flow-debugger 1.0.0

package/dist/cjs/middleware/express.js

@@ -0,0 +1,255 @@
+"use strict";
+// ─────────────────────────────────────────────────────────────
+// flow-debugger — Express Middleware
+// Auto-traces every request, provides /__debugger API + dashboard
+// ─────────────────────────────────────────────────────────────
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flowDebugger = flowDebugger;
+const TraceEngine_1 = require("../core/TraceEngine");
+const Analytics_1 = require("../core/Analytics");
+const Sampler_1 = require("../core/Sampler");
+const types_1 = require("../core/types");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+// AsyncLocalStorage for automatic tracer context propagation
+let asyncLocalStorage;
+try {
+    const { AsyncLocalStorage } = require('async_hooks');
+    asyncLocalStorage = new AsyncLocalStorage();
+}
+catch (_) {
+    // Fallback for environments without async_hooks
+    asyncLocalStorage = 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
+ */
+function flowDebugger(config) {
+    const mergedConfig = { ...types_1.DEFAULT_CONFIG, ...config };
+    const engine = new TraceEngine_1.TraceEngine(mergedConfig);
+    const analytics = new Analytics_1.Analytics(mergedConfig.maxTraces);
+    const sampler = new Sampler_1.Sampler(mergedConfig.samplingRate, mergedConfig.alwaysSampleErrors);
+    // Current tracer per async context
+    let fallbackTracer = null;
+    const getTracer = () => {
+        if (asyncLocalStorage) {
+            try {
+                const store = asyncLocalStorage.getStore();
+                return store?.tracer || null;
+            }
+            catch (_) { }
+        }
+        return fallbackTracer;
+    };
+    const middleware = (req, res, next) => {
+        try {
+            // Skip debugger endpoints
+            if (req.path?.startsWith('/__debugger')) {
+                return handleDebuggerRoute(req, res, next, analytics, mergedConfig);
+            }
+            if (!mergedConfig.enabled)
+                return next();
+            // Sampling
+            if (!sampler.shouldSample())
+                return next();
+            const tracer = engine.startTrace(req.path || req.url, req.method);
+            req.tracer = tracer;
+            req.traceId = tracer.getTraceId();
+            // Set header for client correlation
+            res.setHeader('X-Trace-Id', tracer.getTraceId());
+            const run = () => {
+                fallbackTracer = tracer;
+                // Calculate payload size if body exists
+                let payloadSize;
+                try {
+                    if (req.body) {
+                        const bodyStr = JSON.stringify(req.body);
+                        payloadSize = Buffer.byteLength(bodyStr, 'utf8');
+                    }
+                }
+                catch (_) {
+                    // ignore
+                }
+                // Hook into response finish
+                const originalEnd = res.end;
+                res.end = function (...args) {
+                    try {
+                        const trace = tracer.end(res.statusCode);
+                        // Add environment and payload size to trace
+                        trace.environment = mergedConfig.environment;
+                        trace.payloadSize = payloadSize;
+                        analytics.record(trace);
+                        // If error and we had skipped sampling, re-sample
+                    }
+                    catch (_) {
+                        // never crash
+                    }
+                    fallbackTracer = null;
+                    return originalEnd.apply(res, args);
+                };
+                next();
+            };
+            // Use AsyncLocalStorage if available
+            if (asyncLocalStorage) {
+                asyncLocalStorage.run({ tracer }, run);
+            }
+            else {
+                run();
+            }
+        }
+        catch (_) {
+            // Production-safe: if debugger fails, pass through
+            next();
+        }
+    };
+    return { middleware, engine, analytics, getTracer };
+}
+/**
+ * Handle /__debugger routes
+ */
+function handleDebuggerRoute(req, res, next, analytics, config) {
+    if (!config.enableDashboard)
+        return next();
+    try {
+        const subPath = req.path.replace('/__debugger', '') || '/';
+        switch (subPath) {
+            case '/':
+            case '/api':
+                // JSON analytics API
+                res.json(analytics.getReport());
+                break;
+            case '/dashboard': {
+                // Serve the HTML dashboard
+                const dashboardPath = path.resolve(__dirname, '../../dashboard/index.html');
+                if (fs.existsSync(dashboardPath)) {
+                    res.sendFile(dashboardPath);
+                }
+                else {
+                    // Fallback: inline minimal dashboard
+                    res.send(getInlineDashboard());
+                }
+                break;
+            }
+            case '/dashboard/style.css': {
+                const cssPath = path.resolve(__dirname, '../../dashboard/style.css');
+                if (fs.existsSync(cssPath)) {
+                    res.type('text/css').sendFile(cssPath);
+                }
+                else {
+                    res.status(404).send('Not found');
+                }
+                break;
+            }
+            case '/dashboard/app.js': {
+                const jsPath = path.resolve(__dirname, '../../dashboard/app.js');
+                if (fs.existsSync(jsPath)) {
+                    res.type('application/javascript').sendFile(jsPath);
+                }
+                else {
+                    res.status(404).send('Not found');
+                }
+                break;
+            }
+            case '/health':
+                res.json(analytics.getHealthMonitor().getAllHealth());
+                break;
+            case '/endpoint': {
+                const endpoint = req.query?.path || req.query?.endpoint;
+                if (endpoint) {
+                    const report = analytics.getEndpointReport(String(endpoint));
+                    res.json(report || { error: 'Endpoint not found' });
+                }
+                else {
+                    res.json({ error: 'Provide ?path=/your/endpoint' });
+                }
+                break;
+            }
+            case '/search': {
+                const query = req.query?.q || req.query?.query;
+                const env = req.query?.env;
+                const limit = req.query?.limit ? parseInt(String(req.query.limit), 10) : 50;
+                if (query) {
+                    const results = analytics.searchTraces(String(query), { env: env ? String(env) : undefined, limit });
+                    res.json({ query, results, count: results.length });
+                }
+                else {
+                    res.json({ error: 'Provide ?q=search_term' });
+                }
+                break;
+            }
+            default:
+                next();
+        }
+    }
+    catch (err) {
+        res.status(500).json({ error: 'Debugger dashboard error' });
+    }
+}
+/** Inline fallback dashboard if files aren't found */
+function getInlineDashboard() {
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Flow Debugger Dashboard</title>
+  <style>body{font-family:system-ui;background:#0a0a1a;color:#e0e0e0;padding:20px}
+  h1{color:#7c3aed}.card{background:#1a1a2e;border-radius:12px;padding:20px;margin:10px 0;border:1px solid #2a2a4a}</style>
+</head>
+<body>
+  <h1>🔍 Flow Debugger</h1>
+  <p>Dashboard files not found. API available at <a href="/__debugger" style="color:#7c3aed">/__debugger</a></p>
+  <div class="card" id="data">Loading...</div>
+  <script>
+    fetch('/__debugger').then(r=>r.json()).then(d=>{
+      document.getElementById('data').innerHTML='<pre>'+JSON.stringify(d,null,2)+'</pre>';
+    });
+  </script>
+</body>
+</html>`;
+}
+//# sourceMappingURL=express.js.map

package/dist/cjs/middleware/express.js.map

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

package/dist/esm/core/Analytics.js

@@ -0,0 +1,170 @@
+// ─────────────────────────────────────────────────────────────
+// flow-debugger — Analytics Engine
+// Per-endpoint aggregation + service failure grouping
+// ─────────────────────────────────────────────────────────────
+import { HealthMonitor } from './HealthMonitor';
+export class Analytics {
+    constructor(maxTraces = 1000) {
+        this.traces = [];
+        this.maxTraces = maxTraces;
+        this.startTime = new Date();
+        this.healthMonitor = new HealthMonitor();
+    }
+    /** Record a completed trace */
+    record(trace) {
+        try {
+            this.traces.push(trace);
+            // Trim if over limit (keep most recent)
+            if (this.traces.length > this.maxTraces) {
+                this.traces = this.traces.slice(-this.maxTraces);
+            }
+            // Update health monitor with step results
+            for (const step of trace.steps) {
+                this.healthMonitor.recordStep(step);
+            }
+        }
+        catch (_) {
+            // never crash
+        }
+    }
+    /** Get full analytics report */
+    getReport() {
+        const endpoints = this.getEndpointStats();
+        const totalRequests = this.traces.length;
+        const totalErrors = this.traces.filter(t => t.classification === 'ERROR' || t.classification === 'CRITICAL').length;
+        const totalSlow = this.traces.filter(t => t.classification === 'WARN').length;
+        const uptime = Date.now() - this.startTime.getTime();
+        return {
+            totalRequests,
+            totalErrors,
+            totalSlow,
+            uptime,
+            endpoints,
+            serviceHealth: this.healthMonitor.getAllHealth(),
+            topFailures: this.getTopFailures(),
+            recentTraces: this.traces.slice(-20).reverse(),
+        };
+    }
+    /** Get stats for a specific endpoint */
+    getEndpointReport(path) {
+        const stats = this.getEndpointStats();
+        return stats.find(s => s.path === path) || null;
+    }
+    /** Get aggregated stats per endpoint */
+    getEndpointStats() {
+        const grouped = new Map();
+        for (const trace of this.traces) {
+            const key = `${trace.method}:${trace.endpoint}`;
+            if (!grouped.has(key))
+                grouped.set(key, []);
+            grouped.get(key).push(trace);
+        }
+        const stats = [];
+        for (const [key, traces] of grouped) {
+            const [method, path] = key.split(':');
+            const durations = traces.map(t => t.totalDuration).sort((a, b) => a - b);
+            const errorCount = traces.filter(t => t.classification === 'ERROR' || t.classification === 'CRITICAL').length;
+            const slowCount = traces.filter(t => t.classification === 'WARN').length;
+            // Common issues
+            const issues = new Map();
+            for (const t of traces) {
+                if (t.rootCause) {
+                    const key = t.rootCause.cause;
+                    issues.set(key, (issues.get(key) || 0) + 1);
+                }
+            }
+            const commonIssues = [...issues.entries()]
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, 5)
+                .map(([issue, count]) => `${issue} (${count}x)`);
+            // Service failure breakdown
+            const serviceFailures = this.getServiceFailures(traces);
+            stats.push({
+                path,
+                method,
+                totalRequests: traces.length,
+                errorCount,
+                slowCount,
+                avgDuration: durations.reduce((a, b) => a + b, 0) / durations.length,
+                p95Duration: durations[Math.floor(durations.length * 0.95)] || 0,
+                maxDuration: durations[durations.length - 1] || 0,
+                commonIssues,
+                serviceFailures,
+                recentTraces: traces.slice(-5).reverse(),
+            });
+        }
+        return stats.sort((a, b) => b.totalRequests - a.totalRequests);
+    }
+    /** Get service failure breakdown across all traces */
+    getTopFailures() {
+        return this.getServiceFailures(this.traces);
+    }
+    /** Calculate service failure stats from a set of traces */
+    getServiceFailures(traces) {
+        const failures = new Map();
+        let totalFailures = 0;
+        for (const trace of traces) {
+            for (const step of trace.steps) {
+                if (step.status === 'error' || step.status === 'timeout') {
+                    failures.set(step.service, (failures.get(step.service) || 0) + 1);
+                    totalFailures++;
+                }
+            }
+        }
+        return [...failures.entries()]
+            .map(([service, count]) => ({
+            service,
+            count,
+            percentage: totalFailures > 0 ? Math.round((count / totalFailures) * 100) : 0,
+        }))
+            .sort((a, b) => b.count - a.count);
+    }
+    /** Clear all stored traces */
+    clear() {
+        this.traces = [];
+    }
+    /** Get raw trace count */
+    getTraceCount() {
+        return this.traces.length;
+    }
+    /**
+     * Search traces by traceId, endpoint, or error message.
+     * Returns matching traces sorted by most recent first.
+     */
+    searchTraces(query, options) {
+        if (!query)
+            return [];
+        const lowerQuery = query.toLowerCase();
+        const limit = options?.limit || 50;
+        const matches = this.traces.filter(trace => {
+            // Filter by environment if specified
+            if (options?.env && trace.environment !== options.env) {
+                return false;
+            }
+            // Match traceId
+            if (trace.traceId.toLowerCase().includes(lowerQuery)) {
+                return true;
+            }
+            // Match endpoint
+            if (trace.endpoint.toLowerCase().includes(lowerQuery)) {
+                return true;
+            }
+            // Match error message in steps
+            for (const step of trace.steps) {
+                if (step.error && step.error.toLowerCase().includes(lowerQuery)) {
+                    return true;
+                }
+            }
+            // Match root cause
+            if (trace.rootCause && trace.rootCause.cause.toLowerCase().includes(lowerQuery)) {
+                return true;
+            }
+            return false;
+        });
+        return matches.slice(-limit).reverse();
+    }
+    getHealthMonitor() {
+        return this.healthMonitor;
+    }
+}
+//# sourceMappingURL=Analytics.js.map

package/dist/esm/core/Analytics.js.map

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

package/dist/esm/core/Classifier.js

@@ -0,0 +1,61 @@
+// ─────────────────────────────────────────────────────────────
+// flow-debugger — Classifier
+// Classifies steps and traces into severity levels
+// ─────────────────────────────────────────────────────────────
+/**
+ * Classify a single step based on its duration and status.
+ *
+ *  INFO     → normal, <slowThreshold ms
+ *  WARN     → slow (>slowThreshold ms)
+ *  ERROR    → step failed
+ *  CRITICAL → dependency down / timeout
+ */
+export function classify(duration, status, config) {
+    const threshold = config.slowThreshold ?? 300;
+    if (status === 'timeout')
+        return 'CRITICAL';
+    if (status === 'error')
+        return 'ERROR';
+    if (duration > threshold)
+        return 'WARN';
+    return 'INFO';
+}
+/**
+ * Classify an entire trace based on its steps.
+ * The trace gets the highest severity from any of its steps.
+ */
+export function classifyTrace(steps, _totalDuration, config) {
+    const threshold = config.slowThreshold ?? 300;
+    let maxLevel = 'INFO';
+    const priority = {
+        INFO: 0,
+        WARN: 1,
+        ERROR: 2,
+        CRITICAL: 3,
+    };
+    for (const step of steps) {
+        if (priority[step.classification] > priority[maxLevel]) {
+            maxLevel = step.classification;
+        }
+    }
+    // Also check total duration
+    if (maxLevel === 'INFO' && _totalDuration > threshold) {
+        maxLevel = 'WARN';
+    }
+    return maxLevel;
+}
+/**
+ * Classify a database query specifically — used by integrations
+ * to detect slow queries with a dedicated threshold.
+ */
+export function classifyQuery(duration, status, config) {
+    const threshold = config.slowQueryThreshold ?? 300;
+    if (status === 'timeout')
+        return 'CRITICAL';
+    if (status === 'error')
+        return 'ERROR';
+    if (duration > threshold)
+        return 'WARN';
+    return 'INFO';
+}
+//# sourceMappingURL=Classifier.js.map

package/dist/esm/core/Classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Classifier.js","sourceRoot":"","sources":["../../../src/core/Classifier.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,6BAA6B;AAC7B,mDAAmD;AACnD,gEAAgE;AAShE;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CACpB,QAAgB,EAChB,MAAkB,EAClB,MAA6C;IAE7C,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,IAAI,GAAG,CAAC;IAE9C,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IAC5C,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IACvC,IAAI,QAAQ,GAAG,SAAS;QAAE,OAAO,MAAM,CAAC;IACxC,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CACzB,KAAkB,EAClB,cAAsB,EACtB,MAA6C;IAE7C,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,IAAI,GAAG,CAAC;IAC9C,IAAI,QAAQ,GAAwB,MAAM,CAAC;IAE3C,MAAM,QAAQ,GAAwC;QAClD,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,CAAC;KACd,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrD,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC;QACnC,CAAC;IACL,CAAC;IAED,4BAA4B;IAC5B,IAAI,QAAQ,KAAK,MAAM,IAAI,cAAc,GAAG,SAAS,EAAE,CAAC;QACpD,QAAQ,GAAG,MAAM,CAAC;IACtB,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CACzB,QAAgB,EAChB,MAAkB,EAClB,MAAkD;IAElD,MAAM,SAAS,GAAG,MAAM,CAAC,kBAAkB,IAAI,GAAG,CAAC;IAEnD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IAC5C,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IACvC,IAAI,QAAQ,GAAG,SAAS;QAAE,OAAO,MAAM,CAAC;IACxC,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/esm/core/HealthMonitor.js

@@ -0,0 +1,75 @@
+// ─────────────────────────────────────────────────────────────
+// flow-debugger — Health Monitor
+// Tracks dependency health from step results
+// ─────────────────────────────────────────────────────────────
+export class HealthMonitor {
+    constructor() {
+        this.records = new Map();
+    }
+    /** Record a step result to update health tracking */
+    recordStep(step) {
+        try {
+            const key = step.service;
+            if (key === 'internal' || key === 'unknown')
+                return;
+            if (!this.records.has(key)) {
+                this.records.set(key, {
+                    service: step.service,
+                    name: key,
+                    successes: 0,
+                    failures: 0,
+                    lastCheck: new Date(),
+                });
+            }
+            const record = this.records.get(key);
+            record.lastCheck = new Date();
+            if (step.status === 'success') {
+                record.successes++;
+            }
+            else {
+                record.failures++;
+            }
+        }
+        catch (_) {
+            // never crash
+        }
+    }
+    /** Get health status for a specific service */
+    getHealth(service) {
+        const record = this.records.get(service);
+        if (!record)
+            return null;
+        return this.toHealthStatus(record);
+    }
+    /** Get health status for all tracked services */
+    getAllHealth() {
+        return [...this.records.values()].map(r => this.toHealthStatus(r));
+    }
+    toHealthStatus(record) {
+        const total = record.successes + record.failures;
+        const successRate = total > 0 ? record.successes / total : 1;
+        let status;
+        if (successRate >= 0.95) {
+            status = 'healthy';
+        }
+        else if (successRate >= 0.7) {
+            status = 'degraded';
+        }
+        else {
+            status = 'down';
+        }
+        return {
+            service: record.service,
+            name: record.name,
+            status,
+            lastCheck: record.lastCheck,
+            successRate: Math.round(successRate * 100),
+            totalChecks: total,
+        };
+    }
+    /** Reset all health records */
+    reset() {
+        this.records.clear();
+    }
+}
+//# sourceMappingURL=HealthMonitor.js.map

package/dist/esm/core/HealthMonitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthMonitor.js","sourceRoot":"","sources":["../../../src/core/HealthMonitor.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,iCAAiC;AACjC,6CAA6C;AAC7C,gEAAgE;AAiBhE,MAAM,OAAO,aAAa;IAA1B;QACY,YAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAsEtD,CAAC;IApEG,qDAAqD;IACrD,UAAU,CAAC,IAAe;QACtB,IAAI,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;YACzB,IAAI,GAAG,KAAK,UAAU,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO;YAEpD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE;oBAClB,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,IAAI,EAAE,GAAG;oBACT,SAAS,EAAE,CAAC;oBACZ,QAAQ,EAAE,CAAC;oBACX,SAAS,EAAE,IAAI,IAAI,EAAE;iBACxB,CAAC,CAAC;YACP,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;YACtC,MAAM,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;YAE9B,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC5B,MAAM,CAAC,SAAS,EAAE,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACJ,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtB,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,cAAc;QAClB,CAAC;IACL,CAAC;IAED,+CAA+C;IAC/C,SAAS,CAAC,OAAmB;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,iDAAiD;IACjD,YAAY;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;IAEO,cAAc,CAAC,MAAoB;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC;QACjD,MAAM,WAAW,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAE7D,IAAI,MAAmB,CAAC;QACxB,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;YACtB,MAAM,GAAG,SAAS,CAAC;QACvB,CAAC;aAAM,IAAI,WAAW,IAAI,GAAG,EAAE,CAAC;YAC5B,MAAM,GAAG,UAAU,CAAC;QACxB,CAAC;aAAM,CAAC;YACJ,MAAM,GAAG,MAAM,CAAC;QACpB,CAAC;QAED,OAAO;YACH,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,MAAM;YACN,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC;YAC1C,WAAW,EAAE,KAAK;SACrB,CAAC;IACN,CAAC;IAED,+BAA+B;IAC/B,KAAK;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACJ"}