sorokeep 1.0.0

package/dist/alerts/templates.d.ts

@@ -0,0 +1,109 @@
+import type { AlertEvent } from "./types.js";
+export declare function getTemplateContext(event: AlertEvent): {
+    contractDisplay: string;
+    resourceLabel: string;
+    resourceUnit: string;
+    severityLevel: string;
+    entryLabel: string;
+    severityEmoji: string;
+    isTTLAlert: boolean;
+    isResourceAlert: boolean;
+    isResolved: boolean;
+    isCritical: boolean;
+    isWarning: boolean;
+    isInfo: boolean;
+    currentUsageFormatted: string;
+    limitFormatted: string;
+    currentRemainingLedgersFormatted: string;
+    configuredLedgersFormatted: string;
+    dedupKey: string;
+    customDetails: Record<string, unknown>;
+    type: "threshold_crossed" | "alert_resolved";
+    severity: import("./types.js").AlertSeverity;
+    contractId: string;
+    contractName: string | null;
+    network: string;
+    entry: {
+        keyXdr: string;
+        type: string;
+        label: string | null;
+    };
+    threshold: {
+        configuredLedgers: number;
+        currentRemainingLedgers: number;
+        approximateTimeRemaining: string;
+    };
+    firedAtLedger: number;
+    timestamp: string;
+} | {
+    contractDisplay: string;
+    resourceLabel: string;
+    resourceUnit: string;
+    severityLevel: string;
+    entryLabel: string;
+    severityEmoji: string;
+    isTTLAlert: boolean;
+    isResourceAlert: boolean;
+    isResolved: boolean;
+    isCritical: boolean;
+    isWarning: boolean;
+    isInfo: boolean;
+    currentUsageFormatted: string;
+    limitFormatted: string;
+    currentRemainingLedgersFormatted: string;
+    configuredLedgersFormatted: string;
+    dedupKey: string;
+    customDetails: Record<string, unknown>;
+    type: "resource_alert";
+    severity: import("./types.js").AlertSeverity;
+    contractId: string;
+    contractName: string | null;
+    network: string;
+    resource: {
+        type: "cpu" | "memory";
+        currentUsage: number;
+        limit: number;
+        usagePercent: number;
+    };
+    message: string;
+    firedAtLedger?: number;
+    timestamp: string;
+} | {
+    contractDisplay: string;
+    resourceLabel: string;
+    resourceUnit: string;
+    severityLevel: string;
+    entryLabel: string;
+    severityEmoji: string;
+    isTTLAlert: boolean;
+    isResourceAlert: boolean;
+    isResolved: boolean;
+    isCritical: boolean;
+    isWarning: boolean;
+    isInfo: boolean;
+    currentUsageFormatted: string;
+    limitFormatted: string;
+    currentRemainingLedgersFormatted: string;
+    configuredLedgersFormatted: string;
+    dedupKey: string;
+    customDetails: Record<string, unknown>;
+    type: "state_changed";
+    severity: import("./types.js").AlertSeverity;
+    contractId: string;
+    contractName: string | null;
+    network: string;
+    entry: {
+        keyXdr: string;
+        type: string;
+        label: string | null;
+    };
+    diff: {
+        diffType: "created" | "updated" | "deleted";
+        oldValueXdr: string | null;
+        newValueXdr: string | null;
+    };
+    detectedAtLedger: number;
+    timestamp: string;
+};
+export declare function renderAlertTemplate(channel: string, event: AlertEvent, customTemplatesPath?: string): string | null;
+//# sourceMappingURL=templates.d.ts.map

package/dist/alerts/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/alerts/templates.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAe7C,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2FnD;AAID,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkCnH"}

package/dist/alerts/templates.js

