@dreb/telegram 1.16.0

package/dist/util/files.d.ts

@@ -0,0 +1,27 @@
+/**
+ * File handling utilities — temp dir management, telegram:send pattern.
+ */
+/** Pattern for file send requests embedded in assistant text */
+export declare const SEND_FILE_PATTERN: RegExp;
+/**
+ * Ensure the upload directory exists.
+ */
+export declare function ensureUploadDir(): string;
+/**
+ * Save a buffer to the upload directory.
+ */
+export declare function saveUpload(filename: string, data: Buffer): string;
+/**
+ * Extract [[telegram:send:path]] markers from text.
+ * Returns [cleanedText, filePaths].
+ */
+export declare function extractSendFiles(text: string): [string, string[]];
+/**
+ * Clean up the upload directory. Skips cleanup if there are pending file
+ * batches (3-second debounce timers) to avoid deleting files that haven't
+ * been consumed yet.
+ */
+export declare function cleanupUploads(): void;
+export declare function setPendingBatches(count: number): void;
+export declare function hasPendingBatches(): boolean;
+//# sourceMappingURL=files.d.ts.map

package/dist/util/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/util/files.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,gEAAgE;AAChE,eAAO,MAAM,iBAAiB,QAAoC,CAAC;AAEnE;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAKxC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMjE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAOjE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAerC;AAOD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAErD;AACD,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C","sourcesContent":["/**\n * File handling utilities — temp dir management, telegram:send pattern.\n */\n\nimport { existsSync, mkdirSync, rmSync, writeFileSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { basename, join } from \"node:path\";\nimport { log } from \"./telegram.js\";\n\nconst UPLOAD_DIR = join(tmpdir(), \"dreb-telegram-uploads\");\n\n/** Pattern for file send requests embedded in assistant text */\nexport const SEND_FILE_PATTERN = /\\[\\[telegram:send:([^\\]]+)\\]\\]/g;\n\n/**\n * Ensure the upload directory exists.\n */\nexport function ensureUploadDir(): string {\n\tif (!existsSync(UPLOAD_DIR)) {\n\t\tmkdirSync(UPLOAD_DIR, { recursive: true });\n\t}\n\treturn UPLOAD_DIR;\n}\n\n/**\n * Save a buffer to the upload directory.\n */\nexport function saveUpload(filename: string, data: Buffer): string {\n\tconst dir = ensureUploadDir();\n\tconst safe = basename(filename);\n\tconst path = join(dir, `${Date.now()}_${safe}`);\n\twriteFileSync(path, data);\n\treturn path;\n}\n\n/**\n * Extract [[telegram:send:path]] markers from text.\n * Returns [cleanedText, filePaths].\n */\nexport function extractSendFiles(text: string): [string, string[]] {\n\tconst paths: string[] = [];\n\tconst cleaned = text.replace(SEND_FILE_PATTERN, (_match, path) => {\n\t\tpaths.push(path.trim());\n\t\treturn \"\";\n\t});\n\treturn [cleaned.trim(), paths];\n}\n\n/**\n * Clean up the upload directory. Skips cleanup if there are pending file\n * batches (3-second debounce timers) to avoid deleting files that haven't\n * been consumed yet.\n */\nexport function cleanupUploads(): void {\n\t// Check if any file batches are still pending — their debounce timers\n\t// haven't fired yet, so their files haven't been consumed by the queue\n\tif (hasPendingBatches()) {\n\t\tlog(\"[FILES] Skipping cleanup — pending file batches\");\n\t\treturn;\n\t}\n\ttry {\n\t\tif (existsSync(UPLOAD_DIR)) {\n\t\t\trmSync(UPLOAD_DIR, { recursive: true, force: true });\n\t\t\tlog(\"[FILES] Cleaned up upload directory\");\n\t\t}\n\t} catch (e) {\n\t\tlog(`[FILES] Cleanup failed: ${e}`);\n\t}\n}\n\n/**\n * Track whether file batches are pending so cleanupUploads can skip\n * when files haven't been consumed yet.\n */\nlet _pendingBatchCount = 0;\nexport function setPendingBatches(count: number): void {\n\t_pendingBatchCount = count;\n}\nexport function hasPendingBatches(): boolean {\n\treturn _pendingBatchCount > 0;\n}\n"]}

package/dist/util/files.js

@@ -0,0 +1,75 @@
+/**
+ * File handling utilities — temp dir management, telegram:send pattern.
+ */
+import { existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { basename, join } from "node:path";
+import { log } from "./telegram.js";
+const UPLOAD_DIR = join(tmpdir(), "dreb-telegram-uploads");
+/** Pattern for file send requests embedded in assistant text */
+export const SEND_FILE_PATTERN = /\[\[telegram:send:([^\]]+)\]\]/g;
+/**
+ * Ensure the upload directory exists.
+ */
+export function ensureUploadDir() {
+    if (!existsSync(UPLOAD_DIR)) {
+        mkdirSync(UPLOAD_DIR, { recursive: true });
+    }
+    return UPLOAD_DIR;
+}
+/**
+ * Save a buffer to the upload directory.
+ */
+export function saveUpload(filename, data) {
+    const dir = ensureUploadDir();
+    const safe = basename(filename);
+    const path = join(dir, `${Date.now()}_${safe}`);
+    writeFileSync(path, data);
+    return path;
+}
+/**
+ * Extract [[telegram:send:path]] markers from text.
+ * Returns [cleanedText, filePaths].
+ */
+export function extractSendFiles(text) {
+    const paths = [];
+    const cleaned = text.replace(SEND_FILE_PATTERN, (_match, path) => {
+        paths.push(path.trim());
+        return "";
+    });
+    return [cleaned.trim(), paths];
+}
+/**
+ * Clean up the upload directory. Skips cleanup if there are pending file
+ * batches (3-second debounce timers) to avoid deleting files that haven't
+ * been consumed yet.
+ */
+export function cleanupUploads() {
+    // Check if any file batches are still pending — their debounce timers
+    // haven't fired yet, so their files haven't been consumed by the queue
+    if (hasPendingBatches()) {
+        log("[FILES] Skipping cleanup — pending file batches");
+        return;
+    }
+    try {
+        if (existsSync(UPLOAD_DIR)) {
+            rmSync(UPLOAD_DIR, { recursive: true, force: true });
+            log("[FILES] Cleaned up upload directory");
+        }
+    }
+    catch (e) {
+        log(`[FILES] Cleanup failed: ${e}`);
+    }
+}
+/**
+ * Track whether file batches are pending so cleanupUploads can skip
+ * when files haven't been consumed yet.
+ */
+let _pendingBatchCount = 0;
+export function setPendingBatches(count) {
+    _pendingBatchCount = count;
+}
+export function hasPendingBatches() {
+    return _pendingBatchCount > 0;
+}
+//# sourceMappingURL=files.js.map

