easy-ping 0.6.1 → 0.7.0

package/dist/providers/telegram.cjs

@@ -0,0 +1,103 @@
+'use strict';
+
+// src/providers/telegram/index.ts
+var telegramStartLink = (botUsername, code) => `https://t.me/${botUsername.replace(/^@/, "")}?start=${encodeURIComponent(code)}`;
+function telegramBot(options) {
+  const doFetch = options.fetch ?? globalThis.fetch;
+  const base = `${(options.apiBase ?? "https://api.telegram.org").replace(/\/$/, "")}/bot${options.token}`;
+  const timeoutMs = options.timeoutMs ?? 1e4;
+  const redact = (text) => text.split(options.token).join("<token>");
+  async function call(method, body, signal, budgetMs = timeoutMs) {
+    const timeout = AbortSignal.timeout(budgetMs);
+    const merged = signal ? AbortSignal.any([signal, timeout]) : timeout;
+    const response = await doFetch(`${base}/${method}`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(body),
+      signal: merged
+    });
+    const data = await response.json().catch(() => ({ ok: false }));
+    return { status: response.status, data };
+  }
+  async function must(method, body) {
+    const { data } = await call(method, body);
+    if (!data.ok)
+      throw new Error(redact(`telegram ${method} failed: ${data.description ?? "unknown"}`));
+    return data.result;
+  }
+  return {
+    name: "telegram",
+    async send(message) {
+      const body = {
+        chat_id: message.chatId,
+        text: message.text,
+        parse_mode: "HTML",
+        link_preview_options: { is_disabled: true }
+      };
+      if (message.buttons?.length) {
+        body.reply_markup = {
+          inline_keyboard: [
+            message.buttons.map((button) => ({ text: button.text, url: button.url }))
+          ]
+        };
+      }
+      let status;
+      let data;
+      try {
+        ({ status, data } = await call(
+          "sendMessage",
+          body,
+          message.signal
+        ));
+      } catch (error) {
+        const text = error instanceof Error ? error.message : String(error);
+        return { ok: false, error: redact(text), retryable: true, gone: false };
+      }
+      if (data.ok) return { ok: true, messageId: data.result.message_id };
+      const description = redact(data.description ?? `HTTP ${status}`);
+      const code = data.error_code ?? status;
+      if (code === 429) {
+        return {
+          ok: false,
+          error: description,
+          retryable: true,
+          gone: false,
+          retryAfterSeconds: data.parameters?.retry_after
+        };
+      }
+      const gone = code === 403 || code === 400 && /chat not found|user is deactivated|bot was kicked/i.test(description);
+      return { ok: false, error: description, retryable: code >= 500, gone };
+    },
+    async getUpdates({ offset, timeoutSeconds = 25, signal }) {
+      const { data } = await call(
+        "getUpdates",
+        {
+          ...offset === void 0 ? {} : { offset },
+          timeout: timeoutSeconds,
+          allowed_updates: ["message", "my_chat_member"]
+        },
+        signal,
+        (timeoutSeconds + 10) * 1e3
+      );
+      if (!data.ok)
+        throw new Error(redact(`telegram getUpdates failed: ${data.description ?? "unknown"}`));
+      return data.result;
+    },
+    setWebhook: async (url, secretToken) => {
+      await must("setWebhook", {
+        url,
+        secret_token: secretToken,
+        allowed_updates: ["message", "my_chat_member"]
+      });
+    },
+    deleteWebhook: async () => {
+      await must("deleteWebhook", {});
+    },
+    getMe: () => must("getMe", {})
+  };
+}
+
+exports.telegramBot = telegramBot;
+exports.telegramStartLink = telegramStartLink;
+//# sourceMappingURL=telegram.cjs.map
+//# sourceMappingURL=telegram.cjs.map

