opencode-telegram-link 1.0.0-rc.1

package/dist/setup.d.ts

@@ -0,0 +1,77 @@
+import { type NotifierConfig } from "./config";
+import type { SupportedLocale } from "./i18n";
+import { type TelegramBot } from "./telegram/api";
+export declare function resolveDockerComposeContext(cwd?: string, explicitComposePath?: string): {
+    composeFile: string;
+    projectDir: string;
+} | undefined;
+export type PairingCandidate = {
+    userId: string;
+    chatId: string;
+    updateId: number;
+};
+export type GuidedSetupResult = {
+    status: "ready";
+    bot: Pick<TelegramBot, "id" | "username">;
+    config: NotifierConfig;
+    tokenFile: string;
+    readyForTestNotification: true;
+    pairing?: PairingCandidate;
+} | {
+    status: "confirmation_required";
+    bot: Pick<TelegramBot, "id" | "username">;
+    nonce: string;
+    expiresAt: number;
+    pairing: PairingCandidate;
+};
+export type GuidedSetupOptions = {
+    botToken: string;
+    locale?: SupportedLocale;
+    userId?: string;
+    chatId?: string;
+    stateDirectory?: string;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    now?: () => number;
+    pairing?: {
+        enabled: true;
+        nonce?: string;
+        expiresInMs?: number;
+        pollTimeoutSeconds?: number;
+        confirm?: (candidate: PairingCandidate) => boolean | Promise<boolean>;
+    };
+};
+export type InteractiveSetupOptions = {
+    stdin?: AsyncIterable<Buffer | string> | NodeJS.ReadableStream | undefined;
+    stdout?: Pick<NodeJS.WriteStream, "write"> | undefined;
+    stderr?: Pick<NodeJS.WriteStream, "write"> | undefined;
+    env?: NodeJS.ProcessEnv | undefined;
+    fetch?: typeof fetch | undefined;
+    stateDirectory?: string | undefined;
+    cwd?: string | undefined;
+    now?: (() => number) | undefined;
+};
+export declare class SetupError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare class AsyncPromptReader {
+    private iterator;
+    private buffer;
+    constructor(input: AsyncIterable<Buffer | string> | NodeJS.ReadableStream);
+    readLine(): Promise<string>;
+    ask(promptText: string, stdout: Pick<NodeJS.WriteStream, "write">, defaultValue?: string): Promise<string>;
+}
+export declare function runGuidedSetup(options: GuidedSetupOptions): Promise<GuidedSetupResult>;
+export declare function runInteractiveSetup(options?: InteractiveSetupOptions): Promise<number>;
+export declare function runSetupCli(options?: {
+    argv?: string[];
+    env?: NodeJS.ProcessEnv;
+    stdout?: Pick<NodeJS.WriteStream, "write">;
+    stderr?: Pick<NodeJS.WriteStream, "write">;
+    stdin?: AsyncIterable<Buffer | string>;
+    fetch?: typeof fetch;
+    cwd?: string;
+}): Promise<number>;
+export declare function createPairingNonce(): string;
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

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

package/dist/state/database.d.ts

