flow-debugger 1.0.0

package/dist/cjs/core/Analytics.js

@@ -0,0 +1,174 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────
+// flow-debugger — Analytics Engine
+// Per-endpoint aggregation + service failure grouping
+// ─────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Analytics = void 0;
+const HealthMonitor_1 = require("./HealthMonitor");
+class Analytics {
+    constructor(maxTraces = 1000) {
+        this.traces = [];
+        this.maxTraces = maxTraces;
+        this.startTime = new Date();
+        this.healthMonitor = new HealthMonitor_1.HealthMonitor();
+    }
+    /** Record a completed trace */
+    record(trace) {
+        try {
+            this.traces.push(trace);
+            // Trim if over limit (keep most recent)
+            if (this.traces.length > this.maxTraces) {
+                this.traces = this.traces.slice(-this.maxTraces);
+            }
+            // Update health monitor with step results
+            for (const step of trace.steps) {
+                this.healthMonitor.recordStep(step);
+            }
+        }
+        catch (_) {
+            // never crash
+        }
+    }
+    /** Get full analytics report */
+    getReport() {
+        const endpoints = this.getEndpointStats();
+        const totalRequests = this.traces.length;
+        const totalErrors = this.traces.filter(t => t.classification === 'ERROR' || t.classification === 'CRITICAL').length;
+        const totalSlow = this.traces.filter(t => t.classification === 'WARN').length;
+        const uptime = Date.now() - this.startTime.getTime();
+        return {
+            totalRequests,
+            totalErrors,
+            totalSlow,
+            uptime,
+            endpoints,
+            serviceHealth: this.healthMonitor.getAllHealth(),
+            topFailures: this.getTopFailures(),
+            recentTraces: this.traces.slice(-20).reverse(),
+        };
+    }
+    /** Get stats for a specific endpoint */
+    getEndpointReport(path) {
+        const stats = this.getEndpointStats();
+        return stats.find(s => s.path === path) || null;
+    }
+    /** Get aggregated stats per endpoint */
+    getEndpointStats() {
+        const grouped = new Map();
+        for (const trace of this.traces) {
+            const key = `${trace.method}:${trace.endpoint}`;
+            if (!grouped.has(key))
+                grouped.set(key, []);
+            grouped.get(key).push(trace);
+        }
+        const stats = [];
+        for (const [key, traces] of grouped) {
+            const [method, path] = key.split(':');
+            const durations = traces.map(t => t.totalDuration).sort((a, b) => a - b);
+            const errorCount = traces.filter(t => t.classification === 'ERROR' || t.classification === 'CRITICAL').length;
+            const slowCount = traces.filter(t => t.classification === 'WARN').length;
+            // Common issues
+            const issues = new Map();
+            for (const t of traces) {
+                if (t.rootCause) {
+                    const key = t.rootCause.cause;
+                    issues.set(key, (issues.get(key) || 0) + 1);
+                }
+            }
+            const commonIssues = [...issues.entries()]
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, 5)
+                .map(([issue, count]) => `${issue} (${count}x)`);
+            // Service failure breakdown
+            const serviceFailures = this.getServiceFailures(traces);
+            stats.push({
+                path,
+                method,
+                totalRequests: traces.length,
+                errorCount,
+                slowCount,
+                avgDuration: durations.reduce((a, b) => a + b, 0) / durations.length,
+                p95Duration: durations[Math.floor(durations.length * 0.95)] || 0,
+                maxDuration: durations[durations.length - 1] || 0,
+                commonIssues,
+                serviceFailures,
+                recentTraces: traces.slice(-5).reverse(),
+            });
+        }
+        return stats.sort((a, b) => b.totalRequests - a.totalRequests);
+    }
+    /** Get service failure breakdown across all traces */
+    getTopFailures() {
+        return this.getServiceFailures(this.traces);
+    }
+    /** Calculate service failure stats from a set of traces */
+    getServiceFailures(traces) {
+        const failures = new Map();
+        let totalFailures = 0;
+        for (const trace of traces) {
+            for (const step of trace.steps) {
+                if (step.status === 'error' || step.status === 'timeout') {
+                    failures.set(step.service, (failures.get(step.service) || 0) + 1);
+                    totalFailures++;
+                }
+            }
+        }
+        return [...failures.entries()]
+            .map(([service, count]) => ({
+            service,
+            count,
+            percentage: totalFailures > 0 ? Math.round((count / totalFailures) * 100) : 0,
+        }))
+            .sort((a, b) => b.count - a.count);
+    }
+    /** Clear all stored traces */
+    clear() {
+        this.traces = [];
+    }
+    /** Get raw trace count */
+    getTraceCount() {
+        return this.traces.length;
+    }
+    /**
+     * Search traces by traceId, endpoint, or error message.
+     * Returns matching traces sorted by most recent first.
+     */
+    searchTraces(query, options) {
+        if (!query)
+            return [];
+        const lowerQuery = query.toLowerCase();
+        const limit = options?.limit || 50;
+        const matches = this.traces.filter(trace => {
+            // Filter by environment if specified
+            if (options?.env && trace.environment !== options.env) {
+                return false;
+            }
+            // Match traceId
+            if (trace.traceId.toLowerCase().includes(lowerQuery)) {
+                return true;
+            }
+            // Match endpoint
+            if (trace.endpoint.toLowerCase().includes(lowerQuery)) {
+                return true;
+            }
+            // Match error message in steps
+            for (const step of trace.steps) {
+                if (step.error && step.error.toLowerCase().includes(lowerQuery)) {
+                    return true;
+                }
+            }
+            // Match root cause
+            if (trace.rootCause && trace.rootCause.cause.toLowerCase().includes(lowerQuery)) {
+                return true;
+            }
+            return false;
+        });
+        return matches.slice(-limit).reverse();
+    }
+    getHealthMonitor() {
+        return this.healthMonitor;
+    }
+}
+exports.Analytics = Analytics;
+//# sourceMappingURL=Analytics.js.map

