Stackables Webhooks

GraphQL Code Generator plugin for Stackables webhooks.

Install

This is a plugin for GraphQL Code Generator. See official installation docs for more info.

All packages should be installed as dev dependencies and are used only during development.

# install generator cli
npm install --save-dev @graphql-codegen/cli

# required typescript plugins
npm install --save-dev @graphql-codegen/typescript
npm install --save-dev @graphql-codegen/typescript-operations

# webhooks plugin
npm install --save-dev codegen-stackables-webhooks

Configuration

While GraphQL Code Generator configuration is simple we still recommend to use the graphql configuration for more universal configuration.

We also provide a simple utility to help with the verbosity. But you can always take full control when you need to.

graphql.config.js in repository root

const { getConfiguration } = require('codegen-stackables-webhooks');

// Returned configuration is just a plain object
// So if needed you can add or modify the returned setting as needed

module.exports = getConfiguration({
    generatedFile: "./src/generated/webhooks.ts",
    accountSlug: "<string>",
    introspectionToken: "<string>"
})

See full configuration options here

Usage

Generated types are easy to use with cloudevents-router package.

import { CloudEventsRouter } from 'cloudevents-router'
import { StackablesEvents } from './src/generated/webhooks'

const router = new CloudEventsRouter<StackablesEvents>()

router.on('stackables.webhook.v1.YourHookName', async (event) => {
    console.log('Received typed webhook', event.data)
})

See more options on how to use the router with different web servers here. But simplest is to just use nodejs built in web server like this:

import http from "http"
import { getMiddleware } from "cloudevents-router"

// const router = ... 

const middleware = getMiddleware(router, { path: '/' })
const server = http.createServer(middleware)

server.listen(5000);

Advanced Usage

• Payload structure
• Provided configuration
• Callback tokens
• Branches

Deployment options

You can deploy the created web service anywhere as long as its publicly accessible. But, You need to ensure that you validate the Stackables JWT token. Instructions here

You can also use Stackables cloud to host your webhooks, in this case authentication and scaling is taken care of by us. Instructions here

Thats it ...

... happy coding :)