@blokjs/runner 0.2.0

package/dist/monitoring/HealthCheck.js

@@ -0,0 +1,102 @@
+/**
+ * Health Check Infrastructure for Blok Triggers
+ *
+ * Provides standardized health check capabilities across all trigger types.
+ * Supports Kubernetes readiness/liveness probes and custom dependency checks.
+ */
+export class HealthCheck {
+    startTime;
+    dependencies = new Map();
+    cachedResults = new Map();
+    cacheMaxAge;
+    constructor(cacheMaxAgeMs = 5000) {
+        this.startTime = Date.now();
+        this.cacheMaxAge = cacheMaxAgeMs;
+    }
+    /**
+     * Register a named dependency health check.
+     */
+    registerDependency(name, checkFn) {
+        this.dependencies.set(name, checkFn);
+    }
+    /**
+     * Remove a registered dependency check.
+     */
+    removeDependency(name) {
+        this.dependencies.delete(name);
+        this.cachedResults.delete(name);
+    }
+    /**
+     * Run all dependency checks and return aggregated health.
+     */
+    async check() {
+        const checks = {};
+        const entries = Array.from(this.dependencies.entries());
+        const results = await Promise.allSettled(entries.map(async ([name, checkFn]) => {
+            const cached = this.cachedResults.get(name);
+            if (cached && Date.now() - cached.lastChecked < this.cacheMaxAge) {
+                return { name, result: cached };
+            }
+            const start = performance.now();
+            try {
+                const result = await checkFn();
+                result.latency_ms = performance.now() - start;
+                result.lastChecked = Date.now();
+                this.cachedResults.set(name, result);
+                return { name, result };
+            }
+            catch (err) {
+                const result = {
+                    status: "unhealthy",
+                    latency_ms: performance.now() - start,
+                    message: err instanceof Error ? err.message : String(err),
+                    lastChecked: Date.now(),
+                };
+                this.cachedResults.set(name, result);
+                return { name, result };
+            }
+        }));
+        for (const settled of results) {
+            if (settled.status === "fulfilled") {
+                checks[settled.value.name] = settled.value.result;
+            }
+        }
+        const status = this.aggregateStatus(checks);
+        return {
+            status,
+            timestamp: Date.now(),
+            uptime: Date.now() - this.startTime,
+            checks,
+        };
+    }
+    /**
+     * Quick liveness check - is the process alive and responsive?
+     */
+    liveness() {
+        return {
+            status: "ok",
+            uptime: Date.now() - this.startTime,
+        };
+    }
+    /**
+     * Readiness check - are all dependencies healthy?
+     */
+    async readiness() {
+        const result = await this.check();
+        return {
+            ready: result.status !== "unhealthy",
+            status: result.status,
+        };
+    }
+    aggregateStatus(checks) {
+        const statuses = Object.values(checks);
+        if (statuses.length === 0)
+            return "healthy";
+        if (statuses.some((c) => c.status === "unhealthy"))
+            return "unhealthy";
+        if (statuses.some((c) => c.status === "degraded"))
+            return "degraded";
+        return "healthy";
+    }
+}
+//# sourceMappingURL=HealthCheck.js.map

package/dist/monitoring/HealthCheck.js.map

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

