flow-debugger 1.0.0

package/dist/cjs/integrations/mongo.js

@@ -0,0 +1,111 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────
+// flow-debugger — MongoDB/Mongoose Auto-Instrument
+// Patches Mongoose to automatically trace all DB queries
+// ─────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mongoTracer = mongoTracer;
+exports.removeMongoTracer = removeMongoTracer;
+const types_1 = require("../core/types");
+const Classifier_1 = require("../core/Classifier");
+/**
+ * Auto-instrument Mongoose to trace all queries.
+ *
+ * Usage:
+ *   mongoTracer(mongoose, { getTracer: () => currentTracer })
+ *
+ * Output:
+ *   Mongo users.findOne → 22ms ✔
+ *   Mongo payments.insertMany → error ❌
+ */
+function mongoTracer(mongoose, options) {
+    try {
+        const config = { ...types_1.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 = (0, Classifier_1.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 = (0, Classifier_1.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).
+ */
+function removeMongoTracer(mongoose) {
+    try {
+        const queryProto = mongoose.Query?.prototype;
+        if (queryProto) {
+            delete queryProto.__flowDebuggerPatched;
+        }
+    }
+    catch (_) { }
+}
+//# sourceMappingURL=mongo.js.map

package/dist/cjs/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/cjs/integrations/mysql.js

@@ -0,0 +1,212 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────
+// flow-debugger — MySQL Auto-Instrument (mysql2)
+// Patches mysql2 pool to trace all queries
+// ─────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mysqlTracer = mysqlTracer;
+const types_1 = require("../core/types");
+const Classifier_1 = require("../core/Classifier");
+/**
+ * Auto-instrument mysql2 pool to trace all queries.
+ *
+ * Usage:
+ *   mysqlTracer(pool, { getTracer: () => currentTracer })
+ *
+ * Output:
+ *   MySQL SELECT users → 12ms ✔
+ *   MySQL INSERT payments → error ❌
+ */
+function mysqlTracer(pool, options) {
+    try {
+        if (pool.__flowDebuggerPatched)
+            return;
+        pool.__flowDebuggerPatched = true;
+        const config = { ...types_1.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 = (0, Classifier_1.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 = (0, Classifier_1.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 = (0, Classifier_1.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 = (0, Classifier_1.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: (0, Classifier_1.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: (0, Classifier_1.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/cjs/integrations/mysql.js.map

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

package/dist/cjs/integrations/postgres.js

@@ -0,0 +1,182 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────
+// flow-debugger — PostgreSQL Auto-Instrument (pg)
+// Patches pg Pool/Client to trace all queries
+// ─────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pgTracer = pgTracer;
+const types_1 = require("../core/types");
+const Classifier_1 = require("../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 ❌
+ */
+function pgTracer(pool, options) {
+    try {
+        if (pool.__flowDebuggerPatched)
+            return;
+        pool.__flowDebuggerPatched = true;
+        const config = { ...types_1.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 = (0, Classifier_1.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/cjs/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/cjs/integrations/redis.js

@@ -0,0 +1,105 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────
+// flow-debugger — Redis Auto-Instrument
+// Wraps Redis client commands to trace all operations
+// ─────────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.redisTracer = redisTracer;
+const types_1 = require("../core/types");
+const Classifier_1 = require("../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 ❌
+ */
+function redisTracer(client, options) {
+    try {
+        if (client.__flowDebuggerPatched)
+            return;
+        client.__flowDebuggerPatched = true;
+        const config = { ...types_1.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 = (0, Classifier_1.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 = (0, Classifier_1.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/cjs/integrations/redis.js.map

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