@eigenpal/docx-js-editor 0.0.20 → 0.0.21

package/dist/chunk-2QOEHCBX.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../core/src/core-plugins/registry.ts"],"names":["PluginRegistry","__publicField","plugin","options","warnings","depId","commandType","handler","existing","result","err","pluginId","id","p","pid","tools","toolName","tool","t","listener","event","pluginRegistry","registerPlugins","plugins","createPluginRegistrar"],"mappings":"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","file":"chunk-2QOEHCBX.js","sourcesContent":["/**\n * Plugin Registry\n *\n * Central registry for core plugins. Manages plugin lifecycle,\n * collects command handlers from all plugins, and aggregates\n * MCP tool definitions for the MCP server.\n */\n\nimport type {\n  CorePlugin,\n  CommandHandler,\n  McpToolDefinition,\n  PluginEvent,\n  PluginEventListener,\n  PluginRegistrationResult,\n  PluginOptions,\n} from './types';\n\n// ============================================================================\n// PLUGIN REGISTRY\n// ============================================================================\n\n/**\n * Plugin Registry - manages core plugins\n *\n * @example\n * ```ts\n * import { pluginRegistry, docxtemplaterPlugin } from '@eigenpal/docx-editor/core-plugins';\n *\n * // Register plugins\n * pluginRegistry.register(docxtemplaterPlugin);\n *\n * // Get all MCP tools for MCP server\n * const tools = pluginRegistry.getMcpTools();\n *\n * // Get command handler for executor\n * const handler = pluginRegistry.getCommandHandler('insertTemplateVariable');\n * ```\n */\nexport class PluginRegistry {\n  private plugins: Map<string, CorePlugin> = new Map();\n  private commandHandlers: Map<string, { pluginId: string; handler: CommandHandler }> = new Map();\n  private eventListeners: Set<PluginEventListener> = new Set();\n  private initialized: Set<string> = new Set();\n\n  // ==========================================================================\n  // REGISTRATION\n  // ==========================================================================\n\n  /**\n   * Register a plugin\n   *\n   * @param plugin - The plugin to register\n   * @param options - Optional configuration\n   * @returns Registration result\n   */\n  register(plugin: CorePlugin, options?: PluginOptions): PluginRegistrationResult {\n    const warnings: string[] = [];\n\n    // Validate plugin\n    if (!plugin.id) {\n      return { success: false, error: 'Plugin must have an id' };\n    }\n\n    if (this.plugins.has(plugin.id)) {\n      return { success: false, error: `Plugin '${plugin.id}' is already registered` };\n    }\n\n    // Check dependencies\n    if (plugin.dependencies) {\n      for (const depId of plugin.dependencies) {\n        if (!this.plugins.has(depId)) {\n          return {\n            success: false,\n            error: `Plugin '${plugin.id}' requires '${depId}' which is not registered`,\n          };\n        }\n      }\n    }\n\n    // Register command handlers\n    if (plugin.commandHandlers) {\n      for (const [commandType, handler] of Object.entries(plugin.commandHandlers)) {\n        if (this.commandHandlers.has(commandType)) {\n          const existing = this.commandHandlers.get(commandType)!;\n          warnings.push(\n            `Command '${commandType}' from '${plugin.id}' overrides handler from '${existing.pluginId}'`\n          );\n        }\n        this.commandHandlers.set(commandType, { pluginId: plugin.id, handler });\n      }\n    }\n\n    // Store plugin\n    this.plugins.set(plugin.id, plugin);\n\n    // Initialize if needed\n    if (plugin.initialize && !this.initialized.has(plugin.id)) {\n      try {\n        const result = plugin.initialize();\n        if (result instanceof Promise) {\n          // Handle async initialization\n          result\n            .then(() => {\n              this.initialized.add(plugin.id);\n            })\n            .catch((err) => {\n              this.emit({ type: 'error', pluginId: plugin.id, error: err as Error });\n            });\n        } else {\n          this.initialized.add(plugin.id);\n        }\n      } catch (err) {\n        this.emit({ type: 'error', pluginId: plugin.id, error: err as Error });\n      }\n    }\n\n    // Log if debug enabled\n    if (options?.debug) {\n      console.log(`[PluginRegistry] Registered plugin: ${plugin.id}`);\n    }\n\n    // Emit event\n    this.emit({ type: 'registered', plugin });\n\n    return {\n      success: true,\n      plugin,\n      warnings: warnings.length > 0 ? warnings : undefined,\n    };\n  }\n\n  /**\n   * Unregister a plugin\n   *\n   * @param pluginId - ID of the plugin to unregister\n   * @returns Whether unregistration succeeded\n   */\n  unregister(pluginId: string): boolean {\n    const plugin = this.plugins.get(pluginId);\n    if (!plugin) {\n      return false;\n    }\n\n    // Check if other plugins depend on this one\n    for (const [id, p] of this.plugins) {\n      if (p.dependencies?.includes(pluginId)) {\n        console.warn(`Cannot unregister '${pluginId}': '${id}' depends on it`);\n        return false;\n      }\n    }\n\n    // Remove command handlers\n    for (const [commandType, { pluginId: pid }] of this.commandHandlers) {\n      if (pid === pluginId) {\n        this.commandHandlers.delete(commandType);\n      }\n    }\n\n    // Call destroy if available\n    if (plugin.destroy) {\n      try {\n        const result = plugin.destroy();\n        if (result instanceof Promise) {\n          result.catch((err) => {\n            this.emit({ type: 'error', pluginId, error: err as Error });\n          });\n        }\n      } catch (err) {\n        this.emit({ type: 'error', pluginId, error: err as Error });\n      }\n    }\n\n    // Remove plugin\n    this.plugins.delete(pluginId);\n    this.initialized.delete(pluginId);\n\n    // Emit event\n    this.emit({ type: 'unregistered', pluginId });\n\n    return true;\n  }\n\n  // ==========================================================================\n  // QUERIES\n  // ==========================================================================\n\n  /**\n   * Get a registered plugin by ID\n   *\n   * @param id - Plugin ID\n   * @returns The plugin or undefined\n   */\n  get(id: string): CorePlugin | undefined {\n    return this.plugins.get(id);\n  }\n\n  /**\n   * Get all registered plugins\n   *\n   * @returns Array of all plugins\n   */\n  getAll(): CorePlugin[] {\n    return Array.from(this.plugins.values());\n  }\n\n  /**\n   * Check if a plugin is registered\n   *\n   * @param id - Plugin ID\n   * @returns Whether the plugin is registered\n   */\n  has(id: string): boolean {\n    return this.plugins.has(id);\n  }\n\n  /**\n   * Get number of registered plugins\n   */\n  get size(): number {\n    return this.plugins.size;\n  }\n\n  // ==========================================================================\n  // COMMAND HANDLERS\n  // ==========================================================================\n\n  /**\n   * Get a command handler for a command type\n   *\n   * @param commandType - The command type\n   * @returns The handler or undefined\n   */\n  getCommandHandler(commandType: string): CommandHandler | undefined {\n    const entry = this.commandHandlers.get(commandType);\n    return entry?.handler;\n  }\n\n  /**\n   * Get all registered command types\n   *\n   * @returns Array of command type strings\n   */\n  getCommandTypes(): string[] {\n    return Array.from(this.commandHandlers.keys());\n  }\n\n  /**\n   * Check if a command type has a handler\n   *\n   * @param commandType - The command type\n   * @returns Whether a handler exists\n   */\n  hasCommandHandler(commandType: string): boolean {\n    return this.commandHandlers.has(commandType);\n  }\n\n  // ==========================================================================\n  // MCP TOOLS\n  // ==========================================================================\n\n  /**\n   * Get all MCP tools from all registered plugins\n   *\n   * @returns Array of MCP tool definitions\n   */\n  getMcpTools(): McpToolDefinition[] {\n    const tools: McpToolDefinition[] = [];\n\n    for (const plugin of this.plugins.values()) {\n      if (plugin.mcpTools) {\n        tools.push(...plugin.mcpTools);\n      }\n    }\n\n    return tools;\n  }\n\n  /**\n   * Get MCP tools from a specific plugin\n   *\n   * @param pluginId - Plugin ID\n   * @returns Array of MCP tool definitions\n   */\n  getMcpToolsForPlugin(pluginId: string): McpToolDefinition[] {\n    const plugin = this.plugins.get(pluginId);\n    return plugin?.mcpTools || [];\n  }\n\n  /**\n   * Get an MCP tool by name\n   *\n   * @param toolName - Tool name\n   * @returns The tool definition or undefined\n   */\n  getMcpTool(toolName: string): McpToolDefinition | undefined {\n    for (const plugin of this.plugins.values()) {\n      if (plugin.mcpTools) {\n        const tool = plugin.mcpTools.find((t) => t.name === toolName);\n        if (tool) return tool;\n      }\n    }\n    return undefined;\n  }\n\n  // ==========================================================================\n  // EVENTS\n  // ==========================================================================\n\n  /**\n   * Add an event listener\n   *\n   * @param listener - Event listener function\n   */\n  addEventListener(listener: PluginEventListener): void {\n    this.eventListeners.add(listener);\n  }\n\n  /**\n   * Remove an event listener\n   *\n   * @param listener - Event listener function\n   */\n  removeEventListener(listener: PluginEventListener): void {\n    this.eventListeners.delete(listener);\n  }\n\n  /**\n   * Emit an event to all listeners\n   */\n  private emit(event: PluginEvent): void {\n    for (const listener of this.eventListeners) {\n      try {\n        listener(event);\n      } catch (err) {\n        console.error('[PluginRegistry] Event listener error:', err);\n      }\n    }\n  }\n\n  // ==========================================================================\n  // UTILITIES\n  // ==========================================================================\n\n  /**\n   * Clear all registered plugins\n   *\n   * Useful for testing or resetting state.\n   */\n  clear(): void {\n    // Call destroy on all plugins\n    for (const plugin of this.plugins.values()) {\n      if (plugin.destroy) {\n        try {\n          plugin.destroy();\n        } catch {\n          // Ignore errors during clear\n        }\n      }\n    }\n\n    this.plugins.clear();\n    this.commandHandlers.clear();\n    this.initialized.clear();\n  }\n\n  /**\n   * Get registry state for debugging\n   */\n  getDebugInfo(): {\n    plugins: string[];\n    commandTypes: string[];\n    mcpTools: string[];\n    initialized: string[];\n  } {\n    return {\n      plugins: Array.from(this.plugins.keys()),\n      commandTypes: Array.from(this.commandHandlers.keys()),\n      mcpTools: this.getMcpTools().map((t) => t.name),\n      initialized: Array.from(this.initialized),\n    };\n  }\n}\n\n// ============================================================================\n// GLOBAL INSTANCE\n// ============================================================================\n\n/**\n * Global plugin registry instance\n *\n * Use this for registering plugins and accessing their capabilities.\n */\nexport const pluginRegistry = new PluginRegistry();\n\n// ============================================================================\n// HELPER FUNCTIONS\n// ============================================================================\n\n/**\n * Register multiple plugins at once\n *\n * @param plugins - Array of plugins to register\n * @returns Array of registration results\n */\nexport function registerPlugins(\n  plugins: CorePlugin[],\n  options?: PluginOptions\n): PluginRegistrationResult[] {\n  return plugins.map((plugin) => pluginRegistry.register(plugin, options));\n}\n\n/**\n * Create a plugin registration helper with options pre-configured\n *\n * @param options - Default options for plugin registration\n * @returns Registration function\n */\nexport function createPluginRegistrar(options: PluginOptions) {\n  return (plugin: CorePlugin) => pluginRegistry.register(plugin, options);\n}\n"]}