@memberjunction/component-registry-client-sdk 2.100.0

package/README.md

@@ -0,0 +1,197 @@
+# Component Registry Client SDK
+
+A TypeScript SDK for interacting with Component Registry servers. This package provides a robust REST API client for fetching, searching, and managing interactive components from remote registries.
+
+## Features
+
+- 🚀 **Native Fetch**: Uses native fetch API, no external HTTP dependencies
+- 🔄 **Retry Logic**: Automatic retry with exponential backoff
+- ⏱️ **Timeout Support**: Configurable request timeouts
+- 🔍 **Type Safety**: Full TypeScript support with comprehensive types
+- 📦 **Component Management**: Get, search, and resolve component dependencies
+- 🔒 **Authentication**: Support for API key and Bearer token authentication
+- 🏗️ **Registry Integration**: Used by MJServer for external registry communication
+
+## Installation
+
+```bash
+npm install @memberjunction/component-registry-client-sdk
+```
+
+## Usage
+
+### Basic Setup
+
+```typescript
+import { ComponentRegistryClient } from '@memberjunction/component-registry-client-sdk';
+
+const client = new ComponentRegistryClient({
+    baseUrl: 'https://registry.example.com',
+    apiKey: 'your-api-key',
+    timeout: 30000
+});
+```
+
+### Get a Component
+
+```typescript
+const component = await client.getComponent({
+    registry: 'mj-central',
+    namespace: 'core/ui',
+    name: 'DataGrid',
+    version: '1.0.0' // or 'latest'
+});
+
+console.log(component.name);
+console.log(component.code);
+```
+
+### Search Components
+
+```typescript
+const results = await client.searchComponents({
+    namespace: 'core/ui',
+    query: 'dashboard',
+    type: 'dashboard',
+    tags: ['analytics', 'reporting'],
+    limit: 20,
+    offset: 0
+});
+
+console.log(`Found ${results.total} components`);
+results.components.forEach(comp => {
+    console.log(`- ${comp.name}: ${comp.description}`);
+});
+```
+
+### Resolve Dependencies
+
+```typescript
+const dependencyTree = await client.resolveDependencies('component-123');
+
+console.log(`Component has ${dependencyTree.totalCount} total dependencies`);
+if (dependencyTree.circular) {
+    console.warn('Circular dependency detected!');
+}
+```
+
+## Configuration Options
+
+```typescript
+interface ComponentRegistryClientConfig {
+    baseUrl: string;           // Registry server URL
+    apiKey?: string;          // API key for authentication
+    timeout?: number;         // Request timeout in ms (default: 30000)
+    headers?: HeadersInit;    // Additional headers
+    retryPolicy?: {
+        maxRetries: number;       // Max retry attempts (default: 3)
+        initialDelay: number;     // Initial delay in ms (default: 1000)
+        maxDelay: number;         // Max delay in ms (default: 10000)
+        backoffMultiplier: number; // Delay multiplier (default: 2)
+    };
+}
+```
+
+## Error Handling
+
+The SDK provides typed errors with specific error codes:
+
+```typescript
+import { RegistryError, RegistryErrorCode } from '@memberjunction/component-registry-client-sdk';
+
+try {
+    const component = await client.getComponent({...});
+} catch (error) {
+    if (error instanceof RegistryError) {
+        switch (error.code) {
+            case RegistryErrorCode.COMPONENT_NOT_FOUND:
+                console.log('Component not found');
+                break;
+            case RegistryErrorCode.AUTHENTICATION_FAILED:
+                console.log('Invalid API key');
+                break;
+            case RegistryErrorCode.NETWORK_ERROR:
+                console.log('Network issue:', error.details);
+                break;
+            default:
+                console.error('Registry error:', error.message);
+        }
+    }
+}
+```
+
+## Integration with MemberJunction
+
+This SDK integrates seamlessly with the MemberJunction platform:
+
+### GraphQL Integration
+
+Use with the GraphQL data provider:
+
+```typescript
+import { GraphQLComponentRegistryClient } from '@memberjunction/graphql-dataprovider';
+
+const graphQLClient = new GraphQLComponentRegistryClient(dataProvider);
+const component = await graphQLClient.GetRegistryComponent({
+    registryName: 'MJ',  // Registry name (globally unique)
+    namespace: 'core/ui',
+    name: 'DataGrid',
+    version: 'latest'
+});
+```
+
+### React Runtime Integration
+
+Integrate with the React runtime:
+
+```typescript
+import { ComponentRegistryService } from '@memberjunction/react-runtime';
+
+const registryService = ComponentRegistryService.getInstance(
+    compiler,
+    runtimeContext,
+    debug,
+    graphQLClient
+);
+```
+
+## Architecture Overview
+
+### Registry Communication Flow
+
+1. **React Runtime** → Requests component with `registry` field in spec
+2. **React Runtime** → Calls GraphQL API via `GraphQLComponentRegistryClient`
+3. **MJServer** → Receives GraphQL request with registry name
+4. **MJServer** → Creates `ComponentRegistryClient` on-demand
+5. **MJServer** → Fetches component from external registry using API key
+6. **External Registry** → Returns component specification
+7. **MJServer** → Returns spec to React Runtime
+8. **React Runtime** → Compiles and caches component
+
+### Key Design Decisions
+
+- **On-Demand Client Creation**: MJServer creates registry clients per-request, not pre-initialized
+- **Registry Name Resolution**: Components reference registries by globally unique names, not IDs
+- **API Key Management**: All API keys handled server-side in MJServer, never exposed to client
+- **No Client-Side Caching**: This SDK doesn't cache responses; caching happens at higher layers
+
+## API Reference
+
+### `getComponent(params)`
+Fetches a specific component from a registry.
+
+### `searchComponents(params)`
+Searches for components matching criteria.
+
+### `resolveDependencies(componentId)`
+Resolves the full dependency tree for a component.
+
+### `getLatestVersion(registry, namespace, name)`
+Gets the latest version of a component.
+
+### `checkHealth()`
+Checks if the registry server is healthy.
+
+## License
+
+MIT

