@xbibzlibrary/telebibz 0.1.0

package/dist/src/api/errors.d.ts

@@ -0,0 +1,45 @@
+import type { ResponseParameters, TelegramResponse } from "./types.js";
+export type TelegramErrorKind = "retryable" | "rate-limit" | "authentication" | "validation" | "network" | "server" | "unknown";
+export declare class TelegramError extends Error {
+    readonly name: string;
+    readonly kind: TelegramErrorKind;
+    readonly errorCode: number | undefined;
+    readonly parameters: ResponseParameters | undefined;
+    readonly method: string;
+    readonly payload: unknown;
+    readonly status: number | undefined;
+    constructor(message: string, options: {
+        method: string;
+        payload: unknown;
+        errorCode?: number;
+        parameters?: ResponseParameters;
+        status?: number;
+        kind?: TelegramErrorKind;
+        cause?: unknown;
+    });
+    get retryAfter(): number | undefined;
+    get migrateToChatId(): number | undefined;
+}
+export declare class TelegramRateLimitError extends TelegramError {
+    readonly name: string;
+    constructor(message: string, options: ConstructorParameters<typeof TelegramError>[1]);
+}
+export declare class TelegramAuthError extends TelegramError {
+    readonly name: string;
+    constructor(message: string, options: ConstructorParameters<typeof TelegramError>[1]);
+}
+export declare class TelegramValidationError extends TelegramError {
+    readonly name: string;
+    constructor(message: string, options: ConstructorParameters<typeof TelegramError>[1]);
+}
+export declare class TelegramNetworkError extends TelegramError {
+    readonly name: string;
+    constructor(message: string, options: ConstructorParameters<typeof TelegramError>[1]);
+}
+export declare function classifyTelegramError(errorCode?: number, status?: number): TelegramErrorKind;
+export declare function telegramErrorFromResponse<T>(response: TelegramResponse<T>, context: {
+    method: string;
+    payload: unknown;
+    status?: number;
+}): TelegramError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/api/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/api/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEvE,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,YAAY,GAAG,gBAAgB,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEhI,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAkB,IAAI,EAAE,MAAM,CAAmB;IACjD,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;IAU3L,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAAyC;IAC7E,IAAI,eAAe,IAAI,MAAM,GAAG,SAAS,CAAgD;CAC1F;AAED,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,SAAkB,IAAI,EAAE,MAAM,CAA4B;gBAC9C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;CACrF;AACD,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,SAAkB,IAAI,EAAE,MAAM,CAAuB;gBACzC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;CACrF;AACD,qBAAa,uBAAwB,SAAQ,aAAa;IACxD,SAAkB,IAAI,EAAE,MAAM,CAA6B;gBAC/C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;CACrF;AACD,qBAAa,oBAAqB,SAAQ,aAAa;IACrD,SAAkB,IAAI,EAAE,MAAM,CAA0B;gBAC5C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC;CACrF;AAED,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAM5F;AAED,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,aAAa,CAUzJ"}

package/dist/src/api/errors.js

