@specverse/engines 4.1.0

package/dist/registry/client/registry-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-client.d.ts","sourceRoot":"","sources":["../../../src/registry/client/registry-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EAEd,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IAEjB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAEhB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAEhB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAYD;;;;;GAKG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;gBAEzB,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAIlD;;;;;OAKG;IACG,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2CpF;;;;;OAKG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAwBvE;;;;;;OAMG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,cAAc,CAAC;IAmC1F;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAiBtD;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAWrC;;;;;;OAMG;YACW,cAAc;IA4B5B;;;;OAIG;IACH,OAAO,CAAC,KAAK;IAIb;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IASzB;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAkCxB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;CAG1D;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAGlC,KAAK,CAAC,EAAE,GAAG;gBADlB,OAAO,EAAE,MAAM,EACR,KAAK,CAAC,EAAE,GAAG;IAWpB;;OAEG;IACH,cAAc,IAAI,OAAO;IASzB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,cAAc,IAAI,MAAM;CAWzB"}

package/dist/registry/client/registry-client.js

@@ -0,0 +1,317 @@
+/**
+ * Registry HTTP Client
+ *
+ * Fetches instance factory metadata from the SpecVerse Registry API.
+ * Uses Node.js 18+ built-in fetch with retry logic and timeout handling.
+ *
+ * @module registry/client/registry-client
+ * @version 2.0.0
+ */
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    endpoint: process.env.SPECVERSE_REGISTRY_URL || 'https://specverse-lang-registry-api.vercel.app',
+    timeout: 10000,
+    retries: 3,
+    userAgent: 'SpecVerse CLI'
+};
+/**
+ * Registry HTTP Client
+ *
+ * Handles communication with the SpecVerse Registry API to fetch
+ * instance factory metadata.
+ */
+export class RegistryClient {
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Fetch all instance factory metadata
+     *
+     * @param options - Query options for filtering
+     * @returns Registry response with factory metadata
+     */
+    async fetchFactories(options = {}) {
+        const params = new URLSearchParams({ type: 'factory' });
+        if (options.capability) {
+            params.append('capability', options.capability);
+        }
+        if (options.framework) {
+            params.append('framework', options.framework);
+        }
+        if (options.tags && options.tags.length > 0) {
+            params.append('tags', options.tags.join(','));
+        }
+        if (options.deprecated !== undefined) {
+            params.append('deprecated', String(options.deprecated));
+        }
+        if (options.page !== undefined) {
+            params.append('page', String(options.page));
+        }
+        if (options.pageSize !== undefined) {
+            params.append('pageSize', String(options.pageSize));
+        }
+        const url = `${this.config.endpoint}/api/libraries?${params}`;
+        try {
+            const response = await this.fetchWithRetry(url);
+            if (!response.ok) {
+                throw new Error(`Registry returned ${response.status}: ${response.statusText}`);
+            }
+            const data = await response.json();
+            return this.transformResponse(data);
+        }
+        catch (error) {
+            throw new RegistryFetchError('Failed to fetch registry metadata', error);
+        }
+    }
+    /**
+     * Get specific factory metadata by name
+     *
+     * @param name - Factory name (e.g., "PrismaPostgres")
+     * @returns Factory metadata or null if not found
+     */
+    async getFactory(name) {
+        const url = `${this.config.endpoint}/api/factories/${encodeURIComponent(name)}`;
+        try {
+            const response = await this.fetchWithRetry(url);
+            if (response.status === 404) {
+                return null;
+            }
+            if (!response.ok) {
+                throw new Error(`Registry returned ${response.status}: ${response.statusText}`);
+            }
+            const data = await response.json();
+            return this.transformFactory(data.factory || data);
+        }
+        catch (error) {
+            if (error instanceof RegistryFetchError) {
+                throw error;
+            }
+            throw new RegistryFetchError(`Failed to fetch factory "${name}"`, error);
+        }
+    }
+    /**
+     * Search factories with fuzzy matching
+     *
+     * @param query - Search query string
+     * @param options - Search options
+     * @returns Search results with scores
+     */
+    async search(query, options = {}) {
+        const params = new URLSearchParams({ q: query, type: 'factory' });
+        if (options.capability) {
+            params.append('capability', options.capability);
+        }
+        if (options.framework) {
+            params.append('framework', options.framework);
+        }
+        if (options.tags && options.tags.length > 0) {
+            params.append('tags', options.tags.join(','));
+        }
+        const url = `${this.config.endpoint}/api/search?${params}`;
+        try {
+            const response = await this.fetchWithRetry(url);
+            if (!response.ok) {
+                throw new Error(`Registry returned ${response.status}: ${response.statusText}`);
+            }
+            const data = await response.json();
+            return {
+                query,
+                results: data.results || [],
+                suggestions: data.suggestions || []
+            };
+        }
+        catch (error) {
+            throw new RegistryFetchError(`Failed to search for "${query}"`, error);
+        }
+    }
+    /**
+     * Get all capabilities with factory counts
+     *
+     * @returns Capabilities response
+     */
+    async getCapabilities() {
+        const url = `${this.config.endpoint}/api/capabilities`;
+        try {
+            const response = await this.fetchWithRetry(url);
+            if (!response.ok) {
+                throw new Error(`Registry returned ${response.status}: ${response.statusText}`);
+            }
+            const data = await response.json();
+            return data;
+        }
+        catch (error) {
+            throw new RegistryFetchError('Failed to fetch capabilities', error);
+        }
+    }
+    /**
+     * Check if registry is accessible
+     *
+     * @returns True if registry is reachable
+     */
+    async checkHealth() {
+        const url = `${this.config.endpoint}/health`;
+        try {
+            const response = await this.fetchWithRetry(url, 1); // Only one attempt
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Fetch with automatic retry and exponential backoff
+     *
+     * @param url - URL to fetch
+     * @param attempt - Current attempt number
+     * @returns Response object
+     */
+    async fetchWithRetry(url, attempt = 1) {
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+            const response = await fetch(url, {
+                signal: controller.signal,
+                headers: {
+                    'User-Agent': this.config.userAgent || 'SpecVerse CLI',
+                    'Accept': 'application/json'
+                }
+            });
+            clearTimeout(timeoutId);
+            return response;
+        }
+        catch (error) {
+            // Check if we should retry
+            if (attempt < this.config.retries) {
+                // Exponential backoff: 1s, 2s, 3s, etc.
+                await this.delay(1000 * attempt);
+                return this.fetchWithRetry(url, attempt + 1);
+            }
+            // Max retries reached, throw error
+            throw error;
+        }
+    }
+    /**
+     * Delay helper for retry backoff
+     *
+     * @param ms - Milliseconds to delay
+     */
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Transform registry API response to internal format
+     *
+     * Handles differences between registry API format and internal types.
+     *
+     * @param data - Raw API response
+     * @returns Transformed registry response
+     */
+    transformResponse(data) {
+        return {
+            results: (data.results || []).map((lib) => this.transformFactory(lib)),
+            total: data.total || 0,
+            page: data.page || 1,
+            pageSize: data.pageSize || data.results?.length || 0
+        };
+    }
+    /**
+     * Transform single factory from API format to internal format
+     *
+     * @param lib - Raw library/factory data from API
+     * @returns Transformed factory metadata
+     */
+    transformFactory(lib) {
+        const factoryMeta = lib.factoryMeta || {};
+        return {
+            name: lib.name,
+            displayName: lib.displayName || lib.name,
+            category: lib.category || 'unknown',
+            capabilities: factoryMeta.capabilities || [],
+            framework: factoryMeta.framework || null,
+            deprecated: lib.deprecated || false,
+            deprecationReason: factoryMeta.deprecationReason,
+            replacedBy: factoryMeta.replacedBy,
+            alternatives: factoryMeta.alternatives || [],
+            source: {
+                type: factoryMeta.sourceType || 'npm',
+                package: factoryMeta.sourcePackage,
+                version: factoryMeta.sourceVersion,
+                entrypoint: factoryMeta.sourceEntrypoint || 'factory.yaml',
+                url: factoryMeta.sourceUrl,
+                checksum: factoryMeta.sourceChecksum
+            },
+            tags: (lib.tags || []).map((t) => (typeof t === 'string' ? t : t.name)),
+            description: lib.description || '',
+            license: lib.license,
+            repository: lib.repository,
+            stats: {
+                downloads: lib.downloadCount || 0,
+                stars: lib.starCount || 0
+            },
+            createdAt: lib.createdAt || new Date().toISOString(),
+            updatedAt: lib.updatedAt || new Date().toISOString()
+        };
+    }
+    /**
+     * Get the configured endpoint URL
+     */
+    getEndpoint() {
+        return this.config.endpoint;
+    }
+    /**
+     * Update client configuration
+     *
+     * @param config - Partial config to merge
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+}
+/**
+ * Registry fetch error
+ *
+ * Thrown when registry API requests fail.
+ */
+export class RegistryFetchError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'RegistryFetchError';
+        // Preserve stack trace
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, RegistryFetchError);
+        }
+    }
+    /**
+     * Check if error is due to network issues
+     */
+    isNetworkError() {
+        return (this.cause?.name === 'AbortError' ||
+            this.cause?.name === 'TypeError' ||
+            this.cause?.code === 'ECONNREFUSED' ||
+            this.cause?.code === 'ENOTFOUND');
+    }
+    /**
+     * Check if error is due to timeout
+     */
+    isTimeout() {
+        return this.cause?.name === 'AbortError';
+    }
+    /**
+     * Get user-friendly error message
+     */
+    getUserMessage() {
+        if (this.isTimeout()) {
+            return 'Request timed out. The registry may be slow or unreachable.';
+        }
+        if (this.isNetworkError()) {
+            return 'Network error. Check your internet connection and try again.';
+        }
+        return this.message;
+    }
+}
+//# sourceMappingURL=registry-client.js.map

