flow-debugger 1.0.0

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

@@ -0,0 +1,22 @@
+import { Trace } from './types';
+/**
+ * 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
+ * └────────────────────────────────────────────────────
+ */
+export declare function renderTimeline(trace: Trace, logger?: (...args: unknown[]) => void): void;
+/**
+ * Render a compact one-line summary for high-traffic mode.
+ */
+export declare function renderCompact(trace: Trace, logger?: (...args: unknown[]) => void): void;
+//# sourceMappingURL=Timeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Timeline.d.ts","sourceRoot":"","sources":["../../../src/core/Timeline.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,EAAuB,MAAM,SAAS,CAAC;AAoBrD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC1B,KAAK,EAAE,KAAK,EACZ,MAAM,GAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAkB,GACnD,IAAI,CAiDN;AAED;;GAEG;AACH,wBAAgB,aAAa,CACzB,KAAK,EAAE,KAAK,EACZ,MAAM,GAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAkB,GACnD,IAAI,CAON"}

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

@@ -0,0 +1,47 @@
+import { EventEmitter } from 'events';
+import { Trace, TraceStep, StepOptions, DebuggerConfig } from './types';
+/**
+ * TraceEngine — manages the lifecycle of a single request trace.
+ *
+ * Usage:
+ *   const engine = new TraceEngine(config);
+ *   const tracer = engine.startTrace('/login', 'POST');
+ *   await tracer.step('DB find user', async () => User.findOne(), { service: 'mongo' });
+ *   tracer.end(200);
+ */
+export declare class TraceEngine extends EventEmitter {
+    private config;
+    constructor(config?: DebuggerConfig);
+    /** Update config at runtime */
+    updateConfig(patch: Partial<DebuggerConfig>): void;
+    getConfig(): Required<DebuggerConfig>;
+    /** Start a new request trace */
+    startTrace(endpoint: string, method: string): RequestTracer;
+    /** Safe emit — never throws */
+    safeEmit(event: string, data: unknown): void;
+}
+/**
+ * RequestTracer — the object attached to a single request.
+ * Provides `step()` for manual instrumentation and `addStep()` for auto-instrumentation.
+ */
+export declare class RequestTracer {
+    private traceId;
+    private endpoint;
+    private method;
+    private steps;
+    private startTime;
+    private config;
+    private engine;
+    private ended;
+    constructor(endpoint: string, method: string, config: Required<DebuggerConfig>, engine: TraceEngine);
+    getTraceId(): string;
+    getSteps(): TraceStep[];
+    /** Manually run & trace an async step */
+    step<T>(name: string, fn: () => Promise<T> | T, options?: StepOptions): Promise<T>;
+    /** Add a pre-recorded step (used by auto-integrations) */
+    addStep(step: TraceStep): void;
+    /** End the trace and produce the final result */
+    end(statusCode?: number): Trace;
+    private buildTrace;
+}
+//# sourceMappingURL=TraceEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TraceEngine.d.ts","sourceRoot":"","sources":["../../../src/core/TraceEngine.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EACH,KAAK,EACL,SAAS,EACT,WAAW,EAGX,cAAc,EAGjB,MAAM,SAAS,CAAC;AA6CjB;;;;;;;;GAQG;AACH,qBAAa,WAAY,SAAQ,YAAY;IACzC,OAAO,CAAC,MAAM,CAA2B;gBAE7B,MAAM,CAAC,EAAE,cAAc;IAKnC,+BAA+B;IAC/B,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAIlD,SAAS,IAAI,QAAQ,CAAC,cAAc,CAAC;IAIrC,gCAAgC;IAChC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa;IAM3D,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;CAO/C;AAED;;;GAGG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,KAAK,CAAS;gBAGlB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,EAChC,MAAM,EAAE,WAAW;IAUvB,UAAU,IAAI,MAAM;IAIpB,QAAQ,IAAI,SAAS,EAAE;IAIvB,yCAAyC;IACnC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IA0ExF,0DAA0D;IAC1D,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAQ9B,iDAAiD;IACjD,GAAG,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK;IAqB/B,OAAO,CAAC,UAAU;CAoBrB"}

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