package/dist/monitoring/PerformanceProfiler.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Performance Profiler for Blok Workflows
+ *
+ * Collects and analyzes per-node execution metrics to identify
+ * bottlenecks and hot paths in workflow execution.
+ *
+ * @example
+ * ```typescript
+ * const profiler = new PerformanceProfiler();
+ * profiler.addSample("user-api", "validator", 5.2, 12, 2.1);
+ * profiler.addSample("user-api", "db-query", 120.5, 45, 8.3);
+ * profiler.addSample("user-api", "formatter", 3.1, 10, 1.2);
+ * console.log(profiler.toTable());
+ * ```
+ */
+export interface NodeProfile {
+    nodeName: string;
+    workflowName: string;
+    executionCount: number;
+    totalTimeMs: number;
+    avgTimeMs: number;
+    minTimeMs: number;
+    maxTimeMs: number;
+    p50Ms: number;
+    p95Ms: number;
+    p99Ms: number;
+    memoryAvgMb: number;
+    memoryPeakMb: number;
+    cpuAvgPct: number;
+    errorCount: number;
+    errorRate: number;
+    percentOfTotal: number;
+}
+export interface WorkflowProfile {
+    workflowName: string;
+    totalExecutions: number;
+    avgTotalTimeMs: number;
+    p95TotalTimeMs: number;
+    nodes: NodeProfile[];
+    bottleneck: NodeProfile | null;
+    hotPath: string[];
+}
+export interface ProfileConfig {
+    topN?: number;
+}
+export declare class PerformanceProfiler {
+    private config;
+    private samples;
+    private workflowTotals;
+    constructor(config?: ProfileConfig);
+    addSample(workflowName: string, nodeName: string, latencyMs: number, memoryMb?: number, cpuPct?: number, error?: boolean): void;
+    addWorkflowSample(workflowName: string, totalTimeMs: number): void;
+    getProfiles(): WorkflowProfile[];
+    getBottlenecks(topN?: number): NodeProfile[];
+    getHotPath(workflowName: string): string[];
+    toTable(): string;
+    toFlameChart(): string;
+    toJson(): string;
+    reset(): void;
+    private percentile;
+    private fmtMs;
+    private padColumns;
+}

package/dist/monitoring/PerformanceProfiler.js