package/dist/ComponentRegistryClient.d.ts

@@ -0,0 +1,70 @@
+import { ComponentSpec } from '@memberjunction/interactive-component-types';
+import { ComponentRegistryClientConfig, GetComponentParams, SearchComponentsParams, ComponentSearchResult, ComponentResponse, ResolvedVersion, RegistryInfo, Namespace, DependencyTree } from './types';
+/**
+ * Client for interacting with Component Registry Servers
+ */
+export declare class ComponentRegistryClient {
+    private config;
+    private defaultTimeout;
+    private defaultRetryPolicy;
+    constructor(config: ComponentRegistryClientConfig);
+    /**
+     * Get a specific component from the registry (backward compatible)
+     */
+    getComponent(params: GetComponentParams): Promise<ComponentSpec>;
+    /**
+     * Get a specific component from the registry with hash support
+     * Returns ComponentResponse which includes hash and notModified flag
+     */
+    getComponentWithHash(params: GetComponentParams): Promise<ComponentResponse>;
+    /**
+     * Search for components in the registry
+     */
+    searchComponents(params: SearchComponentsParams): Promise<ComponentSearchResult>;
+    /**
+     * Resolve a version range to a specific version
+     */
+    resolveVersion(params: {
+        registry: string;
+        namespace: string;
+        name: string;
+        versionRange: string;
+    }): Promise<ResolvedVersion>;
+    /**
+     * Get information about a registry
+     */
+    getRegistryInfo(registry: string): Promise<RegistryInfo>;
+    /**
+     * List namespaces in a registry
+     */
+    listNamespaces(registry: string): Promise<Namespace[]>;
+    /**
+     * Resolve dependencies for a component
+     */
+    resolveDependencies(componentId: string): Promise<DependencyTree>;
+    /**
+     * Health check for the registry server
+     */
+    ping(): Promise<boolean>;
+    /**
+     * Make an HTTP request with retry logic
+     */
+    private makeRequest;
+    /**
+     * Determine if a request should be retried
+     */
+    private shouldRetry;
+    /**
+     * Calculate retry delay with exponential backoff
+     */
+    private getRetryDelay;
+    /**
+     * Sleep for specified milliseconds
+     */
+    private sleep;
+    /**
+     * Map error codes from server to client enum
+     */
+    private mapErrorCode;
+}
+//# sourceMappingURL=ComponentRegistryClient.d.ts.map