package/dist/registry/client/registry-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-client.js","sourceRoot":"","sources":["../../../src/registry/client/registry-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA6BH;;GAEG;AACH,MAAM,cAAc,GAAyB;IAC3C,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,gDAAgD;IAChG,OAAO,EAAE,KAAK;IACd,OAAO,EAAE,CAAC;IACV,SAAS,EAAE,eAAe;CAC3B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IACjB,MAAM,CAAuB;IAErC,YAAY,MAAsC;QAChD,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IACjD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAAC,UAAiC,EAAE;QACtD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAExD,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,kBAAkB,MAAM,EAAE,CAAC;QAE9D,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAEhD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YAClF,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,kBAAkB,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QAEhF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAEhD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,OAAO,IAAI,CAAC;YACd,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YAClF,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAS,CAAC;YAC1C,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;gBACxC,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,IAAI,kBAAkB,CAAC,4BAA4B,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,UAAkC,EAAE;QAC9D,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAElE,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,eAAe,MAAM,EAAE,CAAC;QAE3D,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAEhD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YAClF,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAS,CAAC;YAC1C,OAAO;gBACL,KAAK;gBACL,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;gBAC3B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;aACpC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAAC,yBAAyB,KAAK,GAAG,EAAE,KAAK,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,eAAe;QACnB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,mBAAmB,CAAC;QAEvD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YAEhD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YAClF,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,OAAO,IAA4B,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,SAAS,CAAC;QAE7C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,mBAAmB;YACvE,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,cAAc,CAAC,GAAW,EAAE,OAAO,GAAG,CAAC;QACnD,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAE5E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,OAAO,EAAE;oBACP,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,eAAe;oBACtD,QAAQ,EAAE,kBAAkB;iBAC7B;aACF,CAAC,CAAC;YAEH,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,2BAA2B;YAC3B,IAAI,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAClC,wCAAwC;gBACxC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC;gBACjC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;YAC/C,CAAC;YAED,mCAAmC;YACnC,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;;;;;;OAOG;IACK,iBAAiB,CAAC,IAAS;QACjC,OAAO;YACL,OAAO,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;YAC3E,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC;YACtB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC;YACpB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;SACrD,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACK,gBAAgB,CAAC,GAAQ;QAC/B,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;QAE1C,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,IAAI;YACxC,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,SAAS;YACnC,YAAY,EAAE,WAAW,CAAC,YAAY,IAAI,EAAE;YAC5C,SAAS,EAAE,WAAW,CAAC,SAAS,IAAI,IAAI;YACxC,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,KAAK;YACnC,iBAAiB,EAAE,WAAW,CAAC,iBAAiB;YAChD,UAAU,EAAE,WAAW,CAAC,UAAU;YAClC,YAAY,EAAE,WAAW,CAAC,YAAY,IAAI,EAAE;YAC5C,MAAM,EAAE;gBACN,IAAI,EAAE,WAAW,CAAC,UAAU,IAAI,KAAK;gBACrC,OAAO,EAAE,WAAW,CAAC,aAAa;gBAClC,OAAO,EAAE,WAAW,CAAC,aAAa;gBAClC,UAAU,EAAE,WAAW,CAAC,gBAAgB,IAAI,cAAc;gBAC1D,GAAG,EAAE,WAAW,CAAC,SAAS;gBAC1B,QAAQ,EAAE,WAAW,CAAC,cAAc;aACrC;YACD,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC5E,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE;YAClC,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,KAAK,EAAE;gBACL,SAAS,EAAE,GAAG,CAAC,aAAa,IAAI,CAAC;gBACjC,KAAK,EAAE,GAAG,CAAC,SAAS,IAAI,CAAC;aAC1B;YACD,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpD,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,MAAqC;QAChD,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9C,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAGlC;IAFT,YACE,OAAe,EACR,KAAW;QAElB,KAAK,CAAC,OAAO,CAAC,CAAC;QAFR,UAAK,GAAL,KAAK,CAAM;QAGlB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QAEjC,uBAAuB;QACvB,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,CACL,IAAI,CAAC,KAAK,EAAE,IAAI,KAAK,YAAY;YACjC,IAAI,CAAC,KAAK,EAAE,IAAI,KAAK,WAAW;YAChC,IAAI,CAAC,KAAK,EAAE,IAAI,KAAK,cAAc;YACnC,IAAI,CAAC,KAAK,EAAE,IAAI,KAAK,WAAW,CACjC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,EAAE,IAAI,KAAK,YAAY,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACrB,OAAO,6DAA6D,CAAC;QACvE,CAAC;QAED,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;YAC1B,OAAO,8DAA8D,CAAC;QACxE,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}

