sorokeep 1.0.0

package/dist/alerts/alerts.d.ts

@@ -0,0 +1,21 @@
+export type AlertEventType = "budget_exhausted" | "system_error";
+export type AlertSeverity = "warning" | "error" | "info";
+export interface AlertEvent {
+    type: AlertEventType;
+    severity: AlertSeverity;
+    contractId: string;
+    message: string;
+    timestamp: number;
+}
+export interface NotificationChannel {
+    type: "slack" | "webhook" | "discord";
+    send: (event: AlertEvent) => Promise<{
+        success: boolean;
+    }>;
+}
+export declare class AlertDispatcher {
+    private channels;
+    constructor(channels: NotificationChannel[]);
+    dispatchEvent(event: AlertEvent): Promise<void>;
+}
+//# sourceMappingURL=alerts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../src/alerts/alerts.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAAG,cAAc,CAAC;AACjE,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,aAAa,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IACtC,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAwB;gBAE5B,QAAQ,EAAE,mBAAmB,EAAE;IAIrC,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAUtD"}

package/dist/alerts/alerts.js

@@ -0,0 +1,18 @@
+export class AlertDispatcher {
+    channels;
+    constructor(channels) {
+        this.channels = channels;
+    }
+    async dispatchEvent(event) {
+        const deliveryPromises = this.channels.map(async (channel) => {
+            try {
+                await channel.send(event);
+            }
+            catch (error) {
+                console.error(`[AlertDispatcher] Delivery failed for: ${channel.type}`, error);
+            }
+        });
+        await Promise.all(deliveryPromises);
+    }
+}
+//# sourceMappingURL=alerts.js.map

package/dist/alerts/alerts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.js","sourceRoot":"","sources":["../../src/alerts/alerts.ts"],"names":[],"mappings":"AAgBA,MAAM,OAAO,eAAe;IAClB,QAAQ,CAAwB;IAExC,YAAY,QAA+B;QACzC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,KAAiB;QACnC,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAC3D,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,0CAA0C,OAAO,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;YACjF,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/alerts/discord.d.ts

@@ -0,0 +1,3 @@
+import type { AlertEvent } from "./types.js";
+export declare function sendDiscordAlert(webhookUrl: string, event: AlertEvent): Promise<void>;
+//# sourceMappingURL=discord.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discord.d.ts","sourceRoot":"","sources":["../../src/alerts/discord.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,YAAY,CAAC;AAkL5D,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAuE3F"}

package/dist/alerts/discord.js

