tgplus 1.0.0

package/dist/composer.d.ts

@@ -0,0 +1,88 @@
+import { Context } from "./context";
+import * as T from "./types";
+export type Middleware<C extends Context = Context> = (ctx: C, next: () => Promise<void>) => unknown | Promise<unknown>;
+export type Predicate<C extends Context = Context> = (ctx: C) => boolean;
+/**
+ * Composer is the router/handler-chain layer: `bot.command(...)`, `bot.on(...)`,
+ * `bot.hears(...)`, `bot.action(...)` all boil down to "run this middleware if a
+ * predicate matches, otherwise fall through to the next one" — same mental model
+ * as telegraf/Express, but every helper here is a plain method, not a class you
+ * must extend, so a beginner never needs to know the word "middleware" to start.
+ *
+ * Every matching method below (filter/on/command/hears/action) also has a
+ * `static` counterpart that builds the same middleware WITHOUT registering it
+ * on a Composer — use those to nest matchers inside gates like admin()/
+ * privateChat(): `bot.privateChat(Composer.command("start", handler))`.
+ */
+export declare class Composer<C extends Context = Context> {
+    private stack;
+    /** Register any middleware. Everything else on this class is sugar over `use`. */
+    use(...fns: Middleware<C>[]): this;
+    /** Mount a sub-composer (or another bot) as a nested module. */
+    mount(composer: Composer<C>): this;
+    /** Build a standalone predicate-gated middleware — falls through (calls next()) when the predicate doesn't match. Nestable inside gates like admin()/privateChat(). */
+    static filter<C extends Context = Context>(predicate: Predicate<C>, ...fns: Middleware<C>[]): Middleware<C>;
+    /** Only run `fn` when `predicate(ctx)` is true; otherwise continue down the stack. */
+    filter(predicate: Predicate<C>, ...fns: Middleware<C>[]): this;
+    static on<C extends Context = Context>(type: T.UpdateType | MessageSubType | Predicate<C>, ...fns: Middleware<C>[]): Middleware<C>;
+    /** Restrict to a specific update type: on('message'), on('photo' as a message sub-type), on(customPredicate), etc. */
+    on(type: T.UpdateType | MessageSubType | Predicate<C>, ...fns: Middleware<C>[]): this;
+    static command<C extends Context = Context>(cmd: string | string[], ...fns: Middleware<C>[]): Middleware<C>;
+    /** Match /command or /command@BotName, optionally with args captured in ctx.match. */
+    command(cmd: string | string[], ...fns: Middleware<C>[]): this;
+    static hears<C extends Context = Context>(trigger: string | RegExp, ...fns: Middleware<C>[]): Middleware<C>;
+    /** Match message text against a string (exact) or RegExp (captures land in ctx.match). */
+    hears(trigger: string | RegExp, ...fns: Middleware<C>[]): this;
+    static action<C extends Context = Context>(trigger: string | RegExp, ...fns: Middleware<C>[]): Middleware<C>;
+    /** Match callback_query data against a string (exact) or RegExp (captures land in ctx.match). */
+    action(trigger: string | RegExp, ...fns: Middleware<C>[]): this;
+    /** Catch-all fallback if nothing above matched — put this last. */
+    otherwise(...fns: Middleware<C>[]): this;
+    /** Only run fns when the update's chat is one of the given types — e.g. chatType('private'), chatType(['group', 'supergroup']). */
+    chatType(type: T.ChatType | T.ChatType[], ...fns: Middleware<C>[]): this;
+    /** Only run fns in a private (1:1) chat with the bot. */
+    privateChat(...fns: Middleware<C>[]): this;
+    /** Only run fns in a group or supergroup. */
+    groupChat(...fns: Middleware<C>[]): this;
+    /**
+     * Only run fns if the sender is an admin or the creator of the chat.
+     * Makes one getChatMember call per matching update — for high-traffic
+     * chats, consider caching admin lists yourself instead.
+     */
+    admin(...fns: Middleware<C>[]): this;
+    /** Only run fns if the sender is the creator (owner) of the chat. */
+    creator(...fns: Middleware<C>[]): this;
+    /** Alias for filter() matching telegraf's naming — run fns only when predicate(ctx) is true. */
+    optional(predicate: Predicate<C>, ...fns: Middleware<C>[]): this;
+    /** Route to one of two middleware branches depending on predicate(ctx), telegraf-style. */
+    branch(predicate: Predicate<C> | ((ctx: C) => Promise<boolean>), whenTrue: Middleware<C> | Middleware<C>[], whenFalse: Middleware<C> | Middleware<C>[]): this;
+    /** Resolve which middleware to run at dispatch time — e.g. per-tenant config, feature flags, A/B tests. */
+    lazy(factory: (ctx: C) => Middleware<C> | Promise<Middleware<C>>): this;
+    /** Combine several middlewares into one, without needing a Composer instance — matches telegraf's static Composer.compose. */
+    static compose<C extends Context = Context>(fns: Middleware<C>[]): Middleware<C>;
+    /** Run the whole stack for a context. Used internally by Bot; exposed for testing. */
+    handle(ctx: C, done?: () => Promise<void>): Promise<void>;
+}
+/**
+ * Routes to a different sub-middleware based on a key derived from ctx —
+ * e.g. multi-tenant bots, or dispatching by a stored "current step" value
+ * that doesn't fit the Scenes model. Falls through via otherwise() (or the
+ * outer chain) if no route matches.
+ *
+ *   const router = new Router<Context>((ctx) => ctx.session?.lang);
+ *   router.on('en', (ctx) => ctx.reply('Hi!'));
+ *   router.on('fr', (ctx) => ctx.reply('Salut!'));
+ *   router.otherwise((ctx) => ctx.reply('Hi!'));
+ *   bot.use(router.middleware());
+ */
+export declare class Router<C extends Context = Context> {
+    private keyFn;
+    private routes;
+    private fallback?;
+    constructor(keyFn: (ctx: C) => string | undefined | Promise<string | undefined>);
+    on(key: string, ...fns: Middleware<C>[]): this;
+    otherwise(...fns: Middleware<C>[]): this;
+    middleware(): Middleware<C>;
+}
+type MessageSubType = "text" | "photo" | "video" | "document" | "audio" | "voice" | "sticker" | "location" | "contact" | "poll" | "dice" | "video_note" | "rich_message";
+export {};

