@yaebal/test 0.1.0 → 0.2.1

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

package/lib/user-actor.d.ts

@@ -0,0 +1,188 @@
+import type { Message, MessageEntity, Update, User } from "@yaebal/core";
+import { ChatActor } from "./chat-actor.js";
+import type { ActorHost, SendText } from "./internal.js";
+import { buildUser } from "./updates.js";
+/** shapes not separately exported by `@yaebal/core` — derived structurally from `Message`/`Update` instead of adding a `@yaebal/types` dependency just for names. */
+type MessageField<K extends keyof Message> = NonNullable<Message[K]>;
+type UpdateField<K extends keyof Update> = NonNullable<Update[K]>;
+type Location = MessageField<"location">;
+type Contact = MessageField<"contact">;
+type Venue = MessageField<"venue">;
+type SuccessfulPayment = MessageField<"successful_payment">;
+type PreCheckoutQuery = UpdateField<"pre_checkout_query">;
+type ShippingQuery = UpdateField<"shipping_query">;
+/** options shared by `sendMessage`/`sendReply`/`editMessage`. */
+export interface MessageOptions {
+    /** extra entities to merge in alongside whatever `text` (as a `format` result) already carries. */
+    entities?: MessageEntity[];
+    /** sets `reply_to_message`. */
+    replyTo?: Message;
+}
+/** options shared by the media-sending shortcuts (`sendPhoto`, `sendVideo`, ...). */
+export interface MediaOptions {
+    /** caption — a plain string or a `format`/`fmt` result (entities auto-extracted). */
+    caption?: SendText;
+    /** sets `has_media_spoiler = true`. */
+    spoiler?: boolean;
+}
+/**
+ * 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 declare class UserActor {
+    readonly id: number;
+    readonly payload: User;
+    readonly pmChat: ChatActor;
+    private readonly host;
+    constructor(host: ActorHost, payload: User);
+    /** scope every send/click/react to a specific chat. */
+    in(chat: ChatActor): UserInChatScope;
+    /** scope click/react/edit to a specific message (its own chat is inferred). */
+    on(message: Message): UserOnMessageScope;
+    private buildMessage;
+    private dispatchMessage;
+    /** send a text message — to the user's own PM by default, or into `chat` if given first. */
+    sendMessage(text: SendText, options?: MessageOptions): Promise<Message>;
+    sendMessage(chat: ChatActor, text: SendText, options?: MessageOptions): Promise<Message>;
+    /** reply to `message` — same chat, `reply_to_message` set automatically. */
+    sendReply(message: Message, text: SendText): Promise<Message>;
+    /** send `/name args` — a `bot_command` entity is attached automatically. */
+    sendCommand(name: string, args?: string): Promise<Message>;
+    sendCommand(chat: ChatActor, name: string, args?: string): Promise<Message>;
+    private mediaAttachment;
+    sendPhoto(chat?: ChatActor, overrides?: MediaOptions): Promise<Message>;
+    sendPhoto(overrides?: MediaOptions): Promise<Message>;
+    sendVideo(chat?: ChatActor, overrides?: MediaOptions): Promise<Message>;
+    sendVideo(overrides?: MediaOptions): Promise<Message>;
+    sendDocument(chat?: ChatActor, overrides?: MediaOptions): Promise<Message>;
+    sendDocument(overrides?: MediaOptions): Promise<Message>;
+    sendVoice(chat?: ChatActor, overrides?: MediaOptions): Promise<Message>;
+    sendVoice(overrides?: MediaOptions): Promise<Message>;
+    sendAudio(chat?: ChatActor, overrides?: MediaOptions): Promise<Message>;
+    sendAudio(overrides?: MediaOptions): Promise<Message>;
+    sendAnimation(chat?: ChatActor, overrides?: MediaOptions): Promise<Message>;
+    sendAnimation(overrides?: MediaOptions): Promise<Message>;
+    sendVideoNote(chat?: ChatActor, overrides?: MediaOptions): Promise<Message>;
+    sendVideoNote(overrides?: MediaOptions): Promise<Message>;
+    sendSticker(chat?: ChatActor, overrides?: Partial<Message["sticker"]>): Promise<Message>;
+    sendSticker(overrides?: Partial<Message["sticker"]>): Promise<Message>;
+    sendLocation(location: Partial<Location> & {
+        latitude: number;
+        longitude: number;
+    }, chat?: ChatActor): Promise<Message>;
+    sendLocation(chat: ChatActor, location: Partial<Location> & {
+        latitude: number;
+        longitude: number;
+    }): Promise<Message>;
+    sendContact(contact: Partial<Contact> & {
+        phone_number: string;
+        first_name: string;
+    }, chat?: ChatActor): Promise<Message>;
+    sendContact(chat: ChatActor, contact: Partial<Contact> & {
+        phone_number: string;
+        first_name: string;
+    }): Promise<Message>;
+    sendVenue(venue: Partial<Venue> & {
+        location: Location;
+        title: string;
+        address: string;
+    }, chat?: ChatActor): Promise<Message>;
+    sendVenue(chat: ChatActor, venue: Partial<Venue> & {
+        location: Location;
+        title: string;
+        address: string;
+    }): Promise<Message>;
+    sendDice(chat?: ChatActor, emoji?: string): Promise<Message>;
+    sendDice(emoji?: string): Promise<Message>;
+    /** send several media items as one album — one `message` update per item, sharing `media_group_id`. */
+    sendMediaGroup(chat: ChatActor, items: Array<Partial<Message>>): Promise<Message[]>;
+    private chatOf;
+    /** edit a message's text in place — dispatches `edited_message`; `ctx.updatedAt` (if your context exposes it) reflects the new `edit_date`. */
+    editMessage(message: Message, text: SendText): Promise<Message>;
+    /** forward `message` — to the user's own PM by default, or to `toChat`. */
+    forwardMessage(message: Message, toChat?: ChatActor): Promise<Message>;
+    /** pin `message` — dispatches a service `message` update with `pinned_message` set. */
+    pinMessage(message: Message, inChat?: ChatActor): Promise<Message>;
+    /** click an inline button by its `callback_data` — dispatches `callback_query`. */
+    click(callbackData: string, message?: Message): Promise<void>;
+    /** react to `message` with one or more emojis — `old_reaction` is inferred from this user's last reaction on it. pass `[]` to clear. */
+    react(emojis: string | string[], message: Message): Promise<void>;
+    /** join `chat` — emits `chat_member` (membership change) and a `new_chat_members` service message. */
+    join(chat: ChatActor): Promise<void>;
+    /** leave `chat` — emits `chat_member` (membership change) and a `left_chat_member` service message. */
+    leave(chat: ChatActor): Promise<void>;
+    /** send an inline query — pass a `ChatActor` to set `chat_type` automatically. */
+    sendInlineQuery(query: string, chatOrOptions?: ChatActor | {
+        offset?: string;
+    }, options?: {
+        offset?: string;
+    }): Promise<void>;
+    /** choose a result from a previous inline query — dispatches `chosen_inline_result`. */
+    chooseInlineResult(resultId: string, query: string, options?: {
+        inlineMessageId?: string;
+    }): Promise<void>;
+    /** emit a `pre_checkout_query` — the bot is expected to `answerPreCheckoutQuery`. */
+    sendPreCheckoutQuery(overrides?: Partial<PreCheckoutQuery>): Promise<PreCheckoutQuery>;
+    /** emit a `shipping_query`. default shipping address is New York, US. */
+    sendShippingQuery(overrides?: Partial<ShippingQuery>): Promise<ShippingQuery>;
+    /**
+     * 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`.
+     */
+    sendSuccessfulPayment(chatOrOverrides?: ChatActor | Partial<SuccessfulPayment>, overrides?: Partial<SuccessfulPayment>): Promise<Message>;
+}
+/** returned by {@link UserActor.in} — every method delegates to the underlying user, pre-bound to `chat`. */
+export declare class UserInChatScope {
+    private readonly user;
+    private readonly chat;
+    constructor(user: UserActor, chat: ChatActor);
+    sendMessage(text: SendText, options?: MessageOptions): Promise<Message>;
+    sendReply(message: Message, text: SendText): Promise<Message>;
+    sendCommand(name: string, args?: string): Promise<Message>;
+    sendPhoto(overrides?: MediaOptions): Promise<Message>;
+    sendVideo(overrides?: MediaOptions): Promise<Message>;
+    sendDocument(overrides?: MediaOptions): Promise<Message>;
+    sendVoice(overrides?: MediaOptions): Promise<Message>;
+    sendAudio(overrides?: MediaOptions): Promise<Message>;
+    sendAnimation(overrides?: MediaOptions): Promise<Message>;
+    sendVideoNote(overrides?: MediaOptions): Promise<Message>;
+    sendSticker(overrides?: Partial<Message["sticker"]>): Promise<Message>;
+    sendLocation(location: Partial<Location> & {
+        latitude: number;
+        longitude: number;
+    }): Promise<Message>;
+    sendContact(contact: Partial<Contact> & {
+        phone_number: string;
+        first_name: string;
+    }): Promise<Message>;
+    sendVenue(venue: Partial<Venue> & {
+        location: Location;
+        title: string;
+        address: string;
+    }): Promise<Message>;
+    sendDice(emoji?: string): Promise<Message>;
+    sendMediaGroup(items: Array<Partial<Message>>): Promise<Message[]>;
+    sendInlineQuery(query: string, options?: {
+        offset?: string;
+    }): Promise<void>;
+    sendSuccessfulPayment(overrides?: Partial<SuccessfulPayment>): Promise<Message>;
+    join(): Promise<void>;
+    leave(): Promise<void>;
+    on(message: Message): UserOnMessageScope;
+}
+/** returned by {@link UserActor.on} — click/react/edit pre-bound to `message`. */
+export declare class UserOnMessageScope {
+    private readonly user;
+    private readonly message;
+    constructor(user: UserActor, message: Message);
+    click(callbackData: string): Promise<void>;
+    /** find a button by its label (string or regex) in `message`'s inline keyboard and click it. throws if none match. */
+    clickByText(match: string | RegExp): Promise<void>;
+    react(emojis: string | string[]): Promise<void>;
+    editMessage(text: SendText): Promise<Message>;
+    forwardMessage(toChat?: ChatActor): Promise<Message>;
+    pinMessage(inChat?: ChatActor): Promise<Message>;
+}
+export { buildUser };
+//# sourceMappingURL=user-actor.d.ts.map