@jilimb0/tgwrapper 0.4.0

package/dist/observability/metrics.d.ts

@@ -0,0 +1,12 @@
+import type { MetricsCollector } from '../types/core.js';
+export declare class InMemoryMetrics implements MetricsCollector {
+    private readonly counters;
+    private readonly histograms;
+    increment(metric: string, value?: number): void;
+    observe(metric: string, value: number): void;
+    getCounter(metric: string): number;
+    latencyP50(metric: string): number;
+    latencyP95(metric: string): number;
+    private quantile;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/observability/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/observability/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAMzD,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IAE1D,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,IAAI;IAI1C,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAM5C,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIlC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIlC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIzC,OAAO,CAAC,QAAQ;CAUjB"}

package/dist/observability/metrics.js

@@ -0,0 +1,31 @@
+export class InMemoryMetrics {
+    counters = new Map();
+    histograms = new Map();
+    increment(metric, value = 1) {
+        this.counters.set(metric, (this.counters.get(metric) ?? 0) + value);
+    }
+    observe(metric, value) {
+        const bucket = this.histograms.get(metric) ?? { values: [] };
+        bucket.values.push(value);
+        this.histograms.set(metric, bucket);
+    }
+    getCounter(metric) {
+        return this.counters.get(metric) ?? 0;
+    }
+    latencyP50(metric) {
+        return this.quantile(metric, 0.5);
+    }
+    latencyP95(metric) {
+        return this.quantile(metric, 0.95);
+    }
+    quantile(metric, q) {
+        const bucket = this.histograms.get(metric);
+        if (!bucket || bucket.values.length === 0) {
+            return 0;
+        }
+        const sorted = [...bucket.values].sort((a, b) => a - b);
+        const index = Math.max(0, Math.min(sorted.length - 1, Math.floor((sorted.length - 1) * q)));
+        return sorted[index] ?? 0;
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/observability/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/observability/metrics.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,eAAe;IACT,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IACrC,UAAU,GAAG,IAAI,GAAG,EAA2B,CAAC;IAE1D,SAAS,CAAC,MAAc,EAAE,KAAK,GAAG,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;IACtE,CAAC;IAEM,OAAO,CAAC,MAAc,EAAE,KAAa;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAC7D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAEM,UAAU,CAAC,MAAc;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAEM,UAAU,CAAC,MAAc;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;IAEM,UAAU,CAAC,MAAc;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAEO,QAAQ,CAAC,MAAc,EAAE,CAAS;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1C,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACxD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5F,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;CACF"}

package/dist/router/router.d.ts

@@ -0,0 +1,30 @@
+import type { Handler, SceneHooks } from '../types/core.js';
+export interface Router<TContext> {
+    command(command: string, handler: Handler<TContext>, priority?: number): void;
+    regex(pattern: RegExp, handler: Handler<TContext>, priority?: number): void;
+    callbackData(pattern: RegExp, handler: Handler<TContext>, priority?: number): void;
+    state(state: string, handler: Handler<TContext>, priority?: number): void;
+    use(handler: Handler<TContext>, priority?: number): void;
+    scene(state: string, handlers: ReadonlyArray<Handler<TContext>>, hooks?: SceneHooks<TContext>, priority?: number): void;
+    getSceneHooks(state: string): SceneHooks<TContext> | undefined;
+    dispatch(ctx: TContext & RouterContextMeta): Promise<boolean>;
+}
+export interface RouterContextMeta {
+    command?: string;
+    text?: string;
+    callbackData?: string;
+    currentState?: string | null;
+}
+export declare class TreeRouter<TContext> implements Router<TContext> {
+    private readonly routes;
+    private readonly sceneHooks;
+    command(command: string, handler: Handler<TContext>, priority?: number): void;
+    regex(pattern: RegExp, handler: Handler<TContext>, priority?: number): void;
+    callbackData(pattern: RegExp, handler: Handler<TContext>, priority?: number): void;
+    state(state: string, handler: Handler<TContext>, priority?: number): void;
+    scene(state: string, handlers: ReadonlyArray<Handler<TContext>>, hooks?: SceneHooks<TContext>, priority?: number): void;
+    getSceneHooks(state: string): SceneHooks<TContext> | undefined;
+    use(handler: Handler<TContext>, priority?: number): void;
+    dispatch(ctx: TContext & RouterContextMeta): Promise<boolean>;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/router/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/router/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAkB,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE5E,MAAM,WAAW,MAAM,CAAC,QAAQ;IAC9B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9E,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5E,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnF,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1E,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzD,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;IAC/D,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,qBAAa,UAAU,CAAC,QAAQ,CAAE,YAAW,MAAM,CAAC,QAAQ,CAAC;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2D;IAClF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2C;IAE/D,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,QAAQ,SAAM,GAAG,IAAI;IAQ1E,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,QAAQ,SAAK,GAAG,IAAI;IAQvE,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,QAAQ,SAAK,GAAG,IAAI;IAQ9E,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,QAAQ,SAAM,GAAG,IAAI;IAQtE,KAAK,CACV,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAC1C,KAAK,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,EAC5B,QAAQ,SAAM,GACb,IAAI;IAUA,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,SAAS;IAI9D,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,QAAQ,SAAI,GAAG,IAAI;IAQ7C,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;CAa3E"}

package/dist/router/router.js

@@ -0,0 +1,62 @@
+export class TreeRouter {
+    routes = [];
+    sceneHooks = new Map();
+    command(command, handler, priority = 100) {
+        this.routes.push({
+            priority,
+            match: (ctx) => ctx.command === command,
+            handler: handler
+        });
+    }
+    regex(pattern, handler, priority = 50) {
+        this.routes.push({
+            priority,
+            match: (ctx) => typeof ctx.text === 'string' && pattern.test(ctx.text),
+            handler: handler
+        });
+    }
+    callbackData(pattern, handler, priority = 70) {
+        this.routes.push({
+            priority,
+            match: (ctx) => typeof ctx.callbackData === 'string' && pattern.test(ctx.callbackData),
+            handler: handler
+        });
+    }
+    state(state, handler, priority = 200) {
+        this.routes.push({
+            priority,
+            match: (ctx) => ctx.currentState === state,
+            handler: handler
+        });
+    }
+    scene(state, handlers, hooks, priority = 200) {
+        if (hooks) {
+            this.sceneHooks.set(state, hooks);
+        }
+        handlers.forEach((handler, index) => {
+            this.state(state, handler, priority - index);
+        });
+    }
+    getSceneHooks(state) {
+        return this.sceneHooks.get(state);
+    }
+    use(handler, priority = 0) {
+        this.routes.push({
+            priority,
+            match: () => true,
+            handler: handler
+        });
+    }
+    async dispatch(ctx) {
+        const sorted = [...this.routes].sort((a, b) => b.priority - a.priority);
+        for (const route of sorted) {
+            if (!route.match(ctx)) {
+                continue;
+            }
+            await route.handler(ctx);
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/router/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/router/router.ts"],"names":[],"mappings":"AAoBA,MAAM,OAAO,UAAU;IACJ,MAAM,GAAwD,EAAE,CAAC;IACjE,UAAU,GAAG,IAAI,GAAG,EAAgC,CAAC;IAE/D,OAAO,CAAC,OAAe,EAAE,OAA0B,EAAE,QAAQ,GAAG,GAAG;QACxE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,QAAQ;YACR,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,OAAO;YACvC,OAAO,EAAE,OAAgD;SAC1D,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,OAA0B,EAAE,QAAQ,GAAG,EAAE;QACrE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,QAAQ;YACR,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YACtE,OAAO,EAAE,OAAgD;SAC1D,CAAC,CAAC;IACL,CAAC;IAEM,YAAY,CAAC,OAAe,EAAE,OAA0B,EAAE,QAAQ,GAAG,EAAE;QAC5E,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,QAAQ;YACR,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC;YACtF,OAAO,EAAE,OAAgD;SAC1D,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,KAAa,EAAE,OAA0B,EAAE,QAAQ,GAAG,GAAG;QACpE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,QAAQ;YACR,KAAK,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,KAAK,KAAK;YAC1C,OAAO,EAAE,OAAgD;SAC1D,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CACV,KAAa,EACb,QAA0C,EAC1C,KAA4B,EAC5B,QAAQ,GAAG,GAAG;QAEd,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACpC,CAAC;QAED,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;YAClC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,GAAG,KAAK,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,aAAa,CAAC,KAAa;QAChC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAEM,GAAG,CAAC,OAA0B,EAAE,QAAQ,GAAG,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,QAAQ;YACR,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI;YACjB,OAAO,EAAE,OAAgD;SAC1D,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,QAAQ,CAAC,GAAiC;QACrD,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;QACxE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtB,SAAS;YACX,CAAC;YAED,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACzB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/runtime/bot-runtime.d.ts

@@ -0,0 +1,25 @@
+import { BoundedConcurrencyQueue } from '../guards/bounded-concurrency.js';
+import { TokenBucketRateLimiter } from '../guards/token-bucket-rate-limiter.js';
+import type { Logger, MetricsCollector, UpdateSource } from '../types/core.js';
+import type { Update } from '../types/telegram.js';
+export interface RuntimeHandler {
+    handleUpdate(update: Update): Promise<void>;
+}
+export interface RuntimeGuardOptions {
+    tenantResolver?: (update: Update) => string;
+    rateLimiter?: TokenBucketRateLimiter;
+    concurrencyQueue?: BoundedConcurrencyQueue;
+    logger?: Logger;
+    metrics?: MetricsCollector;
+}
+export declare class BotRuntime {
+    private readonly source;
+    private readonly handler;
+    private readonly pending;
+    private readonly guards;
+    constructor(source: UpdateSource, handler: RuntimeHandler, guards?: RuntimeGuardOptions);
+    start(): Promise<void>;
+    shutdown(): Promise<void>;
+    private processUpdate;
+}
+//# sourceMappingURL=bot-runtime.d.ts.map

package/dist/runtime/bot-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/bot-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;gBAE1B,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAE,mBAAwB;IAMrF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAUtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAKxB,aAAa;CAoC5B"}

package/dist/runtime/bot-runtime.js

@@ -0,0 +1,59 @@
+export class BotRuntime {
+    source;
+    handler;
+    pending = new Set();
+    guards;
+    constructor(source, handler, guards = {}) {
+        this.source = source;
+        this.handler = handler;
+        this.guards = guards;
+    }
+    async start() {
+        await this.source.run(async (update) => {
+            const task = this.processUpdate(update).finally(() => {
+                this.pending.delete(task);
+            });
+            this.pending.add(task);
+            await task;
+        });
+    }
+    async shutdown() {
+        await this.source.stop();
+        await Promise.allSettled([...this.pending]);
+    }
+    async processUpdate(update) {
+        const tenantKey = this.guards.tenantResolver ? this.guards.tenantResolver(update) : 'default';
+        if (this.guards.rateLimiter && !this.guards.rateLimiter.allow(tenantKey)) {
+            this.guards.metrics?.increment('runtime_dropped_rate_limited', 1, { tenant: tenantKey });
+            this.guards.logger?.log({
+                level: 'warn',
+                event: 'runtime_rate_limited',
+                timestamp: new Date().toISOString(),
+                data: { tenant: tenantKey }
+            });
+            return;
+        }
+        if (!this.guards.concurrencyQueue) {
+            await this.handler.handleUpdate(update);
+            return;
+        }
+        try {
+            await this.guards.concurrencyQueue.run(async () => {
+                await this.handler.handleUpdate(update);
+            });
+        }
+        catch (error) {
+            this.guards.metrics?.increment('runtime_dropped_queue_overflow', 1, { tenant: tenantKey });
+            this.guards.logger?.log({
+                level: 'error',
+                event: 'runtime_queue_overflow',
+                timestamp: new Date().toISOString(),
+                data: {
+                    tenant: tenantKey,
+                    message: error instanceof Error ? error.message : 'unknown'
+                }
+            });
+        }
+    }
+}
+//# sourceMappingURL=bot-runtime.js.map

package/dist/runtime/bot-runtime.js.map

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

package/dist/storage/memory-session-storage.d.ts

@@ -0,0 +1,12 @@
+import type { CasResult, SessionStorage, VersionedValue } from '../types/core.js';
+export declare class MemorySessionStorage<TSession extends {
+    version: number;
+}> implements SessionStorage<TSession> {
+    private readonly store;
+    get(key: string): Promise<TSession | null>;
+    set(key: string, value: TSession): Promise<void>;
+    delete(key: string): Promise<void>;
+    getWithVersion(key: string): Promise<VersionedValue<TSession> | null>;
+    compareAndSet(key: string, expectedVersion: number, nextValue: TSession): Promise<CasResult<TSession>>;
+}
+//# sourceMappingURL=memory-session-storage.d.ts.map

package/dist/storage/memory-session-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-session-storage.d.ts","sourceRoot":"","sources":["../../src/storage/memory-session-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElF,qBAAa,oBAAoB,CAAC,QAAQ,SAAS;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAE,YAAW,cAAc,CAAC,QAAQ,CAAC;IACzG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+C;IAExD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAI1C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAYrE,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;CA8BpH"}

package/dist/storage/memory-session-storage.js

@@ -0,0 +1,53 @@
+export class MemorySessionStorage {
+    store = new Map();
+    async get(key) {
+        return this.store.get(key)?.value ?? null;
+    }
+    async set(key, value) {
+        this.store.set(key, {
+            value,
+            version: value.version
+        });
+    }
+    async delete(key) {
+        this.store.delete(key);
+    }
+    async getWithVersion(key) {
+        const found = this.store.get(key);
+        if (!found) {
+            return null;
+        }
+        return {
+            value: found.value,
+            version: found.version
+        };
+    }
+    async compareAndSet(key, expectedVersion, nextValue) {
+        const current = this.store.get(key);
+        if (!current && expectedVersion === 0) {
+            this.store.set(key, {
+                value: nextValue,
+                version: nextValue.version
+            });
+            return { ok: true };
+        }
+        if (!current || current.version !== expectedVersion) {
+            if (!current) {
+                return { ok: false };
+            }
+            return {
+                ok: false,
+                current: {
+                    value: current.value,
+                    version: current.version
+                }
+            };
+        }
+        this.store.set(key, {
+            value: nextValue,
+            version: nextValue.version
+        });
+        return { ok: true };
+    }
+}
+//# sourceMappingURL=memory-session-storage.js.map

package/dist/storage/memory-session-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-session-storage.js","sourceRoot":"","sources":["../../src/storage/memory-session-storage.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,oBAAoB;IACd,KAAK,GAAG,IAAI,GAAG,EAAoC,CAAC;IAE9D,KAAK,CAAC,GAAG,CAAC,GAAW;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;IAC5C,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAe;QAC3C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,KAAK;YACL,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;IACL,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,GAAW;QAC7B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAEM,KAAK,CAAC,cAAc,CAAC,GAAW;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,aAAa,CAAC,GAAW,EAAE,eAAuB,EAAE,SAAmB;QAClF,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEpC,IAAI,CAAC,OAAO,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;gBAClB,KAAK,EAAE,SAAS;gBAChB,OAAO,EAAE,SAAS,CAAC,OAAO;aAC3B,CAAC,CAAC;YACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;QACtB,CAAC;QAED,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,KAAK,eAAe,EAAE,CAAC;YACpD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;YACvB,CAAC;YACD,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE;oBACP,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,OAAO,EAAE,OAAO,CAAC,OAAO;iBACzB;aACF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YAClB,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,SAAS,CAAC,OAAO;SAC3B,CAAC,CAAC;QACH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;CACF"}

package/dist/storage/redis-session-storage.d.ts

@@ -0,0 +1,45 @@
+import type { CasResult, SessionStorage, VersionedValue } from '../types/core.js';
+export interface RedisLikeTransaction {
+    get(key: string): Promise<string | null>;
+    watch(key: string): Promise<void>;
+    multi(commands: ReadonlyArray<readonly [string, ...string[]]>): Promise<ReadonlyArray<unknown> | null>;
+    unwatch(): Promise<void>;
+}
+export interface RedisLikeClient {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, mode?: 'EX', ttlSeconds?: number): Promise<unknown>;
+    del(key: string): Promise<number>;
+    withTransaction<T>(runner: (tx: RedisLikeTransaction) => Promise<T>): Promise<T>;
+}
+export interface SessionCrypto<TSession> {
+    encrypt(session: TSession): Promise<string>;
+    decrypt(payload: string): Promise<TSession>;
+}
+export interface RedisSessionStorageOptions<TSession extends {
+    version: number;
+}> {
+    client: RedisLikeClient;
+    namespace?: string;
+    ttlSeconds?: number;
+    crypto?: SessionCrypto<TSession>;
+}
+export declare class RedisSessionStorage<TSession extends {
+    version: number;
+}> implements SessionStorage<TSession> {
+    private readonly client;
+    private readonly namespace;
+    private readonly ttlSeconds;
+    private readonly crypto;
+    constructor(options: RedisSessionStorageOptions<TSession>);
+    get(key: string): Promise<TSession | null>;
+    set(key: string, value: TSession): Promise<void>;
+    delete(key: string): Promise<void>;
+    getWithVersion(key: string): Promise<VersionedValue<TSession> | null>;
+    compareAndSet(key: string, expectedVersion: number, nextValue: TSession): Promise<CasResult<TSession>>;
+    private formatKey;
+    private serialize;
+    private deserialize;
+    private writeValue;
+    private toSetCommands;
+}
+//# sourceMappingURL=redis-session-storage.d.ts.map

package/dist/storage/redis-session-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-session-storage.d.ts","sourceRoot":"","sources":["../../src/storage/redis-session-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElF,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACvG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,oBAAoB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAClF;AAED,MAAM,WAAW,aAAa,CAAC,QAAQ;IACrC,OAAO,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,0BAA0B,CAAC,QAAQ,SAAS;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE;IAC9E,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CAClC;AAED,qBAAa,mBAAmB,CAAC,QAAQ,SAAS;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAE,YAAW,cAAc,CAAC,QAAQ,CAAC;IACxG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;gBAE1C,OAAO,EAAE,0BAA0B,CAAC,QAAQ,CAAC;IAOnD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAS1C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAYrE,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IA2CnH,OAAO,CAAC,SAAS;YAIH,SAAS;YAOT,WAAW;YAOX,UAAU;IAQxB,OAAO,CAAC,aAAa;CAMtB"}

package/dist/storage/redis-session-storage.js

@@ -0,0 +1,101 @@
+export class RedisSessionStorage {
+    client;
+    namespace;
+    ttlSeconds;
+    crypto;
+    constructor(options) {
+        this.client = options.client;
+        this.namespace = options.namespace ?? 'tgfw';
+        this.ttlSeconds = options.ttlSeconds;
+        this.crypto = options.crypto;
+    }
+    async get(key) {
+        const raw = await this.client.get(this.formatKey(key));
+        if (!raw) {
+            return null;
+        }
+        return this.deserialize(raw);
+    }
+    async set(key, value) {
+        const raw = await this.serialize(value);
+        await this.writeValue(this.formatKey(key), raw);
+    }
+    async delete(key) {
+        await this.client.del(this.formatKey(key));
+    }
+    async getWithVersion(key) {
+        const value = await this.get(key);
+        if (!value) {
+            return null;
+        }
+        return {
+            value,
+            version: value.version
+        };
+    }
+    async compareAndSet(key, expectedVersion, nextValue) {
+        const fullKey = this.formatKey(key);
+        return this.client.withTransaction(async (tx) => {
+            await tx.watch(fullKey);
+            const currentRaw = await tx.get(fullKey);
+            if (!currentRaw) {
+                if (expectedVersion !== 0) {
+                    await tx.unwatch();
+                    return { ok: false };
+                }
+                const created = await this.serialize(nextValue);
+                const result = await tx.multi(this.toSetCommands(fullKey, created));
+                if (result === null) {
+                    return { ok: false };
+                }
+                return { ok: true };
+            }
+            const current = await this.deserialize(currentRaw);
+            if (current.version !== expectedVersion) {
+                await tx.unwatch();
+                return {
+                    ok: false,
+                    current: {
+                        value: current,
+                        version: current.version
+                    }
+                };
+            }
+            const serialized = await this.serialize(nextValue);
+            const result = await tx.multi(this.toSetCommands(fullKey, serialized));
+            if (result === null) {
+                return { ok: false };
+            }
+            return { ok: true };
+        });
+    }
+    formatKey(key) {
+        return `${this.namespace}:session:${key}`;
+    }
+    async serialize(session) {
+        if (this.crypto) {
+            return this.crypto.encrypt(session);
+        }
+        return JSON.stringify(session);
+    }
+    async deserialize(payload) {
+        if (this.crypto) {
+            return this.crypto.decrypt(payload);
+        }
+        return JSON.parse(payload);
+    }
+    async writeValue(key, serialized) {
+        if (this.ttlSeconds && this.ttlSeconds > 0) {
+            await this.client.set(key, serialized, 'EX', this.ttlSeconds);
+            return;
+        }
+        await this.client.set(key, serialized);
+    }
+    toSetCommands(key, serialized) {
+        if (this.ttlSeconds && this.ttlSeconds > 0) {
+            return [['SET', key, serialized, 'EX', String(this.ttlSeconds)]];
+        }
+        return [['SET', key, serialized]];
+    }
+}
+//# sourceMappingURL=redis-session-storage.js.map

package/dist/storage/redis-session-storage.js.map

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

package/dist/tenant/key-namespace.d.ts

@@ -0,0 +1,7 @@
+export interface TenantScope {
+    tenantId: string;
+    botId: string;
+}
+export declare function createSessionNamespace(scope: TenantScope): string;
+export declare function createSessionKey(scope: TenantScope, userId: string): string;
+//# sourceMappingURL=key-namespace.d.ts.map

package/dist/tenant/key-namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-namespace.d.ts","sourceRoot":"","sources":["../../src/tenant/key-namespace.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAEjE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3E"}

package/dist/tenant/key-namespace.js

@@ -0,0 +1,7 @@
+export function createSessionNamespace(scope) {
+    return `framework:${scope.tenantId}:${scope.botId}:session`;
+}
+export function createSessionKey(scope, userId) {
+    return `${createSessionNamespace(scope)}:${userId}`;
+}
+//# sourceMappingURL=key-namespace.js.map

package/dist/tenant/key-namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-namespace.js","sourceRoot":"","sources":["../../src/tenant/key-namespace.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,sBAAsB,CAAC,KAAkB;IACvD,OAAO,aAAa,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,KAAK,UAAU,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAkB,EAAE,MAAc;IACjE,OAAO,GAAG,sBAAsB,CAAC,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;AACtD,CAAC"}

package/dist/types/core.d.ts

@@ -0,0 +1,106 @@
+import type { ApiMethods, Update } from '@grammyjs/types';
+export type JsonValue = string | number | boolean | null | JsonObject | JsonValue[];
+export type JsonObject = {
+    [key: string]: JsonValue | undefined;
+};
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogEvent {
+    level: LogLevel;
+    event: string;
+    timestamp: string;
+    requestId?: string;
+    data?: JsonObject;
+}
+export interface Logger {
+    log(event: LogEvent): void;
+}
+export interface MetricsCollector {
+    increment(metric: string, value?: number, tags?: Record<string, string>): void;
+    observe(metric: string, value: number, tags?: Record<string, string>): void;
+}
+export interface RetryOptions {
+    maxRetries: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+    jitterRatio: number;
+}
+export interface CircuitBreakerOptions {
+    failureThreshold: number;
+    cooldownMs: number;
+    halfOpenMaxRequests: number;
+}
+export interface ApiClientOptions {
+    token: string;
+    baseUrl?: string;
+    logger?: Logger;
+    metrics?: MetricsCollector;
+    retry?: Partial<RetryOptions>;
+    fetchImpl?: typeof fetch;
+    mockResponder?: (method: string, payload: JsonObject) => Promise<unknown>;
+    circuitBreaker?: Partial<CircuitBreakerOptions>;
+}
+export interface SessionEnvelope<TState extends string, TData extends JsonObject> {
+    current_state: TState | null;
+    data: TData;
+    version: number;
+    encrypted: boolean;
+    updated_at: string;
+}
+export interface VersionedValue<T> {
+    value: T;
+    version: number;
+}
+export interface CasResult<T> {
+    ok: boolean;
+    current?: VersionedValue<T>;
+}
+export interface SessionStorage<TSession> {
+    get(key: string): Promise<TSession | null>;
+    set(key: string, value: TSession): Promise<void>;
+    delete(key: string): Promise<void>;
+    getWithVersion(key: string): Promise<VersionedValue<TSession> | null>;
+    compareAndSet(key: string, expectedVersion: number, nextValue: TSession): Promise<CasResult<TSession>>;
+}
+export interface ContextShortcuts {
+    reply(text: string, extra?: JsonObject): Promise<unknown>;
+    editMessage(text: string, extra?: JsonObject): Promise<unknown>;
+    answerCallbackQuery(text?: string): Promise<unknown>;
+}
+export interface SceneHooks<TContext> {
+    onEnter?: (ctx: TContext) => Promise<void>;
+    onLeave?: (ctx: TContext) => Promise<void>;
+}
+export type Handler<TContext> = (ctx: TContext) => Promise<void>;
+export interface RouteCandidate<TContext> {
+    priority: number;
+    match: (ctx: TContext) => boolean;
+    handler: Handler<TContext>;
+}
+export interface PollingOptions {
+    limit?: number;
+    timeoutSeconds?: number;
+    dropPendingUpdates?: boolean;
+    signal?: AbortSignal;
+}
+export interface UpdateSource {
+    run(onUpdate: (update: Update) => Promise<void>): Promise<void>;
+    stop(): Promise<void>;
+}
+export interface WebhookRequest {
+    method: string;
+    headers: Record<string, string | undefined>;
+    rawBody: string;
+    path?: string;
+    query?: Record<string, string | undefined>;
+}
+export interface WebhookResponse {
+    status: number;
+    headers: Record<string, string>;
+    body: string;
+}
+export interface WebhookHandlerOptions {
+    secretToken: string;
+    secretHeader?: string;
+}
+export type TelegramMethod = keyof ApiMethods<unknown>;
+//# sourceMappingURL=core.d.ts.map

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

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

package/dist/types/core.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=core.js.map

package/dist/types/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/types/core.ts"],"names":[],"mappings":""}