@diegoaltoworks/chatter 0.33.0 → 0.35.0

package/dist/scheduler/tick.test.d.ts

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

package/dist/scheduler/tick.test.d.ts.map

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

package/dist/scheduler/types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Content-free by design: chatter stores no schedule data of its own.
+ * `id`/`fireAt`/`channel`/`chatId` are the minimum the claim/grace/delivery
+ * machinery needs; `payload` is opaque caller data for the compose step.
+ */
+export interface ScheduleEntry {
+    /** Stable, caller-assigned id — the claim table's primary key. */
+    id: string;
+    /** Epoch ms the entry is due to fire. */
+    fireAt: number;
+    /** Sender-registry channel name to deliver through. */
+    channel: string;
+    /** Channel-specific recipient id. */
+    chatId: string;
+    /** Opaque caller data passed to the compose step; chatter never reads it. */
+    payload?: unknown;
+}
+/** Turns an entry into outbound text. Chatter never inspects the result beyond checking it is non-blank. */
+export type ComposeFn = (entry: ScheduleEntry) => Promise<string> | string;
+export interface ScheduleClaimStore {
+    /** Atomically claims `id` for this instance; resolves false if another instance already holds it. */
+    claim(id: string, now: number): Promise<boolean>;
+    /** Releases this instance's claim on `id`, e.g. after a failed send, so it can be retried within grace. */
+    release(id: string): Promise<void>;
+}
+export interface TickResult {
+    /** Ids delivered this tick. */
+    sent: string[];
+    /** Ids due within grace but already claimed by another instance. */
+    notClaimed: string[];
+    /** Ids due but past their grace window — skipped, never claimed or delivered. */
+    stale: string[];
+    /** Ids claimed this tick whose delivery failed; the claim was released so a later tick can retry. */
+    failed: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/scheduler/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/scheduler/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,4GAA4G;AAC5G,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;AAE3E,MAAM,WAAW,kBAAkB;IACjC,qGAAqG;IACrG,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,2GAA2G;IAC3G,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,oEAAoE;IACpE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iFAAiF;IACjF,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,qGAAqG;IACrG,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegoaltoworks/chatter",
-  "version": "0.33.0",
+  "version": "0.35.0",
   "description": "Embeddable AI chatbot framework with RAG, authentication, and customizable widgets",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -59,6 +59,11 @@
       "types": "./dist/images/index.d.ts",
       "import": "./dist/images/index.mjs",
       "require": "./dist/images/index.js"
+    },
+    "./scheduler": {
+      "types": "./dist/scheduler/index.d.ts",
+      "import": "./dist/scheduler/index.mjs",
+      "require": "./dist/scheduler/index.js"
     }
   },
   "files": [
@@ -68,7 +73,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:personas && bun run build:channels && bun run build:whatsapp && bun run build:flows && bun run build:images && 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:personas && bun run build:channels && bun run build:whatsapp && bun run build:flows && bun run build:images && bun run build:scheduler && 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",
@@ -80,6 +85,7 @@
     "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:flows": "esbuild src/flows/index.ts --bundle --format=esm --outfile=dist/flows/index.mjs --external:@libsql/client --external:openai --platform=node --target=node24 && esbuild src/flows/index.ts --bundle --format=cjs --outfile=dist/flows/index.js --external:@libsql/client --external:openai --platform=node --target=node24",
     "build:images": "esbuild src/images/index.ts --bundle --format=esm --outfile=dist/images/index.mjs --external:@libsql/client --external:openai --platform=node --target=node24 && esbuild src/images/index.ts --bundle --format=cjs --outfile=dist/images/index.js --external:@libsql/client --external:openai --platform=node --target=node24",
+    "build:scheduler": "esbuild src/scheduler/index.ts --bundle --format=esm --outfile=dist/scheduler/index.mjs --external:@libsql/client --external:openai --platform=node --target=node24 && esbuild src/scheduler/index.ts --bundle --format=cjs --outfile=dist/scheduler/index.js --external:@libsql/client --external:openai --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/",