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

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,22 @@ 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.
+ *
+ * @deprecated Use `createMonitorErrorHandler()` from `@spfn/monitor/server` instead.
+ * It provides DB-backed error tracking with fingerprint deduplication,
+ * state-based notifications (new/reopened), and an admin dashboard.
+ *
+ * Migration:
+ * ```typescript
+ * // Before
+ * import { createErrorSlackNotifier } from '@spfn/notification/server';
+ * middleware: { onError: createErrorSlackNotifier() }
+ *
+ * // After
+ * import { createMonitorErrorHandler } from '@spfn/monitor/server';
+ * middleware: { onError: createMonitorErrorHandler() }
+ * ```
  */
 declare function createErrorSlackNotifier(options?: ErrorSlackOptions): (err: Error, ctx: ErrorContext) => Promise<void>;
 

package/dist/server.js

@@ -3879,6 +3879,7 @@ var notificationJobRouter = defineJobRouter({
 });
 
 // src/integrations/error-slack.ts
+import { hostname } from "os";
 function formatHeaders(headers) {
   const entries = Object.entries(headers);
   if (entries.length === 0) {
@@ -3900,9 +3901,21 @@ 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 getEnvLabel() {
+  const env2 = process.env.NODE_ENV || "unknown";
+  const host = hostname();
+  const dbUrl = process.env.DATABASE_URL || "";
+  const dbName = dbUrl.match(/\/([^/?]+)(\?|$)/)?.[1] || "(unknown)";
+  return `${env2} | ${host} | db:${dbName}`;
+}
+function defaultFormat(err, ctx, suppressed = 0) {
+  const envLabel = getEnvLabel();
   const emoji = ctx.statusCode >= 500 ? ":rotating_light:" : ":warning:";
-  const title = `${emoji} *${err.name || "Error"}* \u2014 ${ctx.statusCode}`;
+  const title = `${emoji} *${err.name || "Error"}* \u2014 ${ctx.statusCode} [${envLabel}]`;
   const fields = [
     { type: "mrkdwn", text: `*Method*
 ${ctx.method}` },
@@ -3929,11 +3942,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 +3974,24 @@ ${ctx.requestId ?? "(none)"}` }
   return { text: title, blocks };
 }
 function createErrorSlackNotifier(options = {}) {
-  const { minStatusCode = 500 } = options;
+  console.warn(
+    "[@spfn/notification] createErrorSlackNotifier() is deprecated. Use createMonitorErrorHandler() from @spfn/monitor/server instead."
+  );
+  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