package/dist/util/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/util/files.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,uBAAuB,CAAC,CAAC;AAE3D,gEAAgE;AAChE,MAAM,CAAC,MAAM,iBAAiB,GAAG,iCAAiC,CAAC;AAEnE;;GAEG;AACH,MAAM,UAAU,eAAe,GAAW;IACzC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,UAAU,CAAC;AAAA,CAClB;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,IAAY,EAAU;IAClE,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAChD,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1B,OAAO,IAAI,CAAC;AAAA,CACZ;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAsB;IAClE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QACjE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACxB,OAAO,EAAE,CAAC;IAAA,CACV,CAAC,CAAC;IACH,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;AAAA,CAC/B;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,GAAS;IACtC,wEAAsE;IACtE,uEAAuE;IACvE,IAAI,iBAAiB,EAAE,EAAE,CAAC;QACzB,GAAG,CAAC,mDAAiD,CAAC,CAAC;QACvD,OAAO;IACR,CAAC;IACD,IAAI,CAAC;QACJ,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACrD,GAAG,CAAC,qCAAqC,CAAC,CAAC;QAC5C,CAAC;IACF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,GAAG,CAAC,2BAA2B,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;AAAA,CACD;AAED;;;GAGG;AACH,IAAI,kBAAkB,GAAG,CAAC,CAAC;AAC3B,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAQ;IACtD,kBAAkB,GAAG,KAAK,CAAC;AAAA,CAC3B;AACD,MAAM,UAAU,iBAAiB,GAAY;IAC5C,OAAO,kBAAkB,GAAG,CAAC,CAAC;AAAA,CAC9B","sourcesContent":["/**\n * File handling utilities — temp dir management, telegram:send pattern.\n */\n\nimport { existsSync, mkdirSync, rmSync, writeFileSync } from \"node:fs\";\nimport { tmpdir } from \"node:os\";\nimport { basename, join } from \"node:path\";\nimport { log } from \"./telegram.js\";\n\nconst UPLOAD_DIR = join(tmpdir(), \"dreb-telegram-uploads\");\n\n/** Pattern for file send requests embedded in assistant text */\nexport const SEND_FILE_PATTERN = /\\[\\[telegram:send:([^\\]]+)\\]\\]/g;\n\n/**\n * Ensure the upload directory exists.\n */\nexport function ensureUploadDir(): string {\n\tif (!existsSync(UPLOAD_DIR)) {\n\t\tmkdirSync(UPLOAD_DIR, { recursive: true });\n\t}\n\treturn UPLOAD_DIR;\n}\n\n/**\n * Save a buffer to the upload directory.\n */\nexport function saveUpload(filename: string, data: Buffer): string {\n\tconst dir = ensureUploadDir();\n\tconst safe = basename(filename);\n\tconst path = join(dir, `${Date.now()}_${safe}`);\n\twriteFileSync(path, data);\n\treturn path;\n}\n\n/**\n * Extract [[telegram:send:path]] markers from text.\n * Returns [cleanedText, filePaths].\n */\nexport function extractSendFiles(text: string): [string, string[]] {\n\tconst paths: string[] = [];\n\tconst cleaned = text.replace(SEND_FILE_PATTERN, (_match, path) => {\n\t\tpaths.push(path.trim());\n\t\treturn \"\";\n\t});\n\treturn [cleaned.trim(), paths];\n}\n\n/**\n * Clean up the upload directory. Skips cleanup if there are pending file\n * batches (3-second debounce timers) to avoid deleting files that haven't\n * been consumed yet.\n */\nexport function cleanupUploads(): void {\n\t// Check if any file batches are still pending — their debounce timers\n\t// haven't fired yet, so their files haven't been consumed by the queue\n\tif (hasPendingBatches()) {\n\t\tlog(\"[FILES] Skipping cleanup — pending file batches\");\n\t\treturn;\n\t}\n\ttry {\n\t\tif (existsSync(UPLOAD_DIR)) {\n\t\t\trmSync(UPLOAD_DIR, { recursive: true, force: true });\n\t\t\tlog(\"[FILES] Cleaned up upload directory\");\n\t\t}\n\t} catch (e) {\n\t\tlog(`[FILES] Cleanup failed: ${e}`);\n\t}\n}\n\n/**\n * Track whether file batches are pending so cleanupUploads can skip\n * when files haven't been consumed yet.\n */\nlet _pendingBatchCount = 0;\nexport function setPendingBatches(count: number): void {\n\t_pendingBatchCount = count;\n}\nexport function hasPendingBatches(): boolean {\n\treturn _pendingBatchCount > 0;\n}\n"]}

