baseguard 1.0.0

package/dist/core/error-handler.js

@@ -0,0 +1,392 @@
+import { UIComponents } from '../ui/components.js';
+/**
+ * Error types for different API operations
+ */
+export var ErrorType;
+(function (ErrorType) {
+    ErrorType["NETWORK"] = "network";
+    ErrorType["AUTHENTICATION"] = "authentication";
+    ErrorType["RATE_LIMIT"] = "rate_limit";
+    ErrorType["QUOTA_EXCEEDED"] = "quota_exceeded";
+    ErrorType["INVALID_REQUEST"] = "invalid_request";
+    ErrorType["SERVER_ERROR"] = "server_error";
+    ErrorType["TIMEOUT"] = "timeout";
+    ErrorType["CONFIGURATION"] = "configuration";
+    ErrorType["VALIDATION"] = "validation";
+    ErrorType["UNKNOWN"] = "unknown";
+})(ErrorType || (ErrorType = {}));
+/**
+ * Default retry configuration
+ */
+export const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    baseDelay: 1000, // 1 second
+    maxDelay: 30000, // 30 seconds
+    backoffMultiplier: 2,
+    retryableErrors: [
+        ErrorType.NETWORK,
+        ErrorType.TIMEOUT,
+        ErrorType.SERVER_ERROR,
+        ErrorType.RATE_LIMIT
+    ]
+};
+/**
+ * API operation error with context and recovery suggestions
+ */
+export class APIError extends Error {
+    type;
+    statusCode;
+    retryAfter;
+    quotaReset;
+    suggestions;
+    context;
+    constructor(message, type, options = {}) {
+        super(message);
+        this.name = 'APIError';
+        this.type = type;
+        this.statusCode = options.statusCode;
+        this.retryAfter = options.retryAfter;
+        this.quotaReset = options.quotaReset;
+        this.suggestions = options.suggestions || [];
+        this.context = options.context || {};
+        if (options.cause) {
+            this.cause = options.cause;
+        }
+    }
+}
+/**
+ * Comprehensive error handler for API operations
+ */
+export class ErrorHandler {
+    /**
+     * Handle and classify API errors
+     */
+    static handleAPIError(error, context = {}) {
+        // If already an APIError, return as-is
+        if (error instanceof APIError) {
+            return error;
+        }
+        // Network/connection errors
+        if (this.isNetworkError(error)) {
+            return new APIError('Network connection failed. Please check your internet connection.', ErrorType.NETWORK, {
+                suggestions: [
+                    'Check your internet connection',
+                    'Verify firewall settings allow outbound HTTPS connections',
+                    'Try again in a few moments'
+                ],
+                context,
+                cause: error
+            });
+        }
+        // HTTP status code errors
+        if (error.response?.status) {
+            return this.handleHTTPError(error, context);
+        }
+        // Timeout errors
+        if (this.isTimeoutError(error)) {
+            return new APIError('Request timed out. The API service may be experiencing high load.', ErrorType.TIMEOUT, {
+                suggestions: [
+                    'Try again in a few moments',
+                    'Check if the API service is experiencing issues',
+                    'Consider increasing timeout settings'
+                ],
+                context,
+                cause: error
+            });
+        }
+        // Configuration errors
+        if (this.isConfigurationError(error)) {
+            return new APIError('Configuration error. Please check your API keys and settings.', ErrorType.CONFIGURATION, {
+                suggestions: [
+                    'Run "base config" to verify your API keys',
+                    'Check that API keys are valid and not expired',
+                    'Ensure you have proper permissions for the API'
+                ],
+                context,
+                cause: error
+            });
+        }
+        // Generic error
+        return new APIError(error.message || 'An unexpected error occurred', ErrorType.UNKNOWN, {
+            suggestions: [
+                'Try the operation again',
+                'Check the BaseGuard documentation for troubleshooting',
+                'Report this issue if it persists'
+            ],
+            context,
+            cause: error
+        });
+    }
+    /**
+     * Handle HTTP status code errors
+     */
+    static handleHTTPError(error, context) {
+        const status = error.response.status;
+        const data = error.response.data;
+        switch (status) {
+            case 401:
+                return new APIError('Authentication failed. Your API key may be invalid or expired.', ErrorType.AUTHENTICATION, {
+                    statusCode: status,
+                    suggestions: [
+                        'Check that your API key is correct',
+                        'Verify the API key has not expired',
+                        'Run "base config" to update your API keys',
+                        'Ensure you have proper permissions'
+                    ],
+                    context
+                });
+            case 403:
+                return new APIError('Access forbidden. You may not have permission for this operation.', ErrorType.AUTHENTICATION, {
+                    statusCode: status,
+                    suggestions: [
+                        'Check your API key permissions',
+                        'Verify you have access to the requested resource',
+                        'Contact support if you believe this is an error'
+                    ],
+                    context
+                });
+            case 429:
+                const retryAfter = this.parseRetryAfter(error.response.headers);
+                const quotaReset = this.parseQuotaReset(error.response.headers);
+                return new APIError('Rate limit exceeded. Please wait before making more requests.', ErrorType.RATE_LIMIT, {
+                    statusCode: status,
+                    retryAfter,
+                    quotaReset,
+                    suggestions: [
+                        retryAfter ? `Wait ${retryAfter} seconds before retrying` : 'Wait before retrying',
+                        'Consider reducing the frequency of requests',
+                        quotaReset ? `Quota resets at ${quotaReset.toLocaleString()}` : 'Check your quota limits'
+                    ],
+                    context
+                });
+            case 400:
+                return new APIError(data?.message || 'Invalid request. Please check your input parameters.', ErrorType.INVALID_REQUEST, {
+                    statusCode: status,
+                    suggestions: [
+                        'Check the request parameters',
+                        'Verify the data format is correct',
+                        'Review the API documentation for requirements'
+                    ],
+                    context
+                });
+            case 500:
+            case 502:
+            case 503:
+            case 504:
+                return new APIError('Server error. The API service is experiencing issues.', ErrorType.SERVER_ERROR, {
+                    statusCode: status,
+                    suggestions: [
+                        'Try again in a few moments',
+                        'Check the API service status page',
+                        'Report the issue if it persists'
+                    ],
+                    context
+                });
+            default:
+                return new APIError(data?.message || `HTTP ${status}: ${error.message}`, ErrorType.UNKNOWN, {
+                    statusCode: status,
+                    suggestions: [
+                        'Check the API documentation',
+                        'Try the request again',
+                        'Report this issue if it persists'
+                    ],
+                    context
+                });
+        }
+    }
+    /**
+     * Check if error is a network/connection error
+     */
+    static isNetworkError(error) {
+        return (error.code === 'ECONNREFUSED' ||
+            error.code === 'ENOTFOUND' ||
+            error.code === 'ECONNRESET' ||
+            error.code === 'ENETUNREACH' ||
+            error.message?.includes('network') ||
+            error.message?.includes('connection'));
+    }
+    /**
+     * Check if error is a timeout error
+     */
+    static isTimeoutError(error) {
+        return (error.code === 'ETIMEDOUT' ||
+            error.code === 'TIMEOUT' ||
+            error.message?.includes('timeout'));
+    }
+    /**
+     * Check if error is a configuration error
+     */
+    static isConfigurationError(error) {
+        return (error.message?.includes('API key') ||
+            error.message?.includes('configuration') ||
+            error.message?.includes('invalid key'));
+    }
+    /**
+     * Parse retry-after header
+     */
+    static parseRetryAfter(headers) {
+        const retryAfter = headers?.['retry-after'] || headers?.['Retry-After'];
+        if (retryAfter) {
+            const seconds = parseInt(retryAfter, 10);
+            return isNaN(seconds) ? undefined : seconds;
+        }
+        return undefined;
+    }
+    /**
+     * Parse quota reset time from headers
+     */
+    static parseQuotaReset(headers) {
+        const reset = headers?.['x-ratelimit-reset'] || headers?.['X-RateLimit-Reset'];
+        if (reset) {
+            const timestamp = parseInt(reset, 10);
+            return isNaN(timestamp) ? undefined : new Date(timestamp * 1000);
+        }
+        return undefined;
+    }
+    /**
+     * Retry operation with exponential backoff
+     */
+    static async withRetry(operation, config = {}) {
+        const retryConfig = { ...DEFAULT_RETRY_CONFIG, ...config };
+        let lastError;
+        for (let attempt = 0; attempt <= retryConfig.maxRetries; attempt++) {
+            try {
+                return await operation();
+            }
+            catch (error) {
+                const apiError = this.handleAPIError(error);
+                lastError = apiError;
+                // Don't retry if this is the last attempt
+                if (attempt === retryConfig.maxRetries) {
+                    break;
+                }
+                // Don't retry if error type is not retryable
+                if (!retryConfig.retryableErrors.includes(apiError.type)) {
+                    break;
+                }
+                // Calculate delay with exponential backoff
+                const delay = Math.min(retryConfig.baseDelay * Math.pow(retryConfig.backoffMultiplier, attempt), retryConfig.maxDelay);
+                // Use retry-after header if available
+                const actualDelay = apiError.retryAfter ? apiError.retryAfter * 1000 : delay;
+                console.log(`Retrying in ${Math.ceil(actualDelay / 1000)} seconds... (attempt ${attempt + 1}/${retryConfig.maxRetries})`);
+                await this.sleep(actualDelay);
+            }
+        }
+        throw lastError;
+    }
+    /**
+     * Display error to user with helpful information
+     */
+    static displayError(error) {
+        UIComponents.showErrorBox(error.message);
+        if (error.suggestions.length > 0) {
+            console.log('\nSuggestions:');
+            UIComponents.showList(error.suggestions);
+        }
+        // Show additional context for specific error types
+        switch (error.type) {
+            case ErrorType.RATE_LIMIT:
+                if (error.retryAfter) {
+                    UIComponents.showWarningBox(`Rate limited. Retry after ${error.retryAfter} seconds.`);
+                }
+                if (error.quotaReset) {
+                    UIComponents.showInfoBox(`Quota resets at: ${error.quotaReset.toLocaleString()}`);
+                }
+                break;
+            case ErrorType.AUTHENTICATION:
+                UIComponents.showWarningBox('Run "base config" to update your API keys.');
+                break;
+            case ErrorType.NETWORK:
+                UIComponents.showWarningBox('Check your internet connection and try again.');
+                break;
+        }
+    }
+    /**
+     * Get fallback mode suggestions when APIs are unavailable
+     */
+    static getFallbackSuggestions(errorType) {
+        switch (errorType) {
+            case ErrorType.NETWORK:
+            case ErrorType.TIMEOUT:
+                return [
+                    'Use offline mode for basic compatibility checking',
+                    'Review violations manually using browser compatibility tables',
+                    'Try again when network connection is restored'
+                ];
+            case ErrorType.RATE_LIMIT:
+            case ErrorType.QUOTA_EXCEEDED:
+                return [
+                    'Continue with basic violation detection without AI analysis',
+                    'Review violations manually',
+                    'Try AI features again later when quota resets'
+                ];
+            case ErrorType.AUTHENTICATION:
+                return [
+                    'Use BaseGuard without AI features',
+                    'Update API keys when available',
+                    'Review violations manually using web compatibility resources'
+                ];
+            default:
+                return [
+                    'Continue with basic compatibility checking',
+                    'Review violations manually',
+                    'Try AI features again later'
+                ];
+        }
+    }
+    /**
+     * Check if operation should continue in fallback mode
+     */
+    static shouldUseFallbackMode(error) {
+        return [
+            ErrorType.NETWORK,
+            ErrorType.TIMEOUT,
+            ErrorType.AUTHENTICATION,
+            ErrorType.RATE_LIMIT,
+            ErrorType.QUOTA_EXCEEDED
+        ].includes(error.type);
+    }
+    /**
+     * Sleep for specified milliseconds
+     */
+    static sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Validate API response structure
+     */
+    static validateAPIResponse(response, expectedFields) {
+        if (!response || typeof response !== 'object') {
+            throw new APIError('Invalid API response format', ErrorType.VALIDATION, {
+                suggestions: [
+                    'Check API service status',
+                    'Verify API version compatibility',
+                    'Try the request again'
+                ]
+            });
+        }
+        const missingFields = expectedFields.filter(field => !(field in response));
+        if (missingFields.length > 0) {
+            throw new APIError(`API response missing required fields: ${missingFields.join(', ')}`, ErrorType.VALIDATION, {
+                suggestions: [
+                    'Check API documentation for response format',
+                    'Verify API version compatibility',
+                    'Report this issue if it persists'
+                ],
+                context: { missingFields, response }
+            });
+        }
+    }
+    /**
+     * Create context object for error reporting
+     */
+    static createContext(operation, params) {
+        return {
+            operation,
+            timestamp: new Date().toISOString(),
+            params: params || {},
+            version: process.env.npm_package_version || 'unknown'
+        };
+    }
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/core/error-handler.js.map

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

package/dist/core/file-processor.d.ts

@@ -0,0 +1,80 @@
+import type { DetectedFeature } from '../types/index.js';
+import { CacheManager } from './cache-manager.js';
+/**
+ * File processor with concurrent parsing using worker threads
+ */
+export declare class FileProcessor {
+    private readonly maxWorkers;
+    private readonly cacheManager;
+    private workers;
+    private taskQueue;
+    private pendingTasks;
+    private isProcessing;
+    constructor(options?: {
+        maxWorkers?: number;
+        cacheManager?: CacheManager;
+    });
+    /**
+     * Process multiple files concurrently with caching
+     */
+    processFiles(filePaths: string[]): Promise<DetectedFeature[]>;
+    /**
+     * Process files using worker threads
+     */
+    private processFilesWithWorkers;
+    /**
+     * Process a single task
+     */
+    private processTask;
+    /**
+     * Start worker processing
+     */
+    private startProcessing;
+    /**
+     * Initialize worker threads
+     */
+    private initializeWorkers;
+    /**
+     * Process a batch of tasks with available workers
+     */
+    private processBatch;
+    /**
+     * Assign task to worker
+     */
+    private assignTaskToWorker;
+    /**
+     * Handle worker result
+     */
+    private handleWorkerResult;
+    /**
+     * Handle worker error
+     */
+    private handleWorkerError;
+    /**
+     * Terminate all workers
+     */
+    private terminateWorkers;
+    /**
+     * Get worker script path
+     */
+    private getWorkerScriptPath;
+    /**
+     * Sleep utility
+     */
+    private sleep;
+    /**
+     * Get processing statistics
+     */
+    getStats(): {
+        maxWorkers: number;
+        activeWorkers: number;
+        queuedTasks: number;
+        pendingTasks: number;
+        cacheStats: any;
+    };
+    /**
+     * Cleanup resources
+     */
+    cleanup(): Promise<void>;
+}
+//# sourceMappingURL=file-processor.d.ts.map

package/dist/core/file-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-processor.d.ts","sourceRoot":"","sources":["../../src/core/file-processor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAoBlD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,YAAY,CAGf;IACL,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,GAAE;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,YAAY,CAAC;KACxB;IAKN;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAwBnE;;OAEG;YACW,uBAAuB;IA8CrC;;OAEG;YACW,WAAW;IAuBzB;;OAEG;YACW,eAAe;IAuB7B;;OAEG;YACW,iBAAiB;IAuB/B;;OAEG;YACW,YAAY;IAiB1B;;OAEG;YACW,kBAAkB;IAqBhC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;YACW,gBAAgB;IAO9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,QAAQ,IAAI;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,GAAG,CAAC;KACjB;IAUD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAM/B"}