@pcircle/memesh 2.6.3

package/dist/utils/MinHeap.js

@@ -0,0 +1,69 @@
+export class MinHeap {
+    heap = [];
+    compareFn;
+    constructor(compareFn) {
+        this.compareFn = compareFn;
+    }
+    get size() {
+        return this.heap.length;
+    }
+    isEmpty() {
+        return this.heap.length === 0;
+    }
+    peek() {
+        return this.heap[0];
+    }
+    push(value) {
+        this.heap.push(value);
+        this.bubbleUp(this.heap.length - 1);
+    }
+    pop() {
+        if (this.heap.length === 0) {
+            return undefined;
+        }
+        if (this.heap.length === 1) {
+            return this.heap.pop();
+        }
+        const min = this.heap[0];
+        this.heap[0] = this.heap.pop();
+        this.bubbleDown(0);
+        return min;
+    }
+    clear() {
+        this.heap = [];
+    }
+    toArray() {
+        return [...this.heap];
+    }
+    bubbleUp(index) {
+        while (index > 0) {
+            const parentIndex = Math.floor((index - 1) / 2);
+            if (this.compareFn(this.heap[index], this.heap[parentIndex]) >= 0) {
+                break;
+            }
+            [this.heap[index], this.heap[parentIndex]] = [this.heap[parentIndex], this.heap[index]];
+            index = parentIndex;
+        }
+    }
+    bubbleDown(index) {
+        while (true) {
+            const leftChild = 2 * index + 1;
+            const rightChild = 2 * index + 2;
+            let smallest = index;
+            if (leftChild < this.heap.length &&
+                this.compareFn(this.heap[leftChild], this.heap[smallest]) < 0) {
+                smallest = leftChild;
+            }
+            if (rightChild < this.heap.length &&
+                this.compareFn(this.heap[rightChild], this.heap[smallest]) < 0) {
+                smallest = rightChild;
+            }
+            if (smallest === index) {
+                break;
+            }
+            [this.heap[index], this.heap[smallest]] = [this.heap[smallest], this.heap[index]];
+            index = smallest;
+        }
+    }
+}
+//# sourceMappingURL=MinHeap.js.map

package/dist/utils/MinHeap.js.map

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

package/dist/utils/RateLimiter.d.ts

@@ -0,0 +1,28 @@
+export interface RateLimiterOptions {
+    maxTokens?: number;
+    refillRate?: number;
+    refillInterval?: number;
+    requestsPerMinute?: number;
+}
+export declare class RateLimiter {
+    private tokens;
+    private readonly maxTokens;
+    private readonly refillRate;
+    private readonly refillInterval;
+    private lastRefill;
+    private refillTimer?;
+    private consuming;
+    constructor(options?: RateLimiterOptions);
+    private startRefillTimer;
+    private refill;
+    consume(tokens?: number): boolean;
+    getTokens(): number;
+    getStatus(): {
+        tokens: number;
+        maxTokens: number;
+        utilizationPercent: number;
+    };
+    reset(): void;
+    stop(): void;
+}
+//# sourceMappingURL=RateLimiter.d.ts.map

package/dist/utils/RateLimiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RateLimiter.d.ts","sourceRoot":"","sources":["../../src/utils/RateLimiter.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,kBAAkB;IAKjC,SAAS,CAAC,EAAE,MAAM,CAAC;IAMnB,UAAU,CAAC,EAAE,MAAM,CAAC;IAMpB,cAAc,CAAC,EAAE,MAAM,CAAC;IAMxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAuCD,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAiB;IAMrC,OAAO,CAAC,SAAS,CAAkB;gBAEvB,OAAO,GAAE,kBAAuB;IAoC5C,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,MAAM;IA4Bd,OAAO,CAAC,MAAM,GAAE,MAAU,GAAG,OAAO;IA8DpC,SAAS,IAAI,MAAM;IAwBnB,SAAS,IAAI;QACX,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,kBAAkB,EAAE,MAAM,CAAC;KAC5B;IAoBD,KAAK,IAAI,IAAI;IAmBb,IAAI,IAAI,IAAI;CAOb"}

package/dist/utils/RateLimiter.js

