@runcore-sh/runcore 0.4.0 → 0.5.0

package/dist/webhooks/config.js

@@ -1,214 +0,0 @@
-/**
- * Webhook configuration management.
- *
- * Loads, validates, and resolves webhook provider configurations.
- * Secrets can reference environment variables or be provided as literals.
- * Configuration can be loaded from a file or constructed programmatically.
- */
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { logActivity } from "../activity/log.js";
-import { createLogger } from "../utils/logger.js";
-import { getProvider, listProviders } from "./registry.js";
-const log = createLogger("webhooks.config");
-// ── In-memory config store ───────────────────────────────────────────────────
-let systemConfig = { providers: {} };
-/** Get the current webhook system configuration. */
-export function getConfig() {
-    return systemConfig;
-}
-/** Replace the entire system configuration. */
-export function setConfig(config) {
-    systemConfig = config;
-}
-// ── Provider config CRUD ─────────────────────────────────────────────────────
-/** Get configuration for a specific provider. */
-export function getProviderConfig(name) {
-    return systemConfig.providers[name];
-}
-/** Set configuration for a specific provider. Merges with existing config. */
-export function setProviderConfig(config) {
-    const existing = systemConfig.providers[config.name];
-    systemConfig.providers[config.name] = existing
-        ? { ...existing, ...config }
-        : config;
-}
-/**
- * Set multiple provider configs in one call.
- * Avoids repeated object spread overhead when configuring all providers at startup.
- */
-export function setProviderConfigs(configs) {
-    const start = performance.now();
-    for (const config of configs) {
-        setProviderConfig(config);
-    }
-    const ms = performance.now() - start;
-    // Use debug log instead of logActivity to avoid polluting the insight engine
-    // with routine startup perf data (was causing feedback loop — DASH-70)
-    if (ms > 5) {
-        log.debug(`setProviderConfigs took ${ms.toFixed(1)}ms for ${configs.length} providers`);
-    }
-}
-/** Remove configuration for a provider. */
-export function removeProviderConfig(name) {
-    if (!(name in systemConfig.providers))
-        return false;
-    delete systemConfig.providers[name];
-    return true;
-}
-/** List all configured provider names. */
-export function listConfiguredProviders() {
-    return Object.keys(systemConfig.providers);
-}
-// ── Secret resolution ────────────────────────────────────────────────────────
-/**
- * Resolve a secret value. If the value looks like an environment variable
- * name (all uppercase, underscores, digits), read from process.env.
- * Otherwise, treat it as a literal secret.
- */
-export function resolveSecret(secretRef) {
-    // Env var pattern: all uppercase letters, digits, underscores
-    if (/^[A-Z][A-Z0-9_]*$/.test(secretRef)) {
-        return process.env[secretRef];
-    }
-    return secretRef;
-}
-/**
- * Get the resolved secret for a provider.
- * Returns undefined if no secret is configured or the env var is not set.
- */
-export function getProviderSecret(name) {
-    const config = systemConfig.providers[name];
-    if (!config?.secret)
-        return undefined;
-    return resolveSecret(config.secret);
-}
-// ── Retry config resolution ──────────────────────────────────────────────────
-/**
- * Get the effective retry options for a provider.
- * Provider-specific config overrides system defaults.
- */
-export function getProviderRetryOpts(name) {
-    const defaults = systemConfig.defaults?.retry ?? {};
-    const providerOpts = systemConfig.providers[name]?.retry ?? {};
-    return { ...defaults, ...providerOpts };
-}
-// ── Provider status ──────────────────────────────────────────────────────────
-/** Check if a provider is enabled in the configuration. */
-export function isProviderEnabled(name) {
-    const config = systemConfig.providers[name];
-    if (!config)
-        return true; // Unconfigured providers default to enabled
-    return config.enabled !== false;
-}
-/**
- * Validate the configuration for a specific provider.
- * Returns a list of issues found.
- */
-export function validateProviderConfig(name) {
-    const issues = [];
-    const config = systemConfig.providers[name];
-    if (!config) {
-        issues.push(`No configuration found for provider "${name}"`);
-        return issues;
-    }
-    if (config.secret) {
-        const resolved = resolveSecret(config.secret);
-        if (!resolved) {
-            issues.push(`Secret for "${name}" references env var "${config.secret}" which is not set`);
-        }
-    }
-    if (!getProvider(name)) {
-        issues.push(`Provider "${name}" is configured but not registered in the registry`);
-    }
-    return issues;
-}
-/**
- * Validate the entire system configuration.
- * Returns a map of provider name → issues.
- */
-export function validateConfig() {
-    const result = {};
-    for (const name of Object.keys(systemConfig.providers)) {
-        const issues = validateProviderConfig(name);
-        if (issues.length > 0) {
-            result[name] = issues;
-        }
-    }
-    // Check for registered providers missing configuration
-    for (const name of listProviders()) {
-        if (!systemConfig.providers[name]) {
-            result[name] = [
-                `Provider "${name}" is registered but has no configuration`,
-            ];
-        }
-    }
-    return result;
-}
-// ── File-based config loading ────────────────────────────────────────────────
-/**
- * Load webhook configuration from a JSON file.
- * Returns true if the file was loaded successfully.
- */
-export function loadConfigFromFile(filePath) {
-    const start = performance.now();
-    try {
-        const resolved = path.resolve(filePath);
-        const readStart = performance.now();
-        const content = fs.readFileSync(resolved, "utf-8");
-        const readMs = performance.now() - readStart;
-        const parseStart = performance.now();
-        const parsed = JSON.parse(content);
-        const parseMs = performance.now() - parseStart;
-        if (!parsed.providers || typeof parsed.providers !== "object") {
-            logActivity({
-                source: "system",
-                summary: `Webhook config file missing "providers" object: ${filePath}`,
-            });
-            return false;
-        }
-        systemConfig = parsed;
-        const totalMs = performance.now() - start;
-        logActivity({
-            source: "system",
-            summary: `Loaded webhook config from ${filePath} (${Object.keys(parsed.providers).length} providers, read:${readMs.toFixed(1)}ms, parse:${parseMs.toFixed(1)}ms, total:${totalMs.toFixed(1)}ms)`,
-        });
-        return true;
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        logActivity({
-            source: "system",
-            summary: `Failed to load webhook config from ${filePath}: ${msg}`,
-        });
-        return false;
-    }
-}
-/**
- * Save the current webhook configuration to a JSON file.
- * Secrets that reference env vars are saved as-is (the reference, not the resolved value).
- */
-export function saveConfigToFile(filePath) {
-    try {
-        const resolved = path.resolve(filePath);
-        const dir = path.dirname(resolved);
-        if (!fs.existsSync(dir)) {
-            fs.mkdirSync(dir, { recursive: true });
-        }
-        fs.writeFileSync(resolved, JSON.stringify(systemConfig, null, 2), "utf-8");
-        logActivity({
-            source: "system",
-            summary: `Saved webhook config to ${filePath}`,
-        });
-        return true;
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        logActivity({
-            source: "system",
-            summary: `Failed to save webhook config to ${filePath}: ${msg}`,
-        });
-        return false;
-    }
-}
-//# sourceMappingURL=config.js.map

package/dist/webhooks/config.js.map

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

package/dist/webhooks/event-log.js

@@ -1,132 +0,0 @@
-/**
- * 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

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

package/dist/webhooks/handler.js

@@ -1,103 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}