flow-debugger 1.0.0

package/dist/esm/integrations/postgres.js

@@ -0,0 +1,179 @@
+// ─────────────────────────────────────────────────────────────
+// flow-debugger — PostgreSQL Auto-Instrument (pg)
+// Patches pg Pool/Client to trace all queries
+// ─────────────────────────────────────────────────────────────
+import { DEFAULT_CONFIG } from '../core/types';
+import { classifyQuery } from '../core/Classifier';
+/**
+ * Auto-instrument pg Pool/Client to trace all queries.
+ *
+ * Usage:
+ *   pgTracer(pool, { getTracer: () => currentTracer })
+ *
+ * Output:
+ *   Postgres SELECT orders → 18ms ✔
+ *   Postgres UPDATE invoice → timeout ❌
+ */
+export function pgTracer(pool, options) {
+    try {
+        if (pool.__flowDebuggerPatched)
+            return;
+        pool.__flowDebuggerPatched = true;
+        const config = { ...DEFAULT_CONFIG, ...options?.config };
+        const originalQuery = pool.query.bind(pool);
+        pool.query = function tracedQuery(...args) {
+            const tracer = options?.getTracer?.();
+            if (!tracer) {
+                return originalQuery(...args);
+            }
+            const sql = extractSql(args);
+            const operation = extractPgOperation(sql);
+            const stepName = `Postgres ${operation}`;
+            const startTime = performance.now();
+            // Detect if callback is provided
+            const lastArg = args[args.length - 1];
+            if (typeof lastArg === 'function') {
+                // Callback style
+                const callback = lastArg;
+                args[args.length - 1] = function (err, result) {
+                    recordStep(tracer, stepName, startTime, err, sql, operation, config);
+                    callback(err, result);
+                };
+                return originalQuery(...args);
+            }
+            // Promise style
+            const promise = originalQuery(...args);
+            if (promise && typeof promise.then === 'function') {
+                return promise.then((result) => {
+                    recordStep(tracer, stepName, startTime, null, sql, operation, config);
+                    return result;
+                }, (err) => {
+                    recordStep(tracer, stepName, startTime, err, sql, operation, config);
+                    throw err;
+                });
+            }
+            return promise;
+        };
+        // Also patch connect() to instrument clients from the pool
+        if (pool.connect && !pool.__connectPatched) {
+            pool.__connectPatched = true;
+            const originalConnect = pool.connect.bind(pool);
+            pool.connect = function tracedConnect(...connectArgs) {
+                const lastArg = connectArgs[connectArgs.length - 1];
+                if (typeof lastArg === 'function') {
+                    // Callback style: connect((err, client, done) => { ... })
+                    const callback = lastArg;
+                    connectArgs[connectArgs.length - 1] = function (err, client, done) {
+                        if (client && !client.__flowDebuggerPatched) {
+                            patchClient(client, options, config);
+                        }
+                        callback(err, client, done);
+                    };
+                    return originalConnect(...connectArgs);
+                }
+                // Promise style
+                const promise = originalConnect(...connectArgs);
+                if (promise && typeof promise.then === 'function') {
+                    return promise.then((client) => {
+                        if (client && !client.__flowDebuggerPatched) {
+                            patchClient(client, options, config);
+                        }
+                        return client;
+                    });
+                }
+                return promise;
+            };
+        }
+    }
+    catch (_) {
+        // Production-safe: never crash
+    }
+}
+/** Patch an individual pg Client's query method */
+function patchClient(client, options, config) {
+    try {
+        client.__flowDebuggerPatched = true;
+        const originalClientQuery = client.query.bind(client);
+        client.query = function tracedClientQuery(...args) {
+            const tracer = options?.getTracer?.();
+            if (!tracer) {
+                return originalClientQuery(...args);
+            }
+            const sql = extractSql(args);
+            const operation = extractPgOperation(sql);
+            const stepName = `Postgres ${operation}`;
+            const startTime = performance.now();
+            const lastArg = args[args.length - 1];
+            if (typeof lastArg === 'function') {
+                const callback = lastArg;
+                args[args.length - 1] = function (err, result) {
+                    recordStep(tracer, stepName, startTime, err, sql, operation, config);
+                    callback(err, result);
+                };
+                return originalClientQuery(...args);
+            }
+            const promise = originalClientQuery(...args);
+            if (promise && typeof promise.then === 'function') {
+                return promise.then((result) => {
+                    recordStep(tracer, stepName, startTime, null, sql, operation, config);
+                    return result;
+                }, (err) => {
+                    recordStep(tracer, stepName, startTime, err, sql, operation, config);
+                    throw err;
+                });
+            }
+            return promise;
+        };
+    }
+    catch (_) { }
+}
+/** Record a step from query execution */
+function recordStep(tracer, stepName, startTime, err, sql, operation, config) {
+    try {
+        const endTime = performance.now();
+        const duration = endTime - startTime;
+        const status = err ? 'error' : 'success';
+        const classification = classifyQuery(duration, status, config);
+        const step = {
+            name: stepName,
+            service: 'postgres',
+            status,
+            classification,
+            startTime,
+            endTime,
+            duration,
+            error: err?.message,
+            stackTrace: err?.stack,
+            metadata: { sql: sql.substring(0, 200), operation },
+        };
+        tracer.addStep(step);
+        if (duration > (config.slowQueryThreshold ?? 300)) {
+            try {
+                (config.logger || console.log)(`\x1b[33m⚠ Slow PostgreSQL query: ${stepName} (${Math.round(duration)}ms)\n  ${sql.substring(0, 100)}\x1b[0m`);
+            }
+            catch (_) { }
+        }
+    }
+    catch (_) { }
+}
+/** Extract SQL string from query arguments */
+function extractSql(args) {
+    if (typeof args[0] === 'string')
+        return args[0];
+    if (args[0] && typeof args[0] === 'object' && args[0].text)
+        return args[0].text;
+    return 'unknown';
+}
+/** Extract the SQL operation type from a query string */
+function extractPgOperation(sql) {
+    const trimmed = sql.trim().toUpperCase();
+    const match = trimmed.match(/^(SELECT|INSERT|UPDATE|DELETE|CREATE|ALTER|DROP|TRUNCATE|WITH)\b/);
+    if (match) {
+        const op = match[1];
+        const tableMatch = sql.match(/(?:FROM|INTO|UPDATE|TABLE|JOIN)\s+"?(\w+)"?/i);
+        const table = tableMatch ? tableMatch[1] : '';
+        return table ? `${op} ${table}` : op;
+    }
+    return sql.substring(0, 30);
+}
+//# sourceMappingURL=postgres.js.map

