@mweinbach/apple-docs-mcp 1.0.0

package/dist/utils/http-headers-generator.d.ts

@@ -0,0 +1,151 @@
+/**
+ * HTTP Headers Generator for browser compatibility and anti-detection
+ *
+ * Generates browser-specific HTTP headers to make requests appear more authentic
+ * and reduce the likelihood of being detected as automated requests.
+ *
+ * Features:
+ * - Browser-specific header templates (Chrome, Firefox, Safari, Edge)
+ * - Accept-Language rotation for geographic diversity
+ * - Sec-Fetch-* headers for modern browser simulation
+ * - Configurable privacy settings (DNT, etc.)
+ * - Custom header override support
+ * - High-performance singleton pattern
+ */
+import type { HeaderGeneratorConfig, UserAgent } from '../types/headers.js';
+/**
+ * HTTP Headers Generator
+ *
+ * Generates authentic browser headers based on User-Agent strings and configuration.
+ * Uses singleton pattern for optimal performance and memory usage.
+ *
+ * @example
+ * ```typescript
+ * const generator = HttpHeadersGenerator.getInstance();
+ *
+ * const userAgent = {
+ *   userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)...',
+ *   browserType: 'chrome',
+ *   version: '121.0.0.0',
+ *   os: 'macOS',
+ *   osVersion: '10.15.7'
+ * };
+ *
+ * const headers = generator.generateHeaders(userAgent);
+ * console.log(headers['Accept-Language']); // "en-US,en;q=0.9"
+ * ```
+ */
+export declare class HttpHeadersGenerator {
+    private static instance;
+    private config;
+    private languageRotationIndex;
+    private constructor();
+    /**
+     * Get singleton instance of HttpHeadersGenerator
+     *
+     * @param config - Optional configuration to override defaults
+     * @returns Singleton instance of HttpHeadersGenerator
+     */
+    static getInstance(config?: HeaderGeneratorConfig): HttpHeadersGenerator;
+    /**
+     * Generate complete HTTP headers for a given User-Agent
+     *
+     * Creates a complete set of HTTP headers that match the browser type
+     * and configuration. Headers are generated to appear authentic and
+     * reduce detection risk.
+     *
+     * @param userAgent - UserAgent object containing browser information
+     * @param customHeaders - Optional custom headers to override generated ones
+     * @returns Complete set of HTTP headers
+     */
+    generateHeaders(userAgent: UserAgent, customHeaders?: Record<string, string>): Record<string, string>;
+    /**
+     * Get header template for browser type
+     *
+     * @param browserType - Type of browser
+     * @returns Header template for the browser
+     */
+    private getHeaderTemplate;
+    /**
+     * Generate Accept-Language header with rotation
+     *
+     * @returns Accept-Language header value
+     */
+    private generateLanguageHeader;
+    /**
+     * Generate Sec-Fetch-* headers for modern browsers
+     *
+     * @param browserType - Type of browser
+     * @param config - Optional Sec-Fetch configuration
+     * @returns Sec-Fetch headers object
+     */
+    private generateSecFetchHeaders;
+    /**
+     * Generate Do Not Track header
+     *
+     * @returns DNT header value
+     */
+    private generateDNTHeader;
+    /**
+     * Generate dynamic headers based on User-Agent details
+     *
+     * @param userAgent - UserAgent object
+     * @returns Dynamic headers object
+     */
+    private generateDynamicHeaders;
+    /**
+     * Get custom template headers for browser type
+     *
+     * @param browserType - Type of browser
+     * @returns Custom headers from configuration
+     */
+    private getCustomTemplateHeaders;
+    /**
+     * Check if browser supports Sec-Fetch headers
+     *
+     * @param browserType - Type of browser
+     * @returns Whether browser supports Sec-Fetch headers
+     */
+    private supportsBrowserSecFetch;
+    /**
+     * Update configuration
+     *
+     * @param config - New configuration to merge
+     */
+    updateConfig(config: Partial<HeaderGeneratorConfig>): void;
+    /**
+     * Get current configuration
+     *
+     * @returns Current configuration (read-only)
+     */
+    getConfig(): Readonly<Required<HeaderGeneratorConfig>>;
+    /**
+     * Reset language rotation index
+     */
+    resetLanguageRotation(): void;
+    /**
+     * Get current language rotation index
+     *
+     * @returns Current rotation index
+     */
+    getLanguageRotationIndex(): number;
+    /**
+     * Validate generated headers for consistency
+     *
+     * @param headers - Headers to validate
+     * @param userAgent - Original UserAgent object
+     * @returns Validation result with any warnings
+     */
+    validateHeaders(headers: Record<string, string>, userAgent: UserAgent): {
+        valid: boolean;
+        warnings: string[];
+    };
+}
+/**
+ * Convenience function to create a UserAgent object from a User-Agent string
+ *
+ * @param userAgentString - Raw User-Agent string
+ * @returns UserAgent object with parsed information
+ */
+export declare function parseUserAgent(userAgentString: string): UserAgent;
+//# sourceMappingURL=http-headers-generator.d.ts.map

