@frontmcp/ui 0.5.0 → 0.6.0

package/src/bridge/adapters/openai.adapter.js

@@ -1,194 +0,0 @@
-"use strict";
-/**
- * OpenAI Platform Adapter
- *
- * Adapter for OpenAI's ChatGPT Apps SDK.
- * Provides full widget functionality including tool calls, messaging,
- * and display mode changes via the window.openai API.
- *
- * @packageDocumentation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.OpenAIAdapter = void 0;
-exports.createOpenAIAdapter = createOpenAIAdapter;
-const base_adapter_1 = require("./base-adapter");
-/**
- * OpenAI Apps SDK adapter.
- *
- * Detects the presence of `window.openai` and proxies all operations
- * through the ChatGPT Apps SDK.
- *
- * @example
- * ```typescript
- * import { OpenAIAdapter } from '@frontmcp/ui/bridge';
- *
- * const adapter = new OpenAIAdapter();
- * if (adapter.canHandle()) {
- *   await adapter.initialize();
- *   const theme = adapter.getTheme();
- * }
- * ```
- */
-class OpenAIAdapter extends base_adapter_1.BaseAdapter {
-    id = 'openai';
-    name = 'OpenAI ChatGPT';
-    priority = 100; // Highest priority
-    _openai;
-    _unsubscribeContext;
-    _unsubscribeToolResult;
-    constructor() {
-        super();
-        this._capabilities = {
-            ...base_adapter_1.DEFAULT_CAPABILITIES,
-            canCallTools: true,
-            canSendMessages: true,
-            canOpenLinks: true,
-            canPersistState: true,
-            hasNetworkAccess: true,
-            supportsDisplayModes: true,
-            supportsTheme: true,
-        };
-    }
-    /**
-     * Check if OpenAI Apps SDK is available.
-     */
-    canHandle() {
-        if (typeof window === 'undefined')
-            return false;
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const win = window;
-        return Boolean(win.openai?.canvas);
-    }
-    /**
-     * Initialize the OpenAI adapter.
-     */
-    async initialize() {
-        if (this._initialized)
-            return;
-        // Get OpenAI SDK reference
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        this._openai = window.openai;
-        // Call base initialization (loads widget state, reads injected data)
-        await super.initialize();
-        // Get initial context from OpenAI SDK
-        this._syncContextFromSDK();
-        // Subscribe to context changes
-        if (this._openai?.canvas?.onContextChange) {
-            this._unsubscribeContext = this._openai.canvas.onContextChange((changes) => {
-                this._notifyContextChange(changes);
-            });
-        }
-        // Subscribe to tool results if available
-        if (this._openai?.canvas?.onToolResult) {
-            this._unsubscribeToolResult = this._openai.canvas.onToolResult((result) => {
-                this._notifyToolResult(result);
-            });
-        }
-    }
-    /**
-     * Dispose adapter resources.
-     */
-    dispose() {
-        if (this._unsubscribeContext) {
-            this._unsubscribeContext();
-            this._unsubscribeContext = undefined;
-        }
-        if (this._unsubscribeToolResult) {
-            this._unsubscribeToolResult();
-            this._unsubscribeToolResult = undefined;
-        }
-        this._openai = undefined;
-        super.dispose();
-    }
-    // ============================================
-    // Data Access (override with SDK calls)
-    // ============================================
-    getTheme() {
-        if (this._openai?.canvas?.getTheme) {
-            const theme = this._openai.canvas.getTheme();
-            return theme === 'dark' ? 'dark' : 'light';
-        }
-        return super.getTheme();
-    }
-    getDisplayMode() {
-        if (this._openai?.canvas?.getDisplayMode) {
-            const mode = this._openai.canvas.getDisplayMode();
-            if (mode === 'fullscreen' || mode === 'pip' || mode === 'carousel') {
-                return mode;
-            }
-            return 'inline';
-        }
-        return super.getDisplayMode();
-    }
-    // ============================================
-    // Actions (proxy to SDK)
-    // ============================================
-    async callTool(name, args) {
-        if (!this._openai?.canvas?.callServerTool) {
-            throw new Error('callServerTool not available in OpenAI SDK');
-        }
-        return this._openai.canvas.callServerTool(name, args);
-    }
-    async sendMessage(content) {
-        if (!this._openai?.canvas?.sendMessage) {
-            throw new Error('sendMessage not available in OpenAI SDK');
-        }
-        await this._openai.canvas.sendMessage(content);
-    }
-    async openLink(url) {
-        if (!this._openai?.canvas?.openLink) {
-            // Fallback to window.open
-            return super.openLink(url);
-        }
-        await this._openai.canvas.openLink(url);
-    }
-    async requestDisplayMode(mode) {
-        if (!this._openai?.canvas?.setDisplayMode) {
-            return super.requestDisplayMode(mode);
-        }
-        await this._openai.canvas.setDisplayMode(mode);
-        this._hostContext = { ...this._hostContext, displayMode: mode };
-    }
-    async requestClose() {
-        if (this._openai?.canvas?.close) {
-            await this._openai.canvas.close();
-        }
-    }
-    // ============================================
-    // Private Helpers
-    // ============================================
-    /**
-     * Sync context from OpenAI SDK.
-     */
-    _syncContextFromSDK() {
-        if (!this._openai?.canvas)
-            return;
-        // Update theme
-        if (this._openai.canvas.getTheme) {
-            const theme = this._openai.canvas.getTheme();
-            this._hostContext.theme = theme === 'dark' ? 'dark' : 'light';
-        }
-        // Update display mode
-        if (this._openai.canvas.getDisplayMode) {
-            const mode = this._openai.canvas.getDisplayMode();
-            if (mode === 'fullscreen' || mode === 'pip' || mode === 'carousel' || mode === 'inline') {
-                this._hostContext.displayMode = mode;
-            }
-        }
-        // Get full context if available
-        if (this._openai.canvas.getContext) {
-            const ctx = this._openai.canvas.getContext();
-            if (ctx) {
-                this._hostContext = { ...this._hostContext, ...ctx };
-            }
-        }
-    }
-}
-exports.OpenAIAdapter = OpenAIAdapter;
-/**
- * Factory function for creating OpenAI adapter instances.
- */
-function createOpenAIAdapter() {
-    return new OpenAIAdapter();
-}
-//# sourceMappingURL=openai.adapter.js.map

