@mediaproc/cli 0.8.4 → 1.0.0

package/dist/utils/plugins/manager.d.ts

@@ -0,0 +1,88 @@
+import { Command } from 'commander';
+import type { MediaProcPlugin } from '../../types.js';
+import { PluginType, PluginStatus, type PluginLoadResult } from './api.js';
+/**
+ * Enhanced Plugin Manager with concurrent loading protection and better error handling
+ */
+export declare class PluginManager {
+    private plugins;
+    private loadingPlugins;
+    private failedPlugins;
+    private readonly pluginPrefix;
+    private readonly officialPlugins;
+    /**
+     * Check if a plugin is official (@mediaproc/* package)
+     */
+    isOfficialPlugin(pluginName: string): boolean;
+    /**
+     * Get the plugin prefix
+     */
+    getPluginPrefix(): string;
+    /**
+     * Get plugin type
+     */
+    getPluginType(pluginName: string): PluginType;
+    /**
+     * Get plugin status
+     */
+    getPluginStatus(pluginName: string): PluginStatus;
+    /**
+     * Load a specific plugin and register its commands
+     */
+    loadPlugin(pluginName: string, program: Command, isBuiltIn?: boolean): Promise<boolean>;
+    /**
+     * Load multiple plugins concurrently (with error tolerance)
+     */
+    loadPlugins(pluginNames: string[], program: Command, options?: {
+        throwOnError?: boolean;
+    }): Promise<PluginLoadResult[]>;
+    /**
+     * Get list of loaded plugins (currently in memory)
+     */
+    getLoadedPlugins(): string[];
+    /**
+     * Get official plugins list
+     */
+    getOfficialPlugins(): string[];
+    /**
+     * Get plugin instance
+     */
+    getPlugin(pluginName: string): MediaProcPlugin | undefined;
+    /**
+     * Get all plugin instances
+     */
+    getAllPlugins(): Map<string, MediaProcPlugin>;
+    /**
+     * Get failed plugins with error messages
+     */
+    getFailedPlugins(): Map<string, string>;
+    /**
+     * Unload a plugin (remove from registry)
+     * Properly cleans up all references to prevent memory leaks
+     */
+    unloadPlugin(pluginName: string): boolean;
+    /**
+     * Reload a plugin (unload then load again)
+     * Useful after updating a plugin to refresh its code
+     */
+    reloadPlugin(pluginName: string, program: Command): Promise<boolean>;
+    /**
+     * Check if any plugins are currently loading
+     */
+    hasLoadingPlugins(): boolean;
+    /**
+     * Get count of loaded plugins
+     */
+    getLoadedCount(): number;
+    /**
+     * Clear all plugins (useful for testing)
+     */
+    clear(): void;
+}
+export declare const pluginManager: PluginManager;
+/**
+ * Get the plugin name for a given command name.
+ * Checks loaded plugins for a command match, otherwise returns 'core'.
+ */
+export declare function getPluginNameForCommand(commandName: string): string;
+//# sourceMappingURL=manager.d.ts.map

package/dist/utils/plugins/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/utils/plugins/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE3E;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiB;IAG9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAW9B;IAEF;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAI7C;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU;IAU7C;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY;IAajD;;OAEG;IACG,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAqD3F;;OAEG;IACG,WAAW,CACf,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAO,GACvC,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAyB9B;;OAEG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI1D;;OAEG;IACH,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;IAI7C;;OAEG;IACH,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIvC;;;OAGG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAwBzC;;;OAGG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAyB1E;;OAEG;IACH,iBAAiB,IAAI,OAAO;IAI5B;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAwBnE"}

package/dist/utils/plugins/manager.js

