synapsexcoder 6.0.0

package/dist/profiler/memory-profiler.js

@@ -0,0 +1,211 @@
+/**
+ * Memory Profiler — Memory usage tracking and leak detection
+ *
+ * Phase 12: Performance Profiling — Collects memory snapshots, detects
+ * growth patterns, identifies leak suspects, and tracks allocation hotspots.
+ */
+import { performance } from "node:perf_hooks";
+// Use v8 for heap statistics
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const v8 = null; // Disabled binding for compatibility
+let v8Module = null;
+try {
+    // Dynamic import to avoid crash in non-Node environments
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    v8Module = require("node:v8");
+}
+catch {
+    // Not in Node.js environment
+}
+import { calculateRiskLevel } from "./profiler-types.js";
+// ============================================================================
+// MemoryProfiler
+// ============================================================================
+export class MemoryProfiler {
+    snapshots = [];
+    leakSuspects = [];
+    allocationHotspots = [];
+    options;
+    startTime = 0;
+    isRunning = false;
+    sampleIntervalId = null;
+    previousSnapshot = null;
+    growthRate = 0;
+    gcEvents = 0;
+    constructor(options) {
+        this.options = {
+            sampleIntervalMs: 500,
+            maxSnapshots: 200,
+            growthThresholdMbPerSec: 2,
+            leakDetectionWindowMs: 10000,
+            ...options,
+        };
+    }
+    // ========================================================================
+    // Lifecycle
+    // ========================================================================
+    start() {
+        this.startTime = performance.now();
+        this.isRunning = true;
+        this.snapshots.length = 0;
+        this.leakSuspects.length = 0;
+        this.allocationHotspots.length = 0;
+        this.previousSnapshot = null;
+        this.growthRate = 0;
+        this.gcEvents = 0;
+        // Take initial snapshot
+        this.takeSnapshot();
+        // Start periodic sampling
+        this.sampleIntervalId = setInterval(() => {
+            this.takeSnapshot();
+        }, this.options.sampleIntervalMs);
+    }
+    stop() {
+        this.isRunning = false;
+        if (this.sampleIntervalId) {
+            clearInterval(this.sampleIntervalId);
+            this.sampleIntervalId = null;
+        }
+        // Take final snapshot
+        this.takeSnapshot();
+        this.detectLeaks();
+        return this.getResult();
+    }
+    get isActive() {
+        return this.isRunning;
+    }
+    // ========================================================================
+    // Snapshot Collection
+    // ========================================================================
+    takeSnapshot() {
+        const usage = process.memoryUsage();
+        const snapshot = {
+            timestamp: performance.now(),
+            heapUsed: usage.heapUsed,
+            heapTotal: usage.heapTotal,
+            external: usage.external,
+            arrayBuffers: usage.arrayBuffers,
+            rss: usage.rss,
+        };
+        this.snapshots.push(snapshot);
+        // Enforce max snapshots
+        if (this.snapshots.length > this.options.maxSnapshots) {
+            this.snapshots.splice(0, this.snapshots.length - this.options.maxSnapshots);
+        }
+        // Detect GC events (heapUsed drops significantly)
+        if (this.previousSnapshot) {
+            const dropBytes = this.previousSnapshot.heapUsed - snapshot.heapUsed;
+            if (dropBytes > 5 * 1024 * 1024) {
+                // Drop > 5MB = likely GC
+                this.gcEvents++;
+            }
+        }
+        this.previousSnapshot = snapshot;
+        return snapshot;
+    }
+    /**
+     * Record an allocation hotspot detected by external analysis.
+     */
+    recordAllocationHotspot(fn, location, percentAllocations, allocationCount, suggestion) {
+        this.allocationHotspots.push({
+            function: fn,
+            location,
+            percentAllocations: Math.min(100, percentAllocations),
+            allocationCount,
+            suggestion,
+        });
+    }
+    /**
+     * Add a memory leak suspect.
+     */
+    addLeakSuspect(pattern, description, confidence, location, suggestion) {
+        this.leakSuspects.push({
+            pattern,
+            description,
+            confidence: Math.min(1, Math.max(0, confidence)),
+            location,
+            suggestion: suggestion ?? `Investigate "${pattern}" pattern for proper cleanup`,
+        });
+    }
+    // ========================================================================
+    // Leak Detection
+    // ========================================================================
+    detectLeaks() {
+        if (this.snapshots.length < 3)
+            return;
+        // Analyze growth over time
+        const midIndex = Math.floor(this.snapshots.length / 2);
+        const firstHalf = this.snapshots.slice(0, midIndex);
+        const secondHalf = this.snapshots.slice(midIndex);
+        const firstAvg = firstHalf.reduce((s, n) => s + n.heapUsed, 0) / firstHalf.length;
+        const secondAvg = secondHalf.reduce((s, n) => s + n.heapUsed, 0) / secondHalf.length;
+        const growthBytes = secondAvg - firstAvg;
+        const durationSec = (this.snapshots[this.snapshots.length - 1].timestamp -
+            this.snapshots[0].timestamp) / 1000;
+        this.growthRate = durationSec > 0 ? (growthBytes / (1024 * 1024)) / durationSec : 0;
+        // Monotonically increasing heap = leak suspect
+        let increasingCount = 0;
+        for (let i = 1; i < this.snapshots.length; i++) {
+            if (this.snapshots[i].heapUsed > this.snapshots[i - 1].heapUsed) {
+                increasingCount++;
+            }
+        }
+        const increaseRatio = increasingCount / this.snapshots.length;
+        if (increaseRatio > 0.8 && this.growthRate > this.options.growthThresholdMbPerSec) {
+            this.leakSuspects.push({
+                pattern: "monotonically_increasing_heap",
+                description: `Heap grew continuously (${increaseRatio * 100}% of samples increasing) at ${this.growthRate.toFixed(2)} MB/s`,
+                confidence: Math.min(0.9, 0.5 + (this.growthRate / 10)),
+                suggestion: "Use heap snapshots to identify retained objects. Check for event listeners, timers, closures, and cache without eviction.",
+            });
+        }
+        // High RSS relative to heap = external leak
+        const rssSnapshots = this.snapshots.filter((s) => s.rss !== undefined);
+        if (rssSnapshots.length > 2) {
+            const avgRssMb = rssSnapshots.reduce((s, n) => s + (n.rss || 0), 0) / rssSnapshots.length / (1024 * 1024);
+            const avgHeapMb = rssSnapshots.reduce((s, n) => s + n.heapUsed, 0) / rssSnapshots.length / (1024 * 1024);
+            if (avgRssMb > avgHeapMb * 3) {
+                this.leakSuspects.push({
+                    pattern: "high_rss_to_heap_ratio",
+                    description: `RSS (${avgRssMb.toFixed(1)}MB) is ${(avgRssMb / avgHeapMb).toFixed(1)}x heap used (${avgHeapMb.toFixed(1)}MB)`,
+                    confidence: 0.6,
+                    suggestion: "Check for native bindings, large Buffers, or child processes leaking memory outside V8 heap.",
+                });
+            }
+        }
+        // Large array buffers
+        const avgArrayBuffers = this.snapshots.reduce((s, n) => s + n.arrayBuffers, 0) / this.snapshots.length;
+        if (avgArrayBuffers > 100 * 1024 * 1024) {
+            this.leakSuspects.push({
+                pattern: "large_array_buffers",
+                description: `Average ArrayBuffer size: ${(avgArrayBuffers / (1024 * 1024)).toFixed(1)}MB`,
+                confidence: 0.5,
+                suggestion: "Ensure ArrayBuffers are recycled or freed. Use pool allocation for frequent buffer operations.",
+            });
+        }
+    }
+    // ========================================================================
+    // Result
+    // ========================================================================
+    getResult() {
+        const heapUsages = this.snapshots.map((s) => s.heapUsed);
+        const heapUsedMb = (b) => Math.round((b / (1024 * 1024)) * 100) / 100;
+        const peakHeap = heapUsages.length > 0 ? Math.max(...heapUsages) : 0;
+        const minHeap = heapUsages.length > 0 ? Math.min(...heapUsages) : 0;
+        const avgHeap = heapUsages.length > 0
+            ? heapUsages.reduce((s, n) => s + n, 0) / heapUsages.length
+            : 0;
+        return {
+            snapshots: [...this.snapshots],
+            leakSuspects: [...this.leakSuspects],
+            peakHeapUsedMb: heapUsedMb(peakHeap),
+            averageHeapUsedMb: heapUsedMb(avgHeap),
+            minHeapUsedMb: heapUsedMb(minHeap),
+            growthRateMbPerSec: Math.round(this.growthRate * 100) / 100,
+            totalGcEvents: this.gcEvents,
+            allocationHotspots: [...this.allocationHotspots],
+            riskLevel: calculateRiskLevel(heapUsedMb(peakHeap), this.growthRate, this.leakSuspects.length),
+        };
+    }
+}
+//# sourceMappingURL=memory-profiler.js.map

