@runcore-sh/runcore 0.1.2

package/dist/webhooks/event-log.js

@@ -0,0 +1,132 @@
+/**
+ * Webhook event log — ring buffer of recent webhook events for debugging.
+ *
+ * Tracks the last N webhook events (successes and failures) with timing data,
+ * provider info, and error details. Useful for debugging webhook integrations
+ * without needing to dig through activity logs.
+ *
+ * Usage:
+ *   import { logWebhookEvent, getRecentEvents } from "./event-log.js";
+ *   logWebhookEvent({ provider: "slack-events", eventType: "message", ... });
+ *   const recent = getRecentEvents({ provider: "slack-events", limit: 10 });
+ */
+// ── Ring buffer ──────────────────────────────────────────────────────────────
+const DEFAULT_MAX_SIZE = 500;
+let maxSize = DEFAULT_MAX_SIZE;
+let buffer = [];
+/** Configure the maximum number of entries to keep. */
+export function setEventLogMaxSize(size) {
+    maxSize = Math.max(10, size);
+    if (buffer.length > maxSize) {
+        buffer = buffer.slice(-maxSize);
+    }
+}
+/** Get current max size. */
+export function getEventLogMaxSize() {
+    return maxSize;
+}
+// ── Logging ──────────────────────────────────────────────────────────────────
+/**
+ * Record a webhook event in the log.
+ * Automatically generates an ID and trims the buffer if over capacity.
+ */
+export function logWebhookEvent(entry) {
+    const full = {
+        ...entry,
+        id: `evt_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+    };
+    buffer.push(full);
+    if (buffer.length > maxSize) {
+        buffer = buffer.slice(-maxSize);
+    }
+    return full;
+}
+/**
+ * Create a timing wrapper that records start time and returns a function
+ * to finalize the log entry with duration and result.
+ *
+ * Usage:
+ *   const finish = startEventTimer("slack-events", { eventType: "message" });
+ *   // ... process webhook ...
+ *   finish({ success: true, message: "OK" });
+ */
+export function startEventTimer(provider, meta) {
+    const startTime = performance.now();
+    const receivedAt = new Date().toISOString();
+    return (result) => {
+        const durationMs = Math.round((performance.now() - startTime) * 100) / 100;
+        return logWebhookEvent({
+            provider,
+            eventType: meta?.eventType,
+            deliveryId: meta?.deliveryId,
+            signatureValid: meta?.signatureValid,
+            receivedAt,
+            durationMs,
+            ...result,
+        });
+    };
+}
+// ── Querying ─────────────────────────────────────────────────────────────────
+/** Get recent webhook events, most recent first. */
+export function getRecentEvents(filter) {
+    let entries = [...buffer];
+    if (filter?.provider) {
+        entries = entries.filter((e) => e.provider === filter.provider);
+    }
+    if (filter?.success !== undefined) {
+        entries = entries.filter((e) => e.success === filter.success);
+    }
+    if (filter?.since) {
+        entries = entries.filter((e) => e.receivedAt >= filter.since);
+    }
+    // Most recent first
+    entries.reverse();
+    const limit = filter?.limit ?? 50;
+    return entries.slice(0, limit);
+}
+/** Get a summary of the event log. */
+export function getEventLogSummary() {
+    const byProvider = {};
+    let totalMs = 0;
+    for (const entry of buffer) {
+        totalMs += entry.durationMs;
+        if (!byProvider[entry.provider]) {
+            byProvider[entry.provider] = { count: 0, failures: 0, totalMs: 0 };
+        }
+        byProvider[entry.provider].count++;
+        byProvider[entry.provider].totalMs += entry.durationMs;
+        if (!entry.success) {
+            byProvider[entry.provider].failures++;
+        }
+    }
+    const successes = buffer.filter((e) => e.success).length;
+    const providerSummary = {};
+    for (const [name, stats] of Object.entries(byProvider)) {
+        providerSummary[name] = {
+            count: stats.count,
+            failures: stats.failures,
+            avgDurationMs: stats.count > 0 ? Math.round((stats.totalMs / stats.count) * 100) / 100 : 0,
+        };
+    }
+    return {
+        total: buffer.length,
+        successes,
+        failures: buffer.length - successes,
+        avgDurationMs: buffer.length > 0 ? Math.round((totalMs / buffer.length) * 100) / 100 : 0,
+        byProvider: providerSummary,
+        oldestEntry: buffer.length > 0 ? buffer[0].receivedAt : null,
+        newestEntry: buffer.length > 0 ? buffer[buffer.length - 1].receivedAt : null,
+    };
+}
+/** Clear the event log. Optionally filter by provider. */
+export function clearEventLog(provider) {
+    if (provider) {
+        const before = buffer.length;
+        buffer = buffer.filter((e) => e.provider !== provider);
+        return before - buffer.length;
+    }
+    const count = buffer.length;
+    buffer = [];
+    return count;
+}
+//# sourceMappingURL=event-log.js.map

package/dist/webhooks/event-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-log.js","sourceRoot":"","sources":["../../src/webhooks/event-log.ts"],"names":[],"mappings":"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"}

package/dist/webhooks/handler.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Abstract WebhookHandler base class.
+ *
+ * Provides a class-based API on top of the existing interface-based webhook system.
+ * Subclasses implement `verify()` and `handle()`, getting automatic registration,
+ * retry logic, safe error handling, and activity logging for free.
+ *
+ * Usage:
+ *   class MyHandler extends WebhookHandler {
+ *     constructor() {
+ *       super({
+ *         name: "my-service",
+ *         signatureHeader: "x-my-signature",
+ *         secretEnvVar: "MY_WEBHOOK_SECRET",
+ *       });
+ *     }
+ *     verify(ctx) { ... }
+ *     protected handle(payload, ctx) { ... }
+ *   }
+ */
+import type { WebhookProvider, VerifyContext, WebhookResult, WebhookRetryOpts, SignatureAlgorithm } from "./types.js";
+/** Options for constructing a WebhookHandler. */
+export interface WebhookHandlerConfig {
+    /** Unique provider name (e.g., "github", "stripe"). */
+    name: string;
+    /** Route path where this webhook receives events. Default: `/api/webhooks/{name}`. */
+    path?: string;
+    /** Header name containing the signature (lowercase). Default: "x-signature". */
+    signatureHeader?: string;
+    /** Header name containing the timestamp (lowercase). Optional. */
+    timestampHeader?: string;
+    /** Environment variable name for the webhook secret. */
+    secretEnvVar?: string;
+    /** Signature algorithm hint. Default: "custom". */
+    algorithm?: SignatureAlgorithm;
+    /** Retry options for transient failures. */
+    retry?: WebhookRetryOpts;
+    /** Whether to auto-register on construction. Default: true. */
+    autoRegister?: boolean;
+}
+/**
+ * Abstract base class for webhook handlers.
+ * Implements WebhookProvider and auto-registers with the webhook registry.
+ *
+ * Subclasses must implement:
+ * - `verify(ctx)` — Validate the webhook signature
+ * - `handle(payload, ctx)` — Process the webhook payload
+ *
+ * The base class provides:
+ * - Auto-registration with the webhook registry
+ * - Safe error wrapping (process() never throws)
+ * - Optional retry logic with exponential backoff
+ * - Secret resolution from environment variables
+ * - Activity logging
+ */
+export declare abstract class WebhookHandler implements WebhookProvider {
+    readonly name: string;
+    readonly path: string;
+    readonly signatureHeader: string;
+    readonly timestampHeader?: string;
+    readonly secretEnvVar?: string;
+    readonly algorithm: SignatureAlgorithm;
+    readonly retryOpts: WebhookRetryOpts;
+    constructor(config: WebhookHandlerConfig);
+    /**
+     * Verify the webhook signature. Must be implemented by subclasses.
+     * Return true if the signature is valid.
+     */
+    abstract verify(ctx: VerifyContext): boolean;
+    /**
+     * Process the webhook payload. Must be implemented by subclasses.
+     * May throw — the base class wraps this in safe error handling.
+     */
+    protected abstract handle(payload: unknown, ctx?: Record<string, unknown>): Promise<WebhookResult>;
+    /**
+     * Process a webhook payload with error handling and optional retry.
+     * This is the WebhookProvider.process() implementation — callers use this.
+     * Never throws.
+     */
+    process(payload: unknown, ctx?: Record<string, unknown>): Promise<WebhookResult>;
+    /**
+     * Resolve the webhook secret from the configured environment variable.
+     * Returns undefined if no env var is configured or the var is not set.
+     */
+    getSecret(): string | undefined;
+    /**
+     * Register this handler with the webhook registry.
+     * Called automatically on construction unless autoRegister is false.
+     */
+    register(): void;
+}
+//# sourceMappingURL=handler.d.ts.map

package/dist/webhooks/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/webhooks/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAIpB,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAID;;;;;;;;;;;;;;GAcG;AACH,8BAAsB,cAAe,YAAW,eAAe;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;gBAEzB,MAAM,EAAE,oBAAoB;IAcxC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO;IAE5C;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,MAAM,CACvB,OAAO,EAAE,OAAO,EAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,aAAa,CAAC;IAEzB;;;;OAIG;IACG,OAAO,CACX,OAAO,EAAE,OAAO,EAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,aAAa,CAAC;IAsBzB;;;OAGG;IACH,SAAS,IAAI,MAAM,GAAG,SAAS;IAO/B;;;OAGG;IACH,QAAQ,IAAI,IAAI;CAGjB"}

package/dist/webhooks/handler.js

@@ -0,0 +1,103 @@
+/**
+ * Abstract WebhookHandler base class.
+ *
+ * Provides a class-based API on top of the existing interface-based webhook system.
+ * Subclasses implement `verify()` and `handle()`, getting automatic registration,
+ * retry logic, safe error handling, and activity logging for free.
+ *
+ * Usage:
+ *   class MyHandler extends WebhookHandler {
+ *     constructor() {
+ *       super({
+ *         name: "my-service",
+ *         signatureHeader: "x-my-signature",
+ *         secretEnvVar: "MY_WEBHOOK_SECRET",
+ *       });
+ *     }
+ *     verify(ctx) { ... }
+ *     protected handle(payload, ctx) { ... }
+ *   }
+ */
+import { logActivity } from "../activity/log.js";
+import { registerProvider } from "./registry.js";
+import { withWebhookRetry } from "./retry.js";
+// ── Base class ───────────────────────────────────────────────────────────────
+/**
+ * Abstract base class for webhook handlers.
+ * Implements WebhookProvider and auto-registers with the webhook registry.
+ *
+ * Subclasses must implement:
+ * - `verify(ctx)` — Validate the webhook signature
+ * - `handle(payload, ctx)` — Process the webhook payload
+ *
+ * The base class provides:
+ * - Auto-registration with the webhook registry
+ * - Safe error wrapping (process() never throws)
+ * - Optional retry logic with exponential backoff
+ * - Secret resolution from environment variables
+ * - Activity logging
+ */
+export class WebhookHandler {
+    name;
+    path;
+    signatureHeader;
+    timestampHeader;
+    secretEnvVar;
+    algorithm;
+    retryOpts;
+    constructor(config) {
+        this.name = config.name;
+        this.path = config.path ?? `/api/webhooks/${config.name}`;
+        this.signatureHeader = config.signatureHeader ?? "x-signature";
+        this.timestampHeader = config.timestampHeader;
+        this.secretEnvVar = config.secretEnvVar;
+        this.algorithm = config.algorithm ?? "custom";
+        this.retryOpts = config.retry ?? {};
+        if (config.autoRegister !== false) {
+            registerProvider(this);
+        }
+    }
+    /**
+     * Process a webhook payload with error handling and optional retry.
+     * This is the WebhookProvider.process() implementation — callers use this.
+     * Never throws.
+     */
+    async process(payload, ctx) {
+        try {
+            const maxAttempts = this.retryOpts.maxAttempts ?? 1;
+            if (maxAttempts > 1) {
+                return await withWebhookRetry(() => this.handle(payload, ctx), {
+                    label: this.name,
+                    ...this.retryOpts,
+                });
+            }
+            return await this.handle(payload, ctx);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logActivity({
+                source: "system",
+                summary: `Webhook handler error (${this.name}): ${msg}`,
+            });
+            return { handled: false, message: `Handler error: ${msg}` };
+        }
+    }
+    /**
+     * Resolve the webhook secret from the configured environment variable.
+     * Returns undefined if no env var is configured or the var is not set.
+     */
+    getSecret() {
+        if (this.secretEnvVar) {
+            return process.env[this.secretEnvVar];
+        }
+        return undefined;
+    }
+    /**
+     * Register this handler with the webhook registry.
+     * Called automatically on construction unless autoRegister is false.
+     */
+    register() {
+        registerProvider(this);
+    }
+}
+//# sourceMappingURL=handler.js.map

package/dist/webhooks/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../src/webhooks/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA+B9C,gFAAgF;AAEhF;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAgB,cAAc;IACzB,IAAI,CAAS;IACb,IAAI,CAAS;IACb,eAAe,CAAS;IACxB,eAAe,CAAU;IACzB,YAAY,CAAU;IACtB,SAAS,CAAqB;IAC9B,SAAS,CAAmB;IAErC,YAAY,MAA4B;QACtC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,iBAAiB,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1D,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,IAAI,aAAa,CAAC;QAC/D,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;QAC9C,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,QAAQ,CAAC;QAC9C,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;QAEpC,IAAI,MAAM,CAAC,YAAY,KAAK,KAAK,EAAE,CAAC;YAClC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAiBD;;;;OAIG;IACH,KAAK,CAAC,OAAO,CACX,OAAgB,EAChB,GAA6B;QAE7B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,IAAI,CAAC,CAAC;YAEpD,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;gBACpB,OAAO,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE;oBAC7D,KAAK,EAAE,IAAI,CAAC,IAAI;oBAChB,GAAG,IAAI,CAAC,SAAS;iBAClB,CAAC,CAAC;YACL,CAAC;YAED,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,WAAW,CAAC;gBACV,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,0BAA0B,IAAI,CAAC,IAAI,MAAM,GAAG,EAAE;aACxD,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,GAAG,EAAE,EAAE,CAAC;QAC9D,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,SAAS;QACP,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,QAAQ;QACN,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;CACF"}

package/dist/webhooks/handlers.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Common webhook handler patterns.
+ * Provides safe-execution wrappers, logging, provider factory helpers,
+ * and reusable building blocks for processing webhook events.
+ */
+import type { WebhookResult, WebhookProvider, WebhookEvent } from "./types.js";
+export type { EventHandler } from "./types.js";
+/**
+ * Wrap a webhook handler so it never throws.
+ * Catches errors and returns a structured WebhookResult instead.
+ */
+export declare function safeHandler(source: string, fn: (payload: unknown, ctx?: Record<string, unknown>) => Promise<WebhookResult>): (payload: unknown, ctx?: Record<string, unknown>) => Promise<WebhookResult>;
+export { createEventRouter } from "./router.js";
+/**
+ * Create a provider that uses HMAC-SHA256 hex signature verification (without registering).
+ * Used by services like Linear and GitHub.
+ * Call registerProvider/registerProviders separately to complete registration.
+ */
+export declare function createHmacSha256HexProvider(opts: {
+    name: string;
+    process: (payload: unknown, ctx?: Record<string, unknown>) => Promise<WebhookResult>;
+    /** If true, strip a "sha256=" prefix from the signature before comparing (GitHub-style). Default: false. */
+    stripPrefix?: boolean;
+}): WebhookProvider;
+/**
+ * Create and register a provider that uses HMAC-SHA256 hex signature verification.
+ * Used by services like Linear and GitHub.
+ * @deprecated Use createHmacSha256HexProvider + registerProviders for batch registration.
+ */
+export declare function registerHmacSha256HexProvider(opts: {
+    name: string;
+    process: (payload: unknown, ctx?: Record<string, unknown>) => Promise<WebhookResult>;
+    stripPrefix?: boolean;
+}): WebhookProvider;
+/**
+ * Create a provider that uses HMAC-SHA256 base64 signature verification (without registering).
+ */
+export declare function createHmacSha256Base64Provider(opts: {
+    name: string;
+    process: (payload: unknown, ctx?: Record<string, unknown>) => Promise<WebhookResult>;
+    stripPrefix?: boolean;
+}): WebhookProvider;
+/**
+ * Create and register a provider that uses HMAC-SHA256 base64 signature verification.
+ * @deprecated Use createHmacSha256Base64Provider + registerProviders for batch registration.
+ */
+export declare function registerHmacSha256Base64Provider(opts: {
+    name: string;
+    process: (payload: unknown, ctx?: Record<string, unknown>) => Promise<WebhookResult>;
+    stripPrefix?: boolean;
+}): WebhookProvider;
+/**
+ * Create a provider that uses Slack's v0 signature scheme (without registering).
+ * v0={HMAC-SHA256 of "v0:{timestamp}:{body}"} with timestamp freshness check.
+ */
+export declare function createSlackStyleProvider(opts: {
+    name: string;
+    process: (payload: unknown, ctx?: Record<string, unknown>) => Promise<WebhookResult>;
+    maxAgeSeconds?: number;
+}): WebhookProvider;
+/**
+ * Create and register a provider that uses Slack's v0 signature scheme.
+ * @deprecated Use createSlackStyleProvider + registerProviders for batch registration.
+ */
+export declare function registerSlackStyleProvider(opts: {
+    name: string;
+    process: (payload: unknown, ctx?: Record<string, unknown>) => Promise<WebhookResult>;
+    maxAgeSeconds?: number;
+}): WebhookProvider;
+/**
+ * Create a provider that uses Twilio's signature scheme (without registering).
+ * HMAC-SHA1 of URL + sorted POST params, base64 encoded.
+ */
+export declare function createTwilioStyleProvider(opts: {
+    name: string;
+    process: (payload: unknown, ctx?: Record<string, unknown>) => Promise<WebhookResult>;
+}): WebhookProvider;
+/**
+ * Create and register a provider that uses Twilio's signature scheme.
+ * @deprecated Use createTwilioStyleProvider + registerProviders for batch registration.
+ */
+export declare function registerTwilioStyleProvider(opts: {
+    name: string;
+    process: (payload: unknown, ctx?: Record<string, unknown>) => Promise<WebhookResult>;
+}): WebhookProvider;
+export { withRetryHandler } from "./retry.js";
+/**
+ * Log a webhook event and delegate to a handler.
+ * Adds structured logging before and after processing.
+ */
+export declare function withLogging(source: string, fn: (payload: unknown, ctx?: Record<string, unknown>) => Promise<WebhookResult>): (payload: unknown, ctx?: Record<string, unknown>) => Promise<WebhookResult>;
+/**
+ * Wrap a raw payload into a typed WebhookEvent envelope.
+ * Useful for handlers that want a normalized event shape.
+ */
+export declare function normalizeToEvent<T>(source: string, payload: T, opts?: {
+    typeExtractor?: (p: T) => string;
+    idExtractor?: (p: T) => string;
+}): WebhookEvent<T>;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/webhooks/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/webhooks/handlers.ts"],"names":[],"mappings":"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"}

package/dist/webhooks/handlers.js

@@ -0,0 +1,178 @@
+/**
+ * Common webhook handler patterns.
+ * Provides safe-execution wrappers, logging, provider factory helpers,
+ * and reusable building blocks for processing webhook events.
+ */
+import { logActivity } from "../activity/log.js";
+import { registerProvider } from "./registry.js";
+import { hmacSha256Hex, hmacSha256Base64, hmacSha1Base64, timingSafeCompare, isTimestampFresh, } from "./verify.js";
+import { createWebhookEvent } from "./router.js";
+// ── Safe execution wrapper ───────────────────────────────────────────────────
+/**
+ * Wrap a webhook handler so it never throws.
+ * Catches errors and returns a structured WebhookResult instead.
+ */
+export function safeHandler(source, fn) {
+    return async (payload, ctx) => {
+        try {
+            return await fn(payload, ctx);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logActivity({
+                source: "system",
+                summary: `Webhook handler error (${source}): ${msg}`,
+            });
+            return { handled: false, message: `Handler error: ${msg}` };
+        }
+    };
+}
+// ── Event router builder (re-exported from router.ts) ────────────────────────
+export { createEventRouter } from "./router.js";
+// ── Provider factory helpers ─────────────────────────────────────────────────
+/**
+ * Create a provider that uses HMAC-SHA256 hex signature verification (without registering).
+ * Used by services like Linear and GitHub.
+ * Call registerProvider/registerProviders separately to complete registration.
+ */
+export function createHmacSha256HexProvider(opts) {
+    return {
+        name: opts.name,
+        verify(ctx) {
+            const sig = opts.stripPrefix
+                ? ctx.signature.replace(/^sha256=/, "")
+                : ctx.signature;
+            const expected = hmacSha256Hex(ctx.rawBody, ctx.secret);
+            return timingSafeCompare(sig, expected);
+        },
+        process: opts.process,
+    };
+}
+/**
+ * Create and register a provider that uses HMAC-SHA256 hex signature verification.
+ * Used by services like Linear and GitHub.
+ * @deprecated Use createHmacSha256HexProvider + registerProviders for batch registration.
+ */
+export function registerHmacSha256HexProvider(opts) {
+    const provider = createHmacSha256HexProvider(opts);
+    registerProvider(provider);
+    return provider;
+}
+/**
+ * Create a provider that uses HMAC-SHA256 base64 signature verification (without registering).
+ */
+export function createHmacSha256Base64Provider(opts) {
+    return {
+        name: opts.name,
+        verify(ctx) {
+            const sig = opts.stripPrefix
+                ? ctx.signature.replace(/^sha256=/, "")
+                : ctx.signature;
+            const expected = hmacSha256Base64(ctx.rawBody, ctx.secret);
+            return timingSafeCompare(sig, expected);
+        },
+        process: opts.process,
+    };
+}
+/**
+ * Create and register a provider that uses HMAC-SHA256 base64 signature verification.
+ * @deprecated Use createHmacSha256Base64Provider + registerProviders for batch registration.
+ */
+export function registerHmacSha256Base64Provider(opts) {
+    const provider = createHmacSha256Base64Provider(opts);
+    registerProvider(provider);
+    return provider;
+}
+/**
+ * Create a provider that uses Slack's v0 signature scheme (without registering).
+ * v0={HMAC-SHA256 of "v0:{timestamp}:{body}"} with timestamp freshness check.
+ */
+export function createSlackStyleProvider(opts) {
+    return {
+        name: opts.name,
+        verify(ctx) {
+            const timestamp = ctx.headers?.["timestamp"] ?? "";
+            const ts = parseInt(timestamp, 10);
+            if (!isTimestampFresh(ts, opts.maxAgeSeconds ?? 300))
+                return false;
+            const baseString = `v0:${timestamp}:${ctx.rawBody}`;
+            const computed = `v0=${hmacSha256Hex(baseString, ctx.secret)}`;
+            return timingSafeCompare(ctx.signature, computed);
+        },
+        process: opts.process,
+    };
+}
+/**
+ * Create and register a provider that uses Slack's v0 signature scheme.
+ * @deprecated Use createSlackStyleProvider + registerProviders for batch registration.
+ */
+export function registerSlackStyleProvider(opts) {
+    const provider = createSlackStyleProvider(opts);
+    registerProvider(provider);
+    return provider;
+}
+/**
+ * Create a provider that uses Twilio's signature scheme (without registering).
+ * HMAC-SHA1 of URL + sorted POST params, base64 encoded.
+ */
+export function createTwilioStyleProvider(opts) {
+    return {
+        name: opts.name,
+        verify(ctx) {
+            if (!ctx.url || !ctx.params)
+                return false;
+            const sortedKeys = Object.keys(ctx.params).sort();
+            let data = ctx.url;
+            for (const key of sortedKeys) {
+                data += key + ctx.params[key];
+            }
+            const expected = hmacSha1Base64(data, ctx.secret);
+            return timingSafeCompare(ctx.signature, expected);
+        },
+        process: opts.process,
+    };
+}
+/**
+ * Create and register a provider that uses Twilio's signature scheme.
+ * @deprecated Use createTwilioStyleProvider + registerProviders for batch registration.
+ */
+export function registerTwilioStyleProvider(opts) {
+    const provider = createTwilioStyleProvider(opts);
+    registerProvider(provider);
+    return provider;
+}
+// ── Re-export from retry.ts for backward compatibility ───────────────────────
+export { withRetryHandler } from "./retry.js";
+// ── Logging helper ───────────────────────────────────────────────────────────
+/**
+ * Log a webhook event and delegate to a handler.
+ * Adds structured logging before and after processing.
+ */
+export function withLogging(source, fn) {
+    return async (payload, ctx) => {
+        logActivity({
+            source: "system",
+            summary: `Webhook received: ${source}`,
+        });
+        const result = await fn(payload, ctx);
+        if (!result.handled) {
+            logActivity({
+                source: "system",
+                summary: `Webhook not handled (${source}): ${result.message}`,
+            });
+        }
+        return result;
+    };
+}
+// ── Event normalization ──────────────────────────────────────────────────────
+/**
+ * Wrap a raw payload into a typed WebhookEvent envelope.
+ * Useful for handlers that want a normalized event shape.
+ */
+export function normalizeToEvent(source, payload, opts) {
+    return createWebhookEvent(source, payload, {
+        eventType: opts?.typeExtractor?.(payload),
+        deliveryId: opts?.idExtractor?.(payload),
+    });
+}
+//# sourceMappingURL=handlers.js.map

package/dist/webhooks/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/webhooks/handlers.ts"],"names":[],"mappings":"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"}