@diegoaltoworks/chatter 0.26.0 → 0.28.0

package/dist/channels/gates.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Channel-agnostic reply gates — pure and testable, zero imports from the
+ * rest of chatter. A transport (WhatsApp, or any future channel) resolves
+ * its own wire format into a {@link ChannelMessage} and calls
+ * {@link decideChannelAction} to learn whether to answer, stay quiet, or
+ * flip a mute switch. Nothing here knows about jids, Baileys, or any
+ * specific bot's name — mention/reply-to detection is the transport's job;
+ * this module only combines the already-resolved booleans with allowlist,
+ * mute, and rate-limit policy.
+ */
+/** The slice of an inbound message every channel can resolve into this shape. */
+export interface ChannelMessage {
+    /** The conversation this message belongs to — a DM thread or a group. */
+    chatId: string;
+    senderId: string;
+    text: string;
+    /** True for a 1:1 conversation; false for a group/channel with other members. */
+    isDirectMessage: boolean;
+    /** Resolved by the caller: does this message @-mention the bot? */
+    mentionsBot: boolean;
+    /** Resolved by the caller: is this message a reply to one of the bot's own messages? */
+    isReplyToBot: boolean;
+    /** True when the bot itself sent this message (including via another session — see {@link isEffectivelyFromSelf}). */
+    fromBot: boolean;
+}
+export type ChannelAction = "reply" | "ignore" | "mute" | "unmute";
+export interface ChannelGateConfig {
+    /** Chats eligible for a reply. Empty = every chat is eligible (the master allowlist switch). */
+    allowedChats: string[];
+    /** Group chats currently muted — addressed messages there are ignored until unmuted. Has no effect on DMs, which always reply. */
+    mutedChats: Set<string>;
+    /**
+     * Caller-supplied trigger for "go quiet in this group chat". No default:
+     * this module ships no bot name or in-character phrasing, so mute/unmute
+     * are inert unless a host configures a pattern. Never applied to DMs.
+     */
+    muteRegex?: RegExp;
+    unmuteRegex?: RegExp;
+}
+/**
+ * DMs always reply. In groups, only an allowlisted, unmuted chat gets a
+ * reply, and only when addressed (mentioned or replying to the bot) —
+ * merely mentioning the bot's name in third person is not an invitation.
+ * The unmute check runs before the muted-chat gate so an unmute phrase can
+ * un-silence the bot in the same message, and both run after the allowlist
+ * so a chat the bot isn't eligible for can't toggle its mute state.
+ */
+export declare function decideChannelAction(msg: ChannelMessage, config: ChannelGateConfig): ChannelAction;
+/**
+ * Sliding-window rate limiter (pure, injectable clock): true = allowed and
+ * counted. One instance guards one budget — callers wanting separate DM and
+ * group budgets create two (see {@link underReplyRateLimit}).
+ */
+export declare function createSlidingWindowRateLimiter(maxPerWindow: number, windowMs: number, now?: () => number): (key: string) => boolean;
+/**
+ * Routes a chat to its DM or group rate limiter so a flood in one can't
+ * spend the other's budget — a DM flood used to be entirely unthrottled
+ * before this split existed. Each limiter is expected to be its own
+ * {@link createSlidingWindowRateLimiter} instance.
+ */
+export declare function underReplyRateLimit(msg: Pick<ChannelMessage, "chatId" | "isDirectMessage">, limiters: {
+    dm: (chatId: string) => boolean;
+    group: (chatId: string) => boolean;
+}): boolean;
+/**
+ * Every session's own identities ever seen, keyed by session id. A
+ * multi-session deployment (e.g. two linked numbers in one process) gives
+ * each session only its own identity from its transport — a message that
+ * actually came from a *different* session's identity looks like a
+ * stranger, not "us", and the two sessions can ping-pong replies at each
+ * other indefinitely. Callers populate this directly (`registry.set(sessionId, ids)`)
+ * as each session's identities become known, typically on connect and kept
+ * in sync as they change.
+ *
+ * Entries are NOT expected to be removed when a session disconnects: a
+ * session's own identity is still "us" while it reconnects, and losing that
+ * during exactly the disconnect/reconnect window this guard exists for
+ * would defeat it.
+ */
+export type SessionIdentityRegistry = Map<string, string[]>;
+/** True when `id` matches an identity of ANY session ever registered, not just the one that received the message. */
+export declare function isFromAnySession(id: string | undefined, registry: SessionIdentityRegistry): boolean;
+/**
+ * The one predicate transports need before deciding fromBot: a message is
+ * effectively from the bot itself if the transport already flagged it so,
+ * or if its sender id matches an identity registered by any session (the
+ * loop-guard case a single session's own flag can't catch).
+ */
+export declare function isEffectivelyFromSelf(msg: Pick<ChannelMessage, "fromBot" | "senderId">, registry: SessionIdentityRegistry): boolean;
+//# sourceMappingURL=gates.d.ts.map

