@jilimb0/tgwrapper 0.4.0

package/README.md

@@ -0,0 +1,38 @@
+# Framework Core
+
+Production-grade Telegram Bot Framework with serverless-first architecture, native FSM, optimistic locking, and ecosystem packages.
+
+## Packages
+
+- `@jilimb0/tgwrapper` - framework kernel, transport, router, FSM, adapters
+- `@jilimb0/tgwrapper-adapter-redis` - ioredis-backed atomic session storage
+- `@jilimb0/tgwrapper-observability` - ECS JSON logger and metrics helpers
+
+## Quick start
+
+```bash
+pnpm install
+pnpm test
+pnpm build
+```
+
+## Integration tests (Redis)
+
+```bash
+docker compose -f docker-compose.redis.yml up -d
+REDIS_URL=redis://127.0.0.1:6379 pnpm test:integration
+```
+
+## Deploy examples
+
+- Node HTTP: `pnpm --dir examples/node-http dev`
+- AWS Lambda: `pnpm --dir examples/aws-lambda deploy`
+- Cloudflare Worker: `pnpm --dir examples/cloudflare-worker deploy`
+
+All examples require env vars (`BOT_TOKEN`, `WEBHOOK_SECRET`) and do not hardcode secrets.
+
+## Release
+
+Releases are CI-gated only via Changesets workflow.
+Manual local publishing is not part of supported flow.
+See `/Users/jilimbo/Documents/Personal/TGWrapper/docs/RELEASE_POLICY.md` for semver and process details.

package/dist/adapters/aws-lambda-handler.d.ts

@@ -0,0 +1,29 @@
+import { WebhookHandler } from './webhook-handler.js';
+export interface ApiGatewayV2Event {
+    version: string;
+    routeKey: string;
+    rawPath: string;
+    rawQueryString: string;
+    headers?: Record<string, string>;
+    requestContext: {
+        http: {
+            method: string;
+            path: string;
+        };
+    };
+    body?: string;
+    isBase64Encoded: boolean;
+}
+export interface ApiGatewayV2Response {
+    statusCode: number;
+    headers?: Record<string, string>;
+    body: string;
+}
+export declare class AwsLambdaHandler {
+    private readonly handler;
+    constructor(handler: WebhookHandler);
+    handle(event: ApiGatewayV2Event): Promise<ApiGatewayV2Response>;
+    private normalizeHeaders;
+    private decodeBase64;
+}
+//# sourceMappingURL=aws-lambda-handler.d.ts.map

package/dist/adapters/aws-lambda-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws-lambda-handler.d.ts","sourceRoot":"","sources":["../../src/adapters/aws-lambda-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,cAAc,EAAE;QACd,IAAI,EAAE;YACJ,MAAM,EAAE,MAAM,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;gBAEtB,OAAO,EAAE,cAAc;IAI7B,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsB5E,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,YAAY;CAOrB"}

package/dist/adapters/aws-lambda-handler.js

@@ -0,0 +1,39 @@
+export class AwsLambdaHandler {
+    handler;
+    constructor(handler) {
+        this.handler = handler;
+    }
+    async handle(event) {
+        const rawBody = event.body
+            ? event.isBase64Encoded
+                ? this.decodeBase64(event.body)
+                : event.body
+            : '';
+        const request = {
+            method: event.requestContext.http.method,
+            headers: this.normalizeHeaders(event.headers ?? {}),
+            rawBody,
+            path: event.rawPath
+        };
+        const response = await this.handler.handle(request);
+        return {
+            statusCode: response.status,
+            headers: response.headers,
+            body: response.body
+        };
+    }
+    normalizeHeaders(headers) {
+        const normalized = {};
+        for (const [key, value] of Object.entries(headers)) {
+            normalized[key.toLowerCase()] = value;
+        }
+        return normalized;
+    }
+    decodeBase64(value) {
+        if (typeof atob === 'function') {
+            return atob(value);
+        }
+        throw new Error('Base64 decoding is not available in this runtime.');
+    }
+}
+//# sourceMappingURL=aws-lambda-handler.js.map