@@ -0,0 +1,229 @@
+/**
+ * Performance Profiler for Blok Workflows
+ *
+ * Collects and analyzes per-node execution metrics to identify
+ * bottlenecks and hot paths in workflow execution.
+ *
+ * @example
+ * ```typescript
+ * const profiler = new PerformanceProfiler();
+ * profiler.addSample("user-api", "validator", 5.2, 12, 2.1);
+ * profiler.addSample("user-api", "db-query", 120.5, 45, 8.3);
+ * profiler.addSample("user-api", "formatter", 3.1, 10, 1.2);
+ * console.log(profiler.toTable());
+ * ```
+ */
+const MAX_SAMPLES = 10_000;
+export class PerformanceProfiler {
+    config;
+    samples = new Map();
+    workflowTotals = new Map();
+    constructor(config) {
+        this.config = {
+            topN: config?.topN ?? 10,
+        };
+    }
+    addSample(workflowName, nodeName, latencyMs, memoryMb, cpuPct, error) {
+        if (!this.samples.has(workflowName)) {
+            this.samples.set(workflowName, new Map());
+        }
+        const workflowMap = this.samples.get(workflowName);
+        if (!workflowMap)
+            return;
+        if (!workflowMap.has(nodeName)) {
+            workflowMap.set(nodeName, {
+                latencies: [],
+                memories: [],
+                cpus: [],
+                errors: 0,
+            });
+        }
+        const node = workflowMap.get(nodeName);
+        if (!node)
+            return;
+        node.latencies.push(latencyMs);
+        if (memoryMb !== undefined)
+            node.memories.push(memoryMb);
+        if (cpuPct !== undefined)
+            node.cpus.push(cpuPct);
+        if (error)
+            node.errors++;
+        // Trim to max samples
+        if (node.latencies.length > MAX_SAMPLES) {
+            node.latencies = node.latencies.slice(-MAX_SAMPLES / 2);
+        }
+        if (node.memories.length > MAX_SAMPLES) {
+            node.memories = node.memories.slice(-MAX_SAMPLES / 2);
+        }
+        if (node.cpus.length > MAX_SAMPLES) {
+            node.cpus = node.cpus.slice(-MAX_SAMPLES / 2);
+        }
+    }
+    addWorkflowSample(workflowName, totalTimeMs) {
+        if (!this.workflowTotals.has(workflowName)) {
+            this.workflowTotals.set(workflowName, []);
+        }
+        this.workflowTotals.get(workflowName)?.push(totalTimeMs);
+    }
+    getProfiles() {
+        const profiles = [];
+        for (const [workflowName, workflowMap] of this.samples) {
+            const nodes = [];
+            let totalAvgTime = 0;
+            for (const [nodeName, data] of workflowMap) {
+                const sorted = [...data.latencies].sort((a, b) => a - b);
+                const count = sorted.length;
+                const sum = sorted.reduce((a, b) => a + b, 0);
+                const avg = count > 0 ? sum / count : 0;
+                const memAvg = data.memories.length > 0 ? data.memories.reduce((a, b) => a + b, 0) / data.memories.length : 0;
+                const memPeak = data.memories.length > 0 ? Math.max(...data.memories) : 0;
+                const cpuAvg = data.cpus.length > 0 ? data.cpus.reduce((a, b) => a + b, 0) / data.cpus.length : 0;
+                totalAvgTime += avg;
+                nodes.push({
+                    nodeName,
+                    workflowName,
+                    executionCount: count,
+                    totalTimeMs: sum,
+                    avgTimeMs: avg,
+                    minTimeMs: count > 0 ? sorted[0] : 0,
+                    maxTimeMs: count > 0 ? sorted[count - 1] : 0,
+                    p50Ms: this.percentile(sorted, 50),
+                    p95Ms: this.percentile(sorted, 95),
+                    p99Ms: this.percentile(sorted, 99),
+                    memoryAvgMb: memAvg,
+                    memoryPeakMb: memPeak,
+                    cpuAvgPct: cpuAvg,
+                    errorCount: data.errors,
+                    errorRate: count > 0 ? data.errors / count : 0,
+                    percentOfTotal: 0, // computed below
+                });
+            }
+            // Compute percentOfTotal
+            for (const node of nodes) {
+                node.percentOfTotal = totalAvgTime > 0 ? (node.avgTimeMs / totalAvgTime) * 100 : 0;
+            }
+            // Sort by avgTimeMs descending
+            nodes.sort((a, b) => b.avgTimeMs - a.avgTimeMs);
+            // Workflow totals
+            const wfTotals = this.workflowTotals.get(workflowName) || [];
+            const wfSorted = [...wfTotals].sort((a, b) => a - b);
+            const wfAvg = wfSorted.length > 0 ? wfSorted.reduce((a, b) => a + b, 0) / wfSorted.length : totalAvgTime;
+            profiles.push({
+                workflowName,
+                totalExecutions: nodes.length > 0 ? nodes[0].executionCount : 0,
+                avgTotalTimeMs: wfAvg,
+                p95TotalTimeMs: this.percentile(wfSorted, 95) || wfAvg,
+                nodes,
+                bottleneck: nodes.length > 0 ? nodes[0] : null,
+                hotPath: nodes.map((n) => n.nodeName),
+            });
+        }
+        return profiles;
+    }
+    getBottlenecks(topN) {
+        const n = topN ?? this.config.topN;
+        const allNodes = [];
+        for (const profile of this.getProfiles()) {
+            allNodes.push(...profile.nodes);
+        }
+        allNodes.sort((a, b) => b.avgTimeMs - a.avgTimeMs);
+        return allNodes.slice(0, n);
+    }
+    getHotPath(workflowName) {
+        const profiles = this.getProfiles();
+        const profile = profiles.find((p) => p.workflowName === workflowName);
+        return profile?.hotPath ?? [];
+    }
+    toTable() {
+        const profiles = this.getProfiles();
+        if (profiles.length === 0)
+            return "[No profiling data]";
+        const lines = [];
+        for (const profile of profiles) {
+            lines.push("");
+            lines.push(`  Workflow: ${profile.workflowName}`);
+            lines.push(`  Avg Total: ${this.fmtMs(profile.avgTotalTimeMs)}  |  P95: ${this.fmtMs(profile.p95TotalTimeMs)}  |  Bottleneck: ${profile.bottleneck?.nodeName ?? "N/A"}`);
+            lines.push("");
+            // Header
+            const header = this.padColumns([
+                { val: "Node", width: 24 },
+                { val: "Count", width: 8 },
+                { val: "Avg(ms)", width: 10 },
+                { val: "P50(ms)", width: 10 },
+                { val: "P95(ms)", width: 10 },
+                { val: "P99(ms)", width: 10 },
+                { val: "Mem(MB)", width: 10 },
+                { val: "CPU(%)", width: 8 },
+                { val: "Err%", width: 7 },
+                { val: "% Total", width: 9 },
+            ]);
+            lines.push(`  ${header}`);
+            lines.push(`  ${"─".repeat(header.length)}`);
+            const topNodes = profile.nodes.slice(0, this.config.topN);
+            for (const node of topNodes) {
+                const row = this.padColumns([
+                    { val: node.nodeName.length > 22 ? `${node.nodeName.substring(0, 19)}...` : node.nodeName, width: 24 },
+                    { val: String(node.executionCount), width: 8 },
+                    { val: this.fmtMs(node.avgTimeMs), width: 10 },
+                    { val: this.fmtMs(node.p50Ms), width: 10 },
+                    { val: this.fmtMs(node.p95Ms), width: 10 },
+                    { val: this.fmtMs(node.p99Ms), width: 10 },
+                    { val: node.memoryAvgMb > 0 ? node.memoryAvgMb.toFixed(1) : "-", width: 10 },
+                    { val: node.cpuAvgPct > 0 ? node.cpuAvgPct.toFixed(1) : "-", width: 8 },
+                    { val: (node.errorRate * 100).toFixed(1), width: 7 },
+                    { val: `${node.percentOfTotal.toFixed(1)}%`, width: 9 },
+                ]);
+                lines.push(`  ${row}`);
+            }
+        }
+        lines.push("");
+        return lines.join("\n");
+    }
+    toFlameChart() {
+        const profiles = this.getProfiles();
+        if (profiles.length === 0)
+            return "[No profiling data]";
+        const lines = [];
+        const maxBarWidth = 50;
+        for (const profile of profiles) {
+            lines.push("");
+            lines.push(`  Workflow: ${profile.workflowName}  (Avg: ${this.fmtMs(profile.avgTotalTimeMs)})`);
+            lines.push("");
+            const maxTime = profile.nodes.length > 0 ? Math.max(...profile.nodes.map((n) => n.avgTimeMs)) : 1;
+            for (const node of profile.nodes.slice(0, this.config.topN)) {
+                const barLength = Math.max(1, Math.round((node.avgTimeMs / maxTime) * maxBarWidth));
+                const bar = "█".repeat(barLength);
+                const name = node.nodeName.length > 20 ? `${node.nodeName.substring(0, 17)}...` : node.nodeName;
+                const padded = name + " ".repeat(Math.max(0, 20 - name.length));
+                lines.push(`  ${padded} ${bar} ${this.fmtMs(node.avgTimeMs)} (${node.percentOfTotal.toFixed(0)}%)`);
+            }
+        }
+        lines.push("");
+        return lines.join("\n");
+    }
+    toJson() {
+        return JSON.stringify(this.getProfiles(), null, 2);
+    }
+    reset() {
+        this.samples.clear();
+        this.workflowTotals.clear();
+    }
+    // -- Internal --
+    percentile(sorted, p) {
+        if (sorted.length === 0)
+            return 0;
+        const index = Math.ceil((p / 100) * sorted.length) - 1;
+        return sorted[Math.max(0, Math.min(index, sorted.length - 1))];
+    }
+    fmtMs(ms) {
+        if (ms >= 1000)
+            return `${(ms / 1000).toFixed(2)}s`;
+        if (ms >= 1)
+            return ms.toFixed(1);
+        return ms.toFixed(3);
+    }
+    padColumns(cols) {
+        return cols.map((c) => c.val + " ".repeat(Math.max(0, c.width - c.val.length))).join("");
+    }
+}
+//# sourceMappingURL=PerformanceProfiler.js.map