package/dist/providers/telegram.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/telegram/index.ts"],"names":[],"mappings":"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","file":"telegram.cjs","sourcesContent":["export type TelegramButton = { text: string; url: string };\n\nexport type TelegramMessage = {\n  chatId: string;\n  /** Telegram HTML: <b>, <i>, <a href>, <code>, <pre>. Escape user text with escapeHtml(). */\n  text: string;\n  buttons?: readonly TelegramButton[] | undefined;\n  signal?: AbortSignal | undefined;\n};\n\nexport type TelegramSendResult =\n  | { ok: true; messageId: number }\n  | {\n      ok: false;\n      error: string;\n      /** Worth another attempt: rate limit, 5xx, network. */\n      retryable: boolean;\n      /** The chat can never receive again (user blocked the bot, chat deleted). Prune it. */\n      gone: boolean;\n      retryAfterSeconds?: number | undefined;\n    };\n\n/** The slice of a Bot API update the plugin reads. Everything else passes through untouched. */\nexport type TelegramUpdate = {\n  update_id: number;\n  message?: {\n    text?: string;\n    chat: { id: number | string; type: string; username?: string; title?: string };\n    from?: { id: number; username?: string; first_name?: string };\n  };\n  my_chat_member?: {\n    chat: { id: number | string; type: string; username?: string; title?: string };\n    new_chat_member: { status: string };\n  };\n};\n\nexport type TelegramProvider = {\n  name: string;\n  send(message: TelegramMessage): Promise<TelegramSendResult>;\n  /** Long-polls for updates. For development or hosts without a public URL. */\n  getUpdates(options: {\n    offset?: number | undefined;\n    timeoutSeconds?: number | undefined;\n    signal?: AbortSignal | undefined;\n  }): Promise<TelegramUpdate[]>;\n  /** Points Telegram at your webhook route. Run once per deployment URL. */\n  setWebhook(url: string, secretToken: string): Promise<void>;\n  deleteWebhook(): Promise<void>;\n  getMe(): Promise<{ id: number; username: string }>;\n};\n\nexport type TelegramBotOptions = {\n  /** From @BotFather. Never appears in errors or logs. */\n  token: string;\n  fetch?: typeof globalThis.fetch | undefined;\n  /** Default https://api.telegram.org. A local fake for tests. */\n  apiBase?: string | undefined;\n  timeoutMs?: number | undefined;\n};\n\ntype ApiResponse<T> =\n  | { ok: true; result: T }\n  | { ok: false; description?: string; error_code?: number; parameters?: { retry_after?: number } };\n\n/** Deep link that opens the bot with a start parameter. Codes are [A-Za-z0-9_-], at most 64 chars. */\nexport const telegramStartLink = (botUsername: string, code: string) =>\n  `https://t.me/${botUsername.replace(/^@/, \"\")}?start=${encodeURIComponent(code)}`;\n\n/** Bot API over fetch, so it runs on edge runtimes. Failures are classified, never thrown, on send. */\nexport function telegramBot(options: TelegramBotOptions): TelegramProvider {\n  const doFetch = options.fetch ?? globalThis.fetch;\n  const base = `${(options.apiBase ?? \"https://api.telegram.org\").replace(/\\/$/, \"\")}/bot${options.token}`;\n  const timeoutMs = options.timeoutMs ?? 10_000;\n  const redact = (text: string) => text.split(options.token).join(\"<token>\");\n\n  async function call<T>(\n    method: string,\n    body: Record<string, unknown>,\n    signal?: AbortSignal,\n    budgetMs = timeoutMs,\n  ): Promise<{ status: number; data: ApiResponse<T> }> {\n    const timeout = AbortSignal.timeout(budgetMs);\n    const merged = signal ? AbortSignal.any([signal, timeout]) : timeout;\n    const response = await doFetch(`${base}/${method}`, {\n      method: \"POST\",\n      headers: { \"content-type\": \"application/json\" },\n      body: JSON.stringify(body),\n      signal: merged,\n    });\n    const data = (await response.json().catch(() => ({ ok: false }))) as ApiResponse<T>;\n    return { status: response.status, data };\n  }\n\n  async function must<T>(method: string, body: Record<string, unknown>): Promise<T> {\n    const { data } = await call<T>(method, body);\n    if (!data.ok)\n      throw new Error(redact(`telegram ${method} failed: ${data.description ?? \"unknown\"}`));\n    return data.result;\n  }\n\n  return {\n    name: \"telegram\",\n\n    async send(message) {\n      const body: Record<string, unknown> = {\n        chat_id: message.chatId,\n        text: message.text,\n        parse_mode: \"HTML\",\n        link_preview_options: { is_disabled: true },\n      };\n      if (message.buttons?.length) {\n        body.reply_markup = {\n          inline_keyboard: [\n            message.buttons.map((button) => ({ text: button.text, url: button.url })),\n          ],\n        };\n      }\n\n      let status: number;\n      let data: ApiResponse<{ message_id: number }>;\n      try {\n        ({ status, data } = await call<{ message_id: number }>(\n          \"sendMessage\",\n          body,\n          message.signal,\n        ));\n      } catch (error) {\n        const text = error instanceof Error ? error.message : String(error);\n        return { ok: false, error: redact(text), retryable: true, gone: false };\n      }\n\n      if (data.ok) return { ok: true, messageId: data.result.message_id };\n\n      const description = redact(data.description ?? `HTTP ${status}`);\n      const code = data.error_code ?? status;\n      if (code === 429) {\n        return {\n          ok: false,\n          error: description,\n          retryable: true,\n          gone: false,\n          retryAfterSeconds: data.parameters?.retry_after,\n        };\n      }\n      // 403: the user blocked the bot or was deactivated. 400 \"chat not found\": deleted or never existed.\n      const gone =\n        code === 403 ||\n        (code === 400 && /chat not found|user is deactivated|bot was kicked/i.test(description));\n      return { ok: false, error: description, retryable: code >= 500, gone };\n    },\n\n    async getUpdates({ offset, timeoutSeconds = 25, signal }) {\n      // Telegram holds the request open for `timeout` seconds; the budget must outlive it.\n      const { data } = await call<TelegramUpdate[]>(\n        \"getUpdates\",\n        {\n          ...(offset === undefined ? {} : { offset }),\n          timeout: timeoutSeconds,\n          allowed_updates: [\"message\", \"my_chat_member\"],\n        },\n        signal,\n        (timeoutSeconds + 10) * 1000,\n      );\n      if (!data.ok)\n        throw new Error(redact(`telegram getUpdates failed: ${data.description ?? \"unknown\"}`));\n      return data.result;\n    },\n\n    setWebhook: async (url, secretToken) => {\n      await must(\"setWebhook\", {\n        url,\n        secret_token: secretToken,\n        allowed_updates: [\"message\", \"my_chat_member\"],\n      });\n    },\n    deleteWebhook: async () => {\n      await must(\"deleteWebhook\", {});\n    },\n    getMe: () => must(\"getMe\", {}),\n  };\n}\n"]}