package/dist/util/telegram.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Telegram message utilities — splitting, markdown fallback, rate-limit debounce.
+ */
+import type { Api } from "grammy";
+/**
+ * Wrap a promise with a timeout. Rejects with an error if the promise
+ * doesn't settle within `ms` milliseconds. Used to prevent Telegram API
+ * calls from hanging the event chain indefinitely.
+ *
+ * The timer is cleared when the promise settles to avoid accumulating
+ * stale timers in the Node.js timer heap during heavy message runs.
+ */
+export declare function withTimeout<T>(promise: Promise<T>, ms: number): Promise<T>;
+/**
+ * Send a message, falling back to plain text if Markdown fails.
+ */
+export declare function safeSend(api: Api, chatId: number, text: string, replyToId?: number): Promise<number>;
+/**
+ * Send a long message, splitting at newline boundaries.
+ * Stops on first chunk failure to avoid resending already-delivered chunks
+ * on retry. Returns the remaining (undelivered) text, or empty string if
+ * everything was delivered.
+ */
+export declare function sendLong(api: Api, chatId: number, text: string, replyToId?: number): Promise<string>;
+/**
+ * Edit a message safely, falling back to plain text.
+ */
+export declare function safeEdit(api: Api, chatId: number, messageId: number, text: string): Promise<boolean>;
+/**
+ * Delete a message, ignoring errors.
+ */
+export declare function safeDelete(api: Api, chatId: number, messageId: number): Promise<void>;
+/**
+ * Truncate text to fit Telegram's limit.
+ */
+export declare function truncate(text: string, maxLen?: number): string;
+/**
+ * Rate-limited message editor — debounces rapid edits to avoid Telegram 429s.
+ * Minimum 2 seconds between edits to the same message.
+ */
+export declare class DebouncedEditor {
+    private api;
+    private pending;
+    private lastEdit;
+    private readonly minInterval;
+    constructor(api: Api);
+    /**
+     * Schedule an edit. If another edit comes in before the debounce fires,
+     * the previous one is replaced.
+     */
+    edit(chatId: number, messageId: number, text: string): void;
+    /**
+     * Force flush a pending edit immediately (e.g., before deleting the message).
+     */
+    flush(chatId: number, messageId: number): Promise<void>;
+    /** Cancel all pending edits. */
+    clear(): void;
+}
+export declare function log(msg: string): void;
+//# sourceMappingURL=telegram.d.ts.map

