tgplus 1.0.0

package/dist/filters.d.ts

@@ -0,0 +1,19 @@
+import { Context } from "./context";
+import { Predicate } from "./composer";
+export declare function mention(): Predicate<Context>;
+export declare function hashtag(): Predicate<Context>;
+export declare function cashtag(): Predicate<Context>;
+export declare function url(): Predicate<Context>;
+export declare function textLink(): Predicate<Context>;
+export declare function textMention(): Predicate<Context>;
+export declare function phone(): Predicate<Context>;
+export declare function email(): Predicate<Context>;
+export declare function botCommand(): Predicate<Context>;
+export declare function spoiler(): Predicate<Context>;
+export declare function customEmoji(): Predicate<Context>;
+/**
+ * Matches message_reaction updates — optionally only a specific emoji being
+ * added. `reaction()` alone matches any reaction change; `reaction('👍')`
+ * matches only when 👍 appears in the new reaction set.
+ */
+export declare function reaction(emoji?: string): Predicate<Context>;

package/dist/filters.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mention = mention;
+exports.hashtag = hashtag;
+exports.cashtag = cashtag;
+exports.url = url;
+exports.textLink = textLink;
+exports.textMention = textMention;
+exports.phone = phone;
+exports.email = email;
+exports.botCommand = botCommand;
+exports.spoiler = spoiler;
+exports.customEmoji = customEmoji;
+exports.reaction = reaction;
+/**
+ * Composable predicates for common message-entity and reaction patterns,
+ * matching telegraf's `telegraf/filters` module. Use with `bot.on(filter())`
+ * (on() accepts a predicate directly) or `bot.filter(filter(), ...)`.
+ *
+ *   import { mention, hashtag } from "tgplus";
+ *   bot.on(mention(), (ctx) => ctx.reply("Someone got mentioned!"));
+ *
+ * Each filter maps to exactly one real Bot API entity type — mention() only
+ * matches "@username" mentions, textMention() only matches the separate
+ * "user without a username" mention type, url() only matches plain URL
+ * text, textLink() only matches markdown-style [label](url) links. They're
+ * deliberately not merged, since Telegram treats them as distinct entities.
+ */
+function hasEntityType(ctx, type) {
+    const entities = ctx.message?.entities ?? ctx.message?.caption_entities ?? [];
+    return entities.some((e) => e.type === type);
+}
+function mention() {
+    return (ctx) => hasEntityType(ctx, "mention");
+}
+function hashtag() {
+    return (ctx) => hasEntityType(ctx, "hashtag");
+}
+function cashtag() {
+    return (ctx) => hasEntityType(ctx, "cashtag");
+}
+function url() {
+    return (ctx) => hasEntityType(ctx, "url");
+}
+function textLink() {
+    return (ctx) => hasEntityType(ctx, "text_link");
+}
+function textMention() {
+    return (ctx) => hasEntityType(ctx, "text_mention");
+}
+function phone() {
+    return (ctx) => hasEntityType(ctx, "phone_number");
+}
+function email() {
+    return (ctx) => hasEntityType(ctx, "email");
+}
+function botCommand() {
+    return (ctx) => hasEntityType(ctx, "bot_command");
+}
+function spoiler() {
+    return (ctx) => hasEntityType(ctx, "spoiler");
+}
+function customEmoji() {
+    return (ctx) => hasEntityType(ctx, "custom_emoji");
+}
+/**
+ * Matches message_reaction updates — optionally only a specific emoji being
+ * added. `reaction()` alone matches any reaction change; `reaction('👍')`
+ * matches only when 👍 appears in the new reaction set.
+ */
+function reaction(emoji) {
+    return (ctx) => {
+        const r = ctx.update.message_reaction;
+        if (!r)
+            return false;
+        if (!emoji)
+            return true;
+        return r.new_reaction.some((rt) => rt.type === "emoji" && rt.emoji === emoji);
+    };
+}
+//# sourceMappingURL=filters.js.map