@@ -0,0 +1,159 @@
+import type { RouteKey } from "../protocol";
+export type MessageRouteKind = "session_prompt" | "question_reply" | "permission_notice" | "informational";
+export type MessageRouteStatus = "active" | "consumed" | "expired" | "offline";
+export type MessageRouteRecord = {
+    chatId: string;
+    messageId: number;
+    route: RouteKey;
+    kind: MessageRouteKind;
+    interactionId?: string;
+    createdAt: number;
+    expiresAt: number;
+    status: MessageRouteStatus;
+};
+export type CallbackTokenRecord = {
+    token: string;
+    chatId: string;
+    messageId: number;
+    action: string;
+    payload?: string;
+    createdAt: number;
+    expiresAt: number;
+    consumedAt?: number;
+};
+export type OutboxRecord = {
+    id: number;
+    idempotencyKey: string;
+    chatId: string;
+    payload: string;
+    priority: number;
+    attempts: number;
+    nextAttemptAt: number;
+    expiresAt: number;
+    status: "pending" | "retry" | "delivered" | "failed";
+    resultCode: string | null;
+    createdAt: number;
+    updatedAt: number;
+};
+export type InboundUpdateRecord = {
+    updateId: number;
+    actionId?: string;
+    disposition: "rejected" | "acknowledged" | "failed";
+    payloadHash?: string;
+    occurredAt: number;
+};
+export type RetentionPolicy = {
+    terminalRouteRetentionMs: number;
+    terminalOutboxRetentionMs: number;
+    inboundUpdateRetentionMs: number;
+    maxMessageRoutes: number;
+    maxCallbackTokens: number;
+    maxOutboxRecords: number;
+    maxInboundUpdates: number;
+    maxDedupeRecords: number;
+};
+export type CleanupResult = {
+    expiredMessageRoutes: number;
+    expiredOutboxRecords: number;
+    deletedMessageRoutes: number;
+    deletedCallbackTokens: number;
+    deletedOutboxRecords: number;
+    deletedInboundUpdates: number;
+    deletedDedupeRecords: number;
+};
+export type StateInspection = {
+    schemaVersion: number;
+    machineId: string;
+    telegramUpdateOffset: number;
+    messageRoutes: Record<MessageRouteStatus, number>;
+    callbackTokens: number;
+    outbox: Record<OutboxRecord["status"], number>;
+    inboundUpdates: number;
+    dedupeRecords: number;
+};
+export declare const DEFAULT_RETENTION_POLICY: RetentionPolicy;
+export declare class StateDatabase {
+    #private;
+    readonly path: string;
+    private constructor();
+    static open(input: {
+        stateDirectory: string;
+        machineId: string;
+    }): Promise<StateDatabase>;
+    get schemaVersion(): number;
+    getTelegramUpdateOffset(): number;
+    getTelegramBotFingerprint(): string | undefined;
+    pinTelegramBotFingerprint(botId: string, force?: boolean): void;
+    setTelegramBotFingerprint(botId: string): void;
+    commitInboundUpdate(input: {
+        updateId: number;
+        actionId?: string;
+        disposition: "rejected" | "acknowledged" | "failed";
+        payloadHash?: string;
+        occurredAt: number;
+    }): boolean;
+    getInboundUpdate(updateId: number): InboundUpdateRecord | undefined;
+    saveMessageRoute(record: MessageRouteRecord): void;
+    getMessageRoute(chatId: string, messageId: number): MessageRouteRecord | undefined;
+    setMessageRouteStatus(chatId: string, messageId: number, status: MessageRouteStatus): boolean;
+    saveCallbackToken(record: CallbackTokenRecord): void;
+    getCallbackToken(token: string): CallbackTokenRecord | undefined;
+    consumeCallbackToken(token: string, now: number): boolean;
+    consumeCallbackTokenAndRoute(input: {
+        token: string;
+        chatId: string;
+        messageId: number;
+        now: number;
+    }): boolean;
+    enqueueOutbox(input: {
+        idempotencyKey: string;
+        chatId: string;
+        payload: string;
+        priority: number;
+        nextAttemptAt: number;
+        expiresAt: number;
+        createdAt: number;
+    }): {
+        id: number;
+        created: boolean;
+    };
+    nextOutbox(now: number, limit: number): OutboxRecord[];
+    recordOutboxRetry(id: number, nextAttemptAt: number, resultCode: string, now: number): void;
+    finishOutbox(id: number, status: "delivered" | "failed", resultCode: string | null, now: number): void;
+    finishOutboxDeliveryWithBinding(input: {
+        outboxId: number;
+        route: MessageRouteRecord;
+        callbackTokens?: CallbackTokenRecord[];
+        now: number;
+    }): void;
+    claimNotification(idempotencyKey: string, expiresAt: number, now: number): boolean;
+    cleanup(now: number, policy?: RetentionPolicy): CleanupResult;
+    inspect(): StateInspection;
+    purgeOperationalState(): StateInspection;
+    vacuum(): void;
+    close(): void;
+}
+export declare class DatabaseVersionError extends Error {
+    readonly found: number;
+    readonly supported: number;
+    constructor(found: number, supported: number);
+}
+export type DatabaseIntegrity = {
+    status: "missing";
+} | {
+    status: "healthy";
+} | {
+    status: "corrupt";
+    reason: string;
+};
+export declare function inspectDatabaseIntegrity(stateDirectory: string): Promise<DatabaseIntegrity>;
+export declare function repairCorruptStateDatabase(input: {
+    stateDirectory: string;
+    machineId: string;
+    confirm: boolean;
+    force?: boolean;
+}): Promise<{
+    archivePath: string;
+    previousIntegrity: DatabaseIntegrity;
+}>;
+//# sourceMappingURL=database.d.ts.map