package/dist/cjs/core/Analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Analytics.js","sourceRoot":"","sources":["../../../src/core/Analytics.ts"],"names":[],"mappings":";AAAA,gEAAgE;AAChE,mCAAmC;AACnC,sDAAsD;AACtD,gEAAgE;;;AAUhE,mDAAgD;AAEhD,MAAa,SAAS;IAMlB,YAAY,SAAS,GAAG,IAAI;QALpB,WAAM,GAAY,EAAE,CAAC;QAMzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,aAAa,GAAG,IAAI,6BAAa,EAAE,CAAC;IAC7C,CAAC;IAED,+BAA+B;IAC/B,MAAM,CAAC,KAAY;QACf,IAAI,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAExB,wCAAwC;YACxC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;gBACtC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACrD,CAAC;YAED,0CAA0C;YAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC7B,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACxC,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,cAAc;QAClB,CAAC;IACL,CAAC;IAED,gCAAgC;IAChC,SAAS;QACL,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1C,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QACzC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,OAAO,IAAI,CAAC,CAAC,cAAc,KAAK,UAAU,CAAC,CAAC,MAAM,CAAC;QACpH,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;QAC9E,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QAErD,OAAO;YACH,aAAa;YACb,WAAW;YACX,SAAS;YACT,MAAM;YACN,SAAS;YACT,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE;YAChD,WAAW,EAAE,IAAI,CAAC,cAAc,EAAE;YAClC,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE;SACjD,CAAC;IACN,CAAC;IAED,wCAAwC;IACxC,iBAAiB,CAAC,IAAY;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC;IACpD,CAAC;IAED,wCAAwC;IAChC,gBAAgB;QACpB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;QAE3C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAChD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,KAAK,GAAoB,EAAE,CAAC;QAClC,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YAClC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACzE,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,OAAO,IAAI,CAAC,CAAC,cAAc,KAAK,UAAU,CAAC,CAAC,MAAM,CAAC;YAC9G,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;YAEzE,gBAAgB;YAChB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;YACzC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACrB,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;oBACd,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC;oBAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAChD,CAAC;YACL,CAAC;YACD,MAAM,YAAY,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;iBACrC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;iBAC3B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;iBACX,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,KAAK,KAAK,IAAI,CAAC,CAAC;YAErD,4BAA4B;YAC5B,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;YAExD,KAAK,CAAC,IAAI,CAAC;gBACP,IAAI;gBACJ,MAAM;gBACN,aAAa,EAAE,MAAM,CAAC,MAAM;gBAC5B,UAAU;gBACV,SAAS;gBACT,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,MAAM;gBACpE,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC;gBAChE,WAAW,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC;gBACjD,YAAY;gBACZ,eAAe;gBACf,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE;aAC3C,CAAC,CAAC;QACP,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;IACnE,CAAC;IAED,sDAAsD;IAC9C,cAAc;QAClB,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,2DAA2D;IACnD,kBAAkB,CAAC,MAAe;QACtC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAsB,CAAC;QAC/C,IAAI,aAAa,GAAG,CAAC,CAAC;QAEtB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACzB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC7B,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBACvD,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;oBAClE,aAAa,EAAE,CAAC;gBACpB,CAAC;YACL,CAAC;QACL,CAAC;QAED,OAAO,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;aACzB,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACxB,OAAO;YACP,KAAK;YACL,UAAU,EAAE,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,aAAa,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;SAChF,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,8BAA8B;IAC9B,KAAK;QACD,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACrB,CAAC;IAED,0BAA0B;IAC1B,aAAa;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,KAAa,EAAE,OAA0C;QAClE,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,CAAC;QAEtB,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;QAEnC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;YACvC,qCAAqC;YACrC,IAAI,OAAO,EAAE,GAAG,IAAI,KAAK,CAAC,WAAW,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC;gBACpD,OAAO,KAAK,CAAC;YACjB,CAAC;YAED,gBAAgB;YAChB,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBACnD,OAAO,IAAI,CAAC;YAChB,CAAC;YAED,iBAAiB;YACjB,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBACpD,OAAO,IAAI,CAAC;YAChB,CAAC;YAED,+BAA+B;YAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC7B,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC9D,OAAO,IAAI,CAAC;gBAChB,CAAC;YACL,CAAC;YAED,mBAAmB;YACnB,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9E,OAAO,IAAI,CAAC;YAChB,CAAC;YAED,OAAO,KAAK,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3C,CAAC;IAED,gBAAgB;QACZ,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;CACJ;AAjMD,8BAiMC"}