package/dist/monitoring/PerformanceProfiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerformanceProfiler.js","sourceRoot":"","sources":["../../src/monitoring/PerformanceProfiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA0CH,MAAM,WAAW,GAAG,MAAM,CAAC;AAE3B,MAAM,OAAO,mBAAmB;IACvB,MAAM,CAA0B;IAChC,OAAO,GAA0C,IAAI,GAAG,EAAE,CAAC;IAC3D,cAAc,GAA0B,IAAI,GAAG,EAAE,CAAC;IAE1D,YAAY,MAAsB;QACjC,IAAI,CAAC,MAAM,GAAG;YACb,IAAI,EAAE,MAAM,EAAE,IAAI,IAAI,EAAE;SACxB,CAAC;IACH,CAAC;IAED,SAAS,CACR,YAAoB,EACpB,QAAgB,EAChB,SAAiB,EACjB,QAAiB,EACjB,MAAe,EACf,KAAe;QAEf,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACnD,IAAI,CAAC,WAAW;YAAE,OAAO;QACzB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE;gBACzB,SAAS,EAAE,EAAE;gBACb,QAAQ,EAAE,EAAE;gBACZ,IAAI,EAAE,EAAE;gBACR,MAAM,EAAE,CAAC;aACT,CAAC,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/B,IAAI,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzD,IAAI,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,KAAK;YAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAEzB,sBAAsB;QACtB,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;YACzC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;YACxC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;YACpC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;QAC/C,CAAC;IACF,CAAC;IAED,iBAAiB,CAAC,YAAoB,EAAE,WAAmB;QAC1D,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1D,CAAC;IAED,WAAW;QACV,MAAM,QAAQ,GAAsB,EAAE,CAAC;QAEvC,KAAK,MAAM,CAAC,YAAY,EAAE,WAAW,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACxD,MAAM,KAAK,GAAkB,EAAE,CAAC;YAChC,IAAI,YAAY,GAAG,CAAC,CAAC;YAErB,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC;gBAC5C,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBACzD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;gBAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC9C,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAExC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC9G,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBAElG,YAAY,IAAI,GAAG,CAAC;gBAEpB,KAAK,CAAC,IAAI,CAAC;oBACV,QAAQ;oBACR,YAAY;oBACZ,cAAc,EAAE,KAAK;oBACrB,WAAW,EAAE,GAAG;oBAChB,SAAS,EAAE,GAAG;oBACd,SAAS,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBACpC,SAAS,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC5C,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;oBAClC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;oBAClC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;oBAClC,WAAW,EAAE,MAAM;oBACnB,YAAY,EAAE,OAAO;oBACrB,SAAS,EAAE,MAAM;oBACjB,UAAU,EAAE,IAAI,CAAC,MAAM;oBACvB,SAAS,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;oBAC9C,cAAc,EAAE,CAAC,EAAE,iBAAiB;iBACpC,CAAC,CAAC;YACJ,CAAC;YAED,yBAAyB;YACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBAC1B,IAAI,CAAC,cAAc,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACpF,CAAC;YAED,+BAA+B;YAC/B,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;YAEhD,kBAAkB;YAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;YAC7D,MAAM,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACrD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC;YAEzG,QAAQ,CAAC,IAAI,CAAC;gBACb,YAAY;gBACZ,eAAe,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;gBAC/D,cAAc,EAAE,KAAK;gBACrB,cAAc,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,KAAK;gBACtD,KAAK;gBACL,UAAU,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;gBAC9C,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;aACrC,CAAC,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC;IACjB,CAAC;IAED,cAAc,CAAC,IAAa;QAC3B,MAAM,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QACnC,MAAM,QAAQ,GAAkB,EAAE,CAAC;QAEnC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YAC1C,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;QACnD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7B,CAAC;IAED,UAAU,CAAC,YAAoB;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,YAAY,CAAC,CAAC;QACtE,OAAO,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,OAAO;QACN,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,qBAAqB,CAAC;QAExD,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;YAClD,KAAK,CAAC,IAAI,CACT,gBAAgB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,aAAa,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,oBAAoB,OAAO,CAAC,UAAU,EAAE,QAAQ,IAAI,KAAK,EAAE,CAC5J,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAEf,SAAS;YACT,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;gBAC9B,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC1B,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE;gBAC1B,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC7B,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC7B,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC7B,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC7B,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC7B,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE;gBAC3B,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE;gBACzB,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE;aAC5B,CAAC,CAAC;YAEH,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAE7C,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1D,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC;oBAC3B,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;oBACtG,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;oBAC9C,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;oBAC9C,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;oBAC1C,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;oBAC1C,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;oBAC1C,EAAE,GAAG,EAAE,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE;oBAC5E,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE;oBACvE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;oBACpD,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE;iBACvD,CAAC,CAAC;gBACH,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;YACxB,CAAC;QACF,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,YAAY;QACX,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,qBAAqB,CAAC;QAExD,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,EAAE,CAAC;QAEvB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,eAAe,OAAO,CAAC,YAAY,WAAW,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAChG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAEf,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAElG,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC;gBACpF,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAClC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAChG,MAAM,MAAM,GAAG,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;gBAChE,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACrG,CAAC;QACF,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,MAAM;QACL,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,KAAK;QACJ,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,iBAAiB;IAET,UAAU,CAAC,MAAgB,EAAE,CAAS;QAC7C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC;IAEO,KAAK,CAAC,EAAU;QACvB,IAAI,EAAE,IAAI,IAAI;YAAE,OAAO,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;QACpD,IAAI,EAAE,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAClC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IAEO,UAAU,CAAC,IAA2C;QAC7D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1F,CAAC;CACD"}

