@yaebal/test 0.1.0 → 0.2.1

package/lib/user-actor.d.ts.map

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

package/lib/user-actor.js

@@ -0,0 +1,465 @@
+import { ChatActor } from "./chat-actor.js";
+import { fakeFile, resolveSendText } from "./internal.js";
+import { findButton } from "./keyboard.js";
+import { reactionsOf } from "./reactions.js";
+import { buildUser, createUpdate } from "./updates.js";
+function resolveArgs(a, b, pm) {
+    if (a instanceof ChatActor)
+        return [a, (b ?? {})];
+    return [pm, (a ?? {})];
+}
+function captionFields(caption) {
+    if (caption === undefined)
+        return {};
+    const { text, entities } = resolveSendText(caption);
+    return { caption: text, ...(entities.length ? { caption_entities: entities } : {}) };
+}
+/**
+ * a user actor — the primary way to drive a test scenario. every method emits the update a real
+ * Telegram user's action would produce, then dispatches it through the bot under test.
+ */
+export class UserActor {
+    id;
+    payload;
+    pmChat;
+    host;
+    constructor(host, payload) {
+        this.host = host;
+        this.payload = payload;
+        this.id = payload.id;
+        this.pmChat = new ChatActor(host, { type: "private", id: payload.id });
+    }
+    /** scope every send/click/react to a specific chat. */
+    in(chat) {
+        return new UserInChatScope(this, chat);
+    }
+    /** scope click/react/edit to a specific message (its own chat is inferred). */
+    on(message) {
+        return new UserOnMessageScope(this, message);
+    }
+    buildMessage(chat, fields) {
+        const message = {
+            message_id: this.host.nextMessageId(),
+            date: this.host.now(),
+            chat: chat.toChat(),
+            from: this.payload,
+            ...fields,
+        };
+        chat.messages.push(message);
+        return message;
+    }
+    async dispatchMessage(message) {
+        await this.host.dispatch(createUpdate({ message }));
+        return message;
+    }
+    sendMessage(a, b, c) {
+        const chat = a instanceof ChatActor ? a : this.pmChat;
+        const text = (a instanceof ChatActor ? b : a);
+        const options = (a instanceof ChatActor ? c : b);
+        const { text: resolvedText, entities } = resolveSendText(text, options?.entities ?? []);
+        const message = this.buildMessage(chat, {
+            text: resolvedText,
+            ...(entities.length ? { entities } : {}),
+            ...(options?.replyTo ? { reply_to_message: options.replyTo } : {}),
+        });
+        return this.dispatchMessage(message);
+    }
+    /** reply to `message` — same chat, `reply_to_message` set automatically. */
+    sendReply(message, text) {
+        const chat = this.chatOf(message);
+        return this.sendMessage(chat, text, { replyTo: message });
+    }
+    sendCommand(a, b, c) {
+        const chat = a instanceof ChatActor ? a : this.pmChat;
+        const name = (a instanceof ChatActor ? b : a);
+        const args = a instanceof ChatActor ? c : b;
+        const command = `/${name}`;
+        const text = args ? `${command} ${args}` : command;
+        const entity = { type: "bot_command", offset: 0, length: command.length };
+        return this.sendMessage(chat, { text, entities: [entity] });
+    }
+    mediaAttachment(chatOrOverrides, overrides, fields) {
+        const [chat, options] = resolveArgs(chatOrOverrides, overrides, this.pmChat);
+        const message = this.buildMessage(chat, {
+            ...fields,
+            ...captionFields(options.caption),
+            ...(options.spoiler ? { has_media_spoiler: true } : {}),
+        });
+        return this.dispatchMessage(message);
+    }
+    sendPhoto(a, b) {
+        return this.mediaAttachment(a, b, {
+            photo: [
+                { ...fakeFile("photo"), width: 100, height: 100 },
+                { ...fakeFile("photo"), width: 800, height: 600 },
+            ],
+        });
+    }
+    sendVideo(a, b) {
+        return this.mediaAttachment(a, b, {
+            video: { ...fakeFile("video"), width: 1280, height: 720, duration: 10 },
+        });
+    }
+    sendDocument(a, b) {
+        return this.mediaAttachment(a, b, { document: { ...fakeFile("doc"), file_name: "file.bin" } });
+    }
+    sendVoice(a, b) {
+        return this.mediaAttachment(a, b, { voice: { ...fakeFile("voice"), duration: 5 } });
+    }
+    sendAudio(a, b) {
+        return this.mediaAttachment(a, b, { audio: { ...fakeFile("audio"), duration: 30 } });
+    }
+    sendAnimation(a, b) {
+        return this.mediaAttachment(a, b, {
+            animation: { ...fakeFile("gif"), width: 480, height: 270, duration: 3 },
+        });
+    }
+    sendVideoNote(a, b) {
+        return this.mediaAttachment(a, b, {
+            video_note: { ...fakeFile("videonote"), length: 240, duration: 10 },
+        });
+    }
+    sendSticker(a, b) {
+        const [chat, overrides] = resolveArgs(a, b, this.pmChat);
+        const message = this.buildMessage(chat, {
+            sticker: {
+                ...fakeFile("sticker"),
+                type: "regular",
+                width: 512,
+                height: 512,
+                is_animated: false,
+                is_video: false,
+                ...overrides,
+            },
+        });
+        return this.dispatchMessage(message);
+    }
+    sendLocation(a, b) {
+        const chat = a instanceof ChatActor ? a : this.pmChat;
+        const location = (a instanceof ChatActor ? b : a);
+        return this.dispatchMessage(this.buildMessage(chat, { location }));
+    }
+    sendContact(a, b) {
+        const chat = a instanceof ChatActor ? a : this.pmChat;
+        const contact = (a instanceof ChatActor ? b : a);
+        return this.dispatchMessage(this.buildMessage(chat, { contact }));
+    }
+    sendVenue(a, b) {
+        const chat = a instanceof ChatActor ? a : this.pmChat;
+        const venue = (a instanceof ChatActor ? b : a);
+        return this.dispatchMessage(this.buildMessage(chat, { venue }));
+    }
+    sendDice(a, b) {
+        const chat = a instanceof ChatActor ? a : this.pmChat;
+        const emoji = (a instanceof ChatActor ? b : a) ?? "🎲";
+        const faces = { "🎯": 6, "🏀": 5, "⚽": 5, "🎳": 6, "🎰": 64 };
+        const value = 1 + Math.floor(Math.random() * (faces[emoji] ?? 6));
+        return this.dispatchMessage(this.buildMessage(chat, { dice: { emoji, value } }));
+    }
+    /** send several media items as one album — one `message` update per item, sharing `media_group_id`. */
+    async sendMediaGroup(chat, items) {
+        const groupId = `mg_${this.host.nextMessageId()}`;
+        const out = [];
+        for (const item of items) {
+            const message = this.buildMessage(chat, {
+                ...item,
+                media_group_id: groupId,
+            });
+            out.push(await this.dispatchMessage(message));
+        }
+        return out;
+    }
+    chatOf(message) {
+        return message.chat.id === this.pmChat.id
+            ? this.pmChat
+            : ChatActor.fromChat(this.host, message.chat);
+    }
+    /** edit a message's text in place — dispatches `edited_message`; `ctx.updatedAt` (if your context exposes it) reflects the new `edit_date`. */
+    async editMessage(message, text) {
+        const { text: resolvedText, entities } = resolveSendText(text);
+        const edited = {
+            ...message,
+            text: resolvedText,
+            ...(entities.length ? { entities } : { entities: undefined }),
+            edit_date: this.host.now(),
+        };
+        await this.host.dispatch(createUpdate({ edited_message: edited }));
+        return edited;
+    }
+    /** forward `message` — to the user's own PM by default, or to `toChat`. */
+    async forwardMessage(message, toChat) {
+        const chat = toChat ?? this.pmChat;
+        const { message_id: _id, date: _date, chat: _chat, from, ...content } = message;
+        const forwarded = this.buildMessage(chat, {
+            ...content,
+            forward_origin: from
+                ? { type: "user", date: message.date, sender_user: from }
+                : {
+                    type: "channel",
+                    date: message.date,
+                    chat: message.chat,
+                    message_id: message.message_id,
+                },
+        });
+        return this.dispatchMessage(forwarded);
+    }
+    /** pin `message` — dispatches a service `message` update with `pinned_message` set. */
+    async pinMessage(message, inChat) {
+        const chat = inChat ?? this.chatOf(message);
+        const service = this.buildMessage(chat, { pinned_message: message });
+        return this.dispatchMessage(service);
+    }
+    /** click an inline button by its `callback_data` — dispatches `callback_query`. */
+    async click(callbackData, message) {
+        const msg = message ?? this.buildMessage(this.pmChat, {});
+        await this.host.dispatch(createUpdate({
+            callback_query: {
+                id: String(this.host.nextMessageId()),
+                chat_instance: "0",
+                from: this.payload,
+                data: callbackData,
+                message: msg,
+            },
+        }));
+    }
+    /** react to `message` with one or more emojis — `old_reaction` is inferred from this user's last reaction on it. pass `[]` to clear. */
+    async react(emojis, message) {
+        const newReaction = Array.isArray(emojis) ? emojis : [emojis];
+        const state = reactionsOf(message);
+        const oldReaction = state.get(this.id) ?? [];
+        if (newReaction.length === 0)
+            state.delete(this.id);
+        else
+            state.set(this.id, newReaction);
+        await this.host.dispatch(createUpdate({
+            message_reaction: {
+                chat: message.chat,
+                message_id: message.message_id,
+                user: this.payload,
+                date: this.host.now(),
+                old_reaction: oldReaction.map((emoji) => ({ type: "emoji", emoji })),
+                new_reaction: newReaction.map((emoji) => ({ type: "emoji", emoji })),
+            },
+        }));
+    }
+    /** join `chat` — emits `chat_member` (membership change) and a `new_chat_members` service message. */
+    async join(chat) {
+        chat.members.add(this);
+        chat.setMembership(this.id, { status: "member", since: this.host.now() });
+        await this.host.dispatch(createUpdate({
+            chat_member: {
+                chat: chat.toChat(),
+                from: this.payload,
+                date: this.host.now(),
+                old_chat_member: { status: "left", user: this.payload },
+                new_chat_member: { status: "member", user: this.payload },
+            },
+        }));
+        await this.dispatchMessage(this.buildMessage(chat, { new_chat_members: [this.payload] }));
+    }
+    /** leave `chat` — emits `chat_member` (membership change) and a `left_chat_member` service message. */
+    async leave(chat) {
+        chat.members.delete(this);
+        chat.setMembership(this.id, { status: "left", since: this.host.now() });
+        await this.host.dispatch(createUpdate({
+            chat_member: {
+                chat: chat.toChat(),
+                from: this.payload,
+                date: this.host.now(),
+                old_chat_member: { status: "member", user: this.payload },
+                new_chat_member: { status: "left", user: this.payload },
+            },
+        }));
+        await this.dispatchMessage(this.buildMessage(chat, { left_chat_member: this.payload }));
+    }
+    /** send an inline query — pass a `ChatActor` to set `chat_type` automatically. */
+    async sendInlineQuery(query, chatOrOptions, options) {
+        const chat = chatOrOptions instanceof ChatActor ? chatOrOptions : undefined;
+        const opts = (chatOrOptions instanceof ChatActor ? options : chatOrOptions) ?? {};
+        await this.host.dispatch(createUpdate({
+            inline_query: {
+                id: String(this.host.nextMessageId()),
+                from: this.payload,
+                query,
+                offset: opts.offset ?? "",
+                ...(chat ? { chat_type: chat.type === "private" ? "private" : chat.type } : {}),
+            },
+        }));
+    }
+    /** choose a result from a previous inline query — dispatches `chosen_inline_result`. */
+    async chooseInlineResult(resultId, query, options = {}) {
+        await this.host.dispatch(createUpdate({
+            chosen_inline_result: {
+                result_id: resultId,
+                from: this.payload,
+                query,
+                ...(options.inlineMessageId ? { inline_message_id: options.inlineMessageId } : {}),
+            },
+        }));
+    }
+    /** emit a `pre_checkout_query` — the bot is expected to `answerPreCheckoutQuery`. */
+    async sendPreCheckoutQuery(overrides = {}) {
+        const query = {
+            id: String(this.host.nextMessageId()),
+            from: this.payload,
+            currency: "XTR",
+            total_amount: 100,
+            invoice_payload: "payload",
+            ...overrides,
+        };
+        await this.host.dispatch(createUpdate({ pre_checkout_query: query }));
+        return query;
+    }
+    /** emit a `shipping_query`. default shipping address is New York, US. */
+    async sendShippingQuery(overrides = {}) {
+        const query = {
+            id: String(this.host.nextMessageId()),
+            from: this.payload,
+            invoice_payload: "payload",
+            shipping_address: {
+                country_code: "US",
+                state: "",
+                city: "New York",
+                street_line1: "",
+                street_line2: "",
+                post_code: "10001",
+            },
+            ...overrides,
+        };
+        await this.host.dispatch(createUpdate({ shipping_query: query }));
+        return query;
+    }
+    /**
+     * the full payments flow: emits `pre_checkout_query`, then throws unless the bot answered it
+     * with `ok: true` (real Telegram never sends `successful_payment` otherwise), then dispatches
+     * a `message` update carrying `successful_payment`.
+     */
+    async sendSuccessfulPayment(chatOrOverrides, overrides) {
+        const [chat, payment] = resolveArgs(chatOrOverrides, overrides, this.pmChat);
+        const preCheckout = await this.sendPreCheckoutQuery({
+            currency: payment.currency,
+            total_amount: payment.total_amount,
+            invoice_payload: payment.invoice_payload,
+        });
+        const approved = this.host.answeredPreCheckoutQuery(preCheckout.id);
+        if (!approved) {
+            throw new Error("sendSuccessfulPayment(): the bot never answered the pre_checkout_query with { ok: true } — " +
+                "real Telegram would never send successful_payment in that case");
+        }
+        const message = this.buildMessage(chat, {
+            successful_payment: {
+                currency: "XTR",
+                total_amount: 100,
+                invoice_payload: "payload",
+                ...payment,
+            },
+        });
+        return this.dispatchMessage(message);
+    }
+}
+/** returned by {@link UserActor.in} — every method delegates to the underlying user, pre-bound to `chat`. */
+export class UserInChatScope {
+    user;
+    chat;
+    constructor(user, chat) {
+        this.user = user;
+        this.chat = chat;
+    }
+    sendMessage(text, options) {
+        return this.user.sendMessage(this.chat, text, options);
+    }
+    sendReply(message, text) {
+        return this.user.sendReply(message, text);
+    }
+    sendCommand(name, args) {
+        return this.user.sendCommand(this.chat, name, args);
+    }
+    sendPhoto(overrides) {
+        return this.user.sendPhoto(this.chat, overrides);
+    }
+    sendVideo(overrides) {
+        return this.user.sendVideo(this.chat, overrides);
+    }
+    sendDocument(overrides) {
+        return this.user.sendDocument(this.chat, overrides);
+    }
+    sendVoice(overrides) {
+        return this.user.sendVoice(this.chat, overrides);
+    }
+    sendAudio(overrides) {
+        return this.user.sendAudio(this.chat, overrides);
+    }
+    sendAnimation(overrides) {
+        return this.user.sendAnimation(this.chat, overrides);
+    }
+    sendVideoNote(overrides) {
+        return this.user.sendVideoNote(this.chat, overrides);
+    }
+    sendSticker(overrides) {
+        return this.user.sendSticker(this.chat, overrides);
+    }
+    sendLocation(location) {
+        return this.user.sendLocation(this.chat, location);
+    }
+    sendContact(contact) {
+        return this.user.sendContact(this.chat, contact);
+    }
+    sendVenue(venue) {
+        return this.user.sendVenue(this.chat, venue);
+    }
+    sendDice(emoji) {
+        return this.user.sendDice(this.chat, emoji);
+    }
+    sendMediaGroup(items) {
+        return this.user.sendMediaGroup(this.chat, items);
+    }
+    sendInlineQuery(query, options) {
+        return this.user.sendInlineQuery(query, this.chat, options);
+    }
+    sendSuccessfulPayment(overrides) {
+        return this.user.sendSuccessfulPayment(this.chat, overrides);
+    }
+    join() {
+        return this.user.join(this.chat);
+    }
+    leave() {
+        return this.user.leave(this.chat);
+    }
+    on(message) {
+        return this.user.on(message);
+    }
+}
+/** returned by {@link UserActor.on} — click/react/edit pre-bound to `message`. */
+export class UserOnMessageScope {
+    user;
+    message;
+    constructor(user, message) {
+        this.user = user;
+        this.message = message;
+    }
+    click(callbackData) {
+        return this.user.click(callbackData, this.message);
+    }
+    /** find a button by its label (string or regex) in `message`'s inline keyboard and click it. throws if none match. */
+    clickByText(match) {
+        const button = findButton(this.message.reply_markup, match);
+        if (!button) {
+            throw new Error(`clickByText(): no inline button matching ${String(match)} on this message`);
+        }
+        return this.user.click(String(button.callback_data), this.message);
+    }
+    react(emojis) {
+        return this.user.react(emojis, this.message);
+    }
+    editMessage(text) {
+        return this.user.editMessage(this.message, text);
+    }
+    forwardMessage(toChat) {
+        return this.user.forwardMessage(this.message, toChat);
+    }
+    pinMessage(inChat) {
+        return this.user.pinMessage(this.message, inChat);
+    }
+}
+export { buildUser };
+//# sourceMappingURL=user-actor.js.map

