@yaebal/test 0.0.1 → 0.2.0

package/lib/internal.js

@@ -0,0 +1,19 @@
+function isFormatResult(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "text" in value &&
+        "entities" in value &&
+        Array.isArray(value.entities));
+}
+/** resolve a `SendText` into `{ text, entities }`, merging in any `extraEntities`. */
+export function resolveSendText(text, extraEntities = []) {
+    const resolved = isFormatResult(text) ? text : { text, entities: [] };
+    return { text: resolved.text, entities: [...resolved.entities, ...extraEntities] };
+}
+let fileCounter = 0;
+/** a fake `{ file_id, file_unique_id }` pair — good enough for tests, never a real download. */
+export function fakeFile(prefix) {
+    const n = ++fileCounter;
+    return { file_id: `${prefix}_${n}`, file_unique_id: `u${prefix}${n}` };
+}
+//# sourceMappingURL=internal.js.map

package/lib/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAiBA,SAAS,cAAc,CAAC,KAAc;IACrC,OAAO,CACN,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,UAAU,IAAI,KAAK;QACnB,KAAK,CAAC,OAAO,CAAE,KAAsB,CAAC,QAAQ,CAAC,CAC/C,CAAC;AACH,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,eAAe,CAC9B,IAAc,EACd,gBAAiC,EAAE;IAEnC,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACtE,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,QAAQ,EAAE,GAAG,aAAa,CAAC,EAAE,CAAC;AACpF,CAAC;AAED,IAAI,WAAW,GAAG,CAAC,CAAC;AAEpB,gGAAgG;AAChG,MAAM,UAAU,QAAQ,CAAC,MAAc;IACtC,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC;IACxB,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,EAAE,EAAE,cAAc,EAAE,IAAI,MAAM,GAAG,CAAC,EAAE,EAAE,CAAC;AACxE,CAAC"}

package/lib/keyboard.d.ts

@@ -0,0 +1,15 @@
+/** an inline keyboard button found by {@link findButton}, with its position. */
+export interface FoundButton {
+    text: string;
+    row: number;
+    col: number;
+    [key: string]: unknown;
+}
+/**
+ * search an inline keyboard (a `reply_markup`-shaped object — or an `InlineKeyboard`/`Keyboard`
+ * builder instance, unwrapped via `toJSON()` automatically — e.g. from a recorded call's params,
+ * or a {@link BotMessage}'s `reply_markup`) for a button whose text matches a string or regex.
+ * returns the button (plus its `row`/`col`) or `undefined`.
+ */
+export declare function findButton(markup: unknown, match: string | RegExp): FoundButton | undefined;
+//# sourceMappingURL=keyboard.d.ts.map

package/lib/keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.d.ts","sourceRoot":"","sources":["../src/keyboard.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,CAqB3F"}

package/lib/keyboard.js