package/dist/monitoring/PrometheusBootstrap.d.ts

@@ -0,0 +1,30 @@
+/**
+ * PrometheusBootstrap - Configures OpenTelemetry MeterProvider with PrometheusExporter
+ *
+ * Uses dynamic imports for @opentelemetry/sdk-metrics and @opentelemetry/exporter-prometheus.
+ * Returns null if the packages are not installed (they are optional peer dependencies).
+ * Call this once at trigger startup in listen().
+ */
+export interface PrometheusBootstrapConfig {
+    serviceName: string;
+    serviceVersion?: string;
+    port?: number;
+    endpoint?: string;
+}
+export interface PrometheusBootstrapResult {
+    metricsHandler: (req: unknown, res: unknown) => void;
+    shutdown: () => Promise<void>;
+}
+/**
+ * Bootstrap Prometheus metrics export using OpenTelemetry.
+ *
+ * Dynamically imports @opentelemetry/sdk-metrics and @opentelemetry/exporter-prometheus.
+ * If these packages are not installed, returns null silently.
+ *
+ * @returns Bootstrap result with metricsHandler and shutdown, or null if packages unavailable
+ */
+export declare function bootstrapPrometheus(config: PrometheusBootstrapConfig): Promise<PrometheusBootstrapResult | null>;
+/**
+ * Reset the initialization state. Useful for testing.
+ */
+export declare function resetPrometheusBootstrap(): void;

