@jilimb0/tgwrapper 0.4.0

package/dist/core/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/core/circuit-breaker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D,KAAK,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAQpD,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;gBAE7B,OAAO,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC;IAIpD,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAmBlC,SAAS,IAAI,IAAI;IAMjB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAe9B,QAAQ,IAAI;QAAE,KAAK,EAAE,YAAY,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;CAM7D"}

package/dist/core/circuit-breaker.js

@@ -0,0 +1,59 @@
+import { CircuitOpenError } from './errors.js';
+const DEFAULT_CIRCUIT = {
+    failureThreshold: 5,
+    cooldownMs: 15_000,
+    halfOpenMaxRequests: 1
+};
+export class CircuitBreaker {
+    state = 'closed';
+    failures = 0;
+    openedAt = 0;
+    halfOpenRequests = 0;
+    options;
+    constructor(options) {
+        this.options = { ...DEFAULT_CIRCUIT, ...options };
+    }
+    beforeRequest(nowMs) {
+        if (this.state === 'open') {
+            const elapsed = nowMs - this.openedAt;
+            if (elapsed >= this.options.cooldownMs) {
+                this.state = 'half_open';
+                this.halfOpenRequests = 0;
+            }
+            else {
+                throw new CircuitOpenError(this.options.cooldownMs - elapsed);
+            }
+        }
+        if (this.state === 'half_open') {
+            if (this.halfOpenRequests >= this.options.halfOpenMaxRequests) {
+                throw new CircuitOpenError(this.options.cooldownMs);
+            }
+            this.halfOpenRequests += 1;
+        }
+    }
+    onSuccess() {
+        this.state = 'closed';
+        this.failures = 0;
+        this.halfOpenRequests = 0;
+    }
+    onFailure(nowMs) {
+        if (this.state === 'half_open') {
+            this.state = 'open';
+            this.openedAt = nowMs;
+            this.halfOpenRequests = 0;
+            return;
+        }
+        this.failures += 1;
+        if (this.failures >= this.options.failureThreshold) {
+            this.state = 'open';
+            this.openedAt = nowMs;
+        }
+    }
+    snapshot() {
+        return {
+            state: this.state,
+            failures: this.failures
+        };
+    }
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/core/circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../src/core/circuit-breaker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAK/C,MAAM,eAAe,GAA0B;IAC7C,gBAAgB,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM;IAClB,mBAAmB,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,OAAO,cAAc;IACjB,KAAK,GAAiB,QAAQ,CAAC;IAC/B,QAAQ,GAAG,CAAC,CAAC;IACb,QAAQ,GAAG,CAAC,CAAC;IACb,gBAAgB,GAAG,CAAC,CAAC;IACZ,OAAO,CAAwB;IAEhD,YAAmB,OAAwC;QACzD,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC;IACpD,CAAC;IAEM,aAAa,CAAC,KAAa;QAChC,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;YACtC,IAAI,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvC,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC;gBACzB,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC;gBAC9D,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YACtD,CAAC;YACD,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAEM,SAAS;QACd,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QAClB,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC;IAC5B,CAAC;IAEM,SAAS,CAAC,KAAa;QAC5B,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;YACpB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACtB,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;QACnB,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;YACnD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC;YACpB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;IAEM,QAAQ;QACb,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;IACJ,CAAC;CACF"}

package/dist/core/context.d.ts

@@ -0,0 +1,29 @@
+import type { ApiClient } from './api-client.js';
+import type { JsonObject, SessionEnvelope } from '../types/core.js';
+import type { CallbackQuery, Message, Update } from '../types/telegram.js';
+interface SceneController {
+    enter(nextState: string): Promise<void>;
+    leave(): Promise<void>;
+}
+export declare class Context<TState extends string, TData extends JsonObject> {
+    readonly update: Update;
+    readonly state: JsonObject;
+    readonly session: SessionEnvelope<TState, TData>;
+    readonly scene: SceneController;
+    private readonly apiClient;
+    constructor(params: {
+        update: Update;
+        state?: JsonObject;
+        session: SessionEnvelope<TState, TData>;
+        sceneController: SceneController;
+        apiClient: ApiClient;
+    });
+    get message(): Message.TextMessage | undefined;
+    get callbackQuery(): CallbackQuery | undefined;
+    get fromId(): number | undefined;
+    reply(text: string, extra?: JsonObject): Promise<unknown>;
+    editMessage(text: string, extra?: JsonObject): Promise<unknown>;
+    answerCallbackQuery(text?: string): Promise<unknown>;
+}
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/core/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE3E,UAAU,eAAe;IACvB,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,qBAAa,OAAO,CAAC,MAAM,SAAS,MAAM,EAAE,KAAK,SAAS,UAAU;IAClE,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,KAAK,EAAE,UAAU,CAAC;IAClC,SAAgB,OAAO,EAAE,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACxD,SAAgB,KAAK,EAAE,eAAe,CAAC;IAEvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAEnB,MAAM,EAAE;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,UAAU,CAAC;QACnB,OAAO,EAAE,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACxC,eAAe,EAAE,eAAe,CAAC;QACjC,SAAS,EAAE,SAAS,CAAC;KACtB;IAQD,IAAW,OAAO,IAAI,OAAO,CAAC,WAAW,GAAG,SAAS,CAMpD;IAED,IAAW,aAAa,IAAI,aAAa,GAAG,SAAS,CAEpD;IAED,IAAW,MAAM,IAAI,MAAM,GAAG,SAAS,CAQtC;IAEY,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,UAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAa7D,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,UAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAcnE,mBAAmB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAWlE"}

package/dist/core/context.js

@@ -0,0 +1,67 @@
+export class Context {
+    update;
+    state;
+    session;
+    scene;
+    apiClient;
+    constructor(params) {
+        this.update = params.update;
+        this.state = params.state ?? {};
+        this.session = params.session;
+        this.scene = params.sceneController;
+        this.apiClient = params.apiClient;
+    }
+    get message() {
+        const maybeMessage = this.update.message;
+        if (maybeMessage && 'text' in maybeMessage) {
+            return maybeMessage;
+        }
+        return undefined;
+    }
+    get callbackQuery() {
+        return this.update.callback_query;
+    }
+    get fromId() {
+        if (this.update.message?.from) {
+            return this.update.message.from.id;
+        }
+        if (this.update.callback_query?.from) {
+            return this.update.callback_query.from.id;
+        }
+        return undefined;
+    }
+    async reply(text, extra = {}) {
+        const chatId = this.update.message?.chat.id ?? this.update.callback_query?.message?.chat.id;
+        if (!chatId) {
+            throw new Error('Cannot reply without chat id in update.');
+        }
+        return this.apiClient.callApi('sendMessage', {
+            chat_id: chatId,
+            text,
+            ...extra
+        });
+    }
+    async editMessage(text, extra = {}) {
+        const callbackMessage = this.update.callback_query?.message;
+        if (!callbackMessage) {
+            throw new Error('Cannot edit message without callback_query.message.');
+        }
+        return this.apiClient.callApi('editMessageText', {
+            chat_id: callbackMessage.chat.id,
+            message_id: callbackMessage.message_id,
+            text,
+            ...extra
+        });
+    }
+    async answerCallbackQuery(text) {
+        const callbackQueryId = this.update.callback_query?.id;
+        if (!callbackQueryId) {
+            throw new Error('Cannot answer callback query for non-callback update.');
+        }
+        return this.apiClient.callApi('answerCallbackQuery', {
+            callback_query_id: callbackQueryId,
+            text
+        });
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/core/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,OAAO;IACF,MAAM,CAAS;IACf,KAAK,CAAa;IAClB,OAAO,CAAiC;IACxC,KAAK,CAAkB;IAEtB,SAAS,CAAY;IAEtC,YAAmB,MAMlB;QACC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,eAAe,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACpC,CAAC;IAED,IAAW,OAAO;QAChB,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QACzC,IAAI,YAAY,IAAI,MAAM,IAAI,YAAY,EAAE,CAAC;YAC3C,OAAO,YAAmC,CAAC;QAC7C,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAW,aAAa;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;IACpC,CAAC;IAED,IAAW,MAAM;QACf,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,QAAoB,EAAE;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;QAC5F,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,aAAa,EAAE;YAC3C,OAAO,EAAE,MAAM;YACf,IAAI;YACJ,GAAG,KAAK;SACT,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,IAAY,EAAE,QAAoB,EAAE;QAC3D,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC;QAC5D,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,iBAAiB,EAAE;YAC/C,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC,EAAE;YAChC,UAAU,EAAE,eAAe,CAAC,UAAU;YACtC,IAAI;YACJ,GAAG,KAAK;SACT,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,mBAAmB,CAAC,IAAa;QAC5C,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,qBAAqB,EAAE;YACnD,iBAAiB,EAAE,eAAe;YAClC,IAAI;SACL,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/core/errors.d.ts

@@ -0,0 +1,21 @@
+import type { JsonObject } from '../types/core.js';
+export type CoreErrorCode = 'CIRCUIT_OPEN' | 'TELEGRAM_API_ERROR' | 'NETWORK_ERROR' | 'VALIDATION_ERROR' | 'SESSION_CONFLICT';
+export declare class CoreError extends Error {
+    readonly code: CoreErrorCode;
+    readonly retryable: boolean;
+    readonly details: JsonObject | undefined;
+    constructor(code: CoreErrorCode, message: string, retryable: boolean, details?: JsonObject);
+}
+export declare class TelegramApiError extends CoreError {
+    readonly errorCode: number;
+    readonly description: string;
+    readonly parameters: JsonObject | undefined;
+    constructor(errorCode: number, description: string, parameters?: JsonObject);
+}
+export declare class CircuitOpenError extends CoreError {
+    constructor(cooldownMs: number);
+}
+export declare class SessionConflictError extends CoreError {
+    constructor(sessionKey: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,MAAM,aAAa,GACrB,cAAc,GACd,oBAAoB,GACpB,eAAe,GACf,kBAAkB,GAClB,kBAAkB,CAAC;AAEvB,qBAAa,SAAU,SAAQ,KAAK;IAClC,SAAgB,IAAI,EAAE,aAAa,CAAC;IACpC,SAAgB,SAAS,EAAE,OAAO,CAAC;IACnC,SAAgB,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC;gBAE7B,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,UAAU;CAOlG;AAED,qBAAa,gBAAiB,SAAQ,SAAS;IAC7C,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;gBAEhC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU;CAWnF;AAED,qBAAa,gBAAiB,SAAQ,SAAS;gBAC1B,UAAU,EAAE,MAAM;CAMtC;AAED,qBAAa,oBAAqB,SAAQ,SAAS;gBAC9B,UAAU,EAAE,MAAM;CAMtC"}

package/dist/core/errors.js

@@ -0,0 +1,45 @@
+export class CoreError extends Error {
+    code;
+    retryable;
+    details;
+    constructor(code, message, retryable, details) {
+        super(message);
+        this.code = code;
+        this.retryable = retryable;
+        this.details = details;
+        this.name = 'CoreError';
+    }
+}
+export class TelegramApiError extends CoreError {
+    errorCode;
+    description;
+    parameters;
+    constructor(errorCode, description, parameters) {
+        super('TELEGRAM_API_ERROR', `Telegram API error ${errorCode}: ${description}`, errorCode === 429, {
+            error_code: errorCode,
+            description,
+            parameters
+        });
+        this.name = 'TelegramApiError';
+        this.errorCode = errorCode;
+        this.description = description;
+        this.parameters = parameters;
+    }
+}
+export class CircuitOpenError extends CoreError {
+    constructor(cooldownMs) {
+        super('CIRCUIT_OPEN', `Circuit breaker is open. Retry after ${cooldownMs}ms.`, true, {
+            cooldown_ms: cooldownMs
+        });
+        this.name = 'CircuitOpenError';
+    }
+}
+export class SessionConflictError extends CoreError {
+    constructor(sessionKey) {
+        super('SESSION_CONFLICT', `Session conflict for key ${sessionKey}`, true, {
+            session_key: sessionKey
+        });
+        this.name = 'SessionConflictError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClB,IAAI,CAAgB;IACpB,SAAS,CAAU;IACnB,OAAO,CAAyB;IAEhD,YAAmB,IAAmB,EAAE,OAAe,EAAE,SAAkB,EAAE,OAAoB;QAC/F,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAC7B,SAAS,CAAS;IAClB,WAAW,CAAS;IACpB,UAAU,CAAyB;IAEnD,YAAmB,SAAiB,EAAE,WAAmB,EAAE,UAAuB;QAChF,KAAK,CAAC,oBAAoB,EAAE,sBAAsB,SAAS,KAAK,WAAW,EAAE,EAAE,SAAS,KAAK,GAAG,EAAE;YAChG,UAAU,EAAE,SAAS;YACrB,WAAW;YACX,UAAU;SACX,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAC7C,YAAmB,UAAkB;QACnC,KAAK,CAAC,cAAc,EAAE,wCAAwC,UAAU,KAAK,EAAE,IAAI,EAAE;YACnF,WAAW,EAAE,UAAU;SACxB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,SAAS;IACjD,YAAmB,UAAkB;QACnC,KAAK,CAAC,kBAAkB,EAAE,4BAA4B,UAAU,EAAE,EAAE,IAAI,EAAE;YACxE,WAAW,EAAE,UAAU;SACxB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}

package/dist/fsm/session-manager.d.ts

@@ -0,0 +1,22 @@
+import type { JsonObject, MetricsCollector, SessionEnvelope, SessionStorage, VersionedValue } from '../types/core.js';
+export interface SessionManagerOptions<TState extends string, TData extends JsonObject> {
+    storage: SessionStorage<SessionEnvelope<TState, TData>>;
+    initialData: () => TData;
+    encryptionRequired?: boolean;
+    conflictRetries?: number;
+    metrics?: MetricsCollector;
+}
+export declare class SessionManager<TState extends string, TData extends JsonObject> {
+    private readonly storage;
+    private readonly initialData;
+    private readonly encryptionRequired;
+    private readonly conflictRetries;
+    private readonly metrics;
+    constructor(options: SessionManagerOptions<TState, TData>);
+    load(sessionKey: string): Promise<VersionedValue<SessionEnvelope<TState, TData>>>;
+    runInSession<TResult>(sessionKey: string, runner: (session: SessionEnvelope<TState, TData>) => Promise<TResult>): Promise<TResult>;
+    private createInitialSession;
+    private cloneSession;
+    private assertSecurity;
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/fsm/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../src/fsm/session-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEtH,MAAM,WAAW,qBAAqB,CAAC,MAAM,SAAS,MAAM,EAAE,KAAK,SAAS,UAAU;IACpF,OAAO,EAAE,cAAc,CAAC,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IACxD,WAAW,EAAE,MAAM,KAAK,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED,qBAAa,cAAc,CAAC,MAAM,SAAS,MAAM,EAAE,KAAK,SAAS,UAAU;IACzE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiD;IACzE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;IAC7C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;gBAEpC,OAAO,EAAE,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC;IAQnD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAwBjF,YAAY,CAAC,OAAO,EAC/B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,CAAC,OAAO,EAAE,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GACpE,OAAO,CAAC,OAAO,CAAC;IAwBnB,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,cAAc;CAKvB"}

package/dist/fsm/session-manager.js

@@ -0,0 +1,79 @@
+import { SessionConflictError } from '../core/errors.js';
+export class SessionManager {
+    storage;
+    initialData;
+    encryptionRequired;
+    conflictRetries;
+    metrics;
+    constructor(options) {
+        this.storage = options.storage;
+        this.initialData = options.initialData;
+        this.encryptionRequired = options.encryptionRequired ?? false;
+        this.conflictRetries = options.conflictRetries ?? 3;
+        this.metrics = options.metrics;
+    }
+    async load(sessionKey) {
+        const existing = await this.storage.getWithVersion(sessionKey);
+        if (existing) {
+            this.assertSecurity(existing.value);
+            return existing;
+        }
+        const created = this.createInitialSession();
+        const saved = await this.storage.compareAndSet(sessionKey, 0, created);
+        if (!saved.ok) {
+            this.metrics?.increment('session_conflict_count');
+            const fallback = await this.storage.getWithVersion(sessionKey);
+            if (fallback) {
+                return fallback;
+            }
+            throw new SessionConflictError(sessionKey);
+        }
+        return {
+            value: created,
+            version: created.version
+        };
+    }
+    async runInSession(sessionKey, runner) {
+        for (let attempt = 1; attempt <= this.conflictRetries + 1; attempt += 1) {
+            const current = await this.load(sessionKey);
+            const mutableSession = this.cloneSession(current.value);
+            const result = await runner(mutableSession);
+            this.assertSecurity(mutableSession);
+            mutableSession.version = current.version + 1;
+            mutableSession.updated_at = new Date().toISOString();
+            const save = await this.storage.compareAndSet(sessionKey, current.version, mutableSession);
+            if (save.ok) {
+                return result;
+            }
+            this.metrics?.increment('session_conflict_count');
+            if (attempt > this.conflictRetries) {
+                throw new SessionConflictError(sessionKey);
+            }
+        }
+        throw new SessionConflictError(sessionKey);
+    }
+    createInitialSession() {
+        return {
+            current_state: null,
+            data: this.initialData(),
+            version: 1,
+            encrypted: !this.encryptionRequired,
+            updated_at: new Date().toISOString()
+        };
+    }
+    cloneSession(session) {
+        return {
+            current_state: session.current_state,
+            data: { ...session.data },
+            version: session.version,
+            encrypted: session.encrypted,
+            updated_at: session.updated_at
+        };
+    }
+    assertSecurity(session) {
+        if (this.encryptionRequired && !session.encrypted) {
+            throw new Error('Session contains sensitive data and must be encrypted before saving.');
+        }
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/fsm/session-manager.js.map

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

package/dist/guards/bounded-concurrency.d.ts

@@ -0,0 +1,14 @@
+export declare class QueueOverflowError extends Error {
+    constructor(limit: number);
+}
+export declare class BoundedConcurrencyQueue {
+    private running;
+    private readonly waiters;
+    private readonly maxConcurrency;
+    private readonly maxQueue;
+    constructor(maxConcurrency: number, maxQueue: number);
+    run<T>(task: () => Promise<T>): Promise<T>;
+    private acquire;
+    private release;
+}
+//# sourceMappingURL=bounded-concurrency.d.ts.map

package/dist/guards/bounded-concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-concurrency.d.ts","sourceRoot":"","sources":["../../src/guards/bounded-concurrency.ts"],"names":[],"mappings":"AAAA,qBAAa,kBAAmB,SAAQ,KAAK;gBACxB,KAAK,EAAE,MAAM;CAIjC;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEf,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAK9C,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;YASzC,OAAO;IAkBrB,OAAO,CAAC,OAAO;CAOhB"}

package/dist/guards/bounded-concurrency.js

@@ -0,0 +1,48 @@
+export class QueueOverflowError extends Error {
+    constructor(limit) {
+        super(`Concurrency queue is full (limit=${limit})`);
+        this.name = 'QueueOverflowError';
+    }
+}
+export class BoundedConcurrencyQueue {
+    running = 0;
+    waiters = [];
+    maxConcurrency;
+    maxQueue;
+    constructor(maxConcurrency, maxQueue) {
+        this.maxConcurrency = maxConcurrency;
+        this.maxQueue = maxQueue;
+    }
+    async run(task) {
+        await this.acquire();
+        try {
+            return await task();
+        }
+        finally {
+            this.release();
+        }
+    }
+    async acquire() {
+        if (this.running < this.maxConcurrency) {
+            this.running += 1;
+            return;
+        }
+        if (this.waiters.length >= this.maxQueue) {
+            throw new QueueOverflowError(this.maxQueue);
+        }
+        await new Promise((resolve) => {
+            this.waiters.push(() => {
+                this.running += 1;
+                resolve();
+            });
+        });
+    }
+    release() {
+        this.running = Math.max(0, this.running - 1);
+        const next = this.waiters.shift();
+        if (next) {
+            next();
+        }
+    }
+}
+//# sourceMappingURL=bounded-concurrency.js.map

package/dist/guards/bounded-concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-concurrency.js","sourceRoot":"","sources":["../../src/guards/bounded-concurrency.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAmB,KAAa;QAC9B,KAAK,CAAC,oCAAoC,KAAK,GAAG,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,uBAAuB;IAC1B,OAAO,GAAG,CAAC,CAAC;IACH,OAAO,GAAsB,EAAE,CAAC;IAChC,cAAc,CAAS;IACvB,QAAQ,CAAS;IAElC,YAAmB,cAAsB,EAAE,QAAgB;QACzD,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAEM,KAAK,CAAC,GAAG,CAAI,IAAsB;QACxC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,EAAE,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,IAAI,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;YACvC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACzC,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE;gBACrB,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;gBAClB,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,OAAO;QACb,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAClC,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,EAAE,CAAC;QACT,CAAC;IACH,CAAC;CACF"}

package/dist/guards/token-bucket-rate-limiter.d.ts

@@ -0,0 +1,11 @@
+export interface RateLimitConfig {
+    capacity: number;
+    refillPerSecond: number;
+}
+export declare class TokenBucketRateLimiter {
+    private readonly config;
+    private readonly buckets;
+    constructor(config: RateLimitConfig);
+    allow(key: string, nowMs?: number): boolean;
+}
+//# sourceMappingURL=token-bucket-rate-limiter.d.ts.map

package/dist/guards/token-bucket-rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-bucket-rate-limiter.d.ts","sourceRoot":"","sources":["../../src/guards/token-bucket-rate-limiter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAOD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;gBAEvC,MAAM,EAAE,eAAe;IAInC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAa,GAAG,OAAO;CAsBvD"}

package/dist/guards/token-bucket-rate-limiter.js

@@ -0,0 +1,27 @@
+export class TokenBucketRateLimiter {
+    config;
+    buckets = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    allow(key, nowMs = Date.now()) {
+        const state = this.buckets.get(key) ?? {
+            tokens: this.config.capacity,
+            lastRefillMs: nowMs
+        };
+        const elapsedSec = (nowMs - state.lastRefillMs) / 1000;
+        const refilled = Math.min(this.config.capacity, state.tokens + elapsedSec * this.config.refillPerSecond);
+        const next = {
+            tokens: refilled,
+            lastRefillMs: nowMs
+        };
+        if (next.tokens < 1) {
+            this.buckets.set(key, next);
+            return false;
+        }
+        next.tokens -= 1;
+        this.buckets.set(key, next);
+        return true;
+    }
+}
+//# sourceMappingURL=token-bucket-rate-limiter.js.map

package/dist/guards/token-bucket-rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-bucket-rate-limiter.js","sourceRoot":"","sources":["../../src/guards/token-bucket-rate-limiter.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,sBAAsB;IAChB,MAAM,CAAkB;IACxB,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE1D,YAAmB,MAAuB;QACxC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAEM,KAAK,CAAC,GAAW,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI;YACrC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;YAC5B,YAAY,EAAE,KAAK;SACpB,CAAC;QAEF,MAAM,UAAU,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;QACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACzG,MAAM,IAAI,GAAgB;YACxB,MAAM,EAAE,QAAQ;YAChB,YAAY,EAAE,KAAK;SACpB,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC5B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QACjB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+export { ApiClient } from './core/api-client.js';
+export { BotKernel } from './core/bot-kernel.js';
+export { Context } from './core/context.js';
+export { CircuitBreaker } from './core/circuit-breaker.js';
+export { CircuitOpenError, CoreError, SessionConflictError, TelegramApiError } from './core/errors.js';
+export { TokenBucketRateLimiter } from './guards/token-bucket-rate-limiter.js';
+export { BoundedConcurrencyQueue, QueueOverflowError } from './guards/bounded-concurrency.js';
+export { EcsJsonLogger } from './observability/ecs-logger.js';
+export { InMemoryMetrics } from './observability/metrics.js';
+export { createSessionKey, createSessionNamespace } from './tenant/key-namespace.js';
+export { SessionManager } from './fsm/session-manager.js';
+export { TreeRouter } from './router/router.js';
+export { BotRuntime } from './runtime/bot-runtime.js';
+export { MemorySessionStorage } from './storage/memory-session-storage.js';
+export { RedisSessionStorage } from './storage/redis-session-storage.js';
+export { PollingSource } from './update-loop/polling.js';
+export { WebhookSource } from './update-loop/webhook.js';
+export { isFreshUpdate, isValidTelegramUpdate } from './update-loop/update-validator.js';
+export { AwsLambdaHandler } from './adapters/aws-lambda-handler.js';
+export { CloudflareWorkerHandler } from './adapters/cloudflare-worker-handler.js';
+export { NodeHttpHandler } from './adapters/node-http-handler.js';
+export { WebhookHandler } from './adapters/webhook-handler.js';
+export type { ApiClientOptions, CasResult, CircuitBreakerOptions, ContextShortcuts, Handler, JsonObject, JsonValue, LogEvent, Logger, MetricsCollector, PollingOptions, RetryOptions, RouteCandidate, SessionEnvelope, SessionStorage, UpdateSource, VersionedValue, WebhookHandlerOptions, WebhookRequest, WebhookResponse } from './types/core.js';
+export type { ApiGatewayV2Event, ApiGatewayV2Response } from './adapters/aws-lambda-handler.js';
+export type { RedisLikeClient, RedisLikeTransaction, SessionCrypto } from './storage/redis-session-storage.js';
+export type { ApiMethods, CallbackQuery, Chat, Message, Update, User } from './types/telegram.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACvG,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,YAAY,EACV,gBAAgB,EAChB,SAAS,EACT,qBAAqB,EACrB,gBAAgB,EAChB,OAAO,EACP,UAAU,EACV,SAAS,EACT,QAAQ,EACR,MAAM,EACN,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,eAAe,EACf,cAAc,EACd,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,eAAe,EAChB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAEhG,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAE/G,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+export { ApiClient } from './core/api-client.js';
+export { BotKernel } from './core/bot-kernel.js';
+export { Context } from './core/context.js';
+export { CircuitBreaker } from './core/circuit-breaker.js';
+export { CircuitOpenError, CoreError, SessionConflictError, TelegramApiError } from './core/errors.js';
+export { TokenBucketRateLimiter } from './guards/token-bucket-rate-limiter.js';
+export { BoundedConcurrencyQueue, QueueOverflowError } from './guards/bounded-concurrency.js';
+export { EcsJsonLogger } from './observability/ecs-logger.js';
+export { InMemoryMetrics } from './observability/metrics.js';
+export { createSessionKey, createSessionNamespace } from './tenant/key-namespace.js';
+export { SessionManager } from './fsm/session-manager.js';
+export { TreeRouter } from './router/router.js';
+export { BotRuntime } from './runtime/bot-runtime.js';
+export { MemorySessionStorage } from './storage/memory-session-storage.js';
+export { RedisSessionStorage } from './storage/redis-session-storage.js';
+export { PollingSource } from './update-loop/polling.js';
+export { WebhookSource } from './update-loop/webhook.js';
+export { isFreshUpdate, isValidTelegramUpdate } from './update-loop/update-validator.js';
+export { AwsLambdaHandler } from './adapters/aws-lambda-handler.js';
+export { CloudflareWorkerHandler } from './adapters/cloudflare-worker-handler.js';
+export { NodeHttpHandler } from './adapters/node-http-handler.js';
+export { WebhookHandler } from './adapters/webhook-handler.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACvG,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/observability/ecs-logger.d.ts

@@ -0,0 +1,18 @@
+import type { LogEvent, Logger } from '../types/core.js';
+export interface EcsContext {
+    serviceName: string;
+    tenantId?: string;
+    botId?: string;
+}
+export interface LogSink {
+    write(line: string): void;
+}
+export declare class EcsJsonLogger implements Logger {
+    private readonly context;
+    private readonly sink;
+    constructor(context: EcsContext, sink: LogSink);
+    log(event: LogEvent): void;
+    private toFlatData;
+    private stripUndefined;
+}
+//# sourceMappingURL=ecs-logger.d.ts.map

package/dist/observability/ecs-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecs-logger.d.ts","sourceRoot":"","sources":["../../src/observability/ecs-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAErE,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,qBAAa,aAAc,YAAW,MAAM;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;gBAEZ,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO;IAK9C,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAgBjC,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,cAAc;CASvB"}

package/dist/observability/ecs-logger.js

@@ -0,0 +1,42 @@
+export class EcsJsonLogger {
+    context;
+    sink;
+    constructor(context, sink) {
+        this.context = context;
+        this.sink = sink;
+    }
+    log(event) {
+        const payload = {
+            '@timestamp': event.timestamp,
+            'log.level': event.level,
+            message: event.event,
+            'service.name': this.context.serviceName,
+            'event.action': event.event,
+            'labels.tenant_id': this.context.tenantId,
+            'labels.bot_id': this.context.botId,
+            'labels.request_id': event.requestId,
+            ...this.toFlatData(event.data)
+        };
+        this.sink.write(JSON.stringify(this.stripUndefined(payload)));
+    }
+    toFlatData(data) {
+        if (!data) {
+            return {};
+        }
+        const out = {};
+        for (const [key, value] of Object.entries(data)) {
+            out[`labels.${key}`] = value;
+        }
+        return out;
+    }
+    stripUndefined(input) {
+        const out = {};
+        for (const [key, value] of Object.entries(input)) {
+            if (value !== undefined) {
+                out[key] = value;
+            }
+        }
+        return out;
+    }
+}
+//# sourceMappingURL=ecs-logger.js.map

package/dist/observability/ecs-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecs-logger.js","sourceRoot":"","sources":["../../src/observability/ecs-logger.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,aAAa;IACP,OAAO,CAAa;IACpB,IAAI,CAAU;IAE/B,YAAmB,OAAmB,EAAE,IAAa;QACnD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAEM,GAAG,CAAC,KAAe;QACxB,MAAM,OAAO,GAA4B;YACvC,YAAY,EAAE,KAAK,CAAC,SAAS;YAC7B,WAAW,EAAE,KAAK,CAAC,KAAK;YACxB,OAAO,EAAE,KAAK,CAAC,KAAK;YACpB,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,WAAW;YACxC,cAAc,EAAE,KAAK,CAAC,KAAK;YAC3B,kBAAkB,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;YACzC,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;YACnC,mBAAmB,EAAE,KAAK,CAAC,SAAS;YACpC,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;SAC/B,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC;IAEO,UAAU,CAAC,IAAiB;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,GAAG,CAAC,UAAU,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC;QAC/B,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,cAAc,CAAC,KAA8B;QACnD,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACnB,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}