package/src/bridge/adapters/openai.adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"openai.adapter.js","sourceRoot":"","sources":["../../../../src/bridge/adapters/openai.adapter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * OpenAI Platform Adapter\n *\n * Adapter for OpenAI's ChatGPT Apps SDK.\n * Provides full widget functionality including tool calls, messaging,\n * and display mode changes via the window.openai API.\n *\n * @packageDocumentation\n */\n\nimport type { DisplayMode, HostContext } from '../types';\nimport { BaseAdapter, DEFAULT_CAPABILITIES } from './base-adapter';\n\n/**\n * OpenAI SDK global interface (simplified type).\n */\ninterface OpenAISDK {\n  canvas?: {\n    getTheme(): string;\n    getDisplayMode(): string;\n    setDisplayMode(mode: string): Promise<void>;\n    sendMessage(text: string): Promise<void>;\n    openLink(url: string): Promise<void>;\n    callServerTool(name: string, args: Record<string, unknown>): Promise<unknown>;\n    onContextChange(callback: (context: Partial<HostContext>) => void): () => void;\n    onToolResult?(callback: (result: unknown) => void): () => void;\n    close(): Promise<void>;\n    getContext?(): Partial<HostContext>;\n  };\n}\n\n/**\n * OpenAI Apps SDK adapter.\n *\n * Detects the presence of `window.openai` and proxies all operations\n * through the ChatGPT Apps SDK.\n *\n * @example\n * ```typescript\n * import { OpenAIAdapter } from '@frontmcp/ui/bridge';\n *\n * const adapter = new OpenAIAdapter();\n * if (adapter.canHandle()) {\n *   await adapter.initialize();\n *   const theme = adapter.getTheme();\n * }\n * ```\n */\nexport class OpenAIAdapter extends BaseAdapter {\n  readonly id = 'openai';\n  readonly name = 'OpenAI ChatGPT';\n  readonly priority = 100; // Highest priority\n\n  private _openai: OpenAISDK | undefined;\n  private _unsubscribeContext: (() => void) | undefined;\n  private _unsubscribeToolResult: (() => void) | undefined;\n\n  constructor() {\n    super();\n    this._capabilities = {\n      ...DEFAULT_CAPABILITIES,\n      canCallTools: true,\n      canSendMessages: true,\n      canOpenLinks: true,\n      canPersistState: true,\n      hasNetworkAccess: true,\n      supportsDisplayModes: true,\n      supportsTheme: true,\n    };\n  }\n\n  /**\n   * Check if OpenAI Apps SDK is available.\n   */\n  canHandle(): boolean {\n    if (typeof window === 'undefined') return false;\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const win = window as any;\n    return Boolean(win.openai?.canvas);\n  }\n\n  /**\n   * Initialize the OpenAI adapter.\n   */\n  override async initialize(): Promise<void> {\n    if (this._initialized) return;\n\n    // Get OpenAI SDK reference\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    this._openai = (window as any).openai as OpenAISDK;\n\n    // Call base initialization (loads widget state, reads injected data)\n    await super.initialize();\n\n    // Get initial context from OpenAI SDK\n    this._syncContextFromSDK();\n\n    // Subscribe to context changes\n    if (this._openai?.canvas?.onContextChange) {\n      this._unsubscribeContext = this._openai.canvas.onContextChange((changes) => {\n        this._notifyContextChange(changes);\n      });\n    }\n\n    // Subscribe to tool results if available\n    if (this._openai?.canvas?.onToolResult) {\n      this._unsubscribeToolResult = this._openai.canvas.onToolResult((result) => {\n        this._notifyToolResult(result);\n      });\n    }\n  }\n\n  /**\n   * Dispose adapter resources.\n   */\n  override dispose(): void {\n    if (this._unsubscribeContext) {\n      this._unsubscribeContext();\n      this._unsubscribeContext = undefined;\n    }\n    if (this._unsubscribeToolResult) {\n      this._unsubscribeToolResult();\n      this._unsubscribeToolResult = undefined;\n    }\n    this._openai = undefined;\n    super.dispose();\n  }\n\n  // ============================================\n  // Data Access (override with SDK calls)\n  // ============================================\n\n  override getTheme(): 'light' | 'dark' {\n    if (this._openai?.canvas?.getTheme) {\n      const theme = this._openai.canvas.getTheme();\n      return theme === 'dark' ? 'dark' : 'light';\n    }\n    return super.getTheme();\n  }\n\n  override getDisplayMode(): DisplayMode {\n    if (this._openai?.canvas?.getDisplayMode) {\n      const mode = this._openai.canvas.getDisplayMode();\n      if (mode === 'fullscreen' || mode === 'pip' || mode === 'carousel') {\n        return mode;\n      }\n      return 'inline';\n    }\n    return super.getDisplayMode();\n  }\n\n  // ============================================\n  // Actions (proxy to SDK)\n  // ============================================\n\n  override async callTool(name: string, args: Record<string, unknown>): Promise<unknown> {\n    if (!this._openai?.canvas?.callServerTool) {\n      throw new Error('callServerTool not available in OpenAI SDK');\n    }\n    return this._openai.canvas.callServerTool(name, args);\n  }\n\n  override async sendMessage(content: string): Promise<void> {\n    if (!this._openai?.canvas?.sendMessage) {\n      throw new Error('sendMessage not available in OpenAI SDK');\n    }\n    await this._openai.canvas.sendMessage(content);\n  }\n\n  override async openLink(url: string): Promise<void> {\n    if (!this._openai?.canvas?.openLink) {\n      // Fallback to window.open\n      return super.openLink(url);\n    }\n    await this._openai.canvas.openLink(url);\n  }\n\n  override async requestDisplayMode(mode: DisplayMode): Promise<void> {\n    if (!this._openai?.canvas?.setDisplayMode) {\n      return super.requestDisplayMode(mode);\n    }\n    await this._openai.canvas.setDisplayMode(mode);\n    this._hostContext = { ...this._hostContext, displayMode: mode };\n  }\n\n  override async requestClose(): Promise<void> {\n    if (this._openai?.canvas?.close) {\n      await this._openai.canvas.close();\n    }\n  }\n\n  // ============================================\n  // Private Helpers\n  // ============================================\n\n  /**\n   * Sync context from OpenAI SDK.\n   */\n  private _syncContextFromSDK(): void {\n    if (!this._openai?.canvas) return;\n\n    // Update theme\n    if (this._openai.canvas.getTheme) {\n      const theme = this._openai.canvas.getTheme();\n      this._hostContext.theme = theme === 'dark' ? 'dark' : 'light';\n    }\n\n    // Update display mode\n    if (this._openai.canvas.getDisplayMode) {\n      const mode = this._openai.canvas.getDisplayMode();\n      if (mode === 'fullscreen' || mode === 'pip' || mode === 'carousel' || mode === 'inline') {\n        this._hostContext.displayMode = mode;\n      }\n    }\n\n    // Get full context if available\n    if (this._openai.canvas.getContext) {\n      const ctx = this._openai.canvas.getContext();\n      if (ctx) {\n        this._hostContext = { ...this._hostContext, ...ctx };\n      }\n    }\n  }\n}\n\n/**\n * Factory function for creating OpenAI adapter instances.\n */\nexport function createOpenAIAdapter(): OpenAIAdapter {\n  return new OpenAIAdapter();\n}\n"]}

