schemantic 0.1.0

package/dist/plugins/builtin.js

@@ -0,0 +1,283 @@
+"use strict";
+/**
+ * Built-in plugins for common transformations and enhancements
+ * Provides standard plugins that can be used out of the box
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.strictModePlugin = exports.reactHooksPlugin = exports.validationPlugin = exports.jsdocPlugin = void 0;
+exports.getBuiltinPlugins = getBuiltinPlugins;
+exports.getBasicBuiltinPlugins = getBasicBuiltinPlugins;
+exports.getAdvancedBuiltinPlugins = getAdvancedBuiltinPlugins;
+exports.getBuiltinPlugin = getBuiltinPlugin;
+const schema_1 = require("../types/schema");
+// Import advanced plugins
+const zod_validation_1 = __importDefault(require("./zod-validation"));
+const performance_monitoring_1 = __importDefault(require("./performance-monitoring"));
+const request_deduplication_1 = __importDefault(require("./request-deduplication"));
+const branded_types_1 = __importDefault(require("./branded-types"));
+/**
+ * Built-in plugin for adding JSDoc comments
+ */
+exports.jsdocPlugin = {
+    name: "jsdoc",
+    version: "1.0.0",
+    description: "Adds JSDoc comments to generated types and methods",
+    beforeTypeGeneration: async (_typeName, schema, _context) => {
+        // Add description to schema if not present
+        if ((0, schema_1.isOpenAPISchemaObject)(schema) && !schema.description && schema.title) {
+            schema.description = `Type definition for ${schema.title}`;
+        }
+    },
+    afterTypeGeneration: async (typeName, generatedType, _context) => {
+        // Add JSDoc comment if not present
+        if (!generatedType.content.includes("/**")) {
+            const description = (0, schema_1.isOpenAPISchemaObject)(generatedType.sourceSchema)
+                ? generatedType.sourceSchema.description
+                : undefined;
+            const comment = `/**\n * ${description || `Generated type: ${typeName}`}\n */\n`;
+            generatedType.content = comment + generatedType.content;
+        }
+    },
+    afterClientGeneration: async (generatedClient, context) => {
+        // Add JSDoc comment to client class
+        if (!generatedClient.content.includes("/**")) {
+            const comment = `/**\n * Generated API client\n * @description ${context.schema.info?.description || "Auto-generated from OpenAPI schema"}\n */\n`;
+            generatedClient.content = comment + generatedClient.content;
+        }
+    },
+};
+/**
+ * Built-in plugin for adding validation decorators
+ */
+exports.validationPlugin = {
+    name: "validation",
+    version: "1.0.0",
+    description: "Adds validation decorators to generated types",
+    transformSchema: (schema, _context) => {
+        // Add validation metadata to schema
+        if ((0, schema_1.isOpenAPISchemaObject)(schema) && schema.properties) {
+            for (const [propName, propSchema] of Object.entries(schema.properties)) {
+                if (typeof propSchema === "object" &&
+                    propSchema !== null &&
+                    (0, schema_1.isOpenAPISchemaObject)(propSchema)) {
+                    // Add validation metadata
+                    const meta = {
+                        required: schema.required?.includes(propName) || false,
+                    };
+                    if (propSchema.minLength !== undefined)
+                        meta.minLength = propSchema.minLength;
+                    if (propSchema.maxLength !== undefined)
+                        meta.maxLength = propSchema.maxLength;
+                    if (propSchema.minimum !== undefined)
+                        meta.minimum = propSchema.minimum;
+                    if (propSchema.maximum !== undefined)
+                        meta.maximum = propSchema.maximum;
+                    if (propSchema.pattern !== undefined)
+                        meta.pattern = propSchema.pattern;
+                    if (propSchema.format !== undefined)
+                        meta.format = propSchema.format;
+                    propSchema._validationMetadata = meta;
+                }
+            }
+        }
+        return schema;
+    },
+    afterTypeGeneration: async (_typeName, generatedType, _context) => {
+        // Add validation decorators to generated type
+        if (generatedType.isInterface &&
+            (0, schema_1.isOpenAPISchemaObject)(generatedType.sourceSchema) &&
+            generatedType.sourceSchema.properties) {
+            let content = generatedType.content;
+            // Add validation imports
+            const validationImports = `import { IsString, IsNumber, IsBoolean, IsOptional, IsNotEmpty, MinLength, MaxLength, Min, Max, Matches } from 'class-validator';\n\n`;
+            // Add validation decorators to properties
+            const lines = content.split("\n");
+            const newLines = [];
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                newLines.push(line);
+                // Check if this is a property line
+                if (line.includes(":") &&
+                    !line.includes("export") &&
+                    !line.includes("interface")) {
+                    const propName = line.split(":")[0]?.trim();
+                    if (propName) {
+                        const validationDecorators = generateValidationDecorators(propName, generatedType.sourceSchema);
+                        if (validationDecorators) {
+                            newLines.push(validationDecorators);
+                        }
+                    }
+                }
+            }
+            generatedType.content = validationImports + newLines.join("\n");
+        }
+    },
+};
+// Helper function to generate validation decorators
+function generateValidationDecorators(propName, schema) {
+    if (!(0, schema_1.isOpenAPISchemaObject)(schema) || !schema.properties) {
+        return undefined;
+    }
+    const propSchema = schema.properties[propName];
+    if (!propSchema ||
+        typeof propSchema !== "object" ||
+        !(0, schema_1.isOpenAPISchemaObject)(propSchema)) {
+        return undefined;
+    }
+    const decorators = [];
+    // Add type decorators
+    if (propSchema.type === "string") {
+        decorators.push("@IsString()");
+    }
+    else if (propSchema.type === "number" || propSchema.type === "integer") {
+        decorators.push("@IsNumber()");
+    }
+    else if (propSchema.type === "boolean") {
+        decorators.push("@IsBoolean()");
+    }
+    // Add validation decorators
+    if (propSchema.minLength !== undefined) {
+        decorators.push(`@MinLength(${propSchema.minLength})`);
+    }
+    if (propSchema.maxLength !== undefined) {
+        decorators.push(`@MaxLength(${propSchema.maxLength})`);
+    }
+    if (propSchema.minimum !== undefined) {
+        decorators.push(`@Min(${propSchema.minimum})`);
+    }
+    if (propSchema.maximum !== undefined) {
+        decorators.push(`@Max(${propSchema.maximum})`);
+    }
+    if (propSchema.pattern) {
+        decorators.push(`@Matches(/${propSchema.pattern}/)`);
+    }
+    // Add optional decorator
+    if (propSchema._validationMetadata?.required === false) {
+        decorators.push("@IsOptional()");
+    }
+    else {
+        decorators.push("@IsNotEmpty()");
+    }
+    return decorators.map((d) => `  ${d}`).join("\n");
+}
+/**
+ * Built-in plugin for adding React hooks generation
+ */
+exports.reactHooksPlugin = {
+    name: "react-hooks",
+    version: "1.0.0",
+    description: "Generates React hooks for API endpoints",
+    customClientGenerators: {
+        "react-hooks": (context) => {
+            const schema = context.schema;
+            const clientName = "ApiHooks";
+            // Generate React hooks for each endpoint
+            const hooks = generateReactHooks(schema, context);
+            const content = `import { useQuery, useMutation, useQueryClient } from 'react-query';\nimport { ApiClient } from './api-client';\n\n${hooks}`;
+            return {
+                name: clientName,
+                content,
+                dependencies: ["react-query"],
+                exports: [clientName],
+                endpoints: [], // Hooks don't have traditional endpoints
+            };
+        },
+    },
+};
+// Helper function to generate React hooks
+function generateReactHooks(_schema, _context) {
+    let hooks = "";
+    // This would be implemented to generate actual React hooks
+    // For now, return a placeholder
+    hooks += `export const useApiHooks = (client: ApiClient) => {\n`;
+    hooks += `  // Generated hooks will be here\n`;
+    hooks += `  return {\n`;
+    hooks += `    // Hook methods\n`;
+    hooks += `  };\n`;
+    hooks += `};\n`;
+    return hooks;
+}
+/**
+ * Built-in plugin for adding TypeScript strict mode enhancements
+ */
+exports.strictModePlugin = {
+    name: "strict-mode",
+    version: "1.0.0",
+    description: "Adds TypeScript strict mode enhancements",
+    transformSchema: (schema, _context) => {
+        // Add strict type information
+        if ((0, schema_1.isOpenAPISchemaObject)(schema) && schema.properties) {
+            for (const [propName, propSchema] of Object.entries(schema.properties)) {
+                if (typeof propSchema === "object" &&
+                    propSchema !== null &&
+                    (0, schema_1.isOpenAPISchemaObject)(propSchema)) {
+                    // Mark as strict type
+                    propSchema._isStrictType = true;
+                    // Add null/undefined handling
+                    if (propSchema.nullable) {
+                        propSchema._isNullable = true;
+                    }
+                    if (!schema.required?.includes(propName)) {
+                        propSchema._isOptional = true;
+                    }
+                }
+            }
+        }
+        return schema;
+    },
+    afterTypeGeneration: async (_typeName, generatedType, _context) => {
+        // Add strict type annotations
+        if (generatedType.isInterface) {
+            let content = generatedType.content;
+            // Add strict type imports
+            const strictImports = `import { StrictType, Optional, Nullable } from './strict-types';\n\n`;
+            // Add strict type annotations
+            content = strictImports + content;
+            generatedType.content = content;
+        }
+    },
+};
+/**
+ * Get all built-in plugins (including advanced plugins)
+ */
+function getBuiltinPlugins() {
+    return [
+        // Basic plugins
+        exports.jsdocPlugin,
+        exports.validationPlugin,
+        exports.reactHooksPlugin,
+        exports.strictModePlugin,
+        // Advanced plugins
+        zod_validation_1.default,
+        performance_monitoring_1.default,
+        request_deduplication_1.default,
+        branded_types_1.default,
+    ];
+}
+/**
+ * Get basic built-in plugins only
+ */
+function getBasicBuiltinPlugins() {
+    return [exports.jsdocPlugin, exports.validationPlugin, exports.reactHooksPlugin, exports.strictModePlugin];
+}
+/**
+ * Get advanced built-in plugins only
+ */
+function getAdvancedBuiltinPlugins() {
+    return [
+        zod_validation_1.default,
+        performance_monitoring_1.default,
+        request_deduplication_1.default,
+        branded_types_1.default,
+    ];
+}
+/**
+ * Get built-in plugin by name
+ */
+function getBuiltinPlugin(name) {
+    return getBuiltinPlugins().find((plugin) => plugin.name === name);
+}
+//# sourceMappingURL=builtin.js.map