package/dist/providers/telegram.d.cts

@@ -0,0 +1,83 @@
+type TelegramButton = {
+    text: string;
+    url: string;
+};
+type TelegramMessage = {
+    chatId: string;
+    /** Telegram HTML: <b>, <i>, <a href>, <code>, <pre>. Escape user text with escapeHtml(). */
+    text: string;
+    buttons?: readonly TelegramButton[] | undefined;
+    signal?: AbortSignal | undefined;
+};
+type TelegramSendResult = {
+    ok: true;
+    messageId: number;
+} | {
+    ok: false;
+    error: string;
+    /** Worth another attempt: rate limit, 5xx, network. */
+    retryable: boolean;
+    /** The chat can never receive again (user blocked the bot, chat deleted). Prune it. */
+    gone: boolean;
+    retryAfterSeconds?: number | undefined;
+};
+/** The slice of a Bot API update the plugin reads. Everything else passes through untouched. */
+type TelegramUpdate = {
+    update_id: number;
+    message?: {
+        text?: string;
+        chat: {
+            id: number | string;
+            type: string;
+            username?: string;
+            title?: string;
+        };
+        from?: {
+            id: number;
+            username?: string;
+            first_name?: string;
+        };
+    };
+    my_chat_member?: {
+        chat: {
+            id: number | string;
+            type: string;
+            username?: string;
+            title?: string;
+        };
+        new_chat_member: {
+            status: string;
+        };
+    };
+};
+type TelegramProvider = {
+    name: string;
+    send(message: TelegramMessage): Promise<TelegramSendResult>;
+    /** Long-polls for updates. For development or hosts without a public URL. */
+    getUpdates(options: {
+        offset?: number | undefined;
+        timeoutSeconds?: number | undefined;
+        signal?: AbortSignal | undefined;
+    }): Promise<TelegramUpdate[]>;
+    /** Points Telegram at your webhook route. Run once per deployment URL. */
+    setWebhook(url: string, secretToken: string): Promise<void>;
+    deleteWebhook(): Promise<void>;
+    getMe(): Promise<{
+        id: number;
+        username: string;
+    }>;
+};
+type TelegramBotOptions = {
+    /** From @BotFather. Never appears in errors or logs. */
+    token: string;
+    fetch?: typeof globalThis.fetch | undefined;
+    /** Default https://api.telegram.org. A local fake for tests. */
+    apiBase?: string | undefined;
+    timeoutMs?: number | undefined;
+};
+/** Deep link that opens the bot with a start parameter. Codes are [A-Za-z0-9_-], at most 64 chars. */
+declare const telegramStartLink: (botUsername: string, code: string) => string;
+/** Bot API over fetch, so it runs on edge runtimes. Failures are classified, never thrown, on send. */
+declare function telegramBot(options: TelegramBotOptions): TelegramProvider;
+
+export { type TelegramBotOptions, type TelegramButton, type TelegramMessage, type TelegramProvider, type TelegramSendResult, type TelegramUpdate, telegramBot, telegramStartLink };