package/dist/registry/formatters/error-formatter.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Error Formatter
+ *
+ * Formats validation issues for beautiful console output.
+ * Provides colored, contextualized error messages with suggestions.
+ *
+ * @module registry/formatters/error-formatter
+ * @version 2.0.0
+ */
+import type { ValidationIssue, ValidationResult } from '../types/index.js';
+import type { ValidationReport } from '../validators/validator.js';
+/**
+ * Error formatter options
+ */
+export interface ErrorFormatterOptions {
+    /** Use colors in output (default: true) */
+    colors?: boolean;
+    /** Show suggestions (default: true) */
+    showSuggestions?: boolean;
+    /** Show fix commands (default: true) */
+    showFix?: boolean;
+    /** Show "learn more" URLs (default: true) */
+    showLearnMore?: boolean;
+    /** Compact mode - less verbose (default: false) */
+    compact?: boolean;
+}
+/**
+ * Error Formatter
+ *
+ * Formats validation issues for console output.
+ */
+export declare class ErrorFormatter {
+    private options;
+    constructor(options?: ErrorFormatterOptions);
+    /**
+     * Format a complete validation report
+     *
+     * @param report - Validation report to format
+     * @returns Formatted string ready for console output
+     */
+    formatReport(report: ValidationReport): string;
+    /**
+     * Format validation result
+     *
+     * @param result - Validation result to format
+     * @returns Formatted string
+     */
+    formatResult(result: ValidationResult): string;
+    /**
+     * Format a single validation issue
+     *
+     * @param issue - Issue to format
+     * @returns Formatted string
+     */
+    formatIssue(issue: ValidationIssue): string;
+    /**
+     * Format header
+     *
+     * @param report - Validation report
+     * @returns Formatted header
+     */
+    private formatHeader;
+    /**
+     * Format summary
+     *
+     * @param report - Validation report
+     * @returns Formatted summary
+     */
+    private formatSummary;
+    /**
+     * Format footer
+     *
+     * @param report - Validation report
+     * @returns Formatted footer
+     */
+    private formatFooter;
+    /**
+     * Get icon for severity
+     *
+     * @param severity - Issue severity
+     * @returns Icon character
+     */
+    private getIcon;
+    /**
+     * Get color for severity
+     *
+     * @param severity - Issue severity
+     * @returns ANSI color code
+     */
+    private getSeverityColor;
+    /**
+     * Apply color to text
+     *
+     * @param colorCode - ANSI color code
+     * @param text - Text to color
+     * @returns Colored text (or plain text if colors disabled)
+     */
+    private color;
+}
+//# sourceMappingURL=error-formatter.d.ts.map

package/dist/registry/formatters/error-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-formatter.d.ts","sourceRoot":"","sources":["../../../src/registry/formatters/error-formatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAuBnE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,uCAAuC;IACvC,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAkC;gBAErC,OAAO,GAAE,qBAA0B;IAU/C;;;;;OAKG;IACH,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM;IA+C9C;;;;;OAKG;IACH,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM;IAoC9C;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM;IAiD3C;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAYpB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IA0CrB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAiBpB;;;;;OAKG;IACH,OAAO,CAAC,OAAO;IAaf;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;;;;;OAMG;IACH,OAAO,CAAC,KAAK;CAOd"}