flow-debugger 1.0.0

package/dist/esm/integrations/fetch.js

@@ -0,0 +1,149 @@
+// ─────────────────────────────────────────────────────────────
+// flow-debugger — Fetch API Auto-Instrument
+// Wraps global fetch to trace all HTTP requests
+// ─────────────────────────────────────────────────────────────
+import { DEFAULT_CONFIG } from '../core/types';
+import { classifyQuery } from '../core/Classifier';
+const DEFAULT_SERVICE_MAP = {
+    'stripe.com': 'stripe',
+    'api.stripe.com': 'stripe',
+    'razorpay.com': 'razorpay',
+    'api.razorpay.com': 'razorpay',
+    'sendgrid.com': 'sendgrid',
+    'api.sendgrid.com': 'sendgrid',
+    'twilio.com': 'twilio',
+    'api.twilio.com': 'twilio',
+};
+let originalFetch;
+/**
+ * Auto-instrument global fetch to trace all HTTP requests.
+ *
+ * Usage:
+ *   fetchTracer({ getTracer: () => currentTracer, serviceMap: { 'myapi.com': 'external' } })
+ *
+ * Output:
+ *   Fetch POST https://api.stripe.com/v1/charges → 234ms ✔ [stripe]
+ *   Fetch GET https://api.razorpay.com/orders → timeout ❌ [razorpay]
+ */
+export function fetchTracer(options) {
+    try {
+        if (typeof globalThis.fetch === 'undefined')
+            return;
+        if (globalThis.fetch.__flowDebuggerPatched)
+            return;
+        const config = { ...DEFAULT_CONFIG, ...options?.config };
+        const serviceMap = { ...DEFAULT_SERVICE_MAP, ...options?.serviceMap };
+        originalFetch = globalThis.fetch;
+        globalThis.fetch = async function tracedFetch(input, init) {
+            const tracer = options?.getTracer?.();
+            if (!tracer) {
+                return originalFetch(input, init);
+            }
+            const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;
+            const method = init?.method || 'GET';
+            const service = getServiceFromUrl(url, serviceMap);
+            const stepName = `Fetch ${method} ${getDomain(url)}`;
+            const startTime = performance.now();
+            let status = 'success';
+            let error;
+            let stackTrace;
+            let response;
+            try {
+                response = await originalFetch(input, init);
+                // HTTP errors (4xx, 5xx) are not thrown by fetch, but we should mark them
+                if (!response.ok) {
+                    status = 'error';
+                    error = `HTTP ${response.status} ${response.statusText}`;
+                }
+            }
+            catch (err) {
+                status = 'error';
+                const e = err instanceof Error ? err : new Error(String(err));
+                error = e.message;
+                stackTrace = e.stack;
+                // Detect network errors as timeouts
+                if (error.includes('fetch failed') || error.includes('network') || error.includes('ECONNREFUSED')) {
+                    status = 'timeout';
+                }
+                const endTime = performance.now();
+                const duration = endTime - startTime;
+                const classification = classifyQuery(duration, status, config);
+                tracer.addStep({
+                    name: stepName,
+                    service,
+                    status,
+                    classification,
+                    startTime,
+                    endTime,
+                    duration,
+                    error,
+                    stackTrace,
+                    metadata: { url, method, service },
+                });
+                throw err;
+            }
+            const endTime = performance.now();
+            const duration = endTime - startTime;
+            const classification = classifyQuery(duration, status, config);
+            tracer.addStep({
+                name: stepName,
+                service,
+                status,
+                classification,
+                startTime,
+                endTime,
+                duration,
+                error,
+                metadata: { url, method, statusCode: response.status },
+            });
+            return response;
+        };
+        globalThis.fetch.__flowDebuggerPatched = true;
+    }
+    catch (_) {
+        // Production-safe: never crash
+    }
+}
+/**
+ * Remove fetch tracer (for testing/cleanup)
+ */
+export function removeFetchTracer() {
+    try {
+        if (originalFetch) {
+            globalThis.fetch = originalFetch;
+            delete globalThis.fetch.__flowDebuggerPatched;
+        }
+    }
+    catch (_) { }
+}
+/** Extract service tag from URL */
+function getServiceFromUrl(url, serviceMap) {
+    try {
+        const urlObj = new URL(url);
+        const hostname = urlObj.hostname;
+        // Check exact match
+        if (serviceMap[hostname])
+            return serviceMap[hostname];
+        // Check partial match
+        for (const [pattern, service] of Object.entries(serviceMap)) {
+            if (hostname.includes(pattern))
+                return service;
+        }
+        // Default to fetch
+        return 'fetch';
+    }
+    catch {
+        return 'fetch';
+    }
+}
+/** Extract domain from URL for display */
+function getDomain(url) {
+    try {
+        const urlObj = new URL(url);
+        return urlObj.hostname + urlObj.pathname.substring(0, 30);
+    }
+    catch {
+        return url.substring(0, 50);
+    }
+}
+//# sourceMappingURL=fetch.js.map

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

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

package/dist/esm/integrations/mongo.js