package/dist/monitoring/PrometheusBootstrap.js

@@ -0,0 +1,71 @@
+/**
+ * PrometheusBootstrap - Configures OpenTelemetry MeterProvider with PrometheusExporter
+ *
+ * Uses dynamic imports for @opentelemetry/sdk-metrics and @opentelemetry/exporter-prometheus.
+ * Returns null if the packages are not installed (they are optional peer dependencies).
+ * Call this once at trigger startup in listen().
+ */
+import { metrics } from "@opentelemetry/api";
+// Track whether we've already initialized to avoid double-init warnings
+let initialized = false;
+/**
+ * Bootstrap Prometheus metrics export using OpenTelemetry.
+ *
+ * Dynamically imports @opentelemetry/sdk-metrics and @opentelemetry/exporter-prometheus.
+ * If these packages are not installed, returns null silently.
+ *
+ * @returns Bootstrap result with metricsHandler and shutdown, or null if packages unavailable
+ */
+export async function bootstrapPrometheus(config) {
+    if (initialized) {
+        return null;
+    }
+    try {
+        // Use variable-based dynamic imports so TypeScript doesn't try to resolve
+        // type declarations at compile time — these are optional peer dependencies.
+        const exporterPkg = "@opentelemetry/exporter-prometheus";
+        const sdkMetricsPkg = "@opentelemetry/sdk-metrics";
+        const resourcesPkg = "@opentelemetry/resources";
+        const semconvPkg = "@opentelemetry/semantic-conventions";
+        const [exporterMod, sdkMod, resourceMod, semconvMod] = await Promise.all([
+            import(/* webpackIgnore: true */ exporterPkg),
+            import(/* webpackIgnore: true */ sdkMetricsPkg),
+            import(/* webpackIgnore: true */ resourcesPkg),
+            import(/* webpackIgnore: true */ semconvPkg),
+        ]);
+        const { PrometheusExporter } = exporterMod;
+        const { MeterProvider } = sdkMod;
+        const { Resource } = resourceMod;
+        const { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION } = semconvMod;
+        const port = config.port ?? Number.parseInt(process.env.BLOK_METRICS_PORT || "9464", 10);
+        const endpoint = config.endpoint ?? "/metrics";
+        const exporter = new PrometheusExporter({ port, endpoint });
+        const resource = Resource.default().merge(new Resource({
+            [ATTR_SERVICE_NAME]: config.serviceName,
+            [ATTR_SERVICE_VERSION]: config.serviceVersion ?? "0.0.1",
+        }));
+        const meterProvider = new MeterProvider({ resource });
+        meterProvider.addMetricReader(exporter);
+        metrics.setGlobalMeterProvider(meterProvider);
+        initialized = true;
+        const metricsHandler = exporter.getMetricsRequestHandler.bind(exporter);
+        return {
+            metricsHandler,
+            shutdown: async () => {
+                await meterProvider.shutdown();
+                initialized = false;
+            },
+        };
+    }
+    catch {
+        // OpenTelemetry SDK packages not installed - this is expected and fine
+        return null;
+    }
+}
+/**
+ * Reset the initialization state. Useful for testing.
+ */
+export function resetPrometheusBootstrap() {
+    initialized = false;
+}
+//# sourceMappingURL=PrometheusBootstrap.js.map

