statocysts 0.6.0 → 0.7.0

package/dist/browser.d.ts

@@ -1,8 +1,9 @@
-import { a as Sender, c as buildSenderRegistry, d as ServiceProvider, f as defineProvider, i as http, l as DefineProviderContext, m as defineTransport, n as slack, o as SenderRegistry, p as Transport, r as HttpPayload, s as SenderUrl, t as json, u as DefineProviderOptions } from "./index-I_frtEQ-.js";
+import { a as http, c as SenderUrl, d as DefineProviderOptions, f as ServiceProvider, h as defineTransport, i as HttpPayload, l as buildSenderRegistry, m as Transport, n as telegram, o as Sender, p as defineProvider, r as slack, s as SenderRegistry, t as json, u as DefineProviderContext } from "./index-DIqKYuP3.js";
 
 //#region src/browser.d.ts
+
 declare const senderRegistry: SenderRegistry;
 declare function createSender(urls: SenderUrl[]): Sender;
 declare function send(url: string | URL, title: string, body?: string): Promise<void>;
 //#endregion
-export { DefineProviderContext, DefineProviderOptions, HttpPayload, Sender, SenderRegistry, SenderUrl, ServiceProvider, Transport, buildSenderRegistry, createSender, defineProvider, defineTransport, http, json, send, senderRegistry, slack };
+export { DefineProviderContext, DefineProviderOptions, HttpPayload, Sender, SenderRegistry, SenderUrl, ServiceProvider, Transport, buildSenderRegistry, createSender, defineProvider, defineTransport, http, json, send, senderRegistry, slack, telegram };

package/dist/browser.js

@@ -1,7 +1,11 @@
-import { a as defineTransport, i as http, n as json, o as defineProvider, r as slack, s as assert, t as buildSenderRegistry } from "./shared-vzO3pF63.js";
+import { a as http, c as assert, i as slack, n as json, o as defineTransport, r as telegram, s as defineProvider, t as buildSenderRegistry } from "./shared-DBiCYY_-.js";
 
 //#region src/browser.ts
-const senderRegistry = buildSenderRegistry([json, slack]);
+const senderRegistry = buildSenderRegistry([
+	json,
+	slack,
+	telegram
+]);
 function createSender(urls) {
 	return senderRegistry(urls);
 }
@@ -17,4 +21,4 @@ async function send(url, title, body) {
 }
 
 //#endregion
-export { buildSenderRegistry, createSender, defineProvider, defineTransport, http, json, send, senderRegistry, slack };
+export { buildSenderRegistry, createSender, defineProvider, defineTransport, http, json, send, senderRegistry, slack, telegram };

package/dist/{index-I_frtEQ-.d.ts → index-DIqKYuP3.d.ts}

@@ -1,5 +1,6 @@
 import * as ofetch0 from "ofetch";
 import { FetchOptions } from "ofetch";
+import z from "zod";
 
 //#region src/core/transport.d.ts
 /**
@@ -89,7 +90,19 @@ interface SlackOptions {
 }
 declare const slack: ServiceProvider<"slack:", HttpPayload, SlackOptions>;
 //#endregion
+//#region src/services/chat/telegram/index.d.ts
+interface TelegramOptions {
+  /**
+   * The base URL for Telegram Bot API
+   *
+   * @default `https://api.telegram.org`
+   */
+  apiBaseUrl?: string;
+  fetchOptions?: FetchOptions;
+}
+declare const telegram: ServiceProvider<"telegram:", HttpPayload, TelegramOptions>;
+//#endregion
 //#region src/services/specialized/json/index.d.ts
 declare const json: ServiceProvider<"json:", HttpPayload, FetchOptions<ofetch0.ResponseType, any>>;
 //#endregion