package/dist/cjs/core/Classifier.js

@@ -0,0 +1,66 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────
+// flow-debugger — Classifier
+// Classifies steps and traces into severity levels
+// ─────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classify = classify;
+exports.classifyTrace = classifyTrace;
+exports.classifyQuery = classifyQuery;
+/**
+ * Classify a single step based on its duration and status.
+ *
+ *  INFO     → normal, <slowThreshold ms
+ *  WARN     → slow (>slowThreshold ms)
+ *  ERROR    → step failed
+ *  CRITICAL → dependency down / timeout
+ */
+function classify(duration, status, config) {
+    const threshold = config.slowThreshold ?? 300;
+    if (status === 'timeout')
+        return 'CRITICAL';
+    if (status === 'error')
+        return 'ERROR';
+    if (duration > threshold)
+        return 'WARN';
+    return 'INFO';
+}
+/**
+ * Classify an entire trace based on its steps.
+ * The trace gets the highest severity from any of its steps.
+ */
+function classifyTrace(steps, _totalDuration, config) {
+    const threshold = config.slowThreshold ?? 300;
+    let maxLevel = 'INFO';
+    const priority = {
+        INFO: 0,
+        WARN: 1,
+        ERROR: 2,
+        CRITICAL: 3,
+    };
+    for (const step of steps) {
+        if (priority[step.classification] > priority[maxLevel]) {
+            maxLevel = step.classification;
+        }
+    }
+    // Also check total duration
+    if (maxLevel === 'INFO' && _totalDuration > threshold) {
+        maxLevel = 'WARN';
+    }
+    return maxLevel;
+}
+/**
+ * Classify a database query specifically — used by integrations
+ * to detect slow queries with a dedicated threshold.
+ */
+function classifyQuery(duration, status, config) {
+    const threshold = config.slowQueryThreshold ?? 300;
+    if (status === 'timeout')
+        return 'CRITICAL';
+    if (status === 'error')
+        return 'ERROR';
+    if (duration > threshold)
+        return 'WARN';
+    return 'INFO';
+}
+//# sourceMappingURL=Classifier.js.map

