@eui/mcp 1.0.3

package/dist/loader/http-client.js

@@ -0,0 +1,144 @@
+/**
+ * HTTP client with timeout support and retry logic
+ */
+export class HttpClient {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Fetch content from URL with timeout support and retry logic
+     */
+    async fetch(url, headers) {
+        let lastError;
+        for (let attempt = 0; attempt <= this.options.maxRetries; attempt++) {
+            try {
+                const response = await this.fetchOnce(url, headers);
+                // Check if we should retry based on status code
+                // If not retryable or no more retries, return the response
+                if (!this.isRetryableError(undefined, response.status) || attempt >= this.options.maxRetries) {
+                    return response;
+                }
+                // Retry with backoff
+                const delay = this.calculateBackoff(attempt);
+                await this.sleep(delay);
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                // Check if we should retry
+                if (attempt < this.options.maxRetries && this.isRetryableError(lastError)) {
+                    const delay = this.calculateBackoff(attempt);
+                    await this.sleep(delay);
+                    continue;
+                }
+                // No more retries, throw the error
+                throw lastError;
+            }
+        }
+        // Should not reach here, but throw last error if we do
+        throw lastError || new Error('Unknown error during fetch');
+    }
+    /**
+     * Perform a single fetch attempt with timeout
+     */
+    async fetchOnce(url, headers) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.options.timeout);
+        try {
+            // Build headers object
+            const fetchHeaders = {
+                'Accept': 'application/json',
+                'User-Agent': this.options.userAgent || 'DocumentationLoader/1.0',
+            };
+            // Add custom headers if provided
+            if (headers) {
+                headers.forEach((value, key) => {
+                    fetchHeaders[key] = value;
+                });
+            }
+            const response = await fetch(url, {
+                signal: controller.signal,
+                headers: fetchHeaders,
+            });
+            clearTimeout(timeoutId);
+            // Parse response headers into Map
+            const responseHeaders = new Map();
+            response.headers.forEach((value, key) => {
+                responseHeaders.set(key, value);
+            });
+            // Read response body
+            const data = await response.text();
+            return {
+                status: response.status,
+                statusText: response.statusText,
+                data,
+                headers: responseHeaders,
+            };
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            // Handle abort/timeout errors
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new Error(`Request timeout after ${this.options.timeout}ms`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Check if error is retryable
+     * Retryable: network errors, timeouts, 5xx errors, 408, 429
+     * Non-retryable: 4xx client errors (except 408, 429)
+     */
+    isRetryableError(error, statusCode) {
+        // Check status code if provided
+        if (statusCode !== undefined) {
+            // 2xx and 3xx are successful, don't retry
+            if (statusCode >= 200 && statusCode < 400) {
+                return false;
+            }
+            // 5xx server errors are retryable
+            if (statusCode >= 500) {
+                return true;
+            }
+            // 408 Request Timeout and 429 Too Many Requests are retryable
+            if (statusCode === 408 || statusCode === 429) {
+                return true;
+            }
+            // Other 4xx client errors are not retryable
+            if (statusCode >= 400 && statusCode < 500) {
+                return false;
+            }
+        }
+        // Network errors and timeouts are retryable
+        if (error) {
+            const errorMessage = error.message.toLowerCase();
+            // Timeout errors
+            if (errorMessage.includes('timeout')) {
+                return true;
+            }
+            // Network errors
+            if (errorMessage.includes('network') ||
+                errorMessage.includes('econnrefused') ||
+                errorMessage.includes('enotfound') ||
+                errorMessage.includes('econnreset')) {
+                return true;
+            }
+        }
+        // Default to retryable for unknown errors
+        return true;
+    }
+    /**
+     * Calculate exponential backoff delay
+     * Formula: retryDelay * (2 ^ attempt)
+     */
+    calculateBackoff(attempt) {
+        return this.options.retryDelay * Math.pow(2, attempt);
+    }
+    /**
+     * Sleep for specified milliseconds
+     */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=http-client.js.map

package/dist/loader/http-client.js.map

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

package/dist/loader/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Documentation loader module exports
+ */
+export { DocumentationLoader, DocumentationLoaderOptions, LoadResult, loadDocumentation, } from './documentation-loader.js';
+export { DocumentationSource } from './documentation-source.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/loader/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,UAAU,EACV,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/loader/index.js

@@ -0,0 +1,5 @@
+/**
+ * Documentation loader module exports
+ */
+export { DocumentationLoader, loadDocumentation, } from './documentation-loader.js';
+//# sourceMappingURL=index.js.map

package/dist/loader/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/loader/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EACL,mBAAmB,EAGnB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC"}

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

@@ -0,0 +1,62 @@
+import { CompodocDocumentation } from '../types/compodoc.js';
+import { DocumentationSource } from './documentation-source.js';
+import { LoadResult } from './documentation-loader.js';
+export interface LocalSourceOptions {
+    path: string;
+    watchForChanges: boolean;
+    reloadDebounce: number;
+    onReload?: (data: CompodocDocumentation) => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * LocalDocumentationSource class
+ * Handles loading documentation from local file system with file watching support
+ */
+export declare class LocalDocumentationSource implements DocumentationSource {
+    private filePath;
+    private watchForChanges;
+    private reloadDebounce;
+    private watcher?;
+    private reloadTimer?;
+    private onReloadCallback?;
+    private onErrorCallback?;
+    private currentData?;
+    constructor(options: LocalSourceOptions);
+    /**
+     * Load the documentation.json file from local file system
+     */
+    load(): Promise<LoadResult>;
+    /**
+     * Start monitoring the file for changes using file watcher
+     */
+    startMonitoring(): void;
+    /**
+     * Stop monitoring the file for changes
+     */
+    stopMonitoring(): Promise<void>;
+    /**
+     * Get the currently loaded documentation
+     */
+    getCurrentData(): CompodocDocumentation | undefined;
+    /**
+     * Clean up resources
+     */
+    dispose(): Promise<void>;
+    /**
+     * Validate the basic structure of the documentation
+     */
+    private validateStructure;
+    /**
+     * Start watching the documentation file for changes
+     */
+    private startWatching;
+    /**
+     * Schedule a reload with debouncing
+     */
+    private scheduleReload;
+    /**
+     * Reload the documentation file
+     */
+    private reload;
+}
+//# sourceMappingURL=local-documentation-source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"local-documentation-source.d.ts","sourceRoot":"","sources":["../../src/loader/local-documentation-source.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,mBAAmB;IAClE,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,eAAe,CAAU;IACjC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,OAAO,CAAC,CAAY;IAC5B,OAAO,CAAC,WAAW,CAAC,CAAiB;IACrC,OAAO,CAAC,gBAAgB,CAAC,CAAwC;IACjE,OAAO,CAAC,eAAe,CAAC,CAAyB;IACjD,OAAO,CAAC,WAAW,CAAC,CAAwB;gBAEhC,OAAO,EAAE,kBAAkB;IAQvC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IAsDjC;;OAEG;IACH,eAAe,IAAI,IAAI;IAQvB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAarC;;OAEG;IACH,cAAc,IAAI,qBAAqB,GAAG,SAAS;IAInD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAwBrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;YACW,MAAM;CAiBrB"}

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

@@ -0,0 +1,190 @@
+/**
+ * Local documentation source - loads documentation from local file system
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { watch } from 'chokidar';
+/**
+ * LocalDocumentationSource class
+ * Handles loading documentation from local file system with file watching support
+ */
+export class LocalDocumentationSource {
+    filePath;
+    watchForChanges;
+    reloadDebounce;
+    watcher;
+    reloadTimer;
+    onReloadCallback;
+    onErrorCallback;
+    currentData;
+    constructor(options) {
+        this.filePath = path.resolve(options.path);
+        this.watchForChanges = options.watchForChanges;
+        this.reloadDebounce = options.reloadDebounce;
+        this.onReloadCallback = options.onReload;
+        this.onErrorCallback = options.onError;
+    }
+    /**
+     * Load the documentation.json file from local file system
+     */
+    async load() {
+        try {
+            // Check if file exists
+            if (!fs.existsSync(this.filePath)) {
+                return {
+                    success: false,
+                    error: `Documentation file not found: ${this.filePath}`,
+                };
+            }
+            // Read file
+            const content = await fs.promises.readFile(this.filePath, 'utf-8');
+            // Parse JSON
+            let data;
+            try {
+                data = JSON.parse(content);
+            }
+            catch (parseError) {
+                return {
+                    success: false,
+                    error: `Failed to parse JSON: ${parseError instanceof Error ? parseError.message : String(parseError)}`,
+                };
+            }
+            // Validate structure
+            const validationError = this.validateStructure(data);
+            if (validationError) {
+                return {
+                    success: false,
+                    error: validationError,
+                };
+            }
+            // Store current data
+            this.currentData = data;
+            // Start watching if enabled
+            if (this.watchForChanges && !this.watcher) {
+                this.startMonitoring();
+            }
+            return {
+                success: true,
+                data,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                success: false,
+                error: `Failed to load documentation: ${errorMessage}`,
+            };
+        }
+    }
+    /**
+     * Start monitoring the file for changes using file watcher
+     */
+    startMonitoring() {
+        if (this.watcher) {
+            return;
+        }
+        this.startWatching();
+    }
+    /**
+     * Stop monitoring the file for changes
+     */
+    async stopMonitoring() {
+        if (this.reloadTimer) {
+            clearTimeout(this.reloadTimer);
+            this.reloadTimer = undefined;
+        }
+        if (this.watcher) {
+            await this.watcher.close();
+            this.watcher = undefined;
+            console.log('Stopped watching documentation file');
+        }
+    }
+    /**
+     * Get the currently loaded documentation
+     */
+    getCurrentData() {
+        return this.currentData;
+    }
+    /**
+     * Clean up resources
+     */
+    async dispose() {
+        await this.stopMonitoring();
+        this.currentData = undefined;
+        this.onReloadCallback = undefined;
+        this.onErrorCallback = undefined;
+    }
+    /**
+     * Validate the basic structure of the documentation
+     */
+    validateStructure(data) {
+        if (!data || typeof data !== 'object') {
+            return 'Documentation must be an object';
+        }
+        const doc = data;
+        // Check for required top-level arrays
+        const requiredArrays = ['pipes', 'components', 'directives', 'injectables', 'interfaces', 'classes', 'modules'];
+        for (const key of requiredArrays) {
+            const value = doc[key];
+            if (value !== undefined && !Array.isArray(value)) {
+                return `${key} must be an array`;
+            }
+        }
+        return null;
+    }
+    /**
+     * Start watching the documentation file for changes
+     */
+    startWatching() {
+        if (this.watcher) {
+            return;
+        }
+        this.watcher = watch(this.filePath, {
+            persistent: true,
+            ignoreInitial: true,
+        });
+        this.watcher.on('change', () => {
+            this.scheduleReload();
+        });
+        this.watcher.on('error', (error) => {
+            console.error('File watcher error:', error);
+            if (this.onErrorCallback) {
+                this.onErrorCallback(error);
+            }
+        });
+        console.log(`Watching for changes: ${this.filePath}`);
+    }
+    /**
+     * Schedule a reload with debouncing
+     */
+    scheduleReload() {
+        // Clear existing timer
+        if (this.reloadTimer) {
+            clearTimeout(this.reloadTimer);
+        }
+        // Schedule new reload
+        this.reloadTimer = setTimeout(() => {
+            void this.reload();
+        }, this.reloadDebounce);
+    }
+    /**
+     * Reload the documentation file
+     */
+    async reload() {
+        console.log('Reloading documentation...');
+        const result = await this.load();
+        if (result.success && result.data) {
+            console.log('Documentation reloaded successfully');
+            if (this.onReloadCallback) {
+                this.onReloadCallback(result.data);
+            }
+        }
+        else {
+            console.error('Failed to reload documentation:', result.error);
+            if (this.onErrorCallback) {
+                this.onErrorCallback(new Error(result.error));
+            }
+        }
+    }
+}
+//# sourceMappingURL=local-documentation-source.js.map

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

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

package/dist/loader/path-type-detector.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Path type detection utilities for distinguishing between local paths and remote URLs
+ */
+export declare enum PathType {
+    LOCAL = "local",
+    HTTP_URL = "http_url",
+    HTTPS_URL = "https_url"
+}
+export interface PathInfo {
+    type: PathType;
+    originalPath: string;
+    normalizedPath: string;
+}
+export declare class PathTypeDetector {
+    /**
+     * Detect whether a path is a local file path or URL
+     * @param path - The path to analyze
+     * @returns PathInfo object with type and normalized path
+     */
+    static detect(path: string): PathInfo;
+    /**
+     * Validate URL format
+     * @param path - The path to validate
+     * @returns true if the path is a valid URL (any protocol)
+     */
+    static isValidUrl(path: string): boolean;
+    /**
+     * Check if path is HTTP/HTTPS URL
+     * @param path - The path to check
+     * @returns true if the path is an HTTP or HTTPS URL
+     */
+    static isRemoteUrl(path: string): boolean;
+}
+//# sourceMappingURL=path-type-detector.d.ts.map

package/dist/loader/path-type-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-type-detector.d.ts","sourceRoot":"","sources":["../../src/loader/path-type-detector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,QAAQ,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,gBAAgB;IAC3B;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;IAsBrC;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAUxC;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CA2B1C"}

package/dist/loader/path-type-detector.js

@@ -0,0 +1,78 @@
+/**
+ * Path type detection utilities for distinguishing between local paths and remote URLs
+ */
+export var PathType;
+(function (PathType) {
+    PathType["LOCAL"] = "local";
+    PathType["HTTP_URL"] = "http_url";
+    PathType["HTTPS_URL"] = "https_url";
+})(PathType || (PathType = {}));
+export class PathTypeDetector {
+    /**
+     * Detect whether a path is a local file path or URL
+     * @param path - The path to analyze
+     * @returns PathInfo object with type and normalized path
+     */
+    static detect(path) {
+        const trimmedPath = path.trim();
+        if (this.isRemoteUrl(trimmedPath)) {
+            const url = new URL(trimmedPath);
+            const type = url.protocol === 'https:' ? PathType.HTTPS_URL : PathType.HTTP_URL;
+            return {
+                type,
+                originalPath: path,
+                normalizedPath: trimmedPath,
+            };
+        }
+        // Default to local path
+        return {
+            type: PathType.LOCAL,
+            originalPath: path,
+            normalizedPath: trimmedPath,
+        };
+    }
+    /**
+     * Validate URL format
+     * @param path - The path to validate
+     * @returns true if the path is a valid URL (any protocol)
+     */
+    static isValidUrl(path) {
+        try {
+            const url = new URL(path.trim());
+            // URL constructor accepts any protocol, so we just check if it parses
+            return url.protocol.length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Check if path is HTTP/HTTPS URL
+     * @param path - The path to check
+     * @returns true if the path is an HTTP or HTTPS URL
+     */
+    static isRemoteUrl(path) {
+        try {
+            const trimmed = path.trim();
+            // Must start with http:// or https:// to be a valid remote URL
+            // This prevents malformed URLs like "http:example.com" from being accepted
+            if (!trimmed.startsWith('http://') && !trimmed.startsWith('https://')) {
+                return false;
+            }
+            const url = new URL(trimmed);
+            // Must be http or https protocol
+            if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+                return false;
+            }
+            // Must have a hostname (not empty)
+            if (!url.hostname || url.hostname.length === 0) {
+                return false;
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=path-type-detector.js.map

package/dist/loader/path-type-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-type-detector.js","sourceRoot":"","sources":["../../src/loader/path-type-detector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAN,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,iCAAqB,CAAA;IACrB,mCAAuB,CAAA;AACzB,CAAC,EAJW,QAAQ,KAAR,QAAQ,QAInB;AAQD,MAAM,OAAO,gBAAgB;IAC3B;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,IAAY;QACxB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAEhC,IAAI,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;YACjC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAEhF,OAAO;gBACL,IAAI;gBACJ,YAAY,EAAE,IAAI;gBAClB,cAAc,EAAE,WAAW;aAC5B,CAAC;QACJ,CAAC;QAED,wBAAwB;QACxB,OAAO;YACL,IAAI,EAAE,QAAQ,CAAC,KAAK;YACpB,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,WAAW;SAC5B,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,IAAY;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACjC,sEAAsE;YACtE,OAAO,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAAC,IAAY;QAC7B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAE5B,+DAA+D;YAC/D,2EAA2E;YAC3E,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBACtE,OAAO,KAAK,CAAC;YACf,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;YAE7B,iCAAiC;YACjC,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC1D,OAAO,KAAK,CAAC;YACf,CAAC;YAED,mCAAmC;YACnC,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/C,OAAO,KAAK,CAAC;YACf,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,112 @@
+/**
+ * Remote documentation source - loads documentation from HTTP/HTTPS URLs
+ */
+import { DocumentationSource } from './documentation-source.js';
+import { LoadResult } from './documentation-loader.js';
+import { CompodocDocumentation } from '../types/compodoc.js';
+/**
+ * Options for RemoteDocumentationSource
+ */
+export interface RemoteSourceOptions {
+    /** The URL to fetch documentation from */
+    url: string;
+    /** Request timeout in milliseconds */
+    timeout: number;
+    /** Maximum number of retry attempts */
+    maxRetries: number;
+    /** Polling interval in milliseconds */
+    pollingInterval: number;
+    /** Callback invoked when documentation is reloaded */
+    onReload?: (data: CompodocDocumentation) => void;
+    /** Callback invoked when an error occurs */
+    onError?: (error: Error) => void;
+}
+/**
+ * RemoteDocumentationSource class
+ * Implements DocumentationSource interface for remote HTTP/HTTPS sources
+ *
+ * Features:
+ * - Fetches documentation from remote URLs
+ * - Caches responses with ETag/Last-Modified headers
+ * - Polls for updates using conditional requests
+ * - Handles network errors with retry logic
+ */
+export declare class RemoteDocumentationSource implements DocumentationSource {
+    private url;
+    private httpClient;
+    private cacheManager;
+    private pollingTimer?;
+    private currentData?;
+    private pollingInterval;
+    private onReloadCallback?;
+    private onErrorCallback?;
+    constructor(options: RemoteSourceOptions);
+    /**
+     * Load documentation from the remote URL
+     *
+     * @returns Promise resolving to LoadResult with success status and data or error
+     */
+    load(): Promise<LoadResult>;
+    /**
+     * Start monitoring for changes by polling the remote URL
+     *
+     * Uses setInterval to periodically check for updates using conditional requests
+     */
+    startMonitoring(): void;
+    /**
+     * Stop monitoring for changes
+     *
+     * Clears the polling interval
+     *
+     * @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
+     *
+     * Stops monitoring and clears cached data
+     *
+     * @returns Promise that resolves when cleanup is complete
+     */
+    dispose(): Promise<void>;
+    /**
+     * Poll for updates using conditional requests
+     *
+     * Uses If-None-Match (ETag) and If-Modified-Since (Last-Modified) headers
+     * to minimize bandwidth. If the server returns 304 Not Modified, uses cached data.
+     *
+     * @private
+     */
+    private poll;
+    /**
+     * Fetch and parse documentation from the remote URL
+     *
+     * @private
+     * @returns Promise resolving to LoadResult
+     */
+    private fetchDocumentation;
+    /**
+     * Parse JSON string into CompodocDocumentation
+     *
+     * @private
+     * @param content - JSON string to parse
+     * @returns Parsed CompodocDocumentation object
+     * @throws ParseError if JSON is invalid
+     */
+    private parseJson;
+    /**
+     * Validate the basic structure of the documentation
+     *
+     * @private
+     * @param data - Data to validate
+     * @returns Error message if validation fails, null otherwise
+     */
+    private validateStructure;
+}
+//# sourceMappingURL=remote-documentation-source.d.ts.map