package/src/bridge/core/adapter-registry.d.ts

@@ -1,121 +0,0 @@
-/**
- * Adapter Registry
- *
- * Manages platform adapter registration and auto-detection.
- * Adapters are registered with priorities and selected based on
- * environment detection during initialization.
- *
- * @packageDocumentation
- */
-import type { PlatformAdapter, AdapterFactory, AdapterConfig } from '../types';
-/**
- * Registry for managing platform adapters.
- * Handles registration, retrieval, and auto-detection of adapters.
- */
-export declare class AdapterRegistry {
-    private _adapters;
-    private _disabledAdapters;
-    private _adapterConfigs;
-    private _debug;
-    /**
-     * Enable or disable debug logging.
-     */
-    setDebug(enabled: boolean): void;
-    /**
-     * Register an adapter factory with the registry.
-     * @param id - Unique adapter identifier
-     * @param factory - Factory function that creates the adapter
-     * @param defaultConfig - Optional default configuration
-     */
-    register(id: string, factory: AdapterFactory, defaultConfig?: AdapterConfig): void;
-    /**
-     * Unregister an adapter from the registry.
-     * @param id - Adapter identifier to remove
-     */
-    unregister(id: string): boolean;
-    /**
-     * Check if an adapter is registered.
-     * @param id - Adapter identifier
-     */
-    has(id: string): boolean;
-    /**
-     * Get all registered adapter IDs.
-     */
-    getRegisteredIds(): string[];
-    /**
-     * Disable specific adapters (they won't be selected during auto-detection).
-     * @param ids - Adapter IDs to disable
-     */
-    disable(...ids: string[]): void;
-    /**
-     * Enable previously disabled adapters.
-     * @param ids - Adapter IDs to enable
-     */
-    enable(...ids: string[]): void;
-    /**
-     * Check if an adapter is disabled.
-     * @param id - Adapter identifier
-     */
-    isDisabled(id: string): boolean;
-    /**
-     * Set adapter-specific configuration.
-     * @param id - Adapter identifier
-     * @param config - Configuration to apply
-     */
-    configure(id: string, config: AdapterConfig): void;
-    /**
-     * Get an adapter instance by ID.
-     * @param id - Adapter identifier
-     * @returns Adapter instance or undefined if not found/disabled
-     */
-    get(id: string): PlatformAdapter | undefined;
-    /**
-     * Auto-detect and return the best adapter for the current environment.
-     * Adapters are checked in priority order (highest first).
-     * @returns The first adapter that can handle the current environment, or undefined
-     */
-    detect(): PlatformAdapter | undefined;
-    /**
-     * Get all adapters that can handle the current environment.
-     * Useful for debugging or showing available options.
-     * @returns Array of compatible adapters sorted by priority (highest first)
-     */
-    detectAll(): PlatformAdapter[];
-    /**
-     * Clear all registered adapters.
-     */
-    clear(): void;
-    /**
-     * Get sorted candidate adapters by priority (highest first).
-     */
-    private _getSortedCandidates;
-    /**
-     * Merge default config with user config.
-     */
-    private _mergeConfig;
-    /**
-     * Log debug message if debugging is enabled.
-     */
-    private _log;
-}
-/**
- * Default global adapter registry instance.
- * Use this for the standard registration pattern.
- */
-export declare const defaultRegistry: AdapterRegistry;
-/**
- * Helper function to register an adapter with the default registry.
- * @param id - Unique adapter identifier
- * @param factory - Factory function that creates the adapter
- * @param defaultConfig - Optional default configuration
- */
-export declare function registerAdapter(id: string, factory: AdapterFactory, defaultConfig?: AdapterConfig): void;
-/**
- * Helper function to get an adapter from the default registry.
- * @param id - Adapter identifier
- */
-export declare function getAdapter(id: string): PlatformAdapter | undefined;
-/**
- * Helper function to auto-detect the best adapter from the default registry.
- */
-export declare function detectAdapter(): PlatformAdapter | undefined;