package/dist/cjs/core/Classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Classifier.js","sourceRoot":"","sources":["../../../src/core/Classifier.ts"],"names":[],"mappings":";AAAA,gEAAgE;AAChE,6BAA6B;AAC7B,mDAAmD;AACnD,gEAAgE;;AAiBhE,4BAWC;AAMD,sCA2BC;AAMD,sCAWC;AArED;;;;;;;GAOG;AACH,SAAgB,QAAQ,CACpB,QAAgB,EAChB,MAAkB,EAClB,MAA6C;IAE7C,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,IAAI,GAAG,CAAC;IAE9C,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IAC5C,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IACvC,IAAI,QAAQ,GAAG,SAAS;QAAE,OAAO,MAAM,CAAC;IACxC,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CACzB,KAAkB,EAClB,cAAsB,EACtB,MAA6C;IAE7C,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,IAAI,GAAG,CAAC;IAC9C,IAAI,QAAQ,GAAwB,MAAM,CAAC;IAE3C,MAAM,QAAQ,GAAwC;QAClD,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,CAAC;KACd,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrD,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC;QACnC,CAAC;IACL,CAAC;IAED,4BAA4B;IAC5B,IAAI,QAAQ,KAAK,MAAM,IAAI,cAAc,GAAG,SAAS,EAAE,CAAC;QACpD,QAAQ,GAAG,MAAM,CAAC;IACtB,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CACzB,QAAgB,EAChB,MAAkB,EAClB,MAAkD;IAElD,MAAM,SAAS,GAAG,MAAM,CAAC,kBAAkB,IAAI,GAAG,CAAC;IAEnD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IAC5C,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IACvC,IAAI,QAAQ,GAAG,SAAS;QAAE,OAAO,MAAM,CAAC;IACxC,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/cjs/core/HealthMonitor.js

@@ -0,0 +1,79 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────
+// flow-debugger — Health Monitor
+// Tracks dependency health from step results
+// ─────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HealthMonitor = void 0;
+class HealthMonitor {
+    constructor() {
+        this.records = new Map();
+    }
+    /** Record a step result to update health tracking */
+    recordStep(step) {
+        try {
+            const key = step.service;
+            if (key === 'internal' || key === 'unknown')
+                return;
+            if (!this.records.has(key)) {
+                this.records.set(key, {
+                    service: step.service,
+                    name: key,
+                    successes: 0,
+                    failures: 0,
+                    lastCheck: new Date(),
+                });
+            }
+            const record = this.records.get(key);
+            record.lastCheck = new Date();
+            if (step.status === 'success') {
+                record.successes++;
+            }
+            else {
+                record.failures++;
+            }
+        }
+        catch (_) {
+            // never crash
+        }
+    }
+    /** Get health status for a specific service */
+    getHealth(service) {
+        const record = this.records.get(service);
+        if (!record)
+            return null;
+        return this.toHealthStatus(record);
+    }
+    /** Get health status for all tracked services */
+    getAllHealth() {
+        return [...this.records.values()].map(r => this.toHealthStatus(r));
+    }
+    toHealthStatus(record) {
+        const total = record.successes + record.failures;
+        const successRate = total > 0 ? record.successes / total : 1;
+        let status;
+        if (successRate >= 0.95) {
+            status = 'healthy';
+        }
+        else if (successRate >= 0.7) {
+            status = 'degraded';
+        }
+        else {
+            status = 'down';
+        }
+        return {
+            service: record.service,
+            name: record.name,
+            status,
+            lastCheck: record.lastCheck,
+            successRate: Math.round(successRate * 100),
+            totalChecks: total,
+        };
+    }
+    /** Reset all health records */
+    reset() {
+        this.records.clear();
+    }
+}
+exports.HealthMonitor = HealthMonitor;
+//# sourceMappingURL=HealthMonitor.js.map