package/lib/user-actor.js.map

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

package/lib/webhook.d.ts

@@ -0,0 +1,18 @@
+import type { Update, UpdateSink } from "@yaebal/core";
+/** result of {@link collectUpdates}: an {@link UpdateSink} plus the updates it received, in order. */
+export interface UpdateCollector {
+    sink: UpdateSink;
+    updates: Update[];
+}
+/** a minimal {@link UpdateSink} (the `{ handleUpdate }` shape `webhookCallback`/runners expect) that just records. */
+export declare function collectUpdates(): UpdateCollector;
+/** options for {@link webhookRequest}. */
+export interface WebhookRequestOptions {
+    url?: string;
+    method?: string;
+    secretToken?: string;
+    headers?: Record<string, string>;
+}
+/** build a `Request` carrying `update` as JSON, as telegram would POST it to a webhook handler. */
+export declare function webhookRequest(update: Update, options?: WebhookRequestOptions): Request;
+//# sourceMappingURL=webhook.d.ts.map

package/lib/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../src/webhook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEvD,sGAAsG;AACtG,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,sHAAsH;AACtH,wBAAgB,cAAc,IAAI,eAAe,CAWhD;AAED,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,mGAAmG;AACnG,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAgB3F"}

package/lib/webhook.js

@@ -0,0 +1,25 @@
+/** 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),
+    });
+}
+//# sourceMappingURL=webhook.js.map

package/lib/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../src/webhook.ts"],"names":[],"mappings":"AAQA,sHAAsH;AACtH,MAAM,UAAU,cAAc;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,OAAO;QACN,IAAI,EAAE;YACL,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBAC9B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,CAAC;SACD;QACD,OAAO;KACP,CAAC;AACH,CAAC;AAUD,mGAAmG;AACnG,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,UAAiC,EAAE;IACjF,MAAM,EACL,GAAG,GAAG,iCAAiC,EACvC,MAAM,GAAG,MAAM,EACf,WAAW,EACX,OAAO,GAAG,EAAE,GACZ,GAAG,OAAO,CAAC;IAEZ,MAAM,YAAY,GAA2B,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,OAAO,EAAE,CAAC;IAChG,IAAI,WAAW;QAAE,YAAY,CAAC,iCAAiC,CAAC,GAAG,WAAW,CAAC;IAE/E,OAAO,IAAI,OAAO,CAAC,GAAG,EAAE;QACvB,MAAM;QACN,OAAO,EAAE,YAAY;QACrB,IAAI,EAAE,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;KAChF,CAAC,CAAC;AACJ,CAAC"}

package/lib/webhook.test.d.ts

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

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

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

package/lib/webhook.test.js

@@ -0,0 +1,36 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { withFetch } from "./fetch.js";
+import { messageUpdate } from "./updates.js";
+import { collectUpdates, webhookRequest } from "./webhook.js";
+test("collectUpdates records every update handed to the sink", async () => {
+    const { sink, updates } = collectUpdates();
+    await sink.handleUpdate(messageUpdate({ text: "one" }));
+    await sink.handleUpdate(messageUpdate({ text: "two" }));
+    assert.equal(updates.length, 2);
+    assert.equal(updates[0]?.message?.text, "one");
+});
+test("webhookRequest builds a POST carrying the update as JSON, with an optional secret header", async () => {
+    const update = messageUpdate({ text: "hi" });
+    const req = webhookRequest(update, { secretToken: "s3cret" });
+    assert.equal(req.method, "POST");
+    assert.equal(req.headers.get("x-telegram-bot-api-secret-token"), "s3cret");
+    assert.deepEqual(await req.json(), update);
+});
+test("withFetch stubs globalThis.fetch for the duration of fn, then restores it", async () => {
+    const realFetch = globalThis.fetch;
+    const result = await withFetch(async () => new Response("stubbed"), async () => {
+        const res = await fetch("https://example.invalid/");
+        return res.text();
+    });
+    assert.equal(result, "stubbed");
+    assert.equal(globalThis.fetch, realFetch);
+});
+test("withFetch restores the original fetch even if fn throws", async () => {
+    const realFetch = globalThis.fetch;
+    await assert.rejects(withFetch(async () => new Response("x"), () => {
+        throw new Error("boom");
+    }));
+    assert.equal(globalThis.fetch, realFetch);
+});
+//# sourceMappingURL=webhook.test.js.map

package/lib/webhook.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.test.js","sourceRoot":"","sources":["../src/webhook.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9D,IAAI,CAAC,wDAAwD,EAAE,KAAK,IAAI,EAAE;IACzE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAE3C,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IACxD,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAExD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAChC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0FAA0F,EAAE,KAAK,IAAI,EAAE;IAC3G,MAAM,MAAM,GAAG,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE9D,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC3E,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;IAC5F,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC;IAEnC,MAAM,MAAM,GAAG,MAAM,SAAS,CAC7B,KAAK,IAAI,EAAE,CAAC,IAAI,QAAQ,CAAC,SAAS,CAAC,EACnC,KAAK,IAAI,EAAE;QACV,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACpD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACnB,CAAC,CACD,CAAC;IAEF,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AAC3C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;IAC1E,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC;IAEnC,MAAM,MAAM,CAAC,OAAO,CACnB,SAAS,CACR,KAAK,IAAI,EAAE,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,EAC7B,GAAG,EAAE;QACJ,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC,CACD,CACD,CAAC;IAEF,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AAC3C,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yaebal/test",
-  "version": "0.1.0",
-  "description": "yaebal test — testing utilities for yaebal bots: mock api, update factories, and context builders.",
+  "version": "0.2.1",
+  "description": "yaebal test — an actor-driven test framework for yaebal bots: users/chats that send real updates, a virtual clock, apiError stubs, and satellite-plugin test packs.",
   "type": "module",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -16,7 +16,7 @@
     "src"
   ],
   "dependencies": {
-    "@yaebal/core": "0.0.6"
+    "@yaebal/core": "0.0.9"
   },
   "devDependencies": {
     "@types/node": "latest"
@@ -30,7 +30,9 @@
     "yaebal",
     "test",
     "testing",
-    "mock"
+    "mock",
+    "actor",
+    "e2e"
   ],
   "license": "MIT",
   "repository": {
@@ -44,6 +46,6 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "node --test lib"
+    "test": "node --test lib/*.test.js"
   }
 }