@diegoaltoworks/chatter 0.28.0 → 0.30.0

package/dist/channels/whatsapp/lease.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Deploy-overlap protection: at most one running instance may hold a given
+ * WhatsApp session's Baileys connection at a time.
+ *
+ * Rolling deploys can briefly run the outgoing and incoming revision side by
+ * side, and Baileys/WhatsApp treats a second concurrent connection as a
+ * takeover — it logs the first one out. The lease lives in Turso (`wa_lease`)
+ * so it's visible to every instance. Acquiring/renewing is a single atomic
+ * upsert — see `createTursoWaLeaseStore` — so two instances racing the same
+ * row can never both believe they hold it.
+ */
+import type { Client } from "@libsql/client";
+/** Stale after this long without a heartbeat — a crashed holder's lease frees up. */
+export declare const LEASE_STALE_MS = 90000;
+/** How often a holder renews its lease while connected. */
+export declare const LEASE_HEARTBEAT_MS = 30000;
+/** How long a non-holder waits before re-checking whether the lease freed up. */
+export declare const LEASE_WAIT_MS = 30000;
+export interface WaLeaseRow {
+    instanceId: string;
+    heartbeatAt: number;
+}
+/**
+ * Pure: may `instanceId` take (or keep) the lease right now, given the
+ * current row (null = never held)? Mirrors the SQL WHERE clause in
+ * `createTursoWaLeaseStore` — keep the two in sync.
+ */
+export declare function canAcquireLease(existing: WaLeaseRow | null, instanceId: string, now: number, staleMs?: number): boolean;
+export interface WaLeaseStore {
+    /** Atomically acquires or renews the lease; resolves true iff `instanceId` now holds it. */
+    tryAcquire(sessionId: string, instanceId: string, now: number, staleMs: number): Promise<boolean>;
+    /** Releases the lease iff still held by `instanceId` (no-op otherwise — a late release must never undo a takeover). */
+    release(sessionId: string, instanceId: string): Promise<void>;
+}
+/**
+ * A Turso-backed `WaLeaseStore`. The WHERE clause on DO UPDATE encodes
+ * `canAcquireLease`: SQLite skips the update (and RETURNING yields no row)
+ * when it's false, so a losing racer sees zero rows back — no separate
+ * read-then-write, no race window.
+ */
+export declare function createTursoWaLeaseStore(client: Client): WaLeaseStore;
+//# sourceMappingURL=lease.d.ts.map

package/dist/channels/whatsapp/lease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease.d.ts","sourceRoot":"","sources":["../../../src/channels/whatsapp/lease.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,qFAAqF;AACrF,eAAO,MAAM,cAAc,QAAS,CAAC;AACrC,2DAA2D;AAC3D,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,iFAAiF;AACjF,eAAO,MAAM,aAAa,QAAS,CAAC;AAEpC,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,UAAU,GAAG,IAAI,EAC3B,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAuB,GAC/B,OAAO,CAIT;AAED,MAAM,WAAW,YAAY;IAC3B,4FAA4F;IAC5F,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClG,uHAAuH;IACvH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D;AAuBD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAyBpE"}

package/dist/channels/whatsapp/lease.test.d.ts

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

package/dist/channels/whatsapp/lease.test.d.ts.map

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

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@diegoaltoworks/chatter",
-  "version": "0.28.0",
+  "version": "0.30.0",
   "description": "Embeddable AI chatbot framework with RAG, authentication, and customizable widgets",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
   "bin": {
-    "chatter": "./dist/bin/create-apikey.js"
+    "chatter": "./dist/bin/create-apikey.js",
+    "wa-pair": "./dist/bin/wa-pair.js"
   },
   "exports": {
     ".": {
@@ -38,6 +39,11 @@
       "types": "./dist/channels/index.d.ts",
       "import": "./dist/channels/index.mjs",
       "require": "./dist/channels/index.js"
+    },
+    "./whatsapp": {
+      "types": "./dist/channels/whatsapp/index.d.ts",
+      "import": "./dist/channels/whatsapp/index.mjs",
+      "require": "./dist/channels/whatsapp/index.js"
     }
   },
   "files": [
@@ -47,7 +53,7 @@
   ],
   "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:channels && 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:whatsapp && 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",
@@ -55,7 +61,8 @@
     "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:whatsapp": "esbuild src/channels/whatsapp/index.ts --bundle --format=esm --outfile=dist/channels/whatsapp/index.mjs --external:@libsql/client --external:@whiskeysockets/baileys --platform=node --target=node24 && esbuild src/channels/whatsapp/index.ts --bundle --format=cjs --outfile=dist/channels/whatsapp/index.js --external:@libsql/client --external:@whiskeysockets/baileys --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' && esbuild bin/wa-pair.ts --bundle --format=cjs --outfile=dist/bin/wa-pair.js --external:@libsql/client --external:@whiskeysockets/baileys --external:qrcode-terminal --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/",
     "test": "bun test",
@@ -108,10 +115,20 @@
   "peerDependencies": {
     "@libsql/client": "^0.17.2",
     "@modelcontextprotocol/sdk": "^1.30.0",
+    "@whiskeysockets/baileys": "^7.0.0-rc14",
     "hono": "^4.12.14",
     "openai": "^7.3.0",
+    "qrcode-terminal": "^0.12.0",
     "zod": "^3.25.76 || ^4.4.3"
   },
+  "peerDependenciesMeta": {
+    "@whiskeysockets/baileys": {
+      "optional": true
+    },
+    "qrcode-terminal": {
+      "optional": true
+    }
+  },
   "dependencies": {
     "jose": "6.2.8"
   },
@@ -121,11 +138,13 @@
     "@modelcontextprotocol/sdk": "1.30.0",
     "@types/bun": "1.3.14",
     "@types/node": "26.2.0",
+    "@whiskeysockets/baileys": "7.0.0-rc14",
     "esbuild": "0.28.1",
     "hono": "4.13.1",
     "husky": "9.1.7",
     "lint-staged": "17.3.0",
     "openai": "7.4.0",
+    "qrcode-terminal": "0.12.0",
     "typescript": "7.0.2",
     "zod": "4.4.3"
   },