@@ -0,0 +1,199 @@
+import { getLogger } from "../logging/index.js";
+import { renderAlertTemplate } from "./templates.js";
+const logger = getLogger().child({ component: "DiscordHandler" });
+const TIMEOUT_MS = 10_000;
+// ─── Discord embed color palette ─────────────────────────────────────────────
+const SEVERITY_COLORS = {
+    critical: 0xFF0000, // red
+    warning: 0xFFA500, // orange
+    info: 0x00CC44, // green
+};
+function severityEmoji(event) {
+    if (event.type === "alert_resolved")
+        return "✅";
+    if (event.type === "state_changed")
+        return "🔄";
+    if (event.severity === "critical")
+        return "🔴";
+    return "⚠️";
+}
+function buildTitle(event) {
+    const icon = severityEmoji(event);
+    const contractDisplay = event.contractName ?? event.contractId;
+    if (event.type === "alert_resolved") {
+        return `${icon} Alert Resolved — ${contractDisplay}`;
+    }
+    if (event.type === "state_changed") {
+        const diffLabel = event.diff.diffType.charAt(0).toUpperCase() + event.diff.diffType.slice(1);
+        return `${icon} State ${diffLabel} — ${contractDisplay}`;
+    }
+    const level = event.severity === "critical" ? "CRITICAL" : "Warning";
+    return `${icon} TTL ${level} — ${contractDisplay}`;
+}
+function buildEmbed(event) {
+    const contractDisplay = event.contractName ?? event.contractId;
+    const fields = [
+        {
+            name: "Contract",
+            value: contractDisplay,
+            inline: true,
+        },
+        {
+            name: "Network",
+            value: event.network,
+            inline: true,
+        },
+    ];
+    if (event.type === "resource_alert") {
+        fields.push({
+            name: "Resource",
+            value: event.resource.type === "cpu" ? "CPU" : "Memory",
+            inline: true,
+        }, {
+            name: "Usage",
+            value: `${event.resource.usagePercent}% (${event.resource.currentUsage.toLocaleString()} / ${event.resource.limit.toLocaleString()})`,
+            inline: true,
+        }, {
+            name: "Severity",
+            value: event.severity.toUpperCase(),
+            inline: true,
+        });
+    }
+    else if (event.type === "state_changed") {
+        fields.push({
+            name: "Entry",
+            value: event.entry.label ?? event.entry.type,
+            inline: true,
+        }, {
+            name: "Change Type",
+            value: event.diff.diffType,
+            inline: true,
+        }, {
+            name: "Old Value",
+            value: `\`${event.diff.oldValueXdr ?? "(none)"}\``,
+            inline: false,
+        }, {
+            name: "New Value",
+            value: `\`${event.diff.newValueXdr ?? "(none)"}\``,
+            inline: false,
+        });
+    }
+    else {
+        fields.push({
+            name: "Entry",
+            value: event.entry.label ?? event.entry.type,
+            inline: true,
+        }, {
+            name: "Remaining TTL",
+            value: `${event.threshold.currentRemainingLedgers.toLocaleString()} ledgers (${event.threshold.approximateTimeRemaining})`,
+            inline: true,
+        }, {
+            name: "Alert Threshold",
+            value: `${event.threshold.configuredLedgers.toLocaleString()} ledgers`,
+            inline: true,
+        }, {
+            name: "Severity",
+            value: event.severity.toUpperCase(),
+            inline: true,
+        });
+    }
+    return {
+        title: buildTitle(event),
+        color: SEVERITY_COLORS[event.severity],
+        fields,
+        footer: {
+            text: `Run \`sorokeep status ${event.contractId}\` for details.`,
+        },
+        timestamp: event.timestamp,
+    };
+}
+// ─── Webhook URL validation ───────────────────────────────────────────────────
+function validateWebhookUrl(webhookUrl) {
+    if (!webhookUrl) {
+        throw new Error("Discord webhook URL is required. " +
+            "Pass the full URL from your Discord channel's Integrations → Webhooks settings.");
+    }
+    let parsed;
+    try {
+        parsed = new URL(webhookUrl);
+    }
+    catch {
+        throw new Error(`Invalid Discord webhook URL: "${webhookUrl}". ` +
+            "Expected a URL like https://discord.com/api/webhooks/<id>/<token>.");
+    }
+    if (!parsed.hostname.includes("discord")) {
+        throw new Error(`Invalid Discord webhook URL: "${webhookUrl}". ` +
+            "Expected a URL like https://discord.com/api/webhooks/<id>/<token>.");
+    }
+}
+// ─── Public API ───────────────────────────────────────────────────────────────
+export async function sendDiscordAlert(webhookUrl, event) {
+    validateWebhookUrl(webhookUrl);
+    logger.debug(`Sending Discord alert to webhook`, {
+        type: event.type,
+        contractId: event.contractId,
+        severity: event.severity,
+    });
+    const customMessage = renderAlertTemplate("discord", event);
+    let payload;
+    if (customMessage !== null) {
+        try {
+            const parsed = JSON.parse(customMessage);
+            if (parsed && typeof parsed === "object") {
+                payload = {
+                    username: "Sorokeep",
+                    ...parsed,
+                };
+            }
+            else {
+                payload = {
+                    username: "Sorokeep",
+                    content: customMessage,
+                };
+            }
+        }
+        catch {
+            payload = {
+                username: "Sorokeep",
+                content: customMessage,
+            };
+        }
+    }
+    else {
+        payload = {
+            username: "Sorokeep",
+            embeds: [buildEmbed(event)],
+        };
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), TIMEOUT_MS);
+    let response;
+    try {
+        response = await fetch(webhookUrl, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(payload),
+            signal: controller.signal,
+        });
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+    // Discord returns 204 No Content on success
+    if (!response.ok) {
+        let detail = "";
+        try {
+            const body = await response.json();
+            if (body.message)
+                detail = `: ${body.message}`;
+        }
+        catch {
+            // body not JSON — ignore
+        }
+        throw new Error(`Discord webhook request failed: HTTP ${response.status}${detail}`);
+    }
+    logger.debug(`Discord alert delivered successfully`);
+}
+//# sourceMappingURL=discord.js.map

