@astro-minimax/notify 0.5.0 → 0.7.0

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/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,6 +1,6 @@
 {
   "name": "@astro-minimax/notify",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "type": "module",
   "description": "Multi-channel notification package for astro-minimax blogs — supports Telegram, Email (Resend), and more.",
   "author": "Souloss",