package/dist/channels/gates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gates.d.ts","sourceRoot":"","sources":["../../src/channels/gates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,eAAe,EAAE,OAAO,CAAC;IACzB,mEAAmE;IACnE,WAAW,EAAE,OAAO,CAAC;IACrB,wFAAwF;IACxF,YAAY,EAAE,OAAO,CAAC;IACtB,sHAAsH;IACtH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnE,MAAM,WAAW,iBAAiB;IAChC,gGAAgG;IAChG,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kIAAkI;IAClI,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAOD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,iBAAiB,GAAG,aAAa,CAYjG;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAM,MAAiB,SAGD,MAAM,KAAG,OAAO,CAY5C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,iBAAiB,CAAC,EACvD,QAAQ,EAAE;IAAE,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAA;CAAE,GAChF,OAAO,CAET;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,uBAAuB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAE5D,qHAAqH;AACrH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,MAAM,GAAG,SAAS,EACtB,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAMT;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,UAAU,CAAC,EACjD,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAET"}

package/dist/channels/gates.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gates.test.d.ts.map

package/dist/channels/gates.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gates.test.d.ts","sourceRoot":"","sources":["../../src/channels/gates.test.ts"],"names":[],"mappings":""}

package/dist/channels/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Channel SPI — the seam a transport (WhatsApp, or any future channel)
+ * implements to attach to a chatter server. `createServer` starts every
+ * configured channel with the same {@link ServerDependencies} route
+ * factories and custom routes receive, so a channel can call
+ * `prepareChat`/`answerOnce`, share `deps.db`, etc. without knowing how the
+ * server was assembled — and `channel.start(deps)` works identically when
+ * called directly, outside `createServer`, for standalone use.
+ *
+ * Published as the `@diegoaltoworks/chatter/channels` subpath alongside the
+ * pure decision gates ({@link decideChannelAction} and friends) and the
+ * {@link ChannelSenderRegistry}, so a transport package needs one import for
+ * the whole channel toolkit. Zero required dependencies beyond the core
+ * package itself.
+ *
+ * @packageDocumentation
+ */
+import type { ServerDependencies } from "../types";
+export interface Channel {
+    /** Human-readable name, used in start-failure log lines and as the sender-registry key. */
+    name: string;
+    /**
+     * Called once, after routes are mounted, with the full server dependencies.
+     * Awaited if it returns a promise. A rejection/throw is logged and isolated
+     * — one channel failing to start never crashes the server or the other
+     * configured channels.
+     *
+     * `createServer` awaits this before the app is handed back and starts
+     * serving requests, so `start` should return once the transport is
+     * *initiated* (a socket opened, a listener registered) — not once a remote
+     * connection or pairing flow completes. An implementation that awaits a
+     * slow handshake blocks the whole server from ever starting.
+     */
+    start(deps: ServerDependencies): void | Promise<void>;
+    /**
+     * Called by the host's own shutdown path via the disposer `createServer`
+     * returns (`app.stopChannels()`, see `ChatterApp` in `./server`) — never
+     * automatically on a process signal, since a library installing its own
+     * SIGTERM/SIGINT handler and exiting the process would race a host's
+     * shutdown logic.
+     */
+    stop?(): void | Promise<void>;
+}
+export * from "./gates";
+export type { ChannelSender, ChannelSenderRegistry } from "./senders";
+export { createSenderRegistry } from "./senders";
+//# sourceMappingURL=index.d.ts.map