@@ -0,0 +1,118 @@
+/** Classification severity levels */
+export type ClassificationLevel = 'INFO' | 'WARN' | 'ERROR' | 'CRITICAL';
+/** Known service/dependency types for tagging */
+export type ServiceTag = 'mongo' | 'mysql' | 'postgres' | 'redis' | 'axios' | 'fetch' | 'stripe' | 'razorpay' | 'sendgrid' | 'twilio' | 'external' | 'internal' | 'unknown';
+/** Health status for a dependency */
+export type HealthState = 'healthy' | 'degraded' | 'down';
+/** Status of a single traced step */
+export type StepStatus = 'success' | 'error' | 'timeout';
+/** A single measured step within a trace */
+export interface TraceStep {
+    name: string;
+    service: ServiceTag;
+    status: StepStatus;
+    classification: ClassificationLevel;
+    startTime: number;
+    endTime: number;
+    duration: number;
+    error?: string;
+    stackTrace?: string;
+    errorFile?: string;
+    errorLine?: number;
+    metadata?: Record<string, unknown>;
+}
+/** Options passed to `step()` */
+export interface StepOptions {
+    /** Service tag for grouping  (e.g. 'postgres', 'redis') */
+    service?: ServiceTag;
+    /** Timeout in ms — triggers StepStatus.timeout if exceeded */
+    timeout?: number;
+    /** Arbitrary metadata attached to the step */
+    metadata?: Record<string, unknown>;
+}
+/** A complete request trace */
+export interface Trace {
+    traceId: string;
+    endpoint: string;
+    method: string;
+    statusCode?: number;
+    steps: TraceStep[];
+    totalDuration: number;
+    classification: ClassificationLevel;
+    rootCause: RootCauseResult | null;
+    startTime: number;
+    endTime: number;
+    timestamp: Date;
+    environment?: string;
+    payloadSize?: number;
+}
+export interface RootCauseResult {
+    cause: string;
+    step: string;
+    service: ServiceTag;
+    confidence: 'high' | 'medium' | 'low';
+}
+export interface ServiceFailureStats {
+    service: ServiceTag;
+    count: number;
+    percentage: number;
+}
+export interface EndpointStats {
+    path: string;
+    method: string;
+    totalRequests: number;
+    errorCount: number;
+    slowCount: number;
+    avgDuration: number;
+    p95Duration: number;
+    maxDuration: number;
+    commonIssues: string[];
+    serviceFailures: ServiceFailureStats[];
+    recentTraces: Trace[];
+}
+export interface AnalyticsReport {
+    totalRequests: number;
+    totalErrors: number;
+    totalSlow: number;
+    uptime: number;
+    endpoints: EndpointStats[];
+    serviceHealth: HealthStatus[];
+    topFailures: ServiceFailureStats[];
+    recentTraces: Trace[];
+}
+export interface HealthStatus {
+    service: ServiceTag;
+    name: string;
+    status: HealthState;
+    lastCheck: Date;
+    successRate: number;
+    totalChecks: number;
+}
+export interface DebuggerConfig {
+    /** Enable/disable the debugger (default: true) */
+    enabled?: boolean;
+    /** Environment tag (dev / staging / production) */
+    environment?: string;
+    /** Threshold in ms to mark a step as slow (default: 300) */
+    slowThreshold?: number;
+    /** Threshold in ms for slow SQL/DB query detection (default: 300) */
+    slowQueryThreshold?: number;
+    /** Default step timeout in ms (default: 30000) */
+    defaultTimeout?: number;
+    /** Sampling rate 0-1 (default: 1 = 100%) */
+    samplingRate?: number;
+    /** Always sample errors even if sampling drops the request (default: true) */
+    alwaysSampleErrors?: boolean;
+    /** Max traces to keep in memory for analytics (default: 1000) */
+    maxTraces?: number;
+    /** Enable console timeline output (default: true) */
+    enableTimeline?: boolean;
+    /** Enable the /__debugger dashboard (default: true) */
+    enableDashboard?: boolean;
+    /** Payload size threshold in bytes to warn (default: 1MB) */
+    largePayloadThreshold?: number;
+    /** Custom logger function */
+    logger?: (...args: unknown[]) => void;
+}
+export declare const DEFAULT_CONFIG: Required<DebuggerConfig>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":"AAIA,qCAAqC;AACrC,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;AAEzE,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAChB,OAAO,GACP,OAAO,GACP,UAAU,GACV,OAAO,GACP,OAAO,GACP,OAAO,GACP,QAAQ,GACR,UAAU,GACV,UAAU,GACV,QAAQ,GACR,UAAU,GACV,UAAU,GACV,SAAS,CAAC;AAEhB,qCAAqC;AACrC,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAE1D,qCAAqC;AACrC,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAIzD,4CAA4C;AAC5C,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,cAAc,EAAE,mBAAmB,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,iCAAiC;AACjC,MAAM,WAAW,WAAW;IACxB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,+BAA+B;AAC/B,MAAM,WAAW,KAAK;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,mBAAmB,CAAC;IACpC,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAID,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACzC;AAID,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,UAAU,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,mBAAmB,EAAE,CAAC;IACvC,YAAY,EAAE,KAAK,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,YAAY,EAAE,KAAK,EAAE,CAAC;CACzB;AAID,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,UAAU,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACvB;AAID,MAAM,WAAW,cAAc;IAC3B,kDAAkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,uDAAuD;IACvD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6DAA6D;IAC7D,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,6BAA6B;IAC7B,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACzC;AAED,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,cAAc,CAanD,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,18 @@
+export { TraceEngine, RequestTracer } from './core/TraceEngine';
+export { classify, classifyTrace, classifyQuery } from './core/Classifier';
+export { detectRootCause } from './core/RootCause';
+export { Analytics } from './core/Analytics';
+export { HealthMonitor } from './core/HealthMonitor';
+export { Sampler } from './core/Sampler';
+export { renderTimeline, renderCompact } from './core/Timeline';
+export type { ClassificationLevel, ServiceTag, HealthState, StepStatus, TraceStep, StepOptions, Trace, RootCauseResult, ServiceFailureStats, EndpointStats, AnalyticsReport, HealthStatus, DebuggerConfig, } from './core/types';
+export { DEFAULT_CONFIG } from './core/types';
+export { mongoTracer, removeMongoTracer } from './integrations/mongo';
+export { mysqlTracer } from './integrations/mysql';
+export { pgTracer } from './integrations/postgres';
+export { redisTracer } from './integrations/redis';
+export { fetchTracer, removeFetchTracer } from './integrations/fetch';
+export { axiosTracer } from './integrations/axios';
+export { flowDebugger } from './middleware/express';
+export type { FlowDebuggerMiddleware } from './middleware/express';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhE,YAAY,EACR,mBAAmB,EACnB,UAAU,EACV,WAAW,EACX,UAAU,EACV,SAAS,EACT,WAAW,EACX,KAAK,EACL,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,YAAY,EACZ,cAAc,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,YAAY,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/types/integrations/axios.d.ts