package/dist/util/telegram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/util/telegram.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAIlC;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAU1E;AAID;;GAEG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkC1G;AAkBD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAc1G;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAa1G;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM3F;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAc,GAAG,MAAM,CAGnE;AAED;;;GAGG;AACH,qBAAa,eAAe;IAKf,OAAO,CAAC,GAAG;IAJvB,OAAO,CAAC,OAAO,CAAkF;IACjG,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IAEpC,YAAoB,GAAG,EAAE,GAAG,EAAI;IAEhC;;;OAGG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAgB1D;IAED;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS5D;IAED,gCAAgC;IAChC,KAAK,IAAI,IAAI,CAGZ;CACD;AAED,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAErC","sourcesContent":["/**\n * Telegram message utilities — splitting, markdown fallback, rate-limit debounce.\n */\n\nimport type { Api } from \"grammy\";\n\nconst SAFE_LENGTH = 4000; // Leave room for markdown overhead (Telegram max is 4096)\n\n/**\n * Wrap a promise with a timeout. Rejects with an error if the promise\n * doesn't settle within `ms` milliseconds. Used to prevent Telegram API\n * calls from hanging the event chain indefinitely.\n *\n * The timer is cleared when the promise settles to avoid accumulating\n * stale timers in the Node.js timer heap during heavy message runs.\n */\nexport function withTimeout<T>(promise: Promise<T>, ms: number): Promise<T> {\n\tlet timer: ReturnType<typeof setTimeout>;\n\tconst timeout = new Promise<never>((_, reject) => {\n\t\ttimer = setTimeout(() => reject(new Error(`Telegram API timeout after ${ms}ms`)), ms);\n\t});\n\t// Prevent unhandled rejection from the slow promise if the timeout wins.\n\t// Without this, a late rejection after timeout becomes an unhandled rejection\n\t// which crashes the process in Node.js >= 15.\n\tpromise.catch(() => {});\n\treturn Promise.race([promise, timeout]).finally(() => clearTimeout(timer!));\n}\n\nconst API_TIMEOUT = 15_000; // 15s per Telegram API call\n\n/**\n * Send a message, falling back to plain text if Markdown fails.\n */\nexport async function safeSend(api: Api, chatId: number, text: string, replyToId?: number): Promise<number> {\n\t// Truncate to Telegram's limit — callers sending long content should use sendLong instead\n\tif (text.length > SAFE_LENGTH) text = truncate(text, SAFE_LENGTH);\n\ttry {\n\t\tconst msg = await withTimeout(\n\t\t\tapi.sendMessage(chatId, text, {\n\t\t\t\tparse_mode: \"Markdown\",\n\t\t\t\t...(replyToId ? { reply_parameters: { message_id: replyToId } } : {}),\n\t\t\t}),\n\t\t\tAPI_TIMEOUT,\n\t\t);\n\t\treturn msg.message_id;\n\t} catch (e) {\n\t\t// Only retry as plain text for Markdown parse errors (Telegram 400).\n\t\t// For timeouts/network errors, the original request may still be in-flight —\n\t\t// retrying would risk delivering duplicate messages. Return 0 and let\n\t\t// the outbox retry loop handle it.\n\t\tif (!isTelegramParseError(e)) {\n\t\t\tlog(`[WARN] Failed to send message: ${e}`);\n\t\t\treturn 0;\n\t\t}\n\t\ttry {\n\t\t\tconst msg = await withTimeout(\n\t\t\t\tapi.sendMessage(chatId, text, {\n\t\t\t\t\t...(replyToId ? { reply_parameters: { message_id: replyToId } } : {}),\n\t\t\t\t}),\n\t\t\t\tAPI_TIMEOUT,\n\t\t\t);\n\t\t\treturn msg.message_id;\n\t\t} catch (e2) {\n\t\t\tlog(`[WARN] Failed to send message (plain text fallback): ${e2}`);\n\t\t\treturn 0;\n\t\t}\n\t}\n}\n\n/**\n * Check if an error is a Telegram API parse error (HTTP 400 for bad Markdown).\n * These are safe to retry as plain text because the original request definitively\n * failed — Telegram won't deliver it. Timeouts and network errors are NOT safe\n * to retry immediately because the in-flight request may still succeed.\n */\nfunction isTelegramParseError(e: unknown): boolean {\n\tif (!e || typeof e !== \"object\") return false;\n\t// grammy HttpError has error_code\n\tconst code = (e as any).error_code ?? (e as any).status ?? (e as any).statusCode;\n\tif (code === 400) return true;\n\t// Fallback: check message for common Telegram parse error text\n\tconst msg = (e as any).message ?? String(e);\n\treturn typeof msg === \"string\" && msg.includes(\"can't parse entities\");\n}\n\n/**\n * Send a long message, splitting at newline boundaries.\n * Stops on first chunk failure to avoid resending already-delivered chunks\n * on retry. Returns the remaining (undelivered) text, or empty string if\n * everything was delivered.\n */\nexport async function sendLong(api: Api, chatId: number, text: string, replyToId?: number): Promise<string> {\n\twhile (text) {\n\t\tif (text.length <= SAFE_LENGTH) {\n\t\t\tconst msgId = await safeSend(api, chatId, text, replyToId);\n\t\t\treturn msgId === 0 ? text : \"\";\n\t\t}\n\t\tlet splitAt = text.lastIndexOf(\"\\n\", SAFE_LENGTH);\n\t\tif (splitAt < 2000) splitAt = SAFE_LENGTH;\n\t\tconst msgId = await safeSend(api, chatId, text.slice(0, splitAt), replyToId);\n\t\tif (msgId === 0) return text; // Stop — return full remaining text including this failed chunk\n\t\ttext = text.slice(splitAt).replace(/^\\n+/, \"\");\n\t\treplyToId = undefined; // Only reply to the first chunk\n\t}\n\treturn \"\";\n}\n\n/**\n * Edit a message safely, falling back to plain text.\n */\nexport async function safeEdit(api: Api, chatId: number, messageId: number, text: string): Promise<boolean> {\n\ttext = truncate(text, SAFE_LENGTH);\n\ttry {\n\t\tawait withTimeout(api.editMessageText(chatId, messageId, text, { parse_mode: \"Markdown\" }), API_TIMEOUT);\n\t\treturn true;\n\t} catch {\n\t\ttry {\n\t\t\tawait withTimeout(api.editMessageText(chatId, messageId, text), API_TIMEOUT);\n\t\t\treturn true;\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t}\n}\n\n/**\n * Delete a message, ignoring errors.\n */\nexport async function safeDelete(api: Api, chatId: number, messageId: number): Promise<void> {\n\ttry {\n\t\tawait withTimeout(api.deleteMessage(chatId, messageId), API_TIMEOUT);\n\t} catch {\n\t\t// Ignore — message may already be deleted or too old\n\t}\n}\n\n/**\n * Truncate text to fit Telegram's limit.\n */\nexport function truncate(text: string, maxLen = SAFE_LENGTH): string {\n\tif (text.length <= maxLen) return text;\n\treturn `${text.slice(0, maxLen - 20)}\\n\\n_(truncated)_`;\n}\n\n/**\n * Rate-limited message editor — debounces rapid edits to avoid Telegram 429s.\n * Minimum 2 seconds between edits to the same message.\n */\nexport class DebouncedEditor {\n\tprivate pending: Map<string, { text: string; timer: ReturnType<typeof setTimeout> }> = new Map();\n\tprivate lastEdit: Map<string, number> = new Map();\n\tprivate readonly minInterval = 2000; // 2s between edits\n\n\tconstructor(private api: Api) {}\n\n\t/**\n\t * Schedule an edit. If another edit comes in before the debounce fires,\n\t * the previous one is replaced.\n\t */\n\tedit(chatId: number, messageId: number, text: string): void {\n\t\tconst key = `${chatId}:${messageId}`;\n\t\tconst existing = this.pending.get(key);\n\t\tif (existing) clearTimeout(existing.timer);\n\n\t\tconst lastTime = this.lastEdit.get(key) || 0;\n\t\tconst elapsed = Date.now() - lastTime;\n\t\tconst delay = Math.max(0, this.minInterval - elapsed);\n\n\t\tconst timer = setTimeout(() => {\n\t\t\tthis.pending.delete(key);\n\t\t\tthis.lastEdit.set(key, Date.now());\n\t\t\tvoid safeEdit(this.api, chatId, messageId, text);\n\t\t}, delay);\n\n\t\tthis.pending.set(key, { text, timer });\n\t}\n\n\t/**\n\t * Force flush a pending edit immediately (e.g., before deleting the message).\n\t */\n\tasync flush(chatId: number, messageId: number): Promise<void> {\n\t\tconst key = `${chatId}:${messageId}`;\n\t\tconst existing = this.pending.get(key);\n\t\tif (existing) {\n\t\t\tclearTimeout(existing.timer);\n\t\t\tthis.pending.delete(key);\n\t\t\tthis.lastEdit.set(key, Date.now());\n\t\t\tawait safeEdit(this.api, chatId, messageId, existing.text);\n\t\t}\n\t}\n\n\t/** Cancel all pending edits. */\n\tclear(): void {\n\t\tfor (const { timer } of this.pending.values()) clearTimeout(timer);\n\t\tthis.pending.clear();\n\t}\n}\n\nexport function log(msg: string): void {\n\tconsole.error(msg);\n}\n"]}

