@xbibzlibrary/telebibz 0.4.4 → 3.0.1

package/dist/src/core/bot.d.ts

@@ -1,204 +0,0 @@
-import { ApiClient } from "../api/client.js";
-import { type FetchTransportOptions, type Transport } from "../api/transport.js";
-import type { BotCommand, BotCommandScope, ChatId, Update, User } from "../api/types.js";
-import { Context } from "../context/context.js";
-import { type Middleware } from "../middleware/compose.js";
-import { Router, type RouterOptions, type UpdateFilter } from "../router/router.js";
-import { EventBus, type EventMap } from "./events.js";
-import { type Storage } from "../storage/storage.js";
-import { PluginManager, type Plugin } from "../plugins/plugin.js";
-import { Logger, type LoggerOptions } from "../observability/logger.js";
-import { type Wizard } from "../state/conversation.js";
-import { type BroadcastOptions, type BroadcastReport } from "../broadcast/broadcast.js";
-import { type WebhookReplySink } from "./webhook-reply.js";
-import type { DownloadedFile } from "../api/client.js";
-import type { ContextOptions } from "../context/context.js";
-/** Thrown when a single update exceeds `handlerTimeout`; the handler keeps running in the background. */
-export declare class UpdateTimeoutError extends Error {
-    readonly name: string;
-    readonly updateId: number;
-    constructor(updateId: number, timeoutMs: number);
-}
-export type BotStatus = "created" | "initialized" | "starting" | "running" | "stopping" | "stopped" | "error";
-export type BotContext<S extends object = Record<string, unknown>> = Context<S>;
-export interface BotOptions<S extends object = Record<string, unknown>> {
-    token: string;
-    apiBaseUrl?: string;
-    transport?: Transport;
-    transportOptions?: Omit<FetchTransportOptions, "baseUrl">;
-    session?: Storage<string, S>;
-    services?: Record<string, unknown>;
-    polling?: {
-        timeout?: number;
-        limit?: number;
-        allowedUpdates?: string[];
-        retryDelayMs?: number;
-        maxRetryDelayMs?: number;
-    };
-    /**
-     * Update-processing tuning. Updates always run in parallel across chats
-     * while staying ordered within a single chat. `concurrency` caps how many
-     * updates may be processed at the same time (default `Infinity` — bursts of
-     * 1000+ messages are processed at once, with no artificial cooldown).
-     */
-    updates?: {
-        concurrency?: number;
-    };
-    /**
-     * Per-update processing timeout in milliseconds (default `90000`, matching
-     * Telegraf; `Infinity` disables). On timeout the update error flow runs
-     * (`update:error`, `bot:error`, `catch()` boundary) and `handleUpdate()`
-     * rejects, while the handler keeps running to completion in the background.
-     */
-    handlerTimeout?: number;
-    /** Custom `Context` subclass instantiated for every update (Telegraf's `contextType`). */
-    contextType?: new (options: ContextOptions<S>) => Context<S>;
-    router?: RouterOptions;
-    logger?: Logger | LoggerOptions;
-    branding?: boolean;
-}
-export interface HealthStatus {
-    status: BotStatus;
-    apiReachable: boolean;
-    bot?: User;
-    checkedAt: string;
-    error?: string;
-}
-export declare class Bot<S extends object = Record<string, unknown>> {
-    readonly api: ApiClient;
-    readonly router: Router<Context<S>>;
-    readonly events: EventBus<EventMap>;
-    readonly plugins: PluginManager<Context<S>>;
-    readonly session: Storage<string, S>;
-    readonly services: Record<string, unknown>;
-    readonly token: string;
-    readonly logger: Logger;
-    private readonly middlewares;
-    private readonly pollingOptions;
-    private statusValue;
-    private pollingAbort;
-    private offset;
-    private me?;
-    /** Caps how many updates run at once (default: unlimited). */
-    private readonly updateLimiter;
-    /** Per-update timeout in ms; `Infinity` disables. */
-    private readonly handlerTimeoutMs;
-    /** Context class instantiated per update (default `Context`). */
-    private readonly contextType;
-    /** Per-chat processing chains: parallel across chats, ordered within a chat. */
-    private readonly chatChains;
-    /**
-     * Identifies the update chain executing in the current async context so
-     * `stop()` called from inside a handler never deadlocks waiting on itself
-     * (Telegraf allows `bot.stop()` from within a handler).
-     */
-    private readonly currentUpdateChain;
-    /** Memoized init so a burst of updates triggers exactly one getMe call. */
-    private initOnce;
-    private readonly brandingEnabled;
-    /** Branding effects run only on an interactive TTY; structured logs stay untouched otherwise. */
-    private readonly brandingActive;
-    private activeBanner;
-    private errorHandler?;
-    constructor(options: string | BotOptions<S>);
-    /** Startup info logs are demoted to debug while the branding sequence owns the terminal. */
-    private startupLog;
-    get status(): BotStatus;
-    get botInfo(): User | undefined;
-    use(...middleware: Middleware<Context<S>>[]): this;
-    command(name: string, handler: Middleware<Context<S>>): this;
-    callback(pattern: string | RegExp, handler: Middleware<Context<S>>): this;
-    /** Telegraf-style alias for `callback()`: registers a handler for callback-query button data. */
-    action(pattern: string | RegExp, handler: Middleware<Context<S>>): this;
-    onText(text: string, handler: Middleware<Context<S>>): this;
-    onRegex(expression: RegExp, handler: Middleware<Context<S>>): this;
-    /** Registers a handler for update types: `bot.on("message:photo", handler)` or `bot.on(["message:text", "callback_query:data"], handler)`. */
-    on(filter: UpdateFilter | UpdateFilter[], handler: Middleware<Context<S>>): this;
-    /** Registers a handler for exact text or a regular expression, mirroring familiar frameworks. */
-    hears(trigger: string | RegExp, handler: Middleware<Context<S>>): this;
-    /**
-     * Sets the error boundary for update handlers. When set, handler failures are
-     * passed here instead of rejecting `handleUpdate()` (webhooks answer 200).
-     */
-    catch(handler: (error: unknown, ctx: Context<S>) => void | Promise<void>): this;
-    usePlugin(plugin: Plugin<Context<S>>): this;
-    /**
-     * Routes subsequent messages to the active Wizard step for the same chat/user.
-     * The application starts the wizard once with `wizard.run(ctx, key)`; this
-     * middleware keeps routing replies until the wizard is completed or cancelled.
-     */
-    useWizard(wizard: Wizard<S>, options?: {
-        cancelCommand?: string;
-    }): this;
-    init(): Promise<this>;
-    start(options?: {
-        timeout?: number;
-        allowedUpdates?: string[];
-        dropPendingUpdates?: boolean;
-    }): Promise<void>;
-    launch(options?: {
-        mode: "polling";
-        timeout?: number;
-        allowedUpdates?: string[];
-        dropPendingUpdates?: boolean;
-    }): Promise<void>;
-    stop(): Promise<void>;
-    /** Waits (bounded by `handlerTimeout`) for updates that are still processing. */
-    private drainInFlightUpdates;
-    restart(): Promise<void>;
-    health(): Promise<HealthStatus>;
-    getMe(): Promise<User>;
-    setCommands(commands: BotCommand[], scope?: BotCommandScope, languageCode?: string): Promise<true>;
-    deleteCommands(scope?: BotCommandScope, languageCode?: string): Promise<true>;
-    /**
-     * Downloads a Telegram file by `file_id`: resolves it with `getFile`, then
-     * fetches the raw bytes via the transport's download endpoint. Pass
-     * `destination` to also persist the bytes to a local file path. The
-     * returned `url` is valid for at least one hour; Telegram caps downloads
-     * at 20 MB.
-     */
-    downloadFile(fileId: string, options?: {
-        signal?: AbortSignal;
-        destination?: string;
-    }): Promise<DownloadedFile>;
-    /**
-     * Handles a single update. Updates for different chats run in parallel;
-     * updates for the same chat are processed strictly in arrival order so
-     * sessions, wizards, and conversations never interleave. Rejects for this
-     * update's failure (as before) without affecting other updates.
-     *
-     * `options.webhookReply` installs a Telegraf-style responder: the first
-     * outgoing API call during this update is answered through the webhook HTTP
-     * response instead of a separate request, and resolves with `true` because
-     * Telegram never sends the method result back to a webhook response.
-     */
-    handleUpdate(update: Update, options?: {
-        webhookReply?: WebhookReplySink;
-    }): Promise<void>;
-    /** Rejects with `UpdateTimeoutError` after `timeoutMs` unless `promise` settles first; `timeoutMs <= 0` or a non-finite value disables the guard. */
-    private withTimeout;
-    /**
-     * Handles a whole batch of updates at once: every chat in the batch is
-     * processed immediately (parallel across chats, ordered per chat), so a
-     * burst of 1000 messages is not stuck behind one slow handler. Individual
-     * handler failures are logged, emitted as `update:error`, and passed to the
-     * `catch()` error boundary; they never reject this promise.
-     */
-    handleUpdates(updates: readonly Update[]): Promise<void>;
-    /**
-     * Sends to many chats in parallel — built for broadcasts to 1000+ users.
-     * There is no proactive cooldown: every chat is attempted at once (up to
-     * `concurrency`). When Telegram answers 429, the send is retried
-     * automatically after exactly the `retry_after` delay Telegram ordered, so
-     * bursts deliver completely instead of failing.
-     */
-    broadcast(chatIds: readonly ChatId[], send: (chatId: ChatId) => Promise<unknown>, options?: BroadcastOptions): Promise<BroadcastReport>;
-    /** Runs init() once even when many updates arrive concurrently; never claims a webhook reply slot. */
-    private ensureInitialized;
-    private processUpdate;
-    private runUpdate;
-    private conversationKey;
-    private waitForRetry;
-    private poll;
-}
-//# sourceMappingURL=bot.d.ts.map

package/dist/src/core/bot.d.ts.map

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