package/dist/ComponentRegistryClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentRegistryClient.d.ts","sourceRoot":"","sources":["../src/ComponentRegistryClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAC5E,OAAO,EACL,6BAA6B,EAC7B,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,SAAS,EACT,cAAc,EAIf,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,kBAAkB,CAKxB;gBAEU,MAAM,EAAE,6BAA6B;IAajD;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IAatE;;;OAGG;IACG,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwClF;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA+BtF;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE;QAC3B,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,eAAe,CAAC;IAuB5B;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAmB9D;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAmB5D;;OAEG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAmBvE;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAW9B;;OAEG;YACW,WAAW;IA4HzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAenB;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,YAAY;CAgBrB"}

package/dist/ComponentRegistryClient.js

@@ -0,0 +1,332 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComponentRegistryClient = void 0;
+const types_1 = require("./types");
+/**
+ * Client for interacting with Component Registry Servers
+ */
+class ComponentRegistryClient {
+    constructor(config) {
+        this.defaultTimeout = 30000; // 30 seconds
+        this.defaultRetryPolicy = {
+            maxRetries: 3,
+            initialDelay: 1000,
+            maxDelay: 10000,
+            backoffMultiplier: 2
+        };
+        this.config = {
+            ...config,
+            timeout: config.timeout || this.defaultTimeout,
+            retryPolicy: config.retryPolicy || this.defaultRetryPolicy
+        };
+        // Ensure baseUrl doesn't end with slash
+        if (this.config.baseUrl.endsWith('/')) {
+            this.config.baseUrl = this.config.baseUrl.slice(0, -1);
+        }
+    }
+    /**
+     * Get a specific component from the registry (backward compatible)
+     */
+    async getComponent(params) {
+        const response = await this.getComponentWithHash(params);
+        if (!response.specification) {
+            throw new types_1.RegistryError(`Component ${params.namespace}/${params.name} returned without specification`, types_1.RegistryErrorCode.UNKNOWN);
+        }
+        return response.specification;
+    }
+    /**
+     * Get a specific component from the registry with hash support
+     * Returns ComponentResponse which includes hash and notModified flag
+     */
+    async getComponentWithHash(params) {
+        const { namespace, name, version = 'latest', hash } = params;
+        // Build query parameters
+        const queryParams = new URLSearchParams();
+        if (version !== 'latest') {
+            queryParams.append('version', version);
+        }
+        if (hash) {
+            queryParams.append('hash', hash);
+        }
+        const queryString = queryParams.toString();
+        const path = `/api/v1/components/${encodeURIComponent(namespace)}/${encodeURIComponent(name)}${queryString ? `?${queryString}` : ''}`;
+        try {
+            const response = await this.makeRequest('GET', path);
+            // Handle 304 Not Modified response
+            if (response && typeof response === 'object' && 'message' in response && response.message === 'Not modified') {
+                return {
+                    ...response,
+                    notModified: true
+                };
+            }
+            return response;
+        }
+        catch (error) {
+            if (error instanceof types_1.RegistryError) {
+                throw error;
+            }
+            throw new types_1.RegistryError(`Failed to get component ${namespace}/${name}@${version}`, types_1.RegistryErrorCode.UNKNOWN, undefined, error);
+        }
+    }
+    /**
+     * Search for components in the registry
+     */
+    async searchComponents(params) {
+        const queryParams = new URLSearchParams();
+        if (params.registry)
+            queryParams.append('registry', params.registry);
+        if (params.namespace)
+            queryParams.append('namespace', params.namespace);
+        if (params.query)
+            queryParams.append('q', params.query);
+        if (params.type)
+            queryParams.append('type', params.type);
+        if (params.tags)
+            params.tags.forEach(tag => queryParams.append('tag', tag));
+        if (params.limit !== undefined)
+            queryParams.append('limit', params.limit.toString());
+        if (params.offset !== undefined)
+            queryParams.append('offset', params.offset.toString());
+        if (params.sortBy)
+            queryParams.append('sortBy', params.sortBy);
+        if (params.sortDirection)
+            queryParams.append('sortDirection', params.sortDirection);
+        const path = `/api/v1/components/search?${queryParams.toString()}`;
+        try {
+            const response = await this.makeRequest('GET', path);
+            return response;
+        }
+        catch (error) {
+            if (error instanceof types_1.RegistryError) {
+                throw error;
+            }
+            throw new types_1.RegistryError('Failed to search components', types_1.RegistryErrorCode.UNKNOWN, undefined, error);
+        }
+    }
+    /**
+     * Resolve a version range to a specific version
+     */
+    async resolveVersion(params) {
+        const { registry, namespace, name, versionRange } = params;
+        const path = `/api/v1/components/${encodeURIComponent(registry)}/${encodeURIComponent(namespace)}/${encodeURIComponent(name)}/versions/resolve`;
+        try {
+            const response = await this.makeRequest('POST', path, {
+                versionRange
+            });
+            return response;
+        }
+        catch (error) {
+            if (error instanceof types_1.RegistryError) {
+                throw error;
+            }
+            throw new types_1.RegistryError(`Failed to resolve version for ${registry}/${namespace}/${name}`, types_1.RegistryErrorCode.UNKNOWN, undefined, error);
+        }
+    }
+    /**
+     * Get information about a registry
+     */
+    async getRegistryInfo(registry) {
+        const path = `/api/v1/registries/${encodeURIComponent(registry)}`;
+        try {
+            const response = await this.makeRequest('GET', path);
+            return response;
+        }
+        catch (error) {
+            if (error instanceof types_1.RegistryError) {
+                throw error;
+            }
+            throw new types_1.RegistryError(`Failed to get registry info for ${registry}`, types_1.RegistryErrorCode.UNKNOWN, undefined, error);
+        }
+    }
+    /**
+     * List namespaces in a registry
+     */
+    async listNamespaces(registry) {
+        const path = `/api/v1/registries/${encodeURIComponent(registry)}/namespaces`;
+        try {
+            const response = await this.makeRequest('GET', path);
+            return response;
+        }
+        catch (error) {
+            if (error instanceof types_1.RegistryError) {
+                throw error;
+            }
+            throw new types_1.RegistryError(`Failed to list namespaces for registry ${registry}`, types_1.RegistryErrorCode.UNKNOWN, undefined, error);
+        }
+    }
+    /**
+     * Resolve dependencies for a component
+     */
+    async resolveDependencies(componentId) {
+        const path = `/api/v1/components/${encodeURIComponent(componentId)}/dependencies`;
+        try {
+            const response = await this.makeRequest('GET', path);
+            return response;
+        }
+        catch (error) {
+            if (error instanceof types_1.RegistryError) {
+                throw error;
+            }
+            throw new types_1.RegistryError(`Failed to resolve dependencies for component ${componentId}`, types_1.RegistryErrorCode.UNKNOWN, undefined, error);
+        }
+    }
+    /**
+     * Health check for the registry server
+     */
+    async ping() {
+        const path = '/api/v1/health';
+        try {
+            await this.makeRequest('GET', path);
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * Make an HTTP request with retry logic
+     */
+    async makeRequest(method, path, body, retryCount = 0) {
+        const url = `${this.config.baseUrl}${path}`;
+        // Build headers
+        const headers = {
+            'Accept': 'application/json',
+            'Content-Type': 'application/json',
+            ...this.config.headers
+        };
+        if (this.config.apiKey) {
+            headers['Authorization'] = `Bearer ${this.config.apiKey}`;
+        }
+        // Create abort controller for timeout
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers,
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal
+            });
+            clearTimeout(timeoutId);
+            // Handle response - include 304 Not Modified as success
+            if (response.ok || response.status === 304) {
+                const contentType = response.headers.get('content-type');
+                if (contentType && contentType.includes('application/json')) {
+                    return await response.json();
+                }
+                return await response.text();
+            }
+            // Handle errors
+            let errorMessage = `Request failed with status ${response.status}`;
+            let errorCode = types_1.RegistryErrorCode.UNKNOWN;
+            let errorDetails;
+            try {
+                const errorBody = await response.json();
+                if (errorBody.message)
+                    errorMessage = errorBody.message;
+                if (errorBody.code)
+                    errorCode = this.mapErrorCode(errorBody.code);
+                errorDetails = errorBody;
+            }
+            catch {
+                // If response isn't JSON, use status text
+                errorMessage = response.statusText || errorMessage;
+            }
+            // Map HTTP status to error codes
+            if (!errorDetails || !errorDetails.code) {
+                switch (response.status) {
+                    case 401:
+                        errorCode = types_1.RegistryErrorCode.UNAUTHORIZED;
+                        break;
+                    case 403:
+                        errorCode = types_1.RegistryErrorCode.FORBIDDEN;
+                        break;
+                    case 404:
+                        errorCode = types_1.RegistryErrorCode.COMPONENT_NOT_FOUND;
+                        break;
+                    case 429:
+                        errorCode = types_1.RegistryErrorCode.RATE_LIMITED;
+                        break;
+                    case 500:
+                    case 502:
+                    case 503:
+                    case 504:
+                        errorCode = types_1.RegistryErrorCode.SERVER_ERROR;
+                        break;
+                }
+            }
+            throw new types_1.RegistryError(errorMessage, errorCode, response.status, errorDetails);
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            // Handle timeout
+            if (error.name === 'AbortError') {
+                throw new types_1.RegistryError(`Request timeout after ${this.config.timeout}ms`, types_1.RegistryErrorCode.TIMEOUT);
+            }
+            // Handle network errors
+            if (error instanceof TypeError && error.message.includes('fetch')) {
+                throw new types_1.RegistryError('Network error: Unable to connect to registry', types_1.RegistryErrorCode.NETWORK_ERROR, undefined, error);
+            }
+            // If it's already a RegistryError, check if we should retry
+            if (error instanceof types_1.RegistryError) {
+                if (this.shouldRetry(error, retryCount)) {
+                    const delay = this.getRetryDelay(retryCount);
+                    await this.sleep(delay);
+                    return this.makeRequest(method, path, body, retryCount + 1);
+                }
+                throw error;
+            }
+            // Unknown error
+            throw new types_1.RegistryError('Unexpected error during request', types_1.RegistryErrorCode.UNKNOWN, undefined, error);
+        }
+    }
+    /**
+     * Determine if a request should be retried
+     */
+    shouldRetry(error, retryCount) {
+        if (retryCount >= this.config.retryPolicy.maxRetries) {
+            return false;
+        }
+        // Retry on network errors, timeouts, and server errors
+        const retryableCodes = [
+            types_1.RegistryErrorCode.NETWORK_ERROR,
+            types_1.RegistryErrorCode.TIMEOUT,
+            types_1.RegistryErrorCode.SERVER_ERROR
+        ];
+        return retryableCodes.includes(error.code);
+    }
+    /**
+     * Calculate retry delay with exponential backoff
+     */
+    getRetryDelay(retryCount) {
+        const policy = this.config.retryPolicy;
+        const delay = policy.initialDelay * Math.pow(policy.backoffMultiplier, retryCount);
+        return Math.min(delay, policy.maxDelay);
+    }
+    /**
+     * Sleep for specified milliseconds
+     */
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Map error codes from server to client enum
+     */
+    mapErrorCode(code) {
+        const codeMap = {
+            'COMPONENT_NOT_FOUND': types_1.RegistryErrorCode.COMPONENT_NOT_FOUND,
+            'UNAUTHORIZED': types_1.RegistryErrorCode.UNAUTHORIZED,
+            'FORBIDDEN': types_1.RegistryErrorCode.FORBIDDEN,
+            'RATE_LIMITED': types_1.RegistryErrorCode.RATE_LIMITED,
+            'INVALID_VERSION': types_1.RegistryErrorCode.INVALID_VERSION,
+            'INVALID_NAMESPACE': types_1.RegistryErrorCode.INVALID_NAMESPACE,
+            'NETWORK_ERROR': types_1.RegistryErrorCode.NETWORK_ERROR,
+            'TIMEOUT': types_1.RegistryErrorCode.TIMEOUT,
+            'SERVER_ERROR': types_1.RegistryErrorCode.SERVER_ERROR,
+            'INVALID_RESPONSE': types_1.RegistryErrorCode.INVALID_RESPONSE
+        };
+        return codeMap[code] || types_1.RegistryErrorCode.UNKNOWN;
+    }
+}
+exports.ComponentRegistryClient = ComponentRegistryClient;
+//# sourceMappingURL=ComponentRegistryClient.js.map