@@ -0,0 +1,267 @@
+import { PluginType, PluginStatus } from './api.js';
+/**
+ * Enhanced Plugin Manager with concurrent loading protection and better error handling
+ */
+export class PluginManager {
+    plugins = new Map();
+    loadingPlugins = new Set();
+    failedPlugins = new Map();
+    pluginPrefix = '@mediaproc/';
+    // Official plugins (recommended, but installed on-demand)
+    officialPlugins = [
+        '@mediaproc/image',
+        '@mediaproc/video',
+        '@mediaproc/audio',
+        '@mediaproc/document',
+        '@mediaproc/animation',
+        '@mediaproc/3d',
+        '@mediaproc/stream',
+        '@mediaproc/ai',
+        '@mediaproc/metadata',
+        '@mediaproc/pipeline',
+    ];
+    /**
+     * Check if a plugin is official (@mediaproc/* package)
+     */
+    isOfficialPlugin(pluginName) {
+        return this.officialPlugins.includes(pluginName) || pluginName.startsWith(this.pluginPrefix);
+    }
+    /**
+     * Get the plugin prefix
+     */
+    getPluginPrefix() {
+        return this.pluginPrefix;
+    }
+    /**
+     * Get plugin type
+     */
+    getPluginType(pluginName) {
+        if (pluginName.startsWith('@mediaproc/')) {
+            return PluginType.OFFICIAL;
+        }
+        if (pluginName.startsWith('mediaproc-')) {
+            return PluginType.COMMUNITY;
+        }
+        return PluginType.THIRD_PARTY;
+    }
+    /**
+     * Get plugin status
+     */
+    getPluginStatus(pluginName) {
+        if (this.plugins.has(pluginName)) {
+            return PluginStatus.LOADED;
+        }
+        if (this.loadingPlugins.has(pluginName)) {
+            return PluginStatus.LOADING;
+        }
+        if (this.failedPlugins.has(pluginName)) {
+            return PluginStatus.ERROR;
+        }
+        return PluginStatus.NOT_INSTALLED;
+    }
+    /**
+     * Load a specific plugin and register its commands
+     */
+    async loadPlugin(pluginName, program, isBuiltIn = false) {
+        // Skip if already loaded
+        if (this.plugins.has(pluginName)) {
+            return true;
+        }
+        // Prevent concurrent loading of same plugin
+        if (this.loadingPlugins.has(pluginName)) {
+            throw new Error(`Plugin ${pluginName} is already being loaded`);
+        }
+        // Clear any previous failure state
+        this.failedPlugins.delete(pluginName);
+        this.loadingPlugins.add(pluginName);
+        try {
+            // Dynamic import of the plugin
+            const plugin = await import(pluginName);
+            // Validate plugin structure
+            if (!plugin.name || !plugin.version) {
+                this.loadingPlugins.delete(pluginName);
+                const error = `Plugin ${pluginName} missing required exports (name, version)`;
+                this.failedPlugins.set(pluginName, error);
+                throw new Error(error);
+            }
+            if (typeof plugin.register !== 'function') {
+                this.loadingPlugins.delete(pluginName);
+                const error = `Plugin ${pluginName} does not export a register() function`;
+                this.failedPlugins.set(pluginName, error);
+                throw new Error(error);
+            }
+            // Register plugin commands with the CLI
+            await plugin.register(program);
+            // Store plugin instance
+            this.plugins.set(pluginName, {
+                ...plugin,
+                isBuiltIn
+            });
+            this.loadingPlugins.delete(pluginName);
+            return true;
+        }
+        catch (error) {
+            this.loadingPlugins.delete(pluginName);
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.failedPlugins.set(pluginName, errorMessage);
+            throw new Error(`Failed to load plugin ${pluginName}: ${errorMessage}`);
+        }
+    }
+    /**
+     * Load multiple plugins concurrently (with error tolerance)
+     */
+    async loadPlugins(pluginNames, program, options = {}) {
+        const results = await Promise.allSettled(pluginNames.map(name => this.loadPlugin(name, program)));
+        return results.map((result, index) => {
+            const pluginName = pluginNames[index];
+            if (result.status === 'fulfilled' && result.value) {
+                return {
+                    success: true,
+                    plugin: this.plugins.get(pluginName)
+                };
+            }
+            else {
+                const error = result.status === 'rejected' ? result.reason?.message : 'Unknown error';
+                if (options.throwOnError) {
+                    throw new Error(error);
+                }
+                return {
+                    success: false,
+                    error
+                };
+            }
+        });
+    }
+    /**
+     * Get list of loaded plugins (currently in memory)
+     */
+    getLoadedPlugins() {
+        return Array.from(this.plugins.keys());
+    }
+    /**
+     * Get official plugins list
+     */
+    getOfficialPlugins() {
+        return [...this.officialPlugins];
+    }
+    /**
+     * Get plugin instance
+     */
+    getPlugin(pluginName) {
+        return this.plugins.get(pluginName);
+    }
+    /**
+     * Get all plugin instances
+     */
+    getAllPlugins() {
+        return new Map(this.plugins);
+    }
+    /**
+     * Get failed plugins with error messages
+     */
+    getFailedPlugins() {
+        return new Map(this.failedPlugins);
+    }
+    /**
+     * Unload a plugin (remove from registry)
+     * Properly cleans up all references to prevent memory leaks
+     */
+    unloadPlugin(pluginName) {
+        if (this.plugins.has(pluginName)) {
+            // Get plugin instance for cleanup
+            const plugin = this.plugins.get(pluginName);
+            // Call cleanup if plugin provides it
+            if (plugin && typeof plugin.cleanup === 'function') {
+                try {
+                    plugin.cleanup();
+                }
+                catch (error) {
+                    console.warn(`Warning: Plugin ${pluginName} cleanup failed:`, error);
+                }
+            }
+            // Remove from all tracking structures
+            this.plugins.delete(pluginName);
+            this.failedPlugins.delete(pluginName);
+            this.loadingPlugins.delete(pluginName);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Reload a plugin (unload then load again)
+     * Useful after updating a plugin to refresh its code
+     */
+    async reloadPlugin(pluginName, program) {
+        // Unload first (this will clean up resources)
+        this.unloadPlugin(pluginName);
+        // Clear Node.js module cache to force fresh import
+        // This is important when reloading after an update
+        try {
+            // Try CommonJS cache clearing
+            if (typeof require !== 'undefined' && require.cache) {
+                const moduleId = require.resolve(pluginName);
+                if (moduleId && require.cache[moduleId]) {
+                    delete require.cache[moduleId];
+                }
+            }
+        }
+        catch (error) {
+            // Module may be ES module or not in cache - continue anyway
+        }
+        // Add a small delay to ensure file system has released handles
+        await new Promise(resolve => setTimeout(resolve, 100));
+        // Load fresh version with cache-busting query parameter
+        return await this.loadPlugin(pluginName, program);
+    }
+    /**
+     * Check if any plugins are currently loading
+     */
+    hasLoadingPlugins() {
+        return this.loadingPlugins.size > 0;
+    }
+    /**
+     * Get count of loaded plugins
+     */
+    getLoadedCount() {
+        return this.plugins.size;
+    }
+    /**
+     * Clear all plugins (useful for testing)
+     */
+    clear() {
+        this.plugins.clear();
+        this.loadingPlugins.clear();
+        this.failedPlugins.clear();
+    }
+}
+// Export a singleton PluginManager instance
+export const pluginManager = new PluginManager();
+/**
+ * Get the plugin name for a given command name.
+ * Checks loaded plugins for a command match, otherwise returns 'core'.
+ */
+export function getPluginNameForCommand(commandName) {
+    const allPlugins = pluginManager.getAllPlugins();
+    for (const [pluginName, plugin] of allPlugins.entries()) {
+        // If plugin has a 'commands' array property (non-standard, but some plugins may add it)
+        if (plugin && plugin.commands && Array.isArray(plugin.commands)) {
+            if (plugin.commands.includes(commandName)) {
+                return pluginName;
+            }
+        }
+        // If plugin has a 'getCommands' method (non-standard, but some plugins may add it)
+        if (plugin && typeof plugin.getCommands === 'function') {
+            try {
+                const cmds = plugin.getCommands();
+                if (Array.isArray(cmds) && cmds.includes(commandName)) {
+                    return pluginName;
+                }
+            }
+            catch {
+                // Ignore errors from getCommands
+            }
+        }
+    }
+    return 'core';
+}
+//# sourceMappingURL=manager.js.map

package/dist/utils/plugins/manager.js.map

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

package/dist/{plugin-registry.d.ts → utils/plugins/registry.d.ts}

@@ -11,6 +11,8 @@ export interface PluginRegistryEntry {
     type: 'official' | 'community';
     dependencies?: string[];
     systemRequirements?: string[];
+    keywords?: string[];
+    documentation?: string;
 }
 export declare const PLUGIN_REGISTRY: Record<string, PluginRegistryEntry>;
 /**
@@ -19,18 +21,37 @@ export declare const PLUGIN_REGISTRY: Record<string, PluginRegistryEntry>;
  * 1. Official: @mediaproc/<name> (e.g., @mediaproc/image)
  * 2. Community: mediaproc-<name> (e.g., mediaproc-super-filters)
  * 3. Third-party: any npm package (e.g., my-custom-mediaproc-plugin)
+ * @throws {Error} If plugin name is empty or invalid
  */
 export declare function resolvePluginPackage(shortName: string): string;
 /**
  * Detect plugin type from package name
+ * @param packageName - Full package name
+ * @returns Plugin type: official, community, or third-party
  */
 export declare function detectPluginType(packageName: string): 'official' | 'community' | 'third-party';
 /**
  * Get all available plugins grouped by category
  */
 export declare function getPluginsByCategory(): Record<string, PluginRegistryEntry[]>;
+/**
+ * Get all plugins (unique by package)
+ */
+export declare function getAllPlugins(): PluginRegistryEntry[];
+/**
+ * Search plugins by keyword
+ */
+export declare function searchPlugins(keyword: string): PluginRegistryEntry[];
+/**
+ * Get plugin entry by package name
+ */
+export declare function getPluginEntry(packageName: string): PluginRegistryEntry | undefined;
 /**
  * Check if a plugin exists in registry
  */
 export declare function isValidPlugin(name: string): boolean;
-//# sourceMappingURL=plugin-registry.d.ts.map
+/**
+ * Get plugin category
+ */
+export declare function getPluginCategory(packageName: string): string | undefined;
+//# sourceMappingURL=registry.d.ts.map

package/dist/utils/plugins/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/utils/plugins/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,cAAc,CAAC;IAC/C,IAAI,EAAE,UAAU,GAAG,WAAW,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAqL/D,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA8B9D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,aAAa,CAc9F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,mBAAmB,EAAE,CAAC,CAiB5E;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,mBAAmB,EAAE,CAYrD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAmBpE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAOnF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGzE"}

package/dist/{plugin-registry.js → utils/plugins/registry.js}

@@ -12,6 +12,8 @@ export const PLUGIN_REGISTRY = {
         category: 'core',
         type: 'official',
         systemRequirements: ['Sharp (auto-installed)'],
+        keywords: ['image', 'photo', 'resize', 'convert', 'filter', 'compress'],
+        documentation: 'https://docs.mediaproc.io/plugins/image'
     },
     'video': {
         name: 'video',
@@ -20,6 +22,8 @@ export const PLUGIN_REGISTRY = {
         category: 'core',
         type: 'official',
         systemRequirements: ['FFmpeg'],
+        keywords: ['video', 'movie', 'transcode', 'compress', 'extract', 'trim'],
+        documentation: 'https://docs.mediaproc.io/plugins/video'
     },
     'audio': {
         name: 'audio',
@@ -28,6 +32,8 @@ export const PLUGIN_REGISTRY = {
         category: 'core',
         type: 'official',
         systemRequirements: ['FFmpeg'],
+        keywords: ['audio', 'music', 'sound', 'convert', 'normalize', 'extract'],
+        documentation: 'https://docs.mediaproc.io/plugins/audio'
     },
     // Document Media (Very Important)
     'document': {
@@ -37,6 +43,8 @@ export const PLUGIN_REGISTRY = {
         category: 'core',
         type: 'official',
         systemRequirements: ['Ghostscript', 'Tesseract OCR', 'Poppler'],
+        keywords: ['pdf', 'document', 'docx', 'ocr', 'compress'],
+        documentation: 'https://docs.mediaproc.io/plugins/document'
     },
     'doc': {
         name: 'doc',
@@ -44,6 +52,7 @@ export const PLUGIN_REGISTRY = {
         description: 'Alias for document plugin',
         category: 'core',
         type: 'official',
+        keywords: ['pdf', 'document', 'alias']
     },
     // Animation & Motion Media
     'animation': {
@@ -53,6 +62,8 @@ export const PLUGIN_REGISTRY = {
         category: 'core',
         type: 'official',
         systemRequirements: ['FFmpeg'],
+        keywords: ['gif', 'animation', 'webp', 'lottie', 'animated'],
+        documentation: 'https://docs.mediaproc.io/plugins/animation'
     },
     'anim': {
         name: 'anim',
@@ -60,6 +71,7 @@ export const PLUGIN_REGISTRY = {
         description: 'Alias for animation plugin',
         category: 'core',
         type: 'official',
+        keywords: ['animation', 'alias']
     },
     // 3D & Spatial Media (Advanced)
     '3d': {
@@ -69,6 +81,8 @@ export const PLUGIN_REGISTRY = {
         category: 'advanced',
         type: 'official',
         systemRequirements: ['gltf-transform'],
+        keywords: ['3d', 'model', 'gltf', 'glb', 'texture', 'ar', 'vr'],
+        documentation: 'https://docs.mediaproc.io/plugins/3d'
     },
     'spatial': {
         name: 'spatial',
@@ -76,6 +90,7 @@ export const PLUGIN_REGISTRY = {
         description: 'Alias for 3d plugin',
         category: 'advanced',
         type: 'official',
+        keywords: ['3d', 'spatial', 'alias']
     },
     // Metadata-only Processing (Underrated but Powerful)
     'metadata': {
@@ -85,6 +100,8 @@ export const PLUGIN_REGISTRY = {
         category: 'core',
         type: 'official',
         systemRequirements: ['ExifTool'],
+        keywords: ['metadata', 'exif', 'inspect', 'compliance'],
+        documentation: 'https://docs.mediaproc.io/plugins/metadata'
     },
     'meta': {
         name: 'meta',
@@ -92,6 +109,7 @@ export const PLUGIN_REGISTRY = {
         description: 'Alias for metadata plugin',
         category: 'core',
         type: 'official',
+        keywords: ['metadata', 'alias']
     },
     'inspect': {
         name: 'inspect',
@@ -99,6 +117,7 @@ export const PLUGIN_REGISTRY = {
         description: 'Alias for metadata plugin',
         category: 'core',
         type: 'official',
+        keywords: ['inspect', 'metadata', 'alias']
     },
     // Streaming & Packaging Media (Advanced, Industry-Relevant)
     'stream': {
@@ -108,6 +127,8 @@ export const PLUGIN_REGISTRY = {
         category: 'advanced',
         type: 'official',
         systemRequirements: ['FFmpeg', 'Shaka Packager (optional)'],
+        keywords: ['stream', 'hls', 'dash', 'manifest', 'packaging'],
+        documentation: 'https://docs.mediaproc.io/plugins/stream'
     },
     'streaming': {
         name: 'streaming',
@@ -115,6 +136,7 @@ export const PLUGIN_REGISTRY = {
         description: 'Alias for stream plugin',
         category: 'advanced',
         type: 'official',
+        keywords: ['streaming', 'alias']
     },
     // AI-Assisted Media (Future-Proof)
     'ai': {
@@ -124,6 +146,8 @@ export const PLUGIN_REGISTRY = {
         category: 'future-proof',
         type: 'official',
         systemRequirements: ['TensorFlow/ONNX Runtime (optional)', 'Whisper (optional)'],
+        keywords: ['ai', 'ml', 'caption', 'detection', 'blur', 'transcribe'],
+        documentation: 'https://docs.mediaproc.io/plugins/ai'
     },
     'ml': {
         name: 'ml',
@@ -131,6 +155,7 @@ export const PLUGIN_REGISTRY = {
         description: 'Alias for ai plugin',
         category: 'future-proof',
         type: 'official',
+        keywords: ['ml', 'ai', 'alias']
     },
     // Media Pipelines (Highest Level)
     'pipeline': {
@@ -140,6 +165,8 @@ export const PLUGIN_REGISTRY = {
         category: 'advanced',
         type: 'official',
         dependencies: ['Can use any installed plugins'],
+        keywords: ['pipeline', 'workflow', 'batch', 'yaml'],
+        documentation: 'https://docs.mediaproc.io/plugins/pipeline'
     },
 };
 /**
@@ -148,29 +175,48 @@ export const PLUGIN_REGISTRY = {
  * 1. Official: @mediaproc/<name> (e.g., @mediaproc/image)
  * 2. Community: mediaproc-<name> (e.g., mediaproc-super-filters)
  * 3. Third-party: any npm package (e.g., my-custom-mediaproc-plugin)
+ * @throws {Error} If plugin name is empty or invalid
  */
 export function resolvePluginPackage(shortName) {
+    // Validate input
+    if (!shortName || typeof shortName !== 'string') {
+        throw new Error('Plugin name cannot be empty');
+    }
+    const trimmed = shortName.trim();
+    if (!trimmed) {
+        throw new Error('Plugin name cannot be empty');
+    }
+    // Validate characters (basic npm package name validation)
+    if (!/^[@\w\-./]+$/.test(trimmed)) {
+        throw new Error(`Invalid plugin name: ${trimmed}`);
+    }
     // Already a full package name - return as-is
-    if (shortName.includes('/') || shortName.startsWith('mediaproc-')) {
-        return shortName;
+    if (trimmed.includes('/') || trimmed.startsWith('mediaproc-')) {
+        return trimmed;
     }
     // Look up in official registry first
-    const entry = PLUGIN_REGISTRY[shortName.toLowerCase()];
+    const entry = PLUGIN_REGISTRY[trimmed.toLowerCase()];
     if (entry) {
         return entry.package;
     }
     // Not in registry - could be community or third-party
     // Assume community format: mediaproc-<name>
-    return `mediaproc-${shortName}`;
+    return `mediaproc-${trimmed}`;
 }
 /**
  * Detect plugin type from package name
+ * @param packageName - Full package name
+ * @returns Plugin type: official, community, or third-party
  */
 export function detectPluginType(packageName) {
-    if (packageName.startsWith('@mediaproc/')) {
+    if (!packageName || typeof packageName !== 'string') {
+        return 'third-party';
+    }
+    const trimmed = packageName.trim();
+    if (trimmed.startsWith('@mediaproc/')) {
         return 'official';
     }
-    if (packageName.startsWith('mediaproc-')) {
+    if (trimmed.startsWith('mediaproc-')) {
         return 'community';
     }
     return 'third-party';
@@ -193,10 +239,62 @@ export function getPluginsByCategory() {
     }
     return grouped;
 }
+/**
+ * Get all plugins (unique by package)
+ */
+export function getAllPlugins() {
+    const seen = new Set();
+    const plugins = [];
+    for (const entry of Object.values(PLUGIN_REGISTRY)) {
+        if (!seen.has(entry.package)) {
+            plugins.push(entry);
+            seen.add(entry.package);
+        }
+    }
+    return plugins;
+}
+/**
+ * Search plugins by keyword
+ */
+export function searchPlugins(keyword) {
+    const lowerKeyword = keyword.toLowerCase();
+    const seen = new Set();
+    const results = [];
+    for (const entry of Object.values(PLUGIN_REGISTRY)) {
+        if (seen.has(entry.package))
+            continue;
+        const matchesName = entry.name.toLowerCase().includes(lowerKeyword);
+        const matchesDescription = entry.description.toLowerCase().includes(lowerKeyword);
+        const matchesKeywords = entry.keywords?.some(k => k.toLowerCase().includes(lowerKeyword));
+        if (matchesName || matchesDescription || matchesKeywords) {
+            results.push(entry);
+            seen.add(entry.package);
+        }
+    }
+    return results;
+}
+/**
+ * Get plugin entry by package name
+ */
+export function getPluginEntry(packageName) {
+    for (const entry of Object.values(PLUGIN_REGISTRY)) {
+        if (entry.package === packageName) {
+            return entry;
+        }
+    }
+    return undefined;
+}
 /**
  * Check if a plugin exists in registry
  */
 export function isValidPlugin(name) {
     return name.startsWith('@mediaproc/') || name.toLowerCase() in PLUGIN_REGISTRY;
 }
-//# sourceMappingURL=plugin-registry.js.map
+/**
+ * Get plugin category
+ */
+export function getPluginCategory(packageName) {
+    const entry = getPluginEntry(packageName);
+    return entry?.category;
+}
+//# sourceMappingURL=registry.js.map