@krischoichoi/channel-telegram 0.6.0

package/lib/render/markdown.js

@@ -0,0 +1,187 @@
+import { fromMarkdown } from 'mdast-util-from-markdown';
+import { gfmFromMarkdown, gfmToMarkdown } from 'mdast-util-gfm';
+import { toMarkdown } from 'mdast-util-to-markdown';
+import { toString } from 'mdast-util-to-string';
+import { gfm } from 'micromark-extension-gfm';
+import { RICH_MESSAGE_MAX_BLOCKS, RICH_MESSAGE_MAX_NESTING, RICH_MESSAGE_MAX_TABLE_COLUMNS, RICH_MESSAGE_MAX_UTF8, } from '../rich-message.js';
+import { splitByUtf8Graphemes, utf8Length } from './segment.js';
+export function parseMarkdown(source) {
+    return fromMarkdown(source, {
+        extensions: [gfm()],
+        mdastExtensions: [gfmFromMarkdown()],
+    });
+}
+function serializeNode(node) {
+    return toMarkdown({ type: 'root', children: [node] }, { extensions: [gfmToMarkdown()] }).trimEnd();
+}
+function tableCells(row) {
+    return row.children.map((cell) => toString(cell));
+}
+function sourceMarkdown(source, node) {
+    const start = node.position?.start.offset;
+    const end = node.position?.end.offset;
+    if (start !== undefined && end !== undefined)
+        return source.slice(start, end).trimEnd();
+    return serializeNode(node);
+}
+function asBlock(source, node) {
+    const markdown = sourceMarkdown(source, node);
+    switch (node.type) {
+        case 'code':
+            return { kind: 'code', lang: node.lang ?? '', code: node.value, node, markdown };
+        case 'heading':
+            return { kind: 'heading', level: node.depth, text: toString(node), node, markdown };
+        case 'table':
+            return {
+                kind: 'table',
+                header: node.children[0] ? tableCells(node.children[0]) : [],
+                rows: node.children.slice(1).map(tableCells),
+                node,
+                markdown,
+            };
+        case 'blockquote':
+            return { kind: 'blockquote', content: toString(node), node, markdown };
+        case 'list':
+            return {
+                kind: 'list',
+                ordered: node.ordered === true,
+                items: node.children.map((item) => toString(item)),
+                node,
+                markdown,
+            };
+        default:
+            return { kind: 'paragraph', text: toString(node) || markdown, node, markdown };
+    }
+}
+export function tokenizeMarkdown(source) {
+    if (!source)
+        return [];
+    return parseMarkdown(source).children.map((node) => asBlock(source, node));
+}
+export function renderBlock(block) {
+    return block.markdown;
+}
+function nodeStats(node) {
+    let count = 0;
+    let maxDepth = 0;
+    const visit = (value, depth) => {
+        if (!value || typeof value !== 'object')
+            return;
+        count += 1;
+        maxDepth = Math.max(maxDepth, depth);
+        const children = value.children;
+        for (const child of children ?? [])
+            visit(child, depth + 1);
+    };
+    visit(node, 1);
+    return { count, depth: maxDepth };
+}
+const MARKDOWN_LITERAL = /[\\`*_[\]{}()<>#+\-.!|>~=]/;
+/** Escape literal text and pack complete escape sequences under a byte limit. */
+function literalChunks(value, limit) {
+    const segmenter = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
+    const chunks = [];
+    let current = '';
+    let bytes = 0;
+    for (const item of segmenter.segment(value)) {
+        const escaped = MARKDOWN_LITERAL.test(item.segment) ? `\\${item.segment}` : item.segment;
+        const size = utf8Length(escaped);
+        if (current && bytes + size > limit) {
+            chunks.push(current);
+            current = '';
+            bytes = 0;
+        }
+        current += escaped;
+        bytes += size;
+    }
+    if (current)
+        chunks.push(current);
+    return chunks;
+}
+function splitCode(node, limit) {
+    const bodyBudget = Math.max(1, limit - utf8Length(node.lang ?? '') - 16);
+    const result = [];
+    for (const value of splitByUtf8Graphemes(node.value, bodyBudget)) {
+        const markdown = serializeNode({ ...node, value });
+        if (utf8Length(markdown) <= limit)
+            result.push(markdown);
+        else
+            result.push(...literalChunks(value, limit));
+    }
+    return result;
+}
+function splitTable(node, limit) {
+    if (node.children.length === 0 || node.children[0].children.length > RICH_MESSAGE_MAX_TABLE_COLUMNS) {
+        return literalChunks(toString(node), limit);
+    }
+    const header = node.children[0];
+    const chunks = [];
+    let rows = [];
+    const flush = () => {
+        if (rows.length === 0)
+            return;
+        chunks.push(serializeNode({ ...node, children: [header, ...rows] }));
+        rows = [];
+    };
+    for (const row of node.children.slice(1)) {
+        const candidate = serializeNode({ ...node, children: [header, ...rows, row] });
+        if (utf8Length(candidate) <= limit) {
+            rows.push(row);
+            continue;
+        }
+        flush();
+        const single = serializeNode({ ...node, children: [header, row] });
+        if (utf8Length(single) <= limit)
+            chunks.push(single);
+        else
+            chunks.push(...literalChunks(toString(row), limit));
+    }
+    flush();
+    return chunks.length > 0 ? chunks : [serializeNode(node)];
+}
+function splitBlock(block, limit) {
+    if (block.node.type === 'code')
+        return splitCode(block.node, limit);
+    if (block.node.type === 'table')
+        return splitTable(block.node, limit);
+    return literalChunks(toString(block.node) || block.markdown, limit);
+}
+/** Segment parsed blocks under Telegram's byte, block-count, and depth limits. */
+export function segmentRich(blocks, limit = RICH_MESSAGE_MAX_UTF8) {
+    const messages = [];
+    let current = [];
+    let bytes = 0;
+    let blocksInMessage = 0;
+    const flush = () => {
+        if (current.length > 0)
+            messages.push(current.join('\n\n'));
+        current = [];
+        bytes = 0;
+        blocksInMessage = 0;
+    };
+    for (const block of blocks) {
+        const stats = nodeStats(block.node);
+        const rendered = block.markdown;
+        const renderedBytes = utf8Length(rendered);
+        const separator = current.length > 0 ? 2 : 0;
+        const unsafeStructure = stats.depth > RICH_MESSAGE_MAX_NESTING || stats.count > RICH_MESSAGE_MAX_BLOCKS;
+        if (unsafeStructure || renderedBytes > limit) {
+            flush();
+            messages.push(...splitBlock(block, limit));
+            continue;
+        }
+        if (bytes + separator + renderedBytes > limit ||
+            blocksInMessage + stats.count > RICH_MESSAGE_MAX_BLOCKS)
+            flush();
+        current.push(rendered);
+        bytes += (current.length > 1 ? 2 : 0) + renderedBytes;
+        blocksInMessage += stats.count;
+    }
+    flush();
+    return messages;
+}
+export function renderRichMarkdown(source, limit = RICH_MESSAGE_MAX_UTF8) {
+    return segmentRich(tokenizeMarkdown(source), limit);
+}
+export { tokenizeMarkdown as tokenize };
+//# sourceMappingURL=markdown.js.map

package/lib/render/markdown.js.map

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

package/lib/render/plain.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Plain fallback + MarkdownV2 escaping renderers (plan §5.3 / §20.9).
+ *
+ * - `renderPlain(source)`   — best-effort plain-text fallback, segmented at the
+ *   regular 4096 grapheme-safe limit. Used when a rich/formatted send fails
+ *   with a *format* error (and only then).
+ * - `renderPlainCaption()`  — the 1024-caption variant.
+ * - `escapeMarkdownV2(...)` — full escaping of MarkdownV2 special characters.
+ *   The adapter NEVER sends raw Agent Markdown as MarkdownV2
+ *   (plan §5.3 red line); a `markdown-v2` config mode must pass every literal
+ *   through this escape first.
+ *
+ * The plain fallback is deliberately structural: it strips Markdown markup so
+ * the user still sees readable text (headers, bold, code) instead of raw
+ * `**`/`#`/backticks, while never throwing on unfinished Markdown.
+ */
+import { type MarkdownBlock } from './markdown.js';
+/** Strip inline Markdown from a single line/paragraph. */
+export declare function inlineMarkdownToPlain(text: string): string;
+/** Render one block to plain text. */
+export declare function blockToPlain(block: MarkdownBlock): string;
+/** Convert Markdown source to a single plain-text string. */
+export declare function markdownToPlain(source: string): string;
+/** Segment plain text into ≤ `limit` grapheme chunks. */
+export declare function segmentPlain(text: string, limit?: number): string[];
+/** Plain fallback for regular messages (4096). */
+export declare function renderPlain(source: string, limit?: number): string[];
+/** Plain fallback for media captions (1024). */
+export declare function renderPlainCaption(source: string, limit?: number): string[];
+/**
+ * Escape a piece of literal text for Telegram MarkdownV2 so it cannot be
+ * interpreted as formatting. This is the ONLY sanctioned way to send Agent
+ * Markdown in `markdown-v2` mode — never pass raw Agent Markdown as the body.
+ */
+export declare function escapeMarkdownV2(text: string): string;
+/**
+ * Render MarkdownV2-escaped chunks. `markdown-v2` is an expert-compat mode:
+ * the RAW Agent Markdown is fully escaped so Telegram never interprets it as
+ * formatting (plan §5.3 red line — never send raw Agent Markdown as a
+ * MarkdownV2 body). The visible text keeps its original markdown source.
+ */
+export declare function renderMarkdownV2(source: string, limit?: number): string[];
+//# sourceMappingURL=plain.d.ts.map

package/lib/render/plain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain.d.ts","sourceRoot":"","sources":["../../src/render/plain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAIrE,0DAA0D;AAC1D,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,sCAAsC;AACtC,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAoBzD;AAED,6DAA6D;AAC7D,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAsB,GAAG,MAAM,EAAE,CAEhF;AAED,kDAAkD;AAClD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAsB,GAAG,MAAM,EAAE,CAGjF;AAED,gDAAgD;AAChD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAc,GAAG,MAAM,EAAE,CAIhF;AAKD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAsB,GAAG,MAAM,EAAE,CAGtF"}

package/lib/render/plain.js

@@ -0,0 +1,97 @@
+/**
+ * Plain fallback + MarkdownV2 escaping renderers (plan §5.3 / §20.9).
+ *
+ * - `renderPlain(source)`   — best-effort plain-text fallback, segmented at the
+ *   regular 4096 grapheme-safe limit. Used when a rich/formatted send fails
+ *   with a *format* error (and only then).
+ * - `renderPlainCaption()`  — the 1024-caption variant.
+ * - `escapeMarkdownV2(...)` — full escaping of MarkdownV2 special characters.
+ *   The adapter NEVER sends raw Agent Markdown as MarkdownV2
+ *   (plan §5.3 red line); a `markdown-v2` config mode must pass every literal
+ *   through this escape first.
+ *
+ * The plain fallback is deliberately structural: it strips Markdown markup so
+ * the user still sees readable text (headers, bold, code) instead of raw
+ * `**`/`#`/backticks, while never throwing on unfinished Markdown.
+ */
+import { tokenizeMarkdown } from './markdown.js';
+import { splitByGraphemes } from './segment.js';
+import { CAPTION_MAX, REGULAR_MESSAGE_MAX } from '../rich-message.js';
+/** Strip inline Markdown from a single line/paragraph. */
+export function inlineMarkdownToPlain(text) {
+    return text
+        .replace(/\*\*(.+?)\*\*/g, '$1')
+        .replace(/\*(.+?)\*/g, '$1')
+        .replace(/`([^`]+)`/g, '$1')
+        .replace(/\[([^\]]*)\]\([^)]*\)/g, '$1');
+}
+/** Render one block to plain text. */
+export function blockToPlain(block) {
+    switch (block.kind) {
+        case 'heading':
+            return block.text;
+        case 'code':
+            return block.code;
+        case 'table':
+            return [
+                `| ${block.header.join(' | ')} |`,
+                ...block.rows.map((row) => `| ${row.join(' | ')} |`),
+            ].join('\n');
+        case 'blockquote':
+            return block.content.split('\n').map((line) => `> ${line}`).join('\n');
+        case 'list':
+            return block.items
+                .map((item, idx) => `${block.ordered ? `${idx + 1}.` : '-'} ${inlineMarkdownToPlain(item)}`)
+                .join('\n');
+        case 'paragraph':
+            return inlineMarkdownToPlain(block.text);
+    }
+}
+/** Convert Markdown source to a single plain-text string. */
+export function markdownToPlain(source) {
+    if (source.length === 0)
+        return '';
+    return tokenizeMarkdown(source)
+        .map(blockToPlain)
+        .filter((text) => text.length > 0)
+        .join('\n\n');
+}
+/** Segment plain text into ≤ `limit` grapheme chunks. */
+export function segmentPlain(text, limit = REGULAR_MESSAGE_MAX) {
+    return splitByGraphemes(text, limit);
+}
+/** Plain fallback for regular messages (4096). */
+export function renderPlain(source, limit = REGULAR_MESSAGE_MAX) {
+    if (source.length === 0)
+        return [];
+    return segmentPlain(markdownToPlain(source), limit);
+}
+/** Plain fallback for media captions (1024). */
+export function renderPlainCaption(source, limit = CAPTION_MAX) {
+    if (source.length === 0)
+        return [''];
+    const chunks = segmentPlain(markdownToPlain(source), limit);
+    return chunks.length > 0 ? chunks : [''];
+}
+/** Characters Telegram's MarkdownV2 parser reserves; each must be escaped. */
+const MARKDOWN_V2_SPECIAL = /[_*[\]()~`>#+\-=|{}.!\\]/g;
+/**
+ * Escape a piece of literal text for Telegram MarkdownV2 so it cannot be
+ * interpreted as formatting. This is the ONLY sanctioned way to send Agent
+ * Markdown in `markdown-v2` mode — never pass raw Agent Markdown as the body.
+ */
+export function escapeMarkdownV2(text) {
+    return text.replace(MARKDOWN_V2_SPECIAL, '\\$&');
+}
+/**
+ * Render MarkdownV2-escaped chunks. `markdown-v2` is an expert-compat mode:
+ * the RAW Agent Markdown is fully escaped so Telegram never interprets it as
+ * formatting (plan §5.3 red line — never send raw Agent Markdown as a
+ * MarkdownV2 body). The visible text keeps its original markdown source.
+ */
+export function renderMarkdownV2(source, limit = REGULAR_MESSAGE_MAX) {
+    if (source.length === 0)
+        return [];
+    return splitByGraphemes(escapeMarkdownV2(source), limit);
+}
+//# sourceMappingURL=plain.js.map

package/lib/render/plain.js.map

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

package/lib/render/segment.d.ts

@@ -0,0 +1,39 @@
+/** UTF-8 byte length used by Telegram Rich Message limits. */
+export declare function utf8Length(text: string): number;
+/** Split by UTF-8 byte budget without cutting a grapheme cluster. */
+export declare function splitByUtf8Graphemes(text: string, maxBytes: number): string[];
+/**
+ * Total visible length of `text` in grapheme clusters (not code points). Used
+ * for the caption / regular rich-message length gates.
+ */
+export declare function visibleLength(text: string): number;
+/**
+ * Split `text` into chunks not exceeding `maxLength` grapheme clusters.
+ *
+ * Guarantees:
+ * - no chunk exceeds `maxLength` grapheme clusters
+ * - never cuts a grapheme cluster in half
+ * - joins graphemes back into the original text in order
+ */
+export declare function splitByGraphemes(text: string, maxLength: number): string[];
+/**
+ * Split an already-linearized grapheme array into chunks of at most `maxLength`
+ * clusters. This is the low-level primitive used by the block-aware renderer
+ * (which works over logical text ranges, not arbitrary code-point slices).
+ */
+export declare function splitGraphemeList(graphemeList: string[], maxLength: number): string[][];
+/**
+ * Hard-limit a single text to `maxLength` grapheme clusters, truncating at a
+ * grapheme boundary (never mid-cluster). Used for placeholder text and editor
+ * previews where splitting is not desired.
+ */
+export declare function truncateGraphemes(text: string, maxLength: number): string;
+/** Return the LAST `n` grapheme clusters of `text` (never mid-cluster). */
+export declare function tailGraphemes(text: string, n: number): string;
+/** Built-in message length limits for plain/regular output. */
+export declare const LIMITS: {
+    readonly regular: 4096;
+    readonly caption: 1024;
+    readonly rich: 32768;
+};
+//# sourceMappingURL=segment.d.ts.map

package/lib/render/segment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"segment.d.ts","sourceRoot":"","sources":["../../src/render/segment.ts"],"names":[],"mappings":"AA4BA,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,qEAAqE;AACrE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAyB7E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAI1E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAYvF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED,+DAA+D;AAC/D,eAAO,MAAM,MAAM;;;;CAIT,CAAC"}

