@cats-inc/cats-platform 0.1.0

package/build/server/platform/transports/telegram/relay/index.js

@@ -0,0 +1,122 @@
+import { createTelegramConversationMapper, } from '../mapping.js';
+import { createBridgeDispatchFailureReceipt, deliverTelegramRequest, } from './delivery.js';
+import { linkTelegramRoom, receiveTelegramUpdate } from './ingress.js';
+import { buildTelegramRelayDiagnostics, buildTelegramRelayStatus, } from './status.js';
+import { InMemoryTelegramRelayStore } from '../store/index.js';
+import { readTelegramString } from '../utils.js';
+const DEFAULT_MAX_BODY_BYTES = 256 * 1024;
+function resolveStoredBinding(store, input) {
+    const bindingId = readTelegramString(input.bindingId);
+    const conversationId = readTelegramString(input.conversationId);
+    if (conversationId) {
+        return store.getBindingByConversationId(conversationId);
+    }
+    const chatId = readTelegramString(input.chatId);
+    if (chatId) {
+        return store.getBinding(chatId, bindingId);
+    }
+    const roomId = readTelegramString(input.roomId);
+    if (roomId) {
+        return store.listBindings().find((binding) => binding.linkedRoomId === roomId
+            && (!bindingId || binding.bindingId === bindingId)) ?? null;
+    }
+    return null;
+}
+export function createTelegramRelay(options = {}) {
+    const now = options.now ?? (() => new Date());
+    const store = options.store ?? new InMemoryTelegramRelayStore();
+    const conversationMapper = options.conversationMapper ?? createTelegramConversationMapper(store);
+    const webhookPath = options.webhookPath ?? '/api/transports/telegram/webhook';
+    const diagnosticsPath = options.diagnosticsPath ?? '/api/transports/telegram/diagnostics';
+    const webhookSecretToken = readTelegramString(options.webhookSecretToken);
+    const maxBodyBytes = Number.isFinite(options.maxBodyBytes)
+        ? Math.max(1024, Number(options.maxBodyBytes))
+        : DEFAULT_MAX_BODY_BYTES;
+    const deliveryClient = options.deliveryClient ?? null;
+    const resolveDeliveryClient = options.resolveDeliveryClient;
+    const getPollingStatuses = options.getPollingStatuses ?? (() => []);
+    const hasConfiguredDelivery = (context) => deliveryClient !== null
+        || context.botBindings.some((binding) => binding.status === 'active' && resolveDeliveryClient?.(binding) !== null);
+    const readStatus = (context) => buildTelegramRelayStatus({
+        context,
+        store,
+        conversationMapper,
+        webhookPath,
+        diagnosticsPath,
+        webhookSecretToken,
+        maxBodyBytes,
+        deliveryConfigured: hasConfiguredDelivery(context),
+        pollingStatuses: getPollingStatuses(),
+    });
+    return {
+        getIngressConfig() {
+            return {
+                secretToken: webhookSecretToken,
+                maxBodyBytes,
+            };
+        },
+        getStatus(context) {
+            return readStatus(context);
+        },
+        getDiagnostics(context) {
+            return buildTelegramRelayDiagnostics({
+                status: readStatus(context),
+                store,
+                conversationMapper,
+            });
+        },
+        resolveBinding(input) {
+            return resolveStoredBinding(store, input);
+        },
+        findSoleUnlinkedConversation(bindingId) {
+            const normalized = readTelegramString(bindingId);
+            if (!normalized)
+                return null;
+            const unlinked = store
+                .listBindings()
+                .filter((binding) => binding.bindingId === normalized && !binding.linkedRoomId);
+            return unlinked.length === 1 ? unlinked[0] : null;
+        },
+        linkRoom(input) {
+            const binding = resolveStoredBinding(store, input);
+            if (!binding) {
+                return null;
+            }
+            return linkTelegramRoom({
+                store,
+                binding,
+                roomId: input.roomId,
+                linkedAt: readTelegramString(input.linkedAt) ?? now().toISOString(),
+            });
+        },
+        receiveUpdate({ update, context, }) {
+            return receiveTelegramUpdate({
+                now,
+                store,
+                conversationMapper,
+                context,
+                update,
+            });
+        },
+        async deliver({ request, context, }) {
+            return deliverTelegramRequest({
+                now,
+                store,
+                conversationMapper,
+                deliveryClient,
+                resolveDeliveryClient,
+                request,
+                context,
+            });
+        },
+        recordBridgeDispatchFailure(input) {
+            const receipt = createBridgeDispatchFailureReceipt({
+                ...input,
+                deliveredAt: readTelegramString(input.deliveredAt) ?? now().toISOString(),
+            });
+            store.recordDeliveryReceipt(receipt);
+            return receipt;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/build/server/platform/transports/telegram/relay/index.js.map

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

package/build/server/platform/transports/telegram/relay/ingress.d.ts

@@ -0,0 +1,18 @@
+import type { TelegramConversationBinding, TelegramRelayContext, TelegramWebhookReceipt, TelegramWebhookUpdate } from '../contracts.js';
+import { type TelegramConversationMapper } from '../mapping.js';
+import type { TelegramRelayStore } from '../store/index.js';
+export interface ReceiveTelegramUpdateOptions {
+    now: () => Date;
+    store: TelegramRelayStore;
+    conversationMapper: TelegramConversationMapper;
+    context: TelegramRelayContext;
+    update: TelegramWebhookUpdate;
+}
+export declare function receiveTelegramUpdate(options: ReceiveTelegramUpdateOptions): TelegramWebhookReceipt;
+export declare function linkTelegramRoom(input: {
+    store: TelegramRelayStore;
+    binding: TelegramConversationBinding;
+    roomId: string;
+    linkedAt: string;
+}): TelegramConversationBinding;
+//# sourceMappingURL=ingress.d.ts.map

package/build/server/platform/transports/telegram/relay/ingress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingress.d.ts","sourceRoot":"","sources":["../../../../../../src/platform/transports/telegram/relay/ingress.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,2BAA2B,EAE3B,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAA+B,KAAK,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAE7F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAsD5D,MAAM,WAAW,4BAA4B;IAC3C,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,kBAAkB,EAAE,0BAA0B,CAAC;IAC/C,OAAO,EAAE,oBAAoB,CAAC;IAC9B,MAAM,EAAE,qBAAqB,CAAC;CAC/B;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,sBAAsB,CAmInG;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,OAAO,EAAE,2BAA2B,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,2BAA2B,CAS9B"}

package/build/server/platform/transports/telegram/relay/ingress.js

@@ -0,0 +1,164 @@
+import { describeTelegramRoomRouting } from '../mapping.js';
+import { normalizeTelegramMessageSummary } from '../normalization.js';
+import { pickTelegramMessage, readTelegramString, resolveActiveTelegramBinding, } from '../utils.js';
+function buildTelegramWebhookReceipt(input) {
+    const messageSummary = input.message
+        ? normalizeTelegramMessageSummary(input.message, { isEdited: input.isEdited })
+        : null;
+    return {
+        platform: 'telegram',
+        status: input.status,
+        acceptedAt: input.acceptedAt,
+        updateId: input.updateId,
+        chatId: input.chatId,
+        messageId: input.messageId,
+        bindingId: input.binding?.id ?? null,
+        botName: input.binding?.botName ?? null,
+        bossCatId: input.context.bossCatId,
+        bossCatName: input.context.bossCatName,
+        mappedConversationId: input.mappedConversationId,
+        messageSummary,
+        roomRouting: input.roomRouting,
+        reason: input.reason,
+    };
+}
+function recordTelegramIngressReceipt(store, input) {
+    const receipt = buildTelegramWebhookReceipt(input);
+    store.recordIngressReceipt(receipt);
+    return receipt;
+}
+export function receiveTelegramUpdate(options) {
+    const acceptedAt = options.now().toISOString();
+    const updateId = typeof options.update.update_id === 'number' ? options.update.update_id : null;
+    const pickedMessage = pickTelegramMessage(options.update);
+    const message = pickedMessage.message;
+    const sender = pickedMessage.sender;
+    const chatId = message?.chat?.id != null ? String(message.chat.id) : null;
+    const messageId = typeof message?.message_id === 'number' ? String(message.message_id) : null;
+    const activeBinding = resolveActiveTelegramBinding(options.context);
+    const scopedBindingId = options.context.selectedBotBinding?.id ?? null;
+    const scopedBotName = options.context.selectedBotBinding?.botName ?? activeBinding?.botName ?? null;
+    const roomRouting = options.conversationMapper.describeRoomRouting(scopedBindingId);
+    if (!activeBinding) {
+        return recordTelegramIngressReceipt(options.store, {
+            context: options.context,
+            binding: null,
+            acceptedAt,
+            updateId,
+            chatId,
+            messageId,
+            mappedConversationId: null,
+            message,
+            isEdited: pickedMessage.isEdited,
+            status: 'ignored',
+            roomRouting,
+            reason: 'telegram_not_bound_to_boss_cat',
+        });
+    }
+    if (updateId !== null && options.store.hasProcessedUpdate(updateId)) {
+        return recordTelegramIngressReceipt(options.store, {
+            context: options.context,
+            binding: activeBinding,
+            acceptedAt,
+            updateId,
+            chatId,
+            messageId,
+            mappedConversationId: chatId
+                ? options.store.getBinding(chatId, scopedBindingId)?.conversationId ?? null
+                : null,
+            message,
+            isEdited: pickedMessage.isEdited,
+            status: 'ignored',
+            roomRouting,
+            reason: 'duplicate_update',
+        });
+    }
+    if (!message || !chatId) {
+        return recordTelegramIngressReceipt(options.store, {
+            context: options.context,
+            binding: activeBinding,
+            acceptedAt,
+            updateId,
+            chatId,
+            messageId,
+            mappedConversationId: null,
+            message,
+            isEdited: pickedMessage.isEdited,
+            status: 'ignored',
+            roomRouting,
+            reason: 'unsupported_update',
+        });
+    }
+    if (sender?.is_bot === true) {
+        return recordTelegramIngressReceipt(options.store, {
+            context: options.context,
+            binding: activeBinding,
+            acceptedAt,
+            updateId,
+            chatId,
+            messageId,
+            mappedConversationId: null,
+            message,
+            isEdited: pickedMessage.isEdited,
+            status: 'ignored',
+            roomRouting,
+            reason: 'message_from_bot',
+        });
+    }
+    if (message.chat?.type !== 'private') {
+        return recordTelegramIngressReceipt(options.store, {
+            context: options.context,
+            binding: activeBinding,
+            acceptedAt,
+            updateId,
+            chatId,
+            messageId,
+            mappedConversationId: null,
+            message,
+            isEdited: pickedMessage.isEdited,
+            status: 'ignored',
+            roomRouting,
+            reason: 'unsupported_chat_type',
+        });
+    }
+    const mapping = options.conversationMapper.resolveChatConversation({
+        chatId,
+        acceptedAt,
+        bindingId: scopedBindingId,
+        botName: scopedBotName,
+        chatType: message.chat?.type ?? 'private',
+        chatTitle: readTelegramString(message.chat?.title),
+        chatUsername: readTelegramString(message.chat?.username),
+        messageId,
+        messageSummary: normalizeTelegramMessageSummary(message, {
+            isEdited: pickedMessage.isEdited,
+        }),
+    });
+    if (updateId !== null) {
+        options.store.markProcessedUpdate(updateId);
+    }
+    return recordTelegramIngressReceipt(options.store, {
+        context: options.context,
+        binding: activeBinding,
+        acceptedAt,
+        updateId,
+        chatId,
+        messageId,
+        mappedConversationId: mapping.binding.conversationId,
+        message,
+        isEdited: pickedMessage.isEdited,
+        status: 'accepted',
+        roomRouting: describeTelegramRoomRouting(mapping.binding),
+    });
+}
+export function linkTelegramRoom(input) {
+    const nextBinding = {
+        ...input.binding,
+        linkedRoomId: input.roomId,
+        roomRoutingStatus: 'linked_room',
+        updatedAt: input.linkedAt,
+    };
+    input.store.upsertBinding(nextBinding);
+    return nextBinding;
+}
+//# sourceMappingURL=ingress.js.map

package/build/server/platform/transports/telegram/relay/ingress.js.map

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

package/build/server/platform/transports/telegram/relay/status.d.ts

@@ -0,0 +1,21 @@
+import type { TelegramPollingStatus, TelegramRelayContext, TelegramRelayDiagnostics, TelegramRelayStatus } from '../contracts.js';
+import type { TelegramConversationMapper } from '../mapping.js';
+import type { TelegramRelayStore } from '../store/index.js';
+export interface BuildTelegramRelayStatusOptions {
+    context: TelegramRelayContext;
+    store: TelegramRelayStore;
+    conversationMapper: TelegramConversationMapper;
+    webhookPath: string;
+    diagnosticsPath: string;
+    webhookSecretToken: string | null;
+    maxBodyBytes: number;
+    deliveryConfigured: boolean;
+    pollingStatuses: TelegramPollingStatus[];
+}
+export declare function buildTelegramRelayStatus(options: BuildTelegramRelayStatusOptions): TelegramRelayStatus;
+export declare function buildTelegramRelayDiagnostics(input: {
+    status: TelegramRelayStatus;
+    store: TelegramRelayStore;
+    conversationMapper: TelegramConversationMapper;
+}): TelegramRelayDiagnostics;
+//# sourceMappingURL=status.d.ts.map

package/build/server/platform/transports/telegram/relay/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../../../../src/platform/transports/telegram/relay/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAuC5D,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,oBAAoB,CAAC;IAC9B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,kBAAkB,EAAE,0BAA0B,CAAC;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,qBAAqB,EAAE,CAAC;CAC1C;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,+BAA+B,GACvC,mBAAmB,CAgErB;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,kBAAkB,EAAE,0BAA0B,CAAC;CAChD,GAAG,wBAAwB,CAwB3B"}

package/build/server/platform/transports/telegram/relay/status.js

@@ -0,0 +1,115 @@
+const SUPPORTED_DELIVERY_OPERATIONS = [
+    'send',
+    'reply',
+    'edit',
+    'delete',
+    'send_media',
+    'answer_callback',
+];
+function hasActiveDefaultBinding(context) {
+    return context.defaultBotBinding?.status === 'active';
+}
+function buildStatusNote(input) {
+    if (!input.context.bossCatId) {
+        return 'No Boss Cat is configured for Telegram ingress.';
+    }
+    if (!input.boundToBossCat) {
+        return 'No active Telegram bot binding is available for ingress.';
+    }
+    if (!input.deliveryConfigured) {
+        return input.context.botBindings.length > 1
+            ? 'Multiple Cat-bound Telegram bots are configured. One active binding is used for ingress and delivery is still unconfigured.'
+            : 'Telegram ingress is wired to the active Cat binding. Outbound delivery remains unconfigured.';
+    }
+    return input.context.botBindings.length > 1
+        ? 'Telegram supports multiple Cat-bound bot bindings while keeping one default ingress path.'
+        : 'Telegram ingress and delivery are both pinned to the active Cat binding.';
+}
+export function buildTelegramRelayStatus(options) {
+    const boundToBossCat = hasActiveDefaultBinding(options.context);
+    const botBinding = boundToBossCat && options.context.defaultBotBinding
+        ? {
+            id: options.context.defaultBotBinding.id,
+            platform: 'telegram',
+            botName: options.context.defaultBotBinding.botName,
+        }
+        : null;
+    const availableBindings = options.context.botBindings.map((binding) => ({
+        id: binding.id,
+        platform: 'telegram',
+        botName: binding.botName,
+        catActorId: binding.catActorId,
+        inboundMode: binding.inboundMode ?? 'polling',
+        roomMode: binding.roomMode,
+        status: binding.status,
+    }));
+    const ingress = options.store.getIngressStats();
+    const delivery = options.store.getDeliveryStats();
+    return {
+        platform: 'telegram',
+        status: boundToBossCat ? 'bound' : 'unbound',
+        bossCatId: options.context.bossCatId,
+        bossCatName: options.context.bossCatName,
+        botBinding,
+        availableBindings,
+        publicIdentityMode: 'multi_cat_bindings_single_boss',
+        mappedConversationCount: options.conversationMapper.getBindingCount(),
+        lastProcessedUpdateId: options.store.getLastProcessedUpdateId(),
+        webhookPath: options.webhookPath,
+        diagnosticsPath: options.diagnosticsPath,
+        relayMode: 'boss-cat-ingress',
+        roomRouting: options.conversationMapper.describeRoomRouting(options.context.selectedBotBinding?.id ?? null),
+        ingress: {
+            secretTokenConfigured: options.webhookSecretToken !== null,
+            maxBodyBytes: options.maxBodyBytes,
+            acceptedUpdates: ingress.acceptedCount,
+            ignoredUpdates: ingress.ignoredCount,
+            lastReceipt: ingress.lastReceipt,
+        },
+        delivery: {
+            status: options.deliveryConfigured ? 'configured' : 'not_configured',
+            supportedOperations: [...SUPPORTED_DELIVERY_OPERATIONS],
+            sentCount: delivery.sentCount,
+            repliedCount: delivery.repliedCount,
+            editedCount: delivery.editedCount,
+            deletedCount: delivery.deletedCount,
+            failedCount: delivery.failedCount,
+            lastReceipt: delivery.lastReceipt,
+        },
+        polling: {
+            activeConsumers: options.pollingStatuses.filter((status) => status.health !== 'stopped').length,
+            statuses: options.pollingStatuses,
+        },
+        note: buildStatusNote({
+            context: options.context,
+            boundToBossCat,
+            deliveryConfigured: options.deliveryConfigured,
+        }),
+    };
+}
+export function buildTelegramRelayDiagnostics(input) {
+    return {
+        platform: 'telegram',
+        status: input.status.status,
+        publicIdentityMode: input.status.publicIdentityMode,
+        bossCatId: input.status.bossCatId,
+        bossCatName: input.status.bossCatName,
+        botBinding: input.status.botBinding,
+        availableBindings: input.status.availableBindings,
+        relayMode: input.status.relayMode,
+        webhookPath: input.status.webhookPath,
+        diagnosticsPath: input.status.diagnosticsPath,
+        lastProcessedUpdateId: input.status.lastProcessedUpdateId,
+        dedupe: {
+            retainedUpdateCount: input.store.getProcessedUpdateCount(),
+            maxRetainedUpdateCount: input.store.getMaxProcessedUpdates(),
+        },
+        roomRouting: input.status.roomRouting,
+        ingress: input.status.ingress,
+        delivery: input.status.delivery,
+        polling: input.status.polling,
+        bindings: input.conversationMapper.listBindings(),
+        note: input.status.note,
+    };
+}
+//# sourceMappingURL=status.js.map

package/build/server/platform/transports/telegram/relay/status.js.map

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

package/build/server/platform/transports/telegram/store/index.d.ts

@@ -0,0 +1,83 @@
+import type { TelegramConversationBinding, TelegramDeliveryReceipt, TelegramWebhookReceipt } from '../contracts.js';
+import type { PersistedTelegramRelayState } from './state.js';
+export interface TelegramIngressStatsSnapshot {
+    acceptedCount: number;
+    ignoredCount: number;
+    lastReceipt: TelegramWebhookReceipt | null;
+}
+export interface TelegramDeliveryStatsSnapshot {
+    sentCount: number;
+    repliedCount: number;
+    editedCount: number;
+    deletedCount: number;
+    failedCount: number;
+    lastReceipt: TelegramDeliveryReceipt | null;
+}
+export interface TelegramRelayStore {
+    getBinding(chatId: string, bindingId?: string | null): TelegramConversationBinding | null;
+    getBindingByConversationId(conversationId: string): TelegramConversationBinding | null;
+    listBindings(): TelegramConversationBinding[];
+    upsertBinding(binding: TelegramConversationBinding): void;
+    hasProcessedUpdate(updateId: number): boolean;
+    markProcessedUpdate(updateId: number): void;
+    getLastProcessedUpdateId(): number | null;
+    getProcessedUpdateCount(): number;
+    getMaxProcessedUpdates(): number;
+    recordIngressReceipt(receipt: TelegramWebhookReceipt): void;
+    getIngressStats(): TelegramIngressStatsSnapshot;
+    recordDeliveryReceipt(receipt: TelegramDeliveryReceipt): void;
+    getDeliveryStats(): TelegramDeliveryStatsSnapshot;
+}
+declare class BaseTelegramRelayStore implements TelegramRelayStore {
+    protected readonly maxProcessedUpdates: number;
+    protected readonly processedUpdateOrder: number[];
+    protected readonly bindingsByChatId: Map<string, TelegramConversationBinding>;
+    protected readonly bindingsByConversationId: Map<string, TelegramConversationBinding>;
+    protected readonly processedUpdateIds: Set<number>;
+    protected lastProcessedUpdateId: number | null;
+    protected ingressAcceptedCount: number;
+    protected ingressIgnoredCount: number;
+    protected lastIngressReceipt: TelegramWebhookReceipt | null;
+    protected deliverySentCount: number;
+    protected deliveryRepliedCount: number;
+    protected deliveryEditedCount: number;
+    protected deliveryDeletedCount: number;
+    protected deliveryFailedCount: number;
+    protected lastDeliveryReceipt: TelegramDeliveryReceipt | null;
+    constructor(maxProcessedUpdates?: number);
+    getBinding(chatId: string, bindingId?: string | null): TelegramConversationBinding | null;
+    getBindingByConversationId(conversationId: string): TelegramConversationBinding | null;
+    listBindings(): TelegramConversationBinding[];
+    upsertBinding(binding: TelegramConversationBinding): void;
+    hasProcessedUpdate(updateId: number): boolean;
+    markProcessedUpdate(updateId: number): void;
+    getLastProcessedUpdateId(): number | null;
+    getProcessedUpdateCount(): number;
+    getMaxProcessedUpdates(): number;
+    recordIngressReceipt(receipt: TelegramWebhookReceipt): void;
+    getIngressStats(): TelegramIngressStatsSnapshot;
+    recordDeliveryReceipt(receipt: TelegramDeliveryReceipt): void;
+    getDeliveryStats(): TelegramDeliveryStatsSnapshot;
+    protected upsertBindingInMemory(binding: TelegramConversationBinding): void;
+    protected markProcessedUpdateInMemory(updateId: number): void;
+    protected recordIngressReceiptInMemory(receipt: TelegramWebhookReceipt): void;
+    protected recordDeliveryReceiptInMemory(receipt: TelegramDeliveryReceipt): void;
+    protected serialize(): PersistedTelegramRelayState;
+    protected hydrate(payload: PersistedTelegramRelayState): void;
+}
+export declare class InMemoryTelegramRelayStore extends BaseTelegramRelayStore {
+}
+export declare class FileBackedTelegramRelayStore extends BaseTelegramRelayStore {
+    private readonly statePath;
+    constructor(statePath: string, maxProcessedUpdates?: number);
+    upsertBinding(binding: TelegramConversationBinding): void;
+    markProcessedUpdate(updateId: number): void;
+    recordIngressReceipt(receipt: TelegramWebhookReceipt): void;
+    recordDeliveryReceipt(receipt: TelegramDeliveryReceipt): void;
+    private readPersistedState;
+    private persist;
+}
+export declare function resolveTelegramRelayStatePath(chatStatePath: string): string;
+export declare function createFileBackedTelegramRelayStore(chatStatePath: string, maxProcessedUpdates?: number): TelegramRelayStore;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/server/platform/transports/telegram/store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/platform/transports/telegram/store/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,2BAA2B,EAC3B,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AAKzB,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,WAAW,4BAA4B;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,2BAA2B,GAAG,IAAI,CAAC;IAC1F,0BAA0B,CAAC,cAAc,EAAE,MAAM,GAAG,2BAA2B,GAAG,IAAI,CAAC;IACvF,YAAY,IAAI,2BAA2B,EAAE,CAAC;IAC9C,aAAa,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAC1D,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9C,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,wBAAwB,IAAI,MAAM,GAAG,IAAI,CAAC;IAC1C,uBAAuB,IAAI,MAAM,CAAC;IAClC,sBAAsB,IAAI,MAAM,CAAC;IACjC,oBAAoB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC5D,eAAe,IAAI,4BAA4B,CAAC;IAChD,qBAAqB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC9D,gBAAgB,IAAI,6BAA6B,CAAC;CACnD;AASD,cAAM,sBAAuB,YAAW,kBAAkB;IA6B5C,SAAS,CAAC,QAAQ,CAAC,mBAAmB;IA5BlD,SAAS,CAAC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,EAAE,CAAM;IAEvD,SAAS,CAAC,QAAQ,CAAC,gBAAgB,2CAAkD;IAErF,SAAS,CAAC,QAAQ,CAAC,wBAAwB,2CAAkD;IAE7F,SAAS,CAAC,QAAQ,CAAC,kBAAkB,cAAqB;IAE1D,SAAS,CAAC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEtD,SAAS,CAAC,oBAAoB,SAAK;IAEnC,SAAS,CAAC,mBAAmB,SAAK;IAElC,SAAS,CAAC,kBAAkB,EAAE,sBAAsB,GAAG,IAAI,CAAQ;IAEnE,SAAS,CAAC,iBAAiB,SAAK;IAEhC,SAAS,CAAC,oBAAoB,SAAK;IAEnC,SAAS,CAAC,mBAAmB,SAAK;IAElC,SAAS,CAAC,oBAAoB,SAAK;IAEnC,SAAS,CAAC,mBAAmB,SAAK;IAElC,SAAS,CAAC,mBAAmB,EAAE,uBAAuB,GAAG,IAAI,CAAQ;gBAEtC,mBAAmB,SAAO;IAEzD,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,2BAA2B,GAAG,IAAI;IAIzF,0BAA0B,CAAC,cAAc,EAAE,MAAM,GAAG,2BAA2B,GAAG,IAAI;IAItF,YAAY,IAAI,2BAA2B,EAAE;IAK7C,aAAa,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI;IAIzD,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI7C,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI3C,wBAAwB,IAAI,MAAM,GAAG,IAAI;IAIzC,uBAAuB,IAAI,MAAM;IAIjC,sBAAsB,IAAI,MAAM;IAIhC,oBAAoB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAI3D,eAAe,IAAI,4BAA4B;IAQ/C,qBAAqB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAI7D,gBAAgB,IAAI,6BAA6B;IAWjD,SAAS,CAAC,qBAAqB,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI;IAW3E,SAAS,CAAC,2BAA2B,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAiB7D,SAAS,CAAC,4BAA4B,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAS7E,SAAS,CAAC,6BAA6B,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAoB/E,SAAS,CAAC,SAAS,IAAI,2BAA2B;IAWlD,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI;CAkB9D;AAED,qBAAa,0BAA2B,SAAQ,sBAAsB;CAAG;AAEzE,qBAAa,4BAA6B,SAAQ,sBAAsB;IAEpE,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM,EAClC,mBAAmB,SAAO;IAMnB,aAAa,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI;IAKzD,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQ3C,oBAAoB,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAK3D,qBAAqB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAKtE,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,OAAO;CAGhB;AAED,wBAAgB,6BAA6B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAI3E;AAED,wBAAgB,kCAAkC,CAChD,aAAa,EAAE,MAAM,EACrB,mBAAmB,SAAO,GACzB,kBAAkB,CAKpB"}