@majkapp/plugin-kit 3.3.5 → 3.4.0

package/dist/generator/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/generator/generator.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,GAAG,EACb,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EAAE,GACZ,OAAO,CAAC,gBAAgB,CAAC,CAmC3B"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/generator/generator.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAgBD,wBAAsB,cAAc,CAClC,QAAQ,EAAE,GAAG,EACb,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EAAE,GACZ,OAAO,CAAC,gBAAgB,CAAC,CA8B3B"}

package/dist/generator/generator.js

@@ -39,7 +39,6 @@ const path = __importStar(require("path"));
 async function generateClient(metadata, outputPath, log) {
     const warnings = [];
     const files = [];
-    // Helper to write files
     const writeFile = (filename, content) => {
         const filePath = path.join(outputPath, filename);
         fs.writeFileSync(filePath, content, 'utf-8');
@@ -47,16 +46,12 @@ async function generateClient(metadata, outputPath, log) {
         log.push(`  ✓ Generated ${filename}`);
     };
     try {
-        // 1. Generate TypeScript types
         const types = generateTypes(metadata, warnings, log);
         writeFile('types.ts', types);
-        // 2. Generate client class
         const client = generateClientClass(metadata, warnings, log);
         writeFile('client.ts', client);
-        // 3. Generate React hooks
         const hooks = generateReactHooks(metadata, warnings, log);
         writeFile('hooks.ts', hooks);
-        // 4. Generate index file
         const index = generateIndex();
         writeFile('index.ts', index);
     }
@@ -75,20 +70,16 @@ function generateTypes(metadata, warnings, log) {
  */
 
 `);
-    // Extract types from function schemas
     const processedTypes = new Set();
     metadata.functions.forEach((func) => {
         try {
-            // Generate input type
             const inputTypeName = `${capitalize(func.name)}Input`;
             if (!processedTypes.has(inputTypeName)) {
                 lines.push(`export interface ${inputTypeName} ${schemaToTypeScript(func.input, 0)}\n`);
                 processedTypes.add(inputTypeName);
             }
-            // Generate output type
             const outputTypeName = `${capitalize(func.name)}Output`;
             if (!processedTypes.has(outputTypeName)) {
-                // Handle array types specially - use type alias instead of interface
                 if (func.output.type === 'array') {
                     lines.push(`export type ${outputTypeName} = ${schemaToTypeScript(func.output, 0)};\n`);
                 }
@@ -102,7 +93,6 @@ function generateTypes(metadata, warnings, log) {
             warnings.push(`Failed to generate types for ${func.name}: ${error.message}`);
         }
     });
-    // Standard response types
     lines.push(`
 export interface SuccessResponse<T> {
   success: true;
@@ -134,13 +124,11 @@ ${metadata.functions.map((f) => `  ${capitalize(f.name)}Input,
 
 export class ${capitalize(toCamelCase(metadata.id))}Client {
   private getApiUrl(functionName: string): string {
-    // Extract plugin path from current URL: /plugins/{org}/{id}/ui -> /plugins/{org}/{id}
     const path = window.location.pathname;
     const match = path.match(/(\\/plugins\\/[^\\/]+\\/[^\\/]+)\\//);
     if (match) {
       return \`\${match[1]}/api/\${functionName}\`;
     }
-    // Fallback to relative path
     return \`../api/\${functionName}\`;
   }
 
@@ -159,14 +147,10 @@ export class ${capitalize(toCamelCase(metadata.id))}Client {
 
       const result = await response.json();
 
-      // The transport wraps responses in { success: boolean, data?: T, error?: string }
-      // Check for errors first
       if (result.success === false) {
         throw new Error(result.error || \`Function \${functionName} failed\`);
       }
 
-      // Return the unwrapped data
-      // The TypeScript output types represent the data inside the wrapper
       return result.data;
     } catch (error: any) {
       console.error(\`Error calling \${functionName}:\`, error);
@@ -174,7 +158,6 @@ export class ${capitalize(toCamelCase(metadata.id))}Client {
     }
   }
 `);
-    // Generate methods for each function
     metadata.functions.forEach((func) => {
         try {
             const methodName = toCamelCase(func.name);
@@ -196,7 +179,6 @@ export class ${capitalize(toCamelCase(metadata.id))}Client {
     const className = `${capitalize(toCamelCase(metadata.id))}Client`;
     lines.push(`}
 
-// Default singleton instance
 export const client = new ${className}();
 `);
     return lines.join('');
@@ -207,6 +189,14 @@ function generateReactHooks(metadata, warnings, log) {
  * Auto-generated React hooks for ${metadata.name}
  * Generated at: ${new Date().toISOString()}
  * Plugin version: ${metadata.version}
+ *
+ * Hook Dependency Strategy:
+ * - Query hooks use schema-driven primitive dependency extraction
+ * - Primitive fields (string, number, boolean) are tracked individually via Object.is()
+ * - Complex fields (objects, arrays) are serialized only when necessary
+ * - This enables inline object literals without memoization while maintaining performance
+ *
+ * See generation.log for dependency analysis and schema optimization warnings.
  */
 
 import { useState, useEffect, useCallback } from 'react';
@@ -230,21 +220,34 @@ export interface UseMutationResult<TInput, TOutput> {
   loading: boolean;
 }
 `);
-    // Generate hooks for each function
     metadata.functions.forEach((func) => {
         try {
             const hookName = `use${capitalize(func.name)}`;
             const inputType = `${capitalize(func.name)}Input`;
             const outputType = `${capitalize(func.name)}Output`;
-            // Determine if it's a query or mutation based on name/tags
             const isQuery = func.name.startsWith('get') ||
                 func.name.startsWith('list') ||
                 func.name.includes('health') ||
                 func.name.includes('status');
             if (isQuery) {
+                const analysis = analyzeSchemaDependencies(func.input, 'input', func.name);
+                logDependencyAnalysis(func.name, analysis, log);
+                analysis.warnings.forEach(w => {
+                    const prefix = w.severity === 'error' ? '❌' : w.severity === 'warning' ? '⚠️' : 'ℹ️';
+                    const msg = `${prefix} ${func.name}${w.field ? `.${w.field}` : ''}: ${w.message}${w.suggestion ? ` → ${w.suggestion}` : ''}`;
+                    log.push(`    ${msg}`);
+                    warnings.push(msg);
+                });
+                const depExpressions = analysis.expressions.length > 0
+                    ? [...analysis.expressions, 'options?.enabled']
+                    : ['JSON.stringify(input)', 'options?.enabled'];
+                const depsString = depExpressions.join(', ');
+                const depComment = buildDependencyComment(analysis, func.input);
                 lines.push(`
 /**
  * React hook for ${func.description}
+ *
+ * Dependencies (${analysis.primitiveCount} primitive, ${analysis.serializedCount} serialized):${depComment}
  */
 export function ${hookName}(
   input: ${inputType} = {},
@@ -268,7 +271,7 @@ export function ${hookName}(
     } finally {
       setLoading(false);
     }
-  }, [JSON.stringify(input), options?.enabled]);
+  }, [${depsString}]);
 
   useEffect(() => {
     fetch();
@@ -331,12 +334,210 @@ export * from './client';
 export * from './hooks';
 `;
 }
-// Helper functions
+function analyzeSchemaDependencies(schema, accessor, funcName, depth = 0, maxDepth = 1) {
+    const expressions = [];
+    const warnings = [];
+    let primitiveCount = 0;
+    let serializedCount = 0;
+    if (!schema || !schema.properties) {
+        if (schema && schema.type === 'object' && schema.additionalProperties) {
+            warnings.push({
+                severity: 'warning',
+                message: 'Schema uses additionalProperties - using full object serialization',
+                suggestion: 'Define explicit properties for better performance and type safety'
+            });
+            serializedCount++;
+        }
+        return { expressions, warnings, primitiveCount, serializedCount };
+    }
+    const props = schema.properties || {};
+    const propCount = Object.keys(props).length;
+    if (propCount === 0) {
+        warnings.push({
+            severity: 'info',
+            message: 'Input has no properties - empty object input'
+        });
+        return { expressions, warnings, primitiveCount, serializedCount };
+    }
+    if (propCount > 15) {
+        warnings.push({
+            severity: 'warning',
+            message: `Input has ${propCount} properties - consider splitting into smaller API calls`,
+            suggestion: 'Large input objects can cause performance issues and are harder to maintain'
+        });
+    }
+    for (const [key, prop] of Object.entries(props)) {
+        const path = `${accessor}?.${key}`;
+        const propAnalysis = analyzeProperty(prop, path, key, depth, maxDepth);
+        expressions.push(...propAnalysis.expressions);
+        warnings.push(...propAnalysis.warnings);
+        primitiveCount += propAnalysis.primitiveCount;
+        serializedCount += propAnalysis.serializedCount;
+    }
+    return { expressions, warnings, primitiveCount, serializedCount };
+}
+function analyzeProperty(prop, path, fieldName, depth, maxDepth) {
+    const expressions = [];
+    const warnings = [];
+    let primitiveCount = 0;
+    let serializedCount = 0;
+    if (isPrimitiveSchema(prop)) {
+        expressions.push(path);
+        primitiveCount++;
+    }
+    else if (prop.type === 'array') {
+        if (!prop.items) {
+            warnings.push({
+                severity: 'warning',
+                field: fieldName,
+                message: 'Array field has no items schema - using serialization',
+                suggestion: 'Define items schema for better type safety'
+            });
+            expressions.push(`JSON.stringify(${path})`);
+            serializedCount++;
+        }
+        else if (isPrimitiveSchema(prop.items)) {
+            expressions.push(`JSON.stringify(${path})`);
+            serializedCount++;
+        }
+        else {
+            warnings.push({
+                severity: 'info',
+                field: fieldName,
+                message: 'Array of complex objects requires serialization',
+                suggestion: 'Consider using IDs instead of full objects for better performance'
+            });
+            expressions.push(`JSON.stringify(${path})`);
+            serializedCount++;
+        }
+    }
+    else if (prop.type === 'object' || prop.properties) {
+        if (depth < maxDepth && isShallowObjectSchema(prop)) {
+            const nestedProps = prop.properties || {};
+            const nestedCount = Object.keys(nestedProps).length;
+            if (nestedCount > 10) {
+                warnings.push({
+                    severity: 'warning',
+                    field: fieldName,
+                    message: `Nested object has ${nestedCount} properties - using serialization`,
+                    suggestion: 'Consider flattening the structure or reducing nested properties'
+                });
+                expressions.push(`JSON.stringify(${path})`);
+                serializedCount++;
+            }
+            else {
+                for (const [nestedKey, nestedProp] of Object.entries(nestedProps)) {
+                    const nestedPath = `${path}?.${nestedKey}`;
+                    if (isPrimitiveSchema(nestedProp)) {
+                        expressions.push(nestedPath);
+                        primitiveCount++;
+                    }
+                    else {
+                        expressions.push(`JSON.stringify(${nestedPath})`);
+                        serializedCount++;
+                    }
+                }
+            }
+        }
+        else {
+            if (depth >= maxDepth) {
+                warnings.push({
+                    severity: 'info',
+                    field: fieldName,
+                    message: `Nested beyond depth ${maxDepth} - using serialization`,
+                    suggestion: 'Consider flattening deeply nested structures'
+                });
+            }
+            expressions.push(`JSON.stringify(${path})`);
+            serializedCount++;
+        }
+    }
+    else if (prop.anyOf || prop.oneOf) {
+        warnings.push({
+            severity: 'info',
+            field: fieldName,
+            message: 'Union type field requires serialization',
+            suggestion: 'Union types cannot be optimized - this is expected'
+        });
+        expressions.push(`JSON.stringify(${path})`);
+        serializedCount++;
+    }
+    else {
+        warnings.push({
+            severity: 'warning',
+            field: fieldName,
+            message: `Unknown schema type - using serialization`,
+            suggestion: 'Check schema definition'
+        });
+        expressions.push(`JSON.stringify(${path})`);
+        serializedCount++;
+    }
+    return { expressions, warnings, primitiveCount, serializedCount };
+}
+function isPrimitiveSchema(schema) {
+    if (!schema)
+        return false;
+    const primitiveTypes = new Set(['string', 'number', 'integer', 'boolean', 'null']);
+    if (typeof schema.type === 'string') {
+        return primitiveTypes.has(schema.type);
+    }
+    if (Array.isArray(schema.type)) {
+        return schema.type.every((t) => t === 'null' || primitiveTypes.has(t));
+    }
+    return false;
+}
+function isShallowObjectSchema(schema) {
+    if (!schema)
+        return false;
+    if (schema.type !== 'object' && !schema.properties)
+        return false;
+    if (schema.anyOf || schema.oneOf || schema.allOf)
+        return false;
+    if (schema.additionalProperties === true)
+        return false;
+    return true;
+}
+function buildDependencyComment(analysis, schema) {
+    if (analysis.expressions.length === 0) {
+        return '\n *   - Using full object serialization (no schema properties defined)';
+    }
+    const props = schema?.properties || {};
+    const lines = [];
+    for (const expr of analysis.expressions) {
+        if (expr === 'options?.enabled')
+            continue;
+        if (expr.includes('JSON.stringify')) {
+            const match = expr.match(/input\?\.(\w+)/);
+            const field = match ? match[1] : 'unknown';
+            const prop = props[field];
+            const type = prop?.type || 'unknown';
+            lines.push(`\n *   - ${expr} (${type} - requires serialization)`);
+        }
+        else {
+            const match = expr.match(/input\?\.(\w+)/);
+            const field = match ? match[1] : 'unknown';
+            const prop = props[field];
+            const type = prop?.type || 'primitive';
+            lines.push(`\n *   - ${expr} (${type} - O(1) comparison)`);
+        }
+    }
+    return lines.join('');
+}
+function logDependencyAnalysis(funcName, analysis, log) {
+    log.push(`    📊 ${funcName} dependency analysis:`);
+    log.push(`       ✓ ${analysis.primitiveCount} primitive dependencies (fast)`);
+    if (analysis.serializedCount > 0) {
+        log.push(`       ⚡ ${analysis.serializedCount} serialized dependencies`);
+    }
+    if (analysis.warnings.length === 0) {
+        log.push(`       ✓ No schema issues detected`);
+    }
+}
 function schemaToTypeScript(schema, indent) {
     if (!schema)
         return 'any';
     const spaces = '  '.repeat(indent);
-    if (schema.type === 'object') {
+    if (schema.type === 'object' || schema.properties) {
         const props = schema.properties || {};
         const required = schema.required || [];
         const lines = ['{'];
@@ -370,7 +571,6 @@ function schemaToTypeScript(schema, indent) {
     if (schema.type === 'null') {
         return 'null';
     }
-    // Handle union types
     if (Array.isArray(schema.type)) {
         return schema.type.map((t) => {
             if (t === 'null')
@@ -384,7 +584,6 @@ function schemaToTypeScript(schema, indent) {
             return 'any';
         }).join(' | ');
     }
-    // Handle anyOf/oneOf
     if (schema.anyOf || schema.oneOf) {
         const schemas = schema.anyOf || schema.oneOf;
         return schemas.map((s) => schemaToTypeScript(s, indent)).join(' | ');

package/dist/plugin-kit.d.ts

@@ -134,6 +134,12 @@ export interface FluentBuilder<Id extends string> {
      *   .build();
      */
     pluginRoot(dir: string): this;
+    /**
+     * Disable automatic plugin service generation.
+     * By default, plugin-kit creates a service exposing all plugin functions.
+     * Use this to manage services manually.
+     */
+    noPluginService(): this;
     /** Build the plugin */
     build(): InProcessPlugin;
 }

package/dist/plugin-kit.d.ts.map

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

package/dist/plugin-kit.js

@@ -665,6 +665,7 @@ function definePlugin(id, name, version) {
     let _onReady = null;
     let _healthCheck = null;
     let _pluginRoot = undefined;
+    let _autoPluginService = true; // Auto-generate plugin service by default
     const builder = {
         topbar(route, opts) {
             _topbars.push({
@@ -1099,6 +1100,11 @@ function definePlugin(id, name, version) {
             _pluginRoot = dir;
             return this;
         },
+        noPluginService() {
+            _autoPluginService = false;
+            log(`  🚫 Disabled auto-generated plugin service`);
+            return this;
+        },
         build() {
             // ========== Load Package Info ==========
             let packageName;
@@ -1347,6 +1353,46 @@ function definePlugin(id, name, version) {
                 }
                 _capabilities.push(functionCap);
             }
+            // ========== Auto-Generate Plugin Service ==========
+            // Automatically create a service that exposes all plugin functions
+            // unless explicitly disabled with .noPluginService()
+            if (_autoPluginService && _functionRegistry.functions.size > 0) {
+                const functionMetadata = [];
+                // Build function metadata for all registered functions
+                for (const [funcName, func] of _functionRegistry.functions.entries()) {
+                    const parameters = convertSchemaToParameters(func.input);
+                    const returns = convertSchemaToReturns(func.output);
+                    functionMetadata.push({
+                        name: funcName,
+                        description: func.description,
+                        parameters,
+                        returns,
+                        tags: [id], // Single tag: plugin ID
+                        deprecated: func.deprecated
+                        // NO examples - intentionally omitted
+                    });
+                }
+                // Use packageName if available, fallback to plugin id
+                // This ensures service names like "@majk/task-manager:all" instead of "task-manager-sample:all"
+                const serviceBaseName = packageName || id;
+                const serviceTypeBaseName = packageName ? packageName : `@${id}`;
+                // Create the auto-generated service capability
+                const pluginServiceCapability = {
+                    type: 'service',
+                    serviceName: `${serviceBaseName}:all`,
+                    serviceType: `${serviceTypeBaseName}:all`,
+                    discoverable: true,
+                    metadata: {
+                        name: `${name} Functions`,
+                        description: `All functions from the ${name} plugin`,
+                        version: version,
+                        category: 'plugin'
+                    },
+                    functions: functionMetadata
+                };
+                _capabilities.push(pluginServiceCapability);
+                log(`  🔄 Auto-generated service: ${serviceBaseName}:all (${functionMetadata.length} functions)`);
+            }
             // ========== Build Plugin Class ==========
             // MAJK expects a class/constructor, not an instance
             // Return a class that instantiates BuiltPlugin

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@majkapp/plugin-kit",
-  "version": "3.3.5",
+  "version": "3.4.0",
   "description": "Pure plugin definition library for MAJK - outputs plugin definitions, not HTTP servers",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/transports.d.ts

@@ -1,59 +0,0 @@
-import type { Transport, TransportMetadata, FunctionRegistry, PluginContext, RequestLike, ResponseLike } from './types';
-/**
- * HTTP Transport configuration
- */
-export interface HttpTransportConfig {
-    basePath?: string;
-    cors?: boolean;
-    validation?: {
-        request?: boolean;
-        response?: boolean;
-    };
-}
-/**
- * HTTP Transport implementation
- */
-export declare class HttpTransport implements Transport {
-    name: string;
-    private registry?;
-    private context?;
-    private config;
-    constructor(config?: HttpTransportConfig);
-    initialize(registry: FunctionRegistry, context: PluginContext): Promise<void>;
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    getMetadata(): TransportMetadata;
-    /**
-     * Handle a function call via HTTP
-     */
-    handleFunctionCall(functionName: string, req: RequestLike, res: ResponseLike, ctx: any): Promise<void>;
-    /**
-     * Get discovery information
-     */
-    getDiscovery(): any;
-}
-/**
- * WebSocket Transport (placeholder for future implementation)
- */
-export declare class WebSocketTransport implements Transport {
-    name: string;
-    private config;
-    constructor(config?: any);
-    initialize(registry: FunctionRegistry, context: PluginContext): Promise<void>;
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    getMetadata(): TransportMetadata;
-}
-/**
- * MCP Transport (placeholder for future implementation)
- */
-export declare class MCPTransport implements Transport {
-    name: string;
-    private config;
-    constructor(config?: any);
-    initialize(registry: FunctionRegistry, context: PluginContext): Promise<void>;
-    start(): Promise<void>;
-    stop(): Promise<void>;
-    getMetadata(): TransportMetadata;
-}
-//# sourceMappingURL=transports.d.ts.map

package/dist/transports.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"transports.d.ts","sourceRoot":"","sources":["../src/transports.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC7C,IAAI,SAAU;IACd,OAAO,CAAC,QAAQ,CAAC,CAAmB;IACpC,OAAO,CAAC,OAAO,CAAC,CAAgB;IAChC,OAAO,CAAC,MAAM,CAAsB;gBAExB,MAAM,GAAE,mBAAwB;IAWtC,UAAU,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,WAAW,IAAI,iBAAiB;IAUhC;;OAEG;IACG,kBAAkB,CACtB,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,GAAG,GACP,OAAO,CAAC,IAAI,CAAC;IAgDhB;;OAEG;IACH,YAAY,IAAI,GAAG;CAkCpB;AAED;;GAEG;AACH,qBAAa,kBAAmB,YAAW,SAAS;IAClD,IAAI,SAAe;IACnB,OAAO,CAAC,MAAM,CAAM;gBAER,MAAM,GAAE,GAAQ;IAItB,UAAU,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,WAAW,IAAI,iBAAiB;CAMjC;AAED;;GAEG;AACH,qBAAa,YAAa,YAAW,SAAS;IAC5C,IAAI,SAAS;IACb,OAAO,CAAC,MAAM,CAAM;gBAER,MAAM,GAAE,GAAQ;IAItB,UAAU,CAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,WAAW,IAAI,iBAAiB;CAMjC"}

package/dist/transports.js

@@ -1,171 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MCPTransport = exports.WebSocketTransport = exports.HttpTransport = void 0;
-/**
- * HTTP Transport implementation
- */
-class HttpTransport {
-    constructor(config = {}) {
-        this.name = 'http';
-        this.config = {
-            basePath: config.basePath || '/api',
-            cors: config.cors !== false,
-            validation: {
-                request: config.validation?.request !== false,
-                response: config.validation?.response !== false
-            }
-        };
-    }
-    async initialize(registry, context) {
-        this.registry = registry;
-        this.context = context;
-        context.logger.info(`HTTP Transport initialized with base path ${this.config.basePath}`);
-    }
-    async start() {
-        // HTTP server is managed by the BuiltPlugin
-        // This transport just provides the route handlers
-    }
-    async stop() {
-        // Cleanup if needed
-    }
-    getMetadata() {
-        // Use the baseUrl from context if available, otherwise construct from context.http
-        const baseUrl = this.context?.http?.baseUrl || '';
-        return {
-            type: 'http',
-            endpoint: `${baseUrl}${this.config.basePath}`,
-            discovery: `${baseUrl}${this.config.basePath}/discovery`
-        };
-    }
-    /**
-     * Handle a function call via HTTP
-     */
-    async handleFunctionCall(functionName, req, res, ctx) {
-        if (!this.registry) {
-            res.status(500);
-            res.json({ success: false, error: 'Transport not initialized' });
-            return;
-        }
-        const func = this.registry.functions.get(functionName);
-        if (!func) {
-            res.status(404);
-            res.json({ success: false, error: `Function "${functionName}" not found` });
-            return;
-        }
-        try {
-            // Get input from request body
-            const input = req.body || {};
-            // Validate input if configured
-            if (this.config.validation?.request) {
-                // TODO: Add actual JSON Schema validation here
-                // For now, just check basic structure
-                if (func.input.type === 'object' && typeof input !== 'object') {
-                    res.status(400);
-                    res.json({
-                        success: false,
-                        error: 'Invalid input',
-                        details: ['Input must be an object']
-                    });
-                    return;
-                }
-            }
-            // Call the function handler
-            const output = await func.handler(input, this.context);
-            // Return success response
-            res.json({ success: true, data: output });
-        }
-        catch (error) {
-            this.context?.logger.error(`Function "${functionName}" error: ${error.message}`);
-            res.status(500);
-            res.json({
-                success: false,
-                error: error.message || 'Internal server error'
-            });
-        }
-    }
-    /**
-     * Get discovery information
-     */
-    getDiscovery() {
-        if (!this.registry) {
-            return { error: 'Transport not initialized' };
-        }
-        const functions = [];
-        for (const [name, func] of this.registry.functions) {
-            functions.push({
-                name,
-                description: func.description,
-                input: func.input,
-                output: func.output,
-                tags: func.tags,
-                deprecated: func.deprecated
-            });
-        }
-        const subscriptions = [];
-        for (const [name, sub] of this.registry.subscriptions) {
-            subscriptions.push({
-                name,
-                description: sub.description,
-                input: sub.input,
-                output: sub.output
-            });
-        }
-        return {
-            plugin: this.registry.plugin,
-            functions,
-            subscriptions,
-            transports: [this.getMetadata()]
-        };
-    }
-}
-exports.HttpTransport = HttpTransport;
-/**
- * WebSocket Transport (placeholder for future implementation)
- */
-class WebSocketTransport {
-    constructor(config = {}) {
-        this.name = 'websocket';
-        this.config = config;
-    }
-    async initialize(registry, context) {
-        context.logger.info('WebSocket Transport initialized (not yet implemented)');
-    }
-    async start() {
-        // TODO: Implement WebSocket server
-    }
-    async stop() {
-        // TODO: Stop WebSocket server
-    }
-    getMetadata() {
-        return {
-            type: 'websocket',
-            endpoint: `ws://localhost:${this.config.port || 3001}${this.config.path || '/ws'}`
-        };
-    }
-}
-exports.WebSocketTransport = WebSocketTransport;
-/**
- * MCP Transport (placeholder for future implementation)
- */
-class MCPTransport {
-    constructor(config = {}) {
-        this.name = 'mcp';
-        this.config = config;
-    }
-    async initialize(registry, context) {
-        context.logger.info('MCP Transport initialized (not yet implemented)');
-    }
-    async start() {
-        // TODO: Register functions as MCP tools
-    }
-    async stop() {
-        // TODO: Cleanup MCP registration
-    }
-    getMetadata() {
-        return {
-            type: 'mcp',
-            name: this.config.name || 'plugin-mcp-server'
-        };
-    }
-}
-exports.MCPTransport = MCPTransport;