package/lib/render/segment.js

@@ -0,0 +1,117 @@
+/**
+ * Unicode-safe segmentation helpers (execution plan §7.2 / §20.8).
+ *
+ * The legacy splitter (`Array.from(text)` + code-point slicing in the streaming
+ * reply) can cut a grapheme cluster (emoji ZWJ sequences, flags, variation
+ * selectors, combining marks) in the middle, producing broken glyphs and, worse,
+ * breaking a Markdown code fence / table row mid-stream.
+ *
+ * This module is the single place that performs caller-visible character math
+ * for fallback/plain output. It uses `Intl.Segmenter(grapheme)` so a user-visible
+ * character never spans two messages.
+ */
+import { CAPTION_MAX, REGULAR_MESSAGE_MAX, RICH_MESSAGE_MAX_UTF8, } from '../rich-message.js';
+let segmenter;
+/** Lazily-built, shared grapheme segmenter (Node >= 16 has Intl.Segmenter). */
+function graphemes(text) {
+    segmenter ??= new Intl.Segmenter(undefined, { granularity: 'grapheme' });
+    return [...segmenter.segment(text)].map((s) => s.segment);
+}
+const encoder = new TextEncoder();
+/** UTF-8 byte length used by Telegram Rich Message limits. */
+export function utf8Length(text) {
+    return encoder.encode(text).byteLength;
+}
+/** Split by UTF-8 byte budget without cutting a grapheme cluster. */
+export function splitByUtf8Graphemes(text, maxBytes) {
+    if (text.length === 0)
+        return [];
+    if (maxBytes <= 0)
+        return [text];
+    const chunks = [];
+    let current = '';
+    let currentBytes = 0;
+    for (const grapheme of graphemes(text)) {
+        const bytes = utf8Length(grapheme);
+        if (current && currentBytes + bytes > maxBytes) {
+            chunks.push(current);
+            current = '';
+            currentBytes = 0;
+        }
+        if (bytes > maxBytes) {
+            if (current)
+                chunks.push(current);
+            chunks.push(grapheme);
+            current = '';
+            currentBytes = 0;
+            continue;
+        }
+        current += grapheme;
+        currentBytes += bytes;
+    }
+    if (current)
+        chunks.push(current);
+    return chunks;
+}
+/**
+ * Total visible length of `text` in grapheme clusters (not code points). Used
+ * for the caption / regular rich-message length gates.
+ */
+export function visibleLength(text) {
+    return graphemes(text).length;
+}
+/**
+ * Split `text` into chunks not exceeding `maxLength` grapheme clusters.
+ *
+ * Guarantees:
+ * - no chunk exceeds `maxLength` grapheme clusters
+ * - never cuts a grapheme cluster in half
+ * - joins graphemes back into the original text in order
+ */
+export function splitByGraphemes(text, maxLength) {
+    if (maxLength <= 0)
+        return text.length === 0 ? [] : [text];
+    if (text.length === 0)
+        return [];
+    return splitGraphemeList(graphemes(text), maxLength).map((list) => list.join(''));
+}
+/**
+ * Split an already-linearized grapheme array into chunks of at most `maxLength`
+ * clusters. This is the low-level primitive used by the block-aware renderer
+ * (which works over logical text ranges, not arbitrary code-point slices).
+ */
+export function splitGraphemeList(graphemeList, maxLength) {
+    const chunks = [];
+    let current = [];
+    for (const g of graphemeList) {
+        current.push(g);
+        if (current.length >= maxLength) {
+            chunks.push(current);
+            current = [];
+        }
+    }
+    if (current.length > 0)
+        chunks.push(current);
+    return chunks;
+}
+/**
+ * Hard-limit a single text to `maxLength` grapheme clusters, truncating at a
+ * grapheme boundary (never mid-cluster). Used for placeholder text and editor
+ * previews where splitting is not desired.
+ */
+export function truncateGraphemes(text, maxLength) {
+    return graphemes(text).slice(0, maxLength).join('');
+}
+/** Return the LAST `n` grapheme clusters of `text` (never mid-cluster). */
+export function tailGraphemes(text, n) {
+    if (n <= 0)
+        return '';
+    return graphemes(text).slice(-n).join('');
+}
+/** Built-in message length limits for plain/regular output. */
+export const LIMITS = {
+    regular: REGULAR_MESSAGE_MAX, // 4096
+    caption: CAPTION_MAX, // 1024
+    rich: RICH_MESSAGE_MAX_UTF8, // 32768
+};
+//# sourceMappingURL=segment.js.map

