@xbibzlibrary/telebibz 0.4.4 → 3.0.1

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

@@ -1,338 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-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",
-    magenta: "\u001b[35m",
-    cyan: "\u001b[36m",
-    green: "\u001b[32m",
-    yellow: "\u001b[33m",
-    red: "\u001b[31m",
-    white: "\u001b[97m",
-    dim: "\u001b[2m",
-};
-function pad(value, width) {
-    return `${value}${" ".repeat(Math.max(0, width - [...value].length))}`;
-}
-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);
-    const color = (value, code) => colored ? `${code}${value}${ANSI.reset}` : value;
-    const title = "TELEBIBZ CLI";
-    const width = Math.max([...title].length, [...exports.TERMINAL_BRAND_TEXT].length);
-    const horizontal = "═".repeat(width + 2);
-    const line = (value) => `║ ${pad(value, width)} ║`;
-    return [
-        color(`╔${horizontal}╗`, ANSI.cyan),
-        color(line(title), ANSI.blue),
-        color(line(exports.TERMINAL_BRAND_TEXT), ANSI.magenta),
-        color(`╚${horizontal}╝`, ANSI.cyan),
-        color("Runtime logs: colorful structured output.", ANSI.dim),
-    ].join("\n");
-}
-function printTerminalBranding(options = {}) {
-    process.stdout.write(`${buildTerminalBranding(options)}\n`);
-}
-function startTerminalAnimation(message = "Starting telebibz", options = {}) {
-    const stream = options.stream ?? process.stdout;
-    const colored = useColor(options, stream);
-    const frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
-    const intervalMs = Math.max(60, options.intervalMs ?? 90);
-    let index = 0;
-    let stopped = false;
-    const paint = () => {
-        if (stopped || !stream.isTTY)
-            return;
-        const frame = frames[index++ % frames.length] ?? "⠋";
-        const text = `${frame} ${message}`;
-        stream.write(`\r${ANSI.clearLine}${colored ? ANSI.cyan : ""}${text}${colored ? ANSI.reset : ""}`);
-    };
-    if (!stream.isTTY)
-        return { stop: () => undefined };
-    stream.write(ANSI.hideCursor);
-    paint();
-    const timer = setInterval(paint, intervalMs);
-    timer.unref?.();
-    return {
-        stop(finalMessage = "Done") {
-            if (stopped)
-                return;
-            stopped = true;
-            clearInterval(timer);
-            const prefix = finalMessage.toLowerCase().includes("error") ? ANSI.yellow : ANSI.green;
-            stream.write(`\r${ANSI.clearLine}${colored ? prefix : ""}${finalMessage}${colored ? ANSI.reset : ""}\n${ANSI.showCursor}`);
-        },
-    };
-}

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

@@ -1,58 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runBroadcast = runBroadcast;
-const errors_js_1 = require("../api/errors.js");
-const concurrency_js_1 = require("../utils/concurrency.js");
-function sleep(delayMs) { return new Promise((resolve) => setTimeout(resolve, delayMs)); }
-function describeError(error) {
-    if (error instanceof errors_js_1.TelegramError)
-        return { message: error.message, kind: error.kind };
-    return { message: error instanceof Error ? error.message : String(error), kind: undefined };
-}
-/**
- * Sends to many chats in parallel with automatic 429 retry.
- *
- * There is no proactive cooldown: all chats (up to `concurrency`) are attempted
- * at once. The only waiting ever done is the `retry_after` delay Telegram itself
- * returns with a 429 answer, so bursts of 1000+ chats still deliver completely
- * instead of failing.
- */
-async function runBroadcast(chatIds, send, options = {}) {
-    const startedAt = Date.now();
-    const maxAttempts = options.maxAttempts ?? 10;
-    const failures = [];
-    let delivered = 0;
-    let processed = 0;
-    const total = chatIds.length;
-    await (0, concurrency_js_1.mapWithConcurrency)(chatIds, options.concurrency ?? Infinity, async (chatId) => {
-        let attempts = 0;
-        while (true) {
-            if (options.signal?.aborted) {
-                failures.push({ chatId, attempts, error: "aborted", errorKind: "aborted" });
-                break;
-            }
-            attempts += 1;
-            try {
-                await send(chatId);
-                delivered += 1;
-                break;
-            }
-            catch (error) {
-                const telegram = error instanceof errors_js_1.TelegramError ? error : undefined;
-                if (telegram?.kind === "rate-limit" && attempts < maxAttempts) {
-                    // Telegram told us exactly how long to wait; honor it (plus a small
-                    // jitter so retried chats do not fire as one synchronized wave).
-                    const retryAfterMs = Math.max(0, (telegram.retryAfter ?? 1) * 1000);
-                    await sleep(retryAfterMs + Math.random() * 250);
-                    continue;
-                }
-                const { message, kind } = describeError(error);
-                failures.push({ chatId, attempts, error: message, errorKind: kind });
-                break;
-            }
-        }
-        processed += 1;
-        options.onProgress?.({ total, processed, delivered, failed: failures.length });
-    });
-    return { total, delivered, failed: failures.length, durationMs: Date.now() - startedAt, failures };
-}

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

