@nubemclaw/channel-nostr 2.0.0

package/LICENSE.md

@@ -0,0 +1,59 @@
+# LICENSE — NubemClaw v3
+
+**Copyright © 2026 Nubemsystems S.L.** All rights reserved.
+
+NubemClaw v3 (this monorepo and every `@nubemclaw/*` package published
+under it on the npm registry) is **proprietary software** distributed
+publicly under the SPDX identifier **`UNLICENSED`**. Public
+distribution via npm does NOT make this an open-source project. The
+absence of a permissive license is intentional — the source is
+visible for transparency and operator use, but the rights below apply.
+
+## Permitted
+
+- Installing and running the published `@nubemclaw/*` packages from
+  npm for personal, internal-business, or research use.
+- Reading the source code on the public repository.
+- Submitting issues, pull requests, and feedback to the upstream
+  repository (`nubemsystemsdev/NubemClaw-v3`). Contributions are
+  accepted under the Contributor License Agreement (CLA) gated at PR
+  time; by submitting a contribution you grant Nubemsystems a
+  perpetual, worldwide, non-exclusive license to use the contribution
+  under this proprietary license.
+
+## NOT permitted (without prior written authorisation from Nubemsystems S.L.)
+
+- Redistribution of the source or binaries outside the official npm
+  registry / GitHub release artifacts.
+- Forking and republishing under a different name or scope.
+- Removing or modifying the copyright notice in this file or in the
+  package manifests.
+- Selling, sublicensing, or offering as a hosted SaaS that competes
+  with Nubemsystems' commercial offerings.
+- Reverse-engineering the cloud control plane (when one exists) or
+  any non-source components shipped alongside.
+
+## Trademarks
+
+"NubemClaw", "Nubemsystems", and associated logos are trademarks of
+Nubemsystems S.L. They are not licensed by this document — using them
+to identify your fork, derivative, or service requires explicit
+written permission.
+
+## Warranty disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
+BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+## Contact
+
+Licensing inquiries: `licensing@nubemsystems.es`.
+
+Operator (single point of contact for v3): José Luis Manzanares
+Fernández, Nubemsystems S.L. (`joseluis.manzanares@nubemsystems.es`).

package/dist/channel.d.ts

@@ -0,0 +1,53 @@
+import { type Channel, type ChannelCapabilities, type ChannelTarget } from "@nubemclaw/channel-sdk";
+/**
+ * F31.b / F31-fix.1 — Nostr channel adapter.
+ *
+ * Nostr is NOT REST. The send path opens a WebSocket to a relay, then
+ * sends a `["EVENT", <signedEvent>]` frame (NIP-01). This adapter
+ * intentionally diverges from `createRestChannelBase` because the
+ * transport is a long-lived WS, not a one-shot fetch.
+ *
+ * Signing is intentionally OUT of this package — the adapter accepts
+ * a pre-built signer that returns `{id, sig, pubkey}` for a given
+ * event payload. The default signer is set up by the runner (which
+ * has access to the operator's nsec via secure storage); tests
+ * inject a deterministic signer.
+ *
+ * What this adapter PROVIDES:
+ *
+ *   • A pure `buildNostrEvent` that produces the canonical
+ *     `(kind:1, content, tags, created_at)` envelope.
+ *   • A pure `buildEventFrame` that wraps the signed event into the
+ *     `["EVENT", event]` array NIP-01 frame.
+ *   • A `createNostrChannel(config)` factory that takes a
+ *     `relayFactory` (test override) + `signer` and emits the WS
+ *     frame on send().
+ */
+export interface NostrSignerInput {
+    readonly created_at: number;
+    readonly kind: number;
+    readonly content: string;
+    readonly tags: readonly (readonly string[])[];
+}
+export interface NostrSignedEvent extends NostrSignerInput {
+    readonly id: string;
+    readonly pubkey: string;
+    readonly sig: string;
+}
+export type NostrSigner = (input: NostrSignerInput) => Promise<NostrSignedEvent>;
+export interface NostrRelayLike {
+    send(frame: string): Promise<void>;
+    close(): Promise<void>;
+}
+export interface NostrChannelConfig {
+    readonly relayUrl: string;
+    readonly signer: NostrSigner;
+    readonly relayFactory?: (url: string) => Promise<NostrRelayLike>;
+    readonly capabilities?: ChannelCapabilities;
+}
+export declare const DEFAULT_NOSTR_RELAY: "wss://relay.damus.io";
+export declare const NOSTR_TEXT_NOTE_KIND: 1;
+export declare const buildNostrEvent: (target: ChannelTarget, text: string, now?: () => number) => NostrSignerInput;
+export declare const buildEventFrame: (event: NostrSignedEvent) => string;
+export declare const createNostrChannel: (config: NostrChannelConfig) => Channel;
+//# sourceMappingURL=channel.d.ts.map