package/dist/utils/http-headers-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-headers-generator.d.ts","sourceRoot":"","sources":["../../src/utils/http-headers-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAGV,qBAAqB,EACrB,SAAS,EAEV,MAAM,qBAAqB,CAAC;AAwB7B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuB;IAC9C,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,qBAAqB,CAAK;IAElC,OAAO;IAIP;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,GAAE,qBAA0B,GAAG,oBAAoB;IAc5E;;;;;;;;;;OAUG;IACH,eAAe,CACb,SAAS,EAAE,SAAS,EACpB,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACzC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAyDzB;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAe9B;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAyB/B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAkC9B;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;IAiBhC;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IAK/B;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,IAAI;IAI1D;;;;OAIG;IACH,SAAS,IAAI,QAAQ,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IAItD;;OAEG;IACH,qBAAqB,IAAI,IAAI;IAI7B;;;;OAIG;IACH,wBAAwB,IAAI,MAAM;IAIlC;;;;;;OAMG;IACH,eAAe,CACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,SAAS,EAAE,SAAS,GACnB;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;CAyB1C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,CAiFjE"}

package/dist/utils/http-headers-generator.js

@@ -0,0 +1,407 @@
+/**
+ * HTTP Headers Generator for browser compatibility and anti-detection
+ *
+ * Generates browser-specific HTTP headers to make requests appear more authentic
+ * and reduce the likelihood of being detected as automated requests.
+ *
+ * Features:
+ * - Browser-specific header templates (Chrome, Firefox, Safari, Edge)
+ * - Accept-Language rotation for geographic diversity
+ * - Sec-Fetch-* headers for modern browser simulation
+ * - Configurable privacy settings (DNT, etc.)
+ * - Custom header override support
+ * - High-performance singleton pattern
+ */
+import { BROWSER_HEADERS, SIMPLE_BROWSER_HEADERS, LANGUAGE_PREFERENCES, PLATFORM_VALUES, BROWSER_VERSIONS, DNT_VALUES, CACHE_CONTROL_VALUES, } from '../constants/browser-headers.js';
+/**
+ * Default configuration for header generation
+ */
+const DEFAULT_CONFIG = {
+    enableSecFetch: true,
+    enableDNT: true,
+    languageRotation: true,
+    customTemplates: {},
+    defaultAcceptLanguage: 'en-US,en;q=0.9',
+    simpleMode: false,
+};
+/**
+ * HTTP Headers Generator
+ *
+ * Generates authentic browser headers based on User-Agent strings and configuration.
+ * Uses singleton pattern for optimal performance and memory usage.
+ *
+ * @example
+ * ```typescript
+ * const generator = HttpHeadersGenerator.getInstance();
+ *
+ * const userAgent = {
+ *   userAgent: 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)...',
+ *   browserType: 'chrome',
+ *   version: '121.0.0.0',
+ *   os: 'macOS',
+ *   osVersion: '10.15.7'
+ * };
+ *
+ * const headers = generator.generateHeaders(userAgent);
+ * console.log(headers['Accept-Language']); // "en-US,en;q=0.9"
+ * ```
+ */
+export class HttpHeadersGenerator {
+    static instance;
+    config;
+    languageRotationIndex = 0;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Get singleton instance of HttpHeadersGenerator
+     *
+     * @param config - Optional configuration to override defaults
+     * @returns Singleton instance of HttpHeadersGenerator
+     */
+    static getInstance(config = {}) {
+        if (!HttpHeadersGenerator.instance) {
+            HttpHeadersGenerator.instance = new HttpHeadersGenerator(config);
+        }
+        else if (Object.keys(config).length > 0) {
+            // Update configuration if provided
+            HttpHeadersGenerator.instance.config = {
+                ...HttpHeadersGenerator.instance.config,
+                ...config,
+            };
+        }
+        return HttpHeadersGenerator.instance;
+    }
+    /**
+     * Generate complete HTTP headers for a given User-Agent
+     *
+     * Creates a complete set of HTTP headers that match the browser type
+     * and configuration. Headers are generated to appear authentic and
+     * reduce detection risk.
+     *
+     * @param userAgent - UserAgent object containing browser information
+     * @param customHeaders - Optional custom headers to override generated ones
+     * @returns Complete set of HTTP headers
+     */
+    generateHeaders(userAgent, customHeaders = {}) {
+        // Get base template for browser type
+        const baseTemplate = this.getHeaderTemplate(userAgent.browserType);
+        // Generate dynamic headers
+        const generatedHeaders = {
+            'User-Agent': userAgent.userAgent,
+        };
+        // Apply base template only if not disabled
+        Object.entries(baseTemplate).forEach(([key, value]) => {
+            // Skip Sec-Fetch headers if disabled
+            if (!this.config.enableSecFetch && key.startsWith('Sec-Fetch-')) {
+                return;
+            }
+            // Skip DNT if disabled
+            if (!this.config.enableDNT && key === 'DNT') {
+                return;
+            }
+            generatedHeaders[key] = value;
+        });
+        // Apply language rotation if enabled, otherwise use default or browser-specific
+        if (this.config.languageRotation) {
+            generatedHeaders['Accept-Language'] = this.generateLanguageHeader();
+        }
+        else if (this.config.defaultAcceptLanguage &&
+            this.config.defaultAcceptLanguage !== 'en-US,en;q=0.9') {
+            generatedHeaders['Accept-Language'] = this.config.defaultAcceptLanguage;
+        }
+        // Apply Sec-Fetch headers if enabled and supported and not in simple mode
+        if (this.config.enableSecFetch && !this.config.simpleMode && this.supportsBrowserSecFetch(userAgent.browserType)) {
+            const secFetchHeaders = this.generateSecFetchHeaders(userAgent.browserType);
+            Object.assign(generatedHeaders, secFetchHeaders);
+        }
+        // Apply DNT randomization if enabled
+        if (this.config.enableDNT) {
+            generatedHeaders['DNT'] = this.generateDNTHeader();
+        }
+        // Apply browser-specific dynamic headers (not in simple mode)
+        if (!this.config.simpleMode) {
+            const dynamicHeaders = this.generateDynamicHeaders(userAgent);
+            Object.assign(generatedHeaders, dynamicHeaders);
+        }
+        // Apply custom templates from configuration
+        const customTemplateHeaders = this.getCustomTemplateHeaders(userAgent.browserType);
+        Object.assign(generatedHeaders, customTemplateHeaders);
+        // Apply user-provided custom headers (highest priority)
+        Object.assign(generatedHeaders, customHeaders);
+        return generatedHeaders;
+    }
+    /**
+     * Get header template for browser type
+     *
+     * @param browserType - Type of browser
+     * @returns Header template for the browser
+     */
+    getHeaderTemplate(browserType) {
+        const templates = this.config.simpleMode ? SIMPLE_BROWSER_HEADERS : BROWSER_HEADERS;
+        return { ...templates[browserType] };
+    }
+    /**
+     * Generate Accept-Language header with rotation
+     *
+     * @returns Accept-Language header value
+     */
+    generateLanguageHeader() {
+        if (LANGUAGE_PREFERENCES.length === 0) {
+            return this.config.defaultAcceptLanguage;
+        }
+        const preferences = LANGUAGE_PREFERENCES[this.languageRotationIndex];
+        this.languageRotationIndex = (this.languageRotationIndex + 1) % LANGUAGE_PREFERENCES.length;
+        return preferences
+            .map(pref => pref.quality && pref.quality < 1.0
+            ? `${pref.language};q=${pref.quality.toFixed(1)}`
+            : pref.language)
+            .join(',');
+    }
+    /**
+     * Generate Sec-Fetch-* headers for modern browsers
+     *
+     * @param browserType - Type of browser
+     * @param config - Optional Sec-Fetch configuration
+     * @returns Sec-Fetch headers object
+     */
+    generateSecFetchHeaders(_browserType, config = {}) {
+        const defaultConfig = {
+            dest: 'document',
+            mode: 'navigate',
+            site: 'none',
+            user: true,
+            ...config,
+        };
+        const headers = {
+            'Sec-Fetch-Dest': defaultConfig.dest,
+            'Sec-Fetch-Mode': defaultConfig.mode,
+            'Sec-Fetch-Site': defaultConfig.site,
+        };
+        if (defaultConfig.user) {
+            headers['Sec-Fetch-User'] = '?1';
+        }
+        return headers;
+    }
+    /**
+     * Generate Do Not Track header
+     *
+     * @returns DNT header value
+     */
+    generateDNTHeader() {
+        return DNT_VALUES[Math.floor(Math.random() * DNT_VALUES.length)];
+    }
+    /**
+     * Generate dynamic headers based on User-Agent details
+     *
+     * @param userAgent - UserAgent object
+     * @returns Dynamic headers object
+     */
+    generateDynamicHeaders(userAgent) {
+        const headers = {};
+        // Generate Sec-CH-UA headers for Chrome/Edge
+        if (userAgent.browserType === 'chrome' || userAgent.browserType === 'edge') {
+            const versions = BROWSER_VERSIONS[userAgent.browserType];
+            if (versions && versions.length > 0) {
+                headers['Sec-CH-UA'] = versions[Math.floor(Math.random() * versions.length)];
+            }
+            // Set mobile indicator
+            headers['Sec-CH-UA-Mobile'] = '?0';
+            // Set platform based on OS
+            if (userAgent.os.toLowerCase().includes('mac')) {
+                const platforms = PLATFORM_VALUES.macOS;
+                headers['Sec-CH-UA-Platform'] = platforms[Math.floor(Math.random() * platforms.length)];
+            }
+            else if (userAgent.os.toLowerCase().includes('windows')) {
+                headers['Sec-CH-UA-Platform'] = PLATFORM_VALUES.windows[0];
+            }
+            else if (userAgent.os.toLowerCase().includes('linux')) {
+                headers['Sec-CH-UA-Platform'] = PLATFORM_VALUES.linux[0];
+            }
+        }
+        // Randomize Cache-Control occasionally
+        if (Math.random() < 0.1) { // 10% chance to vary cache control
+            headers['Cache-Control'] = CACHE_CONTROL_VALUES[Math.floor(Math.random() * CACHE_CONTROL_VALUES.length)];
+        }
+        return headers;
+    }
+    /**
+     * Get custom template headers for browser type
+     *
+     * @param browserType - Type of browser
+     * @returns Custom headers from configuration
+     */
+    getCustomTemplateHeaders(browserType) {
+        const customTemplate = this.config.customTemplates[browserType];
+        if (!customTemplate) {
+            return {};
+        }
+        // Filter out undefined values
+        const filtered = {};
+        Object.entries(customTemplate).forEach(([key, value]) => {
+            if (value !== undefined) {
+                filtered[key] = value;
+            }
+        });
+        return filtered;
+    }
+    /**
+     * Check if browser supports Sec-Fetch headers
+     *
+     * @param browserType - Type of browser
+     * @returns Whether browser supports Sec-Fetch headers
+     */
+    supportsBrowserSecFetch(browserType) {
+        // Firefox doesn't support all Sec-Fetch headers, Safari has limited support
+        return browserType === 'chrome' || browserType === 'edge';
+    }
+    /**
+     * Update configuration
+     *
+     * @param config - New configuration to merge
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * Get current configuration
+     *
+     * @returns Current configuration (read-only)
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Reset language rotation index
+     */
+    resetLanguageRotation() {
+        this.languageRotationIndex = 0;
+    }
+    /**
+     * Get current language rotation index
+     *
+     * @returns Current rotation index
+     */
+    getLanguageRotationIndex() {
+        return this.languageRotationIndex;
+    }
+    /**
+     * Validate generated headers for consistency
+     *
+     * @param headers - Headers to validate
+     * @param userAgent - Original UserAgent object
+     * @returns Validation result with any warnings
+     */
+    validateHeaders(headers, userAgent) {
+        const warnings = [];
+        // Check User-Agent consistency
+        if (headers['User-Agent'] !== userAgent.userAgent) {
+            warnings.push('User-Agent header does not match provided UserAgent object');
+        }
+        // Check Accept-Language format
+        const acceptLanguage = headers['Accept-Language'];
+        if (acceptLanguage && !/^[\w-]+(;q=\d\.\d)?(,[\w-]+(;q=\d\.\d)?)*$/.test(acceptLanguage)) {
+            warnings.push('Accept-Language header format may be invalid');
+        }
+        // Check Sec-Fetch headers consistency
+        const hasSecFetch = Object.keys(headers).some(key => key.startsWith('Sec-Fetch-'));
+        if (hasSecFetch && !this.supportsBrowserSecFetch(userAgent.browserType)) {
+            warnings.push(`Sec-Fetch headers present for ${userAgent.browserType} which has limited support`);
+        }
+        return {
+            valid: warnings.length === 0,
+            warnings,
+        };
+    }
+}
+/**
+ * Convenience function to create a UserAgent object from a User-Agent string
+ *
+ * @param userAgentString - Raw User-Agent string
+ * @returns UserAgent object with parsed information
+ */
+export function parseUserAgent(userAgentString) {
+    let browserType = 'chrome'; // default
+    let version = 'unknown';
+    let os = 'unknown';
+    let osVersion = 'unknown';
+    let architecture;
+    // Safari detection
+    if (userAgentString.includes('Safari/') && userAgentString.includes('Version/')) {
+        browserType = 'safari';
+        const versionMatch = userAgentString.match(/Version\/([\d.]+)/);
+        if (versionMatch) {
+            version = versionMatch[1];
+        }
+        // Extract macOS architecture
+        if (userAgentString.includes('Intel Mac OS X')) {
+            architecture = 'Intel';
+        }
+        else if (userAgentString.includes('arm64 Mac OS X')) {
+            architecture = 'Apple Silicon';
+        }
+        // Extract macOS version
+        const macOSMatch = userAgentString.match(/Mac OS X (\d+)_(\d+)(?:_(\d+))?/);
+        if (macOSMatch) {
+            os = 'macOS';
+            osVersion = macOSMatch[3] ? `${macOSMatch[1]}.${macOSMatch[2]}.${macOSMatch[3]}` : `${macOSMatch[1]}.${macOSMatch[2]}`;
+        }
+    }
+    else if (userAgentString.includes('Chrome/') && !userAgentString.includes('Edg/')) {
+        browserType = 'chrome';
+        const chromeMatch = userAgentString.match(/Chrome\/([\d.]+)/);
+        if (chromeMatch) {
+            version = chromeMatch[1];
+        }
+    }
+    else if (userAgentString.includes('Edg/')) {
+        browserType = 'edge';
+        const edgeMatch = userAgentString.match(/Edg\/([\d.]+)/);
+        if (edgeMatch) {
+            version = edgeMatch[1];
+        }
+    }
+    else if (userAgentString.includes('Firefox/')) {
+        browserType = 'firefox';
+        const firefoxMatch = userAgentString.match(/Firefox\/([\d.]+)/);
+        if (firefoxMatch) {
+            version = firefoxMatch[1];
+        }
+    }
+    // Extract OS information for non-Safari browsers
+    if (browserType !== 'safari') {
+        if (userAgentString.includes('Windows NT')) {
+            os = 'Windows';
+            const winMatch = userAgentString.match(/Windows NT ([\d.]+)/);
+            if (winMatch) {
+                osVersion = winMatch[1];
+            }
+        }
+        else if (userAgentString.includes('Mac OS X')) {
+            os = 'macOS';
+            const macMatch = userAgentString.match(/Mac OS X ([\d_.]+)/);
+            if (macMatch) {
+                osVersion = macMatch[1].replace(/_/g, '.');
+            }
+        }
+        else if (userAgentString.includes('Intel Mac OS X')) {
+            os = 'macOS';
+            const macMatch = userAgentString.match(/Intel Mac OS X ([\d.]+)/);
+            if (macMatch) {
+                osVersion = macMatch[1];
+            }
+        }
+        else if (userAgentString.includes('Linux')) {
+            os = 'Linux';
+        }
+    }
+    return {
+        userAgent: userAgentString,
+        browserType,
+        version,
+        os,
+        osVersion,
+        architecture,
+    };
+}
+//# sourceMappingURL=http-headers-generator.js.map