@@ -1,45 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TokenBucketLimiter = exports.MemoryCache = void 0;
-const storage_js_1 = require("../storage/storage.js");
-class MemoryCache {
-    storage;
-    namespace;
-    constructor(namespace = "telebibz", storage = new storage_js_1.MemoryStorage()) {
-        this.storage = storage;
-        this.namespace = namespace;
-    }
-    key(key) { return `${this.namespace}:${key}`; }
-    get(key) { return this.storage.get(this.key(key)); }
-    set(key, value, ttlMs) { return this.storage.set(this.key(key), value, ttlMs === undefined ? {} : { ttlMs }); }
-    delete(key) { return this.storage.delete(this.key(key)); }
-    async invalidate(prefix = "") { const keys = []; for await (const key of this.storage.keys())
-        if (key.startsWith(this.key(prefix)))
-            keys.push(key); for (const key of keys)
-        await this.storage.delete(key); }
-    async getOrSet(key, factory, ttlMs) { const existing = await this.get(key); if (existing !== undefined)
-        return existing; const value = await factory(); await this.set(key, value, ttlMs); return value; }
-}
-exports.MemoryCache = MemoryCache;
-class TokenBucketLimiter {
-    capacity;
-    refillPerSecond;
-    buckets = new Map();
-    constructor(capacity, refillPerSecond) {
-        this.capacity = capacity;
-        this.refillPerSecond = refillPerSecond;
-        if (capacity <= 0 || refillPerSecond <= 0)
-            throw new RangeError("capacity and refillPerSecond must be positive");
-    }
-    consume(key, cost = 1) { if (!Number.isFinite(cost) || cost <= 0)
-        throw new RangeError("cost must be positive"); const now = Date.now(); const current = this.buckets.get(key) ?? { tokens: this.capacity, updatedAt: now }; const elapsedSeconds = (now - current.updatedAt) / 1000; current.tokens = Math.min(this.capacity, current.tokens + elapsedSeconds * this.refillPerSecond); current.updatedAt = now; if (current.tokens < cost) {
-        const retryAfterMs = Math.ceil(((cost - current.tokens) / this.refillPerSecond) * 1000);
-        this.buckets.set(key, current);
-        return { allowed: false, remaining: Math.floor(current.tokens), resetAt: now + retryAfterMs, retryAfterMs };
-    } current.tokens -= cost; this.buckets.set(key, current); return { allowed: true, remaining: Math.floor(current.tokens), resetAt: now + Math.ceil(((this.capacity - current.tokens) / this.refillPerSecond) * 1000) }; }
-    clear(key) { if (key === undefined)
-        this.buckets.clear();
-    else
-        this.buckets.delete(key); }
-}
-exports.TokenBucketLimiter = TokenBucketLimiter;

package/dist-cjs/src/cli.js

@@ -1,86 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.main = main;
-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, branding: false });
-        const health = await bot.health();
-        console.log(JSON.stringify(health, null, 2));
-        if (!health.apiReachable)
-            process.exitCode = 1;
-    }
-}
-async function commandStart() {
-    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);
-    await bot.start();
-}
-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");
-    console.log(`Created ${dir}`);
-}
-async function run(name, args) {
-    return new Promise((resolve) => {
-        const child = (0, node_child_process_1.spawn)(name, args, { stdio: "inherit", shell: false });
-        child.on("exit", (code, signal) => resolve(signal ? 1 : code ?? 1));
-    });
-}
-async function main(argv = process.argv.slice(2)) {
-    const [command, argument] = argv;
-    switch (command) {
-        case "start":
-            await commandStart();
-            break;
-        case "doctor":
-            await commandDoctor();
-            break;
-        case "init":
-            await commandInit(argument ?? "my-telebibz-bot");
-            break;
-        case "generate":
-            process.exitCode = await run("node", ["scripts/generate-api.mjs"]);
-            break;
-        case "build":
-            process.exitCode = await run("npm", ["run", "build"]);
-            break;
-        case "test":
-            process.exitCode = await run("npm", ["test"]);
-            break;
-        case "webhook": {
-            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, 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(`Handler type: ${typeof handler}`);
-            break;
-        }
-        case "inspect":
-            console.log(JSON.stringify({ cwd: process.cwd(), node: process.version }, null, 2));
-            break;
-        default: console.log("telebibz commands: start, init, dev, generate, webhook, doctor, test, inspect, build");
-    }
-}
-if (process.argv[1]?.endsWith("/cli.js") || process.argv[1]?.endsWith("/cli.ts"))
-    void main().catch((error) => {
-        const message = error instanceof Error ? error.message : "Unknown CLI error";
-        console.error(`telebibz: ${message}`);
-        process.exitCode = 1;
-    });