package/dist/state/database.d.ts.map

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

package/dist/state/discovery.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+export declare const DiscoveryRecordSchema: z.ZodObject<{
+    port: z.ZodNumber;
+    pid: z.ZodNumber;
+    nonce: z.ZodUUID;
+    protocol: z.ZodObject<{
+        major: z.ZodNumber;
+        minor: z.ZodNumber;
+    }, z.core.$strip>;
+    startedAt: z.ZodISODateTime;
+}, z.core.$strip>;
+export type DiscoveryRecord = z.infer<typeof DiscoveryRecordSchema>;
+export declare function writeDiscoveryRecord(stateDirectory: string, port: number): Promise<DiscoveryRecord>;
+export declare function removeDiscoveryRecord(stateDirectory: string, expectedNonce: string): Promise<void>;
+export declare function discoveryRecordPath(stateDirectory: string): string;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/state/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/state/discovery.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,qBAAqB;;;;;;;;;iBAShC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,eAAe,CAAC,CAa1B;AAED,wBAAsB,qBAAqB,CACzC,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAElE"}

package/dist/state/identity.d.ts

@@ -0,0 +1,19 @@
+import type { RouteKey } from "../protocol";
+export type StateIdentity = {
+    stateDirectory: string;
+    machineId: string;
+    brokerSecret: string;
+    routeSalt: string;
+};
+export declare function defaultStateDirectory(environment?: NodeJS.ProcessEnv): string;
+export declare function loadOrCreateStateIdentity(stateDirectory?: string): Promise<StateIdentity>;
+export declare function createInstanceId(): string;
+export declare function createRouteGeneration(): string;
+export declare function deriveProjectId(projectPath: string, routeSalt: string): Promise<string>;
+export declare function createRouteKey(input: {
+    machineId: string;
+    instanceId: string;
+    projectId: string;
+    sessionId: string;
+}): RouteKey;
+//# sourceMappingURL=identity.d.ts.map

package/dist/state/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/state/identity.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAK5C,MAAM,MAAM,aAAa,GAAG;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,WAAW,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAc1F;AAED,wBAAsB,yBAAyB,CAC7C,cAAc,SAA0B,GACvC,OAAO,CAAC,aAAa,CAAC,CAqBxB;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG7F;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,QAAQ,CAKX"}

package/dist/state/index.d.ts

@@ -0,0 +1,4 @@
+export { type CallbackTokenRecord, type CleanupResult, type DatabaseIntegrity, DatabaseVersionError, DEFAULT_RETENTION_POLICY, type InboundUpdateRecord, inspectDatabaseIntegrity, type MessageRouteKind, type MessageRouteRecord, type MessageRouteStatus, type OutboxRecord, type RetentionPolicy, repairCorruptStateDatabase, StateDatabase, type StateInspection, } from "./database";
+export { type DiscoveryRecord, DiscoveryRecordSchema, discoveryRecordPath, removeDiscoveryRecord, writeDiscoveryRecord, } from "./discovery";
+export { createInstanceId, createRouteGeneration, createRouteKey, defaultStateDirectory, deriveProjectId, loadOrCreateStateIdentity, type StateIdentity, } from "./identity";
+//# sourceMappingURL=index.d.ts.map

package/dist/state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,KAAK,mBAAmB,EACxB,wBAAwB,EACxB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,0BAA0B,EAC1B,aAAa,EACb,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,eAAe,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,yBAAyB,EACzB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC"}

package/dist/telegram/api.d.ts