package/dist/adapters/aws-lambda-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aws-lambda-handler.js","sourceRoot":"","sources":["../../src/adapters/aws-lambda-handler.ts"],"names":[],"mappings":"AAyBA,MAAM,OAAO,gBAAgB;IACV,OAAO,CAAiB;IAEzC,YAAmB,OAAuB;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,KAAwB;QAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI;YACxB,CAAC,CAAC,KAAK,CAAC,eAAe;gBACrB,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC;gBAC/B,CAAC,CAAC,KAAK,CAAC,IAAI;YACd,CAAC,CAAC,EAAE,CAAC;QAEP,MAAM,OAAO,GAAmB;YAC9B,MAAM,EAAE,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM;YACxC,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;YACnD,OAAO;YACP,IAAI,EAAE,KAAK,CAAC,OAAO;SACpB,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpD,OAAO;YACL,UAAU,EAAE,QAAQ,CAAC,MAAM;YAC3B,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,IAAI,EAAE,QAAQ,CAAC,IAAI;SACpB,CAAC;IACJ,CAAC;IAEO,gBAAgB,CAAC,OAA+B;QACtD,MAAM,UAAU,GAAuC,EAAE,CAAC;QAC1D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC;QACxC,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAEO,YAAY,CAAC,KAAa;QAChC,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;CACF"}

package/dist/adapters/cloudflare-worker-handler.d.ts

@@ -0,0 +1,7 @@
+import { WebhookHandler } from './webhook-handler.js';
+export declare class CloudflareWorkerHandler {
+    private readonly handler;
+    constructor(handler: WebhookHandler);
+    handle(request: Request): Promise<Response>;
+}
+//# sourceMappingURL=cloudflare-worker-handler.d.ts.map

package/dist/adapters/cloudflare-worker-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare-worker-handler.d.ts","sourceRoot":"","sources":["../../src/adapters/cloudflare-worker-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;gBAEtB,OAAO,EAAE,cAAc;IAI7B,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;CAmBzD"}

package/dist/adapters/cloudflare-worker-handler.js

@@ -0,0 +1,24 @@
+export class CloudflareWorkerHandler {
+    handler;
+    constructor(handler) {
+        this.handler = handler;
+    }
+    async handle(request) {
+        const headers = {};
+        request.headers.forEach((value, key) => {
+            headers[key] = value;
+        });
+        const mapped = {
+            method: request.method,
+            headers,
+            rawBody: await request.text(),
+            path: new URL(request.url).pathname
+        };
+        const response = await this.handler.handle(mapped);
+        return new Response(response.body, {
+            status: response.status,
+            headers: response.headers
+        });
+    }
+}
+//# sourceMappingURL=cloudflare-worker-handler.js.map

package/dist/adapters/cloudflare-worker-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare-worker-handler.js","sourceRoot":"","sources":["../../src/adapters/cloudflare-worker-handler.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,uBAAuB;IACjB,OAAO,CAAiB;IAEzC,YAAmB,OAAuB;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,OAAgB;QAClC,MAAM,OAAO,GAAuC,EAAE,CAAC;QACvD,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACrC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAmB;YAC7B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO;YACP,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,EAAE;YAC7B,IAAI,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ;SACpC,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnD,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE;YACjC,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;SAC1B,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/adapters/node-http-handler.d.ts

