@spfn/notification 0.1.0-beta.2 → 0.1.0-beta.3

package/dist/server.d.ts

@@ -736,6 +736,12 @@ interface ErrorSlackOptions {
      * @default 500
      */
     minStatusCode?: number;
+    /**
+     * Throttle window in milliseconds.
+     * Duplicate errors (same name + statusCode + path) within this window are suppressed.
+     * @default 60_000
+     */
+    throttleMs?: number;
     /**
      * Webhook URL override (defaults to env/config)
      */
@@ -752,6 +758,7 @@ interface ErrorSlackOptions {
  * Create an onError callback that sends Slack notifications
  *
  * Returns a function matching ErrorHandler's onError signature.
+ * Duplicate errors (same name + statusCode + path) within `throttleMs` are suppressed.
  */
 declare function createErrorSlackNotifier(options?: ErrorSlackOptions): (err: Error, ctx: ErrorContext) => Promise<void>;
 

package/dist/server.js

@@ -3900,7 +3900,11 @@ function shortStack(err, maxLines = 3) {
   const lines = err.stack.split("\n").slice(1);
   return lines.slice(0, maxLines).map((line) => line.trim()).join("\n");
 }
-function defaultFormat(err, ctx) {
+var throttleMap = /* @__PURE__ */ new Map();
+function throttleKey(err, ctx) {
+  return `${err.name}:${ctx.statusCode}:${ctx.path}`;
+}
+function defaultFormat(err, ctx, suppressed = 0) {
   const emoji = ctx.statusCode >= 500 ? ":rotating_light:" : ":warning:";
   const title = `${emoji} *${err.name || "Error"}* \u2014 ${ctx.statusCode}`;
   const fields = [
@@ -3929,11 +3933,12 @@ ${ctx.requestId ?? "(none)"}` }
       type: "section",
       fields
     },
-    // Timestamp
+    // Timestamp + suppressed count
     {
       type: "context",
       elements: [
-        { type: "mrkdwn", text: `*Time:* ${ctx.timestamp}` }
+        { type: "mrkdwn", text: `*Time:* ${ctx.timestamp}` },
+        ...suppressed > 0 ? [{ type: "mrkdwn", text: `_+${suppressed} suppressed since last notification_` }] : []
       ]
     },
     { type: "divider" },
@@ -3960,12 +3965,21 @@ ${ctx.requestId ?? "(none)"}` }
   return { text: title, blocks };
 }
 function createErrorSlackNotifier(options = {}) {
-  const { minStatusCode = 500 } = options;
+  const { minStatusCode = 500, throttleMs = 6e4 } = options;
   return async (err, ctx) => {
     if (ctx.statusCode < minStatusCode) {
       return;
     }
-    const message = options.formatMessage?.(err, ctx) ?? defaultFormat(err, ctx);
+    const key = throttleKey(err, ctx);
+    const now = Date.now();
+    const entry = throttleMap.get(key);
+    if (entry && now - entry.lastSent < throttleMs) {
+      entry.suppressed++;
+      return;
+    }
+    const suppressed = entry?.suppressed ?? 0;
+    throttleMap.set(key, { lastSent: now, suppressed: 0 });
+    const message = options.formatMessage?.(err, ctx) ?? defaultFormat(err, ctx, suppressed);
     await sendSlack({
       ...message,
       webhookUrl: options.webhookUrl