@mweinbach/apple-docs-mcp 1.0.0

package/dist/utils/cache.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Simple in-memory cache with TTL (Time To Live) support
+ */
+export declare class MemoryCache {
+    private cache;
+    private maxSize;
+    private defaultTTL;
+    private hits;
+    private misses;
+    constructor(maxSize?: number, defaultTTL?: number);
+    /**
+     * Get the current size of the cache
+     */
+    size(): number;
+    /**
+     * Get all entries as array of [key, value] pairs
+     */
+    entries(): [string, unknown][];
+    /**
+     * Get value from cache
+     */
+    get<T>(key: string): T | undefined;
+    /**
+     * Set value in cache
+     */
+    set<T>(key: string, value: T, ttl?: number): void;
+    /**
+     * Check if key exists and is not expired
+     */
+    has(key: string): boolean;
+    /**
+     * Delete entry from cache
+     */
+    delete(key: string): boolean;
+    /**
+     * Clear all cache entries
+     */
+    clear(): void;
+    /**
+     * Clean up expired entries
+     */
+    private cleanup;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        size: number;
+        maxSize: number;
+        hitRate: string;
+        hits: number;
+        misses: number;
+    };
+    /**
+     * Get or set with async function
+     */
+    getOrSet<T>(key: string, fetchFn: () => Promise<T>, ttl?: number): Promise<T>;
+}
+export declare const apiCache: MemoryCache;
+export declare const searchCache: MemoryCache;
+export declare const indexCache: MemoryCache;
+export declare const technologiesCache: MemoryCache;
+export declare const updatesCache: MemoryCache;
+export declare const sampleCodeCache: MemoryCache;
+export declare const technologyOverviewsCache: MemoryCache;
+export declare const wwdcDataCache: MemoryCache;
+/**
+ * Generate cache key for URL-based requests
+ */
+export declare function generateUrlCacheKey(url: string, params?: Record<string, unknown>): string;
+/**
+ * Generate cache key for enhanced analysis
+ */
+export declare function generateEnhancedCacheKey(url: string, options: {
+    includeRelatedApis?: boolean;
+    includeReferences?: boolean;
+    includeSimilarApis?: boolean;
+    includePlatformAnalysis?: boolean;
+}): string;
+/**
+ * Cache decorator for async functions
+ */
+export declare function cached<T>(cache: MemoryCache, keyGenerator: (...args: unknown[]) => string, ttl?: number): (_target: unknown, _propertyName: string, descriptor: PropertyDescriptor) => void;
+/**
+ * Cache decorator (alias for compatibility)
+ */
+export declare function withCache<T = any>(cache: MemoryCache, keyGenerator?: (...args: any[]) => string, ttl?: number): (_target: any, _propertyName: string, descriptor?: PropertyDescriptor) => PropertyDescriptor;
+export declare function getCacheInstance(name: string, maxSize?: number, defaultTTL?: number): MemoryCache;
+/**
+ * Cache info for response metadata
+ */
+export interface CacheInfo {
+    cached: boolean;
+    cachedAt?: string;
+    expiresIn?: string;
+    source: 'api' | 'search' | 'index' | 'technologies' | 'updates' | 'samples' | 'overviews' | 'wwdc';
+}
+/**
+ * Get cache info for a key
+ */
+export declare function getCacheInfo(cache: MemoryCache, key: string): CacheInfo | null;
+/**
+ * Format response with cache hints
+ */
+export declare function formatWithCacheHint(content: string, cacheInfo: CacheInfo | null): string;
+/**
+ * Get all cache statistics for performance reporting
+ */
+export declare function getAllCacheStats(): Record<string, ReturnType<MemoryCache['getStats']>>;
+//# sourceMappingURL=cache.d.ts.map

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

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

package/dist/utils/cache.js