@@ -0,0 +1,22 @@
+import { RequestTracer } from '../core/TraceEngine';
+import { DebuggerConfig, ServiceTag } from '../core/types';
+type AnyAxios = any;
+interface AxiosTracerOptions {
+    config?: Partial<DebuggerConfig>;
+    getTracer?: () => RequestTracer | null;
+    /** Map URL patterns to service tags */
+    serviceMap?: Record<string, ServiceTag>;
+}
+/**
+ * Auto-instrument Axios instance to trace all HTTP requests.
+ *
+ * Usage:
+ *   axiosTracer(axios, { getTracer: () => currentTracer })
+ *
+ * Output:
+ *   Axios POST https://api.stripe.com/v1/charges → 234ms ✔ [stripe]
+ *   Axios GET https://api.razorpay.com/orders → 502 error ❌ [razorpay]
+ */
+export declare function axiosTracer(axiosInstance: AnyAxios, options?: AxiosTracerOptions): void;
+export {};
+//# sourceMappingURL=axios.d.ts.map

package/dist/types/integrations/axios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axios.d.ts","sourceRoot":"","sources":["../../../src/integrations/axios.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAyB,cAAc,EAAkB,UAAU,EAAE,MAAM,eAAe,CAAC;AAGlG,KAAK,QAAQ,GAAG,GAAG,CAAC;AAEpB,UAAU,kBAAkB;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,aAAa,GAAG,IAAI,CAAC;IACvC,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAC3C;AAaD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,aAAa,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAgGvF"}