package/dist/filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.js","sourceRoot":"","sources":["../src/filters.ts"],"names":[],"mappings":";;AAwBA,0BAEC;AACD,0BAEC;AACD,0BAEC;AACD,kBAEC;AACD,4BAEC;AACD,kCAEC;AACD,sBAEC;AACD,sBAEC;AACD,gCAEC;AACD,0BAEC;AACD,kCAEC;AAOD,4BAOC;AAlED;;;;;;;;;;;;;GAaG;AAEH,SAAS,aAAa,CAAC,GAAY,EAAE,IAA6B;IAChE,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,EAAE,QAAQ,IAAI,GAAG,CAAC,OAAO,EAAE,gBAAgB,IAAI,EAAE,CAAC;IAC9E,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,SAAgB,OAAO;IACrB,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AAChD,CAAC;AACD,SAAgB,OAAO;IACrB,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AAChD,CAAC;AACD,SAAgB,OAAO;IACrB,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AAChD,CAAC;AACD,SAAgB,GAAG;IACjB,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAC5C,CAAC;AACD,SAAgB,QAAQ;IACtB,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AAClD,CAAC;AACD,SAAgB,WAAW;IACzB,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;AACrD,CAAC;AACD,SAAgB,KAAK;IACnB,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;AACrD,CAAC;AACD,SAAgB,KAAK;IACnB,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AACD,SAAgB,UAAU;IACxB,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;AACpD,CAAC;AACD,SAAgB,OAAO;IACrB,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AAChD,CAAC;AACD,SAAgB,WAAW;IACzB,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,SAAgB,QAAQ,CAAC,KAAc;IACrC,OAAO,CAAC,GAAG,EAAE,EAAE;QACb,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC;QACtC,IAAI,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QACrB,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,OAAO,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,OAAO,IAAI,EAAE,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IAChF,CAAC,CAAC;AACJ,CAAC"}

package/dist/i18n.d.ts

@@ -0,0 +1,30 @@
+import { Context } from "./context";
+import { Middleware } from "./composer";
+export type Dictionary = Record<string, string | ((...args: any[]) => string)>;
+export type Locales = Record<string, Dictionary>;
+export interface I18nOptions {
+    locales: Locales;
+    defaultLocale: string;
+    /** Defaults to reading ctx.from.language_code (what Telegram clients send). */
+    getLocale?: (ctx: Context) => string | undefined;
+}
+/**
+ * Attaches `ctx.t(key, ...args)`, translating using the user's Telegram
+ * `language_code` with a fallback to `defaultLocale`. Interpolation is up to
+ * you — a dictionary value can be a plain string or a function for
+ * pluralization/placeholders.
+ *
+ *   const i18n = createI18n({
+ *     defaultLocale: 'en',
+ *     locales: {
+ *       en: { greeting: (name) => `Hello, ${name}!` },
+ *       fr: { greeting: (name) => `Bonjour, ${name}!` },
+ *     },
+ *   });
+ *   bot.use(i18n.middleware());
+ *   bot.command('start', (ctx) => ctx.reply(ctx.t('greeting', ctx.from?.first_name)));
+ */
+export declare function createI18n(opts: I18nOptions): {
+    translate: (locale: string | undefined, key: string, ...args: unknown[]) => string;
+    middleware(): Middleware<Context>;
+};

