baseguard 1.0.0

package/dist/core/directory-filter.js

@@ -0,0 +1,319 @@
+import { readdir, stat } from 'fs/promises';
+import { join, basename, extname } from 'path';
+import { glob } from 'glob';
+/**
+ * Smart directory filtering to skip node_modules and build outputs
+ */
+export class DirectoryFilter {
+    defaultExcludePatterns = [
+        'node_modules',
+        '.git',
+        '.svn',
+        '.hg',
+        'dist',
+        'build',
+        'out',
+        '.next',
+        '.nuxt',
+        '.output',
+        'coverage',
+        '.nyc_output',
+        '.cache',
+        '.parcel-cache',
+        '.vscode',
+        '.idea',
+        '*.log',
+        '*.tmp',
+        '*.temp',
+        '.DS_Store',
+        'Thumbs.db'
+    ];
+    defaultIncludeExtensions = [
+        '.js',
+        '.jsx',
+        '.ts',
+        '.tsx',
+        '.vue',
+        '.svelte',
+        '.css',
+        '.scss',
+        '.sass',
+        '.less',
+        '.html',
+        '.htm'
+    ];
+    excludePatterns;
+    includeExtensions;
+    maxDepth;
+    maxFiles;
+    constructor(options = {}) {
+        this.excludePatterns = new Set([
+            ...this.defaultExcludePatterns,
+            ...(options.excludePatterns || [])
+        ]);
+        this.includeExtensions = new Set(options.includeExtensions || this.defaultIncludeExtensions);
+        this.maxDepth = options.maxDepth || 10;
+        this.maxFiles = options.maxFiles || 10000;
+    }
+    /**
+     * Find files recursively with smart filtering
+     */
+    async findFiles(directories, options = {}) {
+        const { patterns = [], excludePatterns = [], includeHidden = false } = options;
+        const allExcludePatterns = new Set([
+            ...this.excludePatterns,
+            ...excludePatterns
+        ]);
+        const files = [];
+        const processedDirs = new Set();
+        for (const directory of directories) {
+            try {
+                await this.findFilesRecursive(directory, files, allExcludePatterns, patterns, includeHidden, 0, processedDirs);
+            }
+            catch (error) {
+                console.warn(`Could not scan directory ${directory}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            }
+            // Stop if we've found too many files
+            if (files.length >= this.maxFiles) {
+                console.warn(`Reached maximum file limit (${this.maxFiles}). Some files may be skipped.`);
+                break;
+            }
+        }
+        return files.slice(0, this.maxFiles);
+    }
+    /**
+     * Find files using glob patterns (faster for specific patterns)
+     */
+    async findFilesWithGlob(patterns, options = {}) {
+        const { cwd = process.cwd(), excludePatterns = [] } = options;
+        try {
+            const allFiles = await glob(patterns, {
+                cwd,
+                ignore: [
+                    ...Array.from(this.excludePatterns),
+                    ...excludePatterns
+                ],
+                absolute: true,
+                nodir: true
+            });
+            // Filter by supported extensions
+            return allFiles.filter(file => this.isSupportedFile(file));
+        }
+        catch (error) {
+            console.error(`Glob search failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            return [];
+        }
+    }
+    /**
+     * Check if a file should be processed
+     */
+    isSupportedFile(filePath) {
+        const extension = extname(filePath).toLowerCase();
+        return this.includeExtensions.has(extension);
+    }
+    /**
+     * Check if a directory should be excluded
+     */
+    isExcludedDirectory(dirPath) {
+        const dirName = basename(dirPath);
+        // Check exact matches
+        if (this.excludePatterns.has(dirName)) {
+            return true;
+        }
+        // Check pattern matches
+        for (const pattern of this.excludePatterns) {
+            if (pattern.includes('*') || pattern.includes('?')) {
+                // Simple glob pattern matching
+                const regex = new RegExp(pattern
+                    .replace(/\*/g, '.*')
+                    .replace(/\?/g, '.'));
+                if (regex.test(dirName)) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    /**
+     * Get file statistics for a directory
+     */
+    async getDirectoryStats(directoryPath) {
+        const stats = {
+            totalFiles: 0,
+            supportedFiles: 0,
+            directories: 0,
+            excludedDirectories: 0,
+            largestFiles: []
+        };
+        try {
+            await this.collectStats(directoryPath, stats, 0);
+        }
+        catch (error) {
+            console.warn(`Could not collect stats for ${directoryPath}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+        // Sort largest files
+        stats.largestFiles.sort((a, b) => b.size - a.size);
+        stats.largestFiles = stats.largestFiles.slice(0, 10);
+        return stats;
+    }
+    /**
+     * Recursive file finding with smart filtering
+     */
+    async findFilesRecursive(currentPath, results, excludePatterns, includePatterns, includeHidden, currentDepth, processedDirs) {
+        // Prevent infinite loops with symlinks
+        if (processedDirs.has(currentPath)) {
+            return;
+        }
+        processedDirs.add(currentPath);
+        // Check depth limit
+        if (currentDepth >= this.maxDepth) {
+            return;
+        }
+        // Check file limit
+        if (results.length >= this.maxFiles) {
+            return;
+        }
+        try {
+            const entries = await readdir(currentPath);
+            for (const entry of entries) {
+                // Skip hidden files/directories unless explicitly included
+                if (!includeHidden && entry.startsWith('.')) {
+                    continue;
+                }
+                const fullPath = join(currentPath, entry);
+                try {
+                    const stats = await stat(fullPath);
+                    if (stats.isDirectory()) {
+                        // Check if directory should be excluded
+                        if (this.isExcludedDirectory(fullPath)) {
+                            continue;
+                        }
+                        // Recurse into directory
+                        await this.findFilesRecursive(fullPath, results, excludePatterns, includePatterns, includeHidden, currentDepth + 1, processedDirs);
+                    }
+                    else if (stats.isFile()) {
+                        // Check if file matches patterns
+                        if (this.shouldIncludeFile(fullPath, includePatterns)) {
+                            results.push(fullPath);
+                        }
+                    }
+                }
+                catch (error) {
+                    // Skip files/directories that can't be accessed
+                    continue;
+                }
+            }
+        }
+        catch (error) {
+            console.warn(`Could not read directory ${currentPath}: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Check if file should be included based on patterns
+     */
+    shouldIncludeFile(filePath, includePatterns) {
+        // If no specific patterns, use extension filtering
+        if (includePatterns.length === 0) {
+            return this.isSupportedFile(filePath);
+        }
+        // Check against include patterns
+        const fileName = basename(filePath);
+        return includePatterns.some(pattern => {
+            if (pattern.includes('*') || pattern.includes('?')) {
+                const regex = new RegExp(pattern
+                    .replace(/\*/g, '.*')
+                    .replace(/\?/g, '.'));
+                return regex.test(fileName);
+            }
+            return fileName === pattern;
+        });
+    }
+    /**
+     * Collect directory statistics recursively
+     */
+    async collectStats(currentPath, stats, currentDepth) {
+        if (currentDepth >= this.maxDepth) {
+            return;
+        }
+        try {
+            const entries = await readdir(currentPath);
+            for (const entry of entries) {
+                const fullPath = join(currentPath, entry);
+                try {
+                    const fileStat = await stat(fullPath);
+                    if (fileStat.isDirectory()) {
+                        stats.directories++;
+                        if (this.isExcludedDirectory(fullPath)) {
+                            stats.excludedDirectories++;
+                            continue;
+                        }
+                        await this.collectStats(fullPath, stats, currentDepth + 1);
+                    }
+                    else if (fileStat.isFile()) {
+                        stats.totalFiles++;
+                        if (this.isSupportedFile(fullPath)) {
+                            stats.supportedFiles++;
+                        }
+                        // Track largest files
+                        if (stats.largestFiles.length < 100) {
+                            stats.largestFiles.push({
+                                path: fullPath,
+                                size: fileStat.size
+                            });
+                        }
+                    }
+                }
+                catch (error) {
+                    // Skip files/directories that can't be accessed
+                    continue;
+                }
+            }
+        }
+        catch (error) {
+            // Skip directories that can't be read
+        }
+    }
+    /**
+     * Get supported extensions
+     */
+    getSupportedExtensions() {
+        return Array.from(this.includeExtensions);
+    }
+    /**
+     * Get exclude patterns
+     */
+    getExcludePatterns() {
+        return Array.from(this.excludePatterns);
+    }
+    /**
+     * Add custom exclude pattern
+     */
+    addExcludePattern(pattern) {
+        this.excludePatterns.add(pattern);
+    }
+    /**
+     * Remove exclude pattern
+     */
+    removeExcludePattern(pattern) {
+        this.excludePatterns.delete(pattern);
+    }
+    /**
+     * Add supported extension
+     */
+    addSupportedExtension(extension) {
+        if (!extension.startsWith('.')) {
+            extension = '.' + extension;
+        }
+        this.includeExtensions.add(extension.toLowerCase());
+    }
+    /**
+     * Remove supported extension
+     */
+    removeSupportedExtension(extension) {
+        if (!extension.startsWith('.')) {
+            extension = '.' + extension;
+        }
+        this.includeExtensions.delete(extension.toLowerCase());
+    }
+}
+//# sourceMappingURL=directory-filter.js.map

package/dist/core/directory-filter.js.map

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

package/dist/core/error-handler.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Error types for different API operations
+ */
+export declare enum ErrorType {
+    NETWORK = "network",
+    AUTHENTICATION = "authentication",
+    RATE_LIMIT = "rate_limit",
+    QUOTA_EXCEEDED = "quota_exceeded",
+    INVALID_REQUEST = "invalid_request",
+    SERVER_ERROR = "server_error",
+    TIMEOUT = "timeout",
+    CONFIGURATION = "configuration",
+    VALIDATION = "validation",
+    UNKNOWN = "unknown"
+}
+/**
+ * Retry configuration for different error types
+ */
+export interface RetryConfig {
+    maxRetries: number;
+    baseDelay: number;
+    maxDelay: number;
+    backoffMultiplier: number;
+    retryableErrors: ErrorType[];
+}
+/**
+ * Default retry configuration
+ */
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+/**
+ * API operation error with context and recovery suggestions
+ */
+export declare class APIError extends Error {
+    readonly type: ErrorType;
+    readonly statusCode?: number;
+    readonly retryAfter?: number;
+    readonly quotaReset?: Date;
+    readonly suggestions: string[];
+    readonly context: Record<string, any>;
+    constructor(message: string, type: ErrorType, options?: {
+        statusCode?: number;
+        retryAfter?: number;
+        quotaReset?: Date;
+        suggestions?: string[];
+        context?: Record<string, any>;
+        cause?: Error;
+    });
+}
+/**
+ * Comprehensive error handler for API operations
+ */
+export declare class ErrorHandler {
+    /**
+     * Handle and classify API errors
+     */
+    static handleAPIError(error: any, context?: Record<string, any>): APIError;
+    /**
+     * Handle HTTP status code errors
+     */
+    private static handleHTTPError;
+    /**
+     * Check if error is a network/connection error
+     */
+    private static isNetworkError;
+    /**
+     * Check if error is a timeout error
+     */
+    private static isTimeoutError;
+    /**
+     * Check if error is a configuration error
+     */
+    private static isConfigurationError;
+    /**
+     * Parse retry-after header
+     */
+    private static parseRetryAfter;
+    /**
+     * Parse quota reset time from headers
+     */
+    private static parseQuotaReset;
+    /**
+     * Retry operation with exponential backoff
+     */
+    static withRetry<T>(operation: () => Promise<T>, config?: Partial<RetryConfig>): Promise<T>;
+    /**
+     * Display error to user with helpful information
+     */
+    static displayError(error: APIError): void;
+    /**
+     * Get fallback mode suggestions when APIs are unavailable
+     */
+    static getFallbackSuggestions(errorType: ErrorType): string[];
+    /**
+     * Check if operation should continue in fallback mode
+     */
+    static shouldUseFallbackMode(error: APIError): boolean;
+    /**
+     * Sleep for specified milliseconds
+     */
+    private static sleep;
+    /**
+     * Validate API response structure
+     */
+    static validateAPIResponse(response: any, expectedFields: string[]): void;
+    /**
+     * Create context object for error reporting
+     */
+    static createContext(operation: string, params?: Record<string, any>): Record<string, any>;
+}
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/core/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/core/error-handler.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,oBAAY,SAAS;IACnB,OAAO,YAAY;IACnB,cAAc,mBAAmB;IACjC,UAAU,eAAe;IACzB,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,YAAY,iBAAiB;IAC7B,OAAO,YAAY;IACnB,aAAa,kBAAkB;IAC/B,UAAU,eAAe;IACzB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,SAAS,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAWlC,CAAC;AAEF;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpC,SAAgB,UAAU,CAAC,EAAE,IAAI,CAAC;IAClC,SAAgB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtC,SAAgB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBAG3C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,EACf,OAAO,GAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,IAAI,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC9B,KAAK,CAAC,EAAE,KAAK,CAAC;KACV;CAeT;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,QAAQ;IA8E9E;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IA0G9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAW7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAQ7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAQnC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAS9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAS9B;;OAEG;WACU,SAAS,CAAC,CAAC,EACtB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAChC,OAAO,CAAC,CAAC,CAAC;IAsCb;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IA6B1C;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,EAAE;IAkC7D;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAUtD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,KAAK;IAIpB;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI;IAgCzE;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAQ3F"}