package/dist/types/integrations/fetch.d.ts

@@ -0,0 +1,25 @@
+import { RequestTracer } from '../core/TraceEngine';
+import { DebuggerConfig, ServiceTag } from '../core/types';
+interface FetchTracerOptions {
+    config?: Partial<DebuggerConfig>;
+    getTracer?: () => RequestTracer | null;
+    /** Map URL patterns to service tags (e.g. 'stripe.com' -> 'stripe') */
+    serviceMap?: Record<string, ServiceTag>;
+}
+/**
+ * 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 declare function fetchTracer(options?: FetchTracerOptions): void;
+/**
+ * Remove fetch tracer (for testing/cleanup)
+ */
+export declare function removeFetchTracer(): void;
+export {};
+//# sourceMappingURL=fetch.d.ts.map

package/dist/types/integrations/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../src/integrations/fetch.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAyB,cAAc,EAAkB,UAAU,EAAE,MAAM,eAAe,CAAC;AAGlG,UAAU,kBAAkB;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,aAAa,GAAG,IAAI,CAAC;IACvC,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CAC3C;AAeD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAyF9D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAOxC"}

package/dist/types/integrations/mongo.d.ts

@@ -0,0 +1,26 @@
+import { RequestTracer } from '../core/TraceEngine';
+import { DebuggerConfig } from '../core/types';
+type AnyMongoose = any;
+interface MongoTracerOptions {
+    /** Config overrides for slow query thresholds */
+    config?: Partial<DebuggerConfig>;
+    /** Function to get the current active tracer (for auto-mode) */
+    getTracer?: () => RequestTracer | null;
+}
+/**
+ * Auto-instrument Mongoose to trace all queries.
+ *
+ * Usage:
+ *   mongoTracer(mongoose, { getTracer: () => currentTracer })
+ *
+ * Output:
+ *   Mongo users.findOne → 22ms ✔
+ *   Mongo payments.insertMany → error ❌
+ */
+export declare function mongoTracer(mongoose: AnyMongoose, options?: MongoTracerOptions): void;
+/**
+ * Remove the monkey-patch from Mongoose (for testing/cleanup).
+ */
+export declare function removeMongoTracer(mongoose: AnyMongoose): void;
+export {};
+//# sourceMappingURL=mongo.d.ts.map

package/dist/types/integrations/mongo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.d.ts","sourceRoot":"","sources":["../../../src/integrations/mongo.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAyB,cAAc,EAAkB,MAAM,eAAe,CAAC;AAGtF,KAAK,WAAW,GAAG,GAAG,CAAC;AAEvB,UAAU,kBAAkB;IACxB,iDAAiD;IACjD,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,aAAa,GAAG,IAAI,CAAC;CAC1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAyFrF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAO7D"}

package/dist/types/integrations/mysql.d.ts

@@ -0,0 +1,20 @@
+import { RequestTracer } from '../core/TraceEngine';
+import { DebuggerConfig } from '../core/types';
+type AnyPool = any;
+interface MysqlTracerOptions {
+    config?: Partial<DebuggerConfig>;
+    getTracer?: () => RequestTracer | null;
+}
+/**
+ * Auto-instrument mysql2 pool to trace all queries.
+ *
+ * Usage:
+ *   mysqlTracer(pool, { getTracer: () => currentTracer })
+ *
+ * Output:
+ *   MySQL SELECT users → 12ms ✔
+ *   MySQL INSERT payments → error ❌
+ */
+export declare function mysqlTracer(pool: AnyPool, options?: MysqlTracerOptions): void;
+export {};
+//# sourceMappingURL=mysql.d.ts.map

package/dist/types/integrations/mysql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql.d.ts","sourceRoot":"","sources":["../../../src/integrations/mysql.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAyB,cAAc,EAAkB,MAAM,eAAe,CAAC;AAGtF,KAAK,OAAO,GAAG,GAAG,CAAC;AAEnB,UAAU,kBAAkB;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,aAAa,GAAG,IAAI,CAAC;CAC1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAsM7E"}