@@ -0,0 +1,20 @@
+import { WebhookHandler } from './webhook-handler.js';
+export interface NodeLikeIncomingMessage {
+    method?: string;
+    headers: Record<string, string | string[] | undefined>;
+    on(event: 'data', listener: (chunk: unknown) => void): void;
+    on(event: 'end', listener: () => void): void;
+    on(event: 'error', listener: (error: Error) => void): void;
+}
+export interface NodeLikeServerResponse {
+    statusCode: number;
+    setHeader(name: string, value: string): void;
+    end(body?: string): void;
+}
+export declare class NodeHttpHandler {
+    private readonly handler;
+    constructor(handler: WebhookHandler);
+    handle(req: NodeLikeIncomingMessage, res: NodeLikeServerResponse): Promise<void>;
+    private toChunkString;
+}
+//# sourceMappingURL=node-http-handler.d.ts.map

package/dist/adapters/node-http-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-http-handler.d.ts","sourceRoot":"","sources":["../../src/adapters/node-http-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACvD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IAC5D,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC7C,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;CAC5D;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;gBAEtB,OAAO,EAAE,cAAc;IAI7B,MAAM,CAAC,GAAG,EAAE,uBAAuB,EAAE,GAAG,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B7F,OAAO,CAAC,aAAa;CAWtB"}

package/dist/adapters/node-http-handler.js

@@ -0,0 +1,41 @@
+export class NodeHttpHandler {
+    handler;
+    constructor(handler) {
+        this.handler = handler;
+    }
+    async handle(req, res) {
+        const chunks = [];
+        await new Promise((resolve, reject) => {
+            req.on('data', (chunk) => {
+                chunks.push(this.toChunkString(chunk));
+            });
+            req.on('end', () => resolve());
+            req.on('error', (error) => reject(error));
+        });
+        const headers = {};
+        for (const [key, value] of Object.entries(req.headers)) {
+            headers[key] = Array.isArray(value) ? value[0] : value;
+        }
+        const request = {
+            method: req.method ?? 'GET',
+            headers,
+            rawBody: chunks.join('')
+        };
+        const response = await this.handler.handle(request);
+        res.statusCode = response.status;
+        for (const [header, value] of Object.entries(response.headers)) {
+            res.setHeader(header, value);
+        }
+        res.end(response.body);
+    }
+    toChunkString(chunk) {
+        if (typeof chunk === 'string') {
+            return chunk;
+        }
+        if (chunk instanceof Uint8Array) {
+            return new TextDecoder().decode(chunk);
+        }
+        return String(chunk);
+    }
+}
+//# sourceMappingURL=node-http-handler.js.map

package/dist/adapters/node-http-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-http-handler.js","sourceRoot":"","sources":["../../src/adapters/node-http-handler.ts"],"names":[],"mappings":"AAiBA,MAAM,OAAO,eAAe;IACT,OAAO,CAAiB;IAEzC,YAAmB,OAAuB;QACxC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,GAA4B,EAAE,GAA2B;QAC3E,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAc,EAAE,EAAE;gBAChC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;YACzC,CAAC,CAAC,CAAC;YACH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/B,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAuC,EAAE,CAAC;QACvD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACvD,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACzD,CAAC;QAED,MAAM,OAAO,GAAmB;YAC9B,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,KAAK;YAC3B,OAAO;YACP,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;SACzB,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpD,GAAG,CAAC,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC;QACjC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/D,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAEO,aAAa,CAAC,KAAc;QAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;YAChC,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;CACF"}

package/dist/adapters/webhook-handler.d.ts

@@ -0,0 +1,14 @@
+import type { WebhookHandlerOptions, WebhookRequest, WebhookResponse } from '../types/core.js';
+import type { Update } from '../types/telegram.js';
+export interface UpdateHandler {
+    handleUpdate(update: Update): Promise<void>;
+}
+export declare class WebhookHandler {
+    private readonly options;
+    private readonly updateHandler;
+    constructor(updateHandler: UpdateHandler, options: WebhookHandlerOptions);
+    handle(request: WebhookRequest): Promise<WebhookResponse>;
+    private response;
+    private readHeader;
+}
+//# sourceMappingURL=webhook-handler.d.ts.map