package/dist/esm/integrations/postgres.js.map

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

package/dist/esm/integrations/redis.js

@@ -0,0 +1,102 @@
+// ─────────────────────────────────────────────────────────────
+// flow-debugger — Redis Auto-Instrument
+// Wraps Redis client commands to trace all operations
+// ─────────────────────────────────────────────────────────────
+import { DEFAULT_CONFIG } from '../core/types';
+import { classifyQuery } from '../core/Classifier';
+/** Commands to trace */
+const TRACED_COMMANDS = [
+    'get', 'set', 'del', 'exists', 'expire', 'ttl',
+    'hget', 'hset', 'hdel', 'hgetall', 'hmset', 'hmget',
+    'lpush', 'rpush', 'lpop', 'rpop', 'lrange', 'llen',
+    'sadd', 'srem', 'smembers', 'sismember',
+    'zadd', 'zrem', 'zrange', 'zrank', 'zscore',
+    'incr', 'decr', 'incrby', 'decrby',
+    'setex', 'setnx', 'mget', 'mset',
+    'publish', 'subscribe',
+    'eval', 'evalsha',
+];
+/**
+ * Auto-instrument a Redis client (ioredis or node-redis v4).
+ *
+ * Usage:
+ *   redisTracer(redisClient, { getTracer: () => currentTracer })
+ *
+ * Output:
+ *   Redis SET session → 3ms ✔
+ *   Redis GET cache → timeout ❌
+ */
+export function redisTracer(client, options) {
+    try {
+        if (client.__flowDebuggerPatched)
+            return;
+        client.__flowDebuggerPatched = true;
+        const config = { ...DEFAULT_CONFIG, ...options?.config };
+        for (const command of TRACED_COMMANDS) {
+            if (typeof client[command] !== 'function')
+                continue;
+            const original = client[command].bind(client);
+            client[command] = async function tracedCommand(...args) {
+                const tracer = options?.getTracer?.();
+                if (!tracer) {
+                    return original(...args);
+                }
+                const key = args[0] !== undefined ? String(args[0]).substring(0, 50) : '';
+                const stepName = `Redis ${command.toUpperCase()} ${key}`;
+                const startTime = performance.now();
+                let status = 'success';
+                let error;
+                let stackTrace;
+                try {
+                    const result = await original(...args);
+                    const endTime = performance.now();
+                    const duration = endTime - startTime;
+                    const classification = classifyQuery(duration, status, config);
+                    tracer.addStep({
+                        name: stepName,
+                        service: 'redis',
+                        status,
+                        classification,
+                        startTime,
+                        endTime,
+                        duration,
+                        metadata: { command: command.toUpperCase(), key },
+                    });
+                    return result;
+                }
+                catch (err) {
+                    const e = err instanceof Error ? err : new Error(String(err));
+                    error = e.message;
+                    stackTrace = e.stack;
+                    // Detect connection errors as CRITICAL
+                    const isConnectionError = error.includes('ECONNREFUSED') ||
+                        error.includes('ECONNRESET') ||
+                        error.includes('ETIMEDOUT') ||
+                        error.includes('connection') ||
+                        error.includes('Connection');
+                    status = isConnectionError ? 'timeout' : 'error';
+                    const endTime = performance.now();
+                    const duration = endTime - startTime;
+                    const classification = classifyQuery(duration, status, config);
+                    tracer.addStep({
+                        name: stepName,
+                        service: 'redis',
+                        status,
+                        classification,
+                        startTime,
+                        endTime,
+                        duration,
+                        error,
+                        stackTrace,
+                        metadata: { command: command.toUpperCase(), key },
+                    });
+                    throw err;
+                }
+            };
+        }
+    }
+    catch (_) {
+        // Production-safe: never crash
+    }
+}
+//# sourceMappingURL=redis.js.map

