@eui/mcp 1.0.3

package/dist/loader/cache-manager.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Cache manager for storing documentation responses with HTTP cache headers
+ */
+import { CompodocDocumentation } from '../types/compodoc.js';
+/**
+ * Cache entry containing documentation data and HTTP cache headers
+ */
+export interface CacheEntry {
+    /** ETag header value for conditional requests */
+    etag?: string;
+    /** Last-Modified header value for conditional requests */
+    lastModified?: string;
+    /** Cached documentation data */
+    data: CompodocDocumentation;
+    /** Timestamp when the entry was cached */
+    timestamp: number;
+}
+/**
+ * Manages caching of remote documentation responses with HTTP cache headers
+ *
+ * Supports conditional requests using ETag and Last-Modified headers to minimize
+ * bandwidth usage when polling for updates.
+ */
+export declare class CacheManager {
+    private cache;
+    constructor();
+    /**
+     * Store documentation with cache headers
+     *
+     * @param url - The URL of the documentation source
+     * @param data - The documentation data to cache
+     * @param headers - HTTP response headers containing ETag and/or Last-Modified
+     */
+    set(url: string, data: CompodocDocumentation, headers: Map<string, string>): void;
+    /**
+     * Get cached documentation for a URL
+     *
+     * @param url - The URL to retrieve from cache
+     * @returns The cache entry if found, undefined otherwise
+     */
+    get(url: string): CacheEntry | undefined;
+    /**
+     * Get conditional request headers for a URL
+     *
+     * Returns If-None-Match (ETag) and/or If-Modified-Since (Last-Modified) headers
+     * if they exist in the cache for the given URL.
+     *
+     * @param url - The URL to get conditional headers for
+     * @returns Map of conditional request headers
+     */
+    getConditionalHeaders(url: string): Map<string, string>;
+    /**
+     * Clear cache for a specific URL
+     *
+     * @param url - The URL to clear from cache
+     */
+    clear(url: string): void;
+    /**
+     * Clear all cached entries
+     */
+    clearAll(): void;
+    /**
+     * Get header value case-insensitively
+     *
+     * HTTP headers are case-insensitive, so we need to search for them
+     * regardless of case.
+     *
+     * @param headers - Map of headers
+     * @param headerName - Name of the header to find (case-insensitive)
+     * @returns The header value if found, undefined otherwise
+     */
+    private getHeaderCaseInsensitive;
+}
+//# sourceMappingURL=cache-manager.d.ts.map

package/dist/loader/cache-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../src/loader/cache-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA0B;;IAMvC;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAqBjF;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIxC;;;;;;;;OAQG;IACH,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAqBvD;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIxB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAIhB;;;;;;;;;OASG;IACH,OAAO,CAAC,wBAAwB;CAWjC"}

package/dist/loader/cache-manager.js

