@jilimb0/tgwrapper 0.4.0

package/dist/types/telegram.d.ts

@@ -0,0 +1,2 @@
+export type { ApiMethods, CallbackQuery, Chat, Message, Update, User } from '@grammyjs/types';
+//# sourceMappingURL=telegram.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/types/telegram.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,aAAa,EACb,IAAI,EACJ,OAAO,EACP,MAAM,EACN,IAAI,EACL,MAAM,iBAAiB,CAAC"}

package/dist/types/telegram.js

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

package/dist/types/telegram.js.map

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

package/dist/update-loop/polling.d.ts

@@ -0,0 +1,13 @@
+import type { ApiClient } from '../core/api-client.js';
+import type { PollingOptions, UpdateSource } from '../types/core.js';
+import type { Update } from '../types/telegram.js';
+export declare class PollingSource implements UpdateSource {
+    private readonly apiClient;
+    private readonly options;
+    private running;
+    private offset;
+    constructor(apiClient: ApiClient, options?: PollingOptions);
+    run(onUpdate: (update: Update) => Promise<void>): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=polling.d.ts.map

package/dist/update-loop/polling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.d.ts","sourceRoot":"","sources":["../../src/update-loop/polling.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAUnD,qBAAa,aAAc,YAAW,YAAY;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAK;gBAEA,SAAS,EAAE,SAAS,EAAE,OAAO,GAAE,cAAmB;IAUxD,GAAG,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B/D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAGnC"}

package/dist/update-loop/polling.js

@@ -0,0 +1,40 @@
+import { isFreshUpdate, isValidTelegramUpdate } from './update-validator.js';
+export class PollingSource {
+    apiClient;
+    options;
+    running = false;
+    offset = 0;
+    constructor(apiClient, options = {}) {
+        this.apiClient = apiClient;
+        this.options = {
+            limit: options.limit ?? 100,
+            timeoutSeconds: options.timeoutSeconds ?? 30,
+            dropPendingUpdates: options.dropPendingUpdates ?? true,
+            signal: options.signal
+        };
+    }
+    async run(onUpdate) {
+        this.running = true;
+        while (this.running && !this.options.signal?.aborted) {
+            const response = await this.apiClient.callApi('getUpdates', {
+                offset: this.offset,
+                timeout: this.options.timeoutSeconds,
+                limit: this.options.limit
+            });
+            for (const update of response) {
+                this.offset = update.update_id + 1;
+                if (!isValidTelegramUpdate(update)) {
+                    continue;
+                }
+                if (this.options.dropPendingUpdates && !isFreshUpdate(update)) {
+                    continue;
+                }
+                await onUpdate(update);
+            }
+        }
+    }
+    async stop() {
+        this.running = false;
+    }
+}
+//# sourceMappingURL=polling.js.map

package/dist/update-loop/polling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.js","sourceRoot":"","sources":["../../src/update-loop/polling.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAS7E,MAAM,OAAO,aAAa;IACP,SAAS,CAAY;IACrB,OAAO,CAAyB;IACzC,OAAO,GAAG,KAAK,CAAC;IAChB,MAAM,GAAG,CAAC,CAAC;IAEnB,YAAmB,SAAoB,EAAE,UAA0B,EAAE;QACnE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG;YACb,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG;YAC3B,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,EAAE;YAC5C,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,IAAI;YACtD,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,QAA2C;QAC1D,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,OAAO,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YACrD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAW,YAAY,EAAE;gBACpE,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc;gBACpC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;aAC1B,CAAC,CAAC;YAEH,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC;gBAEnC,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;oBACnC,SAAS;gBACX,CAAC;gBAED,IAAI,IAAI,CAAC,OAAO,CAAC,kBAAkB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC9D,SAAS;gBACX,CAAC;gBAED,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,CAAC;CACF"}

package/dist/update-loop/update-validator.d.ts

@@ -0,0 +1,4 @@
+import type { Update } from '../types/telegram.js';
+export declare function isValidTelegramUpdate(value: unknown): value is Update;
+export declare function isFreshUpdate(update: Update, nowMs?: number): boolean;
+//# sourceMappingURL=update-validator.d.ts.map

package/dist/update-loop/update-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-validator.d.ts","sourceRoot":"","sources":["../../src/update-loop/update-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAInD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAOrE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAa,GAAG,OAAO,CAQzE"}

package/dist/update-loop/update-validator.js

@@ -0,0 +1,17 @@
+const FIVE_MINUTES_MS = 5 * 60 * 1000;
+export function isValidTelegramUpdate(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const candidate = value;
+    return typeof candidate.update_id === 'number';
+}
+export function isFreshUpdate(update, nowMs = Date.now()) {
+    const messageDate = update.message?.date ?? update.callback_query?.message?.date;
+    if (!messageDate) {
+        return true;
+    }
+    const ageMs = nowMs - messageDate * 1000;
+    return ageMs <= FIVE_MINUTES_MS;
+}
+//# sourceMappingURL=update-validator.js.map

package/dist/update-loop/update-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-validator.js","sourceRoot":"","sources":["../../src/update-loop/update-validator.ts"],"names":[],"mappings":"AAEA,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAEtC,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,KAAgC,CAAC;IACnD,OAAO,OAAO,SAAS,CAAC,SAAS,KAAK,QAAQ,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE;IAC9D,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,IAAI,MAAM,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC;IACjF,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,GAAG,WAAW,GAAG,IAAI,CAAC;IACzC,OAAO,KAAK,IAAI,eAAe,CAAC;AAClC,CAAC"}

package/dist/update-loop/webhook.d.ts

@@ -0,0 +1,15 @@
+import type { Update } from '../types/telegram.js';
+import type { UpdateSource } from '../types/core.js';
+export interface WebhookValidationOptions {
+    headerName: string;
+    secretToken: string;
+}
+export declare class WebhookSource implements UpdateSource {
+    private readonly updates;
+    private running;
+    run(onUpdate: (update: Update) => Promise<void>): Promise<void>;
+    stop(): Promise<void>;
+    ingest(update: unknown): void;
+    validateSignature(headers: Record<string, string | undefined>, options: WebhookValidationOptions): boolean;
+}
+//# sourceMappingURL=webhook.d.ts.map

package/dist/update-loop/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../src/update-loop/webhook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,aAAc,YAAW,YAAY;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,OAAO,CAAS;IAEX,GAAG,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAO7B,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,wBAAwB,GAAG,OAAO;CAIlH"}

package/dist/update-loop/webhook.js

@@ -0,0 +1,30 @@
+import { isValidTelegramUpdate } from './update-validator.js';
+export class WebhookSource {
+    updates = [];
+    running = false;
+    async run(onUpdate) {
+        this.running = true;
+        while (this.running) {
+            const next = this.updates.shift();
+            if (!next) {
+                await new Promise((resolve) => setTimeout(resolve, 10));
+                continue;
+            }
+            await onUpdate(next);
+        }
+    }
+    async stop() {
+        this.running = false;
+    }
+    ingest(update) {
+        if (!isValidTelegramUpdate(update)) {
+            return;
+        }
+        this.updates.push(update);
+    }
+    validateSignature(headers, options) {
+        const current = headers[options.headerName.toLowerCase()] ?? headers[options.headerName];
+        return current === options.secretToken;
+    }
+}
+//# sourceMappingURL=webhook.js.map

package/dist/update-loop/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../src/update-loop/webhook.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAO9D,MAAM,OAAO,aAAa;IACP,OAAO,GAAa,EAAE,CAAC;IAChC,OAAO,GAAG,KAAK,CAAC;IAEjB,KAAK,CAAC,GAAG,CAAC,QAA2C;QAC1D,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;gBACxD,SAAS;YACX,CAAC;YACD,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,CAAC;IAEM,MAAM,CAAC,MAAe;QAC3B,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAEM,iBAAiB,CAAC,OAA2C,EAAE,OAAiC;QACrG,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACzF,OAAO,OAAO,KAAK,OAAO,CAAC,WAAW,CAAC;IACzC,CAAC;CACF"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@jilimb0/tgwrapper",
+  "version": "0.4.0",
+  "description": "Serverless-first Telegram bot framework without external bot libraries",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "keywords": [
+    "telegram",
+    "bot",
+    "framework",
+    "fsm",
+    "serverless"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@grammyjs/types": "^3.8.0"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.29.6",
+    "typedoc": "^0.27.9",
+    "typescript": "5.8.2",
+    "vitest": "^4.0.18"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:integration": "pnpm --filter @jilimb0/tgwrapper-adapter-redis test:integration",
+    "test:load": "vitest run test/load/throughput.load.test.ts",
+    "test:chaos": "vitest run test/chaos/multi-tenant.chaos.test.ts",
+    "test:phase4": "pnpm test:load && pnpm test:chaos && pnpm test:integration",
+    "benchmark": "pnpm build && node benchmark/run-benchmark.mjs",
+    "docs": "typedoc src/index.ts --out docs/api",
+    "release:status": "changeset status",
+    "release:version": "changeset version",
+    "release:publish": "changeset publish"
+  }
+}