@@ -0,0 +1,25 @@
+import { toPlain } from "./normalize.js";
+/**
+ * search an inline keyboard (a `reply_markup`-shaped object — or an `InlineKeyboard`/`Keyboard`
+ * builder instance, unwrapped via `toJSON()` automatically — e.g. from a recorded call's params,
+ * or a {@link BotMessage}'s `reply_markup`) for a button whose text matches a string or regex.
+ * returns the button (plus its `row`/`col`) or `undefined`.
+ */
+export function findButton(markup, match) {
+    const plain = toPlain(markup);
+    const rows = plain?.inline_keyboard ?? [];
+    for (let row = 0; row < rows.length; row++) {
+        const cols = rows[row] ?? [];
+        for (let col = 0; col < cols.length; col++) {
+            const button = cols[col];
+            if (!button)
+                continue;
+            const text = typeof button.text === "string" ? button.text : "";
+            const matches = typeof match === "string" ? text === match : match.test(text);
+            if (matches)
+                return { ...button, text, row, col };
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=keyboard.js.map

package/lib/keyboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.js","sourceRoot":"","sources":["../src/keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAUzC;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,MAAe,EAAE,KAAsB;IACjE,MAAM,KAAK,GAAG,OAAO,CACpB,MAAM,CACN,CAAC;IACF,MAAM,IAAI,GAAG,KAAK,EAAE,eAAe,IAAI,EAAE,CAAC;IAE1C,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAE7B,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YACzB,IAAI,CAAC,MAAM;gBAAE,SAAS;YAEtB,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAE9E,IAAI,OAAO;gBAAE,OAAO,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QACnD,CAAC;IACF,CAAC;IAED,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/lib/keyboard.test.d.ts

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

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

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

package/lib/keyboard.test.js

@@ -0,0 +1,31 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { findButton } from "./keyboard.js";
+test("findButton locates a button by text and reports its position", () => {
+    const markup = {
+        inline_keyboard: [
+            [{ text: "a", callback_data: "a" }],
+            [
+                { text: "b", callback_data: "b" },
+                { text: "Next", callback_data: "page:2" },
+            ],
+        ],
+    };
+    const found = findButton(markup, "Next");
+    assert.equal(found?.callback_data, "page:2");
+    assert.equal(found?.row, 1);
+    assert.equal(found?.col, 1);
+    assert.equal(findButton(markup, /^n/i)?.text, "Next");
+    assert.equal(findButton(markup, "missing"), undefined);
+    assert.equal(findButton(undefined, "missing"), undefined);
+});
+test("findButton unwraps a builder instance via toJSON()", () => {
+    class FakeInlineKeyboard {
+        toJSON() {
+            return { inline_keyboard: [[{ text: "Restart", callback_data: "restart" }]] };
+        }
+    }
+    const found = findButton(new FakeInlineKeyboard(), "Restart");
+    assert.equal(found?.callback_data, "restart");
+});
+//# sourceMappingURL=keyboard.test.js.map

package/lib/keyboard.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard.test.js","sourceRoot":"","sources":["../src/keyboard.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,IAAI,CAAC,8DAA8D,EAAE,GAAG,EAAE;IACzE,MAAM,MAAM,GAAG;QACd,eAAe,EAAE;YAChB,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC;YACnC;gBACC,EAAE,IAAI,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE;gBACjC,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE;aACzC;SACD;KACD,CAAC;IAEF,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAC5B,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAE5B,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACtD,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;IACvD,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;AAC3D,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,oDAAoD,EAAE,GAAG,EAAE;IAC/D,MAAM,kBAAkB;QACvB,MAAM;YACL,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC;QAC/E,CAAC;KACD;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,kBAAkB,EAAE,EAAE,SAAS,CAAC,CAAC;IAC9D,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC"}

package/lib/normalize.d.ts

@@ -0,0 +1,10 @@
+/**
+ * builder instances (e.g. `InlineKeyboard`/`Keyboard` from `@yaebal/keyboard`) expose a
+ * `toJSON()` the same way `Date`/`Map`-like classes do. unwrap them so recorded calls and
+ * assertions see plain JSON, never a class instance — no `@yaebal/keyboard` dependency needed,
+ * this is just duck typing on the standard `toJSON` convention.
+ */
+export declare function toPlain<T = unknown>(value: unknown): T;
+/** shallow-clone `params`, normalizing `reply_markup` (and, for `answerInlineQuery`, each `results[].reply_markup`) via {@link toPlain}. */
+export declare function normalizeParams(params: Record<string, unknown> | undefined): Record<string, unknown> | undefined;
+//# sourceMappingURL=normalize.d.ts.map

package/lib/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAMtD;AAED,4IAA4I;AAC5I,wBAAgB,eAAe,CAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACzC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAgBrC"}

package/lib/normalize.js

@@ -0,0 +1,27 @@
+/**
+ * builder instances (e.g. `InlineKeyboard`/`Keyboard` from `@yaebal/keyboard`) expose a
+ * `toJSON()` the same way `Date`/`Map`-like classes do. unwrap them so recorded calls and
+ * assertions see plain JSON, never a class instance — no `@yaebal/keyboard` dependency needed,
+ * this is just duck typing on the standard `toJSON` convention.
+ */
+export function toPlain(value) {
+    if (value && typeof value.toJSON === "function") {
+        return value.toJSON();
+    }
+    return value;
+}
+/** shallow-clone `params`, normalizing `reply_markup` (and, for `answerInlineQuery`, each `results[].reply_markup`) via {@link toPlain}. */
+export function normalizeParams(params) {
+    if (!params)
+        return params;
+    const out = { ...params };
+    if ("reply_markup" in out)
+        out.reply_markup = toPlain(out.reply_markup);
+    if (Array.isArray(out.results)) {
+        out.results = out.results.map((item) => item && typeof item === "object" && "reply_markup" in item
+            ? { ...item, reply_markup: toPlain(item.reply_markup) }
+            : item);
+    }
+    return out;
+}
+//# sourceMappingURL=normalize.js.map

package/lib/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAc,KAAc;IAClD,IAAI,KAAK,IAAI,OAAQ,KAA8B,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC3E,OAAQ,KAAyB,CAAC,MAAM,EAAE,CAAC;IAC5C,CAAC;IAED,OAAO,KAAU,CAAC;AACnB,CAAC;AAED,4IAA4I;AAC5I,MAAM,UAAU,eAAe,CAC9B,MAA2C;IAE3C,IAAI,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IAE3B,MAAM,GAAG,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAE1B,IAAI,cAAc,IAAI,GAAG;QAAE,GAAG,CAAC,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAExE,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACtC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,cAAc,IAAI,IAAI;YACzD,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,YAAY,EAAE,OAAO,CAAE,IAAgC,CAAC,YAAY,CAAC,EAAE;YACpF,CAAC,CAAC,IAAI,CACP,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACZ,CAAC"}

package/lib/reactions.d.ts

@@ -0,0 +1,3 @@
+/** the emojis a given user currently has on `message` (per-message, per-user reaction state). */
+export declare function reactionsOf(message: object): Map<number, string[]>;
+//# sourceMappingURL=reactions.d.ts.map

package/lib/reactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.d.ts","sourceRoot":"","sources":["../src/reactions.ts"],"names":[],"mappings":"AAQA,iGAAiG;AACjG,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAQlE"}

package/lib/reactions.js

@@ -0,0 +1,17 @@
+/**
+ * per-message reaction state, so {@link UserActor.react} never needs `oldReaction` spelled out
+ * by hand — it's inferred from whatever that user's last `react()` on this message left behind.
+ * keyed by the `Message` object's identity (a `WeakMap`, so it costs nothing once a message is
+ * no longer referenced) rather than `message_id`, since ids aren't guaranteed unique across chats.
+ */
+const store = new WeakMap();
+/** the emojis a given user currently has on `message` (per-message, per-user reaction state). */
+export function reactionsOf(message) {
+    let state = store.get(message);
+    if (!state) {
+        state = new Map();
+        store.set(message, state);
+    }
+    return state;
+}
+//# sourceMappingURL=reactions.js.map

package/lib/reactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.js","sourceRoot":"","sources":["../src/reactions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,KAAK,GAAG,IAAI,OAAO,EAAiC,CAAC;AAE3D,iGAAiG;AACjG,MAAM,UAAU,WAAW,CAAC,OAAe;IAC1C,IAAI,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;QAClB,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC"}

package/lib/updates.d.ts

@@ -0,0 +1,126 @@
+/**
+ * fixture builders — the escape hatch beneath the actor api. every actor
+ * method ({@link UserActor.sendMessage} & co.) is sugar over one of these;
+ * reach for them directly when you need an update shape the actors don't
+ * cover, or want full control over every field.
+ */
+import type { Message, Update, UpdateName, User } from "@yaebal/core";
+/** the payload type for a given update kind — reuses core's `Update` shape, no extra types package needed. */
+type Payload<K extends UpdateName> = NonNullable<Update[K]>;
+/** build an {@link Update} from a partial, filling in a fresh `update_id`. */
+export declare function createUpdate(partial?: Partial<Update>): Update;
+/** options for {@link buildUser}. */
+export interface BuildUserOptions {
+    id?: number;
+    firstName?: string;
+    lastName?: string;
+    username?: string;
+    languageCode?: string;
+    isBot?: boolean;
+}
+/** build a {@link User}, auto-allocating an id if none is given. */
+export declare function buildUser(options?: BuildUserOptions): User;
+/** options shared by the message-shaped factories (`message`, `edited_message`, `channel_post`, ...). */
+export interface MessageUpdateOptions {
+    text?: string;
+    chatId?: number;
+    fromId?: number;
+    chatType?: "private" | "group" | "supergroup" | "channel";
+}
+/** build a `message` {@link Update}. */
+export declare function messageUpdate(options?: MessageUpdateOptions): Update;
+/** build an `edited_message` {@link Update}. */
+export declare function editedMessageUpdate(options?: MessageUpdateOptions): Update;
+/** build a `channel_post` {@link Update}. */
+export declare function channelPostUpdate(options?: MessageUpdateOptions): Update;
+/** build an `edited_channel_post` {@link Update}. */
+export declare function editedChannelPostUpdate(options?: MessageUpdateOptions): Update;
+/** options for {@link callbackUpdate}. */
+export interface CallbackUpdateOptions {
+    data?: string;
+    chatId?: number;
+    fromId?: number;
+    message?: Message;
+}
+/** build a `callback_query` {@link Update}. */
+export declare function callbackUpdate(options?: CallbackUpdateOptions): Update;
+/** options for {@link inlineQueryUpdate}. */
+export interface InlineQueryUpdateOptions {
+    query?: string;
+    fromId?: number;
+    id?: string;
+    offset?: string;
+    chatType?: Payload<"inline_query">["chat_type"];
+}
+/** build an `inline_query` {@link Update}. */
+export declare function inlineQueryUpdate(options?: InlineQueryUpdateOptions): Update;
+/** options for {@link chosenInlineResultUpdate}. */
+export interface ChosenInlineResultUpdateOptions {
+    resultId?: string;
+    fromId?: number;
+    query?: string;
+    inlineMessageId?: string;
+}
+/** build a `chosen_inline_result` {@link Update}. */
+export declare function chosenInlineResultUpdate(options?: ChosenInlineResultUpdateOptions): Update;
+/** options for {@link shippingQueryUpdate}. */
+export interface ShippingQueryUpdateOptions {
+    id?: string;
+    fromId?: number;
+    invoicePayload?: string;
+    shippingAddress?: Partial<Payload<"shipping_query">["shipping_address"]>;
+}
+/** build a `shipping_query` {@link Update}. */
+export declare function shippingQueryUpdate(options?: ShippingQueryUpdateOptions): Update;
+/** options for {@link preCheckoutQueryUpdate}. */
+export interface PreCheckoutQueryUpdateOptions {
+    id?: string;
+    fromId?: number;
+    currency?: string;
+    totalAmount?: number;
+    invoicePayload?: string;
+}
+/** build a `pre_checkout_query` {@link Update}. */
+export declare function preCheckoutQueryUpdate(options?: PreCheckoutQueryUpdateOptions): Update;
+/** options for {@link pollUpdate}. */
+export interface PollUpdateOptions {
+    id?: string;
+    question?: string;
+    options?: string[];
+    isClosed?: boolean;
+}
+/** build a `poll` {@link Update}. */
+export declare function pollUpdate(options?: PollUpdateOptions): Update;
+/** options for {@link pollAnswerUpdate}. */
+export interface PollAnswerUpdateOptions {
+    pollId?: string;
+    fromId?: number;
+    optionIds?: number[];
+}
+/** build a `poll_answer` {@link Update}. */
+export declare function pollAnswerUpdate(options?: PollAnswerUpdateOptions): Update;
+/** options for {@link myChatMemberUpdate} / {@link chatMemberUpdate}. */
+export interface ChatMemberUpdateOptions {
+    chatId?: number;
+    fromId?: number;
+    userId?: number;
+    oldStatus?: string;
+    newStatus?: string;
+}
+/** build a `my_chat_member` {@link Update} (the bot's own membership changed). */
+export declare function myChatMemberUpdate(options?: ChatMemberUpdateOptions): Update;
+/** build a `chat_member` {@link Update} (another member's membership changed). */
+export declare function chatMemberUpdate(options?: ChatMemberUpdateOptions): Update;
+/** options for {@link chatJoinRequestUpdate}. */
+export interface ChatJoinRequestUpdateOptions {
+    chatId?: number;
+    fromId?: number;
+    userChatId?: number;
+    bio?: string;
+}
+/** build a `chat_join_request` {@link Update}. */
+export declare function chatJoinRequestUpdate(options?: ChatJoinRequestUpdateOptions): Update;
+/** infer which payload key an update carries; defaults to `"message"`. */
+export declare function detectUpdateType(update: Update): UpdateName;
+export type { Message, Update, UpdateName, User };
+//# sourceMappingURL=updates.d.ts.map

package/lib/updates.d.ts.map

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

package/lib/updates.js

@@ -0,0 +1,200 @@
+let updateIdCounter = 0;
+let userIdCounter = 0;
+/** build an {@link Update} from a partial, filling in a fresh `update_id`. */
+export function createUpdate(partial = {}) {
+    return { update_id: ++updateIdCounter, ...partial };
+}
+/** build a {@link User}, auto-allocating an id if none is given. */
+export function buildUser(options = {}) {
+    const { id = ++userIdCounter, firstName = "u", lastName, username, languageCode, isBot = false, } = options;
+    return {
+        id,
+        is_bot: isBot,
+        first_name: firstName,
+        ...(lastName !== undefined ? { last_name: lastName } : {}),
+        ...(username !== undefined ? { username } : {}),
+        ...(languageCode !== undefined ? { language_code: languageCode } : {}),
+    };
+}
+const stubUser = (id) => buildUser({ id });
+function buildMessage(options, defaultChatType) {
+    const { text = "", chatId = 1, fromId = chatId, chatType = defaultChatType } = options;
+    return {
+        message_id: 1,
+        date: 0,
+        chat: { id: chatId, type: chatType },
+        from: stubUser(fromId),
+        text,
+    };
+}
+/** build a `message` {@link Update}. */
+export function messageUpdate(options = {}) {
+    return createUpdate({ message: buildMessage(options, "private") });
+}
+/** build an `edited_message` {@link Update}. */
+export function editedMessageUpdate(options = {}) {
+    return createUpdate({ edited_message: buildMessage(options, "private") });
+}
+/** build a `channel_post` {@link Update}. */
+export function channelPostUpdate(options = {}) {
+    return createUpdate({ channel_post: buildMessage(options, "channel") });
+}
+/** build an `edited_channel_post` {@link Update}. */
+export function editedChannelPostUpdate(options = {}) {
+    return createUpdate({ edited_channel_post: buildMessage(options, "channel") });
+}
+/** build a `callback_query` {@link Update}. */
+export function callbackUpdate(options = {}) {
+    const { data = "", chatId = 1, fromId = chatId, message } = options;
+    return createUpdate({
+        callback_query: {
+            id: "1",
+            chat_instance: "0",
+            from: stubUser(fromId),
+            message: message ?? {
+                message_id: 1,
+                date: 0,
+                chat: { id: chatId, type: "private" },
+            },
+            data,
+        },
+    });
+}
+/** build an `inline_query` {@link Update}. */
+export function inlineQueryUpdate(options = {}) {
+    const { query = "", fromId = 1, id = "1", offset = "", chatType } = options;
+    return createUpdate({
+        inline_query: {
+            id,
+            from: stubUser(fromId),
+            query,
+            offset,
+            ...(chatType ? { chat_type: chatType } : {}),
+        },
+    });
+}
+/** build a `chosen_inline_result` {@link Update}. */
+export function chosenInlineResultUpdate(options = {}) {
+    const { resultId = "1", fromId = 1, query = "", inlineMessageId } = options;
+    return createUpdate({
+        chosen_inline_result: {
+            result_id: resultId,
+            from: stubUser(fromId),
+            query,
+            ...(inlineMessageId ? { inline_message_id: inlineMessageId } : {}),
+        },
+    });
+}
+/** build a `shipping_query` {@link Update}. */
+export function shippingQueryUpdate(options = {}) {
+    const { id = "1", fromId = 1, invoicePayload = "", shippingAddress = {} } = options;
+    return createUpdate({
+        shipping_query: {
+            id,
+            from: stubUser(fromId),
+            invoice_payload: invoicePayload,
+            shipping_address: {
+                country_code: "US",
+                state: "",
+                city: "New York",
+                street_line1: "",
+                street_line2: "",
+                post_code: "10001",
+                ...shippingAddress,
+            },
+        },
+    });
+}
+/** build a `pre_checkout_query` {@link Update}. */
+export function preCheckoutQueryUpdate(options = {}) {
+    const { id = "1", fromId = 1, currency = "USD", totalAmount = 100, invoicePayload = "", } = options;
+    return createUpdate({
+        pre_checkout_query: {
+            id,
+            from: stubUser(fromId),
+            currency,
+            total_amount: totalAmount,
+            invoice_payload: invoicePayload,
+        },
+    });
+}
+/** build a `poll` {@link Update}. */
+export function pollUpdate(options = {}) {
+    const { id = "1", question = "", options: choices = ["yes", "no"], isClosed = false } = options;
+    return createUpdate({
+        poll: {
+            id,
+            question,
+            options: choices.map((text, i) => ({ persistent_id: String(i), text, voter_count: 0 })),
+            total_voter_count: 0,
+            is_closed: isClosed,
+            is_anonymous: true,
+            type: "regular",
+            allows_multiple_answers: false,
+            allows_revoting: false,
+            members_only: false,
+        },
+    });
+}
+/** build a `poll_answer` {@link Update}. */
+export function pollAnswerUpdate(options = {}) {
+    const { pollId = "1", fromId = 1, optionIds = [0] } = options;
+    return createUpdate({
+        poll_answer: {
+            poll_id: pollId,
+            user: stubUser(fromId),
+            option_ids: optionIds,
+            option_persistent_ids: optionIds.map(String),
+        },
+    });
+}
+function buildChatMemberUpdate(options) {
+    const { chatId = 1, fromId = chatId, userId = fromId, oldStatus = "member", newStatus = "member", } = options;
+    const user = stubUser(userId);
+    return {
+        chat: { id: chatId, type: "group" },
+        from: stubUser(fromId),
+        date: 0,
+        old_chat_member: { status: oldStatus, user },
+        new_chat_member: { status: newStatus, user },
+    };
+}
+/** build a `my_chat_member` {@link Update} (the bot's own membership changed). */
+export function myChatMemberUpdate(options = {}) {
+    return createUpdate({ my_chat_member: buildChatMemberUpdate(options) });
+}
+/** build a `chat_member` {@link Update} (another member's membership changed). */
+export function chatMemberUpdate(options = {}) {
+    return createUpdate({ chat_member: buildChatMemberUpdate(options) });
+}
+/** build a `chat_join_request` {@link Update}. */
+export function chatJoinRequestUpdate(options = {}) {
+    const { chatId = 1, fromId = 1, userChatId = fromId, bio } = options;
+    return createUpdate({
+        chat_join_request: {
+            chat: { id: chatId, type: "group" },
+            from: stubUser(fromId),
+            user_chat_id: userChatId,
+            date: 0,
+            ...(bio ? { bio } : {}),
+        },
+    });
+}
+/** infer which payload key an update carries; defaults to `"message"`. */
+export function detectUpdateType(update) {
+    if (update.message)
+        return "message";
+    if (update.edited_message)
+        return "edited_message";
+    if (update.channel_post)
+        return "channel_post";
+    if (update.callback_query)
+        return "callback_query";
+    const bag = update;
+    for (const key of Object.keys(bag)) {
+        if (key !== "update_id" && bag[key] !== undefined)
+            return key;
+    }
+    return "message";
+}
+//# sourceMappingURL=updates.js.map

package/lib/updates.js.map

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

package/lib/updates.test.d.ts

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

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

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

package/lib/updates.test.js

@@ -0,0 +1,72 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { buildUser, callbackUpdate, channelPostUpdate, chatJoinRequestUpdate, chatMemberUpdate, chosenInlineResultUpdate, createUpdate, detectUpdateType, editedMessageUpdate, inlineQueryUpdate, messageUpdate, myChatMemberUpdate, pollAnswerUpdate, pollUpdate, preCheckoutQueryUpdate, shippingQueryUpdate, } from "./updates.js";
+test("messageUpdate produces a valid message update", () => {
+    const update = messageUpdate({ text: "hello", chatId: 42, chatType: "group" });
+    assert.ok(update.update_id > 0);
+    assert.equal(update.message?.text, "hello");
+    assert.equal(update.message?.chat.id, 42);
+    assert.equal(update.message?.chat.type, "group");
+    assert.equal(update.message?.from?.id, 42);
+});
+test("callbackUpdate produces a valid callback_query update", () => {
+    const update = callbackUpdate({ data: "click", chatId: 7, fromId: 9 });
+    assert.equal(update.callback_query?.data, "click");
+    assert.equal(update.callback_query?.from.id, 9);
+    assert.equal(update.callback_query?.message?.chat.id, 7);
+});
+test("createUpdate fills a fresh update_id", () => {
+    const a = createUpdate();
+    const b = createUpdate();
+    assert.notEqual(a.update_id, b.update_id);
+});
+test("buildUser auto-allocates distinct ids and fills defaults", () => {
+    const a = buildUser();
+    const b = buildUser({ firstName: "Linia", username: "linia" });
+    assert.notEqual(a.id, b.id);
+    assert.equal(b.first_name, "Linia");
+    assert.equal(b.username, "linia");
+    assert.equal(b.is_bot, false);
+});
+test("channelPostUpdate / editedMessageUpdate build the right update key", () => {
+    assert.equal(channelPostUpdate({ text: "hi" }).channel_post?.text, "hi");
+    assert.equal(channelPostUpdate().channel_post?.chat.type, "channel");
+    assert.equal(editedMessageUpdate({ text: "hi" }).edited_message?.text, "hi");
+});
+test("inlineQueryUpdate / chosenInlineResultUpdate build their payloads", () => {
+    const iq = inlineQueryUpdate({ query: "cats", fromId: 5 });
+    assert.equal(iq.inline_query?.query, "cats");
+    assert.equal(iq.inline_query?.from.id, 5);
+    const cir = chosenInlineResultUpdate({ resultId: "r1", query: "cats" });
+    assert.equal(cir.chosen_inline_result?.result_id, "r1");
+});
+test("shippingQueryUpdate / preCheckoutQueryUpdate build valid payloads", () => {
+    const sq = shippingQueryUpdate({ shippingAddress: { city: "Berlin" } });
+    assert.equal(sq.shipping_query?.shipping_address.city, "Berlin");
+    const pcq = preCheckoutQueryUpdate({ currency: "EUR", totalAmount: 500 });
+    assert.equal(pcq.pre_checkout_query?.currency, "EUR");
+    assert.equal(pcq.pre_checkout_query?.total_amount, 500);
+});
+test("pollUpdate / pollAnswerUpdate build valid payloads", () => {
+    const poll = pollUpdate({ question: "?", options: ["a", "b", "c"] });
+    assert.equal(poll.poll?.options.length, 3);
+    assert.equal(poll.poll?.options[1]?.text, "b");
+    const answer = pollAnswerUpdate({ optionIds: [1] });
+    assert.deepEqual(answer.poll_answer?.option_ids, [1]);
+});
+test("myChatMemberUpdate / chatMemberUpdate / chatJoinRequestUpdate build valid payloads", () => {
+    const my = myChatMemberUpdate({ oldStatus: "left", newStatus: "member" });
+    assert.equal(my.my_chat_member?.old_chat_member.status, "left");
+    assert.equal(my.my_chat_member?.new_chat_member.status, "member");
+    const other = chatMemberUpdate({ userId: 7 });
+    assert.equal(other.chat_member?.new_chat_member.user.id, 7);
+    const join = chatJoinRequestUpdate({ chatId: 3, fromId: 4, bio: "hi" });
+    assert.equal(join.chat_join_request?.chat.id, 3);
+    assert.equal(join.chat_join_request?.bio, "hi");
+});
+test("detectUpdateType infers the payload key", () => {
+    assert.equal(detectUpdateType(messageUpdate()), "message");
+    assert.equal(detectUpdateType(callbackUpdate()), "callback_query");
+    assert.equal(detectUpdateType(pollUpdate()), "poll");
+});
+//# sourceMappingURL=updates.test.js.map

package/lib/updates.test.js.map

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