@hookdeck/pubsub

Hookdeck Pub/Sub SDK [ALPHA Experiment]

Hookdeck allows for Pub/Sub-type communication, but the platform primitives differ. This library enables the use of Pub/Sub primitives and mapping them to Hookdeck ones.

Here's a mapping of Pub/Sub conventions to Hookdeck ones:

• Channel: A Hookdeck Source with a unique name where events are published
• Subscription: A Hookdeck Connection consisting of a Source, Rules^†, and a Destination. The Destination is where events are delivered to and is the subscriber.

^† The current plan is only to support Filter rules.

Contents

• Usage
• Todos
• Contributing

Usage

const pubsub = new HookdeckPubSub({
  // Hookdeck project API Key
  apiKey,

  // Used when creating all Sources/channels
  publishAuth,
});

// Dynamically creates the Hookdeck Connection
const subscription = channel.subscribe({
  channel: "orders",

  // NOT IMPLEMENTED
  // optional. If supplied, used to create a filter on the connection
  eventType: "order.updated",

  // Where events published on the channel are sent
  url,

  // Optional. Used to authenticate the request to the subscribing url.
  auth,
});

// Creates a Source on the fly if one does not already exist with given name
const channel = pubsub.channe({
  name: "orders",
});

// Performs a POST request to the underlying Source URL
await channel.publish({
  channel: "orders",

  event: {
    type: "order.updated",
    data: {
      status: "PAYMENT_RECEIVED",
    },
  },
});

Todos

• Set up CI/CD
• Add support for filters on subscriptions

Contributing

This section is here as a reminder for you to explain to your users how to contribute to the projects you create from this template.

Credits

• Chris Wells Node TypeScript Template