package/lib/render/segment.js.map

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

package/lib/rich-message.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Telegram Rich Message + interactive markup payload shapes (Bot API 10.2).
+ *
+ * This module owns ONLY the Telegram wire contract for rich output and inline
+ * buttons. It is a pure-type + constants module (no I/O, no HTTP) so that both
+ * the upstream driver and the mapper/outbound layers can share the shapes
+ * without duplicating protocol knowledge or pulling the renderer into the
+ * transport layer.
+ *
+ * Wire types come from `@grammyjs/types@4.0.0`, which tracks Bot API 10.2.
+ * The local aliases keep protocol details out of the adapter and renderer.
+ */
+import type { InputRichMessage as OfficialInputRichMessage, InlineKeyboardMarkup, Opts } from '@grammyjs/types';
+import type { TelegramErrorParameters } from './api-error.js';
+/** Rich Message content limits (plan §7.2, official 10.2). */
+export declare const RICH_MESSAGE_MAX_UTF8 = 32768;
+export declare const RICH_MESSAGE_MAX_BLOCKS = 500;
+export declare const RICH_MESSAGE_MAX_NESTING = 16;
+export declare const RICH_MESSAGE_MAX_MEDIA = 50;
+export declare const RICH_MESSAGE_MAX_TABLE_COLUMNS = 20;
+/** Regular text message limit after entity parsing (plan §7.1). */
+export declare const REGULAR_MESSAGE_MAX = 4096;
+/** Media caption limit after entity parsing (plan §7.1). */
+export declare const CAPTION_MAX = 1024;
+/** The official rich body for send, draft, and edit methods. */
+export type InputRichMessage = OfficialInputRichMessage<never>;
+export type TelegramInputRichMessage = InputRichMessage;
+export type SendRichMessageParams = Opts<never>['sendRichMessage'];
+export type SendRichMessageDraftParams = Opts<never>['sendRichMessageDraft'];
+export type EditMessageTextParams = Opts<never>['editMessageText'];
+/** Result of `sendRichMessage` / `sendRichMessageDraft`. */
+export interface RichMessageSent {
+    messageId: string;
+    /** Full Bot API envelope, kept for diagnostics. */
+    raw: unknown;
+}
+/**
+ * Telegram inline keyboard button. `style` is optional and only meaningful on
+ * Bot API 10.2+; every field is validated at the trust boundary in the mapper
+ * (untrusted callback_data is never trusted by the adapter).
+ */
+export type TelegramInlineKeyboardButton = InlineKeyboardMarkup['inline_keyboard'][number][number];
+/** Inline keyboard row. */
+export type TelegramInlineKeyboardRow = TelegramInlineKeyboardButton[];
+/** Inline keyboard markup (`reply_markup.inline_keyboard`). */
+export type TelegramInlineKeyboardMarkup = InlineKeyboardMarkup;
+/**
+ * The reply_markup value accepted by `sendMessage` / `sendMedia` /
+ * `editMessageText` / `answerCallbackQuery`-adjacent sends.
+ */
+export type TelegramReplyMarkup = TelegramInlineKeyboardMarkup | {
+    force_reply: boolean;
+    input_field_placeholder?: string;
+};
+/**
+ * `answerCallbackQuery` request body. `text`/`show_alert`/`url` are optional;
+ * the ACK only needs `callback_query_id` — used as a best-effort, non-blocking
+ * acknowledgement (plan §12.2).
+ */
+export interface AnswerCallbackQueryParams {
+    callback_query_id: string;
+    text?: string;
+    show_alert?: boolean;
+    url?: string;
+    /** Seconds to cache the answer (0–32). */
+    cache_time?: number;
+}
+/** Response shape shared by methods that return `true` or an error envelope. */
+export interface TelegramErrorEnvelope {
+    ok: boolean;
+    error_code?: number;
+    description?: string;
+    parameters?: TelegramErrorParameters;
+}
+//# sourceMappingURL=rich-message.d.ts.map