package/dist/i18n.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createI18n = createI18n;
+/**
+ * Attaches `ctx.t(key, ...args)`, translating using the user's Telegram
+ * `language_code` with a fallback to `defaultLocale`. Interpolation is up to
+ * you — a dictionary value can be a plain string or a function for
+ * pluralization/placeholders.
+ *
+ *   const i18n = createI18n({
+ *     defaultLocale: 'en',
+ *     locales: {
+ *       en: { greeting: (name) => `Hello, ${name}!` },
+ *       fr: { greeting: (name) => `Bonjour, ${name}!` },
+ *     },
+ *   });
+ *   bot.use(i18n.middleware());
+ *   bot.command('start', (ctx) => ctx.reply(ctx.t('greeting', ctx.from?.first_name)));
+ */
+function createI18n(opts) {
+    const getLocale = opts.getLocale ?? ((ctx) => ctx.from?.language_code);
+    function translate(locale, key, ...args) {
+        const dict = (locale && opts.locales[locale]) || opts.locales[opts.defaultLocale] || {};
+        const entry = dict[key];
+        if (entry === undefined)
+            return key; // missing translation — fail loud-ish but not throw
+        return typeof entry === "function" ? entry(...args) : entry;
+    }
+    return {
+        translate,
+        middleware() {
+            return (ctx, next) => {
+                const locale = getLocale(ctx);
+                ctx.locale = locale;
+                ctx.t = (key, ...args) => translate(locale, key, ...args);
+                return next();
+            };
+        },
+    };
+}
+//# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":";;AA6BA,gCAqBC;AArCD;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,UAAU,CAAC,IAAiB;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,GAAY,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAEhF,SAAS,SAAS,CAAC,MAA0B,EAAE,GAAW,EAAE,GAAG,IAAe;QAC5E,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;QACxF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,GAAG,CAAC,CAAC,oDAAoD;QACzF,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9D,CAAC;IAED,OAAO;QACL,SAAS;QACT,UAAU;YACR,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;gBACnB,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;gBAC7B,GAA0D,CAAC,MAAM,GAAG,MAAM,CAAC;gBAC3E,GAAoE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;gBAC5H,OAAO,IAAI,EAAE,CAAC;YAChB,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { Bot, BotOptions } from "./bot";
+export { Context } from "./context";
+export { Composer, Router, Middleware, Predicate } from "./composer";
+export { Api, Transport, TelegramApiError, ClientOptions } from "./client";
+export { Keyboard, InlineKeyboardBuilder, ReplyKeyboardBuilder } from "./keyboard";
+export { RichMessage, RichMarkdownBuilder, RichHtmlBuilder, RichBlocksBuilder } from "./richMessage";
+export { BotController, Command, Hears, Action, On } from "./decorators";
+export { session, SessionStore, MemorySessionStore, SessionOptions } from "./session";
+export { RedisSessionStore, RedisLikeClient, RedisSessionStoreOptions } from "./session-redis";
+export { SqliteSessionStore, SqliteLikeDatabase, SqliteSessionStoreOptions } from "./session-sqlite";
+export { WizardScene, Stage, WizardContext, WizardState, SceneApi, SceneStep } from "./scenes";
+export { rateLimit, RateLimitOptions } from "./rateLimit";
+export { createI18n, I18nOptions, Dictionary, Locales } from "./i18n";
+export { vercelWebhookHandler, lambdaWebhookHandler, cloudflareWebhookHandler } from "./adapters";
+export { mention, hashtag, cashtag, url, textLink, textMention, phone, email, botCommand, spoiler, customEmoji, reaction } from "./filters";
+export * as Types from "./types";

package/dist/index.js