-export { Sender as a, buildSenderRegistry as c, ServiceProvider as d, defineProvider as f, http as i, DefineProviderContext as l, defineTransport as m, slack as n, SenderRegistry as o, Transport as p, HttpPayload as r, SenderUrl as s, json as t, DefineProviderOptions as u };
+export { http as a, SenderUrl as c, DefineProviderOptions as d, ServiceProvider as f, defineTransport as h, HttpPayload as i, buildSenderRegistry as l, Transport as m, telegram as n, Sender as o, defineProvider as p, slack as r, SenderRegistry as s, json as t, DefineProviderContext as u };

package/dist/index.d.ts

@@ -1,8 +1,9 @@
-import { a as Sender, c as buildSenderRegistry, d as ServiceProvider, f as defineProvider, i as http, l as DefineProviderContext, m as defineTransport, n as slack, o as SenderRegistry, p as Transport, r as HttpPayload, s as SenderUrl, t as json, u as DefineProviderOptions } from "./index-I_frtEQ-.js";
+import { a as http, c as SenderUrl, d as DefineProviderOptions, f as ServiceProvider, h as defineTransport, i as HttpPayload, l as buildSenderRegistry, m as Transport, n as telegram, o as Sender, p as defineProvider, r as slack, s as SenderRegistry, t as json, u as DefineProviderContext } from "./index-DIqKYuP3.js";
 
 //#region src/index.d.ts
+
 declare const senderRegistry: SenderRegistry;
 declare function createSender(urls: SenderUrl[]): Sender;
 declare function send(url: string | URL, title: string, body?: string): Promise<void>;
 //#endregion
-export { DefineProviderContext, DefineProviderOptions, HttpPayload, Sender, SenderRegistry, SenderUrl, ServiceProvider, Transport, buildSenderRegistry, createSender, defineProvider, defineTransport, http, json, send, senderRegistry, slack };
+export { DefineProviderContext, DefineProviderOptions, HttpPayload, Sender, SenderRegistry, SenderUrl, ServiceProvider, Transport, buildSenderRegistry, createSender, defineProvider, defineTransport, http, json, send, senderRegistry, slack, telegram };

package/dist/index.js

@@ -1,7 +1,11 @@
-import { a as defineTransport, i as http, n as json, o as defineProvider, r as slack, s as assert, t as buildSenderRegistry } from "./shared-vzO3pF63.js";
+import { a as http, c as assert, i as slack, n as json, o as defineTransport, r as telegram, s as defineProvider, t as buildSenderRegistry } from "./shared-DBiCYY_-.js";
 
 //#region src/index.ts
-const senderRegistry = buildSenderRegistry([json, slack]);
+const senderRegistry = buildSenderRegistry([
+	json,
+	slack,
+	telegram
+]);
 function createSender(urls) {
 	return senderRegistry(urls);
 }
@@ -17,4 +21,4 @@ async function send(url, title, body) {
 }
 
 //#endregion
-export { buildSenderRegistry, createSender, defineProvider, defineTransport, http, json, send, senderRegistry, slack };
+export { buildSenderRegistry, createSender, defineProvider, defineTransport, http, json, send, senderRegistry, slack, telegram };

package/dist/{shared-vzO3pF63.js → shared-DBiCYY_-.js}

@@ -1,12 +1,28 @@
+import { getQuery, withProtocol, withoutLeadingSlash } from "ufo";
 import defu from "defu";
 import { ofetch } from "ofetch";
-import { withProtocol, withoutLeadingSlash } from "ufo";
+import z from "zod";
 
 //#region src/utils/assert.ts
 function assert(condition, message) {
 	if (!condition) throw typeof message === "string" ? new Error(message) : message;
 }
 