package/dist/profiler/memory-profiler.js.map

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

package/dist/profiler/profiler-types.d.ts

@@ -0,0 +1,234 @@
+/**
+ * Profiler Types — Core type definitions for performance profiling
+ *
+ * Phase 12: Performance Profiling — Integrated profiler for measuring
+ * CPU, memory, query, and rendering performance across the system.
+ */
+export interface ProfilerConfig {
+    /** Sample interval in ms (default: 100) */
+    sampleIntervalMs?: number;
+    /** Maximum profiling duration in ms (default: 30000) */
+    maxDurationMs?: number;
+    /** Maximum number of samples to collect (default: 1000) */
+    maxSamples?: number;
+    /** Include memory tracking (default: true) */
+    trackMemory?: boolean;
+    /** Include async operations tracking (default: true) */
+    trackAsync?: boolean;
+    /** Paths to include (glob patterns) */
+    includePaths?: string[];
+    /** Paths to exclude (glob patterns) */
+    excludePaths?: string[];
+}
+export interface ProfileResult {
+    /** Unique profile session ID */
+    sessionId: string;
+    /** When profiling started */
+    startTime: number;
+    /** When profiling ended */
+    endTime: number;
+    /** Duration in ms */
+    duration: number;
+    /** Configuration used */
+    config: Required<ProfilerConfig>;
+    /** CPU profile data */
+    cpu: CpuProfileResult;
+    /** Memory profile data */
+    memory: MemoryProfileResult;
+    /** Query profile data */
+    queries: QueryProfileResult;
+    /** Timeline of events */
+    timeline: TimelineEntry[];
+    /** Summary recommendations */
+    recommendations: string[];
+}
+export interface CpuProfileResult {
+    /** Total functions profiled */
+    totalFunctions: number;
+    /** Total async operations tracked */
+    totalAsyncOps: number;
+    /** Total sync operations tracked */
+    totalSyncOps: number;
+    /** Slowest functions (sorted) */
+    slowestFunctions: ProfiledFunction[];
+    /** Functions with most calls */
+    mostCalled: ProfiledFunction[];
+    /** Async waterfall entries */
+    asyncWaterfall: AsyncProfileEntry[];
+    /** Blocking operations detected */
+    blockingOps: BlockingOperation[];
+    /** Average execution time in ms */
+    averageTimeMs: number;
+    /** Peak execution time in ms */
+    peakTimeMs: number;
+}
+export interface ProfiledFunction {
+    name: string;
+    /** File location */
+    location?: string;
+    /** Number of times called */
+    callCount: number;
+    /** Total execution time in ms */
+    totalTimeMs: number;
+    /** Average execution time in ms */
+    averageTimeMs: number;
+    /** Minimum execution time in ms */
+    minTimeMs: number;
+    /** Maximum execution time in ms */
+    maxTimeMs: number;
+    /** Whether the function is async */
+    isAsync: boolean;
+    /** Stack trace samples */
+    samples?: number;
+}
+export interface AsyncProfileEntry {
+    operation: string;
+    /** Start time epoch ms */
+    startTime: number;
+    /** Duration in ms */
+    duration: number;
+    /** Status */
+    status: "pending" | "resolved" | "rejected";
+    /** Parent async operation if any */
+    parentOperation?: string;
+    /** Line/file location */
+    location?: string;
+}
+export interface BlockingOperation {
+    type: "sync_io" | "long_loop" | "heavy_compute" | "blocking_wait";
+    /** Description of the operation */
+    description: string;
+    /** Duration in ms */
+    durationMs: number;
+    /** Threshold exceeded */
+    thresholdMs: number;
+    /** Location */
+    location?: string;
+    /** Suggestion for improvement */
+    suggestion: string;
+}
+export interface MemoryProfileResult {
+    /** Memory snapshot timeline */
+    snapshots: MemorySnapshot[];
+    /** Memory leak suspects */
+    leakSuspects: MemoryLeakSuspect[];
+    /** Peak memory usage in MB */
+    peakHeapUsedMb: number;
+    /** Average memory usage in MB */
+    averageHeapUsedMb: number;
+    /** Min memory usage in MB */
+    minHeapUsedMb: number;
+    /** Memory growth rate (MB/s) */
+    growthRateMbPerSec: number;
+    /** Total garbage collections observed */
+    totalGcEvents: number;
+    /** Detected allocation hotspots */
+    allocationHotspots: AllocationHotspot[];
+    /** Risk level */
+    riskLevel: "low" | "medium" | "high" | "critical";
+}
+export interface MemorySnapshot {
+    timestamp: number;
+    /** Heap used in bytes */
+    heapUsed: number;
+    /** Heap total in bytes */
+    heapTotal: number;
+    /** External memory in bytes */
+    external: number;
+    /** Array buffers in bytes */
+    arrayBuffers: number;
+    /** RSS in bytes */
+    rss?: number;
+}
+export interface MemoryLeakSuspect {
+    /** Pattern that suggests a leak */
+    pattern: string;
+    /** Description of the suspected leak */
+    description: string;
+    /** Confidence level 0-1 */
+    confidence: number;
+    /** Affected area */
+    location?: string;
+    /** Suggestion */
+    suggestion: string;
+}
+export interface AllocationHotspot {
+    function: string;
+    location: string;
+    /** Percentage of total allocations */
+    percentAllocations: number;
+    /** Number of allocation events */
+    allocationCount: number;
+    /** Suggested optimization */
+    suggestion: string;
+}
+export interface QueryProfileResult {
+    totalQueries: number;
+    slowestQueries: SlowQuery[];
+    nPlusOneDetections: NPlusOneDetection[];
+    duplicateDetections: DuplicateQuery[];
+    cacheMisses: number;
+    averageQueryTimeMs: number;
+    totalQueryTimeMs: number;
+    recommendations: string[];
+}
+export interface SlowQuery {
+    /** Query fingerprint (normalized form) */
+    fingerprint: string;
+    /** Raw query text */
+    query: string;
+    /** Execution time in ms */
+    executionTimeMs: number;
+    /** Number of times executed */
+    executionCount: number;
+    /** Source file location */
+    location?: string;
+    /** Suggested index or optimization */
+    suggestion: string;
+    /** Whether a covering index would help */
+    needsIndex: boolean;
+}
+export interface NPlusOneDetection {
+    /** The parent query */
+    parentQuery: string;
+    /** The repeated child query */
+    childQuery: string;
+    /** Number of repeated executions */
+    repeatCount: number;
+    /** Total time wasted in ms */
+    wastedTimeMs: number;
+    /** Location */
+    location?: string;
+    /** Suggestion (batch/join/eager load) */
+    suggestion: string;
+}
+export interface DuplicateQuery {
+    /** Query fingerprint */
+    fingerprint: string;
+    /** Number of identical executions */
+    executionCount: number;
+    /** Total wasted time (all but first) */
+    wastedTimeMs: number;
+    /** Location */
+    location?: string;
+}
+export interface TimelineEntry {
+    timestamp: number;
+    type: "cpu_sample" | "memory_sample" | "async_start" | "async_end" | "gc_event" | "query" | "allocation" | "custom";
+    label: string;
+    duration?: number;
+    data?: Record<string, unknown>;
+}
+export type ReportFormat = "json" | "markdown" | "html";
+export interface ExportOptions {
+    format: ReportFormat;
+    includeTimeline?: boolean;
+    includeAllFunctions?: boolean;
+    maxFunctions?: number;
+    title?: string;
+    colorScheme?: "light" | "dark";
+}
+export declare function createDefaultProfilerConfig(): Required<ProfilerConfig>;
+export declare function calculateRiskLevel(peakMb: number, growthRate: number, leakSuspects: number): MemoryProfileResult["riskLevel"];
+export declare function createEmptyProfileResult(config?: ProfilerConfig): ProfileResult;
+//# sourceMappingURL=profiler-types.d.ts.map