@@ -0,0 +1,95 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Types = exports.reaction = exports.customEmoji = exports.spoiler = exports.botCommand = exports.email = exports.phone = exports.textMention = exports.textLink = exports.url = exports.cashtag = exports.hashtag = exports.mention = exports.cloudflareWebhookHandler = exports.lambdaWebhookHandler = exports.vercelWebhookHandler = exports.createI18n = exports.rateLimit = exports.Stage = exports.WizardScene = exports.SqliteSessionStore = exports.RedisSessionStore = exports.MemorySessionStore = exports.session = exports.On = exports.Action = exports.Hears = exports.Command = exports.BotController = exports.RichBlocksBuilder = exports.RichHtmlBuilder = exports.RichMarkdownBuilder = exports.RichMessage = exports.ReplyKeyboardBuilder = exports.InlineKeyboardBuilder = exports.Keyboard = exports.TelegramApiError = exports.Transport = exports.Api = exports.Router = exports.Composer = exports.Context = exports.Bot = void 0;
+var bot_1 = require("./bot");
+Object.defineProperty(exports, "Bot", { enumerable: true, get: function () { return bot_1.Bot; } });
+var context_1 = require("./context");
+Object.defineProperty(exports, "Context", { enumerable: true, get: function () { return context_1.Context; } });
+var composer_1 = require("./composer");
+Object.defineProperty(exports, "Composer", { enumerable: true, get: function () { return composer_1.Composer; } });
+Object.defineProperty(exports, "Router", { enumerable: true, get: function () { return composer_1.Router; } });
+var client_1 = require("./client");
+Object.defineProperty(exports, "Api", { enumerable: true, get: function () { return client_1.Api; } });
+Object.defineProperty(exports, "Transport", { enumerable: true, get: function () { return client_1.Transport; } });
+Object.defineProperty(exports, "TelegramApiError", { enumerable: true, get: function () { return client_1.TelegramApiError; } });
+var keyboard_1 = require("./keyboard");
+Object.defineProperty(exports, "Keyboard", { enumerable: true, get: function () { return keyboard_1.Keyboard; } });
+Object.defineProperty(exports, "InlineKeyboardBuilder", { enumerable: true, get: function () { return keyboard_1.InlineKeyboardBuilder; } });
+Object.defineProperty(exports, "ReplyKeyboardBuilder", { enumerable: true, get: function () { return keyboard_1.ReplyKeyboardBuilder; } });
+var richMessage_1 = require("./richMessage");
+Object.defineProperty(exports, "RichMessage", { enumerable: true, get: function () { return richMessage_1.RichMessage; } });
+Object.defineProperty(exports, "RichMarkdownBuilder", { enumerable: true, get: function () { return richMessage_1.RichMarkdownBuilder; } });
+Object.defineProperty(exports, "RichHtmlBuilder", { enumerable: true, get: function () { return richMessage_1.RichHtmlBuilder; } });
+Object.defineProperty(exports, "RichBlocksBuilder", { enumerable: true, get: function () { return richMessage_1.RichBlocksBuilder; } });
+var decorators_1 = require("./decorators");
+Object.defineProperty(exports, "BotController", { enumerable: true, get: function () { return decorators_1.BotController; } });
+Object.defineProperty(exports, "Command", { enumerable: true, get: function () { return decorators_1.Command; } });
+Object.defineProperty(exports, "Hears", { enumerable: true, get: function () { return decorators_1.Hears; } });
+Object.defineProperty(exports, "Action", { enumerable: true, get: function () { return decorators_1.Action; } });
+Object.defineProperty(exports, "On", { enumerable: true, get: function () { return decorators_1.On; } });
+var session_1 = require("./session");
+Object.defineProperty(exports, "session", { enumerable: true, get: function () { return session_1.session; } });
+Object.defineProperty(exports, "MemorySessionStore", { enumerable: true, get: function () { return session_1.MemorySessionStore; } });
+var session_redis_1 = require("./session-redis");
+Object.defineProperty(exports, "RedisSessionStore", { enumerable: true, get: function () { return session_redis_1.RedisSessionStore; } });
+var session_sqlite_1 = require("./session-sqlite");
+Object.defineProperty(exports, "SqliteSessionStore", { enumerable: true, get: function () { return session_sqlite_1.SqliteSessionStore; } });
+var scenes_1 = require("./scenes");
+Object.defineProperty(exports, "WizardScene", { enumerable: true, get: function () { return scenes_1.WizardScene; } });
+Object.defineProperty(exports, "Stage", { enumerable: true, get: function () { return scenes_1.Stage; } });
+var rateLimit_1 = require("./rateLimit");
+Object.defineProperty(exports, "rateLimit", { enumerable: true, get: function () { return rateLimit_1.rateLimit; } });
+var i18n_1 = require("./i18n");
+Object.defineProperty(exports, "createI18n", { enumerable: true, get: function () { return i18n_1.createI18n; } });
+var adapters_1 = require("./adapters");
+Object.defineProperty(exports, "vercelWebhookHandler", { enumerable: true, get: function () { return adapters_1.vercelWebhookHandler; } });
+Object.defineProperty(exports, "lambdaWebhookHandler", { enumerable: true, get: function () { return adapters_1.lambdaWebhookHandler; } });
+Object.defineProperty(exports, "cloudflareWebhookHandler", { enumerable: true, get: function () { return adapters_1.cloudflareWebhookHandler; } });
+var filters_1 = require("./filters");
+Object.defineProperty(exports, "mention", { enumerable: true, get: function () { return filters_1.mention; } });
+Object.defineProperty(exports, "hashtag", { enumerable: true, get: function () { return filters_1.hashtag; } });
+Object.defineProperty(exports, "cashtag", { enumerable: true, get: function () { return filters_1.cashtag; } });
+Object.defineProperty(exports, "url", { enumerable: true, get: function () { return filters_1.url; } });
+Object.defineProperty(exports, "textLink", { enumerable: true, get: function () { return filters_1.textLink; } });
+Object.defineProperty(exports, "textMention", { enumerable: true, get: function () { return filters_1.textMention; } });
+Object.defineProperty(exports, "phone", { enumerable: true, get: function () { return filters_1.phone; } });
+Object.defineProperty(exports, "email", { enumerable: true, get: function () { return filters_1.email; } });
+Object.defineProperty(exports, "botCommand", { enumerable: true, get: function () { return filters_1.botCommand; } });
+Object.defineProperty(exports, "spoiler", { enumerable: true, get: function () { return filters_1.spoiler; } });
+Object.defineProperty(exports, "customEmoji", { enumerable: true, get: function () { return filters_1.customEmoji; } });
+Object.defineProperty(exports, "reaction", { enumerable: true, get: function () { return filters_1.reaction; } });
+exports.Types = __importStar(require("./types"));
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6BAAwC;AAA/B,0FAAA,GAAG,OAAA;AACZ,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,uCAAqE;AAA5D,oGAAA,QAAQ,OAAA;AAAE,kGAAA,MAAM,OAAA;AACzB,mCAA2E;AAAlE,6FAAA,GAAG,OAAA;AAAE,mGAAA,SAAS,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AACzC,uCAAmF;AAA1E,oGAAA,QAAQ,OAAA;AAAE,iHAAA,qBAAqB,OAAA;AAAE,gHAAA,oBAAoB,OAAA;AAC9D,6CAAqG;AAA5F,0GAAA,WAAW,OAAA;AAAE,kHAAA,mBAAmB,OAAA;AAAE,8GAAA,eAAe,OAAA;AAAE,gHAAA,iBAAiB,OAAA;AAC7E,2CAAyE;AAAhE,2GAAA,aAAa,OAAA;AAAE,qGAAA,OAAO,OAAA;AAAE,mGAAA,KAAK,OAAA;AAAE,oGAAA,MAAM,OAAA;AAAE,gGAAA,EAAE,OAAA;AAClD,qCAAsF;AAA7E,kGAAA,OAAO,OAAA;AAAgB,6GAAA,kBAAkB,OAAA;AAClD,iDAA+F;AAAtF,kHAAA,iBAAiB,OAAA;AAC1B,mDAAqG;AAA5F,oHAAA,kBAAkB,OAAA;AAC3B,mCAA+F;AAAtF,qGAAA,WAAW,OAAA;AAAE,+FAAA,KAAK,OAAA;AAC3B,yCAA0D;AAAjD,sGAAA,SAAS,OAAA;AAClB,+BAAsE;AAA7D,kGAAA,UAAU,OAAA;AACnB,uCAAkG;AAAzF,gHAAA,oBAAoB,OAAA;AAAE,gHAAA,oBAAoB,OAAA;AAAE,oHAAA,wBAAwB,OAAA;AAC7E,qCAA4I;AAAnI,kGAAA,OAAO,OAAA;AAAE,kGAAA,OAAO,OAAA;AAAE,kGAAA,OAAO,OAAA;AAAE,8FAAA,GAAG,OAAA;AAAE,mGAAA,QAAQ,OAAA;AAAE,sGAAA,WAAW,OAAA;AAAE,gGAAA,KAAK,OAAA;AAAE,gGAAA,KAAK,OAAA;AAAE,qGAAA,UAAU,OAAA;AAAE,kGAAA,OAAO,OAAA;AAAE,sGAAA,WAAW,OAAA;AAAE,mGAAA,QAAQ,OAAA;AACxH,iDAAiC"}