package/dist/adapters/webhook-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-handler.d.ts","sourceRoot":"","sources":["../../src/adapters/webhook-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGnD,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAE3B,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,qBAAqB;IAQlE,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IA+BtE,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,UAAU;CAGnB"}

package/dist/adapters/webhook-handler.js

@@ -0,0 +1,54 @@
+import { CoreError } from '../core/errors.js';
+import { isValidTelegramUpdate } from '../update-loop/update-validator.js';
+export class WebhookHandler {
+    options;
+    updateHandler;
+    constructor(updateHandler, options) {
+        this.updateHandler = updateHandler;
+        this.options = {
+            secretToken: options.secretToken,
+            secretHeader: options.secretHeader ?? 'x-telegram-bot-api-secret-token'
+        };
+    }
+    async handle(request) {
+        if (request.method.toUpperCase() !== 'POST') {
+            return this.response(405, { error: 'method_not_allowed' });
+        }
+        const headerValue = this.readHeader(request.headers, this.options.secretHeader);
+        if (!headerValue || headerValue !== this.options.secretToken) {
+            return this.response(401, { error: 'invalid_signature' });
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(request.rawBody);
+        }
+        catch {
+            return this.response(400, { error: 'invalid_json' });
+        }
+        if (!isValidTelegramUpdate(parsed)) {
+            return this.response(400, { error: 'invalid_update' });
+        }
+        try {
+            await this.updateHandler.handleUpdate(parsed);
+            return this.response(200, { ok: true });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'unknown';
+            const code = error instanceof CoreError ? error.code : 'INTERNAL';
+            return this.response(500, { error: 'handler_failed', code, message });
+        }
+    }
+    response(status, body) {
+        return {
+            status,
+            headers: {
+                'content-type': 'application/json; charset=utf-8'
+            },
+            body: JSON.stringify(body)
+        };
+    }
+    readHeader(headers, name) {
+        return headers[name] ?? headers[name.toLowerCase()] ?? headers[name.toUpperCase()];
+    }
+}
+//# sourceMappingURL=webhook-handler.js.map

package/dist/adapters/webhook-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-handler.js","sourceRoot":"","sources":["../../src/adapters/webhook-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAM3E,MAAM,OAAO,cAAc;IACR,OAAO,CAAkC;IACzC,aAAa,CAAgB;IAE9C,YAAmB,aAA4B,EAAE,OAA8B;QAC7E,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG;YACb,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,iCAAiC;SACxE,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,OAAuB;QACzC,IAAI,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;YAC5C,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAChF,IAAI,CAAC,WAAW,IAAI,WAAW,KAAK,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAC9C,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;YACnE,MAAM,IAAI,GAAG,KAAK,YAAY,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC;YAClE,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAEO,QAAQ,CAAC,MAAc,EAAE,IAA6B;QAC5D,OAAO;YACL,MAAM;YACN,OAAO,EAAE;gBACP,cAAc,EAAE,iCAAiC;aAClD;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC;IACJ,CAAC;IAEO,UAAU,CAAC,OAA2C,EAAE,IAAY;QAC1E,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACrF,CAAC;CACF"}

package/dist/core/api-client.d.ts