package/dist/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,mBAAmB,EAGxB,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAEjF,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACjE,QAAQ,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAC;CAC7C;AAED,eAAO,MAAM,mBAAmB,EAAG,sBAA+B,CAAC;AACnE,eAAO,MAAM,oBAAoB,EAAG,CAAU,CAAC;AAE/C,eAAO,MAAM,eAAe,GAC1B,QAAQ,aAAa,EACrB,MAAM,MAAM,EACZ,MAAK,MAAM,MAA4C,KACtD,gBAKD,CAAC;AAEH,eAAO,MAAM,eAAe,GAAI,OAAO,gBAAgB,KAAG,MACxB,CAAC;AAEnC,eAAO,MAAM,kBAAkB,GAAI,QAAQ,kBAAkB,KAAG,OAuC/D,CAAC"}

package/dist/channel.js

@@ -0,0 +1,48 @@
+import { TEXT_ONLY_REST_CAPABILITIES, extractMessageText, } from "@nubemclaw/channel-sdk";
+export const DEFAULT_NOSTR_RELAY = "wss://relay.damus.io";
+export const NOSTR_TEXT_NOTE_KIND = 1;
+export const buildNostrEvent = (target, text, now = () => Math.floor(Date.now() / 1000)) => ({
+    created_at: now(),
+    kind: NOSTR_TEXT_NOTE_KIND,
+    content: text,
+    tags: [["p", target.id]],
+});
+export const buildEventFrame = (event) => JSON.stringify(["EVENT", event]);
+export const createNostrChannel = (config) => {
+    let relay;
+    let deps;
+    const ensureRelay = async () => {
+        if (relay !== undefined)
+            return relay;
+        if (config.relayFactory === undefined) {
+            throw new Error("nostr adapter: no relayFactory configured. Provide one via config.relayFactory or wire the production WebSocket factory in the runner.");
+        }
+        relay = await config.relayFactory(config.relayUrl);
+        return relay;
+    };
+    return {
+        id: "nostr",
+        capabilities: config.capabilities ?? TEXT_ONLY_REST_CAPABILITIES,
+        async init(d) {
+            deps = d;
+        },
+        async start() {
+            void deps;
+        },
+        async stop() {
+            if (relay !== undefined) {
+                await relay.close();
+                relay = undefined;
+            }
+        },
+        async send(target, message) {
+            const text = extractMessageText(message);
+            const unsigned = buildNostrEvent(target, text);
+            const signed = await config.signer(unsigned);
+            const frame = buildEventFrame(signed);
+            const r = await ensureRelay();
+            await r.send(frame);
+        },
+    };
+};
+//# sourceMappingURL=channel.js.map