package/dist/cjs/core/HealthMonitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthMonitor.js","sourceRoot":"","sources":["../../../src/core/HealthMonitor.ts"],"names":[],"mappings":";AAAA,gEAAgE;AAChE,iCAAiC;AACjC,6CAA6C;AAC7C,gEAAgE;;;AAiBhE,MAAa,aAAa;IAA1B;QACY,YAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAsEtD,CAAC;IApEG,qDAAqD;IACrD,UAAU,CAAC,IAAe;QACtB,IAAI,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;YACzB,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO;YAEpD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE;oBAClB,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,IAAI,EAAE,GAAG;oBACT,SAAS,EAAE,CAAC;oBACZ,QAAQ,EAAE,CAAC;oBACX,SAAS,EAAE,IAAI,IAAI,EAAE;iBACxB,CAAC,CAAC;YACP,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;YACtC,MAAM,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;YAE9B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC5B,MAAM,CAAC,SAAS,EAAE,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACJ,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtB,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,cAAc;QAClB,CAAC;IACL,CAAC;IAED,+CAA+C;IAC/C,SAAS,CAAC,OAAmB;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,iDAAiD;IACjD,YAAY;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;IAEO,cAAc,CAAC,MAAoB;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC;QACjD,MAAM,WAAW,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAE7D,IAAI,MAAmB,CAAC;QACxB,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;YACtB,MAAM,GAAG,SAAS,CAAC;QACvB,CAAC;aAAM,IAAI,WAAW,IAAI,GAAG,EAAE,CAAC;YAC5B,MAAM,GAAG,UAAU,CAAC;QACxB,CAAC;aAAM,CAAC;YACJ,MAAM,GAAG,MAAM,CAAC;QACpB,CAAC;QAED,OAAO;YACH,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM;YACN,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC;YAC1C,WAAW,EAAE,KAAK;SACrB,CAAC;IACN,CAAC;IAED,+BAA+B;IAC/B,KAAK;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACJ;AAvED,sCAuEC"}

package/dist/cjs/core/RootCause.js

@@ -0,0 +1,89 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────
+// flow-debugger — Root Cause Detection
+// Analyzes trace steps to identify the most likely failure origin
+// ─────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectRootCause = detectRootCause;
+/**
+ * Detect the root cause of a trace failure or slowness.
+ *
+ * Algorithm:
+ *  1. If response is 500 and a step failed → root cause = first failed step
+ *  2. If a step timed out → root cause = timeout step (CRITICAL)
+ *  3. If DB/Redis slow and total latency high → root cause = slow dependency
+ *  4. If no failures but overall slow → root cause = slowest step
+ */
+function detectRootCause(steps, statusCode, config) {
+    if (steps.length === 0)
+        return null;
+    const slowThreshold = config.slowThreshold ?? 300;
+    // 1. Look for timed-out steps (highest priority)
+    const timedOut = steps.find(s => s.status === 'timeout');
+    if (timedOut) {
+        return {
+            cause: `${timedOut.name} timed out`,
+            step: timedOut.name,
+            service: timedOut.service,
+            confidence: 'high',
+        };
+    }
+    // 2. Look for failed steps when response is 5xx
+    if (statusCode && statusCode >= 500) {
+        const failedSteps = steps.filter(s => s.status === 'error');
+        if (failedSteps.length > 0) {
+            // First failure is most likely root cause
+            const first = failedSteps[0];
+            return {
+                cause: `${first.name} failed: ${first.error || 'unknown error'}`,
+                step: first.name,
+                service: first.service,
+                confidence: 'high',
+            };
+        }
+    }
+    // 3. Look for any failed step (even if response isn't 500)
+    const failedStep = steps.find(s => s.status === 'error');
+    if (failedStep) {
+        return {
+            cause: `${failedStep.name} failed: ${failedStep.error || 'unknown error'}`,
+            step: failedStep.name,
+            service: failedStep.service,
+            confidence: statusCode && statusCode >= 400 ? 'high' : 'medium',
+        };
+    }
+    // 4. Look for slow steps
+    const slowSteps = steps.filter(s => s.duration > slowThreshold);
+    if (slowSteps.length > 0) {
+        // Slowest step is the most likely bottleneck
+        const slowest = slowSteps.reduce((a, b) => (a.duration > b.duration ? a : b));
+        const totalDuration = steps.reduce((sum, s) => sum + s.duration, 0);
+        const ratio = slowest.duration / totalDuration;
+        return {
+            cause: `Slow ${getServiceLabel(slowest.service)} query: ${slowest.name} (${Math.round(slowest.duration)}ms)`,
+            step: slowest.name,
+            service: slowest.service,
+            confidence: ratio > 0.5 ? 'high' : 'medium',
+        };
+    }
+    return null;
+}
+function getServiceLabel(service) {
+    const labels = {
+        mongo: 'MongoDB',
+        mysql: 'MySQL',
+        postgres: 'PostgreSQL',
+        redis: 'Redis',
+        axios: 'HTTP',
+        fetch: 'HTTP',
+        stripe: 'Stripe',
+        razorpay: 'Razorpay',
+        sendgrid: 'SendGrid',
+        twilio: 'Twilio',
+        external: 'External',
+        internal: 'Internal',
+        unknown: 'Unknown',
+    };
+    return labels[service] || service;
+}
+//# sourceMappingURL=RootCause.js.map