@@ -0,0 +1,18 @@
+import type { ApiClientOptions, JsonObject } from '../types/core.js';
+export declare class ApiClient {
+    private readonly token;
+    private readonly baseUrl;
+    private readonly logger?;
+    private readonly metrics?;
+    private readonly retry;
+    private readonly fetchImpl;
+    private readonly mockResponder?;
+    private readonly circuitBreaker;
+    constructor(options: ApiClientOptions);
+    callApi<TResponse>(method: string, payload: JsonObject): Promise<TResponse>;
+    private executeRequest;
+    private isRetryable;
+    private resolveRetryDelay;
+    private delay;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/core/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/core/api-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAgB,MAAM,kBAAkB,CAAC;AASnF,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAoC;IACnE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;gBAE7B,OAAO,EAAE,gBAAgB;IAW/B,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;YAgE1E,cAAc;IAsC5B,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,iBAAiB;YAkBX,KAAK;CAKpB"}

package/dist/core/api-client.js

@@ -0,0 +1,139 @@
+import { CircuitBreaker } from './circuit-breaker.js';
+import { CircuitOpenError, CoreError, TelegramApiError } from './errors.js';
+const DEFAULT_RETRY = {
+    maxRetries: 3,
+    baseDelayMs: 300,
+    maxDelayMs: 5_000,
+    jitterRatio: 0.2
+};
+export class ApiClient {
+    token;
+    baseUrl;
+    logger;
+    metrics;
+    retry;
+    fetchImpl;
+    mockResponder;
+    circuitBreaker;
+    constructor(options) {
+        this.token = options.token;
+        this.baseUrl = options.baseUrl ?? 'https://api.telegram.org';
+        this.logger = options.logger;
+        this.metrics = options.metrics;
+        this.retry = { ...DEFAULT_RETRY, ...options.retry };
+        this.fetchImpl = options.fetchImpl ?? fetch;
+        this.mockResponder = options.mockResponder;
+        this.circuitBreaker = new CircuitBreaker(options.circuitBreaker);
+    }
+    async callApi(method, payload) {
+        const requestId = crypto.randomUUID();
+        const started = Date.now();
+        for (let attempt = 1; attempt <= this.retry.maxRetries + 1; attempt += 1) {
+            try {
+                this.circuitBreaker.beforeRequest(Date.now());
+                const response = await this.executeRequest(method, payload);
+                const durationMs = Date.now() - started;
+                this.circuitBreaker.onSuccess();
+                this.metrics?.observe('telegram_api_latency_ms', durationMs, { method });
+                this.logger?.log({
+                    level: 'info',
+                    event: 'telegram_api_call_success',
+                    timestamp: new Date().toISOString(),
+                    requestId,
+                    data: {
+                        method,
+                        attempt,
+                        duration_ms: durationMs
+                    }
+                });
+                return response;
+            }
+            catch (error) {
+                if (error instanceof CircuitOpenError) {
+                    this.metrics?.increment('circuit_breaker_open_count', 1, { method });
+                }
+                else {
+                    this.circuitBreaker.onFailure(Date.now());
+                }
+                const retryDelay = this.resolveRetryDelay(error, attempt);
+                const shouldRetry = retryDelay !== null && attempt <= this.retry.maxRetries;
+                if (shouldRetry) {
+                    this.metrics?.increment('transport_retries', 1, { method });
+                }
+                this.logger?.log({
+                    level: 'error',
+                    event: 'telegram_api_call_error',
+                    timestamp: new Date().toISOString(),
+                    requestId,
+                    data: {
+                        method,
+                        attempt,
+                        duration_ms: Date.now() - started,
+                        retry_ms: retryDelay ?? 0,
+                        retrying: shouldRetry,
+                        message: error instanceof Error ? error.message : 'unknown'
+                    }
+                });
+                if (!shouldRetry) {
+                    throw error;
+                }
+                await this.delay(retryDelay);
+            }
+        }
+        throw new CoreError('NETWORK_ERROR', 'Unexpected retry loop state', false);
+    }
+    async executeRequest(method, payload) {
+        if (this.mockResponder) {
+            return this.mockResponder(method, payload);
+        }
+        let response;
+        try {
+            response = await this.fetchImpl(`${this.baseUrl}/bot${this.token}/${method}`, {
+                method: 'POST',
+                headers: {
+                    'content-type': 'application/json'
+                },
+                body: JSON.stringify(payload)
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown network error';
+            throw new CoreError('NETWORK_ERROR', message, true);
+        }
+        const body = (await response.json());
+        if (!body.ok) {
+            throw new TelegramApiError(body.error_code ?? response.status, body.description ?? 'Unknown error', body.parameters);
+        }
+        if (!('result' in body)) {
+            throw new CoreError('VALIDATION_ERROR', 'Telegram API response has no result field.', false);
+        }
+        return body.result;
+    }
+    isRetryable(error) {
+        if (error instanceof CoreError) {
+            return error.retryable;
+        }
+        return false;
+    }
+    resolveRetryDelay(error, attempt) {
+        if (error instanceof TelegramApiError && error.errorCode === 429) {
+            const retryAfter = error.parameters?.retry_after;
+            if (typeof retryAfter === 'number') {
+                return retryAfter * 1000;
+            }
+        }
+        if (this.isRetryable(error)) {
+            const exponential = this.retry.baseDelayMs * Math.pow(2, attempt - 1);
+            const bounded = Math.min(exponential, this.retry.maxDelayMs);
+            const jitterFactor = 1 + (Math.random() * 2 - 1) * this.retry.jitterRatio;
+            return Math.max(0, Math.floor(bounded * jitterFactor));
+        }
+        return null;
+    }
+    async delay(ms) {
+        await new Promise((resolve) => {
+            setTimeout(resolve, ms);
+        });
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/core/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../src/core/api-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG5E,MAAM,aAAa,GAAiB;IAClC,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,GAAG;IAChB,UAAU,EAAE,KAAK;IACjB,WAAW,EAAE,GAAG;CACjB,CAAC;AAEF,MAAM,OAAO,SAAS;IACH,KAAK,CAAS;IACd,OAAO,CAAS;IAChB,MAAM,CAA8B;IACpC,OAAO,CAA+B;IACtC,KAAK,CAAe;IACpB,SAAS,CAAe;IACxB,aAAa,CAAqC;IAClD,cAAc,CAAiB;IAEhD,YAAmB,OAAyB;QAC1C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,0BAA0B,CAAC;QAC7D,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;QACpD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;QAC5C,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC3C,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACnE,CAAC;IAEM,KAAK,CAAC,OAAO,CAAY,MAAc,EAAE,OAAmB;QACjE,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE3B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;YACzE,IAAI,CAAC;gBACH,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;gBAC9C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAY,MAAM,EAAE,OAAO,CAAC,CAAC;gBACvE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;gBACxC,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,CAAC;gBAEhC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,yBAAyB,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;gBAEzE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC;oBACf,KAAK,EAAE,MAAM;oBACb,KAAK,EAAE,2BAA2B;oBAClC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,SAAS;oBACT,IAAI,EAAE;wBACJ,MAAM;wBACN,OAAO;wBACP,WAAW,EAAE,UAAU;qBACxB;iBACF,CAAC,CAAC;gBACH,OAAO,QAAQ,CAAC;YAClB,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,IAAI,KAAK,YAAY,gBAAgB,EAAE,CAAC;oBACtC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,4BAA4B,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;gBACvE,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;gBAC5C,CAAC;gBAED,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBAC1D,MAAM,WAAW,GAAG,UAAU,KAAK,IAAI,IAAI,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;gBAC5E,IAAI,WAAW,EAAE,CAAC;oBAChB,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,mBAAmB,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC9D,CAAC;gBAED,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC;oBACf,KAAK,EAAE,OAAO;oBACd,KAAK,EAAE,yBAAyB;oBAChC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,SAAS;oBACT,IAAI,EAAE;wBACJ,MAAM;wBACN,OAAO;wBACP,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;wBACjC,QAAQ,EAAE,UAAU,IAAI,CAAC;wBACzB,QAAQ,EAAE,WAAW;wBACrB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;qBAC5D;iBACF,CAAC,CAAC;gBAEH,IAAI,CAAC,WAAW,EAAE,CAAC;oBACjB,MAAM,KAAK,CAAC;gBACd,CAAC;gBAED,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QAED,MAAM,IAAI,SAAS,CAAC,eAAe,EAAE,6BAA6B,EAAE,KAAK,CAAC,CAAC;IAC7E,CAAC;IAEO,KAAK,CAAC,cAAc,CAAY,MAAc,EAAE,OAAmB;QACzE,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAuB,CAAC;QACnE,CAAC;QAED,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,OAAO,OAAO,IAAI,CAAC,KAAK,IAAI,MAAM,EAAE,EAAE;gBAC5E,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;aAC9B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC;YACjF,MAAM,IAAI,SAAS,CAAC,eAAe,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAMlC,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,IAAI,gBAAgB,CAAC,IAAI,CAAC,UAAU,IAAI,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,IAAI,eAAe,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACvH,CAAC;QAED,IAAI,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,SAAS,CAAC,kBAAkB,EAAE,4CAA4C,EAAE,KAAK,CAAC,CAAC;QAC/F,CAAC;QAED,OAAO,IAAI,CAAC,MAAmB,CAAC;IAClC,CAAC;IAEO,WAAW,CAAC,KAAc;QAChC,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC,SAAS,CAAC;QACzB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,iBAAiB,CAAC,KAAc,EAAE,OAAe;QACvD,IAAI,KAAK,YAAY,gBAAgB,IAAI,KAAK,CAAC,SAAS,KAAK,GAAG,EAAE,CAAC;YACjE,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,EAAE,WAAW,CAAC;YACjD,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;gBACnC,OAAO,UAAU,GAAG,IAAI,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;YACtE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC7D,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;YAC1E,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,EAAU;QAC5B,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC5B,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/core/bot-kernel.d.ts

@@ -0,0 +1,29 @@
+import { Context } from './context.js';
+import type { ApiClient } from './api-client.js';
+import type { JsonObject } from '../types/core.js';
+import type { SessionManager } from '../fsm/session-manager.js';
+import type { TreeRouter } from '../router/router.js';
+import type { Update } from '../types/telegram.js';
+interface BotKernelOptions<TState extends string, TData extends JsonObject> {
+    apiClient: ApiClient;
+    sessionManager: SessionManager<TState, TData>;
+    router: TreeRouter<Context<TState, TData>>;
+    resolveSessionKey: (update: Update) => string | null;
+    transitions?: Record<TState, readonly TState[]>;
+    onTransition?: (from: TState | null, to: TState, sessionKey: string) => Promise<void>;
+}
+export declare class BotKernel<TState extends string, TData extends JsonObject> {
+    private readonly apiClient;
+    private readonly sessionManager;
+    private readonly router;
+    private readonly resolveSessionKey;
+    private readonly transitions;
+    private readonly onTransition;
+    constructor(options: BotKernelOptions<TState, TData>);
+    handleUpdate(update: Update): Promise<void>;
+    private extractRoutingMeta;
+    private extractCommand;
+    private assertTransitionAllowed;
+}
+export {};
+//# sourceMappingURL=bot-kernel.d.ts.map

package/dist/core/bot-kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-kernel.d.ts","sourceRoot":"","sources":["../../src/core/bot-kernel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,UAAU,gBAAgB,CAAC,MAAM,SAAS,MAAM,EAAE,KAAK,SAAS,UAAU;IACxE,SAAS,EAAE,SAAS,CAAC;IACrB,cAAc,EAAE,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9C,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAC3C,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IAChD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvF;AAED,qBAAa,SAAS,CAAC,MAAM,SAAS,MAAM,EAAE,KAAK,SAAS,UAAU;IACpE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgC;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoC;IACtE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoC;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuF;gBAEjG,OAAO,EAAE,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC;IAS9C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDxD,OAAO,CAAC,kBAAkB;IA4B1B,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,uBAAuB;CAWhC"}

package/dist/core/bot-kernel.js

@@ -0,0 +1,99 @@
+import { Context } from './context.js';
+export class BotKernel {
+    apiClient;
+    sessionManager;
+    router;
+    resolveSessionKey;
+    transitions;
+    onTransition;
+    constructor(options) {
+        this.apiClient = options.apiClient;
+        this.sessionManager = options.sessionManager;
+        this.router = options.router;
+        this.resolveSessionKey = options.resolveSessionKey;
+        this.transitions = options.transitions ?? {};
+        this.onTransition = options.onTransition;
+    }
+    async handleUpdate(update) {
+        const sessionKey = this.resolveSessionKey(update);
+        if (!sessionKey) {
+            return;
+        }
+        await this.sessionManager.runInSession(sessionKey, async (session) => {
+            let ctxRef = null;
+            const ctx = new Context({
+                update,
+                session,
+                apiClient: this.apiClient,
+                sceneController: {
+                    enter: async (nextState) => {
+                        this.assertTransitionAllowed(session.current_state, nextState);
+                        const previous = session.current_state;
+                        const previousHooks = previous ? this.router.getSceneHooks(previous) : undefined;
+                        const nextHooks = this.router.getSceneHooks(nextState);
+                        if (previousHooks?.onLeave && ctxRef) {
+                            await previousHooks.onLeave(ctxRef);
+                        }
+                        session.current_state = nextState;
+                        if (nextHooks?.onEnter && ctxRef) {
+                            await nextHooks.onEnter(ctxRef);
+                        }
+                        if (this.onTransition) {
+                            await this.onTransition(previous, nextState, sessionKey);
+                        }
+                    },
+                    leave: async () => {
+                        const previous = session.current_state;
+                        const previousHooks = previous ? this.router.getSceneHooks(previous) : undefined;
+                        if (previousHooks?.onLeave && ctxRef) {
+                            await previousHooks.onLeave(ctxRef);
+                        }
+                        session.current_state = null;
+                    }
+                }
+            });
+            ctxRef = ctx;
+            await this.router.dispatch(Object.assign(ctx, this.extractRoutingMeta(ctx)));
+        });
+    }
+    extractRoutingMeta(ctx) {
+        const meta = {
+            currentState: ctx.session.current_state
+        };
+        const text = ctx.message?.text;
+        if (text !== undefined) {
+            meta.text = text;
+        }
+        const command = this.extractCommand(text, ctx.message?.entities);
+        if (command !== undefined) {
+            meta.command = command;
+        }
+        const callbackData = ctx.callbackQuery?.data;
+        if (callbackData !== undefined) {
+            meta.callbackData = callbackData;
+        }
+        return meta;
+    }
+    extractCommand(text, entities) {
+        if (!text || !entities) {
+            return undefined;
+        }
+        const commandEntity = entities.find((entity) => entity.type === 'bot_command' && entity.offset === 0);
+        if (!commandEntity) {
+            return undefined;
+        }
+        const raw = text.slice(0, commandEntity.length);
+        return raw.includes('@') ? raw.split('@')[0] : raw;
+    }
+    assertTransitionAllowed(from, to) {
+        if (!from) {
+            return;
+        }
+        const allowed = this.transitions[from];
+        if (!allowed || allowed.includes(to)) {
+            return;
+        }
+        throw new Error(`Transition from ${from} to ${to} is not allowed.`);
+    }
+}
+//# sourceMappingURL=bot-kernel.js.map

package/dist/core/bot-kernel.js.map

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

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

@@ -0,0 +1,19 @@
+import type { CircuitBreakerOptions } from '../types/core.js';
+type CircuitState = 'closed' | 'open' | 'half_open';
+export declare class CircuitBreaker {
+    private state;
+    private failures;
+    private openedAt;
+    private halfOpenRequests;
+    private readonly options;
+    constructor(options?: Partial<CircuitBreakerOptions>);
+    beforeRequest(nowMs: number): void;
+    onSuccess(): void;
+    onFailure(nowMs: number): void;
+    snapshot(): {
+        state: CircuitState;
+        failures: number;
+    };
+}
+export {};
+//# sourceMappingURL=circuit-breaker.d.ts.map