@@ -0,0 +1,115 @@
+import { logger } from './logger.js';
+export class RateLimiter {
+    tokens;
+    maxTokens;
+    refillRate;
+    refillInterval;
+    lastRefill;
+    refillTimer;
+    consuming = false;
+    constructor(options = {}) {
+        if (options.requestsPerMinute !== undefined) {
+            this.maxTokens = options.requestsPerMinute;
+            this.refillRate = Math.ceil(options.requestsPerMinute / 60);
+            this.refillInterval = 1000;
+        }
+        else {
+            this.maxTokens = options.maxTokens ?? 100;
+            this.refillRate = options.refillRate ?? 10;
+            this.refillInterval = options.refillInterval ?? 1000;
+        }
+        this.tokens = this.maxTokens;
+        this.lastRefill = Date.now();
+        this.startRefillTimer();
+        logger.info('RateLimiter initialized', {
+            maxTokens: this.maxTokens,
+            refillRate: this.refillRate,
+            refillInterval: this.refillInterval,
+        });
+    }
+    startRefillTimer() {
+        this.refillTimer = setInterval(() => {
+            this.refill();
+        }, this.refillInterval);
+        if (this.refillTimer.unref) {
+            this.refillTimer.unref();
+        }
+    }
+    refill() {
+        const now = Date.now();
+        const elapsed = now - this.lastRefill;
+        const intervalsElapsed = Math.floor(elapsed / this.refillInterval);
+        if (intervalsElapsed > 0) {
+            const tokensToAdd = intervalsElapsed * this.refillRate;
+            this.tokens = Math.min(this.maxTokens, this.tokens + tokensToAdd);
+            this.lastRefill = now;
+            logger.debug('RateLimiter refilled', {
+                tokensAdded: tokensToAdd,
+                currentTokens: this.tokens,
+                maxTokens: this.maxTokens,
+            });
+        }
+    }
+    consume(tokens = 1) {
+        let attempts = 0;
+        const MAX_SPIN_ATTEMPTS = 10;
+        while (this.consuming && attempts < MAX_SPIN_ATTEMPTS) {
+            attempts++;
+        }
+        if (this.consuming) {
+            logger.warn('RateLimiter: Request rejected (lock contention)', {
+                attempts,
+                maxAttempts: MAX_SPIN_ATTEMPTS,
+            });
+            return false;
+        }
+        this.consuming = true;
+        try {
+            this.refill();
+            if (this.tokens >= tokens) {
+                this.tokens -= tokens;
+                logger.debug('RateLimiter: Request allowed', {
+                    tokensConsumed: tokens,
+                    tokensRemaining: this.tokens,
+                });
+                return true;
+            }
+            logger.warn('RateLimiter: Request blocked (rate limit exceeded)', {
+                tokensRequested: tokens,
+                tokensAvailable: this.tokens,
+                maxTokens: this.maxTokens,
+            });
+            return false;
+        }
+        finally {
+            this.consuming = false;
+        }
+    }
+    getTokens() {
+        this.refill();
+        return this.tokens;
+    }
+    getStatus() {
+        this.refill();
+        return {
+            tokens: this.tokens,
+            maxTokens: this.maxTokens,
+            utilizationPercent: ((this.maxTokens - this.tokens) / this.maxTokens) * 100,
+        };
+    }
+    reset() {
+        this.tokens = this.maxTokens;
+        this.lastRefill = Date.now();
+        logger.info('RateLimiter reset to max tokens', {
+            maxTokens: this.maxTokens,
+        });
+    }
+    stop() {
+        if (this.refillTimer) {
+            clearInterval(this.refillTimer);
+            this.refillTimer = undefined;
+            logger.info('RateLimiter stopped');
+        }
+    }
+}
+//# sourceMappingURL=RateLimiter.js.map

package/dist/utils/RateLimiter.js.map

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

package/dist/utils/SystemResources.d.ts

@@ -0,0 +1,40 @@
+export interface SystemResourcesConfig {
+    cpuThreshold?: number;
+    memoryThreshold?: number;
+    threadStrategy?: 'conservative' | 'balanced' | 'aggressive';
+    minThreads?: number;
+    maxThreads?: number;
+    e2eMaxConcurrent?: number;
+}
+export interface SystemResources {
+    cpuCores: number;
+    cpuUsage: number;
+    availableCPU: number;
+    totalMemoryMB: number;
+    usedMemoryMB: number;
+    freeMemoryMB: number;
+    memoryUsage: number;
+    recommendedThreads: number;
+    recommendedE2E: number;
+    healthy: boolean;
+    warnings: string[];
+}
+export declare class SystemResourceManager {
+    private config;
+    constructor(config?: SystemResourcesConfig);
+    getResources(): Promise<SystemResources>;
+    private calculateRecommendedThreads;
+    private calculateRecommendedE2E;
+    private getCPUUsage;
+    private getCPUSnapshot;
+    canRunE2E(count?: number): Promise<{
+        canRun: boolean;
+        reason?: string;
+        recommendation?: string;
+    }>;
+    generateReport(): Promise<string>;
+    private getStatusEmoji;
+}
+export declare function getSystemResources(config?: SystemResourcesConfig): Promise<SystemResources>;
+export declare function canRunE2ETest(count?: number, config?: SystemResourcesConfig): Promise<ReturnType<SystemResourceManager['canRunE2E']>>;
+//# sourceMappingURL=SystemResources.d.ts.map