package/dist/esm/integrations/redis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.js","sourceRoot":"","sources":["../../../src/integrations/redis.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,wCAAwC;AACxC,sDAAsD;AACtD,gEAAgE;AAGhE,OAAO,EAAyC,cAAc,EAAE,MAAM,eAAe,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AASnD,wBAAwB;AACxB,MAAM,eAAe,GAAG;IACpB,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK;IAC9C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO;IACnD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAClD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW;IACvC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ;IAC3C,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ;IAClC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;IAChC,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,SAAS;CACpB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,MAAgB,EAAE,OAA4B;IACtE,IAAI,CAAC;QACD,IAAI,MAAM,CAAC,qBAAqB;YAAE,OAAO;QACzC,MAAM,CAAC,qBAAqB,GAAG,IAAI,CAAC;QAEpC,MAAM,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC;QAEzD,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE,CAAC;YACpC,IAAI,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU;gBAAE,SAAS;YAEpD,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAE9C,MAAM,CAAC,OAAO,CAAC,GAAG,KAAK,UAAU,aAAa,CAAC,GAAG,IAAW;gBACzD,MAAM,MAAM,GAAG,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC;gBACtC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACV,OAAO,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;gBAC7B,CAAC;gBAED,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1E,MAAM,QAAQ,GAAG,SAAS,OAAO,CAAC,WAAW,EAAE,IAAI,GAAG,EAAE,CAAC;gBACzD,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;gBAEpC,IAAI,MAAM,GAAe,SAAS,CAAC;gBACnC,IAAI,KAAyB,CAAC;gBAC9B,IAAI,UAA8B,CAAC;gBAEnC,IAAI,CAAC;oBACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;oBACvC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;oBAClC,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;oBACrC,MAAM,cAAc,GAAG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;oBAE/D,MAAM,CAAC,OAAO,CAAC;wBACX,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,OAAO;wBAChB,MAAM;wBACN,cAAc;wBACd,SAAS;wBACT,OAAO;wBACP,QAAQ;wBACR,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE;qBACpD,CAAC,CAAC;oBAEH,OAAO,MAAM,CAAC;gBAClB,CAAC;gBAAC,OAAO,GAAY,EAAE,CAAC;oBACpB,MAAM,CAAC,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC9D,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC;oBAClB,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC;oBAErB,uCAAuC;oBACvC,MAAM,iBAAiB,GAAG,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC;wBACpD,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;wBAC5B,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;wBAC3B,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;wBAC5B,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;oBAEjC,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;oBAEjD,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;oBAClC,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;oBACrC,MAAM,cAAc,GAAG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;oBAE/D,MAAM,CAAC,OAAO,CAAC;wBACX,IAAI,EAAE,QAAQ;wBACd,OAAO,EAAE,OAAO;wBAChB,MAAM;wBACN,cAAc;wBACd,SAAS;wBACT,OAAO;wBACP,QAAQ;wBACR,KAAK;wBACL,UAAU;wBACV,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,GAAG,EAAE;qBACpD,CAAC,CAAC;oBAEH,MAAM,GAAG,CAAC;gBACd,CAAC;YACL,CAAC,CAAC;QACN,CAAC;IACL,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,+BAA+B;IACnC,CAAC;AACL,CAAC"}