package/dist/providers/telegram.d.ts

@@ -0,0 +1,83 @@
+type TelegramButton = {
+    text: string;
+    url: string;
+};
+type TelegramMessage = {
+    chatId: string;
+    /** Telegram HTML: <b>, <i>, <a href>, <code>, <pre>. Escape user text with escapeHtml(). */
+    text: string;
+    buttons?: readonly TelegramButton[] | undefined;
+    signal?: AbortSignal | undefined;
+};
+type TelegramSendResult = {
+    ok: true;
+    messageId: number;
+} | {
+    ok: false;
+    error: string;
+    /** Worth another attempt: rate limit, 5xx, network. */
+    retryable: boolean;
+    /** The chat can never receive again (user blocked the bot, chat deleted). Prune it. */
+    gone: boolean;
+    retryAfterSeconds?: number | undefined;
+};
+/** The slice of a Bot API update the plugin reads. Everything else passes through untouched. */
+type TelegramUpdate = {
+    update_id: number;
+    message?: {
+        text?: string;
+        chat: {
+            id: number | string;
+            type: string;
+            username?: string;
+            title?: string;
+        };
+        from?: {
+            id: number;
+            username?: string;
+            first_name?: string;
+        };
+    };
+    my_chat_member?: {
+        chat: {
+            id: number | string;
+            type: string;
+            username?: string;
+            title?: string;
+        };
+        new_chat_member: {
+            status: string;
+        };
+    };
+};
+type TelegramProvider = {
+    name: string;
+    send(message: TelegramMessage): Promise<TelegramSendResult>;
+    /** Long-polls for updates. For development or hosts without a public URL. */
+    getUpdates(options: {
+        offset?: number | undefined;
+        timeoutSeconds?: number | undefined;
+        signal?: AbortSignal | undefined;
+    }): Promise<TelegramUpdate[]>;
+    /** Points Telegram at your webhook route. Run once per deployment URL. */
+    setWebhook(url: string, secretToken: string): Promise<void>;
+    deleteWebhook(): Promise<void>;
+    getMe(): Promise<{
+        id: number;
+        username: string;
+    }>;
+};
+type TelegramBotOptions = {
+    /** From @BotFather. Never appears in errors or logs. */
+    token: string;
+    fetch?: typeof globalThis.fetch | undefined;
+    /** Default https://api.telegram.org. A local fake for tests. */
+    apiBase?: string | undefined;
+    timeoutMs?: number | undefined;
+};
+/** Deep link that opens the bot with a start parameter. Codes are [A-Za-z0-9_-], at most 64 chars. */
+declare const telegramStartLink: (botUsername: string, code: string) => string;
+/** Bot API over fetch, so it runs on edge runtimes. Failures are classified, never thrown, on send. */
+declare function telegramBot(options: TelegramBotOptions): TelegramProvider;
+
+export { type TelegramBotOptions, type TelegramButton, type TelegramMessage, type TelegramProvider, type TelegramSendResult, type TelegramUpdate, telegramBot, telegramStartLink };

package/dist/providers/telegram.js

