@diegoaltoworks/chatter 0.54.2 → 0.55.0

package/dist/channels/telegram/updates.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Telegram update -> {@link ChannelMessage}: the transport's own half of the
+ * channel contract (see docs/build-a-channel.md), kept pure so mention and
+ * reply-to detection are testable without a network or a running channel.
+ *
+ * Addressing parity with WhatsApp is the point of this module. WhatsApp
+ * resolves "was the bot addressed?" from `contextInfo.mentionedJid` and the
+ * quoted participant; Telegram resolves it from message entities and
+ * `reply_to_message.from`. The gate policy that consumes those booleans
+ * (`decideChannelAction`) is identical for both.
+ */
+import type { ChannelMessage } from "../gates";
+import type { TelegramMessage, TelegramMessageEntity, TelegramUpdate } from "./api";
+/** The bot's own identity, as `getMe` reports it. */
+export interface TelegramBotIdentity {
+    id: number;
+    username?: string;
+}
+/** The message's text: plain text, or a photo/video/document caption. */
+export declare function messageText(message: TelegramMessage): string;
+/** Entities belong to whichever field carried the text — captions carry theirs on `caption_entities`. */
+export declare function messageEntities(message: TelegramMessage): TelegramMessageEntity[];
+/**
+ * Did this message address the bot? Three ways it can, all of which a human
+ * reader would call "addressed":
+ *
+ * - a `mention` entity whose text is the bot's `@username`;
+ * - a `text_mention` entity pointing at the bot's user id (how a mention
+ *   arrives when the mentioned account has no username);
+ * - a `bot_command` entity suffixed with the bot's username (`/ask@mybot`),
+ *   which is how Telegram disambiguates commands between several bots in one
+ *   group.
+ *
+ * Username comparison is case-insensitive: Telegram treats `@MyBot` and
+ * `@mybot` as the same handle, and clients preserve whatever the sender typed.
+ */
+export declare function mentionsBot(message: TelegramMessage, me: TelegramBotIdentity): boolean;
+/**
+ * The {@link ChannelMessage} for an update, or `undefined` when there is
+ * nothing for a chat pipeline to look at: a non-message update, a channel post
+ * (which has no `from`, only a `sender_chat`), or a service message.
+ *
+ * A message with no text at all (a sticker, an uncaptioned photo) still maps —
+ * its blank text is dropped by `decideChannelAction` like any other, and
+ * mapping it keeps this function's rule simple: interpret the wire, let the
+ * gates decide policy.
+ */
+export declare function toChannelMessage(update: TelegramUpdate, me: TelegramBotIdentity): ChannelMessage | undefined;
+/**
+ * The `offset` to request next so `update` is never redelivered:
+ * `update_id + 1`, which is also how the Bot API acknowledges it (there is no
+ * separate ack call — see docs/telegram.md on offset persistence).
+ */
+export declare function nextOffset(update: TelegramUpdate): number;
+/**
+ * A stable identity key for `bucketsFor`/`personaResolver`/`answerFn`. Namespaced
+ * because a bare Telegram user id is a numeral with no channel in it — a host
+ * keying persona or spend state across several channels must not have one
+ * collide with a phone number or another transport's numeric id (the same
+ * reasoning as WhatsApp's explicit `lid:` marker).
+ */
+export declare function telegramSenderKey(senderId: string): string;
+//# sourceMappingURL=updates.d.ts.map

package/dist/channels/telegram/updates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updates.d.ts","sourceRoot":"","sources":["../../../src/channels/telegram/updates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAEpF,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAE5D;AAED,yGAAyG;AACzG,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,qBAAqB,EAAE,CAEjF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,EAAE,mBAAmB,GAAG,OAAO,CAYtF;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,cAAc,EACtB,EAAE,EAAE,mBAAmB,GACtB,cAAc,GAAG,SAAS,CAiB5B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAEzD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegoaltoworks/chatter",
-  "version": "0.54.2",
+  "version": "0.55.0",
   "description": "Embeddable AI chatbot framework with RAG, authentication, and customizable widgets",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -63,6 +63,11 @@
       "import": "./dist/channels/whatsapp/index.mjs",
       "require": "./dist/channels/whatsapp/index.js"
     },
+    "./telegram": {
+      "types": "./dist/channels/telegram/index.d.ts",
+      "import": "./dist/channels/telegram/index.mjs",
+      "require": "./dist/channels/telegram/index.js"
+    },
     "./images": {
       "types": "./dist/images/index.d.ts",
       "import": "./dist/images/index.mjs",
@@ -83,7 +88,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:server && bun run build:mcp && bun run build:usage && bun run build:history && 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": "bun run build:clean && bun run build:types && bun run build:esm && bun run build:cjs && bun run build:server && bun run build:mcp && bun run build:usage && bun run build:history && bun run build:personas && bun run build:channels && bun run build:whatsapp && bun run build:telegram && 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 -p tsconfig.build.json --emitDeclarationOnly --outDir dist",
     "build:esm": "esbuild src/index.ts --bundle --format=esm --outfile=dist/index.mjs --external:@hono/node-server --external:hono --external:openai --external:@libsql/client --external:jose --external:@modelcontextprotocol/sdk --external:zod --platform=node --target=node24",
@@ -95,6 +100,7 @@
     "build:personas": "esbuild src/personas/index.ts --bundle --format=esm --outfile=dist/personas/index.mjs --platform=node --target=node24 && esbuild src/personas/index.ts --bundle --format=cjs --outfile=dist/personas/index.js --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: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:telegram": "esbuild src/channels/telegram/index.ts --bundle --format=esm --outfile=dist/channels/telegram/index.mjs --external:@libsql/client --external:openai --platform=node --target=node24 && esbuild src/channels/telegram/index.ts --bundle --format=cjs --outfile=dist/channels/telegram/index.js --external:@libsql/client --external:openai --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",