@majkapp/plugin-kit 1.0.17 → 1.1.0

package/dist/generator/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/generator/cli.ts"],"names":[],"mappings":""}

package/dist/generator/cli.js

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+"use strict";
+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 });
+const commander_1 = require("commander");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const child_process_1 = require("child_process");
+const generator_1 = require("./generator");
+commander_1.program
+    .name('plugin-kit')
+    .version('1.0.20')
+    .description('Plugin Kit CLI - Generate TypeScript clients from plugin definitions');
+commander_1.program
+    .command('generate')
+    .description('Generate a TypeScript client from a plugin definition')
+    .option('-e, --entry <path>', 'Path to the compiled plugin entry file', './index.js')
+    .option('-o, --output <path>', 'Output directory for generated client', './ui/src/generated')
+    .option('-w, --watch', 'Watch for changes and regenerate', false)
+    .action(async (options) => {
+    const entryPath = path.resolve(options.entry);
+    const outputPath = path.resolve(options.output);
+    const logPath = path.join(outputPath, 'generation.log');
+    // Ensure output directory exists
+    fs.mkdirSync(outputPath, { recursive: true });
+    const generate = async () => {
+        const startTime = Date.now();
+        const log = [];
+        log.push(`=== Plugin Kit Client Generation ===`);
+        log.push(`Time: ${new Date().toISOString()}`);
+        log.push(`Entry: ${entryPath}`);
+        log.push(`Output: ${outputPath}`);
+        log.push(``);
+        try {
+            // Check if entry file exists
+            if (!fs.existsSync(entryPath)) {
+                throw new Error(`Entry file not found: ${entryPath}`);
+            }
+            log.push(`✓ Found entry file`);
+            // Extract metadata from plugin
+            const metadata = await extractMetadata(entryPath);
+            log.push(`✓ Extracted metadata from plugin: ${metadata.name} v${metadata.version}`);
+            log.push(`  - ${metadata.functions.length} functions`);
+            log.push(`  - ${metadata.screens.length} screens`);
+            log.push(`  - ${metadata.tools.length} tools`);
+            log.push(``);
+            // Generate client files
+            const result = await (0, generator_1.generateClient)(metadata, outputPath, log);
+            const duration = Date.now() - startTime;
+            log.push(``);
+            log.push(`✓ Generation completed in ${duration}ms`);
+            if (result.warnings.length > 0) {
+                log.push(``);
+                log.push(`⚠ Warnings:`);
+                result.warnings.forEach(w => log.push(`  - ${w}`));
+            }
+            // Write log file (overwrite each time)
+            fs.writeFileSync(logPath, log.join('\n'), 'utf-8');
+            console.log(`✅ Client generated successfully in ${duration}ms`);
+            console.log(`   Output: ${outputPath}`);
+            console.log(`   Files: ${result.files.join(', ')}`);
+            if (result.warnings.length > 0) {
+                console.log(`   ⚠ ${result.warnings.length} warnings (see generation.log)`);
+            }
+        }
+        catch (error) {
+            log.push(`✗ Error: ${error.message}`);
+            log.push(error.stack || '');
+            fs.writeFileSync(logPath, log.join('\n'), 'utf-8');
+            console.error(`❌ Generation failed: ${error.message}`);
+            console.error(`   See ${logPath} for details`);
+            if (!options.watch) {
+                process.exit(1);
+            }
+        }
+    };
+    if (options.watch) {
+        console.log(`👁 Watching for changes...`);
+        // Initial generation
+        await generate();
+        // Watch for changes
+        let timeout;
+        fs.watch(entryPath, () => {
+            clearTimeout(timeout);
+            timeout = setTimeout(() => {
+                console.log(`🔄 Changes detected, regenerating...`);
+                generate();
+            }, 500);
+        });
+        // Keep process alive
+        process.stdin.resume();
+    }
+    else {
+        await generate();
+    }
+});
+commander_1.program.parse();
+async function extractMetadata(entryPath) {
+    // Create a temp file for the output
+    const tempFile = path.join(path.dirname(entryPath), `.plugin-metadata-${Date.now()}.json`);
+    try {
+        // Run the plugin in extract mode with file output
+        (0, child_process_1.execSync)(`node "${entryPath}"`, {
+            env: {
+                ...process.env,
+                PLUGIN_KIT_MODE: 'extract',
+                PLUGIN_KIT_OUTPUT: tempFile
+            },
+            cwd: path.dirname(entryPath),
+            stdio: 'inherit' // Let the plugin print its own messages
+        });
+        // Read the generated file
+        if (!fs.existsSync(tempFile)) {
+            throw new Error('Metadata file was not created');
+        }
+        const content = fs.readFileSync(tempFile, 'utf-8');
+        const metadata = JSON.parse(content);
+        // Clean up temp file
+        fs.unlinkSync(tempFile);
+        return metadata;
+    }
+    catch (error) {
+        // Clean up temp file if it exists
+        if (fs.existsSync(tempFile)) {
+            fs.unlinkSync(tempFile);
+        }
+        throw new Error(`Failed to extract metadata: ${error.message}`);
+    }
+}