package/src/bridge/core/adapter-registry.js

@@ -1,271 +0,0 @@
-"use strict";
-/**
- * Adapter Registry
- *
- * Manages platform adapter registration and auto-detection.
- * Adapters are registered with priorities and selected based on
- * environment detection during initialization.
- *
- * @packageDocumentation
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultRegistry = exports.AdapterRegistry = void 0;
-exports.registerAdapter = registerAdapter;
-exports.getAdapter = getAdapter;
-exports.detectAdapter = detectAdapter;
-/**
- * Registry for managing platform adapters.
- * Handles registration, retrieval, and auto-detection of adapters.
- */
-class AdapterRegistry {
-    _adapters = new Map();
-    _disabledAdapters = new Set();
-    _adapterConfigs = new Map();
-    _debug = false;
-    /**
-     * Enable or disable debug logging.
-     */
-    setDebug(enabled) {
-        this._debug = enabled;
-    }
-    /**
-     * Register an adapter factory with the registry.
-     * @param id - Unique adapter identifier
-     * @param factory - Factory function that creates the adapter
-     * @param defaultConfig - Optional default configuration
-     */
-    register(id, factory, defaultConfig) {
-        if (this._adapters.has(id)) {
-            this._log(`Overwriting existing adapter: ${id}`);
-        }
-        this._adapters.set(id, {
-            id,
-            factory,
-            defaultConfig,
-        });
-        this._log(`Registered adapter: ${id}`);
-    }
-    /**
-     * Unregister an adapter from the registry.
-     * @param id - Adapter identifier to remove
-     */
-    unregister(id) {
-        const removed = this._adapters.delete(id);
-        if (removed) {
-            this._log(`Unregistered adapter: ${id}`);
-        }
-        return removed;
-    }
-    /**
-     * Check if an adapter is registered.
-     * @param id - Adapter identifier
-     */
-    has(id) {
-        return this._adapters.has(id);
-    }
-    /**
-     * Get all registered adapter IDs.
-     */
-    getRegisteredIds() {
-        return Array.from(this._adapters.keys());
-    }
-    /**
-     * Disable specific adapters (they won't be selected during auto-detection).
-     * @param ids - Adapter IDs to disable
-     */
-    disable(...ids) {
-        for (const id of ids) {
-            this._disabledAdapters.add(id);
-            this._log(`Disabled adapter: ${id}`);
-        }
-    }
-    /**
-     * Enable previously disabled adapters.
-     * @param ids - Adapter IDs to enable
-     */
-    enable(...ids) {
-        for (const id of ids) {
-            this._disabledAdapters.delete(id);
-            this._log(`Enabled adapter: ${id}`);
-        }
-    }
-    /**
-     * Check if an adapter is disabled.
-     * @param id - Adapter identifier
-     */
-    isDisabled(id) {
-        return this._disabledAdapters.has(id);
-    }
-    /**
-     * Set adapter-specific configuration.
-     * @param id - Adapter identifier
-     * @param config - Configuration to apply
-     */
-    configure(id, config) {
-        this._adapterConfigs.set(id, config);
-        this._log(`Configured adapter: ${id}`);
-    }
-    /**
-     * Get an adapter instance by ID.
-     * @param id - Adapter identifier
-     * @returns Adapter instance or undefined if not found/disabled
-     */
-    get(id) {
-        if (this._disabledAdapters.has(id)) {
-            this._log(`Adapter ${id} is disabled`);
-            return undefined;
-        }
-        const registration = this._adapters.get(id);
-        if (!registration) {
-            this._log(`Adapter ${id} not found`);
-            return undefined;
-        }
-        const config = this._mergeConfig(registration.defaultConfig, this._adapterConfigs.get(id));
-        if (config?.enabled === false) {
-            this._log(`Adapter ${id} is disabled via config`);
-            return undefined;
-        }
-        return registration.factory(config);
-    }
-    /**
-     * Auto-detect and return the best adapter for the current environment.
-     * Adapters are checked in priority order (highest first).
-     * @returns The first adapter that can handle the current environment, or undefined
-     */
-    detect() {
-        const candidates = this._getSortedCandidates();
-        for (const registration of candidates) {
-            if (this._disabledAdapters.has(registration.id)) {
-                this._log(`Skipping disabled adapter: ${registration.id}`);
-                continue;
-            }
-            const config = this._mergeConfig(registration.defaultConfig, this._adapterConfigs.get(registration.id));
-            if (config?.enabled === false) {
-                this._log(`Skipping adapter disabled via config: ${registration.id}`);
-                continue;
-            }
-            try {
-                const adapter = registration.factory(config);
-                if (adapter.canHandle()) {
-                    this._log(`Detected adapter: ${registration.id} (priority: ${adapter.priority})`);
-                    return adapter;
-                }
-                this._log(`Adapter ${registration.id} cannot handle current environment`);
-            }
-            catch (error) {
-                this._log(`Error creating adapter ${registration.id}: ${error}`);
-            }
-        }
-        this._log('No suitable adapter detected');
-        return undefined;
-    }
-    /**
-     * Get all adapters that can handle the current environment.
-     * Useful for debugging or showing available options.
-     * @returns Array of compatible adapters sorted by priority (highest first)
-     */
-    detectAll() {
-        const candidates = this._getSortedCandidates();
-        const compatible = [];
-        for (const registration of candidates) {
-            if (this._disabledAdapters.has(registration.id)) {
-                continue;
-            }
-            const config = this._mergeConfig(registration.defaultConfig, this._adapterConfigs.get(registration.id));
-            if (config?.enabled === false) {
-                continue;
-            }
-            try {
-                const adapter = registration.factory(config);
-                if (adapter.canHandle()) {
-                    compatible.push(adapter);
-                }
-            }
-            catch {
-                // Skip adapters that fail to instantiate
-            }
-        }
-        return compatible;
-    }
-    /**
-     * Clear all registered adapters.
-     */
-    clear() {
-        this._adapters.clear();
-        this._disabledAdapters.clear();
-        this._adapterConfigs.clear();
-        this._log('Cleared all adapters');
-    }
-    /**
-     * Get sorted candidate adapters by priority (highest first).
-     */
-    _getSortedCandidates() {
-        const registrations = Array.from(this._adapters.values());
-        // Create temporary adapters to get their priorities
-        const withPriority = registrations.map((reg) => {
-            try {
-                const adapter = reg.factory(reg.defaultConfig);
-                return { registration: reg, priority: adapter.priority };
-            }
-            catch {
-                return { registration: reg, priority: -1 };
-            }
-        });
-        // Sort by priority descending
-        withPriority.sort((a, b) => b.priority - a.priority);
-        return withPriority.map((item) => item.registration);
-    }
-    /**
-     * Merge default config with user config.
-     */
-    _mergeConfig(defaultConfig, userConfig) {
-        if (!defaultConfig && !userConfig) {
-            return undefined;
-        }
-        return {
-            ...defaultConfig,
-            ...userConfig,
-            options: {
-                ...defaultConfig?.options,
-                ...userConfig?.options,
-            },
-        };
-    }
-    /**
-     * Log debug message if debugging is enabled.
-     */
-    _log(message) {
-        if (this._debug) {
-            console.log(`[AdapterRegistry] ${message}`);
-        }
-    }
-}
-exports.AdapterRegistry = AdapterRegistry;
-/**
- * Default global adapter registry instance.
- * Use this for the standard registration pattern.
- */
-exports.defaultRegistry = new AdapterRegistry();
-/**
- * Helper function to register an adapter with the default registry.
- * @param id - Unique adapter identifier
- * @param factory - Factory function that creates the adapter
- * @param defaultConfig - Optional default configuration
- */
-function registerAdapter(id, factory, defaultConfig) {
-    exports.defaultRegistry.register(id, factory, defaultConfig);
-}
-/**
- * Helper function to get an adapter from the default registry.
- * @param id - Adapter identifier
- */
-function getAdapter(id) {
-    return exports.defaultRegistry.get(id);
-}
-/**
- * Helper function to auto-detect the best adapter from the default registry.
- */
-function detectAdapter() {
-    return exports.defaultRegistry.detect();
-}
-//# sourceMappingURL=adapter-registry.js.map

