@xbibzlibrary/telebibz 0.1.18 → 0.2.1

package/dist/src/webhook/handler.js

@@ -28,6 +28,91 @@ export function createWebhookHandler(bot, options = {}) {
         }
     };
 }
+export function webhookCallback(bot, _framework = "express", options = {}) {
+    const maxBodyBytes = options.maxBodyBytes ?? 1_048_576;
+    return async (req, res) => {
+        const rawReq = req;
+        const rawRes = res;
+        const sendResponse = (status, message) => {
+            if (rawRes && typeof rawRes.writeHead === "function" && typeof rawRes.end === "function") {
+                rawRes.writeHead(status, { "Content-Type": "text/plain" });
+                rawRes.end(message);
+                return;
+            }
+            const expressLike = rawRes;
+            if (typeof expressLike?.status === "function" && typeof expressLike.send === "function") {
+                expressLike.status(status).send(message);
+                return;
+            }
+            const koaLike = rawRes;
+            if (koaLike !== undefined) {
+                koaLike.status = status;
+                koaLike.body = message;
+            }
+        };
+        if (rawReq.method !== "POST") {
+            sendResponse(405, "Method Not Allowed");
+            return;
+        }
+        if (options.secretToken) {
+            if (!secureEqual(readHeader(rawReq, "x-telegram-bot-api-secret-token"), options.secretToken)) {
+                sendResponse(401, "Unauthorized");
+                return;
+            }
+        }
+        try {
+            let update;
+            if (typeof rawReq.arrayBuffer === "function") {
+                // Web-standard Request objects (e.g. Deno, Bun, WinterCG runtimes, or
+                // a converted fetch Request) expose the body through arrayBuffer().
+                // Checked before `body` because a Request's `body` is a ReadableStream.
+                const raw = await rawReq.arrayBuffer();
+                if (raw.byteLength > maxBodyBytes) {
+                    sendResponse(413, "Payload Too Large");
+                    return;
+                }
+                update = JSON.parse(new TextDecoder().decode(raw));
+            }
+            else if (rawReq.body && typeof rawReq.body === "object") {
+                update = rawReq.body;
+            }
+            else {
+                const chunks = [];
+                let totalBytes = 0;
+                for await (const chunk of rawReq) {
+                    const buffer = typeof chunk === "string" ? Buffer.from(chunk) : chunk;
+                    totalBytes += buffer.length;
+                    if (totalBytes > maxBodyBytes) {
+                        sendResponse(413, "Payload Too Large");
+                        return;
+                    }
+                    chunks.push(buffer);
+                }
+                const raw = Buffer.concat(chunks).toString("utf8");
+                update = JSON.parse(raw);
+            }
+            if (!Number.isInteger(update?.update_id)) {
+                sendResponse(400, "Bad Request");
+                return;
+            }
+            await bot.handleUpdate(update);
+            sendResponse(200, "OK");
+        }
+        catch (error) {
+            await options.onError?.(error);
+            sendResponse(500, "Internal Server Error");
+        }
+    };
+}
+function readHeader(req, name) {
+    const headers = req.headers;
+    if (!headers || typeof headers !== "object")
+        return "";
+    if (typeof headers.get === "function")
+        return headers.get(name) ?? "";
+    const value = headers[name];
+    return Array.isArray(value) ? value[0] ?? "" : value ?? "";
+}
 function secureEqual(left, right) {
     const leftBuffer = Buffer.from(left, "utf8");
     const rightBuffer = Buffer.from(right, "utf8");

package/dist/src/webhook/handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../src/webhook/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAM9C,MAAM,UAAU,oBAAoB,CAAmB,GAAW,EAAE,UAA0B,EAAE;IAC9F,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,SAAS,CAAC;IACvD,OAAO,KAAK,EAAE,OAAgB,EAAqB,EAAE;QACnD,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM;YAAE,OAAO,IAAI,QAAQ,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QACtH,IAAI,OAAO,CAAC,WAAW,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,WAAW,CAAC;YAAE,OAAO,IAAI,QAAQ,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACjL,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAC9D,IAAI,CAAC,kCAAkC,CAAC,IAAI,CAAC,WAAW,CAAC;YAAE,OAAO,IAAI,QAAQ,CAAC,wBAAwB,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC1H,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;QACzE,IAAI,aAAa,GAAG,YAAY;YAAE,OAAO,IAAI,QAAQ,CAAC,mBAAmB,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5F,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;YACxC,IAAI,GAAG,CAAC,UAAU,GAAG,YAAY;gBAAE,OAAO,IAAI,QAAQ,CAAC,mBAAmB,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YAC7F,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAW,CAAC;YACnE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC;gBAAE,OAAO,IAAI,QAAQ,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YAC7F,MAAM,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAC/B,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;YAC/B,OAAO,IAAI,QAAQ,CAAC,uBAAuB,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,KAAa;IAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC/C,OAAO,UAAU,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAC9F,CAAC"}
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../src/webhook/handler.ts"],"names":[],"mappings":"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"}

package/dist-cjs/src/api/client.js

@@ -24,7 +24,7 @@ class ApiClient {
         });
     }
     async call(method, ...args) { return this.request(method, args[0]); }