@@ -0,0 +1,139 @@
+import Handlebars from "handlebars";
+import fs from "node:fs";
+import path from "node:path";
+import { loadConfig } from "../utils/config.js";
+import { getLogger } from "../logging/index.js";
+const logger = getLogger().child({ component: "AlertTemplates" });
+// ─── Register Handlebars Helpers ─────────────────────────────────────────────
+Handlebars.registerHelper("eq", (a, b) => a === b);
+Handlebars.registerHelper("upperCase", (str) => typeof str === "string" ? str.toUpperCase() : str);
+Handlebars.registerHelper("localeString", (num) => typeof num === "number" ? num.toLocaleString() : num);
+Handlebars.registerHelper("json", (obj) => JSON.stringify(obj));
+Handlebars.registerHelper("escapeJson", (str) => typeof str === "string" ? JSON.stringify(str).slice(1, -1) : str);
+Handlebars.registerHelper("escapeMarkdown", (text) => typeof text === "string" ? text.replace(/[_*[\]()~`>#+=|{}.!\\-]/g, "\\$&") : text);
+// ─── Context Preparation ─────────────────────────────────────────────────────
+export function getTemplateContext(event) {
+    const isResourceAlert = event.type === "resource_alert";
+    const isResolved = event.type === "alert_resolved";
+    const contractDisplay = event.contractName ?? event.contractId;
+    let resourceLabel = "";
+    let resourceUnit = "";
+    let entryLabel = "";
+    if (isResourceAlert) {
+        resourceLabel = event.resource.type === "cpu" ? "CPU" : "Memory";
+        resourceUnit = event.resource.type === "cpu" ? "instructions" : "bytes";
+    }
+    else {
+        entryLabel = event.entry.label ?? event.entry.type;
+    }
+    const severityLevel = event.severity === "critical" ? "CRITICAL" : "Warning";
+    // Dedup keys and details for channels like PagerDuty
+    let dedupKey;
+    let customDetails;
+    if (isResourceAlert) {
+        dedupKey = `sorokeep:${event.network}:${event.contractId}:resource:${event.resource.type}`;
+        customDetails = {
+            contractId: event.contractId,
+            contractName: event.contractName,
+            network: event.network,
+            resourceType: event.resource.type,
+            usagePercent: event.resource.usagePercent,
+            currentUsage: event.resource.currentUsage,
+            limit: event.resource.limit,
+            firedAtLedger: event.firedAtLedger,
+            timestamp: event.timestamp,
+        };
+    }
+    else if (event.type === "threshold_crossed" || event.type === "alert_resolved") {
+        const entryKey = event.entry.keyXdr || event.entry.type;
+        dedupKey = `sorokeep:${event.network}:${event.contractId}:${entryKey}:${event.threshold.configuredLedgers}`;
+        customDetails = {
+            contractId: event.contractId,
+            contractName: event.contractName,
+            network: event.network,
+            entryKeyXdr: event.entry.keyXdr,
+            entryType: event.entry.type,
+            entryLabel: event.entry.label,
+            currentRemainingLedgers: event.threshold.currentRemainingLedgers,
+            configuredLedgers: event.threshold.configuredLedgers,
+            approximateTimeRemaining: event.threshold.approximateTimeRemaining,
+            firedAtLedger: event.firedAtLedger,
+            timestamp: event.timestamp,
+        };
+    }
+    else if (event.type === "state_changed") {
+        const entryKey = event.entry.keyXdr || event.entry.type;
+        dedupKey = `sorokeep:${event.network}:${event.contractId}:${entryKey}:state_changed`;
+        customDetails = {
+            contractId: event.contractId,
+            contractName: event.contractName,
+            network: event.network,
+            entryKeyXdr: event.entry.keyXdr,
+            entryType: event.entry.type,
+            entryLabel: event.entry.label,
+            diffType: event.diff.diffType,
+            detectedAtLedger: event.detectedAtLedger,
+            timestamp: event.timestamp,
+        };
+    }
+    else {
+        dedupKey = `sorokeep:${event.network}:${event.contractId}:unknown`;
+        customDetails = { contractId: event.contractId, timestamp: event.timestamp };
+    }
+    return {
+        ...event,
+        contractDisplay,
+        resourceLabel,
+        resourceUnit,
+        severityLevel,
+        entryLabel,
+        severityEmoji: isResolved ? "✅" : (event.severity === "critical" ? "🔴" : "⚠️"),
+        isTTLAlert: event.type === "threshold_crossed" || event.type === "alert_resolved",
+        isResourceAlert,
+        isResolved,
+        isCritical: event.severity === "critical",
+        isWarning: event.severity === "warning",
+        isInfo: event.severity === "info",
+        currentUsageFormatted: isResourceAlert ? event.resource.currentUsage.toLocaleString() : "",
+        limitFormatted: isResourceAlert ? event.resource.limit.toLocaleString() : "",
+        currentRemainingLedgersFormatted: "threshold" in event ? event.threshold.currentRemainingLedgers.toLocaleString() : "",
+        configuredLedgersFormatted: "threshold" in event ? event.threshold.configuredLedgers.toLocaleString() : "",
+        dedupKey,
+        customDetails,
+    };
+}
+// ─── Main Render API ─────────────────────────────────────────────────────────
+export function renderAlertTemplate(channel, event, customTemplatesPath) {
+    // Priority: custom path parameter > config.templatesPath
+    let templatesPath = customTemplatesPath;
+    if (!templatesPath) {
+        try {
+            const config = loadConfig();
+            if ("templatesPath" in config && typeof config.templatesPath === "string") {
+                templatesPath = config.templatesPath;
+            }
+        }
+        catch {
+            // Ignore config loading errors during startup/tests
+        }
+    }
+    if (!templatesPath) {
+        return null;
+    }
+    const templateFile = path.join(templatesPath, `${channel}.hbs`);
+    if (!fs.existsSync(templateFile)) {
+        return null;
+    }
+    try {
+        const raw = fs.readFileSync(templateFile, "utf8");
+        const template = Handlebars.compile(raw, { noEscape: true });
+        const context = getTemplateContext(event);
+        return template(context);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        logger.error(`Failed to render template ${templateFile}: ${msg}`);
+        return null;
+    }
+}
+//# sourceMappingURL=templates.js.map

package/dist/alerts/templates.js.map

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

package/dist/alerts/types.d.ts

@@ -0,0 +1,113 @@
+export type AlertSeverity = "critical" | "warning" | "info";
+export type AlertEventType = "threshold_crossed" | "alert_resolved" | "resource_alert" | "state_changed";
+export interface TTLAlertEvent {
+    type: "threshold_crossed" | "alert_resolved";
+    severity: AlertSeverity;
+    contractId: string;
+    contractName: string | null;
+    network: string;
+    entry: {
+        keyXdr: string;
+        type: string;
+        label: string | null;
+    };
+    threshold: {
+        /** The ledger count configured in the alert_config. */
+        configuredLedgers: number;
+        /** Remaining TTL at the moment the alert fired. */
+        currentRemainingLedgers: number;
+        /** Human-readable time estimate, e.g. "~6h 25m". */
+        approximateTimeRemaining: string;
+    };
+    /** Ledger sequence number at the time of detection. */
+    firedAtLedger: number;
+    /** ISO 8601 timestamp. */
+    timestamp: string;
+}
+export interface ResourceAlertEvent {
+    type: "resource_alert";
+    severity: AlertSeverity;
+    contractId: string;
+    contractName: string | null;
+    network: string;
+    resource: {
+        type: "cpu" | "memory";
+        /** Current usage (in instructions or bytes). */
+        currentUsage: number;
+        /** Configured limit (in instructions or bytes). */
+        limit: number;
+        /** Usage as a percentage of limit. */
+        usagePercent: number;
+    };
+    /** Human-readable message about the resource usage. */
+    message: string;
+    /** Ledger sequence number at the time of detection (if available). */
+    firedAtLedger?: number;
+    /** ISO 8601 timestamp. */
+    timestamp: string;
+}
+export interface StateChangeAlertEvent {
+    type: "state_changed";
+    severity: AlertSeverity;
+    contractId: string;
+    contractName: string | null;
+    network: string;
+    entry: {
+        keyXdr: string;
+        type: string;
+        label: string | null;
+    };
+    diff: {
+        diffType: "created" | "updated" | "deleted";
+        oldValueXdr: string | null;
+        newValueXdr: string | null;
+    };
+    /** Ledger sequence number at the time of detection. */
+    detectedAtLedger: number;
+    /** ISO 8601 timestamp. */
+    timestamp: string;
+}
+export type AlertEvent = TTLAlertEvent | ResourceAlertEvent | StateChangeAlertEvent;
+export interface AlertChannel {
+    send(target: string, event: AlertEvent, secret?: string | null): Promise<void>;
+}
+export declare function computeSeverity(remainingTTL: number, thresholdLedgers: number, isResolution: boolean): AlertSeverity;
+export declare function computeResourceSeverity(usagePercent: number): AlertSeverity;
+export declare function buildAlertEvent(opts: {
+    type: "threshold_crossed" | "alert_resolved";
+    contractId: string;
+    contractName: string | null;
+    network: string;
+    entryKeyXdr: string;
+    entryType: string;
+    entryLabel: string | null;
+    configuredLedgers: number;
+    remainingTTL: number;
+    firedAtLedger: number;
+}): TTLAlertEvent;
+export declare function buildResourceAlertEvent(opts: {
+    contractId: string;
+    contractName: string | null;
+    network: string;
+    resourceType: "cpu" | "memory";
+    currentUsage: number;
+    limit: number;
+    usagePercent: number;
+    firedAtLedger?: number;
+}): ResourceAlertEvent;
+/**
+ * Build a state-change AlertEvent from raw data.
+ */
+export declare function buildStateChangeAlertEvent(opts: {
+    contractId: string;
+    contractName: string | null;
+    network: string;
+    entryKeyXdr: string;
+    entryType: string;
+    entryLabel: string | null;
+    diffType: "created" | "updated" | "deleted";
+    oldValueXdr: string | null;
+    newValueXdr: string | null;
+    detectedAtLedger: number;
+}): StateChangeAlertEvent;
+//# sourceMappingURL=types.d.ts.map

package/dist/alerts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/alerts/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAEzG,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,mBAAmB,GAAG,gBAAgB,CAAC;IAC7C,QAAQ,EAAE,aAAa,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QACH,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,CAAC;IACF,SAAS,EAAE;QACP,uDAAuD;QACvD,iBAAiB,EAAE,MAAM,CAAC;QAC1B,mDAAmD;QACnD,uBAAuB,EAAE,MAAM,CAAC;QAChC,oDAAoD;QACpD,wBAAwB,EAAE,MAAM,CAAC;KACpC,CAAC;IACF,uDAAuD;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,aAAa,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACN,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;QACvB,gDAAgD;QAChD,YAAY,EAAE,MAAM,CAAC;QACrB,mDAAmD;QACnD,KAAK,EAAE,MAAM,CAAC;QACd,sCAAsC;QACtC,YAAY,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,aAAa,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QACH,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,CAAC;IACF,IAAI,EAAE;QACF,QAAQ,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;QAC5C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,CAAC;IACF,uDAAuD;IACvD,gBAAgB,EAAE,MAAM,CAAC;IACzB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,kBAAkB,GAAG,qBAAqB,CAAC;AAEpF,MAAM,WAAW,YAAY;IACzB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClF;AAED,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,aAAa,CAKpH;AAED,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,CAI3E;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE;IAClC,IAAI,EAAE,mBAAmB,GAAG,gBAAgB,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACzB,GAAG,aAAa,CAoBhB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,kBAAkB,CAyBrB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;CAC5B,GAAG,qBAAqB,CAoBxB"}

package/dist/alerts/types.js

@@ -0,0 +1,87 @@
+import { formatTimeToCloseLedger } from "../utils/formatting.js";
+export function computeSeverity(remainingTTL, thresholdLedgers, isResolution) {
+    if (isResolution)
+        return "info";
+    if (remainingTTL <= 0)
+        return "critical";
+    if (remainingTTL < thresholdLedgers * 0.25)
+        return "critical";
+    return "warning";
+}
+export function computeResourceSeverity(usagePercent) {
+    if (usagePercent >= 95)
+        return "critical";
+    if (usagePercent >= 80)
+        return "warning";
+    return "info";
+}
+export function buildAlertEvent(opts) {
+    return {
+        type: opts.type,
+        severity: computeSeverity(opts.remainingTTL, opts.configuredLedgers, opts.type === "alert_resolved"),
+        contractId: opts.contractId,
+        contractName: opts.contractName,
+        network: opts.network,
+        entry: {
+            keyXdr: opts.entryKeyXdr,
+            type: opts.entryType,
+            label: opts.entryLabel,
+        },
+        threshold: {
+            configuredLedgers: opts.configuredLedgers,
+            currentRemainingLedgers: opts.remainingTTL,
+            approximateTimeRemaining: formatTimeToCloseLedger(opts.remainingTTL),
+        },
+        firedAtLedger: opts.firedAtLedger,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function buildResourceAlertEvent(opts) {
+    const resourceLabel = opts.resourceType === "cpu" ? "CPU" : "Memory";
+    const usageUnit = opts.resourceType === "cpu" ? "instructions" : "bytes";
+    let message = `${resourceLabel} usage is at ${opts.usagePercent}% of limit`;
+    if (opts.usagePercent > 100) {
+        message = `${resourceLabel} usage exceeds limit: ${opts.currentUsage} ${usageUnit} / ${opts.limit} ${usageUnit}`;
+    }
+    return {
+        type: "resource_alert",
+        severity: computeResourceSeverity(opts.usagePercent),
+        contractId: opts.contractId,
+        contractName: opts.contractName,
+        network: opts.network,
+        resource: {
+            type: opts.resourceType,
+            currentUsage: opts.currentUsage,
+            limit: opts.limit,
+            usagePercent: opts.usagePercent,
+        },
+        message,
+        firedAtLedger: opts.firedAtLedger,
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * Build a state-change AlertEvent from raw data.
+ */
+export function buildStateChangeAlertEvent(opts) {
+    return {
+        type: "state_changed",
+        severity: "info",
+        contractId: opts.contractId,
+        contractName: opts.contractName,
+        network: opts.network,
+        entry: {
+            keyXdr: opts.entryKeyXdr,
+            type: opts.entryType,
+            label: opts.entryLabel,
+        },
+        diff: {
+            diffType: opts.diffType,
+            oldValueXdr: opts.oldValueXdr,
+            newValueXdr: opts.newValueXdr,
+        },
+        detectedAtLedger: opts.detectedAtLedger,
+        timestamp: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/alerts/types.js.map

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

package/dist/alerts/webhook.d.ts

@@ -0,0 +1,13 @@
+import type { AlertEvent } from "./types.js";
+/**
+ * Send an AlertEvent to a webhook URL via HTTP POST.
+ *
+ * If a `secret` is provided, the request includes an `X-Sorokeep-Signature`
+ * header with an HMAC-SHA256 hex digest of the body, allowing receivers to
+ * verify authenticity.
+ *
+ * Throws on any non-2xx response or network error.
+ * The caller (dispatcher) is responsible for retry logic via the `delivered` flag.
+ */
+export declare function sendWebhookAlert(url: string, event: AlertEvent, secret?: string | null): Promise<void>;
+//# sourceMappingURL=webhook.d.ts.map

package/dist/alerts/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../src/alerts/webhook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAQ7C;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA6C5G"}

package/dist/alerts/webhook.js

@@ -0,0 +1,56 @@
+import { createHmac } from "node:crypto";
+import { getLogger } from "../logging/index.js";
+import { renderAlertTemplate } from "./templates.js";
+const logger = getLogger().child({ component: "WebhookHandler" });
+const TIMEOUT_MS = 10_000;
+/**
+ * Send an AlertEvent to a webhook URL via HTTP POST.
+ *
+ * If a `secret` is provided, the request includes an `X-Sorokeep-Signature`
+ * header with an HMAC-SHA256 hex digest of the body, allowing receivers to
+ * verify authenticity.
+ *
+ * Throws on any non-2xx response or network error.
+ * The caller (dispatcher) is responsible for retry logic via the `delivered` flag.
+ */
+export async function sendWebhookAlert(url, event, secret) {
+    logger.debug(`Sending webhook alert to ${url}`, { type: event.type, contractId: event.contractId });
+    const customMessage = renderAlertTemplate("webhook", event);
+    let body;
+    const headers = { "Content-Type": "application/json" };
+    if (customMessage !== null) {
+        body = customMessage;
+        try {
+            JSON.parse(customMessage);
+        }
+        catch {
+            headers["Content-Type"] = "text/plain";
+        }
+    }
+    else {
+        body = JSON.stringify(event);
+    }
+    if (secret) {
+        const signature = createHmac("sha256", secret).update(body).digest("hex");
+        headers["X-Sorokeep-Signature"] = `sha256=${signature}`;
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), TIMEOUT_MS);
+    let response;
+    try {
+        response = await fetch(url, {
+            method: "POST",
+            headers,
+            body,
+            signal: controller.signal,
+        });
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+    if (!response.ok) {
+        throw new Error(`Webhook delivery failed: HTTP ${response.status} from ${url}`);
+    }
+    logger.debug(`Webhook alert delivered successfully to ${url}`);
+}
+//# sourceMappingURL=webhook.js.map

package/dist/alerts/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../src/alerts/webhook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAElE,MAAM,UAAU,GAAG,MAAM,CAAC;AAE1B;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAW,EAAE,KAAiB,EAAE,MAAsB;IACzF,MAAM,CAAC,KAAK,CAAC,4BAA4B,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAEpG,MAAM,aAAa,GAAG,mBAAmB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC5D,IAAI,IAAY,CAAC;IACjB,MAAM,OAAO,GAA2B,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;IAE/E,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QACzB,IAAI,GAAG,aAAa,CAAC;QACrB,IAAI,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,CAAC,cAAc,CAAC,GAAG,YAAY,CAAC;QAC3C,CAAC;IACL,CAAC;SAAM,CAAC;QACJ,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACT,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1E,OAAO,CAAC,sBAAsB,CAAC,GAAG,UAAU,SAAS,EAAE,CAAC;IAC5D,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,UAAU,CAAC,CAAC;IAEjE,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACD,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YACxB,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI;YACJ,MAAM,EAAE,UAAU,CAAC,MAAM;SAC5B,CAAC,CAAC;IACP,CAAC;YAAS,CAAC;QACP,YAAY,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACX,iCAAiC,QAAQ,CAAC,MAAM,SAAS,GAAG,EAAE,CACjE,CAAC;IACN,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,2CAA2C,GAAG,EAAE,CAAC,CAAC;AACnE,CAAC"}

package/dist/cli/schemaFormatter.d.ts

@@ -0,0 +1,11 @@
+export type SchemaDictionary = Record<string, string>;
+export declare function loadSchema(schemaPath: string): SchemaDictionary;
+export declare function applySchema(data: any, schema: SchemaDictionary): any;
+/**
+ * Wrapper used by CLI inspect formatting: loads schema when schemaPath is provided.
+ *
+ * - If schemaPath is undefined, returns schema map as undefined (caller should skip transformation)
+ * - If schemaPath is provided, loads+validates schema and applies translation to `data`.
+ */
+export declare function loadAndApplySchema(data: any, schemaPath?: string): any;
+//# sourceMappingURL=schemaFormatter.d.ts.map

package/dist/cli/schemaFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaFormatter.d.ts","sourceRoot":"","sources":["../../src/cli/schemaFormatter.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAwBtD,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAwB/D;AAuBD,wBAAgB,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,GAAG,GAAG,CAGpE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,GAAG,CAItE"}

package/dist/cli/schemaFormatter.js

@@ -0,0 +1,74 @@
+import fs from "node:fs";
+function normalizeSchemaCandidate(input) {
+    if (typeof input !== "object" || input === null || Array.isArray(input)) {
+        throw new Error("Schema configuration error: schema JSON must be a top-level object mapping raw keys to labels");
+    }
+    const candidate = input;
+    const out = {};
+    for (const [k, v] of Object.entries(candidate)) {
+        if (typeof v !== "string") {
+            throw new Error(`Schema configuration error: schema value for key '${k}' must be a string label`);
+        }
+        out[k] = v;
+    }
+    return out;
+}
+export function loadSchema(schemaPath) {
+    try {
+        const raw = fs.readFileSync(schemaPath, "utf8");
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`Schema configuration error: malformed JSON in schema file: ${msg}`, { cause: err });
+        }
+        return normalizeSchemaCandidate(parsed);
+    }
+    catch (err) {
+        const nodeErr = err;
+        if (nodeErr?.code === "ENOENT") {
+            throw new Error(`Schema configuration error: schema file not found at '${schemaPath}'`, { cause: err } // Pass the original caught variable directly
+            );
+        }
+        const msg = nodeErr?.message ?? String(err);
+        throw new Error(`Schema configuration error: failed to load schema file: ${msg}`, { cause: err }); // Pass the original caught variable directly
+    }
+}
+function applySchemaToValue(value, schema) {
+    if (typeof value === "string") {
+        return schema[value] ?? value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((v) => applySchemaToValue(v, schema));
+    }
+    if (typeof value === "object" && value !== null) {
+        const obj = value;
+        const out = {};
+        for (const [key, v] of Object.entries(obj)) {
+            const nextKey = schema[key] ?? key;
+            out[nextKey] = applySchemaToValue(v, schema);
+        }
+        return out;
+    }
+    return value;
+}
+export function applySchema(data, schema) {
+    if (!schema || Object.keys(schema).length === 0)
+        return data;
+    return applySchemaToValue(data, schema);
+}
+/**
+ * Wrapper used by CLI inspect formatting: loads schema when schemaPath is provided.
+ *
+ * - If schemaPath is undefined, returns schema map as undefined (caller should skip transformation)
+ * - If schemaPath is provided, loads+validates schema and applies translation to `data`.
+ */
+export function loadAndApplySchema(data, schemaPath) {
+    if (!schemaPath)
+        return data;
+    const schema = loadSchema(schemaPath);
+    return applySchema(data, schema);
+}
+//# sourceMappingURL=schemaFormatter.js.map

package/dist/cli/schemaFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaFormatter.js","sourceRoot":"","sources":["../../src/cli/schemaFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAIzB,SAAS,wBAAwB,CAAC,KAAc;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CACb,+FAA+F,CAChG,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,KAAgC,CAAC;IACnD,MAAM,GAAG,GAAqB,EAAE,CAAC;IAEjC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/C,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,qDAAqD,CAAC,0BAA0B,CACjF,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACb,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,UAAkB;IACzC,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAChD,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,8DAA8D,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACzG,CAAC;QAED,OAAO,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,OAAO,GAAG,GAA4B,CAAC;QAC7C,IAAI,OAAO,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACX,yDAAyD,UAAU,GAAG,EACtE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,6CAA6C;aAC/D,CAAC;QACN,CAAC;QAED,MAAM,GAAG,GAAG,OAAO,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,2DAA2D,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,6CAA6C;IACpJ,CAAC;AACL,CAAC;AACD,SAAS,kBAAkB,CAAC,KAAc,EAAE,MAAwB;IAClE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;IAChC,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;YACnC,GAAG,CAAC,OAAO,CAAC,GAAG,kBAAkB,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAS,EAAE,MAAwB;IAC7D,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7D,OAAO,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAS,EAAE,UAAmB;IAC/D,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACtC,OAAO,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACnC,CAAC"}

package/dist/commands/alerts.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerAlertsCommand(program: Command): void;
+//# sourceMappingURL=alerts.d.ts.map