package/dist/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,GAMnB,MAAM,wBAAwB,CAAC;AAsDhC,MAAM,CAAC,MAAM,mBAAmB,GAAG,sBAA+B,CAAC;AACnE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAU,CAAC;AAE/C,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,MAAqB,EACrB,IAAY,EACZ,MAAoB,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,EACrC,EAAE,CAAC,CAAC;IACtB,UAAU,EAAE,GAAG,EAAE;IACjB,IAAI,EAAE,oBAAoB;IAC1B,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAuB,EAAU,EAAE,CACjE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AAEnC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAA0B,EAAW,EAAE;IACxE,IAAI,KAAiC,CAAC;IACtC,IAAI,IAA6B,CAAC;IAElC,MAAM,WAAW,GAAG,KAAK,IAA6B,EAAE;QACtD,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACtC,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CACb,wIAAwI,CACzI,CAAC;QACJ,CAAC;QACD,KAAK,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACnD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,OAAO;QACX,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,2BAA2B;QAChE,KAAK,CAAC,IAAI,CAAC,CAAc;YACvB,IAAI,GAAG,CAAC,CAAC;QACX,CAAC;QACD,KAAK,CAAC,KAAK;YACT,KAAK,IAAI,CAAC;QACZ,CAAC;QACD,KAAK,CAAC,IAAI;YACR,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;gBACpB,KAAK,GAAG,SAAS,CAAC;YACpB,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,MAAqB,EAAE,OAAuB;YACvD,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;YACzC,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC7C,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YACtC,MAAM,CAAC,GAAG,MAAM,WAAW,EAAE,CAAC;YAC9B,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./channel.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./channel.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@nubemclaw/channel-nostr",
+  "version": "2.0.0",
+  "description": "NubemClaw v3 — Nostr channel (F31.b). Nostr relay protocol (event publish).",
+  "license": "UNLICENSED",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "zod": "^3.23.8",
+    "@nubemclaw/core": "2.0.0",
+    "@nubemclaw/channel-sdk": "2.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean && rm -rf dist .cache"
+  }
+}

package/src/channel.test.ts