package/dist/cjs/core/RootCause.js.map

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

package/dist/cjs/core/Sampler.js

@@ -0,0 +1,34 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────
+// flow-debugger — Sampler
+// Probabilistic sampling for high-traffic environments
+// ─────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Sampler = void 0;
+class Sampler {
+    constructor(rate = 1, alwaysSampleErrors = true) {
+        this.rate = Math.max(0, Math.min(1, rate));
+        this.alwaysSampleErrors = alwaysSampleErrors;
+    }
+    /** Should this request be sampled? */
+    shouldSample() {
+        if (this.rate >= 1)
+            return true;
+        if (this.rate <= 0)
+            return false;
+        return Math.random() < this.rate;
+    }
+    /** Force sample if it's an error (if alwaysSampleErrors is true) */
+    shouldSampleError() {
+        return this.alwaysSampleErrors;
+    }
+    /** Update sampling rate at runtime */
+    setRate(rate) {
+        this.rate = Math.max(0, Math.min(1, rate));
+    }
+    getRate() {
+        return this.rate;
+    }
+}
+exports.Sampler = Sampler;
+//# sourceMappingURL=Sampler.js.map

package/dist/cjs/core/Sampler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sampler.js","sourceRoot":"","sources":["../../../src/core/Sampler.ts"],"names":[],"mappings":";AAAA,gEAAgE;AAChE,0BAA0B;AAC1B,uDAAuD;AACvD,gEAAgE;;;AAEhE,MAAa,OAAO;IAIhB,YAAY,IAAI,GAAG,CAAC,EAAE,kBAAkB,GAAG,IAAI;QAC3C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QAC3C,IAAI,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;IACjD,CAAC;IAED,sCAAsC;IACtC,YAAY;QACR,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAChC,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QACjC,OAAO,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;IACrC,CAAC;IAED,oEAAoE;IACpE,iBAAiB;QACb,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACnC,CAAC;IAED,sCAAsC;IACtC,OAAO,CAAC,IAAY;QAChB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO;QACH,OAAO,IAAI,CAAC,IAAI,CAAC;IACrB,CAAC;CACJ;AA7BD,0BA6BC"}

package/dist/cjs/core/Timeline.js