package/dist/plugins/builtin.js.map

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

package/dist/plugins/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Plugin module exports
+ */
+export * from './manager';
+export * from './loader';
+export * from './builtin';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC"}

package/dist/plugins/index.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Plugin module exports
+ */
+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 });
+__exportStar(require("./manager"), exports);
+__exportStar(require("./loader"), exports);
+__exportStar(require("./builtin"), exports);
+//# sourceMappingURL=index.js.map

package/dist/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,4CAA0B;AAC1B,2CAAyB;AACzB,4CAA0B"}

package/dist/plugins/loader.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Plugin loader for dynamic plugin loading
+ * Handles loading plugins from various sources (files, packages, etc.)
+ */
+import { SchemanticPlugin } from "../types/core";
+/**
+ * Plugin loader class
+ */
+export declare class PluginLoader {
+    private loadedPlugins;
+    /**
+     * Load plugin from file path
+     */
+    loadPluginFromFile(filePath: string): Promise<SchemanticPlugin>;
+    /**
+     * Load plugin from package
+     */
+    loadPluginFromPackage(packageName: string): Promise<SchemanticPlugin>;
+    /**
+     * Load plugins from directory
+     */
+    loadPluginsFromDirectory(directoryPath: string): Promise<SchemanticPlugin[]>;
+    /**
+     * Load plugin from object
+     */
+    loadPluginFromObject(plugin: SchemanticPlugin): SchemanticPlugin;
+    /**
+     * Extract plugin from module
+     */
+    private extractPluginFromModule;
+    /**
+     * Check if object is a valid plugin
+     */
+    private isValidPlugin;
+    /**
+     * Validate plugin
+     */
+    private validatePlugin;
+    /**
+     * Get loaded plugin
+     */
+    getLoadedPlugin(name: string): SchemanticPlugin | undefined;
+    /**
+     * Get all loaded plugins
+     */
+    getAllLoadedPlugins(): SchemanticPlugin[];
+    /**
+     * Clear loaded plugins
+     */
+    clear(): void;
+    /**
+     * Get loading statistics
+     */
+    getStatistics(): LoadingStatistics;
+}
+/**
+ * Loading statistics
+ */
+export interface LoadingStatistics {
+    loadedPlugins: number;
+    pluginNames: string[];
+}
+/**
+ * Plugin loading options
+ */
+export interface PluginLoadingOptions {
+    /**
+     * Whether to continue loading other plugins if one fails
+     */
+    continueOnError?: boolean;
+    /**
+     * Whether to validate plugins after loading
+     */
+    validate?: boolean;
+    /**
+     * Custom validation function
+     */
+    customValidator?: (plugin: SchemanticPlugin) => boolean;
+}
+/**
+ * Convenience function to load plugin from file
+ */
+export declare function loadPluginFromFile(filePath: string): Promise<SchemanticPlugin>;
+/**
+ * Convenience function to load plugin from package
+ */
+export declare function loadPluginFromPackage(packageName: string): Promise<SchemanticPlugin>;
+/**
+ * Convenience function to load plugins from directory
+ */
+export declare function loadPluginsFromDirectory(directoryPath: string): Promise<SchemanticPlugin[]>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/plugins/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,aAAa,CAA4C;IAEjE;;OAEG;IACG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2BrE;;OAEG;IACG,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA0B3E;;OAEG;IACG,wBAAwB,CAC5B,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IA+B9B;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB;IAUhE;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAwC/B;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAmBtB;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI3D;;OAEG;IACH,mBAAmB,IAAI,gBAAgB,EAAE;IAIzC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,aAAa,IAAI,iBAAiB;CAMnC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC;CACzD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,CAAC,CAG3B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC,CAG3B;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAG7B"}