@@ -0,0 +1,136 @@
+import { describe, expect, it, vi } from "vitest";
+
+import {
+  DEFAULT_NOSTR_RELAY,
+  NOSTR_TEXT_NOTE_KIND,
+  buildEventFrame,
+  buildNostrEvent,
+  createNostrChannel,
+  type NostrRelayLike,
+  type NostrSignedEvent,
+  type NostrSigner,
+} from "./channel.js";
+import type { ChannelDeps } from "@nubemclaw/channel-sdk";
+
+const fakeDeps = (): ChannelDeps => ({
+  logger: { info: vi.fn(), warn: vi.fn(), error: vi.fn(), debug: vi.fn() },
+  state: { get: async () => undefined, set: async () => {}, delete: async () => {} },
+  allowlist: { allows: () => true, size: 0 },
+  onInbound: async () => {},
+});
+
+const detSigner: NostrSigner = async (input) => ({
+  ...input,
+  id: "0000000000000000000000000000000000000000000000000000000000000000",
+  pubkey: "1111111111111111111111111111111111111111111111111111111111111111",
+  sig: "2222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222222",
+});
+
+const fakeRelay = (): NostrRelayLike & { sent: string[]; closed: boolean } => {
+  const sent: string[] = [];
+  let closed = false;
+  return {
+    sent,
+    get closed() {
+      return closed;
+    },
+    set closed(v) {
+      closed = v;
+    },
+    async send(frame) {
+      sent.push(frame);
+    },
+    async close() {
+      closed = true;
+    },
+  };
+};
+
+describe("buildNostrEvent", () => {
+  it("emits kind=1 (text note) with content + p-tag pointing to the recipient", () => {
+    const ev = buildNostrEvent({ kind: "chat", id: "npub1abc" }, "hello", () => 1_700_000_000);
+    expect(ev.kind).toBe(NOSTR_TEXT_NOTE_KIND);
+    expect(ev.content).toBe("hello");
+    expect(ev.tags).toEqual([["p", "npub1abc"]]);
+    expect(ev.created_at).toBe(1_700_000_000);
+  });
+
+  it("uses the injected `now` for deterministic timestamps", () => {
+    const ev = buildNostrEvent({ kind: "chat", id: "x" }, "y", () => 42);
+    expect(ev.created_at).toBe(42);
+  });
+});
+
+describe("buildEventFrame", () => {
+  it('wraps the signed event into a NIP-01 ["EVENT", event] array', () => {
+    const ev: NostrSignedEvent = {
+      created_at: 1,
+      kind: NOSTR_TEXT_NOTE_KIND,
+      content: "x",
+      tags: [],
+      id: "deadbeef",
+      pubkey: "feedface",
+      sig: "abcd",
+    };
+    const frame = JSON.parse(buildEventFrame(ev));
+    expect(frame[0]).toBe("EVENT");
+    expect(frame[1]).toEqual(ev);
+  });
+});
+
+describe("createNostrChannel", () => {
+  it("exposes a Channel with id=nostr", () => {
+    const ch = createNostrChannel({
+      relayUrl: DEFAULT_NOSTR_RELAY,
+      signer: detSigner,
+      relayFactory: async () => fakeRelay(),
+    });
+    expect(ch.id).toBe("nostr");
+  });
+
+  it("send() signs the event and writes the EVENT frame to the relay", async () => {
+    const relay = fakeRelay();
+    const ch = createNostrChannel({
+      relayUrl: "wss://test-relay",
+      signer: detSigner,
+      relayFactory: async () => relay,
+    });
+    await ch.init(fakeDeps());
+    await ch.send({ kind: "chat", id: "npub1xyz" }, { type: "text", text: "hello nostr" });
+    expect(relay.sent).toHaveLength(1);
+    const frame = JSON.parse(relay.sent[0] ?? "[]");
+    expect(frame[0]).toBe("EVENT");
+    expect(frame[1].kind).toBe(NOSTR_TEXT_NOTE_KIND);
+    expect(frame[1].content).toBe("hello nostr");
+    expect(frame[1].tags).toEqual([["p", "npub1xyz"]]);
+    expect(frame[1].sig).toMatch(/^[0-9a-f]+$/);
+  });
+
+  it("send() throws when no relayFactory provided", async () => {
+    const ch = createNostrChannel({
+      relayUrl: "wss://x",
+      signer: detSigner,
+    });
+    await ch.init(fakeDeps());
+    await expect(ch.send({ kind: "chat", id: "n" }, { type: "text", text: "x" })).rejects.toThrow(
+      /no relayFactory/,
+    );
+  });
+
+  it("stop() closes the relay", async () => {
+    const relay = fakeRelay();
+    const ch = createNostrChannel({
+      relayUrl: "wss://x",
+      signer: detSigner,
+      relayFactory: async () => relay,
+    });
+    await ch.init(fakeDeps());
+    await ch.send({ kind: "chat", id: "n" }, { type: "text", text: "x" });
+    await ch.stop();
+    expect(relay.closed).toBe(true);
+  });
+
+  it("DEFAULT_NOSTR_RELAY uses wss://relay.damus.io", () => {
+    expect(DEFAULT_NOSTR_RELAY).toBe("wss://relay.damus.io");
+  });
+});

package/src/channel.ts