package/src/bridge/core/adapter-registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter-registry.js","sourceRoot":"","sources":["../../../../src/bridge/core/adapter-registry.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Adapter Registry\n *\n * Manages platform adapter registration and auto-detection.\n * Adapters are registered with priorities and selected based on\n * environment detection during initialization.\n *\n * @packageDocumentation\n */\n\nimport type { PlatformAdapter, AdapterFactory, AdapterRegistration, AdapterConfig } from '../types';\n\n/**\n * Registry for managing platform adapters.\n * Handles registration, retrieval, and auto-detection of adapters.\n */\nexport class AdapterRegistry {\n  private _adapters: Map<string, AdapterRegistration> = new Map();\n  private _disabledAdapters: Set<string> = new Set();\n  private _adapterConfigs: Map<string, AdapterConfig> = new Map();\n  private _debug = false;\n\n  /**\n   * Enable or disable debug logging.\n   */\n  setDebug(enabled: boolean): void {\n    this._debug = enabled;\n  }\n\n  /**\n   * Register an adapter factory with the registry.\n   * @param id - Unique adapter identifier\n   * @param factory - Factory function that creates the adapter\n   * @param defaultConfig - Optional default configuration\n   */\n  register(id: string, factory: AdapterFactory, defaultConfig?: AdapterConfig): void {\n    if (this._adapters.has(id)) {\n      this._log(`Overwriting existing adapter: ${id}`);\n    }\n\n    this._adapters.set(id, {\n      id,\n      factory,\n      defaultConfig,\n    });\n\n    this._log(`Registered adapter: ${id}`);\n  }\n\n  /**\n   * Unregister an adapter from the registry.\n   * @param id - Adapter identifier to remove\n   */\n  unregister(id: string): boolean {\n    const removed = this._adapters.delete(id);\n    if (removed) {\n      this._log(`Unregistered adapter: ${id}`);\n    }\n    return removed;\n  }\n\n  /**\n   * Check if an adapter is registered.\n   * @param id - Adapter identifier\n   */\n  has(id: string): boolean {\n    return this._adapters.has(id);\n  }\n\n  /**\n   * Get all registered adapter IDs.\n   */\n  getRegisteredIds(): string[] {\n    return Array.from(this._adapters.keys());\n  }\n\n  /**\n   * Disable specific adapters (they won't be selected during auto-detection).\n   * @param ids - Adapter IDs to disable\n   */\n  disable(...ids: string[]): void {\n    for (const id of ids) {\n      this._disabledAdapters.add(id);\n      this._log(`Disabled adapter: ${id}`);\n    }\n  }\n\n  /**\n   * Enable previously disabled adapters.\n   * @param ids - Adapter IDs to enable\n   */\n  enable(...ids: string[]): void {\n    for (const id of ids) {\n      this._disabledAdapters.delete(id);\n      this._log(`Enabled adapter: ${id}`);\n    }\n  }\n\n  /**\n   * Check if an adapter is disabled.\n   * @param id - Adapter identifier\n   */\n  isDisabled(id: string): boolean {\n    return this._disabledAdapters.has(id);\n  }\n\n  /**\n   * Set adapter-specific configuration.\n   * @param id - Adapter identifier\n   * @param config - Configuration to apply\n   */\n  configure(id: string, config: AdapterConfig): void {\n    this._adapterConfigs.set(id, config);\n    this._log(`Configured adapter: ${id}`);\n  }\n\n  /**\n   * Get an adapter instance by ID.\n   * @param id - Adapter identifier\n   * @returns Adapter instance or undefined if not found/disabled\n   */\n  get(id: string): PlatformAdapter | undefined {\n    if (this._disabledAdapters.has(id)) {\n      this._log(`Adapter ${id} is disabled`);\n      return undefined;\n    }\n\n    const registration = this._adapters.get(id);\n    if (!registration) {\n      this._log(`Adapter ${id} not found`);\n      return undefined;\n    }\n\n    const config = this._mergeConfig(registration.defaultConfig, this._adapterConfigs.get(id));\n\n    if (config?.enabled === false) {\n      this._log(`Adapter ${id} is disabled via config`);\n      return undefined;\n    }\n\n    return registration.factory(config);\n  }\n\n  /**\n   * Auto-detect and return the best adapter for the current environment.\n   * Adapters are checked in priority order (highest first).\n   * @returns The first adapter that can handle the current environment, or undefined\n   */\n  detect(): PlatformAdapter | undefined {\n    const candidates = this._getSortedCandidates();\n\n    for (const registration of candidates) {\n      if (this._disabledAdapters.has(registration.id)) {\n        this._log(`Skipping disabled adapter: ${registration.id}`);\n        continue;\n      }\n\n      const config = this._mergeConfig(registration.defaultConfig, this._adapterConfigs.get(registration.id));\n\n      if (config?.enabled === false) {\n        this._log(`Skipping adapter disabled via config: ${registration.id}`);\n        continue;\n      }\n\n      try {\n        const adapter = registration.factory(config);\n\n        if (adapter.canHandle()) {\n          this._log(`Detected adapter: ${registration.id} (priority: ${adapter.priority})`);\n          return adapter;\n        }\n\n        this._log(`Adapter ${registration.id} cannot handle current environment`);\n      } catch (error) {\n        this._log(`Error creating adapter ${registration.id}: ${error}`);\n      }\n    }\n\n    this._log('No suitable adapter detected');\n    return undefined;\n  }\n\n  /**\n   * Get all adapters that can handle the current environment.\n   * Useful for debugging or showing available options.\n   * @returns Array of compatible adapters sorted by priority (highest first)\n   */\n  detectAll(): PlatformAdapter[] {\n    const candidates = this._getSortedCandidates();\n    const compatible: PlatformAdapter[] = [];\n\n    for (const registration of candidates) {\n      if (this._disabledAdapters.has(registration.id)) {\n        continue;\n      }\n\n      const config = this._mergeConfig(registration.defaultConfig, this._adapterConfigs.get(registration.id));\n\n      if (config?.enabled === false) {\n        continue;\n      }\n\n      try {\n        const adapter = registration.factory(config);\n\n        if (adapter.canHandle()) {\n          compatible.push(adapter);\n        }\n      } catch {\n        // Skip adapters that fail to instantiate\n      }\n    }\n\n    return compatible;\n  }\n\n  /**\n   * Clear all registered adapters.\n   */\n  clear(): void {\n    this._adapters.clear();\n    this._disabledAdapters.clear();\n    this._adapterConfigs.clear();\n    this._log('Cleared all adapters');\n  }\n\n  /**\n   * Get sorted candidate adapters by priority (highest first).\n   */\n  private _getSortedCandidates(): AdapterRegistration[] {\n    const registrations = Array.from(this._adapters.values());\n\n    // Create temporary adapters to get their priorities\n    const withPriority = registrations.map((reg) => {\n      try {\n        const adapter = reg.factory(reg.defaultConfig);\n        return { registration: reg, priority: adapter.priority };\n      } catch {\n        return { registration: reg, priority: -1 };\n      }\n    });\n\n    // Sort by priority descending\n    withPriority.sort((a, b) => b.priority - a.priority);\n\n    return withPriority.map((item) => item.registration);\n  }\n\n  /**\n   * Merge default config with user config.\n   */\n  private _mergeConfig(defaultConfig?: AdapterConfig, userConfig?: AdapterConfig): AdapterConfig | undefined {\n    if (!defaultConfig && !userConfig) {\n      return undefined;\n    }\n\n    return {\n      ...defaultConfig,\n      ...userConfig,\n      options: {\n        ...defaultConfig?.options,\n        ...userConfig?.options,\n      },\n    };\n  }\n\n  /**\n   * Log debug message if debugging is enabled.\n   */\n  private _log(message: string): void {\n    if (this._debug) {\n      console.log(`[AdapterRegistry] ${message}`);\n    }\n  }\n}\n\n/**\n * Default global adapter registry instance.\n * Use this for the standard registration pattern.\n */\nexport const defaultRegistry = new AdapterRegistry();\n\n/**\n * Helper function to register an adapter with the default registry.\n * @param id - Unique adapter identifier\n * @param factory - Factory function that creates the adapter\n * @param defaultConfig - Optional default configuration\n */\nexport function registerAdapter(id: string, factory: AdapterFactory, defaultConfig?: AdapterConfig): void {\n  defaultRegistry.register(id, factory, defaultConfig);\n}\n\n/**\n * Helper function to get an adapter from the default registry.\n * @param id - Adapter identifier\n */\nexport function getAdapter(id: string): PlatformAdapter | undefined {\n  return defaultRegistry.get(id);\n}\n\n/**\n * Helper function to auto-detect the best adapter from the default registry.\n */\nexport function detectAdapter(): PlatformAdapter | undefined {\n  return defaultRegistry.detect();\n}\n"]}