@@ -0,0 +1,302 @@
+/**
+ * Simple in-memory cache with TTL (Time To Live) support
+ */
+export class MemoryCache {
+    cache = new Map();
+    maxSize;
+    defaultTTL;
+    hits = 0;
+    misses = 0;
+    constructor(maxSize = 1000, defaultTTL = 30 * 60 * 1000) {
+        this.maxSize = maxSize;
+        this.defaultTTL = defaultTTL;
+        // Clean up expired entries every 5 minutes
+        setInterval(() => this.cleanup(), 5 * 60 * 1000);
+    }
+    /**
+     * Get the current size of the cache
+     */
+    size() {
+        return this.cache.size;
+    }
+    /**
+     * Get all entries as array of [key, value] pairs
+     */
+    entries() {
+        const result = [];
+        const now = Date.now();
+        for (const [key, entry] of this.cache.entries()) {
+            if (now - entry.timestamp <= entry.ttl) {
+                result.push([key, entry.data]);
+            }
+        }
+        return result;
+    }
+    /**
+     * Get value from cache
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.misses++;
+            return undefined;
+        }
+        // Check if expired
+        if (Date.now() - entry.timestamp > entry.ttl) {
+            this.cache.delete(key);
+            this.misses++;
+            return undefined;
+        }
+        this.hits++;
+        return entry.data;
+    }
+    /**
+     * Set value in cache
+     */
+    set(key, value, ttl) {
+        // If cache is full, remove oldest entry
+        if (this.cache.size >= this.maxSize) {
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey) {
+                this.cache.delete(firstKey);
+            }
+        }
+        this.cache.set(key, {
+            data: value,
+            timestamp: Date.now(),
+            ttl: ttl ?? this.defaultTTL,
+        });
+    }
+    /**
+     * Check if key exists and is not expired
+     */
+    has(key) {
+        return this.get(key) !== undefined;
+    }
+    /**
+     * Delete entry from cache
+     */
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    /**
+     * Clear all cache entries
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Clean up expired entries
+     */
+    cleanup() {
+        const now = Date.now();
+        for (const [key, entry] of this.cache.entries()) {
+            if (now - entry.timestamp > entry.ttl) {
+                this.cache.delete(key);
+            }
+        }
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        const total = this.hits + this.misses;
+        const hitRate = total > 0 ? (this.hits / total * 100).toFixed(2) + '%' : '0.00%';
+        return {
+            size: this.cache.size,
+            maxSize: this.maxSize,
+            hitRate,
+            hits: this.hits,
+            misses: this.misses,
+        };
+    }
+    /**
+     * Get or set with async function
+     */
+    async getOrSet(key, fetchFn, ttl) {
+        // Try to get from cache first
+        const cached = this.get(key);
+        if (cached !== undefined) {
+            return cached;
+        }
+        // Fetch new data
+        const data = await fetchFn();
+        // Store in cache
+        this.set(key, data, ttl);
+        return data;
+    }
+}
+import { CACHE_SIZE, CACHE_TTL } from './constants.js';
+// Create different cache instances for different types of data
+export const apiCache = new MemoryCache(CACHE_SIZE.API_DOCS, CACHE_TTL.API_DOCS);
+export const searchCache = new MemoryCache(CACHE_SIZE.SEARCH_RESULTS, CACHE_TTL.SEARCH_RESULTS);
+export const indexCache = new MemoryCache(CACHE_SIZE.FRAMEWORK_INDEX, CACHE_TTL.FRAMEWORK_INDEX);
+export const technologiesCache = new MemoryCache(CACHE_SIZE.TECHNOLOGIES, CACHE_TTL.TECHNOLOGIES);
+export const updatesCache = new MemoryCache(CACHE_SIZE.UPDATES, CACHE_TTL.UPDATES);
+export const sampleCodeCache = new MemoryCache(CACHE_SIZE.SAMPLE_CODE, CACHE_TTL.SAMPLE_CODE);
+export const technologyOverviewsCache = new MemoryCache(CACHE_SIZE.TECHNOLOGY_OVERVIEWS, CACHE_TTL.TECHNOLOGY_OVERVIEWS);
+export const wwdcDataCache = new MemoryCache(100, 30 * 60 * 1000); // 30 minutes TTL
+/**
+ * Generate cache key for URL-based requests
+ */
+export function generateUrlCacheKey(url, params) {
+    let key = url;
+    if (params) {
+        const sortedParams = Object.keys(params)
+            .sort()
+            .map(k => `${k}=${JSON.stringify(params[k])}`)
+            .join('&');
+        key += `?${sortedParams}`;
+    }
+    return key;
+}
+/**
+ * Generate cache key for enhanced analysis
+ */
+export function generateEnhancedCacheKey(url, options) {
+    return generateUrlCacheKey(url, options);
+}
+/**
+ * Cache decorator for async functions
+ */
+export function cached(cache, keyGenerator, ttl) {
+    return function (_target, _propertyName, descriptor) {
+        const method = descriptor.value;
+        descriptor.value = async function (...args) {
+            const key = keyGenerator(...args);
+            return cache.getOrSet(key, () => method.apply(this, args), ttl);
+        };
+    };
+}
+/**
+ * Cache decorator (alias for compatibility)
+ */
+export function withCache(cache, keyGenerator, ttl) {
+    return function (_target, _propertyName, descriptor) {
+        // Handle the case where descriptor might be undefined (TypeScript decorators)
+        if (!descriptor) {
+            throw new Error('withCache decorator requires a method descriptor');
+        }
+        const method = descriptor.value;
+        if (!method) {
+            throw new Error('withCache decorator can only be applied to methods');
+        }
+        const isAsync = method.constructor.name === 'AsyncFunction';
+        descriptor.value = function (...args) {
+            const key = keyGenerator ? keyGenerator(...args) : JSON.stringify(args);
+            // Try to get from cache first
+            const cached = cache.get(key);
+            if (cached !== undefined) {
+                return cached;
+            }
+            // Execute the method
+            const result = method.apply(this, args);
+            // Handle both sync and async methods
+            if (isAsync || result instanceof Promise) {
+                return Promise.resolve(result).then((data) => {
+                    cache.set(key, data, ttl);
+                    return data;
+                }).catch((error) => {
+                    // Don't cache errors
+                    throw error;
+                });
+            }
+            else {
+                // Sync method
+                cache.set(key, result, ttl);
+                return result;
+            }
+        };
+        return descriptor;
+    };
+}
+/**
+ * Get cache instance by name (singleton pattern)
+ */
+const cacheInstances = new Map();
+export function getCacheInstance(name, maxSize, defaultTTL) {
+    if (!cacheInstances.has(name)) {
+        cacheInstances.set(name, new MemoryCache(maxSize, defaultTTL));
+    }
+    return cacheInstances.get(name);
+}
+/**
+ * Get cache info for a key
+ */
+export function getCacheInfo(cache, key) {
+    const entry = cache.cache?.get(key);
+    if (!entry) {
+        return null;
+    }
+    const now = Date.now();
+    const age = now - entry.timestamp;
+    const remaining = entry.ttl - age;
+    if (remaining <= 0) {
+        return null; // Expired
+    }
+    return {
+        cached: true,
+        cachedAt: new Date(entry.timestamp).toISOString(),
+        expiresIn: formatDuration(remaining),
+        source: getCacheSource(cache),
+    };
+}
+/**
+ * Get cache source name
+ */
+function getCacheSource(cache) {
+    if (cache === apiCache)
+        return 'api';
+    if (cache === searchCache)
+        return 'search';
+    if (cache === indexCache)
+        return 'index';
+    if (cache === technologiesCache)
+        return 'technologies';
+    if (cache === updatesCache)
+        return 'updates';
+    if (cache === sampleCodeCache)
+        return 'samples';
+    if (cache === technologyOverviewsCache)
+        return 'overviews';
+    if (cache === wwdcDataCache)
+        return 'wwdc';
+    return 'api';
+}
+/**
+ * Format duration in human-readable format
+ */
+function formatDuration(ms) {
+    if (ms < 60000) {
+        return `${Math.floor(ms / 1000)}s`;
+    }
+    if (ms < 3600000) {
+        return `${Math.floor(ms / 60000)}m`;
+    }
+    return `${Math.floor(ms / 3600000)}h ${Math.floor((ms % 3600000) / 60000)}m`;
+}
+/**
+ * Format response with cache hints
+ */
+export function formatWithCacheHint(content, cacheInfo) {
+    if (!cacheInfo || !cacheInfo.cached) {
+        return content + '\n\n---\n*Data: Fresh from Apple Developer Documentation*';
+    }
+    return content + `\n\n---\n*Data: Cached (${cacheInfo.expiresIn} until refresh)*`;
+}
+/**
+ * Get all cache statistics for performance reporting
+ */
+export function getAllCacheStats() {
+    return {
+        apiCache: apiCache.getStats(),
+        searchCache: searchCache.getStats(),
+        indexCache: indexCache.getStats(),
+        technologiesCache: technologiesCache.getStats(),
+        updatesCache: updatesCache.getStats(),
+        sampleCodeCache: sampleCodeCache.getStats(),
+        technologyOverviewsCache: technologyOverviewsCache.getStats(),
+        wwdcDataCache: wwdcDataCache.getStats(),
+    };
+}
+//# sourceMappingURL=cache.js.map

