@astro-minimax/notify 0.1.0 → 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Souloss
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -232,8 +232,8 @@ interface AiChatEvent {
 你好！AI 对话通知功能测试成功...
 
 📎 引用文章:
-  · 京都马拉松
-  · 东京旅行
+  · 2026 年个人技术博客生态全览：从零构建你的博客系统
+  · 为什么选择 astro-minimax：设计决策与技术思考
 
 ⚙️ 模型配置:
   · API Host: api.openai.com

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { createNotifier } from './notify.js';
+export { createNotifier, getNotifier, resetNotifier } from './notify.js';
 export type { NotifyConfig, NotifyEvent, CommentEvent, AiChatEvent, ArticleRef, ModelInfo, TokenUsage, PhaseTiming, NotifyResult, SendResult, Notifier, EventTemplates, Logger, TelegramConfig, WebhookConfig, EmailConfig, TelegramTemplate, WebhookPayload, EmailTemplate, Channel, EventType, } from './types.js';
 export { defaultTemplates } from './templates/index.js';
 export { createTelegramProvider, createWebhookProvider, createEmailProvider, } from './providers/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,UAAU,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,cAAc,EACd,MAAM,EACN,cAAc,EACd,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,OAAO,EACP,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACzE,YAAY,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,UAAU,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,cAAc,EACd,MAAM,EACN,cAAc,EACd,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,OAAO,EACP,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,3 +1,3 @@
-export { createNotifier } from './notify.js';
+export { createNotifier, getNotifier, resetNotifier } from './notify.js';
 export { defaultTemplates } from './templates/index.js';
 export { createTelegramProvider, createWebhookProvider, createEmailProvider, } from './providers/index.js';

package/dist/notify.d.ts

@@ -1,3 +1,13 @@
 import type { NotifyConfig, Notifier } from './types.js';
+/**
+ * Returns a cached notifier instance if the config matches the previous one.
+ * Creates a new instance only when the config changes.
+ * This optimization avoids recreating provider instances on every request.
+ */
+export declare function getNotifier(config: NotifyConfig): Notifier;
+/**
+ * Resets the singleton instance (useful for testing).
+ */
+export declare function resetNotifier(): void;
 export declare function createNotifier(config: NotifyConfig): Notifier;
 //# sourceMappingURL=notify.d.ts.map

package/dist/notify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../src/notify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAMZ,QAAQ,EAIT,MAAM,YAAY,CAAC;AAkDpB,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,CA4H7D"}
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../src/notify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAMZ,QAAQ,EAIT,MAAM,YAAY,CAAC;AAwEpB;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,CAU1D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAGpC;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,CA4H7D"}

package/dist/notify.js

@@ -27,6 +27,47 @@ function mergeTemplates(custom) {
         },
     };
 }