package/dist/profiler/profiler-types.d.ts.map

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

package/dist/profiler/profiler-types.js

@@ -0,0 +1,89 @@
+/**
+ * Profiler Types — Core type definitions for performance profiling
+ *
+ * Phase 12: Performance Profiling — Integrated profiler for measuring
+ * CPU, memory, query, and rendering performance across the system.
+ */
+// ============================================================================
+// Helpers
+// ============================================================================
+export function createDefaultProfilerConfig() {
+    return {
+        sampleIntervalMs: 100,
+        maxDurationMs: 30000,
+        maxSamples: 1000,
+        trackMemory: true,
+        trackAsync: true,
+        includePaths: ["src/**/*.ts"],
+        excludePaths: ["node_modules/**", "dist/**", ".git/**"],
+    };
+}
+export function calculateRiskLevel(peakMb, growthRate, leakSuspects) {
+    let score = 0;
+    if (peakMb > 500)
+        score += 2;
+    else if (peakMb > 200)
+        score += 1;
+    if (growthRate > 10)
+        score += 3;
+    else if (growthRate > 5)
+        score += 2;
+    else if (growthRate > 1)
+        score += 1;
+    if (leakSuspects > 3)
+        score += 3;
+    else if (leakSuspects > 1)
+        score += 1;
+    if (score >= 6)
+        return "critical";
+    if (score >= 4)
+        return "high";
+    if (score >= 2)
+        return "medium";
+    return "low";
+}
+export function createEmptyProfileResult(config) {
+    const cfg = config ? { ...createDefaultProfilerConfig(), ...config } : createDefaultProfilerConfig();
+    return {
+        sessionId: `profile_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+        startTime: 0,
+        endTime: 0,
+        duration: 0,
+        config: cfg,
+        cpu: {
+            totalFunctions: 0,
+            totalAsyncOps: 0,
+            totalSyncOps: 0,
+            slowestFunctions: [],
+            mostCalled: [],
+            asyncWaterfall: [],
+            blockingOps: [],
+            averageTimeMs: 0,
+            peakTimeMs: 0,
+        },
+        memory: {
+            snapshots: [],
+            leakSuspects: [],
+            peakHeapUsedMb: 0,
+            averageHeapUsedMb: 0,
+            minHeapUsedMb: 0,
+            growthRateMbPerSec: 0,
+            totalGcEvents: 0,
+            allocationHotspots: [],
+            riskLevel: "low",
+        },
+        queries: {
+            totalQueries: 0,
+            slowestQueries: [],
+            nPlusOneDetections: [],
+            duplicateDetections: [],
+            cacheMisses: 0,
+            averageQueryTimeMs: 0,
+            totalQueryTimeMs: 0,
+            recommendations: [],
+        },
+        timeline: [],
+        recommendations: [],
+    };
+}
+//# sourceMappingURL=profiler-types.js.map

package/dist/profiler/profiler-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler-types.js","sourceRoot":"","sources":["../../src/profiler/profiler-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuRH,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,UAAU,2BAA2B;IACzC,OAAO;QACL,gBAAgB,EAAE,GAAG;QACrB,aAAa,EAAE,KAAK;QACpB,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,IAAI;QACjB,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,CAAC,aAAa,CAAC;QAC7B,YAAY,EAAE,CAAC,iBAAiB,EAAE,SAAS,EAAE,SAAS,CAAC;KACxD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,MAAc,EACd,UAAkB,EAClB,YAAoB;IAEpB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,MAAM,GAAG,GAAG;QAAE,KAAK,IAAI,CAAC,CAAC;SACxB,IAAI,MAAM,GAAG,GAAG;QAAE,KAAK,IAAI,CAAC,CAAC;IAClC,IAAI,UAAU,GAAG,EAAE;QAAE,KAAK,IAAI,CAAC,CAAC;SAC3B,IAAI,UAAU,GAAG,CAAC;QAAE,KAAK,IAAI,CAAC,CAAC;SAC/B,IAAI,UAAU,GAAG,CAAC;QAAE,KAAK,IAAI,CAAC,CAAC;IACpC,IAAI,YAAY,GAAG,CAAC;QAAE,KAAK,IAAI,CAAC,CAAC;SAC5B,IAAI,YAAY,GAAG,CAAC;QAAE,KAAK,IAAI,CAAC,CAAC;IACtC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,UAAU,CAAC;IAClC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IAC9B,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IAChC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAuB;IAC9D,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,2BAA2B,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,2BAA2B,EAAE,CAAC;IACrG,OAAO;QACL,SAAS,EAAE,WAAW,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;QAC5E,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,CAAC;QACX,MAAM,EAAE,GAAG;QACX,GAAG,EAAE;YACH,cAAc,EAAE,CAAC;YACjB,aAAa,EAAE,CAAC;YAChB,YAAY,EAAE,CAAC;YACf,gBAAgB,EAAE,EAAE;YACpB,UAAU,EAAE,EAAE;YACd,cAAc,EAAE,EAAE;YAClB,WAAW,EAAE,EAAE;YACf,aAAa,EAAE,CAAC;YAChB,UAAU,EAAE,CAAC;SACd;QACD,MAAM,EAAE;YACN,SAAS,EAAE,EAAE;YACb,YAAY,EAAE,EAAE;YAChB,cAAc,EAAE,CAAC;YACjB,iBAAiB,EAAE,CAAC;YACpB,aAAa,EAAE,CAAC;YAChB,kBAAkB,EAAE,CAAC;YACrB,aAAa,EAAE,CAAC;YAChB,kBAAkB,EAAE,EAAE;YACtB,SAAS,EAAE,KAAK;SACjB;QACD,OAAO,EAAE;YACP,YAAY,EAAE,CAAC;YACf,cAAc,EAAE,EAAE;YAClB,kBAAkB,EAAE,EAAE;YACtB,mBAAmB,EAAE,EAAE;YACvB,WAAW,EAAE,CAAC;YACd,kBAAkB,EAAE,CAAC;YACrB,gBAAgB,EAAE,CAAC;YACnB,eAAe,EAAE,EAAE;SACpB;QACD,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,EAAE;KACpB,CAAC;AACJ,CAAC"}

package/dist/profiler/query-profiler.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Query Profiler — Database query analysis and optimization detection
+ *
+ * Phase 12: Performance Profiling — Detects slow queries, N+1 patterns,
+ * duplicate queries, and provides optimization recommendations.
+ */
+import type { QueryProfileResult } from "./profiler-types.js";
+export interface QueryProfilerOptions {
+    /** Threshold in ms for slow query detection (default: 100) */
+    slowQueryThresholdMs?: number;
+    /** Threshold for N+1 detection (minimum repeats) (default: 5) */
+    nPlusOneMinRepeats?: number;
+    /** Maximum queries to track (default: 1000) */
+    maxQueries?: number;
+    /** Whether to normalize SQL for fingerprinting (default: true) */
+    normalizeSql?: boolean;
+}
+export declare class QueryProfiler {
+    private readonly queries;
+    private options;
+    private isRunning;
+    constructor(options?: QueryProfilerOptions);
+    start(): void;
+    stop(): QueryProfileResult;
+    get isActive(): boolean;
+    /**
+     * Record a database query execution.
+     */
+    recordQuery(query: string, executionTimeMs: number, location?: string): void;
+    /**
+     * Record multiple queries at once (batch recording).
+     */
+    recordQueries(records: Array<{
+        query: string;
+        executionTimeMs: number;
+        location?: string;
+    }>): void;
+    /**
+     * Normalize a SQL query by replacing literals with placeholders.
+     */
+    private fingerprint;
+    private getResult;
+    private detectSlowQueries;
+    private detectNPlusOne;
+    private detectDuplicates;
+    private groupByFingerprint;
+}
+//# sourceMappingURL=query-profiler.d.ts.map

package/dist/profiler/query-profiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-profiler.d.ts","sourceRoot":"","sources":["../../src/profiler/query-profiler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAIV,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAM7B,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iEAAiE;IACjE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAMD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAMhB;IAER,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,SAAS,CAAkB;gBAEvB,OAAO,CAAC,EAAE,oBAAoB;IAc1C,KAAK,IAAI,IAAI;IAKb,IAAI,IAAI,kBAAkB;IAK1B,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAMD;;OAEG;IACH,WAAW,CACT,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,EACvB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI;IAgBP;;OAEG;IACH,aAAa,CACX,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAC5E,IAAI;IAUP;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,SAAS;IAsCjB,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,cAAc;IAyCtB,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,kBAAkB;CA8B3B"}