package/dist/keyboard.d.ts

@@ -0,0 +1,62 @@
+import * as T from "./types";
+/**
+ * Fluent builders for keyboards. Chosen to read almost like English:
+ *
+ *   Keyboard.inline()
+ *     .button('Yes', 'confirm:yes')
+ *     .button('No', 'confirm:no')
+ *     .row()
+ *     .url('Docs', 'https://example.com')
+ *     .build()
+ */
+export declare class InlineKeyboardBuilder {
+    private rows;
+    button(text: string, callback_data: string, extra?: {
+        style?: "primary" | "success" | "danger";
+        icon_custom_emoji_id?: string;
+    }): this;
+    url(text: string, url: string, extra?: {
+        style?: "primary" | "success" | "danger";
+        icon_custom_emoji_id?: string;
+    }): this;
+    /** Alias for url() — a plausible guessed name given how other libraries phrase this, so it's accepted rather than throwing "not a function". */
+    urlButton(text: string, url: string, extra?: {
+        style?: "primary" | "success" | "danger";
+        icon_custom_emoji_id?: string;
+    }): this;
+    webApp(text: string, url: string): this;
+    switchInline(text: string, query?: string): this;
+    pay(text: string): this;
+    /** Copies text to the user's clipboard when tapped (Bot API 7.11+). */
+    copyText(text: string, textToCopy: string, extra?: {
+        style?: "primary" | "success" | "danger";
+        icon_custom_emoji_id?: string;
+    }): this;
+    /** Start a new row of buttons. */
+    row(): this;
+    private current;
+    build(): T.InlineKeyboardMarkup;
+}
+export declare class ReplyKeyboardBuilder {
+    private rows;
+    text(label: string, extra?: {
+        style?: "primary" | "success" | "danger";
+        icon_custom_emoji_id?: string;
+    }): this;
+    requestContact(label: string): this;
+    requestLocation(label: string): this;
+    row(): this;
+    private current;
+    build(opts?: {
+        resize?: boolean;
+        oneTime?: boolean;
+        placeholder?: string;
+    }): T.ReplyKeyboardMarkup;
+}
+/** Entry points, so usage reads as `Keyboard.inline()...` / `Keyboard.reply()...` / `Keyboard.remove()`. */
+export declare const Keyboard: {
+    inline: () => InlineKeyboardBuilder;
+    reply: () => ReplyKeyboardBuilder;
+    remove: (selective?: boolean) => T.ReplyKeyboardRemove;
+    forceReply: (placeholder?: string) => T.ForceReply;
+};