-    async request(method, payload, signal) {
+    async request(method, payload, signal, options) {
         const context = { method, payload, startedAt: Date.now() };
         await this.hooks.onRequest?.(context);
         try {
@@ -33,6 +33,8 @@ class ApiClient {
                 request.payload = payload;
             if (signal !== undefined)
                 request.signal = signal;
+            if (options?.timeoutMs !== undefined)
+                request.timeoutMs = options.timeoutMs;
             const response = await this.transport.request(request);
             context.durationMs = Date.now() - context.startedAt;
             context.response = response.data;

package/dist-cjs/src/api/transport.js

@@ -25,7 +25,8 @@ class FetchTransport {
         this.jitter = options.jitter ?? 0.2;
         this.headers = options.headers ?? {};
     }
-    async request({ method, payload = {}, signal }) {
+    async request({ method, payload = {}, signal, timeoutMs }) {
+        const effectiveTimeoutMs = timeoutMs ?? this.timeoutMs;
         const hasUpload = await containsUpload(payload);
         let body;
         const headers = new Headers(this.headers);
@@ -43,7 +44,7 @@ class FetchTransport {
         while (true) {
             let responseStatus;
             const controller = new AbortController();
-            const timeout = setTimeout(() => controller.abort(new Error(`Request timed out after ${this.timeoutMs}ms`)), this.timeoutMs);
+            const timeout = setTimeout(() => controller.abort(new Error(`Request timed out after ${effectiveTimeoutMs}ms`)), effectiveTimeoutMs);
             const onAbort = () => controller.abort(signal?.reason);
             signal?.addEventListener("abort", onAbort, { once: true });
             try {

package/dist-cjs/src/branding/terminal.js

@@ -1,13 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TERMINAL_BRAND_TEXT = void 0;
+exports.TELE_BIBZ_ASCII = exports.TERMINAL_BRAND_TEXT = void 0;
+exports.paintRainbow = paintRainbow;
+exports.runStartupSequence = runStartupSequence;
+exports.printTeleBibzBanner = printTeleBibzBanner;
+exports.startTeleBibzBanner = startTeleBibzBanner;
+exports.printStatusLine = printStatusLine;
 exports.buildTerminalBranding = buildTerminalBranding;
 exports.printTerminalBranding = printTerminalBranding;
 exports.startTerminalAnimation = startTerminalAnimation;
 exports.TERMINAL_BRAND_TEXT = "Library Bot Telegram By @xbibzofficial";
+/** "Tele Bibz" rendered with the figlet Speed font. */
+exports.TELE_BIBZ_ASCII = [
+    "________    ______          ___________________       _______",
+    "___  __/_______  /____      ___  __ )__(_)__  /_______",
+    "__  /  _  _ \\_  /_  _ \\     __  __  |_  /__  __ \\__  /",
+    "_  /   /  __/  / /  __/     _  /_/ /_  / _  /_/ /_  /_",
+    "/_/    \\___//_/  \\___/      /_____/ /_/  /_.___/_____/",
+];
 const ANSI = {
     reset: "\u001b[0m",
+    bold: "\u001b[1m",
     clearLine: "\u001b[2K",
+    cursorUp: "\u001b[1A",
     hideCursor: "\u001b[?25l",
     showCursor: "\u001b[?25h",
     blue: "\u001b[34m",
@@ -15,6 +30,8 @@ const ANSI = {
     cyan: "\u001b[36m",
     green: "\u001b[32m",
     yellow: "\u001b[33m",
+    red: "\u001b[31m",
+    white: "\u001b[97m",
     dim: "\u001b[2m",
 };
 function pad(value, width) {
@@ -23,6 +40,252 @@ function pad(value, width) {
 function useColor(options, stream) {
     return options.color ?? Boolean(stream.isTTY && !process.env.NO_COLOR);
 }
+function sleep(delayMs) {
+    return new Promise((resolve) => setTimeout(resolve, delayMs));
+}
+function easeInOutCubic(progress) {
+    return progress < 0.5 ? 4 * progress ** 3 : 1 - (-2 * progress + 2) ** 3 / 2;
+}
+function hslToRgb(hue, saturation, lightness) {
+    const normalizedHue = ((hue % 360) + 360) % 360;
+    const chroma = (1 - Math.abs(2 * lightness - 1)) * saturation;
+    const hueSegment = normalizedHue / 60;
+    const secondary = chroma * (1 - Math.abs((hueSegment % 2) - 1));
+    let red = 0;
+    let green = 0;
+    let blue = 0;
+    if (hueSegment < 1) {
+        red = chroma;
+        green = secondary;
+    }
+    else if (hueSegment < 2) {
+        red = secondary;
+        green = chroma;
+    }
+    else if (hueSegment < 3) {
+        green = chroma;
+        blue = secondary;
+    }
+    else if (hueSegment < 4) {
+        green = secondary;
+        blue = chroma;
+    }
+    else if (hueSegment < 5) {
+        red = secondary;
+        blue = chroma;
+    }
+    else {
+        red = chroma;
+        blue = secondary;
+    }
+    const shift = lightness - chroma / 2;
+    return [Math.round((red + shift) * 255), Math.round((green + shift) * 255), Math.round((blue + shift) * 255)];
+}
+function rgbForegroundColor(red, green, blue) {
+    return `\u001b[38;2;${red};${green};${blue}m`;
+}
+/**
+ * Paints multi-line text with a rainbow gradient across columns (the classic
+ * "Rainbow" color filter). Spaces stay unstyled so the art keeps its shape.
+ */
+function paintRainbow(text, options = {}) {
+    if (!options.color)
+        return text;
+    const lines = text.split("\n");
+    const width = Math.max(...lines.map((line) => [...line].length), 1);
+    const offset = options.offset ?? 0;
+    const spread = options.spread ?? 340;
+    const saturation = options.saturation ?? 1;
+    const lightness = options.lightness ?? 0.58;
+    return lines
+        .map((line) => {
+        const characters = [...line];
+        let painted = "";
+        for (let index = 0; index < characters.length; index += 1) {
+            const character = characters[index];
+            if (character === " ") {
+                painted += character;
+                continue;
+            }
+            const hue = offset + (index / width) * spread;
+            const [red, green, blue] = hslToRgb(hue, saturation, lightness);
+            painted += `${rgbForegroundColor(red, green, blue)}${character}${ANSI.reset}`;
+        }
+        return painted;
+    })
+        .join("\n");
+}
+function renderGlassBar(progress, shinePosition, width, colored) {
+    const filled = Math.round(progress * width);
+    let bar = "";
+    for (let index = 0; index < width; index += 1) {
+        const isFilled = index < filled;
+        const shineDistance = Math.abs(index - shinePosition);
+        const isShine = shineDistance <= 1;
+        const character = isFilled ? "█" : "░";
+        if (!colored) {
+            bar += character;
+            continue;
+        }
+        if (isShine) {
+            bar += `${ANSI.bold}${ANSI.white}${character === "█" ? "█" : "▒"}${ANSI.reset}`;
+            continue;
+        }
+        if (isFilled) {
+            const hue = 190 + (index / width) * 150;
+            const [red, green, blue] = hslToRgb(hue, 0.85, 0.6);
+            bar += `${rgbForegroundColor(red, green, blue)}${character}${ANSI.reset}`;
+        }
+        else {
+            bar += `${ANSI.dim}${character}${ANSI.reset}`;
+        }
+    }
+    return bar;
+}
+/**
+ * Plays the startup sequence on a TTY: a typing effect for the label
+ * (default "Installing Dependencies"), a trailing run of dots, and a
+ * glass progress bar with a sweeping highlight that fills to 100%.
+ * No-ops when the stream is not an interactive TTY.
+ */
+async function runStartupSequence(options = {}) {
+    const stream = options.stream ?? process.stdout;
+    if (!stream.isTTY)
+        return;
+    const colored = useColor(options, stream);
+    const label = options.label ?? "Installing Dependencies";
+    const typeDelayMs = options.typeDelayMs ?? 24;
+    const dotDelayMs = options.dotDelayMs ?? 140;
+    const dots = options.dots ?? 6;
+    const barWidth = Math.max(10, options.barWidth ?? 44);
+    const barDurationMs = Math.max(0, options.barDurationMs ?? 1_400);
+    const barFrameMs = Math.max(16, options.barFrameMs ?? 40);
+    if (colored)
+        stream.write(`${ANSI.bold}${ANSI.cyan}`);
+    for (const character of label) {
+        stream.write(character);
+        if (typeDelayMs > 0)
+            await sleep(typeDelayMs);
+    }
+    for (let index = 0; index < dots; index += 1) {
+        if (dotDelayMs > 0)
+            await sleep(dotDelayMs);
+        stream.write(".");
+    }
+    if (colored)
+        stream.write(ANSI.reset);
+    stream.write("\n");
+    const startedAt = Date.now();
+    let frameIndex = 0;
+    while (true) {
+        const elapsed = Date.now() - startedAt;
+        const progress = barDurationMs === 0 ? 1 : Math.min(1, easeInOutCubic(elapsed / barDurationMs));
+        const sweep = (frameIndex * barFrameMs) % 1_600;
+        const triangle = sweep < 800 ? sweep / 800 : 2 - sweep / 800;
+        const shinePosition = triangle * (barWidth - 1);
+        const percentage = Math.round(progress * 100);
+        stream.write(`\r${ANSI.clearLine}${renderGlassBar(progress, shinePosition, barWidth, colored)} ${ANSI.dim}${String(percentage).padStart(3, " ")}%${ANSI.reset}`);
+        if (progress >= 1)
+            break;
+        frameIndex += 1;
+        await sleep(barFrameMs);
+    }
+    stream.write(` ${ANSI.green}${ANSI.bold}✓${ANSI.reset}\n`);
+}
+function bannerFrame(subtitle, offset, colored) {
+    const artWidth = Math.max(...exports.TELE_BIBZ_ASCII.map((line) => [...line].length));
+    const leading = Math.max(0, Math.floor((artWidth - [...exports.TERMINAL_BRAND_TEXT].length) / 2));
+    const tagline = " ".repeat(leading) + exports.TERMINAL_BRAND_TEXT;
+    const lines = paintRainbow(exports.TELE_BIBZ_ASCII.join("\n"), { color: colored, offset }).split("\n");
+    lines.push(colored ? `${ANSI.dim}${tagline}${ANSI.reset}` : tagline);
+    if (subtitle)
+        lines.push(colored ? `${ANSI.cyan}${ANSI.bold}${subtitle}${ANSI.reset}` : subtitle);
+    return lines;
+}
+function tonePrefix(tone, colored) {
+    if (!colored)
+        return "";
+    if (tone === "success")
+        return ANSI.green;
+    if (tone === "error")
+        return ANSI.red;
+    return ANSI.cyan;
+}
+/**
+ * Prints the static "Tele Bibz" banner (rainbow-painted once, no animation).
+ * Suitable for short-lived CLI commands and non-interactive streams.
+ */
+function printTeleBibzBanner(options = {}) {
+    const stream = options.stream ?? process.stdout;
+    const colored = useColor(options, stream);
+    const lines = bannerFrame(options.subtitle, 0, colored);
+    if (options.message) {
+        const prefix = options.tone === "error" ? "✗ " : options.tone === "success" ? "✓ " : "";
+        lines.push(colored ? `${tonePrefix(options.tone ?? "info", colored)}${prefix}${options.message}${ANSI.reset}` : `${prefix}${options.message}`);
+    }
+    stream.write(`${lines.join("\n")}\n`);
+}
+/**
+ * Prints the animated rainbow "Tele Bibz" banner. The rainbow flows until
+ * `stop()` is called (typically once the bot is connected), then the banner
+ * freezes and an optional status line is printed.
+ */
+function startTeleBibzBanner(options = {}) {
+    const stream = options.stream ?? process.stdout;
+    const colored = useColor(options, stream);
+    const frameMs = Math.max(16, options.frameMs ?? 70);
+    const subtitle = options.subtitle;
+    if (!stream.isTTY) {
+        printTeleBibzBanner({ ...options, subtitle });
+        return { stop: () => undefined };
+    }
+    let stopped = false;
+    let linesPrinted = 0;
+    const writeFrame = (offset) => {
+        const lines = bannerFrame(subtitle, offset, colored);
+        linesPrinted = lines.length;
+        stream.write(lines.join("\n") + "\n");
+    };
+    const clearFrame = () => {
+        for (let index = 0; index < linesPrinted; index += 1)
+            stream.write(`${ANSI.cursorUp}${ANSI.clearLine}`);
+        stream.write("\r");
+    };
+    stream.write(ANSI.hideCursor);
+    writeFrame(0);
+    void (async () => {
+        let offset = 0;
+        while (!stopped) {
+            await sleep(frameMs);
+            if (stopped)
+                break;
+            offset = (offset + 14) % 360;
+            clearFrame();
+            writeFrame(offset);
+        }
+    })();
+    return {
+        stop(message, tone = "success") {
+            if (stopped)
+                return;
+            stopped = true;
+            clearFrame();
+            writeFrame(0);
+            if (message) {
+                const prefix = tone === "error" ? "✗ " : tone === "success" ? "✓ " : "";
+                const line = colored ? `${tonePrefix(tone, colored)}${ANSI.bold}${prefix}${message}${ANSI.reset}` : `${prefix}${message}`;
+                stream.write(`${line}\n`);
+            }
+            stream.write(ANSI.showCursor);
+        },
+    };
+}
+/** Prints a single dim status line (used for "Listening for updates..." style messages). */
+function printStatusLine(text, options = {}) {
+    const stream = options.stream ?? process.stdout;
+    const colored = useColor(options, stream);
+    stream.write(colored ? `${ANSI.dim}${text}${ANSI.reset}\n` : `${text}\n`);
+}
 function buildTerminalBranding(options = {}) {
     const stream = process.stdout;
     const colored = useColor(options, stream);

package/dist-cjs/src/cli.js

@@ -5,11 +5,13 @@ const promises_1 = require("node:fs/promises");
 const node_child_process_1 = require("node:child_process");
 const handler_js_1 = require("./webhook/handler.js");
 const bot_js_1 = require("./core/bot.js");
+const terminal_js_1 = require("./branding/terminal.js");
 async function commandDoctor() {
+    (0, terminal_js_1.printTeleBibzBanner)({ subtitle: "telebibz doctor" });
     const token = process.env.TELEGRAM_BOT_TOKEN;
     console.log(JSON.stringify({ node: process.version, tokenPresent: Boolean(token), cwd: process.cwd(), package: "@xbibzlibrary/telebibz" }, null, 2));
     if (token) {
-        const bot = new bot_js_1.Bot(token);
+        const bot = new bot_js_1.Bot({ token, branding: false });
         const health = await bot.health();
         console.log(JSON.stringify(health, null, 2));
         if (!health.apiReachable)
@@ -25,6 +27,7 @@ async function commandStart() {
 }
 async function commandInit(name) {
     const dir = name || "my-telebibz-bot";
+    (0, terminal_js_1.printTeleBibzBanner)({ subtitle: "telebibz init" });
     await (0, promises_1.mkdir)(dir, { recursive: true });
     await (0, promises_1.writeFile)(`${dir}/index.ts`, `import { Bot } from "@xbibzlibrary/telebibz";\n\nconst bot = new Bot(process.env.TELEGRAM_BOT_TOKEN!);\nbot.command("start", (ctx) => ctx.reply("Hello from telebibz"));\nawait bot.start();\n`);
     await (0, promises_1.writeFile)(`${dir}/.env.example`, "TELEGRAM_BOT_TOKEN=\n");
@@ -61,11 +64,12 @@ async function main(argv = process.argv.slice(2)) {
             const token = process.env.TELEGRAM_BOT_TOKEN;
             if (!token)
                 throw new Error("TELEGRAM_BOT_TOKEN is required");
-            const bot = new bot_js_1.Bot(token);
+            const bot = new bot_js_1.Bot({ token, branding: false });
+            (0, terminal_js_1.printTeleBibzBanner)({ subtitle: "telebibz webhook", message: "Webhook handler ready" });
             const webhookOptions = process.env.TELEGRAM_WEBHOOK_SECRET ? { secretToken: process.env.TELEGRAM_WEBHOOK_SECRET } : {};
             const handler = (0, handler_js_1.createWebhookHandler)(bot, webhookOptions);
             await (0, promises_1.access)(".");
-            console.log(`Webhook handler ready: ${typeof handler}`);
+            console.log(`Handler type: ${typeof handler}`);
             break;
         }
         case "inspect":

package/dist-cjs/src/context/context.js

@@ -8,11 +8,15 @@ class Context {
     state = Object.create(null);
     services;
     params = Object.create(null);
+    me;
+    match;
+    args;
     constructor(options) {
         this.update = options.update;
         this.api = options.api;
         this.session = options.session;
         this.services = options.services;
+        this.me = options.me;
     }
     get message() {
         return this.update.message
@@ -32,13 +36,21 @@ class Context {
             ?? this.pollAnswer?.voter_chat;
     }
     get from() {
-        return this.message?.from
-            ?? this.callbackQuery?.from
+        return this.callbackQuery?.from
             ?? this.inlineQuery?.from
+            ?? this.update.chosen_inline_result?.from
+            ?? this.update.message?.from
+            ?? this.update.edited_message?.from
+            ?? this.update.channel_post?.from
+            ?? this.update.edited_channel_post?.from
+            ?? this.update.business_message?.from
+            ?? this.update.edited_business_message?.from
+            ?? this.update.guest_message?.from
             ?? this.update.chat_member?.from
             ?? this.update.my_chat_member?.from
             ?? this.update.chat_join_request?.from
-            ?? this.pollAnswer?.user;
+            ?? this.pollAnswer?.user
+            ?? this.message?.from;
     }
     get sender() { return this.from; }
     get callbackQuery() { return this.update.callback_query; }
@@ -50,20 +62,102 @@ class Context {
     get chatJoinRequest() { return this.update.chat_join_request; }
     get reaction() { return this.update.message_reaction; }
     get boost() { return this.update.chat_boost ?? this.update.removed_chat_boost; }
-    async reply(text, extra = {}) {
+    replyExtras(extra) {
+        const { reply_parameters, reply_markup, ...rest } = extra;
+        const quoted = this.message?.message_id !== undefined ? { message_id: this.message.message_id } : undefined;
+        const replyParameters = quoted === undefined && reply_parameters === undefined ? undefined : { ...(quoted ?? {}), ...(reply_parameters ?? {}) };
+        return { replyParameters, replyMarkup: reply_markup ?? this.state.reply_markup, rest };
+    }
+    sendMethod(method, payload, extra = {}) {
         if (!this.chat)
-            throw new Error("Cannot reply without a chat in this update.");
-        return this.api.methods.sendMessage({ chat_id: this.chat.id, text, reply_parameters: { message_id: this.message?.message_id }, ...extra });
+            throw new Error(`Cannot send ${method} without a chat in this update.`);
+        const { replyParameters, replyMarkup, rest } = this.replyExtras(extra);
+        return this.api.call(method, {
+            chat_id: this.chat.id,
+            ...payload,
+            ...rest,
+            ...(replyParameters ? { reply_parameters: replyParameters } : {}),
+            ...(replyMarkup ? { reply_markup: replyMarkup } : {}),
+        });
+    }
+    async reply(text, extra = {}) {
+        return this.sendMethod("sendMessage", { text }, extra);
     }
     async send(text, extra = {}) {
         if (!this.chat)
             throw new Error("Cannot send without a chat in this update.");
-        return this.api.methods.sendMessage({ chat_id: this.chat.id, text, ...extra });
+        const { replyMarkup, rest } = this.replyExtras(extra);
+        return this.api.methods.sendMessage({
+            chat_id: this.chat.id,
+            text,
+            ...rest,
+            ...(replyMarkup ? { reply_markup: replyMarkup } : {}),
+        });
     }
     async edit(text, extra = {}) {
         if (!this.chat || !this.message)
             throw new Error("Cannot edit without a chat and message in this update.");
-        return this.api.methods.editMessageText({ chat_id: this.chat.id, message_id: this.message.message_id, text, ...extra });
+        const { replyMarkup, rest } = this.replyExtras(extra);
+        return this.api.methods.editMessageText({
+            chat_id: this.chat.id,
+            message_id: this.message.message_id,
+            text,
+            ...rest,
+            ...(replyMarkup ? { reply_markup: replyMarkup } : {}),
+        });
+    }
+    async replyWithHTML(text, extra = {}) {
+        return this.reply(text, { parse_mode: "HTML", ...extra });
+    }
+    async replyWithMarkdown(text, extra = {}) {
+        return this.reply(text, { parse_mode: "MarkdownV2", ...extra });
+    }
+    async replyWithPhoto(photo, extra = {}) {
+        return this.sendMethod("sendPhoto", { photo }, extra);
+    }
+    async replyWithDocument(document, extra = {}) {
+        return this.sendMethod("sendDocument", { document }, extra);
+    }
+    async replyWithAudio(audio, extra = {}) {
+        return this.sendMethod("sendAudio", { audio }, extra);
+    }
+    async replyWithVideo(video, extra = {}) {
+        return this.sendMethod("sendVideo", { video }, extra);
+    }
+    async replyWithVoice(voice, extra = {}) {
+        return this.sendMethod("sendVoice", { voice }, extra);
+    }
+    async replyWithAnimation(animation, extra = {}) {
+        return this.sendMethod("sendAnimation", { animation }, extra);
+    }
+    async replyWithVideoNote(videoNote, extra = {}) {
+        return this.sendMethod("sendVideoNote", { video_note: videoNote }, extra);
+    }
+    async replyWithSticker(sticker, extra = {}) {
+        return this.sendMethod("sendSticker", { sticker }, extra);
+    }
+    async replyWithMediaGroup(media, extra = {}) {
+        return this.sendMethod("sendMediaGroup", { media }, extra);
+    }
+    async replyWithLocation(latitude, longitude, extra = {}) {
+        return this.sendMethod("sendLocation", { latitude, longitude }, extra);
+    }
+    async replyWithVenue(latitude, longitude, title, address, extra = {}) {
+        return this.sendMethod("sendVenue", { latitude, longitude, title, address }, extra);
+    }
+    async replyWithContact(phoneNumber, firstName, extra = {}) {
+        return this.sendMethod("sendContact", { phone_number: phoneNumber, first_name: firstName }, extra);
+    }
+    async replyWithPoll(question, options, extra = {}) {
+        return this.sendMethod("sendPoll", { question, options }, extra);
+    }
+    async replyWithDice(emoji, extra = {}) {
+        return this.sendMethod("sendDice", emoji === undefined ? {} : { emoji }, extra);
+    }
+    async sendChatAction(action, extra = {}) {
+        if (!this.chat)
+            throw new Error("Cannot send chat action without a chat in this update.");
+        return this.api.call("sendChatAction", { chat_id: this.chat.id, action, ...extra });
     }
     async delete() {
         if (!this.chat || !this.message)