package/dist/alerts/discord.js.map

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

package/dist/alerts/dispatcher.d.ts

@@ -0,0 +1,13 @@
+import type Database from "better-sqlite3";
+import { type AlertEvent, type AlertChannel } from "./types.js";
+export interface DeliveryResult {
+    attempted: number;
+    delivered: number;
+    failed: number;
+    abandoned: number;
+    errors: string[];
+}
+export declare const DEFAULT_CHANNELS: Record<string, AlertChannel>;
+export declare function deliverPendingAlerts(db: Database.Database, network: string, channels?: Record<string, AlertChannel>): Promise<DeliveryResult>;
+export declare function deliverSingleAlert(channelType: "webhook" | "slack" | "pagerduty" | "discord" | "telegram", channelTarget: string, event: AlertEvent, webhookSecret?: string | null, channels?: Record<string, AlertChannel>): Promise<boolean>;
+//# sourceMappingURL=dispatcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/alerts/dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAmB,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAQjF,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAgBzD,CAAC;AAEF,wBAAsB,oBAAoB,CACtC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAoB,GAC1D,OAAO,CAAC,cAAc,CAAC,CAgEzB;AAED,wBAAsB,kBAAkB,CACpC,WAAW,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,EACvE,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,UAAU,EACjB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,EAC7B,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAoB,GAC1D,OAAO,CAAC,OAAO,CAAC,CAUlB"}

package/dist/alerts/dispatcher.js