@@ -0,0 +1,107 @@
+// ─────────────────────────────────────────────────────────────
+// flow-debugger — MongoDB/Mongoose Auto-Instrument
+// Patches Mongoose to automatically trace all DB queries
+// ─────────────────────────────────────────────────────────────
+import { DEFAULT_CONFIG } from '../core/types';
+import { classifyQuery } from '../core/Classifier';
+/**
+ * Auto-instrument Mongoose to trace all queries.
+ *
+ * Usage:
+ *   mongoTracer(mongoose, { getTracer: () => currentTracer })
+ *
+ * Output:
+ *   Mongo users.findOne → 22ms ✔
+ *   Mongo payments.insertMany → error ❌
+ */
+export function mongoTracer(mongoose, options) {
+    try {
+        const config = { ...DEFAULT_CONFIG, ...options?.config };
+        const queryProto = mongoose.Query?.prototype;
+        if (!queryProto || queryProto.__flowDebuggerPatched)
+            return;
+        queryProto.__flowDebuggerPatched = true;
+        const originalExec = queryProto.exec;
+        queryProto.exec = async function (...args) {
+            const tracer = options?.getTracer?.();
+            if (!tracer) {
+                return originalExec.apply(this, args);
+            }
+            const op = this.op || 'query';
+            const collection = this.mongooseCollection?.name || this.model?.collection?.name || 'unknown';
+            const stepName = `Mongo ${collection}.${op}`;
+            const startTime = performance.now();
+            let status = 'success';
+            let error;
+            let stackTrace;
+            let result;
+            try {
+                result = await originalExec.apply(this, args);
+            }
+            catch (err) {
+                status = 'error';
+                const e = err instanceof Error ? err : new Error(String(err));
+                error = e.message;
+                stackTrace = e.stack;
+                // Record step before re-throwing
+                const endTime = performance.now();
+                const duration = endTime - startTime;
+                const classification = classifyQuery(duration, status, config);
+                const step = {
+                    name: stepName,
+                    service: 'mongo',
+                    status,
+                    classification,
+                    startTime: startTime,
+                    endTime,
+                    duration,
+                    error,
+                    stackTrace,
+                    metadata: { operation: op, collection },
+                };
+                tracer.addStep(step);
+                throw err;
+            }
+            const endTime = performance.now();
+            const duration = endTime - startTime;
+            const classification = classifyQuery(duration, status, config);
+            const step = {
+                name: stepName,
+                service: 'mongo',
+                status,
+                classification,
+                startTime: startTime,
+                endTime,
+                duration,
+                error,
+                stackTrace,
+                metadata: { operation: op, collection },
+            };
+            tracer.addStep(step);
+            // Log slow query warning
+            if (duration > (config.slowQueryThreshold ?? 300)) {
+                try {
+                    (config.logger || console.log)(`\x1b[33m⚠ Slow MongoDB query: ${stepName} (${Math.round(duration)}ms)\x1b[0m`);
+                }
+                catch (_) { }
+            }
+            return result;
+        };
+    }
+    catch (_) {
+        // Production-safe: never crash the app
+    }
+}
+/**
+ * Remove the monkey-patch from Mongoose (for testing/cleanup).
+ */
+export function removeMongoTracer(mongoose) {
+    try {
+        const queryProto = mongoose.Query?.prototype;
+        if (queryProto) {
+            delete queryProto.__flowDebuggerPatched;
+        }
+    }
+    catch (_) { }
+}
+//# sourceMappingURL=mongo.js.map

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

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

package/dist/esm/integrations/mysql.js