package/dist/types/integrations/postgres.d.ts

@@ -0,0 +1,20 @@
+import { RequestTracer } from '../core/TraceEngine';
+import { DebuggerConfig } from '../core/types';
+type AnyPool = any;
+interface PgTracerOptions {
+    config?: Partial<DebuggerConfig>;
+    getTracer?: () => RequestTracer | null;
+}
+/**
+ * Auto-instrument pg Pool/Client to trace all queries.
+ *
+ * Usage:
+ *   pgTracer(pool, { getTracer: () => currentTracer })
+ *
+ * Output:
+ *   Postgres SELECT orders → 18ms ✔
+ *   Postgres UPDATE invoice → timeout ❌
+ */
+export declare function pgTracer(pool: AnyPool, options?: PgTracerOptions): void;
+export {};
+//# sourceMappingURL=postgres.d.ts.map

package/dist/types/integrations/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../../src/integrations/postgres.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAyB,cAAc,EAAkB,MAAM,eAAe,CAAC;AAGtF,KAAK,OAAO,GAAG,GAAG,CAAC;AAEnB,UAAU,eAAe;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,aAAa,GAAG,IAAI,CAAC;CAC1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAoFvE"}

package/dist/types/integrations/redis.d.ts

@@ -0,0 +1,20 @@
+import { RequestTracer } from '../core/TraceEngine';
+import { DebuggerConfig } from '../core/types';
+type AnyRedis = any;
+interface RedisTracerOptions {
+    config?: Partial<DebuggerConfig>;
+    getTracer?: () => RequestTracer | null;
+}
+/**
+ * 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 declare function redisTracer(client: AnyRedis, options?: RedisTracerOptions): void;
+export {};
+//# sourceMappingURL=redis.d.ts.map

package/dist/types/integrations/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../../src/integrations/redis.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAyB,cAAc,EAAkB,MAAM,eAAe,CAAC;AAGtF,KAAK,QAAQ,GAAG,GAAG,CAAC;AAEpB,UAAU,kBAAkB;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,aAAa,GAAG,IAAI,CAAC;CAC1C;AAeD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAkFhF"}

package/dist/types/middleware/express.d.ts

@@ -0,0 +1,39 @@
+import { TraceEngine, RequestTracer } from '../core/TraceEngine';
+import { Analytics } from '../core/Analytics';
+import { DebuggerConfig } from '../core/types';
+type Request = any;
+type Response = any;
+type NextFunction = any;
+/** Per-request extended request */
+declare global {
+    namespace Express {
+        interface Request {
+            tracer?: RequestTracer;
+            traceId?: string;
+        }
+    }
+}
+export interface FlowDebuggerMiddleware {
+    middleware: (req: Request, res: Response, next: NextFunction) => void;
+    engine: TraceEngine;
+    analytics: Analytics;
+    /** Get current active tracer (for use in integrations) */
+    getTracer: () => RequestTracer | 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 declare function flowDebugger(config?: DebuggerConfig): FlowDebuggerMiddleware;
+export {};
+//# sourceMappingURL=express.d.ts.map

package/dist/types/middleware/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../../src/middleware/express.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAkB,MAAM,eAAe,CAAC;AAK/D,KAAK,OAAO,GAAG,GAAG,CAAC;AACnB,KAAK,QAAQ,GAAG,GAAG,CAAC;AACpB,KAAK,YAAY,GAAG,GAAG,CAAC;AAYxB,mCAAmC;AACnC,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,OAAO,CAAC;QACd,UAAU,OAAO;YACb,MAAM,CAAC,EAAE,aAAa,CAAC;YACvB,OAAO,CAAC,EAAE,MAAM,CAAC;SACpB;KACJ;CACJ;AAED,MAAM,WAAW,sBAAsB;IACnC,UAAU,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IACtE,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,SAAS,CAAC;IACrB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,aAAa,GAAG,IAAI,CAAC;CACzC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,sBAAsB,CAyF5E"}