package/lib/rich-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rich-message.d.ts","sourceRoot":"","sources":["../src/rich-message.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,gBAAgB,IAAI,wBAAwB,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAChH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAE9D,8DAA8D;AAC9D,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAC3C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,4DAA4D;AAC5D,eAAO,MAAM,WAAW,OAAO,CAAC;AAEhC,gEAAgE;AAChE,MAAM,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;AAC/D,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,CAAC;AACxD,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,iBAAiB,CAAC,CAAC;AACnE,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,sBAAsB,CAAC,CAAC;AAC7E,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,iBAAiB,CAAC,CAAC;AAEnE,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,MAAM,4BAA4B,GAAG,oBAAoB,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnG,2BAA2B;AAC3B,MAAM,MAAM,yBAAyB,GAAG,4BAA4B,EAAE,CAAC;AAEvE,+DAA+D;AAC/D,MAAM,MAAM,4BAA4B,GAAG,oBAAoB,CAAC;AAEhE;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAC3B,4BAA4B,GAC5B;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,uBAAuB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,gFAAgF;AAChF,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,uBAAuB,CAAC;CACtC"}

package/lib/rich-message.js

@@ -0,0 +1,11 @@
+/** Rich Message content limits (plan §7.2, official 10.2). */
+export const RICH_MESSAGE_MAX_UTF8 = 32768;
+export const RICH_MESSAGE_MAX_BLOCKS = 500;
+export const RICH_MESSAGE_MAX_NESTING = 16;
+export const RICH_MESSAGE_MAX_MEDIA = 50;
+export const RICH_MESSAGE_MAX_TABLE_COLUMNS = 20;
+/** Regular text message limit after entity parsing (plan §7.1). */
+export const REGULAR_MESSAGE_MAX = 4096;
+/** Media caption limit after entity parsing (plan §7.1). */
+export const CAPTION_MAX = 1024;
+//# sourceMappingURL=rich-message.js.map

package/lib/rich-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rich-message.js","sourceRoot":"","sources":["../src/rich-message.ts"],"names":[],"mappings":"AAeA,8DAA8D;AAC9D,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAC3C,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAC3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAC3C,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AACzC,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,CAAC;AAEjD,mEAAmE;AACnE,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACxC,4DAA4D;AAC5D,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC"}