@@ -0,0 +1,209 @@
+// ─────────────────────────────────────────────────────────────
+// flow-debugger — MySQL Auto-Instrument (mysql2)
+// Patches mysql2 pool to trace all queries
+// ─────────────────────────────────────────────────────────────
+import { DEFAULT_CONFIG } from '../core/types';
+import { classifyQuery } from '../core/Classifier';
+/**
+ * Auto-instrument mysql2 pool to trace all queries.
+ *
+ * Usage:
+ *   mysqlTracer(pool, { getTracer: () => currentTracer })
+ *
+ * Output:
+ *   MySQL SELECT users → 12ms ✔
+ *   MySQL INSERT payments → error ❌
+ */
+export function mysqlTracer(pool, options) {
+    try {
+        if (pool.__flowDebuggerPatched)
+            return;
+        pool.__flowDebuggerPatched = true;
+        const config = { ...DEFAULT_CONFIG, ...options?.config };
+        // Patch pool.query
+        const originalQuery = pool.query.bind(pool);
+        pool.query = function tracedQuery(...args) {
+            const tracer = options?.getTracer?.();
+            if (!tracer) {
+                return originalQuery(...args);
+            }
+            const sql = typeof args[0] === 'string' ? args[0] : args[0]?.sql || 'unknown';
+            const operation = extractSqlOperation(sql);
+            const stepName = `MySQL ${operation}`;
+            const startTime = performance.now();
+            // Check if using callback or promise style
+            const lastArg = args[args.length - 1];
+            if (typeof lastArg === 'function') {
+                // Callback style
+                const callback = lastArg;
+                args[args.length - 1] = function (err, results, fields) {
+                    const endTime = performance.now();
+                    const duration = endTime - startTime;
+                    const status = err ? 'error' : 'success';
+                    const classification = classifyQuery(duration, status, config);
+                    const step = {
+                        name: stepName,
+                        service: 'mysql',
+                        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 MySQL query: ${stepName} (${Math.round(duration)}ms)\n  ${sql.substring(0, 100)}\x1b[0m`);
+                        }
+                        catch (_) { }
+                    }
+                    callback(err, results, fields);
+                };
+                return originalQuery(...args);
+            }
+            else {
+                // Promise style
+                const promise = originalQuery(...args);
+                if (promise && typeof promise.then === 'function') {
+                    return promise.then((result) => {
+                        const endTime = performance.now();
+                        const duration = endTime - startTime;
+                        const classification = classifyQuery(duration, 'success', config);
+                        const step = {
+                            name: stepName,
+                            service: 'mysql',
+                            status: 'success',
+                            classification,
+                            startTime,
+                            endTime,
+                            duration,
+                            metadata: { sql: sql.substring(0, 200), operation },
+                        };
+                        tracer.addStep(step);
+                        if (duration > (config.slowQueryThreshold ?? 300)) {
+                            try {
+                                (config.logger || console.log)(`\x1b[33m⚠ Slow MySQL query: ${stepName} (${Math.round(duration)}ms)\n  ${sql.substring(0, 100)}\x1b[0m`);
+                            }
+                            catch (_) { }
+                        }
+                        return result;
+                    }, (err) => {
+                        const endTime = performance.now();
+                        const duration = endTime - startTime;
+                        const classification = classifyQuery(duration, 'error', config);
+                        const step = {
+                            name: stepName,
+                            service: 'mysql',
+                            status: 'error',
+                            classification,
+                            startTime,
+                            endTime,
+                            duration,
+                            error: err?.message,
+                            stackTrace: err?.stack,
+                            metadata: { sql: sql.substring(0, 200), operation },
+                        };
+                        tracer.addStep(step);
+                        throw err;
+                    });
+                }
+                return promise;
+            }
+        };
+        // Patch pool.execute (mysql2 specific)
+        if (pool.execute) {
+            const originalExecute = pool.execute.bind(pool);
+            pool.execute = function tracedExecute(...args) {
+                const tracer = options?.getTracer?.();
+                if (!tracer) {
+                    return originalExecute(...args);
+                }
+                const sql = typeof args[0] === 'string' ? args[0] : args[0]?.sql || 'unknown';
+                const operation = extractSqlOperation(sql);
+                const stepName = `MySQL ${operation}`;
+                const startTime = performance.now();
+                const lastArg = args[args.length - 1];
+                if (typeof lastArg === 'function') {
+                    const callback = lastArg;
+                    args[args.length - 1] = function (err, results, fields) {
+                        const endTime = performance.now();
+                        const duration = endTime - startTime;
+                        const status = err ? 'error' : 'success';
+                        const classification = classifyQuery(duration, status, config);
+                        tracer.addStep({
+                            name: stepName,
+                            service: 'mysql',
+                            status,
+                            classification,
+                            startTime,
+                            endTime,
+                            duration,
+                            error: err?.message,
+                            stackTrace: err?.stack,
+                            metadata: { sql: sql.substring(0, 200), operation },
+                        });
+                        callback(err, results, fields);
+                    };
+                    return originalExecute(...args);
+                }
+                else {
+                    const promise = originalExecute(...args);
+                    if (promise && typeof promise.then === 'function') {
+                        return promise.then((result) => {
+                            const endTime = performance.now();
+                            const duration = endTime - startTime;
+                            tracer.addStep({
+                                name: stepName,
+                                service: 'mysql',
+                                status: 'success',
+                                classification: classifyQuery(duration, 'success', config),
+                                startTime,
+                                endTime,
+                                duration,
+                                metadata: { sql: sql.substring(0, 200), operation },
+                            });
+                            return result;
+                        }, (err) => {
+                            const endTime = performance.now();
+                            const duration = endTime - startTime;
+                            tracer.addStep({
+                                name: stepName,
+                                service: 'mysql',
+                                status: 'error',
+                                classification: classifyQuery(duration, 'error', config),
+                                startTime,
+                                endTime,
+                                duration,
+                                error: err?.message,
+                                stackTrace: err?.stack,
+                                metadata: { sql: sql.substring(0, 200), operation },
+                            });
+                            throw err;
+                        });
+                    }
+                    return promise;
+                }
+            };
+        }
+    }
+    catch (_) {
+        // Production-safe: never crash
+    }
+}
+/** Extract the SQL operation type from a query string */
+function extractSqlOperation(sql) {
+    const trimmed = sql.trim().toUpperCase();
+    const match = trimmed.match(/^(SELECT|INSERT|UPDATE|DELETE|CREATE|ALTER|DROP|TRUNCATE|REPLACE|CALL)\b/);
+    if (match) {
+        const op = match[1];
+        // Try to extract table name
+        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=mysql.js.map

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

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