package/dist/monitoring/PrometheusBootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrometheusBootstrap.js","sourceRoot":"","sources":["../../src/monitoring/PrometheusBootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAc7C,wEAAwE;AACxE,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,MAAiC;IAEjC,IAAI,WAAW,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,IAAI,CAAC;QACJ,0EAA0E;QAC1E,4EAA4E;QAC5E,MAAM,WAAW,GAAG,oCAAoC,CAAC;QACzD,MAAM,aAAa,GAAG,4BAA4B,CAAC;QACnD,MAAM,YAAY,GAAG,0BAA0B,CAAC;QAChD,MAAM,UAAU,GAAG,qCAAqC,CAAC;QAEzD,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACxE,MAAM,CAAC,yBAAyB,CAAC,WAAW,CAAC;YAC7C,MAAM,CAAC,yBAAyB,CAAC,aAAa,CAAC;YAC/C,MAAM,CAAC,yBAAyB,CAAC,YAAY,CAAC;YAC9C,MAAM,CAAC,yBAAyB,CAAC,UAAU,CAAC;SAC5C,CAAC,CAAC;QAEH,MAAM,EAAE,kBAAkB,EAAE,GAAG,WAAW,CAAC;QAC3C,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC;QACjC,MAAM,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC;QACjC,MAAM,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,GAAG,UAAU,CAAC;QAE/D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;QACzF,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,UAAU,CAAC;QAE/C,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE5D,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,CACxC,IAAI,QAAQ,CAAC;YACZ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,WAAW;YACvC,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC,cAAc,IAAI,OAAO;SACxD,CAAC,CACF,CAAC;QAEF,MAAM,aAAa,GAAG,IAAI,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QACtD,aAAa,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QACxC,OAAO,CAAC,sBAAsB,CAAC,aAAa,CAAC,CAAC;QAE9C,WAAW,GAAG,IAAI,CAAC;QAEnB,MAAM,cAAc,GAAG,QAAQ,CAAC,wBAAwB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAExE,OAAO;YACN,cAAc;YACd,QAAQ,EAAE,KAAK,IAAI,EAAE;gBACpB,MAAM,aAAa,CAAC,QAAQ,EAAE,CAAC;gBAC/B,WAAW,GAAG,KAAK,CAAC;YACrB,CAAC;SACD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACR,uEAAuE;QACvE,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACvC,WAAW,GAAG,KAAK,CAAC;AACrB,CAAC"}