@@ -0,0 +1,119 @@
+import {
+  TEXT_ONLY_REST_CAPABILITIES,
+  extractMessageText,
+  type Channel,
+  type ChannelCapabilities,
+  type ChannelDeps,
+  type ChannelMessage,
+  type ChannelTarget,
+} from "@nubemclaw/channel-sdk";
+
+/**
+ * F31.b / F31-fix.1 — Nostr channel adapter.
+ *
+ * Nostr is NOT REST. The send path opens a WebSocket to a relay, then
+ * sends a `["EVENT", <signedEvent>]` frame (NIP-01). This adapter
+ * intentionally diverges from `createRestChannelBase` because the
+ * transport is a long-lived WS, not a one-shot fetch.
+ *
+ * Signing is intentionally OUT of this package — the adapter accepts
+ * a pre-built signer that returns `{id, sig, pubkey}` for a given
+ * event payload. The default signer is set up by the runner (which
+ * has access to the operator's nsec via secure storage); tests
+ * inject a deterministic signer.
+ *
+ * What this adapter PROVIDES:
+ *
+ *   • A pure `buildNostrEvent` that produces the canonical
+ *     `(kind:1, content, tags, created_at)` envelope.
+ *   • A pure `buildEventFrame` that wraps the signed event into the
+ *     `["EVENT", event]` array NIP-01 frame.
+ *   • A `createNostrChannel(config)` factory that takes a
+ *     `relayFactory` (test override) + `signer` and emits the WS
+ *     frame on send().
+ */
+
+export interface NostrSignerInput {
+  readonly created_at: number;
+  readonly kind: number;
+  readonly content: string;
+  readonly tags: readonly (readonly string[])[];
+}
+
+export interface NostrSignedEvent extends NostrSignerInput {
+  readonly id: string;
+  readonly pubkey: string;
+  readonly sig: string;
+}
+
+export type NostrSigner = (input: NostrSignerInput) => Promise<NostrSignedEvent>;
+
+export interface NostrRelayLike {
+  send(frame: string): Promise<void>;
+  close(): Promise<void>;
+}
+
+export interface NostrChannelConfig {
+  readonly relayUrl: string;
+  readonly signer: NostrSigner;
+  readonly relayFactory?: (url: string) => Promise<NostrRelayLike>;
+  readonly capabilities?: ChannelCapabilities;
+}
+
+export const DEFAULT_NOSTR_RELAY = "wss://relay.damus.io" as const;
+export const NOSTR_TEXT_NOTE_KIND = 1 as const;
+
+export const buildNostrEvent = (
+  target: ChannelTarget,
+  text: string,
+  now: () => number = () => Math.floor(Date.now() / 1000),
+): NostrSignerInput => ({
+  created_at: now(),
+  kind: NOSTR_TEXT_NOTE_KIND,
+  content: text,
+  tags: [["p", target.id]],
+});
+
+export const buildEventFrame = (event: NostrSignedEvent): string =>
+  JSON.stringify(["EVENT", event]);
+
+export const createNostrChannel = (config: NostrChannelConfig): Channel => {
+  let relay: NostrRelayLike | undefined;
+  let deps: ChannelDeps | undefined;
+
+  const ensureRelay = async (): Promise<NostrRelayLike> => {
+    if (relay !== undefined) return relay;
+    if (config.relayFactory === undefined) {
+      throw new Error(
+        "nostr adapter: no relayFactory configured. Provide one via config.relayFactory or wire the production WebSocket factory in the runner.",
+      );
+    }
+    relay = await config.relayFactory(config.relayUrl);
+    return relay;
+  };
+
+  return {
+    id: "nostr",
+    capabilities: config.capabilities ?? TEXT_ONLY_REST_CAPABILITIES,
+    async init(d: ChannelDeps): Promise<void> {
+      deps = d;
+    },
+    async start(): Promise<void> {
+      void deps;
+    },
+    async stop(): Promise<void> {
+      if (relay !== undefined) {
+        await relay.close();
+        relay = undefined;
+      }
+    },
+    async send(target: ChannelTarget, message: ChannelMessage): Promise<void> {
+      const text = extractMessageText(message);
+      const unsigned = buildNostrEvent(target, text);
+      const signed = await config.signer(unsigned);
+      const frame = buildEventFrame(signed);
+      const r = await ensureRelay();
+      await r.send(frame);
+    },
+  };
+};

package/src/index.ts

@@ -0,0 +1 @@
+export * from "./channel.js";