@yaebal/test 0.1.0 → 0.2.1

package/lib/index.js

@@ -1,395 +1,23 @@
 /**
- * @yaebal/test — testing utilities for yaebal bots, with zero dependency on any
- * test runner or assertion library. Works with `node:test`, vitest, bun:test,
- * jest, ava — anything that can `await` a promise and call `assert`.
+ * @yaebal/test — an actor-driven test framework for yaebal bots, with zero dependency on any
+ * test runner or assertion library. Works with `node:test`, vitest, bun:test, jest, ava —
+ * anything that can `await` a promise and call `assert`.
  *
- * every plugin test used to hand-build fake updates and a mock api. this package
- * extracts that boilerplate: {@link mockApi} records every call (and can drive
- * real `before`/`after`/`onError` hooks and simulate failures), the `*Update`
- * factories produce real {@link Update} shapes for every update kind, and
- * {@link createContext} wraps one in a core {@link Context}.
- */
-import { Context, } from "@yaebal/core";
-/** default results for known methods; everything else resolves to `{}`. */
-function builtinResult(method, nextMessageId) {
-    if (method.startsWith("send") || method === "copyMessage" || method === "forwardMessage") {
-        return { message_id: nextMessageId() };
-    }
-    if (method === "answerCallbackQuery")
-        return true;
-    if (method === "getMe")
-        return { id: 1, is_bot: true, first_name: "bot", username: "bot" };
-    return {};
-}
-/**
- * a fake {@link Api} whose every method records `{ method, params }` into `calls`
- * and resolves to a sensible default (auto-incrementing `message_id` for `send*`,
- * `true` for `answerCallbackQuery`, `{}` otherwise) — or to whatever `options.results`
- * says. `before`/`after`/`onError` are real hook registrars (not no-ops): register
- * a hook the same way you would on the production `Api` and it actually runs,
- * including retries requested by an `onError` hook. the mock never actually waits
- * on a requested `delayMs` — retries settle instantly, so tests stay fast.
- */
-export function mockApi(options = {}) {
-    const calls = [];
-    const overrides = { ...options.results };
-    const attempts = new Map();
-    let nextMessageId = 1;
-    const hooks = {
-        before: [],
-        after: [],
-        onError: [],
-    };
-    function resolveResult(method, params) {
-        const attempt = (attempts.get(method) ?? 0) + 1;
-        attempts.set(method, attempt);
-        const override = overrides[method];
-        if (typeof override === "function") {
-            return override(params, attempt);
-        }
-        return override !== undefined ? override : builtinResult(method, () => nextMessageId++);
-    }
-    const call = async (method, params) => {
-        let p = params;
-        for (const hook of hooks.before) {
-            const next = await hook(method, p);
-            if (next !== undefined)
-                p = next;
-        }
-        for (let attempt = 1;; attempt++) {
-            calls.push({ method, params: p });
-            let result;
-            try {
-                result = resolveResult(method, p);
-                if (result instanceof Error)
-                    throw result;
-            }
-            catch (error) {
-                let retry;
-                for (const hook of hooks.onError) {
-                    const action = await hook(method, error, attempt);
-                    if (action?.retry) {
-                        retry = action;
-                        break;
-                    }
-                }
-                if (!retry)
-                    throw error;
-                continue; // the mock never actually waits on retry.delayMs
-            }
-            for (const hook of hooks.after) {
-                const next = await hook(method, p, result);
-                if (next !== undefined)
-                    result = next;
-            }
-            return result;
-        }
-    };
-    const registrar = {
-        call: (method, params) => call(method, params),
-        fileUrl: (filePath) => `https://example.invalid/file/${filePath}`,
-        before(hook) {
-            hooks.before.push(hook);
-            return api;
-        },
-        after(hook) {
-            hooks.after.push(hook);
-            return api;
-        },
-        onError(hook) {
-            hooks.onError.push(hook);
-            return api;
-        },
-    };
-    const api = new Proxy(registrar, {
-        get(obj, prop) {
-            if (prop in obj)
-                return obj[prop];
-            const method = (params) => call(prop, params);
-            obj[prop] = method;
-            return method;
-        },
-    });
-    return {
-        api,
-        calls,
-        hooks,
-        lastCall: (method) => method ? [...calls].reverse().find((c) => c.method === method) : calls.at(-1),
-        callsTo: (method) => calls.filter((c) => c.method === method),
-        setResult: (method, result) => {
-            overrides[method] = result;
-        },
-        reset: () => {
-            calls.length = 0;
-            attempts.clear();
-            nextMessageId = 1;
-        },
-    };
-}
-let updateIdCounter = 0;
-/** build an {@link Update} from a partial, filling in a fresh `update_id`. */
-export function createUpdate(partial = {}) {
-    return { update_id: ++updateIdCounter, ...partial };
-}
-const stubUser = (id) => ({ id, is_bot: false, first_name: "u" });
-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 } = options;
-    return createUpdate({
-        callback_query: {
-            id: "1",
-            chat_instance: "0",
-            from: stubUser(fromId),
-            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";
-}
-/**
- * wrap an {@link Update} in a core {@link Context}. the api defaults to a fresh
- * {@link mockApi}; pass `updateType` to override the auto-detected one.
- */
-export function createContext(update, api, updateType) {
-    return new Context({
-        api: api ?? mockApi().api,
-        update,
-        updateType: updateType ?? detectUpdateType(update),
-    });
-}
-/** shortcut: build a `message` update and wrap it in a {@link Context} in one call. */
-export function messageContext(options = {}, api) {
-    return createContext(messageUpdate(options), api);
-}
-/** shortcut: build a `callback_query` update and wrap it in a {@link Context} in one call. */
-export function callbackContext(options = {}, api) {
-    return createContext(callbackUpdate(options), api);
-}
-const noop = async () => { };
-/** run a composer's middleware against a context. resolves when the chain settles. */
-export async function runMiddleware(composer, ctx) {
-    await composer.toMiddleware()(ctx, noop);
-}
-/**
- * search an inline keyboard (a `reply_markup`-shaped object, e.g. from a
- * recorded `sendMessage` call's params) for a button whose text matches a
- * string or regex. returns the button (plus its `row`/`col`) or `undefined`.
+ * {@link createTestEnv} wraps your bot and hands you {@link UserActor}/{@link ChatActor} actors
+ * that send it real updates — messages, commands, media, reactions, button clicks, joins,
+ * payments — the way real Telegram users would. every outgoing api call is intercepted and
+ * recorded (no real HTTP), with sensible auto-stubs, `onApi`/`apiError` overrides for the rest,
+ * a virtual clock for TTL/retry tests, and satellite-plugin test packs.
+ *
+ * fixture builders ({@link messageUpdate} & co.), {@link webhookRequest}/{@link collectUpdates},
+ * and {@link withFetch} remain as the escape hatch beneath the actor api — reach for them when
+ * you need a raw update shape or full control.
  */
-export function findButton(markup, match) {
-    const rows = markup?.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;
-}
-/** a minimal {@link UpdateSink} (the `{ handleUpdate }` shape `webhookCallback`/runners expect) that just records. */
-export function collectUpdates() {
-    const updates = [];
-    return {
-        sink: {
-            handleUpdate: async (update) => {
-                updates.push(update);
-            },
-        },
-        updates,
-    };
-}
-/** build a `Request` carrying `update` as JSON, as telegram would POST it to a webhook handler. */
-export function webhookRequest(update, options = {}) {
-    const { url = "https://example.invalid/webhook", method = "POST", secretToken, headers = {}, } = options;
-    const finalHeaders = { "content-type": "application/json", ...headers };
-    if (secretToken)
-        finalHeaders["x-telegram-bot-api-secret-token"] = secretToken;
-    return new Request(url, {
-        method,
-        headers: finalHeaders,
-        body: method === "GET" || method === "HEAD" ? undefined : JSON.stringify(update),
-    });
-}
-/** stub `globalThis.fetch` for the duration of `fn`, restoring the original afterwards (even on throw). */
-export async function withFetch(handler, fn) {
-    const realFetch = globalThis.fetch;
-    globalThis.fetch = handler;
-    try {
-        return await fn();
-    }
-    finally {
-        globalThis.fetch = realFetch;
-    }
-}
+export { mockApi } from "./api.js";
+export { apiError, ChatActor, createTestEnv, installTestClock, isApiErrorSentinel, TestApiError, TestEnv, UserActor, UserInChatScope, UserOnMessageScope, } from "./env.js";
+export { withFetch } from "./fetch.js";
+export { findButton } from "./keyboard.js";
+export { toPlain } from "./normalize.js";
+export { buildUser, callbackUpdate, channelPostUpdate, chatJoinRequestUpdate, chatMemberUpdate, chosenInlineResultUpdate, createUpdate, detectUpdateType, editedChannelPostUpdate, editedMessageUpdate, inlineQueryUpdate, messageUpdate, myChatMemberUpdate, pollAnswerUpdate, pollUpdate, preCheckoutQueryUpdate, shippingQueryUpdate, } from "./updates.js";
+export { collectUpdates, webhookRequest, } from "./webhook.js";
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAqC,OAAO,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAEN,QAAQ,EAER,SAAS,EAIT,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAOlB,YAAY,EAEZ,OAAO,EAGP,SAAS,EACT,eAAe,EACf,kBAAkB,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAoB,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAEN,SAAS,EAKT,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,wBAAwB,EACxB,YAAY,EACZ,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EAEnB,iBAAiB,EAEjB,aAAa,EACb,kBAAkB,EAIlB,gBAAgB,EAChB,UAAU,EACV,sBAAsB,EAEtB,mBAAmB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,cAAc,EAGd,cAAc,GACd,MAAM,cAAc,CAAC"}

package/lib/internal.d.ts

@@ -0,0 +1,25 @@
+import type { FormatResult, MessageEntity, Update } from "@yaebal/core";
+/**
+ * the sliver of {@link TestEnv} actors need — kept as a separate interface (rather than a
+ * circular import of the class) so `chat-actor.ts`/`user-actor.ts` don't depend on `env.ts`.
+ */
+export interface ActorHost {
+    dispatch(update: Update): Promise<void>;
+    nextMessageId(): number;
+    now(): number;
+    /** did the bot answer `answerPreCheckoutQuery` for `preCheckoutQueryId` with `ok: true`? */
+    answeredPreCheckoutQuery(preCheckoutQueryId: string): boolean;
+}
+/** text an actor method accepts: a plain string, or a `format`/`fmt` result carrying entities. */
+export type SendText = string | FormatResult;
+/** resolve a `SendText` into `{ text, entities }`, merging in any `extraEntities`. */
+export declare function resolveSendText(text: SendText, extraEntities?: MessageEntity[]): {
+    text: string;
+    entities: MessageEntity[];
+};
+/** a fake `{ file_id, file_unique_id }` pair — good enough for tests, never a real download. */
+export declare function fakeFile(prefix: string): {
+    file_id: string;
+    file_unique_id: string;
+};
+//# sourceMappingURL=internal.d.ts.map

package/lib/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAExE;;;GAGG;AACH,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,aAAa,IAAI,MAAM,CAAC;IACxB,GAAG,IAAI,MAAM,CAAC;IACd,4FAA4F;IAC5F,wBAAwB,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC;CAC9D;AAED,kGAAkG;AAClG,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,YAAY,CAAC;AAY7C,sFAAsF;AACtF,wBAAgB,eAAe,CAC9B,IAAI,EAAE,QAAQ,EACd,aAAa,GAAE,aAAa,EAAO,GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;CAAE,CAG7C;AAID,gGAAgG;AAChG,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAGpF"}

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"}