package/dist/keyboard.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Keyboard = exports.ReplyKeyboardBuilder = exports.InlineKeyboardBuilder = void 0;
+/**
+ * Fluent builders for keyboards. Chosen to read almost like English:
+ *
+ *   Keyboard.inline()
+ *     .button('Yes', 'confirm:yes')
+ *     .button('No', 'confirm:no')
+ *     .row()
+ *     .url('Docs', 'https://example.com')
+ *     .build()
+ */
+class InlineKeyboardBuilder {
+    rows = [[]];
+    button(text, callback_data, extra = {}) {
+        this.current().push({ text, callback_data, ...extra });
+        return this;
+    }
+    url(text, url, extra = {}) {
+        this.current().push({ text, url, ...extra });
+        return this;
+    }
+    /** Alias for url() — a plausible guessed name given how other libraries phrase this, so it's accepted rather than throwing "not a function". */
+    urlButton(text, url, extra = {}) {
+        return this.url(text, url, extra);
+    }
+    webApp(text, url) {
+        this.current().push({ text, web_app: { url } });
+        return this;
+    }
+    switchInline(text, query = "") {
+        this.current().push({ text, switch_inline_query: query });
+        return this;
+    }
+    pay(text) {
+        this.current().push({ text, pay: true });
+        return this;
+    }
+    /** Copies text to the user's clipboard when tapped (Bot API 7.11+). */
+    copyText(text, textToCopy, extra = {}) {
+        this.current().push({ text, copy_text: { text: textToCopy }, ...extra });
+        return this;
+    }
+    /** Start a new row of buttons. */
+    row() {
+        this.rows.push([]);
+        return this;
+    }
+    current() {
+        return this.rows[this.rows.length - 1];
+    }
+    build() {
+        return { inline_keyboard: this.rows.filter((r) => r.length) };
+    }
+}
+exports.InlineKeyboardBuilder = InlineKeyboardBuilder;
+class ReplyKeyboardBuilder {
+    rows = [[]];
+    text(label, extra = {}) {
+        this.current().push({ text: label, ...extra });
+        return this;
+    }
+    requestContact(label) {
+        this.current().push({ text: label, request_contact: true });
+        return this;
+    }
+    requestLocation(label) {
+        this.current().push({ text: label, request_location: true });
+        return this;
+    }
+    row() {
+        this.rows.push([]);
+        return this;
+    }
+    current() {
+        return this.rows[this.rows.length - 1];
+    }
+    build(opts = {}) {
+        return {
+            keyboard: this.rows.filter((r) => r.length),
+            resize_keyboard: opts.resize ?? true,
+            one_time_keyboard: opts.oneTime,
+            input_field_placeholder: opts.placeholder,
+        };
+    }
+}
+exports.ReplyKeyboardBuilder = ReplyKeyboardBuilder;
+/** Entry points, so usage reads as `Keyboard.inline()...` / `Keyboard.reply()...` / `Keyboard.remove()`. */
+exports.Keyboard = {
+    inline: () => new InlineKeyboardBuilder(),
+    reply: () => new ReplyKeyboardBuilder(),
+    remove: (selective = false) => ({ remove_keyboard: true, selective }),
+    forceReply: (placeholder) => ({ force_reply: true, input_field_placeholder: placeholder }),
+};
+//# sourceMappingURL=keyboard.js.map