package/dist/utils/cache.js.map

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

package/dist/utils/constants.d.ts

@@ -0,0 +1,178 @@
+/**
+ * Configuration constants for Apple Docs MCP
+ */
+export declare const API_LIMITS: {
+    readonly MAX_SEARCH_RESULTS: 15;
+    readonly MAX_RELATED_APIS: 10;
+    readonly MAX_REFERENCES: 50;
+    readonly MAX_SIMILAR_APIS: 15;
+    readonly MAX_FRAMEWORK_DEPTH: 10;
+    readonly DEFAULT_FRAMEWORK_DEPTH: 3;
+    readonly DEFAULT_FRAMEWORK_SYMBOLS_LIMIT: 15;
+    readonly DEFAULT_DOCUMENTATION_UPDATES_LIMIT: 15;
+    readonly DEFAULT_TECHNOLOGY_OVERVIEWS_LIMIT: 15;
+    readonly DEFAULT_SAMPLE_CODE_LIMIT: 15;
+    readonly DEFAULT_TECHNOLOGIES_LIMIT: 25;
+    readonly DEFAULT_REFERENCES_LIMIT: 10;
+    readonly MAX_FRAMEWORK_SYMBOLS_LIMIT: 200;
+    readonly MAX_DOCUMENTATION_UPDATES_LIMIT: 200;
+    readonly MAX_TECHNOLOGY_OVERVIEWS_LIMIT: 200;
+    readonly MAX_SAMPLE_CODE_LIMIT: 200;
+    readonly MAX_TECHNOLOGIES_LIMIT: 500;
+    readonly MAX_REFERENCES_LIMIT: 50;
+};
+export declare const SEARCH_DEPTH_LIMITS: {
+    readonly shallow: 5;
+    readonly medium: 10;
+    readonly deep: 15;
+};
+export declare const CACHE_TTL: {
+    readonly API_DOCS: number;
+    readonly SEARCH_RESULTS: number;
+    readonly FRAMEWORK_INDEX: number;
+    readonly TECHNOLOGIES: number;
+    readonly UPDATES: number;
+    readonly SAMPLE_CODE: number;
+    readonly TECHNOLOGY_OVERVIEWS: number;
+};
+export declare const CACHE_SIZE: {
+    readonly API_DOCS: 500;
+    readonly SEARCH_RESULTS: 200;
+    readonly FRAMEWORK_INDEX: 100;
+    readonly TECHNOLOGIES: 50;
+    readonly UPDATES: 100;
+    readonly SAMPLE_CODE: 100;
+    readonly TECHNOLOGY_OVERVIEWS: 100;
+    readonly DEFAULT_CACHE_SIZE: 1000;
+    readonly DEFAULT_CACHE_TTL: number;
+};
+export declare const SAFARI_USER_AGENTS: readonly ["Mozilla/5.0 (Macintosh; Intel Mac OS X 12_7_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15", "Mozilla/5.0 (Macintosh; arm64 Mac OS X 12_7_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15", "Mozilla/5.0 (Macintosh; Intel Mac OS X 12_7_4) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15", "Mozilla/5.0 (Macintosh; Intel Mac OS X 13_7_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15", "Mozilla/5.0 (Macintosh; arm64 Mac OS X 13_7_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15", "Mozilla/5.0 (Macintosh; Intel Mac OS X 13_6_9) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15", "Mozilla/5.0 (Macintosh; arm64 Mac OS X 13_6_8) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15", "Mozilla/5.0 (Macintosh; Intel Mac OS X 13_6_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15", "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_7_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15", "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_7_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15", "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_6_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15", "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_6_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15", "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15", "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15", "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1 Safari/605.1.15", "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_4_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1 Safari/605.1.15", "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.1 Safari/605.1.15", "Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.1 Safari/605.1.15", "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_0_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0.1 Safari/605.1.15", "Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_0_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0.1 Safari/605.1.15", "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Safari/605.1.15", "Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Safari/605.1.15", "Mozilla/5.0 (Macintosh; arm64 Mac OS X 26_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/19.0 Safari/605.1.15", "Mozilla/5.0 (Macintosh; Intel Mac OS X 26_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/19.0 Safari/605.1.15", "Mozilla/5.0 (Macintosh; arm64 Mac OS X 26_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/19.1 Safari/605.1.15"];
+export declare const SAFARI_USER_AGENT_CATEGORIES: {
+    readonly monterey: ("Mozilla/5.0 (Macintosh; Intel Mac OS X 12_7_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 12_7_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 12_7_4) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 13_7_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 13_7_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 13_6_9) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 13_6_8) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 13_6_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_7_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_7_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_6_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_6_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_4_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_0_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_0_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 26_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/19.0 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 26_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/19.0 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 26_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/19.1 Safari/605.1.15")[];
+    readonly ventura: ("Mozilla/5.0 (Macintosh; Intel Mac OS X 12_7_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 12_7_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 12_7_4) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 13_7_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 13_7_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 13_6_9) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 13_6_8) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 13_6_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_7_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_7_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_6_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_6_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_4_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_0_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_0_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 26_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/19.0 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 26_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/19.0 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 26_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/19.1 Safari/605.1.15")[];
+    readonly sonoma: ("Mozilla/5.0 (Macintosh; Intel Mac OS X 12_7_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 12_7_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 12_7_4) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 13_7_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 13_7_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 13_6_9) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 13_6_8) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 13_6_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_7_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_7_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_6_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_6_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_4_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_0_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_0_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 26_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/19.0 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 26_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/19.0 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 26_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/19.1 Safari/605.1.15")[];
+    readonly sequoia: ("Mozilla/5.0 (Macintosh; Intel Mac OS X 12_7_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 12_7_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 12_7_4) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 13_7_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 13_7_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 13_6_9) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 13_6_8) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 13_6_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_7_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_7_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_6_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_6_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_4_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_0_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_0_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 26_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/19.0 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 26_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/19.0 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 26_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/19.1 Safari/605.1.15")[];
+    readonly beta: ("Mozilla/5.0 (Macintosh; Intel Mac OS X 12_7_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 12_7_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 12_7_4) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 13_7_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 13_7_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 13_6_9) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 13_6_8) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 13_6_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_7_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_7_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_6_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_6_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.6.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_5) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_4_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 14_4_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.4.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_0_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_0_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0.1 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 15_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 26_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/19.0 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; Intel Mac OS X 26_0) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/19.0 Safari/605.1.15" | "Mozilla/5.0 (Macintosh; arm64 Mac OS X 26_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/19.1 Safari/605.1.15")[];
+};
+export declare const SAFARI_USER_AGENT_UTILS: {
+    readonly SAFARI_UA_REGEX: RegExp;
+    /**
+     * Validates if a User-Agent string is a valid Safari format
+     * @param userAgent - The User-Agent string to validate
+     * @returns boolean indicating if the format is valid
+     */
+    readonly isValidSafariUserAgent: (userAgent: string) => boolean;
+    /**
+     * Extracts architecture from User-Agent string
+     * @param userAgent - The User-Agent string
+     * @returns 'Intel' | 'Apple Silicon' | null
+     */
+    readonly getArchitecture: (userAgent: string) => "Intel" | "Apple Silicon" | null;
+    /**
+     * Extracts macOS version from User-Agent string
+     * @param userAgent - The User-Agent string
+     * @returns string representation of macOS version (e.g., "14.7.1")
+     */
+    readonly getMacOSVersion: (userAgent: string) => string | null;
+    /**
+     * Extracts Safari version from User-Agent string
+     * @param userAgent - The User-Agent string
+     * @returns string representation of Safari version (e.g., "17.6.1")
+     */
+    readonly getSafariVersion: (userAgent: string) => string | null;
+    /**
+     * Gets a random Safari User-Agent from all available options
+     * @returns A random Safari User-Agent string
+     */
+    readonly getRandomUserAgent: () => string;
+    /**
+     * Gets a random Safari User-Agent from a specific category
+     * @param category - The category to select from
+     * @returns A random Safari User-Agent string from the specified category
+     */
+    readonly getRandomUserAgentFromCategory: (category: keyof typeof SAFARI_USER_AGENT_CATEGORIES) => string;
+};
+export declare const REQUEST_CONFIG: {
+    readonly TIMEOUT: 30000;
+    readonly MAX_RETRIES: 3;
+    readonly RETRY_DELAY: 1000;
+    readonly MAX_CONCURRENT_REQUESTS: 5;
+    readonly USER_AGENT: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36";
+    readonly DEFAULT_SAFARI_USER_AGENT: "Mozilla/5.0 (Macintosh; arm64 Mac OS X 15_0_1) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0.1 Safari/605.1.15";
+};
+export declare const RATE_LIMIT: {
+    readonly MAX_REQUESTS_PER_MINUTE: 100;
+    readonly WINDOW_MS: 60000;
+};
+export declare const PROCESSING_LIMITS: {
+    readonly MAX_COLLECTIONS_TO_SHOW: 5;
+    readonly MAX_RELATED_APIS_PER_SECTION: 3;
+    readonly MAX_PLATFORM_COMPATIBILITY_ITEMS: 2;
+    readonly MAX_SIMILAR_APIS_FOR_DEEP_SEARCH: 3;
+    readonly MAX_TOPIC_IDENTIFIERS: 4;
+    readonly MAX_DOC_FETCHER_RELATED_APIS: 10;
+    readonly MAX_DOC_FETCHER_REFERENCES: 15;
+    readonly MAX_DOC_FETCHER_SIMILAR_APIS: 8;
+    readonly MAX_DOC_FETCHER_REFS_PER_TYPE: 5;
+    readonly RESPONSE_TIME_GOOD_THRESHOLD: 1000;
+    readonly RESPONSE_TIME_MODERATE_THRESHOLD: 3000;
+};
+export declare const APPLE_URLS: {
+    readonly BASE: "https://developer.apple.com";
+    readonly SEARCH: "https://developer.apple.com/search/";
+    readonly DOCUMENTATION: "https://developer.apple.com/documentation/";
+    readonly TUTORIALS_DATA: "https://developer.apple.com/tutorials/data/";
+    readonly TECHNOLOGIES_JSON: "https://developer.apple.com/tutorials/data/documentation/technologies.json";
+    readonly UPDATES_JSON: "https://developer.apple.com/tutorials/data/documentation/Updates.json";
+    readonly UPDATES_INDEX_JSON: "https://developer.apple.com/tutorials/data/index/updates";
+    readonly TECHNOLOGY_OVERVIEWS_JSON: "https://developer.apple.com/tutorials/data/documentation/TechnologyOverviews.json";
+    readonly TECHNOLOGY_OVERVIEWS_INDEX_JSON: "https://developer.apple.com/tutorials/data/index/technologyoverviews";
+    readonly SAMPLE_CODE_JSON: "https://developer.apple.com/tutorials/data/documentation/SampleCode.json";
+    readonly SAMPLE_CODE_INDEX_JSON: "https://developer.apple.com/tutorials/data/index/samplecode";
+};
+export declare const WWDC_URLS: {
+    readonly BASE: "https://developer.apple.com/videos";
+    readonly TOPICS: "https://developer.apple.com/videos/topics/";
+    readonly YEAR_BASE: "https://developer.apple.com/videos/wwdc";
+    readonly PLAY_BASE: "https://developer.apple.com/videos/play/wwdc";
+    readonly getYearUrl: (year: string) => string;
+    readonly getVideoUrl: (year: string, videoId: string) => string;
+    readonly getCodeUrl: (year: string, videoId: string) => string;
+    readonly getTranscriptUrl: (year: string, videoId: string) => string;
+    readonly getResourcesUrl: (year: string, videoId: string) => string;
+    readonly getTopicUrl: (topicId: string) => string;
+};
+export declare const WWDC_CONFIG: {
+    readonly EARLIEST_YEAR: 2014;
+    readonly LATEST_YEAR: 2025;
+    readonly CODE_TAB_INTRODUCED_YEAR: 2022;
+    readonly AVAILABLE_YEARS: readonly ["2014", "2015", "2016", "2017", "2018", "2019", "2020", "2021", "2022", "2023", "2024", "2025"];
+    readonly DEFAULT_VIDEO_LIMIT: 15;
+    readonly DEFAULT_CODE_EXAMPLES_LIMIT: 10;
+    readonly DEFAULT_SEARCH_LIMIT: 10;
+    readonly DEFAULT_RELATED_VIDEOS_LIMIT: 10;
+    readonly DEFAULT_TOPIC_VIDEOS_LIMIT: 10;
+    readonly MAX_VIDEO_LIMIT: 200;
+    readonly MAX_CODE_EXAMPLES_LIMIT: 100;
+    readonly MAX_SEARCH_LIMIT: 100;
+    readonly MAX_RELATED_VIDEOS_LIMIT: 50;
+    readonly MAX_TOPIC_VIDEOS_LIMIT: 100;
+    readonly MIN_CODE_LENGTH: 10;
+    readonly MAX_CONTEXT_MATCHES: 3;
+    readonly MAX_TOPIC_VIDEOS_FOR_SCORING: 10;
+    readonly CACHE_TTL: number;
+};
+export declare const ERROR_MESSAGES: {
+    readonly INVALID_URL: "URL must be from developer.apple.com";
+    readonly FETCH_FAILED: "Failed to fetch data from Apple Developer Documentation";
+    readonly PARSE_FAILED: "Failed to parse response data";
+    readonly NOT_FOUND: "Documentation not found (404). This URL may have been moved or removed.";
+    readonly TIMEOUT: "Request timed out. Please try again later.";
+    readonly NETWORK_ERROR: "Network error occurred. Please check your connection.";
+    readonly RATE_LIMITED: "Request rate limit exceeded. Please wait before trying again.";
+    readonly API_ERROR: "API error occurred while processing the request.";
+    readonly CACHE_ERROR: "Cache operation failed, but the request will continue.";
+    readonly VALIDATION_ERROR: "Input validation failed. Please check your parameters.";
+    readonly SERVICE_UNAVAILABLE: "Apple Developer Documentation service is temporarily unavailable.";
+};
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;CAuBb,CAAC;AAGX,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAGX,eAAO,MAAM,SAAS;;;;;;;;CAQZ,CAAC;AAGX,eAAO,MAAM,UAAU;;;;;;;;;;CAYb,CAAC;AAIX,eAAO,MAAM,kBAAkB,i9FAmCrB,CAAC;AAGX,eAAO,MAAM,4BAA4B;;;;;;CAM/B,CAAC;AAGX,eAAO,MAAM,uBAAuB;;IAIlC;;;;OAIG;iDACiC,MAAM,KAAG,OAAO;IAIpD;;;;OAIG;0CAC0B,MAAM,KAAG,OAAO,GAAG,eAAe,GAAG,IAAI;IAQtE;;;;OAIG;0CAC0B,MAAM,KAAG,MAAM,GAAG,IAAI;IASnD;;;;OAIG;2CAC2B,MAAM,KAAG,MAAM,GAAG,IAAI;IAQpD;;;OAGG;uCACqB,MAAM;IAK9B;;;;OAIG;wDACwC,MAAM,OAAO,4BAA4B,KAAG,MAAM;CAKrF,CAAC;AAGX,eAAO,MAAM,cAAc;;;;;;;CASjB,CAAC;AAGX,eAAO,MAAM,UAAU;;;CAGb,CAAC;AAGX,eAAO,MAAM,iBAAiB;;;;;;;;;;;;CAepB,CAAC;AAGX,eAAO,MAAM,UAAU;;;;;;;;;;;;CAYb,CAAC;AAGX,eAAO,MAAM,SAAS;;;;;gCAOD,MAAM;iCACL,MAAM,WAAW,MAAM;gCACxB,MAAM,WAAW,MAAM;sCACjB,MAAM,WAAW,MAAM;qCACxB,MAAM,WAAW,MAAM;oCACxB,MAAM;CACrB,CAAC;AAGX,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;CA8Bd,CAAC;AAGX,eAAO,MAAM,cAAc;;;;;;;;;;;;CAYjB,CAAC"}