package/dist/utils/SystemResources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemResources.d.ts","sourceRoot":"","sources":["../../src/utils/SystemResources.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,qBAAqB;IAEpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IAGzB,cAAc,CAAC,EAAE,cAAc,GAAG,UAAU,GAAG,YAAY,CAAC;IAG5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAOD,MAAM,WAAW,eAAe;IAE9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IAGrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IAGpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IAGvB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAgCD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAkC;gBAEpC,MAAM,GAAE,qBAA0B;IAcxC,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC;IAwE9C,OAAO,CAAC,2BAA2B;IAmDnC,OAAO,CAAC,uBAAuB;YAyCjB,WAAW;IAkCzB,OAAO,CAAC,cAAc;IAwChB,SAAS,CAAC,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC;QAC1C,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IAgEI,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IA2CvC,OAAO,CAAC,cAAc;CAKvB;AAcD,wBAAsB,kBAAkB,CACtC,MAAM,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAG1B;AAiBD,wBAAsB,aAAa,CACjC,KAAK,GAAE,MAAU,EACjB,MAAM,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC,UAAU,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC,CAAC,CAGzD"}

package/dist/utils/SystemResources.js

@@ -0,0 +1,221 @@
+import os from 'os';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import { logger } from './logger.js';
+const execAsync = promisify(exec);
+export class SystemResourceManager {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            cpuThreshold: config.cpuThreshold ?? 80,
+            memoryThreshold: config.memoryThreshold ?? 85,
+            threadStrategy: config.threadStrategy ?? 'balanced',
+            minThreads: config.minThreads ?? 1,
+            maxThreads: config.maxThreads ?? os.cpus().length,
+            e2eMaxConcurrent: config.e2eMaxConcurrent ?? 0,
+        };
+    }
+    async getResources() {
+        const cpuCores = os.cpus().length;
+        const totalMemoryMB = os.totalmem() / (1024 * 1024);
+        const freeMemoryMB = os.freemem() / (1024 * 1024);
+        const usedMemoryMB = totalMemoryMB - freeMemoryMB;
+        const memoryUsage = (usedMemoryMB / totalMemoryMB) * 100;
+        const cpuUsage = await this.getCPUUsage();
+        const availableCPU = 100 - cpuUsage;
+        const recommendedThreads = this.calculateRecommendedThreads(cpuCores, cpuUsage, memoryUsage);
+        const recommendedE2E = this.calculateRecommendedE2E(cpuCores, cpuUsage, memoryUsage);
+        const warnings = [];
+        let healthy = true;
+        if (cpuUsage > this.config.cpuThreshold) {
+            healthy = false;
+            warnings.push(`High CPU usage: ${cpuUsage.toFixed(1)}% (threshold: ${this.config.cpuThreshold}%)`);
+        }
+        if (memoryUsage > this.config.memoryThreshold) {
+            healthy = false;
+            warnings.push(`High memory usage: ${memoryUsage.toFixed(1)}% (threshold: ${this.config.memoryThreshold}%)`);
+        }
+        if (freeMemoryMB < 1024) {
+            healthy = false;
+            warnings.push(`Low free memory: ${freeMemoryMB.toFixed(0)}MB`);
+        }
+        return {
+            cpuCores,
+            cpuUsage,
+            availableCPU,
+            totalMemoryMB,
+            usedMemoryMB,
+            freeMemoryMB,
+            memoryUsage,
+            recommendedThreads,
+            recommendedE2E,
+            healthy,
+            warnings,
+        };
+    }
+    calculateRecommendedThreads(cpuCores, cpuUsage, memoryUsage) {
+        let threads;
+        switch (this.config.threadStrategy) {
+            case 'conservative':
+                threads = Math.max(1, Math.floor(cpuCores * 0.5));
+                break;
+            case 'aggressive':
+                if (cpuUsage < 30 && memoryUsage < 60) {
+                    threads = cpuCores;
+                }
+                else {
+                    threads = Math.max(1, Math.floor(cpuCores * 0.75));
+                }
+                break;
+            case 'balanced':
+            default:
+                if (cpuUsage > 70 || memoryUsage > 80) {
+                    threads = Math.max(1, Math.floor(cpuCores * 0.25));
+                }
+                else if (cpuUsage > 50 || memoryUsage > 60) {
+                    threads = Math.max(1, Math.floor(cpuCores * 0.5));
+                }
+                else {
+                    threads = Math.max(1, Math.floor(cpuCores * 0.75));
+                }
+                break;
+        }
+        threads = Math.max(this.config.minThreads, threads);
+        threads = Math.min(this.config.maxThreads, threads);
+        return threads;
+    }
+    calculateRecommendedE2E(cpuCores, cpuUsage, memoryUsage) {
+        if (this.config.e2eMaxConcurrent > 0) {
+            return this.config.e2eMaxConcurrent;
+        }
+        const availableCPU = 100 - cpuUsage;
+        const availableMemoryPercent = 100 - memoryUsage;
+        const cpuBasedE2E = Math.floor(availableCPU / 25);
+        const memoryBasedE2E = Math.floor(availableMemoryPercent / 25);
+        let e2e = Math.min(cpuBasedE2E, memoryBasedE2E);
+        e2e = Math.min(e2e, Math.floor(cpuCores / 2));
+        e2e = Math.max(1, Math.min(4, e2e));
+        return e2e;
+    }
+    async getCPUUsage() {
+        try {
+            const startUsage = this.getCPUSnapshot();
+            await new Promise(resolve => setTimeout(resolve, 100));
+            const endUsage = this.getCPUSnapshot();
+            const totalDiff = endUsage.total - startUsage.total;
+            const idleDiff = endUsage.idle - startUsage.idle;
+            if (totalDiff === 0) {
+                return 0;
+            }
+            const usagePercent = ((totalDiff - idleDiff) / totalDiff) * 100;
+            return Math.max(0, Math.min(100, usagePercent));
+        }
+        catch (error) {
+            logger.warn('Failed to get CPU usage, using fallback:', error);
+            const loadavg = os.loadavg()[0];
+            const cpuCores = os.cpus().length;
+            return Math.min(100, (loadavg / cpuCores) * 100);
+        }
+    }
+    getCPUSnapshot() {
+        const cpus = os.cpus();
+        let totalTime = 0;
+        let idleTime = 0;
+        for (const cpu of cpus) {
+            for (const type in cpu.times) {
+                totalTime += cpu.times[type];
+            }
+            idleTime += cpu.times.idle;
+        }
+        return { total: totalTime, idle: idleTime };
+    }
+    async canRunE2E(count = 1) {
+        const resources = await this.getResources();
+        if (!resources.healthy) {
+            return {
+                canRun: false,
+                reason: `System resources unhealthy: ${resources.warnings.join(', ')}`,
+                recommendation: 'Wait for system to stabilize or reduce concurrent tasks',
+            };
+        }
+        if (count > resources.recommendedE2E) {
+            return {
+                canRun: false,
+                reason: `Requested ${count} E2E tests exceeds recommended ${resources.recommendedE2E}`,
+                recommendation: `Run ${resources.recommendedE2E} E2E test(s) instead, or run sequentially`,
+            };
+        }
+        const estimatedCPU = count * 25;
+        const estimatedMemory = count * 25;
+        if (estimatedCPU > resources.availableCPU) {
+            return {
+                canRun: false,
+                reason: `Insufficient CPU (need ${estimatedCPU}%, available ${resources.availableCPU.toFixed(1)}%)`,
+                recommendation: 'Reduce E2E test count or run sequentially',
+            };
+        }
+        if (estimatedMemory > (100 - resources.memoryUsage)) {
+            return {
+                canRun: false,
+                reason: `Insufficient memory (need ~${(count * 2048).toFixed(0)}MB, available ${resources.freeMemoryMB.toFixed(0)}MB)`,
+                recommendation: 'Close other applications or run E2E tests sequentially',
+            };
+        }
+        return { canRun: true };
+    }
+    async generateReport() {
+        const resources = await this.getResources();
+        let report = '╔═══════════════════════════════════════════════════════════╗\n';
+        report += '║           SYSTEM RESOURCES REPORT                       ║\n';
+        report += '╠═══════════════════════════════════════════════════════════╣\n';
+        report += `║ CPU Cores:           ${resources.cpuCores.toString().padEnd(36)}║\n`;
+        report += `║ CPU Usage:           ${resources.cpuUsage.toFixed(1)}% ${this.getStatusEmoji(resources.cpuUsage, this.config.cpuThreshold).padEnd(29)}║\n`;
+        report += `║ Memory Total:        ${resources.totalMemoryMB.toFixed(0)}MB ${' '.repeat(32 - resources.totalMemoryMB.toFixed(0).length)}║\n`;
+        report += `║ Memory Usage:        ${resources.memoryUsage.toFixed(1)}% ${this.getStatusEmoji(resources.memoryUsage, this.config.memoryThreshold).padEnd(29)}║\n`;
+        report += '╠═══════════════════════════════════════════════════════════╣\n';
+        report += `║ Recommended Threads: ${resources.recommendedThreads.toString().padEnd(36)}║\n`;
+        report += `║ Recommended E2E:     ${resources.recommendedE2E.toString().padEnd(36)}║\n`;
+        report += `║ Strategy:            ${this.config.threadStrategy.padEnd(36)}║\n`;
+        report += '╠═══════════════════════════════════════════════════════════╣\n';
+        if (resources.warnings.length > 0) {
+            report += `║ ⚠️  WARNINGS:                                            ║\n`;
+            for (const warning of resources.warnings) {
+                const words = warning.split(' ');
+                let line = '';
+                for (const word of words) {
+                    if ((line + word).length > 54) {
+                        report += `║ ${line.padEnd(54)}   ║\n`;
+                        line = '  ' + word + ' ';
+                    }
+                    else {
+                        line += word + ' ';
+                    }
+                }
+                if (line.trim()) {
+                    report += `║ ${line.trim().padEnd(54)}   ║\n`;
+                }
+            }
+        }
+        else {
+            report += `║ ✅ System Healthy                                        ║\n`;
+        }
+        report += '╚═══════════════════════════════════════════════════════════╝\n';
+        return report;
+    }
+    getStatusEmoji(usage, threshold) {
+        if (usage < threshold * 0.7)
+            return '✅';
+        if (usage < threshold)
+            return '⚠️ ';
+        return '🔴';
+    }
+}
+export async function getSystemResources(config) {
+    const manager = new SystemResourceManager(config);
+    return manager.getResources();
+}
+export async function canRunE2ETest(count = 1, config) {
+    const manager = new SystemResourceManager(config);
+    return manager.canRunE2E(count);
+}
+//# sourceMappingURL=SystemResources.js.map