package/dist/channels/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD,MAAM,WAAW,OAAO;IACtB,2FAA2F;IAC3F,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD;;;;;;OAMG;IACH,IAAI,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED,cAAc,SAAS,CAAC;AACxB,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC"}

package/dist/channels/index.js

@@ -0,0 +1,137 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/channels/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createSenderRegistry: () => createSenderRegistry,
+  createSlidingWindowRateLimiter: () => createSlidingWindowRateLimiter,
+  decideChannelAction: () => decideChannelAction,
+  isEffectivelyFromSelf: () => isEffectivelyFromSelf,
+  isFromAnySession: () => isFromAnySession,
+  underReplyRateLimit: () => underReplyRateLimit
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/channels/gates.ts
+function matches(re, text) {
+  return new RegExp(re.source, re.flags.replace(/[gy]/g, "")).test(text);
+}
+function decideChannelAction(msg, config) {
+  if (msg.fromBot || !msg.text.trim()) return "ignore";
+  if (!msg.isDirectMessage) {
+    if (config.allowedChats.length > 0 && !config.allowedChats.includes(msg.chatId)) {
+      return "ignore";
+    }
+    if (config.muteRegex && matches(config.muteRegex, msg.text)) return "mute";
+    if (config.unmuteRegex && matches(config.unmuteRegex, msg.text)) return "unmute";
+    if (config.mutedChats.has(msg.chatId)) return "ignore";
+    return msg.mentionsBot || msg.isReplyToBot ? "reply" : "ignore";
+  }
+  return "reply";
+}
+function createSlidingWindowRateLimiter(maxPerWindow, windowMs, now = Date.now) {
+  const log = /* @__PURE__ */ new Map();
+  return function allow(key) {
+    const cutoff = now() - windowMs;
+    const entries = (log.get(key) ?? []).filter((t) => t > cutoff);
+    if (entries.length >= maxPerWindow) {
+      if (entries.length > 0) log.set(key, entries);
+      else log.delete(key);
+      return false;
+    }
+    entries.push(now());
+    log.set(key, entries);
+    return true;
+  };
+}
+function underReplyRateLimit(msg, limiters) {
+  return msg.isDirectMessage ? limiters.dm(msg.chatId) : limiters.group(msg.chatId);
+}
+function isFromAnySession(id, registry) {
+  if (!id) return false;
+  for (const ids of registry.values()) {
+    if (ids.includes(id)) return true;
+  }
+  return false;
+}
+function isEffectivelyFromSelf(msg, registry) {
+  return msg.fromBot || isFromAnySession(msg.senderId, registry);
+}
+
+// src/channels/senders.ts
+function createSenderRegistry() {
+  const senders = /* @__PURE__ */ new Map();
+  return {
+    register(name, sender) {
+      if (senders.has(name)) {
+        console.warn(`Channel sender "${name}" is already registered; overwriting.`);
+      }
+      senders.set(name, sender);
+    },
+    unregister(name) {
+      senders.delete(name);
+    },
+    available(name) {
+      return senders.has(name);
+    },
+    async sendText(name, chatId, text) {
+      const sender = senders.get(name);
+      if (!sender) return false;
+      try {
+        await sender.sendText(chatId, text);
+        return true;
+      } catch (error) {
+        console.warn(`Channel sender "${name}" sendText failed:`, error);
+        return false;
+      }
+    },
+    async sendVoice(name, chatId, payload) {
+      const sender = senders.get(name);
+      if (!sender?.sendVoice) return false;
+      try {
+        await sender.sendVoice(chatId, payload);
+        return true;
+      } catch (error) {
+        console.warn(`Channel sender "${name}" sendVoice failed:`, error);
+        return false;
+      }
+    },
+    async sendMedia(name, chatId, payload) {
+      const sender = senders.get(name);
+      if (!sender?.sendMedia) return false;
+      try {
+        await sender.sendMedia(chatId, payload);
+        return true;
+      } catch (error) {
+        console.warn(`Channel sender "${name}" sendMedia failed:`, error);
+        return false;
+      }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createSenderRegistry,
+  createSlidingWindowRateLimiter,
+  decideChannelAction,
+  isEffectivelyFromSelf,
+  isFromAnySession,
+  underReplyRateLimit
+});

package/dist/channels/index.mjs

@@ -0,0 +1,105 @@
+// src/channels/gates.ts
+function matches(re, text) {
+  return new RegExp(re.source, re.flags.replace(/[gy]/g, "")).test(text);
+}
+function decideChannelAction(msg, config) {
+  if (msg.fromBot || !msg.text.trim()) return "ignore";
+  if (!msg.isDirectMessage) {
+    if (config.allowedChats.length > 0 && !config.allowedChats.includes(msg.chatId)) {
+      return "ignore";
+    }
+    if (config.muteRegex && matches(config.muteRegex, msg.text)) return "mute";
+    if (config.unmuteRegex && matches(config.unmuteRegex, msg.text)) return "unmute";
+    if (config.mutedChats.has(msg.chatId)) return "ignore";
+    return msg.mentionsBot || msg.isReplyToBot ? "reply" : "ignore";
+  }
+  return "reply";
+}
+function createSlidingWindowRateLimiter(maxPerWindow, windowMs, now = Date.now) {
+  const log = /* @__PURE__ */ new Map();
+  return function allow(key) {
+    const cutoff = now() - windowMs;
+    const entries = (log.get(key) ?? []).filter((t) => t > cutoff);
+    if (entries.length >= maxPerWindow) {
+      if (entries.length > 0) log.set(key, entries);
+      else log.delete(key);
+      return false;
+    }
+    entries.push(now());
+    log.set(key, entries);
+    return true;
+  };
+}
+function underReplyRateLimit(msg, limiters) {
+  return msg.isDirectMessage ? limiters.dm(msg.chatId) : limiters.group(msg.chatId);
+}
+function isFromAnySession(id, registry) {
+  if (!id) return false;
+  for (const ids of registry.values()) {
+    if (ids.includes(id)) return true;
+  }
+  return false;
+}
+function isEffectivelyFromSelf(msg, registry) {
+  return msg.fromBot || isFromAnySession(msg.senderId, registry);
+}
+
+// src/channels/senders.ts
+function createSenderRegistry() {
+  const senders = /* @__PURE__ */ new Map();
+  return {
+    register(name, sender) {
+      if (senders.has(name)) {
+        console.warn(`Channel sender "${name}" is already registered; overwriting.`);
+      }
+      senders.set(name, sender);
+    },
+    unregister(name) {
+      senders.delete(name);
+    },
+    available(name) {
+      return senders.has(name);
+    },
+    async sendText(name, chatId, text) {
+      const sender = senders.get(name);
+      if (!sender) return false;
+      try {
+        await sender.sendText(chatId, text);
+        return true;
+      } catch (error) {
+        console.warn(`Channel sender "${name}" sendText failed:`, error);
+        return false;
+      }
+    },
+    async sendVoice(name, chatId, payload) {
+      const sender = senders.get(name);
+      if (!sender?.sendVoice) return false;
+      try {
+        await sender.sendVoice(chatId, payload);
+        return true;
+      } catch (error) {
+        console.warn(`Channel sender "${name}" sendVoice failed:`, error);
+        return false;
+      }
+    },
+    async sendMedia(name, chatId, payload) {
+      const sender = senders.get(name);
+      if (!sender?.sendMedia) return false;
+      try {
+        await sender.sendMedia(chatId, payload);
+        return true;
+      } catch (error) {
+        console.warn(`Channel sender "${name}" sendMedia failed:`, error);
+        return false;
+      }
+    }
+  };
+}
+export {
+  createSenderRegistry,
+  createSlidingWindowRateLimiter,
+  decideChannelAction,
+  isEffectivelyFromSelf,
+  isFromAnySession,
+  underReplyRateLimit
+};

package/dist/channels/senders.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Channel-agnostic outbound registry. Brain-side features (a scheduler, the
+ * flows engine) send messages by channel name without importing a transport
+ * or knowing whether it is currently connected — a channel registers its
+ * sender on start and unregisters it on stop, and every send degrades to
+ * `false` instead of throwing when the name is unknown or the underlying
+ * send fails, so a disconnected channel can never crash a caller.
+ */
+/** What a channel implements to receive outbound sends. Voice/media payload shapes are transport-defined. */
+export interface ChannelSender {
+    sendText(chatId: string, text: string): Promise<void>;
+    /** Optional: channels without voice support (or test fakes) stay valid without it. */
+    sendVoice?(chatId: string, payload: unknown): Promise<void>;
+    /** Optional: channels without media support (or test fakes) stay valid without it. */
+    sendMedia?(chatId: string, payload: unknown): Promise<void>;
+}
+export interface ChannelSenderRegistry {
+    register(name: string, sender: ChannelSender): void;
+    unregister(name: string): void;
+    /** True when a sender is registered under `name` (regardless of what it optionally supports). */
+    available(name: string): boolean;
+    sendText(name: string, chatId: string, text: string): Promise<boolean>;
+    /** False (not a throw) when the sender is missing, disconnected, or lacks voice support. */
+    sendVoice(name: string, chatId: string, payload: unknown): Promise<boolean>;
+    /** False (not a throw) when the sender is missing, disconnected, or lacks media support. */
+    sendMedia(name: string, chatId: string, payload: unknown): Promise<boolean>;
+}
+/** One registry per server: channels register on start, callers send by name. */
+export declare function createSenderRegistry(): ChannelSenderRegistry;
+//# sourceMappingURL=senders.d.ts.map

package/dist/channels/senders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"senders.d.ts","sourceRoot":"","sources":["../../src/channels/senders.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6GAA6G;AAC7G,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,sFAAsF;IACtF,SAAS,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,sFAAsF;IACtF,SAAS,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IACpD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,iGAAiG;IACjG,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvE,4FAA4F;IAC5F,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5E,4FAA4F;IAC5F,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7E;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,IAAI,qBAAqB,CAkD5D"}

package/dist/channels/senders.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=senders.test.d.ts.map

package/dist/channels/senders.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"senders.test.d.ts","sourceRoot":"","sources":["../../src/channels/senders.test.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -12,6 +12,7 @@
  */
 export type { ApiKeyOptions, ApiKeyPayload, VerifyResult } from "./auth";
 export { ApiKeyManager } from "./auth";
+export type { Channel } from "./channels";
 export type { ChatBotConfig, ChatButtonConfig, ChatConfig, ChatMessage, ChatMode, StreamCallbacks, } from "./client";
 export { Chat, ChatBot, ChatButton } from "./client";
 export type { AnswerFn, AnswerFnInput, AnswerFnResult, AnswerOptions, AnswerUsage, } from "./core/answer";
@@ -39,6 +40,7 @@ export { demoRoutes } from "./routes/demo";
 export { openaiRoutes } from "./routes/openai";
 export { privateRoutes } from "./routes/private";
 export { publicRoutes } from "./routes/public";
+export type { ChatterApp } from "./server";
 export { createServer } from "./server";
 export type { BotBranding, BotChatConfig, BotIdentity, ChatterConfig, CustomRoutes, EmbeddingChunk, KnowledgeDocument, ServerDependencies, } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,QAAQ,EACR,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EACV,QAAQ,EACR,aAAa,EACb,cAAc,EACd,aAAa,EACb,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACzD,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEnF,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEvE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,YAAY,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,aAAa,EACb,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAIvC,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,QAAQ,EACR,eAAe,GAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EACV,QAAQ,EACR,aAAa,EACb,cAAc,EACd,aAAa,EACb,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACzD,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEnF,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEvE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,YAAY,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,aAAa,EACb,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -33171,6 +33171,58 @@ var import_hono5 = require("hono");
 var import_bun = require("hono/bun");
 var import_openai2 = __toESM(require("openai"));
 
+// src/channels/senders.ts
+function createSenderRegistry() {
+  const senders = /* @__PURE__ */ new Map();
+  return {
+    register(name, sender) {
+      if (senders.has(name)) {
+        console.warn(`Channel sender "${name}" is already registered; overwriting.`);
+      }
+      senders.set(name, sender);
+    },
+    unregister(name) {
+      senders.delete(name);
+    },
+    available(name) {
+      return senders.has(name);
+    },
+    async sendText(name, chatId, text) {
+      const sender = senders.get(name);
+      if (!sender) return false;
+      try {
+        await sender.sendText(chatId, text);
+        return true;
+      } catch (error51) {
+        console.warn(`Channel sender "${name}" sendText failed:`, error51);
+        return false;
+      }
+    },
+    async sendVoice(name, chatId, payload) {
+      const sender = senders.get(name);
+      if (!sender?.sendVoice) return false;
+      try {
+        await sender.sendVoice(chatId, payload);
+        return true;
+      } catch (error51) {
+        console.warn(`Channel sender "${name}" sendVoice failed:`, error51);
+        return false;
+      }
+    },
+    async sendMedia(name, chatId, payload) {
+      const sender = senders.get(name);
+      if (!sender?.sendMedia) return false;
+      try {
+        await sender.sendMedia(chatId, payload);
+        return true;
+      } catch (error51) {
+        console.warn(`Channel sender "${name}" sendMedia failed:`, error51);
+        return false;
+      }
+    }
+  };
+}
+
 // src/core/widgets.ts
 var import_node_fs3 = require("node:fs");
 var import_node_path3 = require("node:path");
@@ -33296,7 +33348,8 @@ async function createServer(config2) {
     app.get("/demo/chatbot", (0, import_bun.serveStatic)({ path: `${publicDir}/demo-chatbot.html` }));
     app.get("/demo/react", (0, import_bun.serveStatic)({ path: `${publicDir}/react-demo.html` }));
   }
-  const deps = { client, store, db, config: config2, prompts, apiKeyManager };
+  const senders = createSenderRegistry();
+  const deps = { client, store, db, config: config2, prompts, apiKeyManager, senders };
   if (enablePublic) {
     app.route("/", publicRoutes(deps));
   }
@@ -33312,8 +33365,36 @@ async function createServer(config2) {
   if (config2.customRoutes) {
     await config2.customRoutes(app, deps);
   }
+  const started = [];
+  if (config2.channels && config2.channels.length > 0) {
+    for (const channel of config2.channels) {
+      try {
+        await channel.start(deps);
+        started.push(channel);
+        console.log(`\u2705 Channel "${channel.name}" started`);
+      } catch (error51) {
+        console.error(`\u274C Channel "${channel.name}" failed to start:`, error51);
+      }
+    }
+  }
   console.log(`\u2705 ${config2.bot.name} server ready`);
-  return app;
+  return Object.assign(app, {
+    // Scoped to this call's started channels, not global — two servers in
+    // one process each stop only their own. A channel's `stop()` throwing
+    // (sync or async) is caught per-channel so one misbehaving channel can't
+    // stop the rest from cleaning up.
+    stopChannels: async () => {
+      await Promise.allSettled(
+        started.map(async (channel) => {
+          try {
+            await channel.stop?.();
+          } catch (error51) {
+            console.error(`Channel "${channel.name}" failed to stop:`, error51);
+          }
+        })
+      );
+    }
+  });
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.mjs

@@ -33134,6 +33134,58 @@ import { Hono as Hono5 } from "hono";
 import { serveStatic } from "hono/bun";
 import OpenAI2 from "openai";
 
+// src/channels/senders.ts
+function createSenderRegistry() {
+  const senders = /* @__PURE__ */ new Map();
+  return {
+    register(name, sender) {
+      if (senders.has(name)) {
+        console.warn(`Channel sender "${name}" is already registered; overwriting.`);
+      }
+      senders.set(name, sender);
+    },
+    unregister(name) {
+      senders.delete(name);
+    },
+    available(name) {
+      return senders.has(name);
+    },
+    async sendText(name, chatId, text) {
+      const sender = senders.get(name);
+      if (!sender) return false;
+      try {
+        await sender.sendText(chatId, text);
+        return true;
+      } catch (error51) {
+        console.warn(`Channel sender "${name}" sendText failed:`, error51);
+        return false;
+      }
+    },
+    async sendVoice(name, chatId, payload) {
+      const sender = senders.get(name);
+      if (!sender?.sendVoice) return false;
+      try {
+        await sender.sendVoice(chatId, payload);
+        return true;
+      } catch (error51) {
+        console.warn(`Channel sender "${name}" sendVoice failed:`, error51);
+        return false;
+      }
+    },
+    async sendMedia(name, chatId, payload) {
+      const sender = senders.get(name);
+      if (!sender?.sendMedia) return false;
+      try {
+        await sender.sendMedia(chatId, payload);
+        return true;
+      } catch (error51) {
+        console.warn(`Channel sender "${name}" sendMedia failed:`, error51);
+        return false;
+      }
+    }
+  };
+}
+
 // src/core/widgets.ts
 import { existsSync } from "node:fs";
 import { dirname, join as join3 } from "node:path";
@@ -33258,7 +33310,8 @@ async function createServer(config2) {
     app.get("/demo/chatbot", serveStatic({ path: `${publicDir}/demo-chatbot.html` }));
     app.get("/demo/react", serveStatic({ path: `${publicDir}/react-demo.html` }));
   }
-  const deps = { client, store, db, config: config2, prompts, apiKeyManager };
+  const senders = createSenderRegistry();
+  const deps = { client, store, db, config: config2, prompts, apiKeyManager, senders };
   if (enablePublic) {
     app.route("/", publicRoutes(deps));
   }
@@ -33274,8 +33327,36 @@ async function createServer(config2) {
   if (config2.customRoutes) {
     await config2.customRoutes(app, deps);
   }
+  const started = [];
+  if (config2.channels && config2.channels.length > 0) {
+    for (const channel of config2.channels) {
+      try {
+        await channel.start(deps);
+        started.push(channel);
+        console.log(`\u2705 Channel "${channel.name}" started`);
+      } catch (error51) {
+        console.error(`\u274C Channel "${channel.name}" failed to start:`, error51);
+      }
+    }
+  }
   console.log(`\u2705 ${config2.bot.name} server ready`);
-  return app;
+  return Object.assign(app, {
+    // Scoped to this call's started channels, not global — two servers in
+    // one process each stop only their own. A channel's `stop()` throwing
+    // (sync or async) is caught per-channel so one misbehaving channel can't
+    // stop the rest from cleaning up.
+    stopChannels: async () => {
+      await Promise.allSettled(
+        started.map(async (channel) => {
+          try {
+            await channel.stop?.();
+          } catch (error51) {
+            console.error(`Channel "${channel.name}" failed to stop:`, error51);
+          }
+        })
+      );
+    }
+  });
 }
 var export_Chat = import_client3.Chat;
 var export_ChatBot = import_client3.ChatBot;

package/dist/server.d.ts

@@ -5,11 +5,30 @@
  */
 import { Hono } from "hono";
 import type { ChatterConfig } from "./types";
+/**
+ * A Chatter server: the Hono app plus a disposer for anything `createServer`
+ * started outside the request/response cycle. Deliberately not a signal
+ * handler — a library calling `process.exit` on a host's process would race
+ * the host's own shutdown (e.g. an in-flight-request drain) and override its
+ * exit code. Hosts that start channels wire `stopChannels` into their own
+ * shutdown path:
+ *
+ * ```ts
+ * const app = await createServer(config);
+ * process.on("SIGTERM", async () => {
+ *   await app.stopChannels();
+ *   process.exit(0);
+ * });
+ * ```
+ */
+export type ChatterApp = Hono & {
+    stopChannels: () => Promise<void>;
+};
 /**
  * Create a Chatter server instance
  *
  * @param config - Chatter configuration
- * @returns Configured Hono app instance
+ * @returns Configured Hono app instance, plus `stopChannels()` — see {@link ChatterApp}
  */
-export declare function createServer(config: ChatterConfig): Promise<Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">>;
+export declare function createServer(config: ChatterConfig): Promise<ChatterApp>;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAY5B,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,SAAS,CAAC;AAEjE;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,uFA+JvD"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAc5B,OAAO,KAAK,EAAE,aAAa,EAAsB,MAAM,SAAS,CAAC;AAEjE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG;IAAE,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC;AAEtE;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAkM7E"}

package/dist/types.d.ts

@@ -7,6 +7,7 @@
 import type { Client as LibsqlClient } from "@libsql/client";
 import type { Hono } from "hono";
 import type OpenAI from "openai";
+import type { Channel, ChannelSenderRegistry } from "./channels";
 import type { AnswerFn } from "./core/answer";
 import type { BucketsFor } from "./core/buckets";
 import type { PromptLoader } from "./core/prompts";
@@ -174,6 +175,15 @@ export interface ChatterConfig {
     bucketsFor?: BucketsFor;
     /** Custom route handler for advanced use cases. May be async — see {@link CustomRoutes} */
     customRoutes?: CustomRoutes;
+    /**
+     * Transports (WhatsApp, or any future channel) to start alongside the
+     * server. Each is started after routes are mounted with the same
+     * {@link ServerDependencies} route factories receive; a channel that fails
+     * to start is logged and skipped rather than crashing the server. See the
+     * `./channels` subpath for the {@link Channel} SPI, the reply-decision
+     * gates, and the sender registry channels register into.
+     */
+    channels?: Channel[];
 }
 /**
  * Mounts additional routes on the server's Hono app.
@@ -217,6 +227,13 @@ export interface ServerDependencies {
             error?: string;
         }>;
     };
+    /**
+     * The channel sender registry every configured channel is started with.
+     * A channel registers itself here (`deps.senders.register(channel.name, sender)`)
+     * so custom routes and other channels can send outbound messages by
+     * channel name without importing the transport.
+     */
+    senders: ChannelSenderRegistry;
 }
 /**
  * Knowledge document

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegoaltoworks/chatter",
-  "version": "0.26.0",
+  "version": "0.28.0",
   "description": "Embeddable AI chatbot framework with RAG, authentication, and customizable widgets",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -33,6 +33,11 @@
       "types": "./dist/usage/index.d.ts",
       "import": "./dist/usage/index.mjs",
       "require": "./dist/usage/index.js"
+    },
+    "./channels": {
+      "types": "./dist/channels/index.d.ts",
+      "import": "./dist/channels/index.mjs",
+      "require": "./dist/channels/index.js"
     }
   },
   "files": [
@@ -42,13 +47,14 @@
   ],
   "scripts": {
     "dev": "bun --watch src/index.ts",
-    "build": "bun run build:clean && bun run build:types && bun run build:esm && bun run build:cjs && bun run build:mcp && bun run build:usage && bun run build:bin && bun run build:client && bun run build:copy-client",
+    "build": "bun run build:clean && bun run build:types && bun run build:esm && bun run build:cjs && bun run build:mcp && bun run build:usage && bun run build:channels && bun run build:bin && bun run build:client && bun run build:copy-client",
     "build:clean": "rm -rf dist",
     "build:types": "tsc --emitDeclarationOnly --outDir dist",
     "build:esm": "esbuild src/index.ts --bundle --format=esm --outfile=dist/index.mjs --external:hono --external:openai --external:@libsql/client --external:jose --platform=node --target=node24",
     "build:cjs": "esbuild src/index.ts --bundle --format=cjs --outfile=dist/index.js --external:hono --external:openai --external:@libsql/client --external:jose --platform=node --target=node24",
     "build:mcp": "esbuild src/mcp-server.ts --bundle --format=esm --outfile=dist/mcp-server.mjs --external:@modelcontextprotocol/sdk --external:openai --external:@libsql/client --external:zod --platform=node --target=node24 && esbuild src/mcp-server.ts --bundle --format=cjs --outfile=dist/mcp-server.js --external:@modelcontextprotocol/sdk --external:openai --external:@libsql/client --external:zod --platform=node --target=node24",
     "build:usage": "esbuild src/usage/index.ts --bundle --format=esm --outfile=dist/usage/index.mjs --external:@libsql/client --platform=node --target=node24 && esbuild src/usage/index.ts --bundle --format=cjs --outfile=dist/usage/index.js --external:@libsql/client --platform=node --target=node24",
+    "build:channels": "esbuild src/channels/index.ts --bundle --format=esm --outfile=dist/channels/index.mjs --external:hono --external:openai --external:@libsql/client --platform=node --target=node24 && esbuild src/channels/index.ts --bundle --format=cjs --outfile=dist/channels/index.js --external:hono --external:openai --external:@libsql/client --platform=node --target=node24",
     "build:bin": "esbuild bin/create-apikey.ts --bundle --format=cjs --outfile=dist/bin/create-apikey.js --external:jose --platform=node --target=node18 --banner:js='#!/usr/bin/env node'",
     "build:client": "cd src/client && bun run build",
     "build:copy-client": "mkdir -p dist/static && cp src/client/dist/chatter.js src/client/dist/chatter.css dist/static/",