package/dist/plugins/loader.js

@@ -0,0 +1,245 @@
+"use strict";
+/**
+ * Plugin loader for dynamic plugin loading
+ * Handles loading plugins from various sources (files, packages, etc.)
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginLoader = void 0;
+exports.loadPluginFromFile = loadPluginFromFile;
+exports.loadPluginFromPackage = loadPluginFromPackage;
+exports.loadPluginsFromDirectory = loadPluginsFromDirectory;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+/**
+ * Plugin loader class
+ */
+class PluginLoader {
+    constructor() {
+        this.loadedPlugins = new Map();
+    }
+    /**
+     * Load plugin from file path
+     */
+    async loadPluginFromFile(filePath) {
+        try {
+            // Check if file exists
+            await fs.access(filePath);
+            // Load the module
+            const pluginModule = await Promise.resolve(`${path.resolve(filePath)}`).then(s => __importStar(require(s)));
+            // Extract plugin from module
+            const plugin = this.extractPluginFromModule(pluginModule);
+            if (!plugin) {
+                throw new Error(`No valid plugin found in ${filePath}`);
+            }
+            // Validate plugin
+            this.validatePlugin(plugin);
+            // Store loaded plugin
+            this.loadedPlugins.set(plugin.name, plugin);
+            return plugin;
+        }
+        catch (error) {
+            throw new Error(`Failed to load plugin from ${filePath}: ${error}`);
+        }
+    }
+    /**
+     * Load plugin from package
+     */
+    async loadPluginFromPackage(packageName) {
+        try {
+            // Load the package
+            const pluginModule = await Promise.resolve(`${packageName}`).then(s => __importStar(require(s)));
+            // Extract plugin from module
+            const plugin = this.extractPluginFromModule(pluginModule);
+            if (!plugin) {
+                throw new Error(`No valid plugin found in package ${packageName}`);
+            }
+            // Validate plugin
+            this.validatePlugin(plugin);
+            // Store loaded plugin
+            this.loadedPlugins.set(plugin.name, plugin);
+            return plugin;
+        }
+        catch (error) {
+            throw new Error(`Failed to load plugin from package ${packageName}: ${error}`);
+        }
+    }
+    /**
+     * Load plugins from directory
+     */
+    async loadPluginsFromDirectory(directoryPath) {
+        try {
+            const plugins = [];
+            // Read directory contents
+            const entries = await fs.readdir(directoryPath, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isFile() &&
+                    (entry.name.endsWith(".js") || entry.name.endsWith(".ts"))) {
+                    const filePath = path.join(directoryPath, entry.name);
+                    try {
+                        const plugin = await this.loadPluginFromFile(filePath);
+                        plugins.push(plugin);
+                    }
+                    catch (error) {
+                        console.warn(`Failed to load plugin from ${filePath}:`, error);
+                    }
+                }
+            }
+            return plugins;
+        }
+        catch (error) {
+            throw new Error(`Failed to load plugins from directory ${directoryPath}: ${error}`);
+        }
+    }
+    /**
+     * Load plugin from object
+     */
+    loadPluginFromObject(plugin) {
+        // Validate plugin
+        this.validatePlugin(plugin);
+        // Store loaded plugin
+        this.loadedPlugins.set(plugin.name, plugin);
+        return plugin;
+    }
+    /**
+     * Extract plugin from module
+     */
+    extractPluginFromModule(module) {
+        // Try different export patterns
+        if (typeof module === "object" &&
+            module !== null &&
+            "default" in module &&
+            this.isValidPlugin(module.default)) {
+            return module.default;
+        }
+        if (typeof module === "object" &&
+            module !== null &&
+            "plugin" in module &&
+            this.isValidPlugin(module.plugin)) {
+            return module.plugin;
+        }
+        if (this.isValidPlugin(module)) {
+            return module;
+        }
+        // Look for plugin in exports
+        if (typeof module === "object" && module !== null) {
+            for (const [, value] of Object.entries(module)) {
+                if (this.isValidPlugin(value)) {
+                    return value;
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Check if object is a valid plugin
+     */
+    isValidPlugin(obj) {
+        if (!obj || typeof obj !== "object")
+            return false;
+        const maybe = obj;
+        return (typeof maybe.name === "string" &&
+            typeof maybe.version === "string" &&
+            typeof maybe.description === "string");
+    }
+    /**
+     * Validate plugin
+     */
+    validatePlugin(plugin) {
+        if (!plugin.name || typeof plugin.name !== "string") {
+            throw new Error("Plugin must have a valid name");
+        }
+        if (!plugin.version || typeof plugin.version !== "string") {
+            throw new Error("Plugin must have a valid version");
+        }
+        if (!plugin.description || typeof plugin.description !== "string") {
+            throw new Error("Plugin must have a valid description");
+        }
+        // Check for duplicate names
+        if (this.loadedPlugins.has(plugin.name)) {
+            throw new Error(`Plugin with name '${plugin.name}' is already loaded`);
+        }
+    }
+    /**
+     * Get loaded plugin
+     */
+    getLoadedPlugin(name) {
+        return this.loadedPlugins.get(name);
+    }
+    /**
+     * Get all loaded plugins
+     */
+    getAllLoadedPlugins() {
+        return Array.from(this.loadedPlugins.values());
+    }
+    /**
+     * Clear loaded plugins
+     */
+    clear() {
+        this.loadedPlugins.clear();
+    }
+    /**
+     * Get loading statistics
+     */
+    getStatistics() {
+        return {
+            loadedPlugins: this.loadedPlugins.size,
+            pluginNames: Array.from(this.loadedPlugins.keys()),
+        };
+    }
+}
+exports.PluginLoader = PluginLoader;
+/**
+ * Convenience function to load plugin from file
+ */
+async function loadPluginFromFile(filePath) {
+    const loader = new PluginLoader();
+    return loader.loadPluginFromFile(filePath);
+}
+/**
+ * Convenience function to load plugin from package
+ */
+async function loadPluginFromPackage(packageName) {
+    const loader = new PluginLoader();
+    return loader.loadPluginFromPackage(packageName);
+}
+/**
+ * Convenience function to load plugins from directory
+ */
+async function loadPluginsFromDirectory(directoryPath) {
+    const loader = new PluginLoader();
+    return loader.loadPluginsFromDirectory(directoryPath);
+}
+//# sourceMappingURL=loader.js.map