@adriangalilea/utils 0.31.0 → 1.1.0

package/dist/bot/storage-d1.js.map

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

package/dist/bot/worker.d.ts

@@ -0,0 +1,57 @@
+import { type AlertThrottle } from "./notify.js";
+/** The slice of a gramio `Bot` the worker cap drives — structural, so versions don't pin. */
+export type WorkerBot = {
+    info?: {
+        username?: string;
+    };
+    updates: {
+        handleUpdate(update: unknown): Promise<unknown>;
+    };
+    api: {
+        setWebhook(params: {
+            url: string;
+            secret_token: string;
+            allowed_updates: string[];
+        }): Promise<unknown>;
+        deleteWebhook(): Promise<unknown>;
+        getWebhookInfo(): Promise<{
+            url?: string;
+            [k: string]: unknown;
+        }>;
+        /** For the lifecycle DMs (notifyAdmins rides the same bot). */
+        sendMessage(params: {
+            chat_id: number;
+            text: string;
+        }): Promise<unknown>;
+    };
+};
+type WaitUntilCtx = {
+    waitUntil(promise: Promise<unknown>): void;
+};
+export type BotWorkerRuntime = {
+    bot: WorkerBot;
+    /** Telegram webhook secret; unset → webhook/setup respond 500 (a misconfigured prod must scream). */
+    webhookSecret?: string;
+    /** Bearer for /pause, /resume, /webhook-status; unset → those 404 (surface disabled). */
+    operatorSecret?: string;
+    /** Deployment label echoed in responses/DMs (e.g. the wrangler env name). */
+    mode?: string;
+    /** Live admin resolver for the lifecycle DMs + error alerts. Default: nobody (DMs off). */
+    adminIds?: () => Promise<readonly number[]>;
+    /** Awaited inside waitUntil after each update — hand `d1Storage`'s flush here. */
+    flush?: () => Promise<void>;
+    /** Extra fields merged into /webhook-status (e.g. a live feature flag). */
+    statusExtra?: () => Promise<Record<string, unknown>>;
+    /** Consumer endpoints, tried BEFORE the built-ins. Return null to fall through. */
+    routes?: (request: Request, url: URL, ctx: WaitUntilCtx) => Promise<Response | null> | Response | null;
+    /** Error-alert throttle (share one to share its budget). Default: own 60s window. */
+    errorThrottle?: AlertThrottle;
+};
+/**
+ * Build the Worker `fetch` handler. `resolve` runs per request — memoize your
+ * bot construction inside it (the classic `let botPromise` pattern) so the
+ * isolate builds once.
+ */
+export declare function botWorkerFetch<Env>(resolve: (env: Env) => Promise<BotWorkerRuntime> | BotWorkerRuntime): (request: Request, env: Env, ctx: WaitUntilCtx) => Promise<Response>;
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/dist/bot/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/bot/worker.ts"],"names":[],"mappings":"AA2CA,OAAO,EACN,KAAK,aAAa,EAIlB,MAAM,aAAa,CAAC;AAIrB,6FAA6F;AAC7F,MAAM,MAAM,SAAS,GAAG;IACvB,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7B,OAAO,EAAE;QAAE,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC;IAC7D,GAAG,EAAE;QACJ,UAAU,CAAC,MAAM,EAAE;YAClB,GAAG,EAAE,MAAM,CAAC;YACZ,YAAY,EAAE,MAAM,CAAC;YACrB,eAAe,EAAE,MAAM,EAAE,CAAC;SAC1B,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACrB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;QAClC,cAAc,IAAI,OAAO,CAAC;YAAE,GAAG,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC,CAAC;QAClE,+DAA+D;QAC/D,WAAW,CAAC,MAAM,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KACzE,CAAC;CACF,CAAC;AAEF,KAAK,YAAY,GAAG;IAAE,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,gBAAgB,GAAG;IAC9B,GAAG,EAAE,SAAS,CAAC;IACf,qGAAqG;IACrG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yFAAyF;IACzF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAC5C,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,mFAAmF;IACnF,MAAM,CAAC,EAAE,CACR,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,YAAY,KACb,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC;IAChD,qFAAqF;IACrF,aAAa,CAAC,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EACjC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,GACjE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,QAAQ,CAAC,CAkLtE"}

package/dist/bot/worker.js