package/dist/generator/generator.d.ts

@@ -0,0 +1,6 @@
+export interface GenerationResult {
+    files: string[];
+    warnings: string[];
+}
+export declare function generateClient(metadata: any, outputPath: string, log: string[]): Promise<GenerationResult>;
+//# sourceMappingURL=generator.d.ts.map

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

@@ -0,0 +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"}

package/dist/generator/generator.js

@@ -0,0 +1,389 @@
+"use strict";
+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.generateClient = generateClient;
+const fs = __importStar(require("fs"));
+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');
+        files.push(filename);
+        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);
+    }
+    catch (error) {
+        warnings.push(`Partial generation error: ${error.message}`);
+        log.push(`  ⚠ Partial generation error: ${error.message}`);
+    }
+    return { files, warnings };
+}
+function generateTypes(metadata, warnings, log) {
+    const lines = [];
+    lines.push(`/**
+ * Auto-generated TypeScript types for ${metadata.name}
+ * Generated at: ${new Date().toISOString()}
+ * Plugin version: ${metadata.version}
+ */
+
+`);
+    // 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`);
+                }
+                else {
+                    lines.push(`export interface ${outputTypeName} ${schemaToTypeScript(func.output, 0)}\n`);
+                }
+                processedTypes.add(outputTypeName);
+            }
+        }
+        catch (error) {
+            warnings.push(`Failed to generate types for ${func.name}: ${error.message}`);
+        }
+    });
+    // Standard response types
+    lines.push(`
+export interface SuccessResponse<T> {
+  success: true;
+  data: T;
+}
+
+export interface ErrorResponse {
+  success: false;
+  error: string;
+  details?: any[];
+}
+
+export type ApiResponse<T> = SuccessResponse<T> | ErrorResponse;
+`);
+    return lines.join('\n');
+}
+function generateClientClass(metadata, warnings, log) {
+    const lines = [];
+    lines.push(`/**
+ * Auto-generated client for ${metadata.name}
+ * Generated at: ${new Date().toISOString()}
+ * Plugin version: ${metadata.version}
+ */
+
+import type {
+${metadata.functions.map((f) => `  ${capitalize(f.name)}Input,
+  ${capitalize(f.name)}Output`).join(',\n')}
+} from './types';
+
+export class ${capitalize(toCamelCase(metadata.id))}Client {
+  constructor(private baseUrl: string = '') {}
+
+  private async request<TInput, TOutput>(
+    functionName: string,
+    input: TInput
+  ): Promise<TOutput> {
+    try {
+      const response = await fetch(\`\${this.baseUrl}/api/fn/\${functionName}\`, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(input),
+      });
+
+      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);
+      throw error;
+    }
+  }
+`);
+    // Generate methods for each function
+    metadata.functions.forEach((func) => {
+        try {
+            const methodName = toCamelCase(func.name);
+            const inputType = `${capitalize(func.name)}Input`;
+            const outputType = `${capitalize(func.name)}Output`;
+            lines.push(`
+  /**
+   * ${func.description}${func.deprecated ? '\n   * @deprecated' : ''}
+   */
+  async ${methodName}(input: ${inputType} = {}): Promise<${outputType}> {
+    return this.request<${inputType}, ${outputType}>('${func.name}', input);
+  }
+`);
+        }
+        catch (error) {
+            warnings.push(`Failed to generate method for ${func.name}: ${error.message}`);
+        }
+    });
+    lines.push(`}
+
+// Default singleton instance
+export const ${toCamelCase(metadata.id)}Client = new ${capitalize(toCamelCase(metadata.id))}Client();
+`);
+    return lines.join('');
+}
+function generateReactHooks(metadata, warnings, log) {
+    const lines = [];
+    lines.push(`/**
+ * Auto-generated React hooks for ${metadata.name}
+ * Generated at: ${new Date().toISOString()}
+ * Plugin version: ${metadata.version}
+ */
+
+import { useState, useEffect, useCallback } from 'react';
+import { ${toCamelCase(metadata.id)}Client } from './client';
+import type {
+${metadata.functions.map((f) => `  ${capitalize(f.name)}Input,
+  ${capitalize(f.name)}Output`).join(',\n')}
+} from './types';
+
+export interface UseQueryResult<T> {
+  data: T | undefined;
+  error: Error | undefined;
+  loading: boolean;
+  refetch: () => void;
+}
+
+export interface UseMutationResult<TInput, TOutput> {
+  mutate: (input: TInput) => Promise<TOutput>;
+  data: TOutput | undefined;
+  error: Error | undefined;
+  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) {
+                lines.push(`
+/**
+ * React hook for ${func.description}
+ */
+export function ${hookName}(
+  input: ${inputType} = {},
+  options?: { enabled?: boolean; refetchInterval?: number }
+): UseQueryResult<${outputType}> {
+  const [data, setData] = useState<${outputType} | undefined>();
+  const [error, setError] = useState<Error | undefined>();
+  const [loading, setLoading] = useState(false);
+
+  const fetch = useCallback(async () => {
+    if (options?.enabled === false) return;
+
+    setLoading(true);
+    setError(undefined);
+
+    try {
+      const result = await ${toCamelCase(metadata.id)}Client.${toCamelCase(func.name)}(input);
+      setData(result);
+    } catch (err: any) {
+      setError(err);
+    } finally {
+      setLoading(false);
+    }
+  }, [JSON.stringify(input), options?.enabled]);
+
+  useEffect(() => {
+    fetch();
+
+    if (options?.refetchInterval) {
+      const interval = setInterval(fetch, options.refetchInterval);
+      return () => clearInterval(interval);
+    }
+  }, [fetch, options?.refetchInterval]);
+
+  return { data, error, loading, refetch: fetch };
+}
+`);
+            }
+            else {
+                lines.push(`
+/**
+ * React hook for ${func.description}
+ */
+export function ${hookName}(): UseMutationResult<${inputType}, ${outputType}> {
+  const [data, setData] = useState<${outputType} | undefined>();
+  const [error, setError] = useState<Error | undefined>();
+  const [loading, setLoading] = useState(false);
+
+  const mutate = useCallback(async (input: ${inputType}): Promise<${outputType}> => {
+    setLoading(true);
+    setError(undefined);
+
+    try {
+      const result = await ${toCamelCase(metadata.id)}Client.${toCamelCase(func.name)}(input);
+      setData(result);
+      return result;
+    } catch (err: any) {
+      setError(err);
+      throw err;
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  return { mutate, data, error, loading };
+}
+`);
+            }
+        }
+        catch (error) {
+            warnings.push(`Failed to generate hook for ${func.name}: ${error.message}`);
+        }
+    });
+    return lines.join('');
+}
+function generateIndex() {
+    return `/**
+ * Auto-generated client exports
+ * Generated at: ${new Date().toISOString()}
+ */
+
+export * from './types';
+export * from './client';
+export * from './hooks';
+`;
+}
+// Helper functions
+function schemaToTypeScript(schema, indent) {
+    if (!schema)
+        return 'any';
+    const spaces = '  '.repeat(indent);
+    if (schema.type === 'object') {
+        const props = schema.properties || {};
+        const required = schema.required || [];
+        const lines = ['{'];
+        Object.entries(props).forEach(([key, prop]) => {
+            const optional = !required.includes(key) ? '?' : '';
+            const type = schemaToTypeScript(prop, indent + 1);
+            const description = prop.description ? `\n${spaces}  /** ${prop.description} */\n${spaces}  ` : '\n' + spaces + '  ';
+            lines.push(`${description}${key}${optional}: ${type};`);
+        });
+        if (Object.keys(props).length === 0) {
+            lines.push(`${spaces}  [key: string]: any;`);
+        }
+        lines.push(spaces + '}');
+        return lines.join('');
+    }
+    if (schema.type === 'array') {
+        return `${schemaToTypeScript(schema.items, indent)}[]`;
+    }
+    if (schema.type === 'string') {
+        if (schema.enum) {
+            return schema.enum.map((e) => `'${e}'`).join(' | ');
+        }
+        return 'string';
+    }
+    if (schema.type === 'number' || schema.type === 'integer') {
+        return 'number';
+    }
+    if (schema.type === 'boolean') {
+        return 'boolean';
+    }
+    if (schema.type === 'null') {
+        return 'null';
+    }
+    // Handle union types
+    if (Array.isArray(schema.type)) {
+        return schema.type.map((t) => {
+            if (t === 'null')
+                return 'null';
+            if (t === 'string')
+                return 'string';
+            if (t === 'number' || t === 'integer')
+                return 'number';
+            if (t === 'boolean')
+                return 'boolean';
+            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(' | ');
+    }
+    return 'any';
+}
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+function toCamelCase(str) {
+    return str.replace(/-([a-z])/g, (g) => g[1].toUpperCase());
+}

package/dist/index.d.ts

@@ -12,5 +12,8 @@
  * - Lifecycle hooks with cleanup management
  */
 export { definePlugin, FluentBuilder } from './plugin-kit';
-export type { PluginContext, PluginLogger, PluginStorage, ScopedTimers, ScopedIpcRegistry, PluginCapabilities, PluginCapability, ToolImplementation, InProcessPlugin, PluginHealthStatus, ToolSpec, ToolHandler, ApiMethod, ApiRouteDef, RouteHandler, RequestLike, ResponseLike, UiConfig, HistoryMode, ScreenBase, ReactScreen, HtmlScreen, ConfigWizardDef, SettingsDef, Scope, EntityType, CleanupFn, HealthCheckFn, MCPServerEntity, TeamMemberEntity } from './types';
+export { HttpTransport, WebSocketTransport, MCPTransport } from './transports';
+export { FunctionRegistryImpl } from './registry';
+export { generateClient } from './generator/generator';
+export type { PluginContext, PluginLogger, PluginStorage, ScopedTimers, ScopedIpcRegistry, PluginCapabilities, PluginCapability, ToolImplementation, InProcessPlugin, PluginHealthStatus, ToolSpec, ToolHandler, ApiMethod, ApiRouteDef, JsonSchema, RouteHandler, RequestLike, ResponseLike, UiConfig, HistoryMode, ScreenBase, ReactScreen, HtmlScreen, ConfigWizardDef, SettingsDef, Scope, EntityType, CleanupFn, HealthCheckFn, MCPServerEntity, TeamMemberEntity, FunctionHandler, SubscriptionHandler, FunctionDefinition, SubscriptionDefinition, Transport, TransportMetadata, FunctionRegistry, ClientGenerationConfig } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE3D,YAAY,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,QAAQ,EACR,WAAW,EACX,SAAS,EACT,WAAW,EACX,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,EACV,eAAe,EACf,WAAW,EACX,KAAK,EACL,UAAU,EACV,SAAS,EACT,aAAa,EACb,eAAe,EACf,gBAAgB,EACjB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,YAAY,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,QAAQ,EACR,WAAW,EACX,SAAS,EACT,WAAW,EACX,UAAU,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,EACV,eAAe,EACf,WAAW,EACX,KAAK,EACL,UAAU,EACV,SAAS,EACT,aAAa,EACb,eAAe,EACf,gBAAgB,EAEhB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -13,6 +13,14 @@
  * - Lifecycle hooks with cleanup management
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.definePlugin = void 0;
+exports.generateClient = exports.FunctionRegistryImpl = exports.MCPTransport = exports.WebSocketTransport = exports.HttpTransport = exports.definePlugin = void 0;
 var plugin_kit_1 = require("./plugin-kit");
 Object.defineProperty(exports, "definePlugin", { enumerable: true, get: function () { return plugin_kit_1.definePlugin; } });
+var transports_1 = require("./transports");
+Object.defineProperty(exports, "HttpTransport", { enumerable: true, get: function () { return transports_1.HttpTransport; } });
+Object.defineProperty(exports, "WebSocketTransport", { enumerable: true, get: function () { return transports_1.WebSocketTransport; } });
+Object.defineProperty(exports, "MCPTransport", { enumerable: true, get: function () { return transports_1.MCPTransport; } });
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "FunctionRegistryImpl", { enumerable: true, get: function () { return registry_1.FunctionRegistryImpl; } });
+var generator_1 = require("./generator/generator");
+Object.defineProperty(exports, "generateClient", { enumerable: true, get: function () { return generator_1.generateClient; } });

package/dist/plugin-kit.d.ts

@@ -1,4 +1,4 @@
-import { PluginContext, InProcessPlugin, ToolSpec, ToolHandler, ApiRouteDef, UiConfig, ReactScreen, HtmlScreen, ConfigWizardDef, SettingsDef, Scope, EntityType, CleanupFn, HealthCheckFn, MCPServerEntity, TeamMemberEntity, MenuItemDeclaration } from './types';
+import { PluginContext, InProcessPlugin, ToolSpec, ToolHandler, ApiRouteDef, JsonSchema, UiConfig, ReactScreen, HtmlScreen, ConfigWizardDef, SettingsDef, Scope, EntityType, CleanupFn, HealthCheckFn, MCPServerEntity, TeamMemberEntity, MenuItemDeclaration, FunctionHandler, SubscriptionHandler, Transport, ClientGenerationConfig } from './types';
 /**
  * Fluent Builder Interface
  */
@@ -17,8 +17,28 @@ export interface FluentBuilder<Id extends string> {
     screenReact(screen: ReactScreen<Id>): this;
     /** Add an HTML screen */
     screenHtml(screen: HtmlScreen<Id>): this;
-    /** Add an API route */
+    /** Add an API route (legacy) */
     apiRoute(route: ApiRouteDef): this;
+    /** Add a function with JSON Schema (new function-first API) */
+    function(name: string, config: {
+        description: string;
+        input: JsonSchema;
+        output: JsonSchema;
+        handler: FunctionHandler;
+        tags?: string[];
+        deprecated?: boolean;
+    }): this;
+    /** Add a subscription for real-time updates */
+    subscription(name: string, config: {
+        description: string;
+        input: JsonSchema;
+        output: JsonSchema;
+        handler: SubscriptionHandler;
+    }): this;
+    /** Configure transports */
+    transport(transport: Transport): this;
+    /** Configure client generation */
+    generateClient(config: ClientGenerationConfig): this;
     /** Add a tool */
     tool(scope: Scope, spec: ToolSpec, handler: ToolHandler): this;
     /** Declare entities that this plugin provides (generic, untyped) */
@@ -27,6 +47,12 @@ export interface FluentBuilder<Id extends string> {
     mcpServer(servers: MCPServerEntity[]): this;
     /** Add team member entities with full TypeScript validation */
     teamMember(members: TeamMemberEntity[]): this;
+    /** Add configurable entities that are only registered after plugin config exists */
+    configurableEntity(entityType: EntityType, factory: (config: any) => any[]): this;
+    /** Add configurable MCP servers (only registered after config exists) */
+    configurableMcp(factory: (config: any) => MCPServerEntity[]): this;
+    /** Add configurable team members (only registered after config exists) */
+    configurableTeamMember(factory: (config: any) => TeamMemberEntity[]): this;
     /** Add config wizard */
     configWizard(def: ConfigWizardDef): this;
     /** Add settings screen */

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

@@ -1 +1 @@
-{"version":3,"file":"plugin-kit.d.ts","sourceRoot":"","sources":["../src/plugin-kit.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,aAAa,EAGb,eAAe,EACf,QAAQ,EACR,WAAW,EACX,WAAW,EACX,QAAQ,EACR,WAAW,EACX,UAAU,EACV,eAAe,EACf,WAAW,EACX,KAAK,EACL,UAAU,EACV,SAAS,EACT,aAAa,EAIb,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAmtBjB;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,EAAE,SAAS,MAAM;IAC9C,mDAAmD;IACnD,MAAM,CAAC,KAAK,EAAE,mBAAmB,EAAE,IAAI,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAE7G,0CAA0C;IAC1C,UAAU,CAAC,KAAK,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAAC;IAE/C,0CAA0C;IAC1C,EAAE,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAE5B,yBAAyB;IACzB,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IAE3C,yBAAyB;IACzB,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IAEzC,uBAAuB;IACvB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAEnC,iBAAiB;IACjB,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAE/D,oEAAoE;IACpE,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAEtD,8DAA8D;IAC9D,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IAE5C,+DAA+D;IAC/D,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;IAE9C,wBAAwB;IACxB,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,CAAC;IAEzC,0BAA0B;IAC1B,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IAEjC,sCAAsC;IACtC,OAAO,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAElG,0BAA0B;IAC1B,MAAM,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI,CAAC;IAEhC;;;;;;;;;;OAUG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,uBAAuB;IACvB,KAAK,IAAI,eAAe,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAClD,EAAE,EAAE,EAAE,EACN,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,aAAa,CAAC,EAAE,CAAC,CA+YnB"}
+{"version":3,"file":"plugin-kit.d.ts","sourceRoot":"","sources":["../src/plugin-kit.ts"],"names":[],"mappings":"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"}