flow-debugger 1.1.0 → 1.3.0

package/README.md

@@ -6,6 +6,19 @@ Traces requests step-by-step, measures timing, classifies errors, detects root c
 
 ---
 
+![Flow Debugger Dashboard](https://raw.githubusercontent.com/sannuk79/debugerpackages/main/portfolio-repo/flowdebuger.png)
+
+## 🚀 Easy 3-Line Setup (Beginner Friendly)
+Beginners can get a professional dashboard and request tracing with just **3 lines of code**:
+
+```typescript
+const debug = flowDebugger({ enableDashboard: true }); // 1. Init
+app.use(debug.middleware);                             // 2. Middleware
+mongoTracer(mongoose, { getTracer: debug.getTracer }); // 3. Auto-Trace
+```
+
+---
+
 ## ✨ Features
 
 - **Request Tracing** — Every request gets a unique `traceId` with step-by-step timing

package/assets/DASHBOARD.png

@@ -0,0 +1 @@
+[image_data_placeholder]

package/dashboard/app.js

@@ -35,7 +35,14 @@ async function refreshData() {
     const res = await fetch(API_URL);
     if (!res.ok) throw new Error('API error');
     const data = await res.json();
-    renderDashboard(data);
+
+    // Seed sample data if empty for a better first-look experience
+    if (!data.totalRequests || data.totalRequests === 0) {
+      const seededData = seedSampleData(data);
+      renderDashboard(seededData);
+    } else {
+      renderDashboard(data);
+    }
   } catch (err) {
     document.getElementById('statusBadge').textContent = '● OFFLINE';
     document.getElementById('statusBadge').className = 'badge badge-offline';
@@ -349,3 +356,37 @@ function formatDuration(ms) {
   const hrs = Math.floor(mins / 60);
   return hrs + 'h ' + (mins % 60) + 'm';
 }
+
+function seedSampleData(data) {
+  return {
+    ...data,
+    uptime: 124000,
+    totalRequests: 1,
+    totalErrors: 0,
+    totalSlow: 0,
+    serviceHealth: [
+      { name: 'mongo', status: 'healthy', successRate: 100, totalChecks: 12 },
+      { name: 'redis', status: 'degraded', successRate: 92, totalChecks: 45 },
+      { name: 'postgres', status: 'healthy', successRate: 100, totalChecks: 5 }
+    ],
+    endpoints: [
+      { method: 'GET', path: '/api/users', totalRequests: 1, errorCount: 0, slowCount: 0, avgDuration: 42, p95Duration: 42, maxDuration: 42, commonIssues: [] }
+    ],
+    recentTraces: [
+      {
+        traceId: 'sample_trace_123',
+        endpoint: '/api/users',
+        method: 'GET',
+        totalDuration: 156,
+        classification: 'INFO',
+        language: 'node',
+        steps: [
+          { name: 'Auth Check', service: 'internal', status: 'success', classification: 'INFO', startTime: 2, endTime: 12, duration: 10, offset: 2 },
+          { name: 'DB Find User', service: 'mongo', status: 'success', classification: 'INFO', startTime: 15, endTime: 145, duration: 130, offset: 15 },
+          { name: 'Redis Cache', service: 'redis', status: 'success', classification: 'INFO', startTime: 148, endTime: 155, duration: 7, offset: 148 }
+        ]
+      }
+    ]
+  };
+}
+

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "flow-debugger",
-    "version": "1.1.0",
+    "version": "1.3.0",
     "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",
@@ -64,9 +64,9 @@
     ],
     "repository": {
         "type": "git",
-        "url": "https://github.com/sannuk79/debugerpackages.git"
+        "url": "https://github.com/sannuk79/PROJECTS-AND-NPM-PACKAGES-"
     },
-    "homepage": "https://github.com/sannuk79/debugerpackages#readme",
+    "homepage": "https://github.com/sannuk79/PROJECTS-AND-NPM-PACKAGES-",
     "bugs": {
         "url": "https://github.com/sannuk79/debugerpackages/issues"
     },