flow-debugger 1.9.3 → 1.9.4

package/dist/types/index.d.ts

@@ -15,4 +15,6 @@ export { fetchTracer, removeFetchTracer } from './integrations/fetch';
 export { axiosTracer } from './integrations/axios';
 export { flowDebugger } from './middleware/express';
 export type { FlowDebuggerMiddleware } from './middleware/express';
+export { DebuggerProvider, useDebugger, initializeReactNativeDebugger, getReactNativeDebugger, createFetchInterceptor, traceAsyncOperation, withDebugger } from './react_native';
+export type { TraceStep as RNTraceStep, Trace as RNTrace, StepOptions as RNStepOptions, DebuggerContextType as RNDebuggerContextType } from './react_native';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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;AAGnE,OAAO,EACH,gBAAgB,EAChB,WAAW,EACX,6BAA6B,EAC7B,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,YAAY,EACf,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACR,SAAS,IAAI,WAAW,EACxB,KAAK,IAAI,OAAO,EAChB,WAAW,IAAI,aAAa,EAC5B,mBAAmB,IAAI,qBAAqB,EAC/C,MAAM,gBAAgB,CAAC"}

package/dist/types/react_native.d.ts

@@ -0,0 +1,54 @@
+export interface TraceStep {
+    name: string;
+    service: string;
+    status: 'success' | 'error' | 'timeout';
+    startTime: number;
+    endTime: number;
+    duration: number;
+    offset: number;
+    error?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface Trace {
+    traceId: string;
+    endpoint: string;
+    method: string;
+    steps: TraceStep[];
+    totalDuration: number;
+    timestamp: Date;
+    platform: 'react-native';
+}
+export interface StepOptions {
+    service?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface DebuggerContextType {
+    startTrace: (endpoint: string, method?: string) => string;
+    step: <T>(traceId: string, name: string, fn: () => Promise<T>, options?: StepOptions) => Promise<T>;
+    addManualStep: (traceId: string, name: string, duration: number, options?: StepOptions) => void;
+    sendTrace: (traceId: string) => Promise<void>;
+    getTraces: () => Promise<Trace[]>;
+}
+declare class ReactNativeDebugger {
+    private traces;
+    private debuggerUrl;
+    private enabled;
+    constructor(debuggerUrl?: string, enabled?: boolean);
+    private loadTracesFromStorage;
+    private saveTracesToStorage;
+    startTrace(endpoint: string, method?: string): string;
+    step<T>(traceId: string, name: string, fn: () => Promise<T>, options?: StepOptions): Promise<T>;
+    addManualStep(traceId: string, name: string, duration: number, options?: StepOptions): void;
+    sendTrace(traceId: string): Promise<void>;
+    getTraces(): Promise<Trace[]>;
+    clearTraces(): Promise<void>;
+}
+export declare function initializeReactNativeDebugger(debuggerUrl?: string, enabled?: boolean): ReactNativeDebugger;
+export declare function getReactNativeDebugger(): ReactNativeDebugger | null;
+export declare const DebuggerProvider: any;
+export declare const useDebugger: () => DebuggerContextType;
+export declare function withDebugger<P extends object>(Component: any): any;
+export declare function createFetchInterceptor(debuggerUrl?: string): (url: string | URL | Request, options?: RequestInit) => Promise<Response>;
+export declare function traceAsyncOperation<T>(endpoint: string, operationName: string, operation: () => Promise<T>, service?: string): Promise<T>;
+export {};
+//# sourceMappingURL=react_native.d.ts.map

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

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

package/package.json

@@ -1,122 +1,127 @@
-{
-    "name": "flow-debugger",
-    "version": "1.9.3",
-    "description": "Production-safe flow-level debugging SDK. Traces requests, measures timing, classifies errors, detects root causes, and provides endpoint analytics with a live dashboard.",
-    "main": "dist/cjs/index.js",
-    "module": "dist/esm/index.js",
-    "types": "dist/types/index.d.ts",
-    "exports": {
-        ".": {
-            "require": "./dist/cjs/index.js",
-            "import": "./dist/esm/index.js",
-            "types": "./dist/types/index.d.ts"
-        },
-        "./express": {
-            "require": "./dist/cjs/middleware/express.js",
-            "import": "./dist/esm/middleware/express.js",
-            "types": "./dist/types/middleware/express.d.ts"
-        },
-        "./mongo": {
-            "require": "./dist/cjs/integrations/mongo.js",
-            "import": "./dist/esm/integrations/mongo.js",
-            "types": "./dist/types/integrations/mongo.d.ts"
-        },
-        "./mysql": {
-            "require": "./dist/cjs/integrations/mysql.js",
-            "import": "./dist/esm/integrations/mysql.js",
-            "types": "./dist/types/integrations/mysql.d.ts"
-        },
-        "./postgres": {
-            "require": "./dist/cjs/integrations/postgres.js",
-            "import": "./dist/esm/integrations/postgres.js",
-            "types": "./dist/types/integrations/postgres.d.ts"
-        },
-        "./redis": {
-            "require": "./dist/cjs/integrations/redis.js",
-            "import": "./dist/esm/integrations/redis.js",
-            "types": "./dist/types/integrations/redis.d.ts"
-        }
-    },
-    "scripts": {
-        "build": "npm run build:cjs && npm run build:esm && npm run build:types",
-        "build:cjs": "tsc --project tsconfig.cjs.json",
-        "build:esm": "tsc --project tsconfig.esm.json",
-        "build:types": "tsc --project tsconfig.types.json",
-        "dev": "ts-node example/server.ts",
-        "test": "jest --config jest.config.js",
-        "prepublishOnly": "npm run build"
-    },
-    "keywords": [
-        "debugger",
-        "trace",
-        "flow",
-        "monitoring",
-        "performance",
-        "analytics",
-        "root-cause",
-        "express",
-        "mongodb",
-        "mysql",
-        "postgresql",
-        "redis",
-        "apm",
-        "observability",
-        "api-response-monitor"
-    ],
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/sannuk79/PROJECTS-AND-NPM-PACKAGES-"
-    },
-    "homepage": "https://github.com/sannuk79/PROJECTS-AND-NPM-PACKAGES-",
-    "bugs": {
-        "url": "https://github.com/sannuk79/debugerpackages/issues"
-    },
-    "bin": {
-        "flow-debugger": "bin/cli.js"
-    },
-    "author": "",
-    "license": "MIT",
-    "peerDependencies": {
-        "express": "^4.0.0 || ^5.0.0",
-        "mongoose": "^6.0.0 || ^7.0.0 || ^8.0.0 || ^9.0.0",
-        "mysql2": "^2.0.0 || ^3.0.0",
-        "pg": "^8.0.0",
-        "redis": "^4.0.0",
-        "axios": "^0.27.0 || ^1.0.0"
-    },
-    "peerDependenciesMeta": {
-        "express": {
-            "optional": true
-        },
-        "mongoose": {
-            "optional": true
-        },
-        "mysql2": {
-            "optional": true
-        },
-        "pg": {
-            "optional": true
-        },
-        "redis": {
-            "optional": true
-        },
-        "axios": {
-            "optional": true
-        }
-    },
-    "devDependencies": {
-        "@types/express": "^4.17.21",
-        "@types/jest": "^29.5.12",
-        "@types/node": "^20.11.19",
-        "@types/pg": "^8.10.9",
-        "express": "^4.18.2",
-        "jest": "^29.7.0",
-        "mongoose": "^9.2.1",
-        "mysql2": "^3.7.0",
-        "pg": "^8.11.3",
-        "ts-jest": "^29.1.2",
-        "ts-node": "^10.9.2",
-        "typescript": "^5.3.3",
-        "autocannon": "^7.15.0"
-    }
+{
+    "name": "flow-debugger",
+    "version": "1.9.4",
+    "description": "Production-safe flow-level debugging SDK. Traces requests, measures timing, classifies errors, detects root causes, and provides endpoint analytics with a live dashboard.",
+    "main": "dist/cjs/index.js",
+    "module": "dist/esm/index.js",
+    "types": "dist/types/index.d.ts",
+    "exports": {
+        ".": {
+            "require": "./dist/cjs/index.js",
+            "import": "./dist/esm/index.js",
+            "types": "./dist/types/index.d.ts"
+        },
+        "./express": {
+            "require": "./dist/cjs/middleware/express.js",
+            "import": "./dist/esm/middleware/express.js",
+            "types": "./dist/types/middleware/express.d.ts"
+        },
+        "./mongo": {
+            "require": "./dist/cjs/integrations/mongo.js",
+            "import": "./dist/esm/integrations/mongo.js",
+            "types": "./dist/types/integrations/mongo.d.ts"
+        },
+        "./mysql": {
+            "require": "./dist/cjs/integrations/mysql.js",
+            "import": "./dist/esm/integrations/mysql.js",
+            "types": "./dist/types/integrations/mysql.d.ts"
+        },
+        "./postgres": {
+            "require": "./dist/cjs/integrations/postgres.js",
+            "import": "./dist/esm/integrations/postgres.js",
+            "types": "./dist/types/integrations/postgres.d.ts"
+        },
+        "./redis": {
+            "require": "./dist/cjs/integrations/redis.js",
+            "import": "./dist/esm/integrations/redis.js",
+            "types": "./dist/types/integrations/redis.d.ts"
+        },
+        "./react_native": {
+            "require": "./dist/cjs/react_native.js",
+            "import": "./dist/esm/react_native.js",
+            "types": "./dist/types/react_native.d.ts"
+        }
+    },
+    "scripts": {
+        "build": "npm run build:cjs && npm run build:esm && npm run build:types",
+        "build:cjs": "tsc --project tsconfig.cjs.json",
+        "build:esm": "tsc --project tsconfig.esm.json",
+        "build:types": "tsc --project tsconfig.types.json",
+        "dev": "ts-node example/server.ts",
+        "test": "jest --config jest.config.js",
+        "prepublishOnly": "npm run build"
+    },
+    "keywords": [
+        "debugger",
+        "trace",
+        "flow",
+        "monitoring",
+        "performance",
+        "analytics",
+        "root-cause",
+        "express",
+        "mongodb",
+        "mysql",
+        "postgresql",
+        "redis",
+        "apm",
+        "observability",
+        "api-response-monitor"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/sannuk79/PROJECTS-AND-NPM-PACKAGES-"
+    },
+    "homepage": "https://github.com/sannuk79/PROJECTS-AND-NPM-PACKAGES-",
+    "bugs": {
+        "url": "https://github.com/sannuk79/debugerpackages/issues"
+    },
+    "bin": {
+        "flow-debugger": "bin/cli.js"
+    },
+    "author": "",
+    "license": "MIT",
+    "peerDependencies": {
+        "express": "^4.0.0 || ^5.0.0",
+        "mongoose": "^6.0.0 || ^7.0.0 || ^8.0.0 || ^9.0.0",
+        "mysql2": "^2.0.0 || ^3.0.0",
+        "pg": "^8.0.0",
+        "redis": "^4.0.0",
+        "axios": "^0.27.0 || ^1.0.0"
+    },
+    "peerDependenciesMeta": {
+        "express": {
+            "optional": true
+        },
+        "mongoose": {
+            "optional": true
+        },
+        "mysql2": {
+            "optional": true
+        },
+        "pg": {
+            "optional": true
+        },
+        "redis": {
+            "optional": true
+        },
+        "axios": {
+            "optional": true
+        }
+    },
+    "devDependencies": {
+        "@types/express": "^4.17.21",
+        "@types/jest": "^29.5.12",
+        "@types/node": "^20.11.19",
+        "@types/pg": "^8.10.9",
+        "express": "^4.18.2",
+        "jest": "^29.7.0",
+        "mongoose": "^9.2.1",
+        "mysql2": "^3.7.0",
+        "pg": "^8.11.3",
+        "ts-jest": "^29.1.2",
+        "ts-node": "^10.9.2",
+        "typescript": "^5.3.3",
+        "autocannon": "^7.15.0"
+    }
 }

package/python-sdk/fastapi_middleware.py

@@ -0,0 +1,217 @@
+import time
+import uuid
+from typing import Callable, Any
+from contextlib import contextmanager
+import asyncio
+from starlette.middleware.base import BaseHTTPMiddleware
+from starlette.requests import Request
+from starlette.responses import Response
+from starlette.background import BackgroundTask
+import httpx
+from .flow_debugger_core import RequestTracer
+
+
+class FlowDebuggerFastAPI:
+    """
+    FastAPI middleware for flow-debugger integration.
+    
+    Usage:
+        from flow_debugger.fastapi_middleware import FlowDebuggerFastAPI
+        
+        app = FastAPI()
+        debugger = FlowDebuggerFastAPI(
+            app=app,
+            debugger_url="http://localhost:3500/__debugger"
+        )
+    """
+    
+    def __init__(
+        self, 
+        app=None, 
+        debugger_url: str = "http://localhost:3500/__debugger",
+        enabled: bool = True,
+        slow_threshold: int = 300,
+        capture_request_data: bool = False
+    ):
+        self.debugger_url = debugger_url
+        self.enabled = enabled
+        self.slow_threshold = slow_threshold
+        self.capture_request_data = capture_request_data
+        self.app = app
+        
+        if app is not None:
+            self.init_app(app)
+
+    def init_app(self, app):
+        """Initialize the middleware with a FastAPI app."""
+        app.add_middleware(
+            FlowDebuggerMiddleware,
+            debugger=self
+        )
+
+
+class FlowDebuggerMiddleware(BaseHTTPMiddleware):
+    """Internal middleware class that handles the actual request processing."""
+    
+    def __init__(self, app, debugger: FlowDebuggerFastAPI):
+        super().__init__(app)
+        self.debugger = debugger
+
+    async def dispatch(self, request: Request, call_next) -> Response:
+        if not self.debugger.enabled:
+            return await call_next(request)
+            
+        # Skip debugger endpoints to prevent recursion
+        if request.url.path.startswith('/__debugger'):
+            return await call_next(request)
+
+        # Create tracer for this request
+        tracer = RequestTracer(
+            endpoint=request.url.path,
+            method=request.method,
+            trace_id=f"fastapi_{uuid.uuid4().hex[:12]}"
+        )
+        
+        # Store tracer in request state
+        request.state.tracer = tracer
+        
+        start_time = time.time()
+        
+        try:
+            # Process the request
+            response = await call_next(request)
+        finally:
+            # Calculate duration
+            duration = (time.time() - start_time) * 1000  # Convert to milliseconds
+            
+            # End the trace
+            trace_data = tracer.end(status_code=response.status_code)
+            trace_data['totalDuration'] = duration
+            trace_data['timestamp'] = tracer.timestamp.isoformat()
+            
+            # Add request/response info
+            trace_data['endpoint'] = request.url.path
+            trace_data['method'] = request.method
+            
+            # Send trace data to the main debugger service
+            if self.debugger.debugger_url:
+                # Create a background task to send trace data asynchronously
+                # This prevents slowing down the main request
+                async def send_trace():
+                    try:
+                        async with httpx.AsyncClient(timeout=5.0) as client:
+                            await client.post(
+                                self.debugger.debugger_url,
+                                json=trace_data,
+                                headers={'Content-Type': 'application/json'}
+                            )
+                    except Exception:
+                        # Silently fail to avoid affecting the main request
+                        pass
+                
+                # Add background task to response if possible
+                if hasattr(response, 'background') and response.background:
+                    # Chain with existing background tasks
+                    existing_task = response.background
+                    response.background = BackgroundTask(
+                        lambda: asyncio.gather(
+                            send_trace(),
+                            existing_task()
+                        ) if callable(existing_task) else send_trace()
+                    )
+                else:
+                    response.background = BackgroundTask(send_trace)
+        
+        # Add trace ID to response headers
+        response.headers['X-Trace-ID'] = tracer.trace_id
+        
+        return response
+
+
+# Context manager and decorator utilities for manual tracing
+@contextmanager
+def traced_step(tracer: RequestTracer, name: str, service: str = 'internal'):
+    """
+    Context manager for tracing code blocks manually.
+    
+    Usage:
+        with traced_step(request.state.tracer, "Database query", "postgres"):
+            result = await database.fetch_all(query)
+    """
+    if not tracer:
+        yield
+        return
+    
+    step = tracer.step(name, service)
+    try:
+        yield step
+    except Exception as e:
+        step.status = 'error'
+        step.error = str(e)
+        raise
+    finally:
+        step.end()
+
+
+def trace_step_async(name: str, service: str = 'internal'):
+    """
+    Decorator for tracing async functions.
+    
+    Usage:
+        @trace_step_async("User validation", "auth")
+        async def validate_user(user_id):
+            # function implementation
+    """
+    def decorator(func):
+        async def wrapper(*args, **kwargs):
+            # Try to get tracer from request context (requires FastAPI dependency injection)
+            tracer = getattr(args[0].request.state, 'tracer', None) if hasattr(args[0], 'request') else None
+            
+            if tracer:
+                with traced_step(tracer, name, service):
+                    return await func(*args, **kwargs)
+            else:
+                return await func(*args, **kwargs)
+        return wrapper
+    return decorator
+
+
+# Utility function to get tracer from request
+def get_tracer(request: Request) -> RequestTracer:
+    """Get the current request tracer from the request state."""
+    return getattr(request.state, 'tracer', None)
+
+
+# Manual tracing function for custom steps
+async def trace_async_step(
+    request: Request, 
+    name: str, 
+    func: Callable, 
+    service: str = 'internal',
+    timeout: float = 30.0
+):
+    """
+    Manually trace an async function call.
+    
+    Usage:
+        result = await trace_async_step(
+            request, 
+            "External API call", 
+            lambda: external_api.call(), 
+            service="external"
+        )
+    """
+    tracer = get_tracer(request)
+    if not tracer:
+        return await func()
+    
+    step = tracer.step(name, service)
+    try:
+        result = await func()
+        return result
+    except Exception as e:
+        step.status = 'error'
+        step.error = str(e)
+        raise
+    finally:
+        step.end()