@@ -0,0 +1,91 @@
+import { getUndeliveredAlerts, markAlertDelivered, incrementRetryCount, MAX_RETRY_COUNT } from "../db/repositories.js";
+import { buildAlertEvent } from "./types.js";
+import { sendWebhookAlert } from "./webhook.js";
+import { SlackChannel } from "./slack.js";
+import { sendPagerDutyAlert } from "./pagerduty.js";
+import { getLogger } from "../logging/index.js";
+const logger = getLogger().child({ component: "AlertDispatcher" });
+export const DEFAULT_CHANNELS = {
+    webhook: { send: sendWebhookAlert },
+    slack: { send: (target, event) => new SlackChannel(target).send(event) },
+    pagerduty: { send: (target, event) => sendPagerDutyAlert(target, event) },
+    discord: {
+        send: async (target, event) => {
+            const { sendDiscordAlert } = await import("./discord.js");
+            await sendDiscordAlert(target, event);
+        }
+    },
+    telegram: {
+        send: async (target, event) => {
+            const { sendTelegramAlert } = await import("./telegram.js");
+            await sendTelegramAlert(target, event);
+        }
+    },
+};
+export async function deliverPendingAlerts(db, network, channels = DEFAULT_CHANNELS) {
+    const pending = getUndeliveredAlerts(db, network);
+    const result = {
+        attempted: 0,
+        delivered: 0,
+        failed: 0,
+        abandoned: 0,
+        errors: [],
+    };
+    if (pending.length === 0)
+        return result;
+    logger.debug(`Dispatcher: ${pending.length} undelivered alert(s) for network ${network}`);
+    for (const alert of pending) {
+        result.attempted++;
+        const event = buildAlertEvent({
+            type: "threshold_crossed",
+            contractId: alert.contractId,
+            contractName: alert.contractName,
+            network: alert.network,
+            entryKeyXdr: alert.entryKeyXdr,
+            entryType: alert.entryType,
+            entryLabel: alert.entryLabel,
+            configuredLedgers: alert.thresholdLedgers,
+            remainingTTL: alert.remainingTTL,
+            firedAtLedger: alert.firedAtLedger,
+        });
+        try {
+            const channel = channels[alert.channelType];
+            if (!channel)
+                throw new Error(`Unknown channel type: ${alert.channelType}`);
+            await channel.send(alert.channelTarget, event, alert.webhookSecret);
+            markAlertDelivered(db, alert.alertFiredId);
+            result.delivered++;
+            logger.info(`Alert delivered — id: ${alert.alertFiredId}, channel: ${alert.channelType}, contract: ${alert.contractId}`);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            result.failed++;
+            result.errors.push(message);
+            incrementRetryCount(db, alert.alertFiredId);
+            const nextRetry = alert.retryCount + 1;
+            if (nextRetry >= MAX_RETRY_COUNT) {
+                result.abandoned++;
+                logger.error(`Alert abandoned after ${MAX_RETRY_COUNT} retries — id: ${alert.alertFiredId}, channel: ${alert.channelType}, error: ${message}`);
+            }
+            else {
+                logger.warn(`Alert delivery failed (attempt ${nextRetry}/${MAX_RETRY_COUNT}) — id: ${alert.alertFiredId}, channel: ${alert.channelType}, error: ${message}`);
+            }
+        }
+    }
+    logger.debug(`Dispatcher finished — attempted: ${result.attempted}, delivered: ${result.delivered}, failed: ${result.failed}, abandoned: ${result.abandoned}`);
+    return result;
+}
+export async function deliverSingleAlert(channelType, channelTarget, event, webhookSecret, channels = DEFAULT_CHANNELS) {
+    try {
+        const channel = channels[channelType];
+        if (!channel)
+            throw new Error(`Unknown channel type: ${channelType}`);
+        await channel.send(channelTarget, event, webhookSecret ?? null);
+        return true;
+    }
+    catch (error) {
+        logger.warn(`Single alert delivery failed for ${channelType}: ${error instanceof Error ? error.message : String(error)}`);
+        return false;
+    }
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/alerts/dispatcher.js.map

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

package/dist/alerts/keys.d.ts

@@ -0,0 +1,24 @@
+export interface KeychainStore {
+    saveKey(name: string, secret: string): Promise<boolean>;
+    listKeys(): Promise<string[]>;
+}
+/**
+ * Keytar-backed system credential manager layer
+ */
+export declare class SecureKeypairStore implements KeychainStore {
+    private serviceName;
+    private keytar;
+    constructor(keytarMock?: any);
+    saveKey(name: string, secret: string): Promise<boolean>;
+    listKeys(): Promise<string[]>;
+}
+/**
+ * CLI Command Router mimicking 'sorokeep keys add' actions
+ */
+export declare class KeysCliController {
+    private store;
+    constructor(store: KeychainStore);
+    handleAddKeyCommand(name: string, promptedSecret: string): Promise<string>;
+    handleListKeysCommand(): Promise<string[]>;
+}
+//# sourceMappingURL=keys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/alerts/keys.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IACtD,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,MAAM,CAAM;gBAER,UAAU,CAAC,EAAE,GAAG;IAKtB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASvD,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAKpC;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAAgB;gBAEjB,KAAK,EAAE,aAAa;IAK1B,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM1E,qBAAqB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAIjD"}

package/dist/alerts/keys.js

@@ -0,0 +1,44 @@
+/**
+ * Keytar-backed system credential manager layer
+ */
+export class SecureKeypairStore {
+    serviceName = "sorokeep-keys";
+    keytar;
+    constructor(keytarMock) {
+        // Fallback to allow mock injection during test environments safely
+        this.keytar = keytarMock;
+    }
+    async saveKey(name, secret) {
+        if (!name || !secret) {
+            throw new Error("Key name and secret key value are both required.");
+        }
+        // Step 1: Securely write target secret to local OS credentials manager vault
+        await this.keytar.setPassword(this.serviceName, name, secret);
+        return true;
+    }
+    async listKeys() {
+        // Retrieve all account entries linked under our application signature service tag
+        const credentials = await this.keytar.findCredentials(this.serviceName);
+        return credentials.map((cred) => cred.account);
+    }
+}
+/**
+ * CLI Command Router mimicking 'sorokeep keys add' actions
+ */
+export class KeysCliController {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    // Simulates executing: sorokeep keys add --name <name>
+    async handleAddKeyCommand(name, promptedSecret) {
+        await this.store.saveKey(name, promptedSecret);
+        return `Success: Keypair registered securely under label [${name}].`;
+    }
+    // Simulates execution that lists labels without leaking values
+    async handleListKeysCommand() {
+        const labels = await this.store.listKeys();
+        return labels; // Strictly returns names/labels; values stay safely hidden inside OS vault
+    }
+}
+//# sourceMappingURL=keys.js.map

package/dist/alerts/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../src/alerts/keys.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACrB,WAAW,GAAG,eAAe,CAAC;IAC9B,MAAM,CAAM;IAEpB,YAAY,UAAgB;QAC1B,mEAAmE;QACnE,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,MAAc;QACxC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QACD,6EAA6E;QAC7E,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,kFAAkF;QAClF,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxE,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,IAAyB,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtE,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACpB,KAAK,CAAgB;IAE7B,YAAY,KAAoB;QAC9B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,mBAAmB,CAAC,IAAY,EAAE,cAAsB;QAC5D,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAC/C,OAAO,qDAAqD,IAAI,IAAI,CAAC;IACvE,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,qBAAqB;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC3C,OAAO,MAAM,CAAC,CAAC,2EAA2E;IAC5F,CAAC;CACF"}

package/dist/alerts/pagerduty.d.ts

@@ -0,0 +1,8 @@
+import type { AlertEvent } from "./types.js";
+export declare class PagerDutyChannel {
+    #private;
+    constructor(routingKey: string);
+    send(event: AlertEvent): Promise<void>;
+}
+export declare function sendPagerDutyAlert(routingKey: string, event: AlertEvent): Promise<void>;
+//# sourceMappingURL=pagerduty.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pagerduty.d.ts","sourceRoot":"","sources":["../../src/alerts/pagerduty.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA2G7C,qBAAa,gBAAgB;;gBAGb,UAAU,EAAE,MAAM;IAOjB,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAyDtD;AAED,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAG7F"}

package/dist/alerts/pagerduty.js

@@ -0,0 +1,164 @@
+import { getLogger } from "../logging/index.js";
+import { renderAlertTemplate } from "./templates.js";
+const logger = getLogger().child({ component: "PagerDutyHandler" });
+const PAGERDUTY_EVENTS_URL = "https://events.pagerduty.com/v2/enqueue";
+const TIMEOUT_MS = 10_000;
+function mapSeverity(event) {
+    if (event.type === "alert_resolved")
+        return "info";
+    return event.severity === "critical" ? "critical" : "warning";
+}
+function buildDedupKey(event) {
+    if (event.type === "resource_alert") {
+        return `sorokeep:${event.network}:${event.contractId}:resource:${event.resource.type}`;
+    }
+    if (event.type === "state_changed") {
+        return `sorokeep:${event.network}:${event.contractId}:state:${event.entry.keyXdr}:${event.diff.diffType}`;
+    }
+    const entryKey = event.entry.keyXdr || event.entry.type;
+    return `sorokeep:${event.network}:${event.contractId}:${entryKey}:${event.threshold.configuredLedgers}`;
+}
+function buildSummary(event) {
+    const contractDisplay = event.contractName ?? event.contractId;
+    if (event.type === "resource_alert") {
+        const resourceLabel = event.resource.type === "cpu" ? "CPU" : "Memory";
+        return `Sorokeep alert: ${contractDisplay} is consuming too much ${resourceLabel} (${event.resource.usagePercent}% used).`;
+    }
+    if (event.type === "threshold_crossed") {
+        return `Sorokeep alert: ${contractDisplay} has crossed the TTL threshold (${event.threshold.currentRemainingLedgers} ledgers remaining).`;
+    }
+    if (event.type === "state_changed") {
+        const diffLabel = event.diff.diffType.charAt(0).toUpperCase() + event.diff.diffType.slice(1);
+        return `Sorokeep alert: ${contractDisplay} state ${event.diff.diffType} detected for entry ${event.entry.label ?? event.entry.type}.`;
+    }
+    return `Sorokeep alert resolved: ${contractDisplay} has recovered above threshold.`;
+}
+function buildCustomDetails(event) {
+    if (event.type === "resource_alert") {
+        return {
+            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,
+        };
+    }
+    if (event.type === "state_changed") {
+        return {
+            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,
+            oldValueXdr: event.diff.oldValueXdr,
+            newValueXdr: event.diff.newValueXdr,
+            detectedAtLedger: event.detectedAtLedger,
+            timestamp: event.timestamp,
+        };
+    }
+    return {
+        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,
+    };
+}
+function buildPayload(event) {
+    return {
+        routing_key: "",
+        event_action: event.type === "threshold_crossed" || event.type === "resource_alert" || event.type === "state_changed" ? "trigger" : "resolve",
+        dedup_key: buildDedupKey(event),
+        payload: {
+            summary: buildSummary(event),
+            source: event.contractId,
+            severity: mapSeverity(event),
+            component: event.type === "resource_alert" ? "resource_monitor" : event.type === "state_changed" ? "state_monitor" : (event.entry.label ?? event.entry.type),
+            group: event.network,
+            class: event.type === "resource_alert" ? `resource:${event.resource.type}` : event.type === "state_changed" ? `state:${event.diff.diffType}` : `threshold:${event.threshold.configuredLedgers}`,
+            custom_details: buildCustomDetails(event),
+        },
+    };
+}
+export class PagerDutyChannel {
+    #routingKey;
+    constructor(routingKey) {
+        if (!routingKey || routingKey.trim() === "") {
+            throw new Error("PagerDuty routing key is required.");
+        }
+        this.#routingKey = routingKey;
+    }
+    async send(event) {
+        logger.debug(`Sending PagerDuty event: ${event.type}`, { contractId: event.contractId });
+        const customMessage = renderAlertTemplate("pagerduty", event);
+        const payload = buildPayload(event);
+        payload.routing_key = this.#routingKey;
+        if (customMessage !== null) {
+            try {
+                const parsed = JSON.parse(customMessage);
+                if (parsed && typeof parsed === "object") {
+                    if (parsed.payload && typeof parsed.payload === "object") {
+                        payload.payload = {
+                            ...payload.payload,
+                            ...parsed.payload,
+                        };
+                    }
+                    if (parsed.routing_key)
+                        payload.routing_key = parsed.routing_key;
+                    if (parsed.event_action)
+                        payload.event_action = parsed.event_action;
+                    if (parsed.dedup_key)
+                        payload.dedup_key = parsed.dedup_key;
+                    for (const key of Object.keys(parsed)) {
+                        if (key !== "payload" && key !== "routing_key" && key !== "event_action" && key !== "dedup_key") {
+                            payload[key] = parsed[key];
+                        }
+                    }
+                }
+                else {
+                    payload.payload.summary = customMessage;
+                }
+            }
+            catch {
+                payload.payload.summary = customMessage;
+            }
+        }
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), TIMEOUT_MS);
+        let response;
+        try {
+            response = await fetch(PAGERDUTY_EVENTS_URL, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(payload),
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+        if (!response.ok) {
+            throw new Error(`PagerDuty API request failed: HTTP ${response.status}`);
+        }
+        logger.debug(`PagerDuty event delivered successfully: ${event.type}`);
+    }
+}
+export async function sendPagerDutyAlert(routingKey, event) {
+    const channel = new PagerDutyChannel(routingKey);
+    await channel.send(event);
+}
+//# sourceMappingURL=pagerduty.js.map