@@ -0,0 +1,235 @@
+/**
+ * The Cloudflare Worker cap for a GramIO bot: everything between "I have a
+ * `Bot` with features" and "it serves Telegram traffic in production", so a
+ * bot file never hand-rolls a fetch handler. The workerd twin of `bot/kit`'s
+ * `gracefulStart` (which owns the Node long-poll lifecycle).
+ *
+ * Endpoints (all on the worker root):
+ *
+ *   POST /                webhook — `X-Telegram-Bot-Api-Secret-Token` checked,
+ *                         acked immediately; the update (+ storage flush) rides
+ *                         `ctx.waitUntil`, errors DM the admins (throttled).
+ *   POST /setup           registers the webhook with `allowed_updates` DERIVED
+ *                         from the bot's handlers (a new handler type never
+ *                         fires until /setup reruns — deploys should end here).
+ *                         Body may carry `{sha, author, message}`: the deploy
+ *                         DM then names the commit that went live.
+ *   POST /deploy-started  the "what is shipping" DM — curl it from your deploy
+ *                         script on the STILL-LIVE version the moment a deploy
+ *                         starts. Body `{sha, author, message, etaSeconds?}`.
+ *   POST /pause           deleteWebhook (traffic truly stops; Telegram queues
+ *                         ~24h) — operator-authed.
+ *   POST /resume          re-register the webhook — operator-authed.
+ *   GET  /webhook-status  `{mode, paused, webhook, ...statusExtra}` — operator-authed.
+ *   GET  /                liveness: `ok (<mode>)`.
+ *
+ * Auth: `/setup` + `/deploy-started` take `Bearer <webhookSecret>`; the
+ * operator verbs take `Bearer <operatorSecret>` and 404 when it's unset.
+ * Consumer endpoints go in `routes` (tried first, return null to fall through).
+ *
+ * Usage — the resolver receives the Worker env and returns the runtime (build
+ * & memoize your bot inside it):
+ *
+ *   export default { fetch: botWorkerFetch(async (env) => ({
+ *     bot: await getBot(env),
+ *     webhookSecret: env.WEBHOOK_SECRET,
+ *     operatorSecret: env.SEND_SECRET,
+ *     mode: env.MODE,
+ *     adminIds: () => readAdminIds(env),
+ *     flush,
+ *   })) }
+ */
+import { buildAllowedUpdates } from "gramio";
+import { createLogger } from "../universal/log.js";
+import { alertAdminError, alertThrottle, notifyAdmins, } from "./notify.js";
+const log = createLogger("bot/worker");
+/**
+ * Build the Worker `fetch` handler. `resolve` runs per request — memoize your
+ * bot construction inside it (the classic `let botPromise` pattern) so the
+ * isolate builds once.
+ */
+export function botWorkerFetch(resolve) {
+    const fallbackThrottle = alertThrottle();
+    return async (request, env, ctx) => {
+        const url = new URL(request.url);
+        try {
+            const rt = await resolve(env);
+            const { bot } = rt;
+            const mode = rt.mode ?? "?";
+            const adminIds = rt.adminIds ?? (async () => []);
+            const throttle = rt.errorThrottle ?? fallbackThrottle;
+            const webhookSecret = rt.webhookSecret?.trim();
+            // Consumer routes first — the escape hatch for bot-specific endpoints.
+            if (rt.routes) {
+                const handled = await rt.routes(request, url, ctx);
+                if (handled)
+                    return handled;
+            }
+            if (request.method === "GET" && url.pathname === "/") {
+                return new Response(`ok (${mode})`);
+            }
+            if (request.method === "POST" && url.pathname === "/") {
+                if (!webhookSecret)
+                    return new Response("webhookSecret is required", { status: 500 });
+                if (request.headers.get("X-Telegram-Bot-Api-Secret-Token") !==
+                    webhookSecret) {
+                    return new Response("Unauthorized", { status: 401 });
+                }
+                let update;
+                try {
+                    update = await request.json();
+                }
+                catch {
+                    return new Response("Bad Request", { status: 400 });
+                }
+                // Ack Telegram immediately, then keep the Worker alive for the slow
+                // work (avoids GramIO's 30s webhook timeout).
+                ctx.waitUntil((async () => {
+                    await bot.updates.handleUpdate(update);
+                    if (rt.flush)
+                        await rt.flush();
+                })().catch(async (error) => {
+                    log.error("update failed:", error instanceof Error ? error.message : error);
+                    // awaited so the DM rides the same waitUntil, not a frozen isolate
+                    await alertAdminError(bot, await adminIds(), "webhook update failed", error, throttle);
+                }));
+                return new Response("OK");
+            }
+            // Deploy narration, step 1 of 2: what is SHIPPING (curled on the still-live version).
+            if (request.method === "POST" && url.pathname === "/deploy-started") {
+                if (!webhookSecret)
+                    return new Response("webhookSecret is required", { status: 500 });
+                if (bearerToken(request.headers.get("Authorization")) !== webhookSecret) {
+                    return new Response("forbidden", { status: 403 });
+                }
+                const meta = await request.json().catch(() => ({}));
+                const commit = parseCommitMeta(meta);
+                const eta = etaSeconds(meta);
+                log.info(`deploy started${commit ? ` · ${describeCommit(commit)}` : ""}`);
+                ctx.waitUntil(adminIds().then((ids) => notifyAdmins(bot, ids, `🛳 <b>@${bot.info?.username}</b> deploying${eta ? ` <i>(~${eta}s)</i>` : ""}…${commitHtml(commit)}`, DEPLOY_DM_PARAMS)));
+                return new Response("ok");
+            }
+            // Deploy narration, step 2 of 2: what went LIVE — and the load-bearing
+            // webhook re-registration (allowed_updates derives from the handlers).
+            if (request.method === "POST" && url.pathname === "/setup") {
+                if (!webhookSecret)
+                    return new Response("webhookSecret is required", { status: 500 });
+                const token = bearerToken(request.headers.get("Authorization")) ??
+                    request.headers.get("X-Setup-Token");
+                if (token !== webhookSecret)
+                    return new Response("forbidden", { status: 403 });
+                const commit = parseCommitMeta(await request.json().catch(() => ({})));
+                const allowedUpdates = await registerWebhook(bot, url.origin, webhookSecret);
+                log.success(`deployed${commit ? ` · ${describeCommit(commit)}` : ""} — webhook registered`);
+                ctx.waitUntil(adminIds().then((ids) => notifyAdmins(bot, ids, `🚀 <b>@${bot.info?.username}</b> deployed · webhook registered${commitHtml(commit)}`, DEPLOY_DM_PARAMS)));
+                return new Response(`[${mode}] webhook set to ${url.origin}/ (updates: ${allowedUpdates.join(", ")})`);
+            }
+            // The operator tap: pause = deleteWebhook (Telegram queues ~24h),
+            // resume = re-register, status = getWebhookInfo (+statusExtra).
+            if (url.pathname === "/pause" ||
+                url.pathname === "/resume" ||
+                url.pathname === "/webhook-status") {
+                const secret = rt.operatorSecret?.trim();
+                if (!secret)
+                    return json({ error: "operator API disabled" }, 404);
+                if (request.headers.get("Authorization") !== `Bearer ${secret}`) {
+                    return json({ error: "unauthorized" }, 401);
+                }
+                if (request.method === "POST" && url.pathname === "/pause") {
+                    await bot.api.deleteWebhook();
+                    ctx.waitUntil(adminIds().then((ids) => notifyAdmins(bot, ids, `⏸️ @${bot.info?.username} [${mode}] paused — webhook deleted, Telegram queues ~24h.`)));
+                }
+                else if (request.method === "POST" && url.pathname === "/resume") {
+                    if (!webhookSecret)
+                        return new Response("webhookSecret is required", { status: 500 });
+                    await registerWebhook(bot, url.origin, webhookSecret);
+                    ctx.waitUntil(adminIds().then((ids) => notifyAdmins(bot, ids, `▶️ @${bot.info?.username} [${mode}] resumed — webhook re-registered.`)));
+                }
+                else if (!(request.method === "GET" && url.pathname === "/webhook-status")) {
+                    return new Response("Not Found", { status: 404 });
+                }
+                const info = await bot.api.getWebhookInfo();
+                const extra = rt.statusExtra ? await rt.statusExtra() : {};
+                return json({ mode, paused: !info.url, ...extra, webhook: info });
+            }
+            return new Response("Not Found", { status: 404 });
+        }
+        catch (error) {
+            log.error("worker request failed:", error instanceof Error ? error.message : error);
+            return new Response("internal error", { status: 500 });
+        }
+    };
+}
+// allowed_updates must list the opt-in types (message_reaction, chat-member
+// events) or Telegram never delivers them. Derived from the bot's registered
+// handlers — which is why deploys re-register (/setup) and /resume re-derives
+// instead of remembering a stale list.
+async function registerWebhook(bot, origin, webhookSecret) {
+    const allowedUpdates = [...buildAllowedUpdates(bot)];
+    await bot.api.setWebhook({
+        url: `${origin}/`,
+        secret_token: webhookSecret,
+        allowed_updates: allowedUpdates,
+    });
+    return allowedUpdates;
+}
+function bearerToken(header) {
+    const match = /^Bearer\s+(.+)$/i.exec(header ?? "");
+    return match?.[1]?.trim() || null;
+}
+function json(value, status = 200) {
+    return new Response(JSON.stringify(value), {
+        status,
+        headers: { "content-type": "application/json" },
+    });
+}
+function parseCommitMeta(meta) {
+    const m = meta;
+    const commit = {
+        sha: typeof m?.sha === "string" ? m.sha.trim().slice(0, 7) : "",
+        author: typeof m?.author === "string" ? m.author.trim() : "",
+        message: typeof m?.message === "string"
+            ? (m.message.split("\n")[0]?.trim().slice(0, 120) ?? "")
+            : "",
+    };
+    return commit.sha || commit.author || commit.message ? commit : null;
+}
+/** One line for the operator log: `abc1234 · Author · "message"`. */
+function describeCommit(c) {
+    return [c.sha, c.author, c.message ? `“${c.message}”` : ""]
+        .filter(Boolean)
+        .join(" · ");
+}
+/**
+ * The deploy DMs' commit block (Telegram HTML), appended to the headline:
+ * a mono sha + author line, then the message as a quote. Empty when no metadata came.
+ */
+function commitHtml(c) {
+    if (!c)
+        return "";
+    const head = [
+        c.sha ? `<code>${escapeHtml(c.sha)}</code>` : "",
+        escapeHtml(c.author),
+    ]
+        .filter(Boolean)
+        .join(" · ");
+    const quote = c.message
+        ? `\n<blockquote>${escapeHtml(c.message)}</blockquote>`
+        : "";
+    return `${head ? `\n${head}` : ""}${quote}`;
+}
+// HTML mode + no link preview, shared by both deploy DMs.
+const DEPLOY_DM_PARAMS = {
+    parse_mode: "HTML",
+    link_preview_options: { is_disabled: true },
+};
+/** The recent average deploy duration (seconds) a CI measured, when present and sane. */
+function etaSeconds(meta) {
+    const n = Number(meta?.etaSeconds);
+    return Number.isFinite(n) && n > 0 && n < 3600 ? Math.round(n) : null;
+}
+// Local minimal escaper; graduates to bot/format when that module lands.
+function escapeHtml(s) {
+    return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+//# sourceMappingURL=worker.js.map

package/dist/bot/worker.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@adriangalilea/utils",
-	"version": "0.31.0",
+	"version": "1.1.0",
 	"description": "TypeScript utilities - logger, currency, formatter, GramIO bot plugins, and more",
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",
@@ -84,6 +84,10 @@
 			"types": "./dist/bot/storage.d.ts",
 			"default": "./dist/bot/storage.js"
 		},
+		"./bot/storage-d1": {
+			"types": "./dist/bot/storage-d1.d.ts",
+			"default": "./dist/bot/storage-d1.js"
+		},
 		"./bot/ctx": {
 			"types": "./dist/bot/ctx.d.ts",
 			"default": "./dist/bot/ctx.js"
@@ -103,6 +107,14 @@
 		"./bot/notify": {
 			"types": "./dist/bot/notify.d.ts",
 			"default": "./dist/bot/notify.js"
+		},
+		"./bot/worker": {
+			"types": "./dist/bot/worker.d.ts",
+			"default": "./dist/bot/worker.js"
+		},
+		"./bot/create": {
+			"types": "./dist/bot/create.d.ts",
+			"default": "./dist/bot/create.js"
 		}
 	},
 	"files": [
@@ -124,7 +136,8 @@
 		"fix": "biome check --write --unsafe",
 		"ci": "biome ci",
 		"prepublishOnly": "pnpm run build",
-		"test:worker-safe": "pnpm run build && tsx tests/worker-safe-test.ts"
+		"test:worker-safe": "pnpm run build && tsx tests/worker-safe-test.ts",
+		"demo:bot": "tsx tests/create-demo.ts"
 	},
 	"keywords": [
 		"typescript",