@negotium/adapter-sdk

Versioned lifecycle contract shared by Negotium channel adapters. An API v3 adapter definition has a stable name, transcript projection capabilities, start(options), and an idempotent stop() handle.

bun add @negotium/adapter-sdk

import { defineNegotiumAdapter } from "@negotium/adapter-sdk";

export const exampleAdapter = defineNegotiumAdapter({
  name: "example",
  projection: {
    transcript: "full",
    historyBackfill: true,
    externalAuthors: "native",
  },
  start(options: { endpoint: string }) {
    return { name: "example", stop() {} };
  },
});

Requires Bun 1.2.15 or newer.

Durable delivery helpers are exported from @negotium/adapter-sdk/outbox. Runner-neutral adapter contract assertions are exported from @negotium/adapter-sdk/testkit.