package/dist/utils/http-headers-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-headers-generator.js","sourceRoot":"","sources":["../../src/utils/http-headers-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAUH,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,oBAAoB,GACrB,MAAM,iCAAiC,CAAC;AAEzC;;GAEG;AACH,MAAM,cAAc,GAAoC;IACtD,cAAc,EAAE,IAAI;IACpB,SAAS,EAAE,IAAI;IACf,gBAAgB,EAAE,IAAI;IACtB,eAAe,EAAE,EAAE;IACnB,qBAAqB,EAAE,gBAAgB;IACvC,UAAU,EAAE,KAAK;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,oBAAoB;IACvB,MAAM,CAAC,QAAQ,CAAuB;IACtC,MAAM,CAAkC;IACxC,qBAAqB,GAAG,CAAC,CAAC;IAElC,YAAoB,SAAgC,EAAE;QACpD,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IACjD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,SAAgC,EAAE;QACnD,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,CAAC;YACnC,oBAAoB,CAAC,QAAQ,GAAG,IAAI,oBAAoB,CAAC,MAAM,CAAC,CAAC;QACnE,CAAC;aAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,mCAAmC;YACnC,oBAAoB,CAAC,QAAQ,CAAC,MAAM,GAAG;gBACrC,GAAG,oBAAoB,CAAC,QAAQ,CAAC,MAAM;gBACvC,GAAG,MAAM;aACV,CAAC;QACJ,CAAC;QAED,OAAO,oBAAoB,CAAC,QAAQ,CAAC;IACvC,CAAC;IAED;;;;;;;;;;OAUG;IACH,eAAe,CACb,SAAoB,EACpB,gBAAwC,EAAE;QAE1C,qCAAqC;QACrC,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAEnE,2BAA2B;QAC3B,MAAM,gBAAgB,GAA2B;YAC/C,YAAY,EAAE,SAAS,CAAC,SAAS;SAClC,CAAC;QAEF,2CAA2C;QAC3C,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YACpD,qCAAqC;YACrC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBAChE,OAAO;YACT,CAAC;YACD,uBAAuB;YACvB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;gBAC5C,OAAO;YACT,CAAC;YACD,gBAAgB,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAChC,CAAC,CAAC,CAAC;QAEH,gFAAgF;QAChF,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;YACjC,gBAAgB,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC;QACtE,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,CAAC,qBAAqB;YACjC,IAAI,CAAC,MAAM,CAAC,qBAAqB,KAAK,gBAAgB,EAAE,CAAC;YAClE,gBAAgB,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC;QAC1E,CAAC;QAED,0EAA0E;QAC1E,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC,uBAAuB,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;YACjH,MAAM,eAAe,GAAG,IAAI,CAAC,uBAAuB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YAC5E,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;QACnD,CAAC;QAED,qCAAqC;QACrC,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC1B,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACrD,CAAC;QAED,8DAA8D;QAC9D,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAC5B,MAAM,cAAc,GAAG,IAAI,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;YAC9D,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;QAClD,CAAC;QAED,4CAA4C;QAC5C,MAAM,qBAAqB,GAAG,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACnF,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,qBAAqB,CAAC,CAAC;QAEvD,wDAAwD;QACxD,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC;QAE/C,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACK,iBAAiB,CAAC,WAAwB;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,eAAe,CAAC;QACpF,OAAO,EAAE,GAAG,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACK,sBAAsB;QAC5B,IAAI,oBAAoB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC;QAC3C,CAAC;QAED,MAAM,WAAW,GAAG,oBAAoB,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACrE,IAAI,CAAC,qBAAqB,GAAG,CAAC,IAAI,CAAC,qBAAqB,GAAG,CAAC,CAAC,GAAG,oBAAoB,CAAC,MAAM,CAAC;QAE5F,OAAO,WAAW;aACf,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,GAAG,GAAG;YAC7C,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YACjD,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;aACjB,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAED;;;;;;OAMG;IACK,uBAAuB,CAC7B,YAAyB,EACzB,SAAkC,EAAE;QAEpC,MAAM,aAAa,GAAmB;YACpC,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,IAAI;YACV,GAAG,MAAM;SACV,CAAC;QAEF,MAAM,OAAO,GAA2B;YACtC,gBAAgB,EAAE,aAAa,CAAC,IAAI;YACpC,gBAAgB,EAAE,aAAa,CAAC,IAAI;YACpC,gBAAgB,EAAE,aAAa,CAAC,IAAI;SACrC,CAAC;QAEF,IAAI,aAAa,CAAC,IAAI,EAAE,CAAC;YACvB,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;QACnC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACK,iBAAiB;QACvB,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACnE,CAAC;IAED;;;;;OAKG;IACK,sBAAsB,CAAC,SAAoB;QACjD,MAAM,OAAO,GAA2B,EAAE,CAAC;QAE3C,6CAA6C;QAC7C,IAAI,SAAS,CAAC,WAAW,KAAK,QAAQ,IAAI,SAAS,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;YAC3E,MAAM,QAAQ,GAAG,gBAAgB,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YACzD,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpC,OAAO,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;YAC/E,CAAC;YAED,uBAAuB;YACvB,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC;YAEnC,2BAA2B;YAC3B,IAAI,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/C,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC;gBACxC,OAAO,CAAC,oBAAoB,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;YAC1F,CAAC;iBAAM,IAAI,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1D,OAAO,CAAC,oBAAoB,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC7D,CAAC;iBAAM,IAAI,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxD,OAAO,CAAC,oBAAoB,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QAED,uCAAuC;QACvC,IAAI,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,mCAAmC;YAC5D,OAAO,CAAC,eAAe,CAAC,GAAG,oBAAoB,CAC7C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,oBAAoB,CAAC,MAAM,CAAC,CACxD,CAAC;QACJ,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACK,wBAAwB,CAAC,WAAwB;QACvD,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QAChE,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,8BAA8B;QAC9B,MAAM,QAAQ,GAA2B,EAAE,CAAC;QAC5C,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YACtD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACxB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;OAKG;IACK,uBAAuB,CAAC,WAAwB;QACtD,4EAA4E;QAC5E,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,KAAK,MAAM,CAAC;IAC5D,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,MAAsC;QACjD,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACH,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,qBAAqB;QACnB,IAAI,CAAC,qBAAqB,GAAG,CAAC,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,wBAAwB;QACtB,OAAO,IAAI,CAAC,qBAAqB,CAAC;IACpC,CAAC;IAED;;;;;;OAMG;IACH,eAAe,CACb,OAA+B,EAC/B,SAAoB;QAEpB,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,+BAA+B;QAC/B,IAAI,OAAO,CAAC,YAAY,CAAC,KAAK,SAAS,CAAC,SAAS,EAAE,CAAC;YAClD,QAAQ,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QAC9E,CAAC;QAED,+BAA+B;QAC/B,MAAM,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;QAClD,IAAI,cAAc,IAAI,CAAC,4CAA4C,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;YACzF,QAAQ,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAChE,CAAC;QAED,sCAAsC;QACtC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;QACnF,IAAI,WAAW,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC;YACxE,QAAQ,CAAC,IAAI,CAAC,iCAAiC,SAAS,CAAC,WAAW,4BAA4B,CAAC,CAAC;QACpG,CAAC;QAED,OAAO;YACL,KAAK,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC;YAC5B,QAAQ;SACT,CAAC;IACJ,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,eAAuB;IACpD,IAAI,WAAW,GAAgB,QAAQ,CAAC,CAAC,UAAU;IACnD,IAAI,OAAO,GAAG,SAAS,CAAC;IACxB,IAAI,EAAE,GAAG,SAAS,CAAC;IACnB,IAAI,SAAS,GAAG,SAAS,CAAC;IAC1B,IAAI,YAAgC,CAAC;IAErC,mBAAmB;IACnB,IAAI,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAChF,WAAW,GAAG,QAAQ,CAAC;QACvB,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAChE,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;QAED,6BAA6B;QAC7B,IAAI,eAAe,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC/C,YAAY,GAAG,OAAO,CAAC;QACzB,CAAC;aAAM,IAAI,eAAe,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACtD,YAAY,GAAG,eAAe,CAAC;QACjC,CAAC;QAED,wBAAwB;QACxB,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QAC5E,IAAI,UAAU,EAAE,CAAC;YACf,EAAE,GAAG,OAAO,CAAC;YACb,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACzH,CAAC;IACH,CAAC;SAAM,IAAI,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACpF,WAAW,GAAG,QAAQ,CAAC;QACvB,MAAM,WAAW,GAAG,eAAe,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAC9D,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;SAAM,IAAI,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,WAAW,GAAG,MAAM,CAAC;QACrB,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACzD,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;SAAM,IAAI,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAChD,WAAW,GAAG,SAAS,CAAC;QACxB,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAChE,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,IAAI,WAAW,KAAK,QAAQ,EAAE,CAAC;QAC7B,IAAI,eAAe,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YAC3C,EAAE,GAAG,SAAS,CAAC;YACf,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;YAC9D,IAAI,QAAQ,EAAE,CAAC;gBACb,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;aAAM,IAAI,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAChD,EAAE,GAAG,OAAO,CAAC;YACb,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAC7D,IAAI,QAAQ,EAAE,CAAC;gBACb,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;aAAM,IAAI,eAAe,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACtD,EAAE,GAAG,OAAO,CAAC;YACb,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAClE,IAAI,QAAQ,EAAE,CAAC;gBACb,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;aAAM,IAAI,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7C,EAAE,GAAG,OAAO,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO;QACL,SAAS,EAAE,eAAe;QAC1B,WAAW;QACX,OAAO;QACP,EAAE;QACF,SAAS;QACT,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Simple logger utility for consistent logging across the application
+ */
+export declare enum LogLevel {
+    DEBUG = "debug",
+    INFO = "info",
+    WARN = "warn",
+    ERROR = "error"
+}
+declare class Logger {
+    private enabled;
+    private level;
+    /**
+     * Log debug message
+     */
+    debug(message: string, ...args: any[]): void;
+    /**
+     * Log info message
+     */
+    info(message: string, ...args: any[]): void;
+    /**
+     * Log warning message
+     */
+    warn(message: string, ...args: any[]): void;
+    /**
+     * Log error message
+     */
+    error(message: string, error?: unknown): void;
+    /**
+     * Check if should log based on level
+     */
+    private shouldLog;
+    /**
+     * Set log level
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Enable/disable logging
+     */
+    setEnabled(enabled: boolean): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED,cAAM,MAAM;IACV,OAAO,CAAC,OAAO,CAA6C;IAC5D,OAAO,CAAC,KAAK,CAA2B;IAExC;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM5C;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM3C;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAM3C;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAS7C;;OAEG;IACH,OAAO,CAAC,SAAS;IAOjB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAGnC;AAGD,eAAO,MAAM,MAAM,QAAe,CAAC"}