package/dist/composer.js

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Router = exports.Composer = void 0;
+/**
+ * Composer is the router/handler-chain layer: `bot.command(...)`, `bot.on(...)`,
+ * `bot.hears(...)`, `bot.action(...)` all boil down to "run this middleware if a
+ * predicate matches, otherwise fall through to the next one" — same mental model
+ * as telegraf/Express, but every helper here is a plain method, not a class you
+ * must extend, so a beginner never needs to know the word "middleware" to start.
+ *
+ * Every matching method below (filter/on/command/hears/action) also has a
+ * `static` counterpart that builds the same middleware WITHOUT registering it
+ * on a Composer — use those to nest matchers inside gates like admin()/
+ * privateChat(): `bot.privateChat(Composer.command("start", handler))`.
+ */
+class Composer {
+    stack = [];
+    /** Register any middleware. Everything else on this class is sugar over `use`. */
+    use(...fns) {
+        this.stack.push(...fns);
+        return this;
+    }
+    /** Mount a sub-composer (or another bot) as a nested module. */
+    mount(composer) {
+        return this.use((ctx, next) => composer.handle(ctx, next));
+    }
+    /** Build a standalone predicate-gated middleware — falls through (calls next()) when the predicate doesn't match. Nestable inside gates like admin()/privateChat(). */
+    static filter(predicate, ...fns) {
+        const inner = Composer.compose(fns);
+        return async (ctx, next) => {
+            if (predicate(ctx))
+                return inner(ctx, next);
+            return next();
+        };
+    }
+    /** Only run `fn` when `predicate(ctx)` is true; otherwise continue down the stack. */
+    filter(predicate, ...fns) {
+        return this.use(Composer.filter(predicate, ...fns));
+    }
+    static on(type, ...fns) {
+        const predicate = typeof type === "function" ? type : (ctx) => matchesUpdateType(ctx, type);
+        return Composer.filter(predicate, ...fns);
+    }
+    /** Restrict to a specific update type: on('message'), on('photo' as a message sub-type), on(customPredicate), etc. */
+    on(type, ...fns) {
+        return this.use(Composer.on(type, ...fns));
+    }
+    static command(cmd, ...fns) {
+        const cmds = (Array.isArray(cmd) ? cmd : [cmd]).map((c) => c.replace(/^\//, ""));
+        return Composer.filter((ctx) => {
+            const text = ctx.message?.text;
+            if (!text?.startsWith("/"))
+                return false;
+            const [used, ...rest] = text.slice(1).split(/\s+/);
+            const [name] = used.split("@");
+            if (!cmds.includes(name))
+                return false;
+            ctx.match = [text, rest.join(" ")];
+            return true;
+        }, ...fns);
+    }
+    /** Match /command or /command@BotName, optionally with args captured in ctx.match. */
+    command(cmd, ...fns) {
+        return this.use(Composer.command(cmd, ...fns));
+    }
+    static hears(trigger, ...fns) {
+        return Composer.filter((ctx) => {
+            const text = ctx.message?.text;
+            if (text === undefined)
+                return false;
+            if (typeof trigger === "string")
+                return text === trigger;
+            const m = text.match(trigger);
+            if (m)
+                ctx.match = m;
+            return !!m;
+        }, ...fns);
+    }
+    /** Match message text against a string (exact) or RegExp (captures land in ctx.match). */
+    hears(trigger, ...fns) {
+        return this.use(Composer.hears(trigger, ...fns));
+    }
+    static action(trigger, ...fns) {
+        return Composer.filter((ctx) => {
+            const data = ctx.callbackQuery?.data;
+            if (data === undefined)
+                return false;
+            if (typeof trigger === "string")
+                return data === trigger;
+            const m = data.match(trigger);
+            if (m)
+                ctx.match = m;
+            return !!m;
+        }, ...fns);
+    }
+    /** Match callback_query data against a string (exact) or RegExp (captures land in ctx.match). */
+    action(trigger, ...fns) {
+        return this.use(Composer.action(trigger, ...fns));
+    }
+    /** Catch-all fallback if nothing above matched — put this last. */
+    otherwise(...fns) {
+        return this.use(...fns);
+    }
+    /** Only run fns when the update's chat is one of the given types — e.g. chatType('private'), chatType(['group', 'supergroup']). */
+    chatType(type, ...fns) {
+        const types = Array.isArray(type) ? type : [type];
+        return this.filter((ctx) => !!ctx.chat && types.includes(ctx.chat.type), ...fns);
+    }
+    /** Only run fns in a private (1:1) chat with the bot. */
+    privateChat(...fns) {
+        return this.chatType("private", ...fns);
+    }
+    /** Only run fns in a group or supergroup. */
+    groupChat(...fns) {
+        return this.chatType(["group", "supergroup"], ...fns);
+    }
+    /**
+     * Only run fns if the sender is an admin or the creator of the chat.
+     * Makes one getChatMember call per matching update — for high-traffic
+     * chats, consider caching admin lists yourself instead.
+     */
+    admin(...fns) {
+        const inner = Composer.compose(fns);
+        return this.use(async (ctx, next) => {
+            if (!ctx.chat || !ctx.from)
+                return;
+            const member = await ctx.api.getChatMember({ chat_id: ctx.chat.id, user_id: ctx.from.id }).catch(() => null);
+            if (member?.status === "administrator" || member?.status === "creator")
+                return inner(ctx, next);
+        });
+    }
+    /** Only run fns if the sender is the creator (owner) of the chat. */
+    creator(...fns) {
+        const inner = Composer.compose(fns);
+        return this.use(async (ctx, next) => {
+            if (!ctx.chat || !ctx.from)
+                return;
+            const member = await ctx.api.getChatMember({ chat_id: ctx.chat.id, user_id: ctx.from.id }).catch(() => null);
+            if (member?.status === "creator")
+                return inner(ctx, next);
+        });
+    }
+    /** Alias for filter() matching telegraf's naming — run fns only when predicate(ctx) is true. */
+    optional(predicate, ...fns) {
+        return this.filter(predicate, ...fns);
+    }
+    /** Route to one of two middleware branches depending on predicate(ctx), telegraf-style. */
+    branch(predicate, whenTrue, whenFalse) {
+        const trueMw = Composer.compose(Array.isArray(whenTrue) ? whenTrue : [whenTrue]);
+        const falseMw = Composer.compose(Array.isArray(whenFalse) ? whenFalse : [whenFalse]);
+        return this.use(async (ctx, next) => {
+            const result = await predicate(ctx);
+            return result ? trueMw(ctx, next) : falseMw(ctx, next);
+        });
+    }
+    /** Resolve which middleware to run at dispatch time — e.g. per-tenant config, feature flags, A/B tests. */
+    lazy(factory) {
+        return this.use(async (ctx, next) => {
+            const mw = await factory(ctx);
+            return mw(ctx, next);
+        });
+    }
+    /** Combine several middlewares into one, without needing a Composer instance — matches telegraf's static Composer.compose. */
+    static compose(fns) {
+        return (ctx, next) => runChain(fns, ctx, next);
+    }
+    /** Run the whole stack for a context. Used internally by Bot; exposed for testing. */
+    async handle(ctx, done = async () => { }) {
+        await runChain(this.stack, ctx, done);
+    }
+}
+exports.Composer = Composer;
+/**
+ * Routes to a different sub-middleware based on a key derived from ctx —
+ * e.g. multi-tenant bots, or dispatching by a stored "current step" value
+ * that doesn't fit the Scenes model. Falls through via otherwise() (or the
+ * outer chain) if no route matches.
+ *
+ *   const router = new Router<Context>((ctx) => ctx.session?.lang);
+ *   router.on('en', (ctx) => ctx.reply('Hi!'));
+ *   router.on('fr', (ctx) => ctx.reply('Salut!'));
+ *   router.otherwise((ctx) => ctx.reply('Hi!'));
+ *   bot.use(router.middleware());
+ */
+class Router {
+    keyFn;
+    routes = new Map();
+    fallback;
+    constructor(keyFn) {
+        this.keyFn = keyFn;
+    }
+    on(key, ...fns) {
+        this.routes.set(key, Composer.compose(fns));
+        return this;
+    }
+    otherwise(...fns) {
+        this.fallback = Composer.compose(fns);
+        return this;
+    }
+    middleware() {
+        return async (ctx, next) => {
+            const key = await this.keyFn(ctx);
+            const route = key !== undefined ? this.routes.get(key) : undefined;
+            if (route)
+                return route(ctx, next);
+            if (this.fallback)
+                return this.fallback(ctx, next);
+            return next();
+        };
+    }
+}
+exports.Router = Router;
+async function runChain(fns, ctx, done) {
+    let i = -1;
+    async function dispatch(idx) {
+        if (idx <= i)
+            throw new Error("next() called multiple times");
+        i = idx;
+        const fn = fns[idx];
+        if (!fn)
+            return done();
+        await fn(ctx, () => dispatch(idx + 1));
+    }
+    await dispatch(0);
+}
+function matchesUpdateType(ctx, type) {
+    if (ctx.updateType === type)
+        return true;
+    if (ctx.message && type in ctx.message)
+        return true;
+    return false;
+}
+//# sourceMappingURL=composer.js.map

package/dist/composer.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,72 @@
+import { Api } from "./client";
+import * as T from "./types";
+/**
+ * Context wraps one incoming Update with the bits people reach for constantly:
+ * ctx.message, ctx.chat, ctx.from, ctx.reply(...), ctx.match (from hears/command regex).
+ *
+ * Every reply/send helper is chainable-friendly (returns the sent Message),
+ * and all take the same options object shape as the underlying Api method —
+ * no new vocabulary to learn on top of the Bot API docs.
+ */
+export declare class Context {
+    readonly update: T.Update;
+    readonly api: Api;
+    readonly botInfo: T.User;
+    /** Populated by Composer when a command/hears/action pattern captured groups. */
+    match: RegExpMatchArray | null;
+    /** Free-for-all bag for your own middleware to stash things (auth info, etc). */
+    state: Record<string, unknown>;
+    /** Populated by the `session()` middleware — persisted across updates for the same chat (or user, if configured). */
+    session?: Record<string, unknown>;
+    /** Populated by `Stage.middleware()` (see scenes.ts) once mounted — lets any handler call ctx.scene.enter(...)/leave(). */
+    scene?: {
+        enter: (sceneId: string, initialState?: Record<string, unknown>) => Promise<void>;
+        leave: () => Promise<void>;
+        current: string | undefined;
+    };
+    /** Populated by `Stage.middleware()` only while a scene is active for this update. */
+    wizard?: {
+        cursor: number;
+        state: Record<string, unknown>;
+        next: () => Promise<void>;
+        selectStep: (index: number) => Promise<void>;
+    };
+    constructor(update: T.Update, api: Api, botInfo: T.User);
+    get updateType(): T.UpdateType;
+    get message(): T.Message | undefined;
+    get callbackQuery(): T.CallbackQuery | undefined;
+    get inlineQuery(): T.InlineQuery | undefined;
+    get chat(): T.Chat | undefined;
+    get from(): T.User | undefined;
+    get text(): string | undefined;
+    get chatId(): T.ChatId | undefined;
+    private baseSend;
+    reply(text: string, extra?: Omit<Parameters<Api["sendMessage"]>[0], "chat_id" | "text">): Promise<T.Message>;
+    /** Send a Rich Message (Bot API 10.1) — tables, checklists, blockquotes, inline media. */
+    replyRich(rich: T.InputRichMessage, extra?: Omit<Parameters<Api["sendRichMessage"]>[0], "chat_id" | "rich_message">): Promise<T.Message>;
+    replyWithPhoto(photo: T.InputFile, extra?: Omit<Parameters<Api["sendPhoto"]>[0], "chat_id" | "photo">): Promise<T.Message>;
+    replyWithVideo(video: T.InputFile, extra?: Omit<Parameters<Api["sendVideo"]>[0], "chat_id" | "video">): Promise<T.Message>;
+    replyWithDocument(document: T.InputFile, extra?: Omit<Parameters<Api["sendDocument"]>[0], "chat_id" | "document">): Promise<T.Message>;
+    replyWithAudio(audio: T.InputFile, extra?: Omit<Parameters<Api["sendAudio"]>[0], "chat_id" | "audio">): Promise<T.Message>;
+    replyWithSticker(sticker: T.InputFile, extra?: Omit<Parameters<Api["sendSticker"]>[0], "chat_id" | "sticker">): Promise<T.Message>;
+    replyWithPoll(question: string, options: string[], extra?: Omit<Parameters<Api["sendPoll"]>[0], "chat_id" | "question" | "options">): Promise<T.Message>;
+    replyWithChatAction(action: Parameters<Api["sendChatAction"]>[0]["action"]): Promise<true>;
+    /**
+     * The message_id to edit/delete when no explicit one is given — resolves
+     * from the current message OR, critically, from callback_query.message
+     * (the "user taps a button, bot edits that message" pattern). Previously
+     * editText()/deleteMessage() only checked ctx.message, which is always
+     * undefined for callback_query updates, silently breaking the single most
+     * common edit-on-button-tap pattern.
+     */
+    private get editableMessageId();
+    /** Edit the message this context came from — works from a plain message context and from inside action()/callback_query handlers. */
+    editText(text: string, extra?: Record<string, unknown>): Promise<true | T.Message>;
+    editCaption(caption: string, extra?: Record<string, unknown>): Promise<true | T.Message>;
+    editMedia(media: T.InputMedia, extra?: Record<string, unknown>): Promise<true | T.Message>;
+    /** Update just the inline keyboard — e.g. toggling a selection without resending the message. */
+    editReplyMarkup(reply_markup?: T.InlineKeyboardMarkup): Promise<true | T.Message>;
+    deleteMessage(messageId?: T.Integer): Promise<true>;
+    answerCbQuery(text?: string, extra?: Omit<Parameters<Api["answerCallbackQuery"]>[0], "callback_query_id" | "text">): Promise<true>;
+    answerInlineQuery(results: T.InlineQueryResult[], extra?: Omit<Parameters<Api["answerInlineQuery"]>[0], "inline_query_id" | "results">): Promise<true>;
+}

package/dist/context.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Context = void 0;
+/**
+ * Context wraps one incoming Update with the bits people reach for constantly:
+ * ctx.message, ctx.chat, ctx.from, ctx.reply(...), ctx.match (from hears/command regex).
+ *
+ * Every reply/send helper is chainable-friendly (returns the sent Message),
+ * and all take the same options object shape as the underlying Api method —
+ * no new vocabulary to learn on top of the Bot API docs.
+ */
+class Context {
+    update;
+    api;
+    botInfo;
+    /** Populated by Composer when a command/hears/action pattern captured groups. */
+    match = null;
+    /** Free-for-all bag for your own middleware to stash things (auth info, etc). */
+    state = {};
+    /** Populated by the `session()` middleware — persisted across updates for the same chat (or user, if configured). */
+    session;
+    /** Populated by `Stage.middleware()` (see scenes.ts) once mounted — lets any handler call ctx.scene.enter(...)/leave(). */
+    scene;
+    /** Populated by `Stage.middleware()` only while a scene is active for this update. */
+    wizard;
+    constructor(update, api, botInfo) {
+        this.update = update;
+        this.api = api;
+        this.botInfo = botInfo;
+    }
+    get updateType() {
+        const known = [
+            "message", "edited_message", "channel_post", "edited_channel_post",
+            "business_message", "inline_query", "chosen_inline_result", "callback_query",
+            "shipping_query", "pre_checkout_query", "poll", "poll_answer",
+            "my_chat_member", "chat_member", "chat_join_request", "subscription",
+            "managed_bot_created", "managed_bot",
+        ];
+        return known.find((k) => this.update[k] !== undefined);
+    }
+    get message() {
+        return this.update.message ?? this.update.channel_post ?? this.update.business_message ?? this.update.edited_message;
+    }
+    get callbackQuery() { return this.update.callback_query; }
+    get inlineQuery() { return this.update.inline_query; }
+    get chat() {
+        return (this.message?.chat ??
+            this.callbackQuery?.message?.chat ??
+            this.update.my_chat_member?.chat ??
+            this.update.chat_member?.chat ??
+            this.update.chat_join_request?.chat ??
+            this.update.chat_boost?.chat ??
+            this.update.removed_chat_boost?.chat ??
+            this.update.poll_answer?.voter_chat);
+    }
+    get from() {
+        return (this.message?.from ??
+            this.callbackQuery?.from ??
+            this.inlineQuery?.from ??
+            this.update.chat_join_request?.from ??
+            this.update.my_chat_member?.from ??
+            this.update.chat_member?.from ??
+            this.update.shipping_query?.from ??
+            this.update.pre_checkout_query?.from ??
+            this.update.poll_answer?.user);
+    }
+    get text() { return this.message?.text; }
+    get chatId() { return this.chat?.id; }
+    // ----- Reply helpers (auto-fill chat_id + reply_to_message_id) -----
+    baseSend() {
+        if (this.chatId === undefined)
+            throw new Error("ctx has no chat to reply to for this update type");
+        return { chat_id: this.chatId };
+    }
+    reply(text, extra = {}) {
+        return this.api.sendMessage({ ...this.baseSend(), text, ...extra });
+    }
+    /** Send a Rich Message (Bot API 10.1) — tables, checklists, blockquotes, inline media. */
+    replyRich(rich, extra = {}) {
+        return this.api.sendRichMessage({ ...this.baseSend(), rich_message: rich, ...extra });
+    }
+    replyWithPhoto(photo, extra = {}) {
+        return this.api.sendPhoto({ ...this.baseSend(), photo, ...extra });
+    }
+    replyWithVideo(video, extra = {}) {
+        return this.api.sendVideo({ ...this.baseSend(), video, ...extra });
+    }
+    replyWithDocument(document, extra = {}) {
+        return this.api.sendDocument({ ...this.baseSend(), document, ...extra });
+    }
+    replyWithAudio(audio, extra = {}) {
+        return this.api.sendAudio({ ...this.baseSend(), audio, ...extra });
+    }
+    replyWithSticker(sticker, extra = {}) {
+        return this.api.sendSticker({ ...this.baseSend(), sticker, ...extra });
+    }
+    replyWithPoll(question, options, extra = {}) {
+        return this.api.sendPoll({ ...this.baseSend(), question, options, ...extra });
+    }
+    replyWithChatAction(action) {
+        return this.api.sendChatAction({ ...this.baseSend(), action });
+    }
+    /**
+     * The message_id to edit/delete when no explicit one is given — resolves
+     * from the current message OR, critically, from callback_query.message
+     * (the "user taps a button, bot edits that message" pattern). Previously
+     * editText()/deleteMessage() only checked ctx.message, which is always
+     * undefined for callback_query updates, silently breaking the single most
+     * common edit-on-button-tap pattern.
+     */
+    get editableMessageId() {
+        return this.message?.message_id ?? this.callbackQuery?.message?.message_id;
+    }
+    /** Edit the message this context came from — works from a plain message context and from inside action()/callback_query handlers. */
+    editText(text, extra = {}) {
+        return this.api.editMessageText({ chat_id: this.chatId, message_id: this.editableMessageId, text, ...extra });
+    }
+    editCaption(caption, extra = {}) {
+        return this.api.editMessageCaption({ chat_id: this.chatId, message_id: this.editableMessageId, caption, ...extra });
+    }
+    editMedia(media, extra = {}) {
+        return this.api.editMessageMedia({ chat_id: this.chatId, message_id: this.editableMessageId, media, ...extra });
+    }
+    /** Update just the inline keyboard — e.g. toggling a selection without resending the message. */
+    editReplyMarkup(reply_markup) {
+        return this.api.editMessageReplyMarkup({ chat_id: this.chatId, message_id: this.editableMessageId, reply_markup });
+    }
+    deleteMessage(messageId) {
+        const id = messageId ?? this.editableMessageId;
+        if (this.chatId === undefined || id === undefined) {
+            throw new Error("ctx has no message to delete for this update type — pass a message_id explicitly");
+        }
+        return this.api.deleteMessage({ chat_id: this.chatId, message_id: id });
+    }
+    // ----- Callback query -----
+    answerCbQuery(text, extra = {}) {
+        if (!this.callbackQuery)
+            throw new Error("No callback_query on this update");
+        return this.api.answerCallbackQuery({ callback_query_id: this.callbackQuery.id, text, ...extra });
+    }
+    // ----- Inline query -----
+    answerInlineQuery(results, extra = {}) {
+        if (!this.inlineQuery)
+            throw new Error("No inline_query on this update");
+        return this.api.answerInlineQuery({ inline_query_id: this.inlineQuery.id, results, ...extra });
+    }
+}
+exports.Context = Context;
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/decorators.d.ts

@@ -0,0 +1,33 @@
+import { Context } from "./context";
+/**
+ * Decorator-based controllers, for people coming from aiogram's class-based
+ * routers or from Nest/Spring-style frameworks. These are pure sugar: every
+ * decorator just records "when X matches, call this method" into a registry,
+ * and `bot.useController(instance)` replays that registry onto the same
+ * Composer used by the functional and fluent styles — so all three styles
+ * can be mixed in one bot.
+ */
+type HandlerKind = {
+    kind: "command";
+    value: string | string[];
+} | {
+    kind: "hears";
+    value: string | RegExp;
+} | {
+    kind: "action";
+    value: string | RegExp;
+} | {
+    kind: "on";
+    value: string;
+};
+export declare function getControllerHandlers(instance: object): {
+    meta: HandlerKind;
+    fn: (ctx: Context, next: () => Promise<void>) => unknown;
+}[];
+/** Class decorator — purely documentational/marker, so tgplus controllers are easy to spot. Optional. */
+export declare function BotController(): ClassDecorator;
+export declare function Command(name: string | string[]): MethodDecorator;
+export declare function Hears(trigger: string | RegExp): MethodDecorator;
+export declare function Action(trigger: string | RegExp): MethodDecorator;
+export declare function On(updateType: string): MethodDecorator;
+export {};

package/dist/decorators.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getControllerHandlers = getControllerHandlers;
+exports.BotController = BotController;
+exports.Command = Command;
+exports.Hears = Hears;
+exports.Action = Action;
+exports.On = On;
+const registry = new WeakMap();
+function register(target, methodName, meta) {
+    const ctor = target.constructor;
+    const list = registry.get(ctor) ?? [];
+    list.push({ ...meta, methodName });
+    registry.set(ctor, list);
+}
+function getControllerHandlers(instance) {
+    const list = registry.get(instance.constructor) ?? [];
+    return list.map((h) => ({
+        meta: h,
+        fn: (ctx, next) => instance[h.methodName](ctx, next),
+    }));
+}
+/** Class decorator — purely documentational/marker, so tgplus controllers are easy to spot. Optional. */
+function BotController() {
+    return (target) => target;
+}
+function Command(name) {
+    return (target, propertyKey) => register(target, propertyKey, { kind: "command", value: name });
+}
+function Hears(trigger) {
+    return (target, propertyKey) => register(target, propertyKey, { kind: "hears", value: trigger });
+}
+function Action(trigger) {
+    return (target, propertyKey) => register(target, propertyKey, { kind: "action", value: trigger });
+}
+function On(updateType) {
+    return (target, propertyKey) => register(target, propertyKey, { kind: "on", value: updateType });
+}
+//# sourceMappingURL=decorators.js.map

package/dist/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":";;AA4BA,sDAMC;AAGD,sCAEC;AAED,0BAEC;AAED,sBAEC;AAED,wBAEC;AAED,gBAEC;AApCD,MAAM,QAAQ,GAAG,IAAI,OAAO,EAA2B,CAAC;AAExD,SAAS,QAAQ,CAAC,MAAc,EAAE,UAA2B,EAAE,IAAiB;IAC9E,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC;IAChC,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACtC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IACnC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,SAAgB,qBAAqB,CAAC,QAAgB;IACpD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;IACtD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtB,IAAI,EAAE,CAAC;QACP,EAAE,EAAE,CAAC,GAAY,EAAE,IAAyB,EAAE,EAAE,CAAE,QAAgB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC;KAC5F,CAAC,CAAC,CAAC;AACN,CAAC;AAED,yGAAyG;AACzG,SAAgB,aAAa;IAC3B,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC;AAC5B,CAAC;AAED,SAAgB,OAAO,CAAC,IAAuB;IAC7C,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAgB,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5G,CAAC;AAED,SAAgB,KAAK,CAAC,OAAwB;IAC5C,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAgB,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AAC7G,CAAC;AAED,SAAgB,MAAM,CAAC,OAAwB;IAC7C,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAgB,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AAC9G,CAAC;AAED,SAAgB,EAAE,CAAC,UAAkB;IACnC,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAgB,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;AAC7G,CAAC"}