@@ -0,0 +1,65 @@
+export class TelegramError extends Error {
+    name = "TelegramError";
+    kind;
+    errorCode;
+    parameters;
+    method;
+    payload;
+    status;
+    constructor(message, options) {
+        super(message, { cause: options.cause });
+        this.method = options.method;
+        this.payload = options.payload;
+        this.errorCode = options.errorCode;
+        this.parameters = options.parameters;
+        this.status = options.status;
+        this.kind = options.kind ?? classifyTelegramError(options.errorCode, options.status);
+    }
+    get retryAfter() { return this.parameters?.retry_after; }
+    get migrateToChatId() { return this.parameters?.migrate_to_chat_id; }
+}
+export class TelegramRateLimitError extends TelegramError {
+    name = "TelegramRateLimitError";
+    constructor(message, options) { super(message, { ...options, kind: "rate-limit" }); }
+}
+export class TelegramAuthError extends TelegramError {
+    name = "TelegramAuthError";
+    constructor(message, options) { super(message, { ...options, kind: "authentication" }); }
+}
+export class TelegramValidationError extends TelegramError {
+    name = "TelegramValidationError";
+    constructor(message, options) { super(message, { ...options, kind: "validation" }); }
+}
+export class TelegramNetworkError extends TelegramError {
+    name = "TelegramNetworkError";
+    constructor(message, options) { super(message, { ...options, kind: "network" }); }
+}
+export function classifyTelegramError(errorCode, status) {
+    if (errorCode === 429)
+        return "rate-limit";
+    if (errorCode === 401 || status === 401 || status === 403)
+        return "authentication";
+    if (errorCode !== undefined && errorCode >= 400 && errorCode < 500)
+        return "validation";
+    if (status !== undefined && status >= 500)
+        return "server";
+    return "unknown";
+}
+export function telegramErrorFromResponse(response, context) {
+    const message = response.description ?? `Telegram API request failed for ${context.method}`;
+    const options = { method: context.method, payload: context.payload };
+    if (response.error_code !== undefined)
+        options.errorCode = response.error_code;
+    if (response.parameters !== undefined)
+        options.parameters = response.parameters;
+    if (context.status !== undefined)
+        options.status = context.status;
+    if (response.error_code === 429)
+        return new TelegramRateLimitError(message, options);
+    if (response.error_code === 401 || context.status === 401 || context.status === 403)
+        return new TelegramAuthError(message, options);
+    if (response.error_code !== undefined && response.error_code >= 400 && response.error_code < 500)
+        return new TelegramValidationError(message, options);
+    return new TelegramError(message, options);
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/api/errors.js.map

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

package/dist/src/api/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./client.js";
+export * from "./errors.js";
+export * from "./transport.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/src/api/index.js

@@ -0,0 +1,5 @@
+export * from "./client.js";
+export * from "./errors.js";
+export * from "./transport.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/src/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/src/api/transport.d.ts

@@ -0,0 +1,37 @@
+import type { TelegramResponse } from "./types.js";
+export interface TransportRequest {
+    method: string;
+    payload?: Record<string, unknown>;
+    signal?: AbortSignal;
+}
+export interface TransportResponse<T = unknown> {
+    status: number;
+    headers: Headers;
+    data: TelegramResponse<T>;
+}
+export interface Transport {
+    request<T>(request: TransportRequest): Promise<TransportResponse<T>>;
+}
+export interface FetchTransportOptions {
+    baseUrl?: string;
+    fetch?: typeof globalThis.fetch;
+    timeoutMs?: number;
+    retries?: number;
+    backoffMs?: number;
+    maxBackoffMs?: number;
+    jitter?: number;
+    headers?: HeadersInit;
+}
+export declare class FetchTransport implements Transport {
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    private readonly timeoutMs;
+    private readonly retries;
+    private readonly backoffMs;
+    private readonly maxBackoffMs;
+    private readonly jitter;
+    private readonly headers;
+    constructor(options?: FetchTransportOptions);
+    request<T>({ method, payload, signal }: TransportRequest): Promise<TransportResponse<T>>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/src/api/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/api/transport.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAa,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,qBAAa,cAAe,YAAW,SAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;gBAE1B,OAAO,GAAE,qBAA0B;IAYzC,OAAO,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,OAAY,EAAE,MAAM,EAAE,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;CA6CpG"}

package/dist/src/api/transport.js

@@ -0,0 +1,134 @@
+import { readFile } from "node:fs/promises";
+import { basename, isAbsolute, resolve } from "node:path";
+import { TelegramNetworkError } from "./errors.js";
+export class FetchTransport {
+    baseUrl;
+    fetchImpl;
+    timeoutMs;
+    retries;
+    backoffMs;
+    maxBackoffMs;
+    jitter;
+    headers;
+    constructor(options = {}) {
+        this.baseUrl = (options.baseUrl ?? "https://api.telegram.org").replace(/\/$/, "");
+        this.fetchImpl = options.fetch ?? globalThis.fetch;
+        if (!this.fetchImpl)
+            throw new Error("A fetch implementation is required.");
+        this.timeoutMs = options.timeoutMs ?? 30_000;
+        this.retries = options.retries ?? 2;
+        this.backoffMs = options.backoffMs ?? 250;
+        this.maxBackoffMs = options.maxBackoffMs ?? 8_000;
+        this.jitter = options.jitter ?? 0.2;
+        this.headers = options.headers ?? {};
+    }
+    async request({ method, payload = {}, signal }) {
+        const hasUpload = await containsUpload(payload);
+        let body;
+        const headers = new Headers(this.headers);
+        if (hasUpload) {
+            const form = new FormData();
+            for (const [key, value] of Object.entries(payload))
+                await appendFormValue(form, key, value);
+            body = form;
+        }
+        else {
+            headers.set("content-type", "application/json; charset=utf-8");
+            body = JSON.stringify(payload);
+        }
+        let attempt = 0;
+        while (true) {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(new Error(`Request timed out after ${this.timeoutMs}ms`)), this.timeoutMs);
+            const onAbort = () => controller.abort(signal?.reason);
+            signal?.addEventListener("abort", onAbort, { once: true });
+            try {
+                const normalizedMethod = method.replace(/^\//, "");
+                const response = await this.fetchImpl(`${this.baseUrl}/${normalizedMethod}`, {
+                    method: "POST",
+                    headers,
+                    body,
+                    signal: controller.signal,
+                });
+                const data = await response.json();
+                return { status: response.status, headers: response.headers, data };
+            }
+            catch (error) {
+                if (signal?.aborted)
+                    throw error;
+                if (attempt >= this.retries || !isRetryableNetworkError(error)) {
+                    throw new TelegramNetworkError(error instanceof Error ? error.message : "Network request failed", { method, payload, cause: error });
+                }
+                const exponential = Math.min(this.maxBackoffMs, this.backoffMs * 2 ** attempt);
+                const spread = exponential * this.jitter;
+                const delay = Math.max(0, exponential - spread + Math.random() * spread * 2);
+                await new Promise((resolveDelay) => setTimeout(resolveDelay, delay));
+                attempt += 1;
+            }
+            finally {
+                clearTimeout(timeout);
+                signal?.removeEventListener("abort", onAbort);
+            }
+        }
+    }
+}
+function isRetryableNetworkError(error) {
+    if (!(error instanceof Error))
+        return true;
+    return error.name === "AbortError" || /network|fetch|socket|timeout|temporar/i.test(error.message);
+}
+async function containsUpload(value) {
+    if (value instanceof Uint8Array || value instanceof ArrayBuffer || value instanceof Blob)
+        return true;
+    if (typeof value === "string")
+        return false;
+    if (value && typeof value === "object" && "source" in value)
+        return containsUpload(value.source);
+    if (Array.isArray(value)) {
+        for (const item of value)
+            if (await containsUpload(item))
+                return true;
+    }
+    else if (value && typeof value === "object") {
+        for (const item of Object.values(value))
+            if (await containsUpload(item))
+                return true;
+    }
+    return false;
+}
+async function appendFormValue(form, key, value) {
+    if (value === undefined || value === null)
+        return;
+    if (value instanceof Uint8Array) {
+        form.append(key, new Blob([value]));
+        return;
+    }
+    if (value instanceof ArrayBuffer) {
+        form.append(key, new Blob([value]));
+        return;
+    }
+    if (value instanceof Blob) {
+        form.append(key, value);
+        return;
+    }
+    if (value && typeof value === "object" && "source" in value) {
+        const upload = value;
+        if (typeof upload.source === "string" && (isAbsolute(upload.source) || upload.source.startsWith("./") || upload.source.startsWith("../"))) {
+            const filePath = resolve(upload.source);
+            const bytes = await readFile(filePath);
+            form.append(key, new Blob([bytes]), upload.filename ?? basename(filePath));
+            return;
+        }
+        return appendFormValue(form, key, upload.source);
+    }
+    if (typeof value === "string") {
+        form.append(key, value);
+        return;
+    }
+    if (typeof value === "number" || typeof value === "boolean") {
+        form.append(key, String(value));
+        return;
+    }
+    form.append(key, JSON.stringify(value));
+}
+//# sourceMappingURL=transport.js.map

package/dist/src/api/transport.js.map

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