package/dist/ComponentRegistryClient.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './ComponentRegistryClient';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// PUBLIC API SURFACE AREA
+__exportStar(require("./ComponentRegistryClient"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0BAA0B;AAC1B,4DAA0C;AAC1C,0CAAwB"}

package/dist/types.d.ts

@@ -0,0 +1,305 @@
+import { ComponentSpec } from '@memberjunction/interactive-component-types';
+/**
+ * Configuration for the Component Registry Client
+ */
+export interface ComponentRegistryClientConfig {
+    /**
+     * Base URL of the Component Registry Server
+     */
+    baseUrl: string;
+    /**
+     * Optional API key for authentication
+     */
+    apiKey?: string;
+    /**
+     * Request timeout in milliseconds
+     */
+    timeout?: number;
+    /**
+     * Retry policy configuration
+     */
+    retryPolicy?: RetryPolicy;
+    /**
+     * Custom headers to include with all requests
+     */
+    headers?: Record<string, string>;
+}
+/**
+ * Retry policy configuration
+ */
+export interface RetryPolicy {
+    /**
+     * Maximum number of retry attempts
+     */
+    maxRetries: number;
+    /**
+     * Initial delay in milliseconds
+     */
+    initialDelay?: number;
+    /**
+     * Maximum delay in milliseconds
+     */
+    maxDelay?: number;
+    /**
+     * Backoff multiplier for exponential backoff
+     */
+    backoffMultiplier?: number;
+}
+/**
+ * Parameters for getting a component
+ */
+export interface GetComponentParams {
+    /**
+     * Registry identifier
+     */
+    registry: string;
+    /**
+     * Component namespace
+     */
+    namespace: string;
+    /**
+     * Component name
+     */
+    name: string;
+    /**
+     * Component version (defaults to 'latest')
+     */
+    version?: string;
+    /**
+     * Optional hash for caching - if provided and matches current spec, returns 304
+     */
+    hash?: string;
+}
+/**
+ * Component response with hash and caching support
+ */
+export interface ComponentResponse {
+    /**
+     * Component ID
+     */
+    id: string;
+    /**
+     * Component namespace
+     */
+    namespace: string;
+    /**
+     * Component name
+     */
+    name: string;
+    /**
+     * Component version
+     */
+    version: string;
+    /**
+     * Component specification (undefined if not modified - 304 response)
+     */
+    specification?: ComponentSpec;
+    /**
+     * SHA-256 hash of the specification
+     */
+    hash: string;
+    /**
+     * Indicates if the component was not modified (304 response)
+     */
+    notModified?: boolean;
+    /**
+     * Message from server (e.g., "Not modified")
+     */
+    message?: string;
+}
+/**
+ * Parameters for searching components
+ */
+export interface SearchComponentsParams {
+    /**
+     * Optional registry filter
+     */
+    registry?: string;
+    /**
+     * Optional namespace filter
+     */
+    namespace?: string;
+    /**
+     * Search query string
+     */
+    query?: string;
+    /**
+     * Component type filter
+     */
+    type?: string;
+    /**
+     * Tags to filter by
+     */
+    tags?: string[];
+    /**
+     * Maximum number of results
+     */
+    limit?: number;
+    /**
+     * Offset for pagination
+     */
+    offset?: number;
+    /**
+     * Sort field
+     */
+    sortBy?: 'name' | 'version' | 'createdAt' | 'updatedAt';
+    /**
+     * Sort direction
+     */
+    sortDirection?: 'asc' | 'desc';
+}
+/**
+ * Search result containing components and metadata
+ */
+export interface ComponentSearchResult {
+    /**
+     * Array of matching components
+     */
+    components: ComponentSpec[];
+    /**
+     * Total number of matches
+     */
+    total: number;
+    /**
+     * Current offset
+     */
+    offset: number;
+    /**
+     * Current limit
+     */
+    limit: number;
+}
+/**
+ * Resolved version information
+ */
+export interface ResolvedVersion {
+    /**
+     * The resolved version number
+     */
+    version: string;
+    /**
+     * Whether this is the latest version
+     */
+    isLatest: boolean;
+    /**
+     * Available versions that match the range
+     */
+    availableVersions?: string[];
+}
+/**
+ * Registry information
+ */
+export interface RegistryInfo {
+    /**
+     * Registry identifier
+     */
+    id: string;
+    /**
+     * Registry name
+     */
+    name: string;
+    /**
+     * Registry description
+     */
+    description?: string;
+    /**
+     * Registry version
+     */
+    version: string;
+    /**
+     * Available namespaces
+     */
+    namespaces?: string[];
+    /**
+     * Total component count
+     */
+    componentCount?: number;
+    /**
+     * Registry capabilities
+     */
+    capabilities?: string[];
+}
+/**
+ * Namespace information
+ */
+export interface Namespace {
+    /**
+     * Namespace path
+     */
+    path: string;
+    /**
+     * Display name
+     */
+    name?: string;
+    /**
+     * Description
+     */
+    description?: string;
+    /**
+     * Number of components in namespace
+     */
+    componentCount?: number;
+    /**
+     * Child namespaces
+     */
+    children?: Namespace[];
+}
+/**
+ * Dependency tree structure
+ */
+export interface DependencyTree {
+    /**
+     * Component identifier
+     */
+    componentId: string;
+    /**
+     * Component name
+     */
+    name?: string;
+    /**
+     * Component namespace
+     */
+    namespace?: string;
+    /**
+     * Component version
+     */
+    version?: string;
+    /**
+     * Direct dependencies
+     */
+    dependencies?: DependencyTree[];
+    /**
+     * Whether this is a circular dependency
+     */
+    circular?: boolean;
+    /**
+     * Total count of all dependencies
+     */
+    totalCount?: number;
+}
+/**
+ * Error codes for registry operations
+ */
+export declare enum RegistryErrorCode {
+    COMPONENT_NOT_FOUND = "COMPONENT_NOT_FOUND",
+    UNAUTHORIZED = "UNAUTHORIZED",
+    FORBIDDEN = "FORBIDDEN",
+    RATE_LIMITED = "RATE_LIMITED",
+    INVALID_VERSION = "INVALID_VERSION",
+    INVALID_NAMESPACE = "INVALID_NAMESPACE",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    TIMEOUT = "TIMEOUT",
+    SERVER_ERROR = "SERVER_ERROR",
+    INVALID_RESPONSE = "INVALID_RESPONSE",
+    UNKNOWN = "UNKNOWN"
+}
+/**
+ * Registry-specific error class
+ */
+export declare class RegistryError extends Error {
+    code: RegistryErrorCode;
+    statusCode?: number;
+    details?: any;
+    constructor(message: string, code: RegistryErrorCode, statusCode?: number, details?: any);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RegistryError = exports.RegistryErrorCode = void 0;
+/**
+ * Error codes for registry operations
+ */
+var RegistryErrorCode;
+(function (RegistryErrorCode) {
+    RegistryErrorCode["COMPONENT_NOT_FOUND"] = "COMPONENT_NOT_FOUND";
+    RegistryErrorCode["UNAUTHORIZED"] = "UNAUTHORIZED";
+    RegistryErrorCode["FORBIDDEN"] = "FORBIDDEN";
+    RegistryErrorCode["RATE_LIMITED"] = "RATE_LIMITED";
+    RegistryErrorCode["INVALID_VERSION"] = "INVALID_VERSION";
+    RegistryErrorCode["INVALID_NAMESPACE"] = "INVALID_NAMESPACE";
+    RegistryErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    RegistryErrorCode["TIMEOUT"] = "TIMEOUT";
+    RegistryErrorCode["SERVER_ERROR"] = "SERVER_ERROR";
+    RegistryErrorCode["INVALID_RESPONSE"] = "INVALID_RESPONSE";
+    RegistryErrorCode["UNKNOWN"] = "UNKNOWN";
+})(RegistryErrorCode || (exports.RegistryErrorCode = RegistryErrorCode = {}));
+/**
+ * Registry-specific error class
+ */
+class RegistryError extends Error {
+    constructor(message, code, statusCode, details) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.details = details;
+        this.name = 'RegistryError';
+    }
+}
+exports.RegistryError = RegistryError;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAiVA;;GAEG;AACH,IAAY,iBAYX;AAZD,WAAY,iBAAiB;IAC3B,gEAA2C,CAAA;IAC3C,kDAA6B,CAAA;IAC7B,4CAAuB,CAAA;IACvB,kDAA6B,CAAA;IAC7B,wDAAmC,CAAA;IACnC,4DAAuC,CAAA;IACvC,oDAA+B,CAAA;IAC/B,wCAAmB,CAAA;IACnB,kDAA6B,CAAA;IAC7B,0DAAqC,CAAA;IACrC,wCAAmB,CAAA;AACrB,CAAC,EAZW,iBAAiB,iCAAjB,iBAAiB,QAY5B;AAED;;GAEG;AACH,MAAa,aAAc,SAAQ,KAAK;IACtC,YACE,OAAe,EACR,IAAuB,EACvB,UAAmB,EACnB,OAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAJR,SAAI,GAAJ,IAAI,CAAmB;QACvB,eAAU,GAAV,UAAU,CAAS;QACnB,YAAO,GAAP,OAAO,CAAM;QAGpB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAVD,sCAUC"}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@memberjunction/component-registry-client-sdk",
+  "version": "2.100.0",
+  "description": "MemberJunction: Component Registry Client SDK",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "/dist"
+  ],
+  "scripts": {
+    "start": "ts-node-dev src/index.ts",
+    "build": "tsc",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "MemberJunction.com",
+  "license": "ISC",
+  "devDependencies": {
+    "ts-node-dev": "^2.0.0",
+    "typescript": "^5.4.5"
+  },
+  "dependencies": {
+    "@memberjunction/global": "2.100.0",
+    "@memberjunction/core": "2.100.0",
+    "@memberjunction/interactive-component-types": "2.100.0"
+  }
+}