@@ -0,0 +1,3 @@
+export { telegramBot, telegramStartLink } from '../chunk-SSHVZHSJ.js';
+//# sourceMappingURL=telegram.js.map
+//# sourceMappingURL=telegram.js.map

package/dist/providers/telegram.js.map

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

package/dist/providers/web-push.d.cts

@@ -1,6 +1,6 @@
 import { PushProvider } from '../plugins/push.cjs';
-import '../plugin-CHd2ZiGC.cjs';
-import '../adapter-D3lTy-4E.cjs';
+import '../plugin-Wwp1nvo0.cjs';
+import '../adapter-BJ8Iejvs.cjs';
 
 /** The subscription itself is unusable. Distinct from a transport failure so the plugin prunes rather than retries. */
 declare class InvalidSubscriptionError extends Error {

package/dist/providers/web-push.d.ts

@@ -1,6 +1,6 @@
 import { PushProvider } from '../plugins/push.js';
-import '../plugin-Cg9usuUi.js';
-import '../adapter-D3lTy-4E.js';
+import '../plugin-CSLKKgXT.js';
+import '../adapter-BJ8Iejvs.js';
 
 /** The subscription itself is unusable. Distinct from a transport failure so the plugin prunes rather than retries. */
 declare class InvalidSubscriptionError extends Error {

package/dist/schema.d.cts

@@ -1,5 +1,5 @@
-import { S as SchemaDeclaration } from './plugin-CHd2ZiGC.cjs';
-import './adapter-D3lTy-4E.cjs';
+import { S as SchemaDeclaration } from './plugin-Wwp1nvo0.cjs';
+import './adapter-BJ8Iejvs.cjs';
 
 declare const toSnakeCase: (value: string) => string;
 /** Core tables in the plugin format. A drift test asserts it agrees with the Drizzle schema. */

package/dist/schema.d.ts

@@ -1,5 +1,5 @@
-import { S as SchemaDeclaration } from './plugin-Cg9usuUi.js';
-import './adapter-D3lTy-4E.js';
+import { S as SchemaDeclaration } from './plugin-CSLKKgXT.js';
+import './adapter-BJ8Iejvs.js';
 
 declare const toSnakeCase: (value: string) => string;
 /** Core tables in the plugin format. A drift test asserts it agrees with the Drizzle schema. */

package/dist/testing.d.cts

@@ -1,4 +1,4 @@
-import { D as DatabaseAdapter } from './adapter-D3lTy-4E.cjs';
+import { D as DatabaseAdapter } from './adapter-BJ8Iejvs.cjs';
 
 type ConformanceContext = {
     adapter: DatabaseAdapter;

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import { D as DatabaseAdapter } from './adapter-D3lTy-4E.js';
+import { D as DatabaseAdapter } from './adapter-BJ8Iejvs.js';
 
 type ConformanceContext = {
     adapter: DatabaseAdapter;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "easy-ping",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Self-hosted, type-safe notifications for TypeScript apps. Your database, your users.",
   "license": "MIT",
   "author": "Teklu Moges",
@@ -22,6 +22,7 @@
     "push-notifications",
     "vapid",
     "service-worker",
+    "telegram",
     "email",
     "transactional-email",
     "resend",
@@ -130,11 +131,21 @@
       "import": "./dist/plugins/push.js",
       "require": "./dist/plugins/push.cjs"
     },
+    "./plugins/telegram": {
+      "types": "./dist/plugins/telegram.d.ts",
+      "import": "./dist/plugins/telegram.js",
+      "require": "./dist/plugins/telegram.cjs"
+    },
     "./providers/web-push": {
       "types": "./dist/providers/web-push.d.ts",
       "import": "./dist/providers/web-push.js",
       "require": "./dist/providers/web-push.cjs"
     },
+    "./providers/telegram": {
+      "types": "./dist/providers/telegram.d.ts",
+      "import": "./dist/providers/telegram.js",
+      "require": "./dist/providers/telegram.cjs"
+    },
     "./browser": {
       "types": "./dist/browser.d.ts",
       "import": "./dist/browser.js",
@@ -179,7 +190,7 @@
     "@standard-schema/spec": "^1.1.0"
   },
   "scripts": {
-    "build": "node scripts/clean.mjs && tsup",
+    "build": "node scripts/build.mjs",
     "dev": "tsup --watch",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",