@hookflo/tern 4.2.1-beta → 4.2.5-beta

package/dist/alerts.d.ts

@@ -1,5 +1,5 @@
 export * from './notifications';
-export declare const __alertInternals: {
+export declare const alertInternals: {
     resolveDestinations: typeof import("./notifications/utils").resolveDestinations;
     normalizeAlertOptions: typeof import("./notifications/utils").normalizeAlertOptions;
     buildSlackPayload: typeof import("./notifications/channels/slack").buildSlackPayload;

package/dist/alerts.js

@@ -14,8 +14,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.__alertInternals = void 0;
-__exportStar(require("./notifications"), exports);
+exports.alertInternals = void 0;
 const notifications_1 = require("./notifications");
+__exportStar(require("./notifications"), exports);
 // Backward-compatible alias used by previous version internals.
-exports.__alertInternals = notifications_1.__notificationInternals;
+exports.alertInternals = notifications_1.notificationInternals;

package/dist/notifications/channels/discord/build-payload.d.ts

@@ -1,4 +1,4 @@
-import type { AlertPayloadBuilderInput } from '../../types';
+import type { AlertPayloadBuilderInput } from "../../types";
 export declare function buildDiscordPayload(input: AlertPayloadBuilderInput): {
     embeds: {
         title: string;

package/dist/notifications/channels/discord/build-payload.js

@@ -4,34 +4,44 @@ exports.buildDiscordPayload = buildDiscordPayload;
 const utils_1 = require("../../utils");
 const constants_1 = require("../../constants");
 function buildDiscordPayload(input) {
-    const fields = [
-        {
-            name: 'Severity',
-            value: input.severity.toUpperCase(),
-            inline: true,
-        },
-    ];
-    if (input.eventId) {
-        fields.push({ name: 'Event ID', value: `\`${input.eventId}\``, inline: true });
-    }
+    const isDLQ = input.dlq;
+    const title = isDLQ ? "Dead Letter Queue — Event Failed" : "Webhook Received";
+    const description = isDLQ
+        ? "Event exhausted all retries. Manual replay required."
+        : "Event verified and queued for processing.";
+    const fields = [];
     if (input.source) {
-        fields.push({ name: 'Source', value: input.source, inline: true });
+        fields.push({ name: "Platform", value: input.source, inline: true });
     }
-    if (input.dlq) {
-        fields.push({ name: 'Queue', value: 'DLQ', inline: true });
+    fields.push({
+        name: "Severity",
+        value: input.severity.toLowerCase(),
+        inline: true,
+    });
+    if (isDLQ) {
+        fields.push({ name: "Queue", value: "dlq", inline: true });
+    }
+    if (input.eventId) {
+        fields.push({
+            name: isDLQ ? "DLQ ID" : "Event ID",
+            value: `\`${input.eventId}\``,
+            inline: false,
+        });
     }
     const metadataString = (0, utils_1.compactMetadata)(input.metadata);
     if (metadataString) {
-        fields.push({ name: 'Details', value: `\`\`\`${metadataString}\`\`\`` });
+        fields.push({ name: "Details", value: `\`\`\`${metadataString}\`\`\`` });
     }
-    const replayLine = input.replayUrl ? `\n\n[${input.replayLabel}](${input.replayUrl})` : '';
-    const footerText = input.branding === false ? undefined : 'Alert from Tern • tern.hookflo.com';
+    const replayLine = input.replayUrl
+        ? `\n\n[${input.replayLabel ?? "Replay Event"}](${input.replayUrl})`
+        : "";
+    const footerText = input.branding === false ? undefined : "Alert from Tern · tern.hookflo.com";
     return {
         embeds: [
             {
-                title: input.title,
-                description: `${input.message}${replayLine}`,
-                color: parseInt(constants_1.severityColorMap[input.severity].replace('#', ''), 16),
+                title,
+                description: `${description}${replayLine}`,
+                color: parseInt(constants_1.severityColorMap[input.severity].replace("#", ""), 16),
                 fields,
                 footer: footerText ? { text: footerText } : undefined,
                 timestamp: new Date().toISOString(),

package/dist/notifications/channels/slack/build-payload.d.ts

@@ -1,4 +1,4 @@
-import type { AlertPayloadBuilderInput } from '../../types';
+import type { AlertPayloadBuilderInput } from "../../types";
 export declare function buildSlackPayload(input: AlertPayloadBuilderInput): {
     text: string;
     blocks: Record<string, unknown>[];

package/dist/notifications/channels/slack/build-payload.js

@@ -4,29 +4,33 @@ exports.buildSlackPayload = buildSlackPayload;
 const utils_1 = require("../../utils");
 const constants_1 = require("../../constants");
 function buildSlackPayload(input) {
+    const isDLQ = input.dlq;
+    const title = isDLQ ? "Dead Letter Queue — Event Failed" : "Webhook Received";
+    const message = isDLQ
+        ? "Event exhausted all retries. Manual replay required."
+        : "Event verified and queued for processing.";
     const fields = [
-        input.eventId ? { type: 'mrkdwn', text: `*Event ID*\n\`${input.eventId}\`` } : null,
-        input.source ? { type: 'mrkdwn', text: `*Source*\n${input.source}` } : null,
+        input.source
+            ? { type: "mrkdwn", text: `*Platform*\n${input.source}` }
+            : null,
         {
-            type: 'mrkdwn',
-            text: `*Severity*\n${input.severity.toUpperCase()}`,
+            type: "mrkdwn",
+            text: `*Severity*\n${input.severity.toLowerCase()}`,
         },
-        input.dlq ? { type: 'mrkdwn', text: '*Queue*\nDLQ' } : null,
+        isDLQ ? { type: "mrkdwn", text: "*Queue*\ndlq" } : null,
+        input.eventId
+            ? {
+                type: "mrkdwn",
+                text: `*${isDLQ ? "DLQ ID" : "Event ID"}*\n\`${input.eventId}\``,
+            }
+            : null,
     ].filter(Boolean);
     const blocks = [
         {
-            type: 'header',
+            type: "section",
             text: {
-                type: 'plain_text',
-                text: input.title,
-                emoji: true,
-            },
-        },
-        {
-            type: 'section',
-            text: {
-                type: 'mrkdwn',
-                text: input.message,
+                type: "mrkdwn",
+                text: `*${title}*\n${message}`,
             },
             fields,
         },
@@ -34,43 +38,43 @@ function buildSlackPayload(input) {
     const metadataString = (0, utils_1.compactMetadata)(input.metadata);
     if (metadataString) {
         blocks.push({
-            type: 'section',
+            type: "section",
             text: {
-                type: 'mrkdwn',
-                text: `*Details*\n\`\`\`${metadataString}\`\`\``,
+                type: "mrkdwn",
+                text: `\`\`\`${metadataString}\`\`\``,
             },
         });
     }
     if (input.replayUrl) {
         blocks.push({
-            type: 'actions',
+            type: "actions",
             elements: [
                 {
-                    type: 'button',
+                    type: "button",
                     text: {
-                        type: 'plain_text',
-                        text: input.replayLabel,
-                        emoji: true,
+                        type: "plain_text",
+                        text: input.replayLabel ?? "Replay Event",
+                        emoji: false,
                     },
                     url: input.replayUrl,
-                    style: 'primary',
+                    style: "danger",
                 },
             ],
         });
     }
     if (input.branding !== false) {
         blocks.push({
-            type: 'context',
+            type: "context",
             elements: [
                 {
-                    type: 'mrkdwn',
+                    type: "mrkdwn",
                     text: `Alert from <${constants_1.TERN_BRAND_URL}|Tern>`,
                 },
             ],
         });
     }
     return {
-        text: `${input.title} - ${input.message}`,
+        text: title,
         blocks,
     };
 }

package/dist/notifications/index.d.ts

@@ -1,8 +1,8 @@
-export * from './types';
 import { normalizeAlertOptions, resolveDestinations } from './utils';
 import { buildSlackPayload } from './channels/slack';
 import { buildDiscordPayload } from './channels/discord';
-export declare const __notificationInternals: {
+export * from './types';
+export declare const notificationInternals: {
     resolveDestinations: typeof resolveDestinations;
     normalizeAlertOptions: typeof normalizeAlertOptions;
     buildSlackPayload: typeof buildSlackPayload;

package/dist/notifications/index.js

@@ -14,12 +14,12 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.__notificationInternals = void 0;
-__exportStar(require("./types"), exports);
+exports.notificationInternals = void 0;
 const utils_1 = require("./utils");
 const slack_1 = require("./channels/slack");
 const discord_1 = require("./channels/discord");
-exports.__notificationInternals = {
+__exportStar(require("./types"), exports);
+exports.notificationInternals = {
     resolveDestinations: utils_1.resolveDestinations,
     normalizeAlertOptions: utils_1.normalizeAlertOptions,
     buildSlackPayload: slack_1.buildSlackPayload,

package/dist/notifications/utils.js

@@ -10,6 +10,36 @@ function compactMetadata(metadata) {
     const entries = Object.entries(metadata).slice(0, 8);
     return entries.map(([key, value]) => `${key}: ${String(value)}`).join('\n');
 }
+function asNonEmptyString(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value : undefined;
+}
+function asObject(value) {
+    return value && typeof value === 'object' ? value : undefined;
+}
+function resolveSource(options) {
+    const metadata = options.metadata || {};
+    return asNonEmptyString(options.source)
+        || asNonEmptyString(metadata.source)
+        || asNonEmptyString(metadata.platform)
+        || asNonEmptyString(metadata.provider);
+}
+function resolveEventId(options) {
+    const metadata = options.metadata || {};
+    const metadataPayload = asObject(metadata.payload);
+    const metadataEvent = asObject(metadata.event);
+    const metadataData = asObject(metadata.data);
+    return asNonEmptyString(options.eventId)
+        || asNonEmptyString(options.dlqId)
+        || asNonEmptyString(metadata.eventId)
+        || asNonEmptyString(metadata.messageId)
+        || asNonEmptyString(metadata.webhookId)
+        || asNonEmptyString(metadata.id)
+        || asNonEmptyString(metadataPayload?.id)
+        || asNonEmptyString(metadataPayload?.eventId)
+        || asNonEmptyString(metadataPayload?.request_id)
+        || asNonEmptyString(metadataEvent?.id)
+        || asNonEmptyString(metadataData?.id);
+}
 function resolveDestinations(config) {
     const destinations = [];
     if (config.slack?.enabled !== false && config.slack?.webhookUrl) {
@@ -29,10 +59,11 @@ function normalizeAlertOptions(options) {
     return {
         ...options,
         dlq: isDlq,
+        source: resolveSource(options),
         title,
         message,
         severity,
         replayLabel,
-        eventId: options.eventId || options.dlqId,
+        eventId: resolveEventId(options),
     };
 }

package/dist/upstash/controls.js

@@ -117,6 +117,22 @@ function createTernControls(config) {
         },
         async alert(options = {}) {
             let replayMeta = {};
+            let resolvedSource = options.source;
+            let resolvedEventId = options.eventId;
+            if (options.dlq && (!resolvedSource || !resolvedEventId)) {
+                try {
+                    const dlqMessages = await this.dlq();
+                    const matchingMessage = dlqMessages.find((message) => message.dlqId === options.dlqId);
+                    resolvedSource = resolvedSource || matchingMessage?.platform;
+                    resolvedEventId = resolvedEventId || matchingMessage?.id;
+                }
+                catch (error) {
+                    replayMeta = {
+                        ...replayMeta,
+                        dlqLookupError: error.message,
+                    };
+                }
+            }
             if (options.dlq) {
                 if (!options.dlqId || options.dlqId.trim() === '') {
                     throw new Error('[tern] controls.alert() with dlq: true requires dlqId.');
@@ -148,9 +164,12 @@ function createTernControls(config) {
                     : undefined,
             }, {
                 ...options,
-                eventId: options.eventId || options.dlqId,
+                source: resolvedSource,
+                eventId: resolvedEventId || options.dlqId,
                 metadata: {
                     ...(options.metadata || {}),
+                    source: resolvedSource || options.metadata?.source,
+                    eventId: resolvedEventId || options.metadata?.eventId,
                     ...replayMeta,
                 },
             });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hookflo/tern",
-  "version": "4.2.1-beta",
+  "version": "4.2.5-beta",
   "description": "A robust, scalable webhook verification framework supporting multiple platforms and signature algorithms",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",