package/dist/monitoring/PrometheusMetricsBridge.d.ts

@@ -0,0 +1,60 @@
+/**
+ * PrometheusMetricsBridge - Bridges internal metrics to OpenTelemetry/Prometheus
+ *
+ * Exposes TriggerMetricsCollector data as properly-named Prometheus metrics
+ * using the OpenTelemetry API. Works as no-op if no MeterProvider is configured.
+ */
+import type { CircuitBreaker } from "./CircuitBreaker";
+import type { RateLimiter } from "./RateLimiter";
+import type { TriggerMetricsCollector } from "./TriggerMetricsCollector";
+export interface PrometheusMetricsBridgeConfig {
+    triggerType: string;
+    triggerName: string;
+}
+export interface ExecutionLabels {
+    workflow_name: string;
+    workflow_version: string;
+    env: string;
+}
+export declare class PrometheusMetricsBridge {
+    private meter;
+    private config;
+    private collector;
+    private circuitBreaker;
+    private rateLimiter;
+    private executionsCounter;
+    private durationHistogram;
+    private errorsCounter;
+    private observableGauges;
+    private initialized;
+    constructor(config: PrometheusMetricsBridgeConfig, collector: TriggerMetricsCollector);
+    /**
+     * Register observable callbacks that pull from the TriggerMetricsCollector
+     * at scrape time. Call this once after construction.
+     */
+    initialize(): void;
+    /**
+     * Record a workflow execution. Called from TriggerBase.run() after each request.
+     *
+     * @param durationMs - Execution duration in milliseconds
+     * @param success - Whether the execution succeeded
+     * @param labels - Workflow-specific labels
+     */
+    recordExecution(durationMs: number, success: boolean, labels: ExecutionLabels): void;
+    /**
+     * Record an error with a specific category.
+     */
+    recordError(category: string, labels?: Partial<ExecutionLabels>): void;
+    /**
+     * Attach a CircuitBreaker for state monitoring.
+     */
+    attachCircuitBreaker(cb: CircuitBreaker): void;
+    /**
+     * Attach a RateLimiter for remaining token monitoring.
+     */
+    attachRateLimiter(rl: RateLimiter): void;
+    /**
+     * Clean up resources.
+     */
+    destroy(): void;
+}