@@ -0,0 +1,212 @@
+import { z } from "zod";
+export declare const TelegramFileSchema: z.ZodObject<{
+    file_id: z.ZodString;
+    file_unique_id: z.ZodOptional<z.ZodString>;
+    file_size: z.ZodOptional<z.ZodNumber>;
+    file_path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type TelegramFile = z.infer<typeof TelegramFileSchema>;
+export declare const TelegramUpdateSchema: z.ZodObject<{
+    update_id: z.ZodNumber;
+    message: z.ZodOptional<z.ZodObject<{
+        message_id: z.ZodNumber;
+        from: z.ZodOptional<z.ZodObject<{
+            id: z.ZodNumber;
+            is_bot: z.ZodBoolean;
+            first_name: z.ZodString;
+            username: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        chat: z.ZodObject<{
+            id: z.ZodNumber;
+            type: z.ZodEnum<{
+                private: "private";
+                group: "group";
+                supergroup: "supergroup";
+                channel: "channel";
+            }>;
+        }, z.core.$strip>;
+        date: z.ZodNumber;
+        text: z.ZodOptional<z.ZodString>;
+        voice: z.ZodOptional<z.ZodObject<{
+            file_id: z.ZodString;
+            file_unique_id: z.ZodOptional<z.ZodString>;
+            duration: z.ZodOptional<z.ZodNumber>;
+            mime_type: z.ZodOptional<z.ZodString>;
+            file_size: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        audio: z.ZodOptional<z.ZodObject<{
+            file_id: z.ZodString;
+            file_unique_id: z.ZodOptional<z.ZodString>;
+            duration: z.ZodOptional<z.ZodNumber>;
+            mime_type: z.ZodOptional<z.ZodString>;
+            file_size: z.ZodOptional<z.ZodNumber>;
+            file_name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        sender_chat: z.ZodOptional<z.ZodObject<{
+            id: z.ZodNumber;
+            type: z.ZodEnum<{
+                private: "private";
+                group: "group";
+                supergroup: "supergroup";
+                channel: "channel";
+            }>;
+        }, z.core.$strip>>;
+        forward_origin: z.ZodOptional<z.ZodUnknown>;
+        author_signature: z.ZodOptional<z.ZodString>;
+        business_connection_id: z.ZodOptional<z.ZodString>;
+        reply_to_message: z.ZodOptional<z.ZodObject<{
+            message_id: z.ZodNumber;
+            chat: z.ZodObject<{
+                id: z.ZodNumber;
+                type: z.ZodEnum<{
+                    private: "private";
+                    group: "group";
+                    supergroup: "supergroup";
+                    channel: "channel";
+                }>;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    callback_query: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        from: z.ZodObject<{
+            id: z.ZodNumber;
+            is_bot: z.ZodBoolean;
+            first_name: z.ZodString;
+            username: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        message: z.ZodOptional<z.ZodObject<{
+            message_id: z.ZodNumber;
+            from: z.ZodOptional<z.ZodObject<{
+                id: z.ZodNumber;
+                is_bot: z.ZodBoolean;
+                first_name: z.ZodString;
+                username: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            chat: z.ZodObject<{
+                id: z.ZodNumber;
+                type: z.ZodEnum<{
+                    private: "private";
+                    group: "group";
+                    supergroup: "supergroup";
+                    channel: "channel";
+                }>;
+            }, z.core.$strip>;
+            date: z.ZodNumber;
+            text: z.ZodOptional<z.ZodString>;
+            voice: z.ZodOptional<z.ZodObject<{
+                file_id: z.ZodString;
+                file_unique_id: z.ZodOptional<z.ZodString>;
+                duration: z.ZodOptional<z.ZodNumber>;
+                mime_type: z.ZodOptional<z.ZodString>;
+                file_size: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            audio: z.ZodOptional<z.ZodObject<{
+                file_id: z.ZodString;
+                file_unique_id: z.ZodOptional<z.ZodString>;
+                duration: z.ZodOptional<z.ZodNumber>;
+                mime_type: z.ZodOptional<z.ZodString>;
+                file_size: z.ZodOptional<z.ZodNumber>;
+                file_name: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            sender_chat: z.ZodOptional<z.ZodObject<{
+                id: z.ZodNumber;
+                type: z.ZodEnum<{
+                    private: "private";
+                    group: "group";
+                    supergroup: "supergroup";
+                    channel: "channel";
+                }>;
+            }, z.core.$strip>>;
+            forward_origin: z.ZodOptional<z.ZodUnknown>;
+            author_signature: z.ZodOptional<z.ZodString>;
+            business_connection_id: z.ZodOptional<z.ZodString>;
+            reply_to_message: z.ZodOptional<z.ZodObject<{
+                message_id: z.ZodNumber;
+                chat: z.ZodObject<{
+                    id: z.ZodNumber;
+                    type: z.ZodEnum<{
+                        private: "private";
+                        group: "group";
+                        supergroup: "supergroup";
+                        channel: "channel";
+                    }>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        data: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type TelegramUpdate = z.infer<typeof TelegramUpdateSchema>;
+export declare const TelegramBotSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    first_name: z.ZodString;
+    username: z.ZodOptional<z.ZodString>;
+    is_bot: z.ZodLiteral<true>;
+}, z.core.$strip>;
+export type TelegramBot = z.infer<typeof TelegramBotSchema>;
+export type SendMessageInput = {
+    chatId: string;
+    text: string;
+    parseMode?: "HTML";
+    disableNotification?: boolean;
+    replyMarkup?: Record<string, unknown>;
+    signal?: AbortSignal;
+};
+export type TelegramBotApiOptions = {
+    token: string;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+};
+export declare class TelegramBotApi {
+    #private;
+    constructor(options: TelegramBotApiOptions);
+    getMe(signal?: AbortSignal): Promise<TelegramBot>;
+    deleteWebhook(signal?: AbortSignal): Promise<void>;
+    getUpdates(input: {
+        offset: number;
+        timeoutSeconds?: number;
+        signal?: AbortSignal;
+    }): Promise<TelegramUpdate[]>;
+    sendMessage(input: SendMessageInput): Promise<{
+        messageId: number;
+        chatId: string;
+    }>;
+    answerCallbackQuery(input: {
+        callbackQueryId: string;
+        text?: string;
+        showAlert?: boolean;
+        signal?: AbortSignal;
+    }): Promise<boolean>;
+    editMessageText(input: {
+        chatId: string;
+        messageId: number;
+        text: string;
+        parseMode?: "HTML";
+        replyMarkup?: Record<string, unknown>;
+        signal?: AbortSignal;
+    }): Promise<{
+        messageId: number;
+        chatId: string;
+    }>;
+    getFile(fileId: string, signal?: AbortSignal | undefined): Promise<TelegramFile>;
+    downloadFile(filePath: string, signal?: AbortSignal | undefined): Promise<Uint8Array>;
+}
+export declare class TelegramApiError extends Error {
+    readonly method: string;
+    readonly statusCode: number;
+    readonly errorCode: number | undefined;
+    readonly retryAfterSeconds: number | undefined;
+    readonly retryable: boolean;
+    constructor(input: {
+        method: string;
+        statusCode: number;
+        errorCode?: number;
+        description: string;
+        retryAfterSeconds?: number;
+        retryable: boolean;
+    });
+    get authenticationFailed(): boolean;
+    get pollingConflict(): boolean;
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/telegram/api.d.ts.map

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

package/dist/telegram/authorization.d.ts

@@ -0,0 +1,25 @@
+import type { TelegramUpdate } from "./api";
+import type { UpdateDisposition } from "./poller";
+export type AuthorizationRejection = "UNSUPPORTED_UPDATE" | "USER_MISSING" | "BOT_SENDER" | "USER_MISMATCH" | "CHAT_MISSING" | "CHAT_NOT_PRIVATE" | "CHAT_MISMATCH" | "FORWARDED_MESSAGE" | "SENDER_CHAT" | "BUSINESS_MESSAGE";
+export type AuthorizedUpdate = {
+    kind: "message" | "callback_query";
+    userId: string;
+    chatId: string;
+};
+export type AuthorizationResult = {
+    authorized: true;
+    subject: AuthorizedUpdate;
+} | {
+    authorized: false;
+    reason: AuthorizationRejection;
+};
+export declare class TelegramUpdateAuthorizer {
+    #private;
+    constructor(input: {
+        userId: string;
+        chatId: string;
+    });
+    authorize(update: TelegramUpdate): AuthorizationResult;
+}
+export declare function createAuthorizedUpdateHandler(authorizer: TelegramUpdateAuthorizer, handleAuthorized: (update: TelegramUpdate, subject: AuthorizedUpdate) => UpdateDisposition | Promise<UpdateDisposition>): (update: TelegramUpdate) => UpdateDisposition | Promise<UpdateDisposition>;
+//# sourceMappingURL=authorization.d.ts.map

package/dist/telegram/authorization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorization.d.ts","sourceRoot":"","sources":["../../src/telegram/authorization.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD,MAAM,MAAM,sBAAsB,GAC9B,oBAAoB,GACpB,cAAc,GACd,YAAY,GACZ,eAAe,GACf,cAAc,GACd,kBAAkB,GAClB,eAAe,GACf,mBAAmB,GACnB,aAAa,GACb,kBAAkB,CAAC;AAEvB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,SAAS,GAAG,gBAAgB,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAC3B;IAAE,UAAU,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,GAC/C;IAAE,UAAU,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAA;CAAE,CAAC;AAE1D,qBAAa,wBAAwB;;gBAIvB,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAWrD,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,mBAAmB;CAmCvD;AAED,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,wBAAwB,EACpC,gBAAgB,EAAE,CAChB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,gBAAgB,KACtB,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,GAClD,CAAC,MAAM,EAAE,cAAc,KAAK,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAU5E"}

package/dist/telegram/commands.d.ts

@@ -0,0 +1,20 @@
+import type { RouteRegistry } from "../broker/registry";
+import { type SupportedLocale } from "../i18n";
+import type { BrokerCommand, CommandResult } from "../protocol";
+export type SlashCommandContext = {
+    text: string;
+    locale?: SupportedLocale;
+    registry: RouteRegistry;
+    dispatcher: {
+        sendCommand(command: BrokerCommand): Promise<CommandResult>;
+    };
+    startedAt?: number;
+    packageVersion?: string;
+};
+export declare function isSlashCommand(text?: string): boolean;
+export declare function parseSlashCommand(text: string): {
+    command: string;
+    args: string[];
+} | undefined;
+export declare function executeSlashCommand(context: SlashCommandContext): Promise<string>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/telegram/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/telegram/commands.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,KAAK,eAAe,EAAa,MAAM,SAAS,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGhE,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,aAAa,CAAC;IACxB,UAAU,EAAE;QACV,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;KAC7D,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAIrD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CAe/F;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkCvF"}

package/dist/telegram/index.d.ts

@@ -0,0 +1,9 @@
+export { type SendMessageInput, TelegramApiError, type TelegramBot, TelegramBotApi, type TelegramBotApiOptions, type TelegramUpdate, TelegramUpdateSchema, } from "./api";
+export { type AuthorizationRejection, type AuthorizationResult, type AuthorizedUpdate, createAuthorizedUpdateHandler, TelegramUpdateAuthorizer, } from "./authorization";
+export { executeSlashCommand, isSlashCommand, parseSlashCommand, type SlashCommandContext, } from "./commands";
+export { type BrokerCommandDispatcher, createValidatedInteractionHandler, type InteractionFeedbackCode, type InteractionSubmissionOutcome, type InteractionValidationReason, type InteractionValidationResult, type InteractionValidatorOptions, interactionFeedbackText, submitCompletedSessionReply, submitQuestionReply, submitTelegramInteraction, type ValidatedTelegramInteraction, validateTelegramInteraction, validationFeedback, } from "./interaction";
+export { type TelegramOutboxPayload, TelegramOutboxPayloadSchema, TelegramOutboxWorker, type TelegramOutboxWorkerOptions, } from "./outbox";
+export { TelegramPoller, type TelegramPollerOptions, type UpdateDisposition, } from "./poller";
+export { type RenderedTelegramPayload, redactText, renderTelegramNotification, sanitizeTelegramText, TelegramRenderError, type TelegramRenderOptions, } from "./render";
+export { VoiceTranscriber, type VoiceTranscriberOptions, } from "./transcriber";
+//# sourceMappingURL=index.d.ts.map

package/dist/telegram/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telegram/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EACrB,gBAAgB,EAChB,KAAK,WAAW,EAChB,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,oBAAoB,GACrB,MAAM,OAAO,CAAC;AACf,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,6BAA6B,EAC7B,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,uBAAuB,EAC5B,iCAAiC,EACjC,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,uBAAuB,EACvB,2BAA2B,EAC3B,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,4BAA4B,EACjC,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,qBAAqB,EAC1B,2BAA2B,EAC3B,oBAAoB,EACpB,KAAK,2BAA2B,GACjC,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,GACvB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,KAAK,uBAAuB,EAC5B,UAAU,EACV,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,qBAAqB,GAC3B,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,GAC7B,MAAM,eAAe,CAAC"}

package/dist/telegram/interaction.d.ts

@@ -0,0 +1,49 @@
+import { type SupportedLocale } from "../i18n";
+import type { BrokerCommand, CommandResult, RouteKey } from "../protocol";
+import type { MessageRouteKind, StateDatabase } from "../state";
+import type { TelegramUpdate } from "./api";
+import type { AuthorizedUpdate, TelegramUpdateAuthorizer } from "./authorization";
+import type { UpdateDisposition } from "./poller";
+export type InteractionValidationReason = "ALREADY_HANDLED" | "MESSAGE_BINDING_REQUIRED" | "MESSAGE_BINDING_NOT_FOUND" | "MESSAGE_BINDING_EXPIRED" | "MESSAGE_BINDING_INACTIVE" | "CALLBACK_TOKEN_INVALID" | "CALLBACK_TOKEN_EXPIRED" | "CALLBACK_TOKEN_MESSAGE_MISMATCH" | "ACTION_KIND_MISMATCH" | "ROUTE_STALE";
+export type ValidatedTelegramInteraction = {
+    updateId: number;
+    chatId: string;
+    messageId: number;
+    kind: MessageRouteKind;
+    route: RouteKey;
+    interactionId?: string;
+    text?: string;
+    callbackToken?: string;
+    callbackAction?: string;
+    callbackPayload?: string;
+};
+export type InteractionValidationResult = {
+    accepted: true;
+    interaction: ValidatedTelegramInteraction;
+} | {
+    accepted: false;
+    reason: InteractionValidationReason;
+    disposition: UpdateDisposition;
+};
+export type InteractionValidatorOptions = {
+    database: StateDatabase;
+    isRouteLive: (route: RouteKey) => boolean;
+    now?: () => number;
+};
+export type BrokerCommandDispatcher = {
+    sendCommand(command: BrokerCommand): Promise<CommandResult>;
+};
+export type InteractionFeedbackCode = "accepted" | "already_handled" | "expired" | "indeterminate" | "invalid" | "offline" | "rejected" | "reply_required" | "stale" | "terminal_only";
+export type InteractionSubmissionOutcome = {
+    result: CommandResult;
+    feedback: InteractionFeedbackCode;
+};
+export declare function validateTelegramInteraction(update: TelegramUpdate, subject: AuthorizedUpdate, options: InteractionValidatorOptions): InteractionValidationResult;
+export declare function createValidatedInteractionHandler(authorizer: TelegramUpdateAuthorizer, options: InteractionValidatorOptions, handleValidated: (interaction: ValidatedTelegramInteraction, update: TelegramUpdate) => UpdateDisposition | Promise<UpdateDisposition>): (update: TelegramUpdate) => UpdateDisposition | Promise<UpdateDisposition>;
+export declare function submitCompletedSessionReply(dispatcher: BrokerCommandDispatcher, interaction: ValidatedTelegramInteraction): Promise<CommandResult>;
+export declare function submitQuestionReply(dispatcher: BrokerCommandDispatcher, interaction: ValidatedTelegramInteraction): Promise<CommandResult>;
+export declare function submitPermissionReply(dispatcher: BrokerCommandDispatcher, interaction: ValidatedTelegramInteraction): Promise<CommandResult>;
+export declare function submitTelegramInteraction(dispatcher: BrokerCommandDispatcher, interaction: ValidatedTelegramInteraction): Promise<InteractionSubmissionOutcome>;
+export declare function validationFeedback(reason: InteractionValidationReason): InteractionFeedbackCode;
+export declare function interactionFeedbackText(locale: SupportedLocale, feedback: InteractionFeedbackCode): string;
+//# sourceMappingURL=interaction.d.ts.map