package/dist/esm/middleware/express.js

@@ -0,0 +1,219 @@
+// ─────────────────────────────────────────────────────────────
+// flow-debugger — Express Middleware
+// Auto-traces every request, provides /__debugger API + dashboard
+// ─────────────────────────────────────────────────────────────
+import { TraceEngine } from '../core/TraceEngine';
+import { Analytics } from '../core/Analytics';
+import { Sampler } from '../core/Sampler';
+import { DEFAULT_CONFIG } from '../core/types';
+import * as path from 'path';
+import * as fs from 'fs';
+// AsyncLocalStorage for automatic tracer context propagation
+let asyncLocalStorage;
+try {
+    const { AsyncLocalStorage } = require('async_hooks');
+    asyncLocalStorage = new AsyncLocalStorage();
+}
+catch (_) {
+    // Fallback for environments without async_hooks
+    asyncLocalStorage = null;
+}
+/**
+ * Create the flow-debugger Express middleware.
+ *
+ * Usage:
+ *   const debugger = flowDebugger({ slowThreshold: 500 });
+ *   app.use(debugger.middleware);
+ *
+ *   // Auto-instrument databases
+ *   mongoTracer(mongoose, { getTracer: debugger.getTracer });
+ *   mysqlTracer(pool, { getTracer: debugger.getTracer });
+ *
+ *   // Dashboard at: GET /__debugger/dashboard
+ *   // API at:       GET /__debugger
+ */
+export function flowDebugger(config) {
+    const mergedConfig = { ...DEFAULT_CONFIG, ...config };
+    const engine = new TraceEngine(mergedConfig);
+    const analytics = new Analytics(mergedConfig.maxTraces);
+    const sampler = new Sampler(mergedConfig.samplingRate, mergedConfig.alwaysSampleErrors);
+    // Current tracer per async context
+    let fallbackTracer = null;
+    const getTracer = () => {
+        if (asyncLocalStorage) {
+            try {
+                const store = asyncLocalStorage.getStore();
+                return store?.tracer || null;
+            }
+            catch (_) { }
+        }
+        return fallbackTracer;
+    };
+    const middleware = (req, res, next) => {
+        try {
+            // Skip debugger endpoints
+            if (req.path?.startsWith('/__debugger')) {
+                return handleDebuggerRoute(req, res, next, analytics, mergedConfig);
+            }
+            if (!mergedConfig.enabled)
+                return next();
+            // Sampling
+            if (!sampler.shouldSample())
+                return next();
+            const tracer = engine.startTrace(req.path || req.url, req.method);
+            req.tracer = tracer;
+            req.traceId = tracer.getTraceId();
+            // Set header for client correlation
+            res.setHeader('X-Trace-Id', tracer.getTraceId());
+            const run = () => {
+                fallbackTracer = tracer;
+                // Calculate payload size if body exists
+                let payloadSize;
+                try {
+                    if (req.body) {
+                        const bodyStr = JSON.stringify(req.body);
+                        payloadSize = Buffer.byteLength(bodyStr, 'utf8');
+                    }
+                }
+                catch (_) {
+                    // ignore
+                }
+                // Hook into response finish
+                const originalEnd = res.end;
+                res.end = function (...args) {
+                    try {
+                        const trace = tracer.end(res.statusCode);
+                        // Add environment and payload size to trace
+                        trace.environment = mergedConfig.environment;
+                        trace.payloadSize = payloadSize;
+                        analytics.record(trace);
+                        // If error and we had skipped sampling, re-sample
+                    }
+                    catch (_) {
+                        // never crash
+                    }
+                    fallbackTracer = null;
+                    return originalEnd.apply(res, args);
+                };
+                next();
+            };
+            // Use AsyncLocalStorage if available
+            if (asyncLocalStorage) {
+                asyncLocalStorage.run({ tracer }, run);
+            }
+            else {
+                run();
+            }
+        }
+        catch (_) {
+            // Production-safe: if debugger fails, pass through
+            next();
+        }
+    };
+    return { middleware, engine, analytics, getTracer };
+}
+/**
+ * Handle /__debugger routes
+ */
+function handleDebuggerRoute(req, res, next, analytics, config) {
+    if (!config.enableDashboard)
+        return next();
+    try {
+        const subPath = req.path.replace('/__debugger', '') || '/';
+        switch (subPath) {
+            case '/':
+            case '/api':
+                // JSON analytics API
+                res.json(analytics.getReport());
+                break;
+            case '/dashboard': {
+                // Serve the HTML dashboard
+                const dashboardPath = path.resolve(__dirname, '../../dashboard/index.html');
+                if (fs.existsSync(dashboardPath)) {
+                    res.sendFile(dashboardPath);
+                }
+                else {
+                    // Fallback: inline minimal dashboard
+                    res.send(getInlineDashboard());
+                }
+                break;
+            }
+            case '/dashboard/style.css': {
+                const cssPath = path.resolve(__dirname, '../../dashboard/style.css');
+                if (fs.existsSync(cssPath)) {
+                    res.type('text/css').sendFile(cssPath);
+                }
+                else {
+                    res.status(404).send('Not found');
+                }
+                break;
+            }
+            case '/dashboard/app.js': {
+                const jsPath = path.resolve(__dirname, '../../dashboard/app.js');
+                if (fs.existsSync(jsPath)) {
+                    res.type('application/javascript').sendFile(jsPath);
+                }
+                else {
+                    res.status(404).send('Not found');
+                }
+                break;
+            }
+            case '/health':
+                res.json(analytics.getHealthMonitor().getAllHealth());
+                break;
+            case '/endpoint': {
+                const endpoint = req.query?.path || req.query?.endpoint;
+                if (endpoint) {
+                    const report = analytics.getEndpointReport(String(endpoint));
+                    res.json(report || { error: 'Endpoint not found' });
+                }
+                else {
+                    res.json({ error: 'Provide ?path=/your/endpoint' });
+                }
+                break;
+            }
+            case '/search': {
+                const query = req.query?.q || req.query?.query;
+                const env = req.query?.env;
+                const limit = req.query?.limit ? parseInt(String(req.query.limit), 10) : 50;
+                if (query) {
+                    const results = analytics.searchTraces(String(query), { env: env ? String(env) : undefined, limit });
+                    res.json({ query, results, count: results.length });
+                }
+                else {
+                    res.json({ error: 'Provide ?q=search_term' });
+                }
+                break;
+            }
+            default:
+                next();
+        }
+    }
+    catch (err) {
+        res.status(500).json({ error: 'Debugger dashboard error' });
+    }
+}
+/** Inline fallback dashboard if files aren't found */
+function getInlineDashboard() {
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Flow Debugger Dashboard</title>
+  <style>body{font-family:system-ui;background:#0a0a1a;color:#e0e0e0;padding:20px}
+  h1{color:#7c3aed}.card{background:#1a1a2e;border-radius:12px;padding:20px;margin:10px 0;border:1px solid #2a2a4a}</style>
+</head>
+<body>
+  <h1>🔍 Flow Debugger</h1>
+  <p>Dashboard files not found. API available at <a href="/__debugger" style="color:#7c3aed">/__debugger</a></p>
+  <div class="card" id="data">Loading...</div>
+  <script>
+    fetch('/__debugger').then(r=>r.json()).then(d=>{
+      document.getElementById('data').innerHTML='<pre>'+JSON.stringify(d,null,2)+'</pre>';
+    });
+  </script>
+</body>
+</html>`;
+}
+//# sourceMappingURL=express.js.map

package/dist/esm/middleware/express.js.map

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

package/dist/types/core/Analytics.d.ts

@@ -0,0 +1,35 @@
+import { Trace, EndpointStats, AnalyticsReport } from './types';
+import { HealthMonitor } from './HealthMonitor';
+export declare class Analytics {
+    private traces;
+    private maxTraces;
+    private startTime;
+    private healthMonitor;
+    constructor(maxTraces?: number);
+    /** Record a completed trace */
+    record(trace: Trace): void;
+    /** Get full analytics report */
+    getReport(): AnalyticsReport;
+    /** Get stats for a specific endpoint */
+    getEndpointReport(path: string): EndpointStats | null;
+    /** Get aggregated stats per endpoint */
+    private getEndpointStats;
+    /** Get service failure breakdown across all traces */
+    private getTopFailures;
+    /** Calculate service failure stats from a set of traces */
+    private getServiceFailures;
+    /** Clear all stored traces */
+    clear(): void;
+    /** Get raw trace count */
+    getTraceCount(): number;
+    /**
+     * Search traces by traceId, endpoint, or error message.
+     * Returns matching traces sorted by most recent first.
+     */
+    searchTraces(query: string, options?: {
+        env?: string;
+        limit?: number;
+    }): Trace[];
+    getHealthMonitor(): HealthMonitor;
+}
+//# sourceMappingURL=Analytics.d.ts.map

package/dist/types/core/Analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Analytics.d.ts","sourceRoot":"","sources":["../../../src/core/Analytics.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,KAAK,EACL,aAAa,EACb,eAAe,EAIlB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,qBAAa,SAAS;IAClB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAO;IACxB,OAAO,CAAC,aAAa,CAAgB;gBAEzB,SAAS,SAAO;IAM5B,+BAA+B;IAC/B,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAkB1B,gCAAgC;IAChC,SAAS,IAAI,eAAe;IAmB5B,wCAAwC;IACxC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAKrD,wCAAwC;IACxC,OAAO,CAAC,gBAAgB;IAkDxB,sDAAsD;IACtD,OAAO,CAAC,cAAc;IAItB,2DAA2D;IAC3D,OAAO,CAAC,kBAAkB;IAsB1B,8BAA8B;IAC9B,KAAK,IAAI,IAAI;IAIb,0BAA0B;IAC1B,aAAa,IAAI,MAAM;IAIvB;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,EAAE;IAwChF,gBAAgB,IAAI,aAAa;CAGpC"}

package/dist/types/core/Classifier.d.ts

@@ -0,0 +1,21 @@
+import { ClassificationLevel, StepStatus, TraceStep, DebuggerConfig } from './types';
+/**
+ * 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
+ */
+export declare function classify(duration: number, status: StepStatus, config: Pick<DebuggerConfig, 'slowThreshold'>): ClassificationLevel;
+/**
+ * Classify an entire trace based on its steps.
+ * The trace gets the highest severity from any of its steps.
+ */
+export declare function classifyTrace(steps: TraceStep[], _totalDuration: number, config: Pick<DebuggerConfig, 'slowThreshold'>): ClassificationLevel;
+/**
+ * Classify a database query specifically — used by integrations
+ * to detect slow queries with a dedicated threshold.
+ */
+export declare function classifyQuery(duration: number, status: StepStatus, config: Pick<DebuggerConfig, 'slowQueryThreshold'>): ClassificationLevel;
+//# sourceMappingURL=Classifier.d.ts.map

package/dist/types/core/Classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Classifier.d.ts","sourceRoot":"","sources":["../../../src/core/Classifier.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,mBAAmB,EACnB,UAAU,EACV,SAAS,EACT,cAAc,EACjB,MAAM,SAAS,CAAC;AAEjB;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACpB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,GAC9C,mBAAmB,CAOrB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CACzB,KAAK,EAAE,SAAS,EAAE,EAClB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,GAC9C,mBAAmB,CAuBrB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,oBAAoB,CAAC,GACnD,mBAAmB,CAOrB"}

package/dist/types/core/HealthMonitor.d.ts

@@ -0,0 +1,14 @@
+import { TraceStep, HealthStatus, ServiceTag } from './types';
+export declare class HealthMonitor {
+    private records;
+    /** Record a step result to update health tracking */
+    recordStep(step: TraceStep): void;
+    /** Get health status for a specific service */
+    getHealth(service: ServiceTag): HealthStatus | null;
+    /** Get health status for all tracked services */
+    getAllHealth(): HealthStatus[];
+    private toHealthStatus;
+    /** Reset all health records */
+    reset(): void;
+}
+//# sourceMappingURL=HealthMonitor.d.ts.map

package/dist/types/core/HealthMonitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthMonitor.d.ts","sourceRoot":"","sources":["../../../src/core/HealthMonitor.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,SAAS,EACT,YAAY,EAEZ,UAAU,EACb,MAAM,SAAS,CAAC;AAUjB,qBAAa,aAAa;IACtB,OAAO,CAAC,OAAO,CAAmC;IAElD,qDAAqD;IACrD,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IA4BjC,+CAA+C;IAC/C,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,YAAY,GAAG,IAAI;IAMnD,iDAAiD;IACjD,YAAY,IAAI,YAAY,EAAE;IAI9B,OAAO,CAAC,cAAc;IAuBtB,+BAA+B;IAC/B,KAAK,IAAI,IAAI;CAGhB"}

package/dist/types/core/RootCause.d.ts

@@ -0,0 +1,12 @@
+import { TraceStep, RootCauseResult, DebuggerConfig } from './types';
+/**
+ * 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
+ */
+export declare function detectRootCause(steps: TraceStep[], statusCode: number | undefined, config: Pick<DebuggerConfig, 'slowThreshold' | 'slowQueryThreshold'>): RootCauseResult | null;
+//# sourceMappingURL=RootCause.d.ts.map

package/dist/types/core/RootCause.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RootCause.d.ts","sourceRoot":"","sources":["../../../src/core/RootCause.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,SAAS,EACT,eAAe,EACf,cAAc,EAEjB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC3B,KAAK,EAAE,SAAS,EAAE,EAClB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,GAAG,oBAAoB,CAAC,GACrE,eAAe,GAAG,IAAI,CA2DxB"}

package/dist/types/core/Sampler.d.ts

@@ -0,0 +1,13 @@
+export declare class Sampler {
+    private rate;
+    private alwaysSampleErrors;
+    constructor(rate?: number, alwaysSampleErrors?: boolean);
+    /** Should this request be sampled? */
+    shouldSample(): boolean;
+    /** Force sample if it's an error (if alwaysSampleErrors is true) */
+    shouldSampleError(): boolean;
+    /** Update sampling rate at runtime */
+    setRate(rate: number): void;
+    getRate(): number;
+}
+//# sourceMappingURL=Sampler.d.ts.map

package/dist/types/core/Sampler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sampler.d.ts","sourceRoot":"","sources":["../../../src/core/Sampler.ts"],"names":[],"mappings":"AAKA,qBAAa,OAAO;IAChB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,kBAAkB,CAAU;gBAExB,IAAI,SAAI,EAAE,kBAAkB,UAAO;IAK/C,sCAAsC;IACtC,YAAY,IAAI,OAAO;IAMvB,oEAAoE;IACpE,iBAAiB,IAAI,OAAO;IAI5B,sCAAsC;IACtC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,OAAO,IAAI,MAAM;CAGpB"}