+// Singleton instance and its config hash for caching
+let notifierInstance = null;
+let lastConfigHash = null;
+/**
+ * Computes a simple hash of the notify config for singleton caching.
+ * Only includes fields that affect provider creation.
+ */
+function computeConfigHash(config) {
+    const parts = [];
+    if (config.telegram) {
+        parts.push(`telegram:${config.telegram.botToken}:${config.telegram.chatId}`);
+    }
+    if (config.webhook) {
+        parts.push(`webhook:${config.webhook.url}`);
+    }
+    if (config.email) {
+        parts.push(`email:${config.email.provider}:${config.email.apiKey}:${config.email.from}:${config.email.to}`);
+    }
+    return parts.join('|');
+}
+/**
+ * Returns a cached notifier instance if the config matches the previous one.
+ * Creates a new instance only when the config changes.
+ * This optimization avoids recreating provider instances on every request.
+ */
+export function getNotifier(config) {
+    const hash = computeConfigHash(config);
+    if (notifierInstance && hash === lastConfigHash) {
+        return notifierInstance;
+    }
+    notifierInstance = createNotifier(config);
+    lastConfigHash = hash;
+    return notifierInstance;
+}
+/**
+ * Resets the singleton instance (useful for testing).
+ */
+export function resetNotifier() {
+    notifierInstance = null;
+    lastConfigHash = null;
+}
 export function createNotifier(config) {
     const logger = config.logger ?? new DefaultLogger();
     const templates = mergeTemplates(config.templates);

package/dist/providers/email.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/providers/email.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAElF,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACpD;AAoBD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,aAAa,CA8Ef"}
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/providers/email.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAElF,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACpD;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,aAAa,CA4Ef"}

package/dist/providers/email.js

@@ -1,19 +1,3 @@
-let proxyConfigured = false;
-async function configureProxy() {
-    if (proxyConfigured)
-        return;
-    const proxyUrl = process.env.HTTPS_PROXY || process.env.https_proxy || process.env.HTTP_PROXY || process.env.http_proxy;
-    if (proxyUrl) {
-        try {
-            const { setGlobalDispatcher, ProxyAgent } = await import('undici');
-            setGlobalDispatcher(new ProxyAgent(proxyUrl));
-            proxyConfigured = true;
-        }
-        catch {
-            // ProxyAgent not available, continue without proxy
-        }
-    }
-}
 export function createEmailProvider(config, logger) {
     const { provider, apiKey, from, to } = config;
     return {
@@ -28,7 +12,6 @@ export function createEmailProvider(config, logger) {
                 };
             }
             try {
-                await configureProxy();
                 const response = await fetch('https://api.resend.com/emails', {
                     method: 'POST',
                     headers: {

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

@@ -1 +1 @@
-{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/providers/telegram.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAExF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACvD;AAoBD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,cAAc,EACtB,MAAM,CAAC,EAAE,MAAM,GACd,gBAAgB,CAmElB"}
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/providers/telegram.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAExF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACvD;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,cAAc,EACtB,MAAM,CAAC,EAAE,MAAM,GACd,gBAAgB,CAqElB"}

package/dist/providers/telegram.js

@@ -1,26 +1,12 @@
-let proxyConfigured = false;
-async function configureProxy() {
-    if (proxyConfigured)
-        return;
-    const proxyUrl = process.env.HTTPS_PROXY || process.env.https_proxy || process.env.HTTP_PROXY || process.env.http_proxy;
-    if (proxyUrl) {
-        try {
-            const { setGlobalDispatcher, ProxyAgent } = await import('undici');
-            setGlobalDispatcher(new ProxyAgent(proxyUrl));
-            proxyConfigured = true;
-        }
-        catch {
-            // ProxyAgent not available, continue without proxy
-        }
-    }
-}
 export function createTelegramProvider(config, logger) {
     const { botToken, chatId } = config;
     return {
         async send(template) {
             const start = Date.now();
             try {
-                await configureProxy();
+                // Note: Proxy configuration is not supported in Cloudflare Edge Runtime.
+                // If you need proxy support, consider using a dedicated proxy service
+                // or running the notification service in a Node.js environment.
                 const url = `https://api.telegram.org/bot${botToken}/sendMessage`;
                 const response = await fetch(url, {
                     method: 'POST',

package/dist/templates/comment.js

@@ -74,6 +74,12 @@ export function emailTemplate(event) {
     };
 }
 function escapeHtml(text) {
+    if (text === null || text === undefined) {
+        return '';
+    }
+    if (typeof text !== 'string') {
+        return String(text);
+    }
     return text
         .replace(/&/g, '&')
         .replace(/</g, '&lt;')

package/package.json

@@ -1,10 +1,27 @@
 {
   "name": "@astro-minimax/notify",
-  "version": "0.1.0",
+  "version": "0.7.0",
   "type": "module",
-  "description": "Multi-channel notification package for astro-minimax blogs",
+  "description": "Multi-channel notification package for astro-minimax blogs — supports Telegram, Email (Resend), and more.",
   "author": "Souloss",
   "license": "MIT",
+  "keywords": [
+    "astro",
+    "notification",
+    "telegram",
+    "email",
+    "resend",
+    "webhook"
+  ],
+  "homepage": "https://github.com/souloss/astro-minimax#readme",
+  "bugs": {
+    "url": "https://github.com/souloss/astro-minimax/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/souloss/astro-minimax",
+    "directory": "packages/notify"
+  },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -18,15 +35,10 @@
     "dist/"
   ],
   "sideEffects": false,
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "build:watch": "tsc -p tsconfig.build.json --watch",
-    "clean": "rm -rf dist",
-    "prepublishOnly": "pnpm run clean && pnpm run build",
-    "publish": "npm publish --access public"
-  },
   "dependencies": {
-    "grammy": "^1.41.1",
+    "grammy": "^1.41.1"
+  },
+  "optionalDependencies": {
     "undici": "^6.0.0"
   },
   "peerDependencies": {
@@ -43,6 +55,13 @@
     "typescript": "^5.9.3"
   },
   "engines": {
-    "node": ">=22.12.0"
+    "node": ">=22.12.0",
+    "pnpm": ">=9.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "build:watch": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
   }
-}
+}