package/dist/util/telegram.js

@@ -0,0 +1,192 @@
+/**
+ * Telegram message utilities — splitting, markdown fallback, rate-limit debounce.
+ */
+const SAFE_LENGTH = 4000; // Leave room for markdown overhead (Telegram max is 4096)
+/**
+ * Wrap a promise with a timeout. Rejects with an error if the promise
+ * doesn't settle within `ms` milliseconds. Used to prevent Telegram API
+ * calls from hanging the event chain indefinitely.
+ *
+ * The timer is cleared when the promise settles to avoid accumulating
+ * stale timers in the Node.js timer heap during heavy message runs.
+ */
+export function withTimeout(promise, ms) {
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error(`Telegram API timeout after ${ms}ms`)), ms);
+    });
+    // Prevent unhandled rejection from the slow promise if the timeout wins.
+    // Without this, a late rejection after timeout becomes an unhandled rejection
+    // which crashes the process in Node.js >= 15.
+    promise.catch(() => { });
+    return Promise.race([promise, timeout]).finally(() => clearTimeout(timer));
+}
+const API_TIMEOUT = 15_000; // 15s per Telegram API call
+/**
+ * Send a message, falling back to plain text if Markdown fails.
+ */
+export async function safeSend(api, chatId, text, replyToId) {
+    // Truncate to Telegram's limit — callers sending long content should use sendLong instead
+    if (text.length > SAFE_LENGTH)
+        text = truncate(text, SAFE_LENGTH);
+    try {
+        const msg = await withTimeout(api.sendMessage(chatId, text, {
+            parse_mode: "Markdown",
+            ...(replyToId ? { reply_parameters: { message_id: replyToId } } : {}),
+        }), API_TIMEOUT);
+        return msg.message_id;
+    }
+    catch (e) {
+        // Only retry as plain text for Markdown parse errors (Telegram 400).
+        // For timeouts/network errors, the original request may still be in-flight —
+        // retrying would risk delivering duplicate messages. Return 0 and let
+        // the outbox retry loop handle it.
+        if (!isTelegramParseError(e)) {
+            log(`[WARN] Failed to send message: ${e}`);
+            return 0;
+        }
+        try {
+            const msg = await withTimeout(api.sendMessage(chatId, text, {
+                ...(replyToId ? { reply_parameters: { message_id: replyToId } } : {}),
+            }), API_TIMEOUT);
+            return msg.message_id;
+        }
+        catch (e2) {
+            log(`[WARN] Failed to send message (plain text fallback): ${e2}`);
+            return 0;
+        }
+    }
+}
+/**
+ * Check if an error is a Telegram API parse error (HTTP 400 for bad Markdown).
+ * These are safe to retry as plain text because the original request definitively
+ * failed — Telegram won't deliver it. Timeouts and network errors are NOT safe
+ * to retry immediately because the in-flight request may still succeed.
+ */
+function isTelegramParseError(e) {
+    if (!e || typeof e !== "object")
+        return false;
+    // grammy HttpError has error_code
+    const code = e.error_code ?? e.status ?? e.statusCode;
+    if (code === 400)
+        return true;
+    // Fallback: check message for common Telegram parse error text
+    const msg = e.message ?? String(e);
+    return typeof msg === "string" && msg.includes("can't parse entities");
+}
+/**
+ * Send a long message, splitting at newline boundaries.
+ * Stops on first chunk failure to avoid resending already-delivered chunks
+ * on retry. Returns the remaining (undelivered) text, or empty string if
+ * everything was delivered.
+ */
+export async function sendLong(api, chatId, text, replyToId) {
+    while (text) {
+        if (text.length <= SAFE_LENGTH) {
+            const msgId = await safeSend(api, chatId, text, replyToId);
+            return msgId === 0 ? text : "";
+        }
+        let splitAt = text.lastIndexOf("\n", SAFE_LENGTH);
+        if (splitAt < 2000)
+            splitAt = SAFE_LENGTH;
+        const msgId = await safeSend(api, chatId, text.slice(0, splitAt), replyToId);
+        if (msgId === 0)
+            return text; // Stop — return full remaining text including this failed chunk
+        text = text.slice(splitAt).replace(/^\n+/, "");
+        replyToId = undefined; // Only reply to the first chunk
+    }
+    return "";
+}
+/**
+ * Edit a message safely, falling back to plain text.
+ */
+export async function safeEdit(api, chatId, messageId, text) {
+    text = truncate(text, SAFE_LENGTH);
+    try {
+        await withTimeout(api.editMessageText(chatId, messageId, text, { parse_mode: "Markdown" }), API_TIMEOUT);
+        return true;
+    }
+    catch {
+        try {
+            await withTimeout(api.editMessageText(chatId, messageId, text), API_TIMEOUT);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+/**
+ * Delete a message, ignoring errors.
+ */
+export async function safeDelete(api, chatId, messageId) {
+    try {
+        await withTimeout(api.deleteMessage(chatId, messageId), API_TIMEOUT);
+    }
+    catch {
+        // Ignore — message may already be deleted or too old
+    }
+}
+/**
+ * Truncate text to fit Telegram's limit.
+ */
+export function truncate(text, maxLen = SAFE_LENGTH) {
+    if (text.length <= maxLen)
+        return text;
+    return `${text.slice(0, maxLen - 20)}\n\n_(truncated)_`;
+}
+/**
+ * Rate-limited message editor — debounces rapid edits to avoid Telegram 429s.
+ * Minimum 2 seconds between edits to the same message.
+ */
+export class DebouncedEditor {
+    api;
+    pending = new Map();
+    lastEdit = new Map();
+    minInterval = 2000; // 2s between edits
+    constructor(api) {
+        this.api = api;
+    }
+    /**
+     * Schedule an edit. If another edit comes in before the debounce fires,
+     * the previous one is replaced.
+     */
+    edit(chatId, messageId, text) {
+        const key = `${chatId}:${messageId}`;
+        const existing = this.pending.get(key);
+        if (existing)
+            clearTimeout(existing.timer);
+        const lastTime = this.lastEdit.get(key) || 0;
+        const elapsed = Date.now() - lastTime;
+        const delay = Math.max(0, this.minInterval - elapsed);
+        const timer = setTimeout(() => {
+            this.pending.delete(key);
+            this.lastEdit.set(key, Date.now());
+            void safeEdit(this.api, chatId, messageId, text);
+        }, delay);
+        this.pending.set(key, { text, timer });
+    }
+    /**
+     * Force flush a pending edit immediately (e.g., before deleting the message).
+     */
+    async flush(chatId, messageId) {
+        const key = `${chatId}:${messageId}`;
+        const existing = this.pending.get(key);
+        if (existing) {
+            clearTimeout(existing.timer);
+            this.pending.delete(key);
+            this.lastEdit.set(key, Date.now());
+            await safeEdit(this.api, chatId, messageId, existing.text);
+        }
+    }
+    /** Cancel all pending edits. */
+    clear() {
+        for (const { timer } of this.pending.values())
+            clearTimeout(timer);
+        this.pending.clear();
+    }
+}
+export function log(msg) {
+    console.error(msg);
+}
+//# sourceMappingURL=telegram.js.map

package/dist/util/telegram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.js","sourceRoot":"","sources":["../../src/util/telegram.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,0DAA0D;AAEpF;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAI,OAAmB,EAAE,EAAU,EAAc;IAC3E,IAAI,KAAoC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;QACjD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,8BAA8B,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAAA,CACtF,CAAC,CAAC;IACH,yEAAyE;IACzE,8EAA8E;IAC9E,8CAA8C;IAC9C,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAC,CAAC,CAAC,CAAC;IACxB,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAM,CAAC,CAAC,CAAC;AAAA,CAC5E;AAED,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,4BAA4B;AAExD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAQ,EAAE,MAAc,EAAE,IAAY,EAAE,SAAkB,EAAmB;IAC3G,4FAA0F;IAC1F,IAAI,IAAI,CAAC,MAAM,GAAG,WAAW;QAAE,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAClE,IAAI,CAAC;QACJ,MAAM,GAAG,GAAG,MAAM,WAAW,CAC5B,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE;YAC7B,UAAU,EAAE,UAAU;YACtB,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrE,CAAC,EACF,WAAW,CACX,CAAC;QACF,OAAO,GAAG,CAAC,UAAU,CAAC;IACvB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,qEAAqE;QACrE,+EAA6E;QAC7E,sEAAsE;QACtE,mCAAmC;QACnC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9B,GAAG,CAAC,kCAAkC,CAAC,EAAE,CAAC,CAAC;YAC3C,OAAO,CAAC,CAAC;QACV,CAAC;QACD,IAAI,CAAC;YACJ,MAAM,GAAG,GAAG,MAAM,WAAW,CAC5B,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE;gBAC7B,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrE,CAAC,EACF,WAAW,CACX,CAAC;YACF,OAAO,GAAG,CAAC,UAAU,CAAC;QACvB,CAAC;QAAC,OAAO,EAAE,EAAE,CAAC;YACb,GAAG,CAAC,wDAAwD,EAAE,EAAE,CAAC,CAAC;YAClE,OAAO,CAAC,CAAC;QACV,CAAC;IACF,CAAC;AAAA,CACD;AAED;;;;;GAKG;AACH,SAAS,oBAAoB,CAAC,CAAU,EAAW;IAClD,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9C,kCAAkC;IAClC,MAAM,IAAI,GAAI,CAAS,CAAC,UAAU,IAAK,CAAS,CAAC,MAAM,IAAK,CAAS,CAAC,UAAU,CAAC;IACjF,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAC9B,+DAA+D;IAC/D,MAAM,GAAG,GAAI,CAAS,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;IAC5C,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC;AAAA,CACvE;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAQ,EAAE,MAAc,EAAE,IAAY,EAAE,SAAkB,EAAmB;IAC3G,OAAO,IAAI,EAAE,CAAC;QACb,IAAI,IAAI,CAAC,MAAM,IAAI,WAAW,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;YAC3D,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAChC,CAAC;QACD,IAAI,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAClD,IAAI,OAAO,GAAG,IAAI;YAAE,OAAO,GAAG,WAAW,CAAC;QAC1C,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,CAAC;QAC7E,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,CAAC,kEAAgE;QAC9F,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC/C,SAAS,GAAG,SAAS,CAAC,CAAC,gCAAgC;IACxD,CAAC;IACD,OAAO,EAAE,CAAC;AAAA,CACV;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAQ,EAAE,MAAc,EAAE,SAAiB,EAAE,IAAY,EAAoB;IAC3G,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACnC,IAAI,CAAC;QACJ,MAAM,WAAW,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;QACzG,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACR,IAAI,CAAC;YACJ,MAAM,WAAW,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC;YAC7E,OAAO,IAAI,CAAC;QACb,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC;AAAA,CACD;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAQ,EAAE,MAAc,EAAE,SAAiB,EAAiB;IAC5F,IAAI,CAAC;QACJ,MAAM,WAAW,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,WAAW,CAAC,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACR,uDAAqD;IACtD,CAAC;AAAA,CACD;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,MAAM,GAAG,WAAW,EAAU;IACpE,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,EAAE,CAAC,mBAAmB,CAAC;AAAA,CACxD;AAED;;;GAGG;AACH,MAAM,OAAO,eAAe;IAKP,GAAG;IAJf,OAAO,GAAwE,IAAI,GAAG,EAAE,CAAC;IACzF,QAAQ,GAAwB,IAAI,GAAG,EAAE,CAAC;IACjC,WAAW,GAAG,IAAI,CAAC,CAAC,mBAAmB;IAExD,YAAoB,GAAQ,EAAE;mBAAV,GAAG;IAAQ,CAAC;IAEhC;;;OAGG;IACH,IAAI,CAAC,MAAc,EAAE,SAAiB,EAAE,IAAY,EAAQ;QAC3D,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,QAAQ;YAAE,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAE3C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,CAAC;QAEtD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC;YAC9B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YACnC,KAAK,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QAAA,CACjD,EAAE,KAAK,CAAC,CAAC;QAEV,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAAA,CACvC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,SAAiB,EAAiB;QAC7D,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,QAAQ,EAAE,CAAC;YACd,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC7B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YACnC,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC5D,CAAC;IAAA,CACD;IAED,gCAAgC;IAChC,KAAK,GAAS;QACb,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QACnE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAAA,CACrB;CACD;AAED,MAAM,UAAU,GAAG,CAAC,GAAW,EAAQ;IACtC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAAA,CACnB","sourcesContent":["/**\n * Telegram message utilities — splitting, markdown fallback, rate-limit debounce.\n */\n\nimport type { Api } from \"grammy\";\n\nconst SAFE_LENGTH = 4000; // Leave room for markdown overhead (Telegram max is 4096)\n\n/**\n * Wrap a promise with a timeout. Rejects with an error if the promise\n * doesn't settle within `ms` milliseconds. Used to prevent Telegram API\n * calls from hanging the event chain indefinitely.\n *\n * The timer is cleared when the promise settles to avoid accumulating\n * stale timers in the Node.js timer heap during heavy message runs.\n */\nexport function withTimeout<T>(promise: Promise<T>, ms: number): Promise<T> {\n\tlet timer: ReturnType<typeof setTimeout>;\n\tconst timeout = new Promise<never>((_, reject) => {\n\t\ttimer = setTimeout(() => reject(new Error(`Telegram API timeout after ${ms}ms`)), ms);\n\t});\n\t// Prevent unhandled rejection from the slow promise if the timeout wins.\n\t// Without this, a late rejection after timeout becomes an unhandled rejection\n\t// which crashes the process in Node.js >= 15.\n\tpromise.catch(() => {});\n\treturn Promise.race([promise, timeout]).finally(() => clearTimeout(timer!));\n}\n\nconst API_TIMEOUT = 15_000; // 15s per Telegram API call\n\n/**\n * Send a message, falling back to plain text if Markdown fails.\n */\nexport async function safeSend(api: Api, chatId: number, text: string, replyToId?: number): Promise<number> {\n\t// Truncate to Telegram's limit — callers sending long content should use sendLong instead\n\tif (text.length > SAFE_LENGTH) text = truncate(text, SAFE_LENGTH);\n\ttry {\n\t\tconst msg = await withTimeout(\n\t\t\tapi.sendMessage(chatId, text, {\n\t\t\t\tparse_mode: \"Markdown\",\n\t\t\t\t...(replyToId ? { reply_parameters: { message_id: replyToId } } : {}),\n\t\t\t}),\n\t\t\tAPI_TIMEOUT,\n\t\t);\n\t\treturn msg.message_id;\n\t} catch (e) {\n\t\t// Only retry as plain text for Markdown parse errors (Telegram 400).\n\t\t// For timeouts/network errors, the original request may still be in-flight —\n\t\t// retrying would risk delivering duplicate messages. Return 0 and let\n\t\t// the outbox retry loop handle it.\n\t\tif (!isTelegramParseError(e)) {\n\t\t\tlog(`[WARN] Failed to send message: ${e}`);\n\t\t\treturn 0;\n\t\t}\n\t\ttry {\n\t\t\tconst msg = await withTimeout(\n\t\t\t\tapi.sendMessage(chatId, text, {\n\t\t\t\t\t...(replyToId ? { reply_parameters: { message_id: replyToId } } : {}),\n\t\t\t\t}),\n\t\t\t\tAPI_TIMEOUT,\n\t\t\t);\n\t\t\treturn msg.message_id;\n\t\t} catch (e2) {\n\t\t\tlog(`[WARN] Failed to send message (plain text fallback): ${e2}`);\n\t\t\treturn 0;\n\t\t}\n\t}\n}\n\n/**\n * Check if an error is a Telegram API parse error (HTTP 400 for bad Markdown).\n * These are safe to retry as plain text because the original request definitively\n * failed — Telegram won't deliver it. Timeouts and network errors are NOT safe\n * to retry immediately because the in-flight request may still succeed.\n */\nfunction isTelegramParseError(e: unknown): boolean {\n\tif (!e || typeof e !== \"object\") return false;\n\t// grammy HttpError has error_code\n\tconst code = (e as any).error_code ?? (e as any).status ?? (e as any).statusCode;\n\tif (code === 400) return true;\n\t// Fallback: check message for common Telegram parse error text\n\tconst msg = (e as any).message ?? String(e);\n\treturn typeof msg === \"string\" && msg.includes(\"can't parse entities\");\n}\n\n/**\n * Send a long message, splitting at newline boundaries.\n * Stops on first chunk failure to avoid resending already-delivered chunks\n * on retry. Returns the remaining (undelivered) text, or empty string if\n * everything was delivered.\n */\nexport async function sendLong(api: Api, chatId: number, text: string, replyToId?: number): Promise<string> {\n\twhile (text) {\n\t\tif (text.length <= SAFE_LENGTH) {\n\t\t\tconst msgId = await safeSend(api, chatId, text, replyToId);\n\t\t\treturn msgId === 0 ? text : \"\";\n\t\t}\n\t\tlet splitAt = text.lastIndexOf(\"\\n\", SAFE_LENGTH);\n\t\tif (splitAt < 2000) splitAt = SAFE_LENGTH;\n\t\tconst msgId = await safeSend(api, chatId, text.slice(0, splitAt), replyToId);\n\t\tif (msgId === 0) return text; // Stop — return full remaining text including this failed chunk\n\t\ttext = text.slice(splitAt).replace(/^\\n+/, \"\");\n\t\treplyToId = undefined; // Only reply to the first chunk\n\t}\n\treturn \"\";\n}\n\n/**\n * Edit a message safely, falling back to plain text.\n */\nexport async function safeEdit(api: Api, chatId: number, messageId: number, text: string): Promise<boolean> {\n\ttext = truncate(text, SAFE_LENGTH);\n\ttry {\n\t\tawait withTimeout(api.editMessageText(chatId, messageId, text, { parse_mode: \"Markdown\" }), API_TIMEOUT);\n\t\treturn true;\n\t} catch {\n\t\ttry {\n\t\t\tawait withTimeout(api.editMessageText(chatId, messageId, text), API_TIMEOUT);\n\t\t\treturn true;\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t}\n}\n\n/**\n * Delete a message, ignoring errors.\n */\nexport async function safeDelete(api: Api, chatId: number, messageId: number): Promise<void> {\n\ttry {\n\t\tawait withTimeout(api.deleteMessage(chatId, messageId), API_TIMEOUT);\n\t} catch {\n\t\t// Ignore — message may already be deleted or too old\n\t}\n}\n\n/**\n * Truncate text to fit Telegram's limit.\n */\nexport function truncate(text: string, maxLen = SAFE_LENGTH): string {\n\tif (text.length <= maxLen) return text;\n\treturn `${text.slice(0, maxLen - 20)}\\n\\n_(truncated)_`;\n}\n\n/**\n * Rate-limited message editor — debounces rapid edits to avoid Telegram 429s.\n * Minimum 2 seconds between edits to the same message.\n */\nexport class DebouncedEditor {\n\tprivate pending: Map<string, { text: string; timer: ReturnType<typeof setTimeout> }> = new Map();\n\tprivate lastEdit: Map<string, number> = new Map();\n\tprivate readonly minInterval = 2000; // 2s between edits\n\n\tconstructor(private api: Api) {}\n\n\t/**\n\t * Schedule an edit. If another edit comes in before the debounce fires,\n\t * the previous one is replaced.\n\t */\n\tedit(chatId: number, messageId: number, text: string): void {\n\t\tconst key = `${chatId}:${messageId}`;\n\t\tconst existing = this.pending.get(key);\n\t\tif (existing) clearTimeout(existing.timer);\n\n\t\tconst lastTime = this.lastEdit.get(key) || 0;\n\t\tconst elapsed = Date.now() - lastTime;\n\t\tconst delay = Math.max(0, this.minInterval - elapsed);\n\n\t\tconst timer = setTimeout(() => {\n\t\t\tthis.pending.delete(key);\n\t\t\tthis.lastEdit.set(key, Date.now());\n\t\t\tvoid safeEdit(this.api, chatId, messageId, text);\n\t\t}, delay);\n\n\t\tthis.pending.set(key, { text, timer });\n\t}\n\n\t/**\n\t * Force flush a pending edit immediately (e.g., before deleting the message).\n\t */\n\tasync flush(chatId: number, messageId: number): Promise<void> {\n\t\tconst key = `${chatId}:${messageId}`;\n\t\tconst existing = this.pending.get(key);\n\t\tif (existing) {\n\t\t\tclearTimeout(existing.timer);\n\t\t\tthis.pending.delete(key);\n\t\t\tthis.lastEdit.set(key, Date.now());\n\t\t\tawait safeEdit(this.api, chatId, messageId, existing.text);\n\t\t}\n\t}\n\n\t/** Cancel all pending edits. */\n\tclear(): void {\n\t\tfor (const { timer } of this.pending.values()) clearTimeout(timer);\n\t\tthis.pending.clear();\n\t}\n}\n\nexport function log(msg: string): void {\n\tconsole.error(msg);\n}\n"]}

package/package.json

@@ -0,0 +1,49 @@
+{
+	"name": "@dreb/telegram",
+	"version": "1.16.0",
+	"description": "Telegram bot frontend for dreb coding agent",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"bin": {
+		"dreb-telegram": "./dist/index.js"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"files": [
+		"dist",
+		"README.md",
+		"CHANGELOG.md"
+	],
+	"scripts": {
+		"clean": "shx rm -rf dist",
+		"build": "tsgo -p tsconfig.build.json && shx chmod +x dist/index.js",
+		"dev": "tsgo -p tsconfig.build.json --watch --preserveWatchOutput",
+		"test": "vitest --run",
+		"prepublishOnly": "npm run clean && npm run build"
+	},
+	"dependencies": {
+		"@dreb/coding-agent": "^1.0.0",
+		"grammy": "^1.35.0"
+	},
+	"devDependencies": {
+		"@types/node": "^24.3.0",
+		"typescript": "^5.9.2",
+		"vitest": "^3.2.4"
+	},
+	"engines": {
+		"node": ">=20.0.0"
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/aebrer/dreb.git",
+		"directory": "packages/telegram"
+	}
+}