@yaebal/rich 0.0.1 → 0.0.3

package/lib/document.js

@@ -0,0 +1,46 @@
+/**
+ * the emitted rich message — a rendered dialect string plus the
+ * `InputRichMessage` flags, settable fluently (`.rtl()`, `.noEntityDetection()`).
+ *
+ * `sendRichMessage`/`RichMessageDraft` accept it directly, and `toJSON()`
+ * delegates to `toInputRichMessage()`, so even a raw `api.call` payload holding
+ * a `RichDocument` serializes into the correct `rich_message` shape.
+ */
+export class RichDocument {
+    dialect;
+    content;
+    #isRtl;
+    #skipEntityDetection;
+    constructor(dialect, content) {
+        this.dialect = dialect;
+        this.content = content;
+    }
+    /** `InputRichMessage.is_rtl` — show the message right-to-left. */
+    rtl(value = true) {
+        this.#isRtl = value;
+        return this;
+    }
+    /**
+     * `InputRichMessage.skip_entity_detection` — turn off auto-detection of urls,
+     * emails, `@mentions`, `#hashtags`, `$cashtags`, `/bot_commands`, and phone
+     * numbers in plain text.
+     */
+    noEntityDetection(value = true) {
+        this.#skipEntityDetection = value;
+        return this;
+    }
+    /** the `rich_message` method argument: `{ [dialect]: content, is_rtl?, skip_entity_detection? }`. */
+    toInputRichMessage() {
+        return {
+            [this.dialect]: this.content,
+            ...(this.#isRtl !== undefined ? { is_rtl: this.#isRtl } : {}),
+            ...(this.#skipEntityDetection !== undefined
+                ? { skip_entity_detection: this.#skipEntityDetection }
+                : {}),
+        };
+    }
+    toJSON() {
+        return this.toInputRichMessage();
+    }
+}
+//# sourceMappingURL=document.js.map

package/lib/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,OAAO,YAAY;IAKd;IACA;IALV,MAAM,CAAW;IACjB,oBAAoB,CAAW;IAE/B,YACU,OAAgB,EAChB,OAAe;QADf,YAAO,GAAP,OAAO,CAAS;QAChB,YAAO,GAAP,OAAO,CAAQ;IACtB,CAAC;IAEJ,kEAAkE;IAClE,GAAG,CAAC,KAAK,GAAG,IAAI;QACf,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,KAAK,GAAG,IAAI;QAC7B,IAAI,CAAC,oBAAoB,GAAG,KAAK,CAAC;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,qGAAqG;IACrG,kBAAkB;QACjB,OAAO;YACN,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO;YAC5B,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,GAAG,CAAC,IAAI,CAAC,oBAAoB,KAAK,SAAS;gBAC1C,CAAC,CAAC,EAAE,qBAAqB,EAAE,IAAI,CAAC,oBAAoB,EAAE;gBACtD,CAAC,CAAC,EAAE,CAAC;SACN,CAAC;IACH,CAAC;IAED,MAAM;QACL,OAAO,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAClC,CAAC;CACD"}

package/lib/draft.d.ts

@@ -1,5 +1,6 @@
 import type { Api, Message } from "@yaebal/core";
 import type { InputRichMessage } from "@yaebal/types";
+import { RichDocument } from "./document.js";
 export interface RichMessageDraftOptions {
     /**
      * how often to re-push the last draft to keep it alive, in ms. telegram drops
@@ -10,7 +11,17 @@ export interface RichMessageDraftOptions {
     keepAliveMs?: number;
     /** called when a background keep-alive push fails (e.g. network blip). */
     onError?: (error: unknown) => void;
+    /**
+     * the forum topic to stream/send into. sendRichMessageDraft has no
+     * business_connection_id param (drafts aren't supported in business chats), so only
+     * the thread id carries through the keep-alive pushes; `send()` additionally accepts
+     * `businessConnectionId` for the final, non-ephemeral sendRichMessage call.
+     */
+    messageThreadId?: number;
+    /** routed into the final `send()` only — see {@link messageThreadId}. */
+    businessConnectionId?: string;
 }
+type DraftSource = RichDocument | InputRichMessage | string;
 /**
  * a `sendRichMessageDraft` streaming session — the operationally hard part of the
  * rich-message api. telegram's draft is ephemeral: it vanishes 30s after the last
@@ -20,25 +31,51 @@ export interface RichMessageDraftOptions {
  *
  * - re-pushes the latest draft on a timer so a slow generator (e.g. an LLM
  *   stream) doesn't lose the draft between tokens;
- * - refuses to push after `commit()`/`cancel()`, so a stray late token can't
+ * - refuses to push after `send()`/`cancel()`, so a stray late call can't
  *   resurrect a closed draft;
- * - requires an explicit `commit()` — there is no implicit "last push wins".
+ * - requires an explicit `send()` — there is no implicit "last push wins".
+ *
+ * two ways to grow the draft: `rewrite()` replaces the whole thing (what you want
+ * for a token stream, where each chunk is a longer version of the *same* paragraph),
+ * `write()` appends to it via plain string concatenation (what you want to tack on
+ * a block — a footer, a divider — after content that's already there, without
+ * re-supplying it). a push boundary that lands mid-tag with `write()` is on the
+ * caller, same tradeoff raw concatenation always has.
+ *
+ * `send()` finalizes: with no argument it auto-assembles from the accumulated
+ * `rewrite()`/`write()` calls, so you don't have to re-render the final content —
+ * pass an explicit override when you want the persisted message to differ from the
+ * last draft snapshot.
  *
  * @example
  * const draft = ctx.richMessageDraft(1);
- * await draft.push(thinking("…"));
- * for await (const chunk of stream) await draft.push(document([paragraph(soFar)]));
- * await draft.commit(document([paragraph(finalAnswer)]));
+ * await draft.rewrite(document([thinking("…")]));
+ * for await (const chunk of stream) {
+ *   soFar += chunk;
+ *   await draft.rewrite(document([paragraph(soFar)]));
+ * }
+ * await draft.send();
  */
 export declare class RichMessageDraft {
     #private;
     constructor(api: Api, chatId: number, draftId: number, options?: RichMessageDraftOptions);
     get closed(): boolean;
-    /** push a new partial draft; telegram animates the transition for a shared `draft_id`. */
-    push(input: InputRichMessage | string): Promise<void>;
-    /** finalize: persist the real message and stop the keep-alive. always call this or `cancel()`. */
-    commit(input: InputRichMessage | string, extra?: Record<string, unknown>): Promise<Message>;
+    /** replace the whole draft with new content. */
+    rewrite(input: DraftSource): Promise<void>;
+    /**
+     * append to the current draft (plain string concatenation of the resolved text).
+     * throws if `input`'s dialect doesn't match the draft's, or if nothing has been
+     * written yet — call `rewrite()` first.
+     */
+    write(input: DraftSource): Promise<void>;
+    /**
+     * finalize: persist the real message and stop the keep-alive. with no `override`,
+     * auto-assembles from the accumulated `rewrite()`/`write()` calls. always call this
+     * or `cancel()`.
+     */
+    send(override?: DraftSource, extra?: Record<string, unknown>): Promise<Message>;
     /** abandon the draft without persisting anything — it expires within 30s on its own. */
     cancel(): void;
 }
+export {};
 //# sourceMappingURL=draft.d.ts.map

package/lib/draft.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"draft.d.ts","sourceRoot":"","sources":["../src/draft.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,WAAW,uBAAuB;IACvC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,gBAAgB;;gBAWhB,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,uBAA4B;IAQ5F,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,0FAA0F;IACpF,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B3D,kGAAkG;IAC5F,MAAM,CACX,KAAK,EAAE,gBAAgB,GAAG,MAAM,EAChC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,OAAO,CAAC;IAYnB,wFAAwF;IACxF,MAAM,IAAI,IAAI;CAUd"}
+{"version":3,"file":"draft.d.ts","sourceRoot":"","sources":["../src/draft.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,MAAM,WAAW,uBAAuB;IACvC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC9B;AASD,KAAK,WAAW,GAAG,YAAY,GAAG,gBAAgB,GAAG,MAAM,CAAC;AAqC5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,gBAAgB;;gBAahB,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,uBAA4B;IAU5F,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,gDAAgD;IAC1C,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhD;;;;OAIG;IACG,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAoD9C;;;;OAIG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuBzF,wFAAwF;IACxF,MAAM,IAAI,IAAI;CAgBd"}

package/lib/draft.js

@@ -1,3 +1,36 @@
+import { RichDocument } from "./document.js";
+function resolve(input, fallbackDialect) {
+    if (typeof input === "string")
+        return { dialect: fallbackDialect, text: input };
+    if (input instanceof RichDocument)
+        return resolve(input.toInputRichMessage(), fallbackDialect);
+    if (input.html !== undefined) {
+        return {
+            dialect: "html",
+            text: input.html,
+            isRtl: input.is_rtl,
+            skipEntityDetection: input.skip_entity_detection,
+        };
+    }
+    if (input.markdown !== undefined) {
+        return {
+            dialect: "markdown",
+            text: input.markdown,
+            isRtl: input.is_rtl,
+            skipEntityDetection: input.skip_entity_detection,
+        };
+    }
+    throw new Error("RichMessageDraft: input must have an `html` or `markdown` field");
+}
+function toInputRichMessage(state) {
+    return {
+        [state.dialect]: state.text,
+        ...(state.isRtl !== undefined ? { is_rtl: state.isRtl } : {}),
+        ...(state.skipEntityDetection !== undefined
+            ? { skip_entity_detection: state.skipEntityDetection }
+            : {}),
+    };
+}
 /**
  * a `sendRichMessageDraft` streaming session — the operationally hard part of the
  * rich-message api. telegram's draft is ephemeral: it vanishes 30s after the last
@@ -7,15 +40,30 @@
  *
  * - re-pushes the latest draft on a timer so a slow generator (e.g. an LLM
  *   stream) doesn't lose the draft between tokens;
- * - refuses to push after `commit()`/`cancel()`, so a stray late token can't
+ * - refuses to push after `send()`/`cancel()`, so a stray late call can't
  *   resurrect a closed draft;
- * - requires an explicit `commit()` — there is no implicit "last push wins".
+ * - requires an explicit `send()` — there is no implicit "last push wins".
+ *
+ * two ways to grow the draft: `rewrite()` replaces the whole thing (what you want
+ * for a token stream, where each chunk is a longer version of the *same* paragraph),
+ * `write()` appends to it via plain string concatenation (what you want to tack on
+ * a block — a footer, a divider — after content that's already there, without
+ * re-supplying it). a push boundary that lands mid-tag with `write()` is on the
+ * caller, same tradeoff raw concatenation always has.
+ *
+ * `send()` finalizes: with no argument it auto-assembles from the accumulated
+ * `rewrite()`/`write()` calls, so you don't have to re-render the final content —
+ * pass an explicit override when you want the persisted message to differ from the
+ * last draft snapshot.
  *
  * @example
  * const draft = ctx.richMessageDraft(1);
- * await draft.push(thinking("…"));
- * for await (const chunk of stream) await draft.push(document([paragraph(soFar)]));
- * await draft.commit(document([paragraph(finalAnswer)]));
+ * await draft.rewrite(document([thinking("…")]));
+ * for await (const chunk of stream) {
+ *   soFar += chunk;
+ *   await draft.rewrite(document([paragraph(soFar)]));
+ * }
+ * await draft.send();
  */
 export class RichMessageDraft {
     #api;
@@ -23,8 +71,10 @@ export class RichMessageDraft {
     #draftId;
     #keepAliveMs;
     #onError;
+    #messageThreadId;
+    #businessConnectionId;
     #timer;
-    #latest;
+    #state;
     #closed = false;
     constructor(api, chatId, draftId, options = {}) {
         this.#api = api;
@@ -32,42 +82,83 @@ export class RichMessageDraft {
         this.#draftId = draftId;
         this.#keepAliveMs = options.keepAliveMs ?? 20_000;
         this.#onError = options.onError;
+        this.#messageThreadId = options.messageThreadId;
+        this.#businessConnectionId = options.businessConnectionId;
     }
     get closed() {
         return this.#closed;
     }
-    /** push a new partial draft; telegram animates the transition for a shared `draft_id`. */
-    async push(input) {
-        if (this.#closed)
-            throw new Error("RichMessageDraft: push() after commit()/cancel()");
-        const resolved = typeof input === "string" ? { html: input } : input;
-        this.#latest = resolved;
-        await this.#push(resolved);
+    /** replace the whole draft with new content. */
+    async rewrite(input) {
+        this.#assertOpen();
+        this.#state = resolve(input, this.#state?.dialect ?? "html");
+        await this.#pushCurrent();
+        this.#arm();
+    }
+    /**
+     * append to the current draft (plain string concatenation of the resolved text).
+     * throws if `input`'s dialect doesn't match the draft's, or if nothing has been
+     * written yet — call `rewrite()` first.
+     */
+    async write(input) {
+        this.#assertOpen();
+        if (!this.#state) {
+            throw new Error("RichMessageDraft: write() before the first rewrite()");
+        }
+        const next = resolve(input, this.#state.dialect);
+        if (next.dialect !== this.#state.dialect) {
+            throw new Error(`RichMessageDraft: write() dialect "${next.dialect}" doesn't match the draft's "${this.#state.dialect}"`);
+        }
+        this.#state = {
+            dialect: this.#state.dialect,
+            text: this.#state.text + next.text,
+            isRtl: next.isRtl ?? this.#state.isRtl,
+            skipEntityDetection: next.skipEntityDetection ?? this.#state.skipEntityDetection,
+        };
+        await this.#pushCurrent();
         this.#arm();
     }
+    #pushCurrent() {
+        const state = this.#state;
+        if (!state)
+            throw new Error("unreachable: #pushCurrent() with no state");
+        return this.#push(toInputRichMessage(state));
+    }
     #push(input) {
         return this.#api.call("sendRichMessageDraft", {
             chat_id: this.#chatId,
             draft_id: this.#draftId,
             rich_message: input,
+            ...(this.#messageThreadId === undefined ? {} : { message_thread_id: this.#messageThreadId }),
         });
     }
     #arm() {
         clearInterval(this.#timer);
         this.#timer = setInterval(() => {
-            if (!this.#latest)
+            if (!this.#state)
                 return;
-            this.#push(this.#latest).catch((error) => this.#onError?.(error));
+            this.#push(toInputRichMessage(this.#state)).catch((error) => this.#onError?.(error));
         }, this.#keepAliveMs);
         this.#timer.unref?.();
     }
-    /** finalize: persist the real message and stop the keep-alive. always call this or `cancel()`. */
-    async commit(input, extra = {}) {
+    /**
+     * finalize: persist the real message and stop the keep-alive. with no `override`,
+     * auto-assembles from the accumulated `rewrite()`/`write()` calls. always call this
+     * or `cancel()`.
+     */
+    async send(override, extra = {}) {
         this.#stop();
-        const resolved = typeof input === "string" ? { html: input } : input;
+        const state = override !== undefined ? resolve(override, this.#state?.dialect ?? "html") : this.#state;
+        if (!state) {
+            throw new Error("RichMessageDraft: send() with nothing written — call rewrite()/write() first or pass an override");
+        }
         return this.#api.call("sendRichMessage", {
             chat_id: this.#chatId,
-            rich_message: resolved,
+            rich_message: toInputRichMessage(state),
+            ...(this.#messageThreadId === undefined ? {} : { message_thread_id: this.#messageThreadId }),
+            ...(this.#businessConnectionId === undefined
+                ? {}
+                : { business_connection_id: this.#businessConnectionId }),
             ...extra,
         });
     }
@@ -81,5 +172,10 @@ export class RichMessageDraft {
         this.#closed = true;
         clearInterval(this.#timer);
     }
+    #assertOpen() {
+        if (this.#closed) {
+            throw new Error("RichMessageDraft: rewrite()/write() after send()/cancel()");
+        }
+    }
 }
 //# sourceMappingURL=draft.js.map

package/lib/draft.js.map

@@ -1 +1 @@
-{"version":3,"file":"draft.js","sourceRoot":"","sources":["../src/draft.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,gBAAgB;IACnB,IAAI,CAAM;IACV,OAAO,CAAS;IAChB,QAAQ,CAAS;IACjB,YAAY,CAAS;IACrB,QAAQ,CAA4B;IAE7C,MAAM,CAAkC;IACxC,OAAO,CAA+B;IACtC,OAAO,GAAG,KAAK,CAAC;IAEhB,YAAY,GAAQ,EAAE,MAAc,EAAE,OAAe,EAAE,UAAmC,EAAE;QAC3F,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,IAAI,MAAM,CAAC;QAClD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;IAED,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,0FAA0F;IAC1F,KAAK,CAAC,IAAI,CAAC,KAAgC;QAC1C,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAEtF,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAErE,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC;QACxB,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;IAED,KAAK,CAAC,KAAuB;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAU,sBAAsB,EAAE;YACtD,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,YAAY,EAAE,KAAK;SACnB,CAAC,CAAC;IACJ,CAAC;IAED,IAAI;QACH,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE3B,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE;YAC9B,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,OAAO;YAE1B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5E,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QAEtB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;IACvB,CAAC;IAED,kGAAkG;IAClG,KAAK,CAAC,MAAM,CACX,KAAgC,EAChC,QAAiC,EAAE;QAEnC,IAAI,CAAC,KAAK,EAAE,CAAC;QAEb,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAErE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAU,iBAAiB,EAAE;YACjD,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,YAAY,EAAE,QAAQ;YACtB,GAAG,KAAK;SACR,CAAC,CAAC;IACJ,CAAC;IAED,wFAAwF;IACxF,MAAM;QACL,IAAI,CAAC,KAAK,EAAE,CAAC;IACd,CAAC;IAED,KAAK;QACJ,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QAEzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;CACD"}
+{"version":3,"file":"draft.js","sourceRoot":"","sources":["../src/draft.ts"],"names":[],"mappings":"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"}

package/lib/draft.test.d.ts

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

package/lib/draft.test.d.ts.map

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

package/lib/draft.test.js

@@ -0,0 +1,122 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { mockApi } from "@yaebal/test";
+import { RichMessageDraft } from "./draft.js";
+test("rewrite() pushes a full sendRichMessageDraft snapshot and re-arms the keep-alive timer", async () => {
+    const { api, calls } = mockApi();
+    const draft = new RichMessageDraft(api, 1, 7, { keepAliveMs: 60_000 });
+    await draft.rewrite("<tg-thinking>…</tg-thinking>");
+    assert.deepEqual(calls.map((c) => ({ method: c.method, params: c.params })), [
+        {
+            method: "sendRichMessageDraft",
+            params: { chat_id: 1, draft_id: 7, rich_message: { html: "<tg-thinking>…</tg-thinking>" } },
+        },
+    ]);
+});
+test("rewrite() replaces the whole draft — a second call drops the first's content", async () => {
+    const { api, calls } = mockApi();
+    const draft = new RichMessageDraft(api, 1, 1, { keepAliveMs: 60_000 });
+    await draft.rewrite("<p>one</p>");
+    await draft.rewrite("<p>two</p>");
+    assert.equal(calls.length, 2);
+    assert.deepEqual(calls[1]?.params?.rich_message, { html: "<p>two</p>" });
+});
+test("write() appends via string concatenation onto the current draft", async () => {
+    const { api, calls } = mockApi();
+    const draft = new RichMessageDraft(api, 1, 1, { keepAliveMs: 60_000 });
+    await draft.rewrite({ html: "<p>hello</p>" });
+    await draft.write({ html: "<hr/>" });
+    assert.deepEqual(calls[1]?.params?.rich_message, { html: "<p>hello</p><hr/>" });
+});
+test("write() before the first rewrite() throws", async () => {
+    const { api } = mockApi();
+    const draft = new RichMessageDraft(api, 1, 1);
+    await assert.rejects(() => draft.write("x"), /write\(\) before the first rewrite\(\)/);
+});
+test("write() with a dialect that doesn't match the draft's throws", async () => {
+    const { api } = mockApi();
+    const draft = new RichMessageDraft(api, 1, 1, { keepAliveMs: 60_000 });
+    await draft.rewrite({ html: "<p>hi</p>" });
+    await assert.rejects(() => draft.write({ markdown: "hi" }), /dialect "markdown" doesn't match the draft's "html"/);
+});
+test("send() with no override auto-assembles from the accumulated rewrite()/write() calls", async () => {
+    const { api, calls } = mockApi();
+    const draft = new RichMessageDraft(api, 1, 1, { keepAliveMs: 60_000 });
+    await draft.rewrite({ html: "<p>hello</p>" });
+    await draft.write({ html: "<hr/>" });
+    await draft.send();
+    assert.equal(calls[2]?.method, "sendRichMessage");
+    assert.deepEqual(calls[2]?.params, { chat_id: 1, rich_message: { html: "<p>hello</p><hr/>" } });
+    assert.equal(draft.closed, true);
+});
+test("send(override) persists the override instead of the accumulated draft", async () => {
+    const { api, calls } = mockApi();
+    const draft = new RichMessageDraft(api, 1, 1, { keepAliveMs: 60_000 });
+    await draft.rewrite({ html: "<p>draft text</p>" });
+    await draft.send({ html: "<p>final text</p>" }, { reply_markup: { x: 1 } });
+    assert.equal(calls[1]?.method, "sendRichMessage");
+    assert.deepEqual(calls[1]?.params, {
+        chat_id: 1,
+        rich_message: { html: "<p>final text</p>" },
+        reply_markup: { x: 1 },
+    });
+});
+test("send() with nothing written and no override throws", async () => {
+    const { api } = mockApi();
+    const draft = new RichMessageDraft(api, 1, 1);
+    await assert.rejects(() => draft.send(), /send\(\) with nothing written/);
+});
+test("cancel() closes without persisting anything", async () => {
+    const { api, calls } = mockApi();
+    const draft = new RichMessageDraft(api, 1, 2, { keepAliveMs: 60_000 });
+    await draft.rewrite("draft text");
+    draft.cancel();
+    assert.equal(draft.closed, true);
+    assert.equal(calls.some((c) => c.method === "sendRichMessage"), false);
+});
+test("rewrite()/write() after send()/cancel() throws", async () => {
+    const { api } = mockApi();
+    const draft = new RichMessageDraft(api, 1, 1, { keepAliveMs: 60_000 });
+    await draft.rewrite("x");
+    await draft.send();
+    await assert.rejects(() => draft.rewrite("late"), /after send\(\)\/cancel\(\)/);
+    await assert.rejects(() => draft.write("late"), /after send\(\)\/cancel\(\)/);
+});
+test("messageThreadId routes both the keep-alive pushes and the final send", async () => {
+    const { api, calls } = mockApi();
+    const draft = new RichMessageDraft(api, 1, 1, { keepAliveMs: 60_000, messageThreadId: 42 });
+    await draft.rewrite("<p>hi</p>");
+    await draft.send();
+    assert.equal(calls[0]?.method, "sendRichMessageDraft");
+    assert.deepEqual(calls[0]?.params, {
+        chat_id: 1,
+        draft_id: 1,
+        rich_message: { html: "<p>hi</p>" },
+        message_thread_id: 42,
+    });
+    assert.equal(calls[1]?.method, "sendRichMessage");
+    assert.deepEqual(calls[1]?.params, {
+        chat_id: 1,
+        rich_message: { html: "<p>hi</p>" },
+        message_thread_id: 42,
+    });
+});
+test("businessConnectionId routes only the final send (sendRichMessageDraft has no such param)", async () => {
+    const { api, calls } = mockApi();
+    const draft = new RichMessageDraft(api, 1, 1, {
+        keepAliveMs: 60_000,
+        businessConnectionId: "bc1",
+    });
+    await draft.rewrite("<p>hi</p>");
+    await draft.send();
+    assert.equal(calls[0]?.params?.business_connection_id, undefined);
+    assert.equal(calls[1]?.params?.business_connection_id, "bc1");
+});
+test("preserves is_rtl/skip_entity_detection across write() unless the new push overrides them", async () => {
+    const { api, calls } = mockApi();
+    const draft = new RichMessageDraft(api, 1, 1, { keepAliveMs: 60_000 });
+    await draft.rewrite({ html: "<p>a</p>", is_rtl: true });
+    await draft.write({ html: "<p>b</p>" });
+    assert.deepEqual(calls[1]?.params?.rich_message, { html: "<p>a</p><p>b</p>", is_rtl: true });
+});
+//# sourceMappingURL=draft.test.js.map

package/lib/draft.test.js.map

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

package/lib/escape.d.ts

@@ -2,4 +2,12 @@
 export declare function escapeText(value: string): string;
 /** escape a double-quoted attribute value. */
 export declare function escapeAttr(value: string): string;
+/** escape text so it can never be re-parsed as rich-markdown syntax. */
+export declare function escapeMarkdown(value: string): string;
+/**
+ * escape a url used as a markdown link destination. `[text](url)` is terminated by `)`
+ * or whitespace, so an attacker-controlled url can't break out of the link — escape the
+ * parens/backslash and percent-encode whitespace.
+ */
+export declare function escapeMarkdownUrl(value: string): string;
 //# sourceMappingURL=escape.d.ts.map

package/lib/escape.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"escape.d.ts","sourceRoot":"","sources":["../src/escape.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,8CAA8C;AAC9C,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD"}
+{"version":3,"file":"escape.d.ts","sourceRoot":"","sources":["../src/escape.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,8CAA8C;AAC9C,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAQD,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/lib/escape.js

@@ -6,4 +6,21 @@ export function escapeText(value) {
 export function escapeAttr(value) {
     return escapeText(value).replace(/"/g, """);
 }
+// rich-markdown specials. `&`/`<`/`>` become numeric entities (rich-markdown renders
+// `\<` with the backslash showing, but does accept entities — the same trick telegram's
+// classic parse_mode markdown uses); everything else backslash-escapes cleanly.
+const MARKDOWN_SPECIALS = /[\\`*_~=|[\]()#!+\-&<>]/g;
+const MARKDOWN_ENTITY = { "&": "&#38;", "<": "&#60;", ">": "&#62;" };
+/** escape text so it can never be re-parsed as rich-markdown syntax. */
+export function escapeMarkdown(value) {
+    return value.replace(MARKDOWN_SPECIALS, (ch) => MARKDOWN_ENTITY[ch] ?? `\\${ch}`);
+}
+/**
+ * escape a url used as a markdown link destination. `[text](url)` is terminated by `)`
+ * or whitespace, so an attacker-controlled url can't break out of the link — escape the
+ * parens/backslash and percent-encode whitespace.
+ */
+export function escapeMarkdownUrl(value) {
+    return value.replace(/[\\()]/g, "\\$&").replace(/\s/g, (ch) => encodeURIComponent(ch));
+}
 //# sourceMappingURL=escape.js.map

package/lib/escape.js.map

@@ -1 +1 @@
-{"version":3,"file":"escape.js","sourceRoot":"","sources":["../src/escape.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,MAAM,UAAU,UAAU,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACjF,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,UAAU,CAAC,KAAa;IACvC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAClD,CAAC"}
+{"version":3,"file":"escape.js","sourceRoot":"","sources":["../src/escape.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,MAAM,UAAU,UAAU,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACjF,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,UAAU,CAAC,KAAa;IACvC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED,qFAAqF;AACrF,wFAAwF;AACxF,gFAAgF;AAChF,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AACrD,MAAM,eAAe,GAA2B,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AAE7F,wEAAwE;AACxE,MAAM,UAAU,cAAc,CAAC,KAAa;IAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,EAAE,CAAC,CAAC;AACnF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC9C,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC;AACxF,CAAC"}

package/lib/escape.test.d.ts

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

package/lib/escape.test.d.ts.map

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

package/lib/escape.test.js

@@ -0,0 +1,28 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { escapeAttr, escapeMarkdown, escapeMarkdownUrl, escapeText } from "./escape.js";
+test("escapeText escapes &, <, > with named entities", () => {
+    assert.equal(escapeText("a & b < c > d"), "a &amp; b &lt; c &gt; d");
+});
+test("escapeText leaves other characters (including quotes) untouched", () => {
+    assert.equal(escapeText(`"hi" 'there'`), `"hi" 'there'`);
+});
+test("escapeAttr additionally escapes double quotes", () => {
+    assert.equal(escapeAttr(`say "hi" & bye`), "say &quot;hi&quot; &amp; bye");
+});
+test("escapeMarkdown backslash-escapes rich-markdown specials", () => {
+    assert.equal(escapeMarkdown("a*b_c~d=e|f[g]h(i)j#k!l+m-n`o"), "a\\*b\\_c\\~d\\=e\\|f\\[g\\]h\\(i\\)j\\#k\\!l\\+m\\-n\\`o");
+});
+test("escapeMarkdown numeric-entity-escapes &, <, >", () => {
+    assert.equal(escapeMarkdown("a & b < c > d"), "a &#38; b &#60; c &#62; d");
+});
+test("escapeMarkdown leaves plain text untouched", () => {
+    assert.equal(escapeMarkdown("hello world 123"), "hello world 123");
+});
+test("escapeMarkdownUrl escapes parens/backslash so a url can't break out of [text](url)", () => {
+    assert.equal(escapeMarkdownUrl("https://x.test/a(b)c\\d"), "https://x.test/a\\(b\\)c\\\\d");
+});
+test("escapeMarkdownUrl percent-encodes whitespace", () => {
+    assert.equal(escapeMarkdownUrl("https://x.test/a b"), "https://x.test/a%20b");
+});
+//# sourceMappingURL=escape.test.js.map

package/lib/escape.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.test.js","sourceRoot":"","sources":["../src/escape.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAExF,IAAI,CAAC,gDAAgD,EAAE,GAAG,EAAE;IAC3D,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,yBAAyB,CAAC,CAAC;AACtE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,iEAAiE,EAAE,GAAG,EAAE;IAC5E,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC,CAAC;AAC1D,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE;IAC1D,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,8BAA8B,CAAC,CAAC;AAC5E,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yDAAyD,EAAE,GAAG,EAAE;IACpE,MAAM,CAAC,KAAK,CACX,cAAc,CAAC,+BAA+B,CAAC,EAC/C,2DAA2D,CAC3D,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE;IAC1D,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,2BAA2B,CAAC,CAAC;AAC5E,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,4CAA4C,EAAE,GAAG,EAAE;IACvD,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC,CAAC;AACpE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,oFAAoF,EAAE,GAAG,EAAE;IAC/F,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,yBAAyB,CAAC,EAAE,+BAA+B,CAAC,CAAC;AAC7F,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,8CAA8C,EAAE,GAAG,EAAE;IACzD,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,EAAE,sBAAsB,CAAC,CAAC;AAC/E,CAAC,CAAC,CAAC"}

package/lib/guards.test.d.ts

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

package/lib/guards.test.d.ts.map

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