@@ -0,0 +1,90 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────
+// flow-debugger — Timeline Renderer
+// Prints a visual timeline of a trace to the console
+// ─────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderTimeline = renderTimeline;
+exports.renderCompact = renderCompact;
+const ICONS = {
+    success: '✔',
+    error: '❌',
+    timeout: '⏱ TIMEOUT',
+};
+const LEVEL_COLORS = {
+    INFO: '\x1b[32m', // green
+    WARN: '\x1b[33m', // yellow
+    ERROR: '\x1b[31m', // red
+    CRITICAL: '\x1b[35m', // magenta
+};
+const RESET = '\x1b[0m';
+const DIM = '\x1b[2m';
+const BOLD = '\x1b[1m';
+const CYAN = '\x1b[36m';
+/**
+ * Render a trace timeline to the console.
+ *
+ * Output example:
+ * ┌─── flow-debugger ── req_abc123 ── POST /login ───
+ * │ [0ms]   Request start
+ * │ [2ms]   DB find user ✔ (14ms) [mongo]
+ * │ [16ms]  Redis cache ❌ (3ms) [redis]
+ * │ [20ms]  Response 200
+ * │
+ * │ ⚠ Root cause: Redis cache failed: connection refused
+ * │ Classification: ERROR
+ * │ Total: 20ms
+ * └────────────────────────────────────────────────────
+ */
+function renderTimeline(trace, logger = console.log) {
+    const lines = [];
+    const divider = '─'.repeat(50);
+    lines.push('');
+    lines.push(`${CYAN}┌─── flow-debugger ── ${trace.traceId} ── ${trace.method} ${trace.endpoint} ───${RESET}`);
+    lines.push(`${DIM}│ [0ms]    Request start${RESET}`);
+    for (const step of trace.steps) {
+        const offset = Math.round(step.startTime);
+        const dur = Math.round(step.duration);
+        const icon = ICONS[step.status] || '?';
+        const levelColor = LEVEL_COLORS[step.classification] || '';
+        const serviceTag = step.service !== 'internal' ? ` ${DIM}[${step.service}]${RESET}` : '';
+        const line = `│ [${offset}ms]${' '.repeat(Math.max(1, 5 - String(offset).length))}` +
+            `${levelColor}${step.name} ${icon} (${dur}ms)${RESET}${serviceTag}`;
+        lines.push(line);
+        if (step.error) {
+            lines.push(`│         ${DIM}└─ ${step.error}${RESET}`);
+        }
+        // Slow query warning
+        if (step.classification === 'WARN' && step.duration > 300) {
+            lines.push(`│         ${LEVEL_COLORS.WARN}⚠ Slow ${step.service} query detected (${dur}ms)${RESET}`);
+        }
+    }
+    // Response line
+    lines.push(`${DIM}│ [${Math.round(trace.totalDuration)}ms]${' '.repeat(Math.max(1, 5 - String(Math.round(trace.totalDuration)).length))}Response ${trace.statusCode || '—'}${RESET}`);
+    lines.push('│');
+    // Root cause
+    if (trace.rootCause) {
+        const rcColor = LEVEL_COLORS.ERROR;
+        lines.push(`${rcColor}│ 🔍 Root cause: ${trace.rootCause.cause}${RESET}`);
+        lines.push(`${DIM}│    Service: ${trace.rootCause.service} | Confidence: ${trace.rootCause.confidence}${RESET}`);
+    }
+    // Classification
+    const clsColor = LEVEL_COLORS[trace.classification];
+    lines.push(`${clsColor}│ Classification: ${trace.classification}${RESET}`);
+    lines.push(`${DIM}│ Total: ${Math.round(trace.totalDuration)}ms${RESET}`);
+    lines.push(`${CYAN}└${divider}${RESET}`);
+    lines.push('');
+    logger(lines.join('\n'));
+}
+/**
+ * Render a compact one-line summary for high-traffic mode.
+ */
+function renderCompact(trace, logger = console.log) {
+    const icon = trace.classification === 'INFO' ? '✔' :
+        trace.classification === 'WARN' ? '⚠' :
+            trace.classification === 'ERROR' ? '❌' :
+                '🔴';
+    const rc = trace.rootCause ? ` → ${trace.rootCause.cause}` : '';
+    logger(`${icon} ${trace.method} ${trace.endpoint} ${Math.round(trace.totalDuration)}ms [${trace.classification}]${rc}`);
+}
+//# sourceMappingURL=Timeline.js.map

package/dist/cjs/core/Timeline.js.map

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