package/dist/keyboard.js.map

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

package/dist/rateLimit.d.ts

@@ -0,0 +1,19 @@
+import { Context } from "./context";
+import { Middleware } from "./composer";
+export interface RateLimitOptions {
+    /** Time window in ms. Default 3000 (3s). */
+    windowMs?: number;
+    /** Max updates allowed per window per key. Default 1. */
+    limit?: number;
+    /** Defaults to limiting per chat. Use `ctx => String(ctx.from?.id)` to limit per user instead. */
+    keyFn?: (ctx: Context) => string | undefined;
+    /** Called instead of silently dropping the update when the limit is hit. Defaults to doing nothing. */
+    onLimitExceeded?: (ctx: Context) => unknown | Promise<unknown>;
+}
+/**
+ * Simple sliding-window rate limiter. Mount it early with `bot.use(rateLimit())`
+ * so spammy updates never even reach your command/hears/action handlers.
+ *
+ *   bot.use(rateLimit({ windowMs: 2000, limit: 1, onLimitExceeded: (ctx) => ctx.reply('Slow down!') }));
+ */
+export declare function rateLimit(opts?: RateLimitOptions): Middleware<Context>;

package/dist/rateLimit.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rateLimit = rateLimit;
+/**
+ * Simple sliding-window rate limiter. Mount it early with `bot.use(rateLimit())`
+ * so spammy updates never even reach your command/hears/action handlers.
+ *
+ *   bot.use(rateLimit({ windowMs: 2000, limit: 1, onLimitExceeded: (ctx) => ctx.reply('Slow down!') }));
+ */
+function rateLimit(opts = {}) {
+    const windowMs = opts.windowMs ?? 3000;
+    const limit = opts.limit ?? 1;
+    const keyFn = opts.keyFn ?? ((ctx) => (ctx.chat ? String(ctx.chat.id) : undefined));
+    const hits = new Map();
+    return async (ctx, next) => {
+        const key = keyFn(ctx);
+        if (key === undefined)
+            return next();
+        const now = Date.now();
+        const timestamps = (hits.get(key) ?? []).filter((t) => now - t < windowMs);
+        if (timestamps.length >= limit) {
+            hits.set(key, timestamps);
+            if (opts.onLimitExceeded)
+                await opts.onLimitExceeded(ctx);
+            return; // drop — don't call next()
+        }
+        timestamps.push(now);
+        hits.set(key, timestamps);
+        return next();
+    };
+}
+//# sourceMappingURL=rateLimit.js.map

package/dist/rateLimit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimit.js","sourceRoot":"","sources":["../src/rateLimit.ts"],"names":[],"mappings":";;AAoBA,8BAuBC;AA7BD;;;;;GAKG;AACH,SAAgB,SAAS,CAAC,OAAyB,EAAE;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,GAAY,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC7F,MAAM,IAAI,GAAG,IAAI,GAAG,EAAoB,CAAC;IAEzC,OAAO,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACzB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,IAAI,EAAE,CAAC;QAErC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;QAE3E,IAAI,UAAU,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;YAC/B,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;YAC1B,IAAI,IAAI,CAAC,eAAe;gBAAE,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YAC1D,OAAO,CAAC,2BAA2B;QACrC,CAAC;QAED,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAC1B,OAAO,IAAI,EAAE,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/dist/richMessage.d.ts