@@ -0,0 +1,107 @@
+/**
+ * Cache manager for storing documentation responses with HTTP cache headers
+ */
+/**
+ * Manages caching of remote documentation responses with HTTP cache headers
+ *
+ * Supports conditional requests using ETag and Last-Modified headers to minimize
+ * bandwidth usage when polling for updates.
+ */
+export class CacheManager {
+    cache;
+    constructor() {
+        this.cache = new Map();
+    }
+    /**
+     * Store documentation with cache headers
+     *
+     * @param url - The URL of the documentation source
+     * @param data - The documentation data to cache
+     * @param headers - HTTP response headers containing ETag and/or Last-Modified
+     */
+    set(url, data, headers) {
+        const entry = {
+            data,
+            timestamp: Date.now(),
+        };
+        // Extract ETag header (case-insensitive)
+        const etag = this.getHeaderCaseInsensitive(headers, 'etag');
+        if (etag) {
+            entry.etag = etag;
+        }
+        // Extract Last-Modified header (case-insensitive)
+        const lastModified = this.getHeaderCaseInsensitive(headers, 'last-modified');
+        if (lastModified) {
+            entry.lastModified = lastModified;
+        }
+        this.cache.set(url, entry);
+    }
+    /**
+     * Get cached documentation for a URL
+     *
+     * @param url - The URL to retrieve from cache
+     * @returns The cache entry if found, undefined otherwise
+     */
+    get(url) {
+        return this.cache.get(url);
+    }
+    /**
+     * Get conditional request headers for a URL
+     *
+     * Returns If-None-Match (ETag) and/or If-Modified-Since (Last-Modified) headers
+     * if they exist in the cache for the given URL.
+     *
+     * @param url - The URL to get conditional headers for
+     * @returns Map of conditional request headers
+     */
+    getConditionalHeaders(url) {
+        const headers = new Map();
+        const entry = this.cache.get(url);
+        if (!entry) {
+            return headers;
+        }
+        // Add If-None-Match header if ETag exists
+        if (entry.etag) {
+            headers.set('If-None-Match', entry.etag);
+        }
+        // Add If-Modified-Since header if Last-Modified exists
+        if (entry.lastModified) {
+            headers.set('If-Modified-Since', entry.lastModified);
+        }
+        return headers;
+    }
+    /**
+     * Clear cache for a specific URL
+     *
+     * @param url - The URL to clear from cache
+     */
+    clear(url) {
+        this.cache.delete(url);
+    }
+    /**
+     * Clear all cached entries
+     */
+    clearAll() {
+        this.cache.clear();
+    }
+    /**
+     * Get header value case-insensitively
+     *
+     * HTTP headers are case-insensitive, so we need to search for them
+     * regardless of case.
+     *
+     * @param headers - Map of headers
+     * @param headerName - Name of the header to find (case-insensitive)
+     * @returns The header value if found, undefined otherwise
+     */
+    getHeaderCaseInsensitive(headers, headerName) {
+        const lowerHeaderName = headerName.toLowerCase();
+        for (const [key, value] of headers.entries()) {
+            if (key.toLowerCase() === lowerHeaderName) {
+                return value;
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=cache-manager.js.map

package/dist/loader/cache-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-manager.js","sourceRoot":"","sources":["../../src/loader/cache-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,CAA0B;IAEvC;QACE,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;IACzB,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CAAC,GAAW,EAAE,IAA2B,EAAE,OAA4B;QACxE,MAAM,KAAK,GAAe;YACxB,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QAEF,yCAAyC;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,wBAAwB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5D,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;QACpB,CAAC;QAED,kDAAkD;QAClD,MAAM,YAAY,GAAG,IAAI,CAAC,wBAAwB,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAC7E,IAAI,YAAY,EAAE,CAAC;YACjB,KAAK,CAAC,YAAY,GAAG,YAAY,CAAC;QACpC,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;;;;OAQG;IACH,qBAAqB,CAAC,GAAW;QAC/B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAElC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,0CAA0C;QAC1C,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;QAED,uDAAuD;QACvD,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QACvD,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAW;QACf,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;;;;;;;;OASG;IACK,wBAAwB,CAAC,OAA4B,EAAE,UAAkB;QAC/E,MAAM,eAAe,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QAEjD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAC7C,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,eAAe,EAAE,CAAC;gBAC1C,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/loader/documentation-loader.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Documentation loader - loads and parses Compodoc documentation.json
+ * Uses strategy pattern to delegate to LocalDocumentationSource or RemoteDocumentationSource
+ */
+import { CompodocDocumentation } from '../types/compodoc.js';
+export interface LoadResult {
+    success: boolean;
+    data?: CompodocDocumentation;
+    error?: string;
+}
+export interface DocumentationLoaderOptions {
+    path: string;
+    watchForChanges?: boolean;
+    reloadDebounce?: number;
+    timeout?: number;
+    maxRetries?: number;
+    pollingInterval?: number;
+    onReload?: (data: CompodocDocumentation) => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * DocumentationLoader class
+ * Responsible for loading, parsing, and watching the documentation.json file
+ * Uses strategy pattern to delegate to appropriate source based on path type
+ */
+export declare class DocumentationLoader {
+    private source;
+    constructor(options: DocumentationLoaderOptions);
+    /**
+     * Load the documentation from the configured source
+     */
+    load(): Promise<LoadResult>;
+    /**
+     * Get the currently loaded documentation
+     */
+    getCurrentData(): CompodocDocumentation | undefined;
+    /**
+     * Stop watching the file or polling the URL
+     */
+    stopWatching(): Promise<void>;
+    /**
+     * Clean up resources
+     */
+    dispose(): Promise<void>;
+    /**
+     * Create appropriate source based on path type
+     * @private
+     * @param options - DocumentationLoaderOptions
+     * @returns DocumentationSource instance (LocalDocumentationSource or RemoteDocumentationSource)
+     */
+    private createSource;
+}
+/**
+ * Helper function to load documentation without watching
+ */
+export declare function loadDocumentation(filePath: string): Promise<LoadResult>;
+//# sourceMappingURL=documentation-loader.d.ts.map

package/dist/loader/documentation-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation-loader.d.ts","sourceRoot":"","sources":["../../src/loader/documentation-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAM7D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAsB;gBAExB,OAAO,EAAE,0BAA0B;IAI/C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IAIjC;;OAEG;IACH,cAAc,IAAI,qBAAqB,GAAG,SAAS;IAInD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;;;;OAKG;IACH,OAAO,CAAC,YAAY;CA0BrB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAO7E"}

package/dist/loader/documentation-loader.js

@@ -0,0 +1,81 @@
+import { LocalDocumentationSource } from './local-documentation-source.js';
+import { RemoteDocumentationSource } from './remote-documentation-source.js';
+import { PathTypeDetector, PathType } from './path-type-detector.js';
+/**
+ * DocumentationLoader class
+ * Responsible for loading, parsing, and watching the documentation.json file
+ * Uses strategy pattern to delegate to appropriate source based on path type
+ */
+export class DocumentationLoader {
+    source;
+    constructor(options) {
+        this.source = this.createSource(options);
+    }
+    /**
+     * Load the documentation from the configured source
+     */
+    async load() {
+        return this.source.load();
+    }
+    /**
+     * Get the currently loaded documentation
+     */
+    getCurrentData() {
+        return this.source.getCurrentData();
+    }
+    /**
+     * Stop watching the file or polling the URL
+     */
+    async stopWatching() {
+        await this.source.stopMonitoring();
+    }
+    /**
+     * Clean up resources
+     */
+    async dispose() {
+        await this.source.dispose();
+    }
+    /**
+     * Create appropriate source based on path type
+     * @private
+     * @param options - DocumentationLoaderOptions
+     * @returns DocumentationSource instance (LocalDocumentationSource or RemoteDocumentationSource)
+     */
+    createSource(options) {
+        // Detect path type
+        const pathInfo = PathTypeDetector.detect(options.path);
+        // Create appropriate source based on path type
+        if (pathInfo.type === PathType.LOCAL) {
+            // Local file path - use LocalDocumentationSource
+            return new LocalDocumentationSource({
+                path: pathInfo.normalizedPath,
+                watchForChanges: options.watchForChanges ?? true,
+                reloadDebounce: options.reloadDebounce ?? 1000,
+                onReload: options.onReload,
+                onError: options.onError,
+            });
+        }
+        else {
+            // Remote URL (HTTP or HTTPS) - use RemoteDocumentationSource
+            return new RemoteDocumentationSource({
+                url: pathInfo.normalizedPath,
+                timeout: options.timeout ?? 10000,
+                maxRetries: options.maxRetries ?? 3,
+                pollingInterval: options.pollingInterval ?? 60000,
+                onReload: options.onReload,
+                onError: options.onError,
+            });
+        }
+    }
+}
+/**
+ * Helper function to load documentation without watching
+ */
+export async function loadDocumentation(filePath) {
+    const loader = new DocumentationLoader({
+        path: filePath,
+        watchForChanges: false,
+    });
+    return loader.load();
+}
+//# sourceMappingURL=documentation-loader.js.map

package/dist/loader/documentation-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation-loader.js","sourceRoot":"","sources":["../../src/loader/documentation-loader.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAmBrE;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IACtB,MAAM,CAAsB;IAEpC,YAAY,OAAmC;QAC7C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACK,YAAY,CAAC,OAAmC;QACtD,mBAAmB;QACnB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAEvD,+CAA+C;QAC/C,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,KAAK,EAAE,CAAC;YACrC,iDAAiD;YACjD,OAAO,IAAI,wBAAwB,CAAC;gBAClC,IAAI,EAAE,QAAQ,CAAC,cAAc;gBAC7B,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;gBAChD,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI;gBAC9C,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;aACzB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,6DAA6D;YAC7D,OAAO,IAAI,yBAAyB,CAAC;gBACnC,GAAG,EAAE,QAAQ,CAAC,cAAc;gBAC5B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK;gBACjC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC;gBACnC,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,KAAK;gBACjD,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;aACzB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,QAAgB;IACtD,MAAM,MAAM,GAAG,IAAI,mBAAmB,CAAC;QACrC,IAAI,EAAE,QAAQ;QACd,eAAe,EAAE,KAAK;KACvB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC"}

package/dist/loader/documentation-source.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Documentation source interface
+ * Defines the contract for loading documentation from different sources (local files or remote URLs)
+ */
+import { CompodocDocumentation } from '../types/compodoc.js';
+import { LoadResult } from './documentation-loader.js';
+/**
+ * DocumentationSource interface
+ * Common interface for both local and remote documentation sources
+ */
+export interface DocumentationSource {
+    /**
+     * Load documentation from the source
+     * @returns Promise resolving to LoadResult with success status and data or error
+     */
+    load(): Promise<LoadResult>;
+    /**
+     * Start monitoring for changes (file watching for local sources, polling for remote sources)
+     */
+    startMonitoring(): void;
+    /**
+     * Stop monitoring for changes
+     * @returns Promise that resolves when monitoring has been stopped
+     */
+    stopMonitoring(): Promise<void>;
+    /**
+     * Get currently loaded documentation data
+     * @returns The currently loaded CompodocDocumentation or undefined if not loaded
+     */
+    getCurrentData(): CompodocDocumentation | undefined;
+    /**
+     * Clean up resources and dispose of the source
+     * @returns Promise that resolves when cleanup is complete
+     */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=documentation-source.d.ts.map

package/dist/loader/documentation-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation-source.d.ts","sourceRoot":"","sources":["../../src/loader/documentation-source.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAE5B;;OAEG;IACH,eAAe,IAAI,IAAI,CAAC;IAExB;;;OAGG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC;;;OAGG;IACH,cAAc,IAAI,qBAAqB,GAAG,SAAS,CAAC;IAEpD;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/dist/loader/documentation-source.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=documentation-source.js.map

package/dist/loader/documentation-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation-source.js","sourceRoot":"","sources":["../../src/loader/documentation-source.ts"],"names":[],"mappings":""}

package/dist/loader/errors.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Custom error types for documentation loading
+ */
+/**
+ * Base error class for network-related errors
+ */
+export declare class NetworkError extends Error {
+    url: string;
+    cause?: Error | undefined;
+    constructor(message: string, url: string, cause?: Error | undefined);
+}
+/**
+ * Error thrown when a request times out
+ */
+export declare class TimeoutError extends NetworkError {
+    timeout: number;
+    constructor(url: string, timeout: number);
+}
+/**
+ * Error thrown for HTTP errors (non-2xx status codes)
+ */
+export declare class HttpError extends NetworkError {
+    statusCode: number;
+    statusText: string;
+    constructor(message: string, url: string, statusCode: number, statusText: string);
+}
+/**
+ * Error thrown when JSON parsing fails
+ */
+export declare class ParseError extends Error {
+    content: string;
+    constructor(message: string, content: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/loader/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/loader/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IAG5B,GAAG,EAAE,MAAM;IACX,KAAK,CAAC,EAAE,KAAK;gBAFpB,OAAO,EAAE,MAAM,EACR,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,KAAK,YAAA;CAUvB;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,YAAY;IACZ,OAAO,EAAE,MAAM;gBAAnC,GAAG,EAAE,MAAM,EAAS,OAAO,EAAE,MAAM;CAQhD;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,YAAY;IAIhC,UAAU,EAAE,MAAM;IAClB,UAAU,EAAE,MAAM;gBAHzB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACJ,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM;CAS5B;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACC,OAAO,EAAE,MAAM;gBAAvC,OAAO,EAAE,MAAM,EAAS,OAAO,EAAE,MAAM;CAQpD"}

package/dist/loader/errors.js

@@ -0,0 +1,65 @@
+/**
+ * Custom error types for documentation loading
+ */
+/**
+ * Base error class for network-related errors
+ */
+export class NetworkError extends Error {
+    url;
+    cause;
+    constructor(message, url, cause) {
+        super(message);
+        this.url = url;
+        this.cause = cause;
+        this.name = 'NetworkError';
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, NetworkError);
+        }
+    }
+}
+/**
+ * Error thrown when a request times out
+ */
+export class TimeoutError extends NetworkError {
+    timeout;
+    constructor(url, timeout) {
+        super(`Request timeout after ${timeout}ms`, url);
+        this.timeout = timeout;
+        this.name = 'TimeoutError';
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, TimeoutError);
+        }
+    }
+}
+/**
+ * Error thrown for HTTP errors (non-2xx status codes)
+ */
+export class HttpError extends NetworkError {
+    statusCode;
+    statusText;
+    constructor(message, url, statusCode, statusText) {
+        super(message, url);
+        this.statusCode = statusCode;
+        this.statusText = statusText;
+        this.name = 'HttpError';
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, HttpError);
+        }
+    }
+}
+/**
+ * Error thrown when JSON parsing fails
+ */
+export class ParseError extends Error {
+    content;
+    constructor(message, content) {
+        super(message);
+        this.content = content;
+        this.name = 'ParseError';
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ParseError);
+        }
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/loader/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/loader/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAG5B;IACA;IAHT,YACE,OAAe,EACR,GAAW,EACX,KAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,QAAG,GAAH,GAAG,CAAQ;QACX,UAAK,GAAL,KAAK,CAAQ;QAGpB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAE3B,qFAAqF;QACrF,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,YAAY;IACZ;IAAhC,YAAY,GAAW,EAAS,OAAe;QAC7C,KAAK,CAAC,yBAAyB,OAAO,IAAI,EAAE,GAAG,CAAC,CAAC;QADnB,YAAO,GAAP,OAAO,CAAQ;QAE7C,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAE3B,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,YAAY;IAIhC;IACA;IAJT,YACE,OAAe,EACf,GAAW,EACJ,UAAkB,EAClB,UAAkB;QAEzB,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAHb,eAAU,GAAV,UAAU,CAAQ;QAClB,eAAU,GAAV,UAAU,CAAQ;QAGzB,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QAExB,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IACC;IAApC,YAAY,OAAe,EAAS,OAAe;QACjD,KAAK,CAAC,OAAO,CAAC,CAAC;QADmB,YAAO,GAAP,OAAO,CAAQ;QAEjD,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QAEzB,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;CACF"}

package/dist/loader/http-client.d.ts

@@ -0,0 +1,43 @@
+/**
+ * HTTP client with timeout support and retry logic
+ */
+export interface HttpClientOptions {
+    timeout: number;
+    maxRetries: number;
+    retryDelay: number;
+    userAgent?: string;
+}
+export interface HttpResponse {
+    status: number;
+    statusText: string;
+    data: string;
+    headers: Map<string, string>;
+}
+export declare class HttpClient {
+    private options;
+    constructor(options: HttpClientOptions);
+    /**
+     * Fetch content from URL with timeout support and retry logic
+     */
+    fetch(url: string, headers?: Map<string, string>): Promise<HttpResponse>;
+    /**
+     * Perform a single fetch attempt with timeout
+     */
+    private fetchOnce;
+    /**
+     * Check if error is retryable
+     * Retryable: network errors, timeouts, 5xx errors, 408, 429
+     * Non-retryable: 4xx client errors (except 408, 429)
+     */
+    private isRetryableError;
+    /**
+     * Calculate exponential backoff delay
+     * Formula: retryDelay * (2 ^ attempt)
+     */
+    private calculateBackoff;
+    /**
+     * Sleep for specified milliseconds
+     */
+    private sleep;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/loader/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/loader/http-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAoB;gBAEvB,OAAO,EAAE,iBAAiB;IAItC;;OAEG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAmC9E;;OAEG;YACW,SAAS;IAoDvB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAgDxB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}