+//#endregion
+//#region src/utils/markdown.ts
+/**
+* Escape special characters: _*[]()~`>#+-=|{}.!
+*/
+function escapeMarkdown(text) {
+	return text.replace(/([_*[\]()~`>#+\-=|{}.!])/g, "\\$1");
+}
+
+//#endregion
+//#region src/utils/url.ts
+function getValidateQuery(url, parser) {
+	return parser(getQuery(url.toString()));
+}
+
 //#endregion
 //#region src/core/provider.ts
 function defineProvider(protocol, createOptions) {
@@ -17,7 +33,7 @@ function defineProvider(protocol, createOptions) {
 			url,
 			message
 		};
-		const opts = defu(createOptions.defaultOptions ?? {}, options ?? {});
+		const opts = defu(options ?? {}, createOptions.defaultOptions ?? {});
 		const payload = await createOptions.prepare.call(ctx, ctx, opts);
 		await createOptions.transport.send(payload);
 	};
@@ -112,6 +128,57 @@ const slack = defineProvider("slack:", {
 	}
 });
 
+//#endregion
+//#region src/services/chat/telegram/index.ts
+const telegramQuerySchema = z.object({ parse_mode: z.enum([
+	"Markdown",
+	"MarkdownV2",
+	"HTML"
+]).optional() });
+const telegram = defineProvider("telegram:", {
+	transport: http,
+	defaultOptions: { apiBaseUrl: "https://api.telegram.org" },
+	async prepare(_, options) {
+		const { url } = this;
+		assert(url.hostname === "bot", `Invalid telegram URL: ${url.toString()}`);
+		assert(url.username, "Bot token is required");
+		const pathSegments = url.pathname.split("/").filter(Boolean);
+		assert(pathSegments.length > 0, "At least one chat ID is required");
+		const queryResult = getValidateQuery(url, telegramQuerySchema.safeParse);
+		if (!queryResult.success) throw new Error("Invalid telegram query");
+		const query = queryResult.data;
+		const botToken = `${url.username}:${url.password}`;
+		const chatPart = decodeURIComponent(pathSegments[0]);
+		const [chatId, messageThreadId] = chatPart.includes(":") ? chatPart.split(":", 2) : [chatPart, void 0];
+		const requestUrl = new URL(`/bot${botToken}/sendMessage`, options.apiBaseUrl);
+		const headers = new Headers([["Content-Type", "application/json"]]);
+		let text;
+		if (this.message.body) {
+			const parseMode = query.parse_mode;
+			let titleFormatted;
+			if (parseMode === "HTML") titleFormatted = `<b>${this.message.title}</b>`;
+			else if (parseMode === "MarkdownV2") titleFormatted = `*${escapeMarkdown(this.message.title)}*`;
+			else titleFormatted = `*${this.message.title}*`;
+			text = `${titleFormatted}\n\n${this.message.body}`;
+		} else if (query.parse_mode === "MarkdownV2") text = escapeMarkdown(this.message.title);
+		else text = this.message.title;
+		const body = {
+			chat_id: chatId,
+			text,
+			parse_mode: query.parse_mode
+		};
+		if (messageThreadId) body.message_thread_id = Number.parseInt(messageThreadId, 10);
+		return {
+			request: new Request(requestUrl, {
+				method: "POST",
+				headers,
+				body: JSON.stringify(body)
+			}),
+			fetchOptions: options.fetchOptions
+		};
+	}
+});
+
 //#endregion
 //#region src/services/specialized/json/index.ts
 const json = defineProvider("json:", {
@@ -177,4 +244,4 @@ function buildSenderRegistry(providers) {
 }
 
 //#endregion
-export { defineTransport as a, http as i, json as n, defineProvider as o, slack as r, assert as s, buildSenderRegistry as t };
+export { http as a, assert as c, slack as i, json as n, defineTransport as o, telegram as r, defineProvider as s, buildSenderRegistry as t };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "statocysts",
   "type": "module",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Notification library for JavaScript",
   "license": "MIT",
   "homepage": "https://github.com/octoplorer/statocysts",
@@ -52,7 +52,7 @@
     "zod": "^4.2.1"
   },
   "devDependencies": {
-    "@types/node": "^25.0.2",
+    "@types/node": "^25.0.3",
     "@vitest/coverage-v8": "4.0.16",
     "tsdown": "^0.18.1",
     "typescript": "^5.9.3",