dsh-messager 0.1.4 → 0.2.0

package/lib/channels/telegram.js

@@ -0,0 +1,52 @@
+/**
+ * Telegram 通道（Bot API）：sendMessage（HTML parse_mode），host 端投递。
+ *
+ * 端点 = https://api.telegram.org/bot<token>/sendMessage（token 即凭证，走 URL 路径）。
+ * 成功判定：HTTP 2xx 且响应 ok === true。
+ * HTML parse_mode 必须转义 & < > " '，否则非法标签会导致 API 400。
+ * 限制守卫：text ≤ 4096 字符。
+ */
+export const TELEGRAM_API_BASE = 'https://api.telegram.org';
+/** HTML 转义（纯函数）：& < > " '。 */
+export function escapeHtml(text) {
+    return text
+        .replaceAll('&', '&amp;')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;')
+        .replaceAll('"', '&quot;')
+        .replaceAll("'", '&#39;');
+}
+/** 构建 sendMessage 载荷（纯函数；text ≤ 4096 兜底）。 */
+export function buildTelegramPayload(payload, chatId) {
+    const lines = [`<b>${escapeHtml(payload.title)}</b>`];
+    if (payload.body !== '')
+        lines.push(escapeHtml(payload.body));
+    lines.push(`<a href="${escapeHtml(payload.url)}">打开 DSH</a>`);
+    return {
+        chat_id: chatId,
+        text: lines.join('\n').slice(0, 4096),
+        parse_mode: 'HTML',
+        link_preview_options: { is_disabled: true },
+    };
+}
+export function createTelegramChannel(options) {
+    return {
+        id: 'telegram',
+        async send(payload) {
+            const endpoint = `${TELEGRAM_API_BASE}/bot${options.botToken}/sendMessage`;
+            const response = await fetch(endpoint, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify(buildTelegramPayload(payload, options.chatId)),
+                signal: AbortSignal.timeout(options.timeoutMs),
+            });
+            if (!response.ok)
+                throw new Error(`telegram API responded ${response.status}`);
+            const result = (await response.json().catch(() => undefined));
+            if (result !== undefined && result.ok !== true) {
+                throw new Error(`telegram rejected: ${result.description ?? 'unknown error'}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=telegram.js.map

package/lib/channels/telegram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.js","sourceRoot":"","sources":["../../src/channels/telegram.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,MAAM,CAAC,MAAM,iBAAiB,GAAG,0BAA0B,CAAA;AAE3D,8BAA8B;AAC9B,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI;SACR,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC;SACzB,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;AAC7B,CAAC;AAUD,6CAA6C;AAC7C,MAAM,UAAU,oBAAoB,CAAC,OAA4B,EAAE,MAAc;IAC/E,MAAM,KAAK,GAAG,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IACrD,IAAI,OAAO,CAAC,IAAI,KAAK,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IAC7D,KAAK,CAAC,IAAI,CAAC,YAAY,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;IAC7D,OAAO;QACL,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;QACrC,UAAU,EAAE,MAAM;QAClB,oBAAoB,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;KAC5C,CAAA;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAA+B;IACnE,OAAO;QACL,EAAE,EAAE,UAAU;QACd,KAAK,CAAC,IAAI,CAAC,OAA4B;YACrC,MAAM,QAAQ,GAAG,GAAG,iBAAiB,OAAO,OAAO,CAAC,QAAQ,cAAc,CAAA;YAC1E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;gBACrC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBACnE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;aAC/C,CAAC,CAAA;YACF,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;YAC9E,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAuD,CAAA;YACnH,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,WAAW,IAAI,eAAe,EAAE,CAAC,CAAA;YAChF,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/lib/channels/wecom.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 企业微信群机器人通道（webhook）：POST markdown 消息，host 端投递。
+ *
+ * 消息：msgtype=markdown，content 为「加粗标题 + 正文 + 打开链接」。
+ * 可选加签（机器人「安全设置-加签」）：
+ *   string_to_sign = `${timestamp}\n${secret}`
+ *   sign = base64(HmacSHA256(string_to_sign, key=secret))   // 无需 URL 编码
+ * 追加为查询参数 &timestamp=<ts>&sign=<sign>（与钉钉不同：钉钉需要 urlEncode）。
+ * 成功判定：HTTP 2xx 且响应 errcode === 0。
+ */
+import type { NotifyChannel, NotificationPayload } from '../notify.js';
+export interface WecomChannelOptions {
+    webhookUrl: string;
+    /** 加签密钥（机器人「安全设置-加签」），配置后按企业微信规范签名。 */
+    secret?: string;
+    timeoutMs: number;
+}
+/** 企业微信 markdown 消息载荷。 */
+export interface WecomMarkdownPayload {
+    msgtype: 'markdown';
+    markdown: {
+        content: string;
+    };
+}
+/** 构建企业微信 markdown 消息（纯函数；content 限 4000 字符兜底）。 */
+export declare function buildWecomPayload(payload: NotificationPayload): WecomMarkdownPayload;
+/**
+ * 企业微信加签：
+ *   sign = base64(HmacSHA256(key=secret, msg=`${timestamp}\n${secret}`))，无 URL 编码。
+ * @returns 追加了 timestamp/sign 查询参数的完整 URL。
+ */
+export declare function signWecomUrl(webhookUrl: string, secret: string, timestamp: string): string;
+export declare function createWecomChannel(options: WecomChannelOptions): NotifyChannel;
+//# sourceMappingURL=wecom.d.ts.map

package/lib/channels/wecom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wecom.d.ts","sourceRoot":"","sources":["../../src/channels/wecom.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAEtE,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAA;IAClB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,0BAA0B;AAC1B,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,UAAU,CAAA;IACnB,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAC9B;AAED,mDAAmD;AACnD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,oBAAoB,CAKpF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAK1F;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,aAAa,CAoB9E"}

package/lib/channels/wecom.js

@@ -0,0 +1,53 @@
+/**
+ * 企业微信群机器人通道（webhook）：POST markdown 消息，host 端投递。
+ *
+ * 消息：msgtype=markdown，content 为「加粗标题 + 正文 + 打开链接」。
+ * 可选加签（机器人「安全设置-加签」）：
+ *   string_to_sign = `${timestamp}\n${secret}`
+ *   sign = base64(HmacSHA256(string_to_sign, key=secret))   // 无需 URL 编码
+ * 追加为查询参数 &timestamp=<ts>&sign=<sign>（与钉钉不同：钉钉需要 urlEncode）。
+ * 成功判定：HTTP 2xx 且响应 errcode === 0。
+ */
+import { createHmac } from 'node:crypto';
+/** 构建企业微信 markdown 消息（纯函数；content 限 4000 字符兜底）。 */
+export function buildWecomPayload(payload) {
+    const lines = [`**${payload.title}**`];
+    if (payload.body !== '')
+        lines.push(payload.body);
+    lines.push(`[打开 DSH](${payload.url})`);
+    return { msgtype: 'markdown', markdown: { content: lines.join('\n').slice(0, 4000) } };
+}
+/**
+ * 企业微信加签：
+ *   sign = base64(HmacSHA256(key=secret, msg=`${timestamp}\n${secret}`))，无 URL 编码。
+ * @returns 追加了 timestamp/sign 查询参数的完整 URL。
+ */
+export function signWecomUrl(webhookUrl, secret, timestamp) {
+    const stringToSign = `${timestamp}\n${secret}`;
+    const sign = createHmac('sha256', secret).update(stringToSign).digest('base64');
+    const separator = webhookUrl.includes('?') ? '&' : '?';
+    return `${webhookUrl}${separator}timestamp=${timestamp}&sign=${sign}`;
+}
+export function createWecomChannel(options) {
+    return {
+        id: 'wecom',
+        async send(payload) {
+            const url = options.secret === undefined
+                ? options.webhookUrl
+                : signWecomUrl(options.webhookUrl, options.secret, String(Math.floor(Date.now() / 1000)));
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify(buildWecomPayload(payload)),
+                signal: AbortSignal.timeout(options.timeoutMs),
+            });
+            if (!response.ok)
+                throw new Error(`wecom webhook responded ${response.status}`);
+            const result = (await response.json().catch(() => undefined));
+            if (result !== undefined && result.errcode !== 0) {
+                throw new Error(`wecom webhook rejected: errcode=${String(result.errcode)} errmsg=${String(result.errmsg)}`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=wecom.js.map

package/lib/channels/wecom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wecom.js","sourceRoot":"","sources":["../../src/channels/wecom.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAgBxC,mDAAmD;AACnD,MAAM,UAAU,iBAAiB,CAAC,OAA4B;IAC5D,MAAM,KAAK,GAAG,CAAC,KAAK,OAAO,CAAC,KAAK,IAAI,CAAC,CAAA;IACtC,IAAI,OAAO,CAAC,IAAI,KAAK,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,GAAG,GAAG,CAAC,CAAA;IACtC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAA;AACxF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB,EAAE,MAAc,EAAE,SAAiB;IAChF,MAAM,YAAY,GAAG,GAAG,SAAS,KAAK,MAAM,EAAE,CAAA;IAC9C,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC/E,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;IACtD,OAAO,GAAG,UAAU,GAAG,SAAS,aAAa,SAAS,SAAS,IAAI,EAAE,CAAA;AACvE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC7D,OAAO;QACL,EAAE,EAAE,OAAO;QACX,KAAK,CAAC,IAAI,CAAC,OAA4B;YACrC,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS;gBACtC,CAAC,CAAC,OAAO,CAAC,UAAU;gBACpB,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;YAC3F,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;gBAChD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;aAC/C,CAAC,CAAA;YACF,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;YAC/E,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAsD,CAAA;YAClH,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;gBACjD,MAAM,IAAI,KAAK,CAAC,mCAAmC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;YAC9G,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}