@@ -0,0 +1,111 @@
+import * as T from "./types";
+/**
+ * Two ways to build a Rich Message (Bot API 10.1, block API added 10.2):
+ *
+ * 1. `RichMessage.markdown()` / `.html()` — write "Rich Markdown"/"Rich HTML"
+ *    text (GFM-flavored markdown: **bold**, ==marked==, ||spoiler||, `- [ ]`
+ *    task items, GFM tables, etc. — see the official docs for the full
+ *    syntax). Simplest for AI-generated or hand-written content. Inline
+ *    photos here (`.photo()`) use Rich Markdown's own `![](url)` image
+ *    syntax directly in the text — confirmed working against a real server.
+ * 2. `RichMessage.blocks()` — build the structured block tree directly
+ *    (Bot API 10.2+), for when you want guaranteed structure (e.g. a table
+ *    with real colspan/rowspan) rather than round-tripping through text.
+ *    Media blocks (photo/video/audio/animation/voice_note) reference a
+ *    separately-declared media item by id — confirmed via two live 400
+ *    errors that Telegram rejects both a missing `id` on the media item and
+ *    an inline file where it expects an `{ id }` reference. Use `.photo()`/
+ *    `.video()`/etc. here (not the markdown builder's `.photo()`) and the id
+ *    bookkeeping is handled for you.
+ *
+ * Both produce an `InputRichMessage` for `ctx.replyRich()` / `api.sendRichMessage()`.
+ */
+export declare class RichMarkdownBuilder {
+    private parts;
+    text(str: string): this;
+    heading(str: string, level?: 1 | 2 | 3 | 4 | 5 | 6): this;
+    blockquote(str: string): this;
+    checklist(items: (string | {
+        label: string;
+        done?: boolean;
+    })[]): this;
+    list(items: string[], ordered?: boolean): this;
+    table(headers: string[], rows: string[][]): this;
+    codeBlock(code: string, language?: string): this;
+    divider(): this;
+    /**
+     * Embeds a photo inline via Rich Markdown's own `![](url "caption")`
+     * image syntax. This does NOT use InputRichMessage.media — that field is
+     * only for RichMessage.blocks()'s structured media blocks, and is a
+     * separate mechanism. This method's output is the confirmed-working path.
+     */
+    photo(url: string, caption?: string): this;
+    build(): T.InputRichMessage;
+}
+export declare class RichHtmlBuilder {
+    private parts;
+    raw(html: string): this;
+    paragraph(html: string): this;
+    heading(html: string, level?: 1 | 2 | 3 | 4 | 5 | 6): this;
+    build(): T.InputRichMessage;
+}
+/** Structural block-based builder (Bot API 10.2+) — produces InputRichBlock[] directly. */
+export declare class RichBlocksBuilder {
+    private blocks;
+    private mediaItems;
+    private mediaCounter;
+    /**
+     * Declares a media item, returning its id. Prefer the .photo()/.video()/
+     * .audio()/.animation()/.voiceNote() convenience methods below, which call
+     * this for you and add the referencing block in one step — use this
+     * directly only if you're building a raw block yourself via .raw().
+     */
+    media(type: T.InputRichMessageMedia["type"], file: T.InputFile): string;
+    paragraph(text: T.RichText): this;
+    heading(text: T.RichText, size?: 1 | 2 | 3 | 4 | 5 | 6): this;
+    divider(): this;
+    table(cells: T.RichBlockTableCell[][], opts?: {
+        bordered?: boolean;
+        striped?: boolean;
+        caption?: T.RichText;
+    }): this;
+    list(items: T.RichBlockListItem[]): this;
+    details(summary: T.RichText, blocks: T.InputRichBlock[], open?: boolean): this;
+    /** Adds a photo block, declaring its media item for you. */
+    photo(file: T.InputFile, opts?: {
+        hasSpoiler?: boolean;
+        caption?: T.RichBlockCaption;
+    }): this;
+    video(file: T.InputFile, opts?: {
+        hasSpoiler?: boolean;
+        caption?: T.RichBlockCaption;
+    }): this;
+    audio(file: T.InputFile, opts?: {
+        caption?: T.RichBlockCaption;
+    }): this;
+    animation(file: T.InputFile, opts?: {
+        hasSpoiler?: boolean;
+        caption?: T.RichBlockCaption;
+    }): this;
+    voiceNote(file: T.InputFile, opts?: {
+        caption?: T.RichBlockCaption;
+    }): this;
+    /** Bot API 10.3+: adds a document (file) block. */
+    document(file: T.InputFile, opts?: {
+        caption?: T.RichBlockCaption;
+    }): this;
+    /** Bot API 10.3+: adds a row of buttons to the rich message. */
+    buttons(buttons: T.RichMessageButton[]): this;
+    /** Bot API 10.3+: adds an expandable/collapsible block quotation. */
+    expandableBlockquote(blocks: T.InputRichBlock[], opts?: {
+        credit?: T.RichText;
+    }): this;
+    /** Escape hatch for block types without a dedicated method. If it references media by id, declare that media via .media() first, or build() will throw before you ever hit Telegram's 400. */
+    raw(block: T.InputRichBlock): this;
+    build(): T.InputRichMessage;
+}
+export declare const RichMessage: {
+    markdown: () => RichMarkdownBuilder;
+    html: () => RichHtmlBuilder;
+    blocks: () => RichBlocksBuilder;
+};