package/dist/utils/SystemResources.js.map

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

package/dist/utils/errorHandler.d.ts

@@ -0,0 +1,28 @@
+export interface ErrorContext {
+    component: string;
+    method: string;
+    operation?: string;
+    requestId?: string;
+    data?: Record<string, unknown>;
+}
+export interface HandledError {
+    message: string;
+    stack?: string;
+    type: string;
+    context?: ErrorContext;
+}
+export declare function logError(error: unknown, context: ErrorContext): void;
+export declare function handleError(error: unknown, context: ErrorContext, userMessage?: string): HandledError;
+export declare function withErrorHandling<T extends unknown[], R>(fn: (...args: T) => Promise<R>, context: ErrorContext): (...args: T) => Promise<R>;
+export declare function formatMCPError(error: unknown, context: ErrorContext): {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError: boolean;
+};
+export declare function getErrorMessage(error: unknown): string;
+export declare function getErrorStack(error: unknown): string | undefined;
+export declare function getRecoverySuggestion(error: unknown): string | undefined;
+export declare function formatErrorWithSuggestion(error: unknown, operation: string): string;
+//# sourceMappingURL=errorHandler.d.ts.map

package/dist/utils/errorHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHandler.d.ts","sourceRoot":"","sources":["../../src/utils/errorHandler.ts"],"names":[],"mappings":"AAgDA,MAAM,WAAW,YAAY;IAE3B,SAAS,EAAE,MAAM,CAAC;IAElB,MAAM,EAAE,MAAM,CAAC;IAEf,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAKD,MAAM,WAAW,YAAY;IAE3B,OAAO,EAAE,MAAM,CAAC;IAEhB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,IAAI,EAAE,MAAM,CAAC;IAEb,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAiCD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAepE;AAUD,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,YAAY,EACrB,WAAW,CAAC,EAAE,MAAM,GACnB,YAAY,CAad;AASD,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EACtD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9B,OAAO,EAAE,YAAY,GACpB,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAS5B;AASD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,YAAY,GACpB;IACD,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,EAAE,OAAO,CAAC;CAClB,CAuBA;AAQD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKtD;AAQD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAKhE;AAmID,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAUxE;AAwBD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,GAChB,MAAM,CAWR"}