@adverant-nexus/cli 2.0.0

package/dist/core/discovery/openapi-parser.js

@@ -0,0 +1,353 @@
+/**
+ * OpenAPI Parser
+ *
+ * Fetches and parses OpenAPI 3.x schemas from service endpoints
+ * Generates command definitions from API operations
+ */
+import axios from 'axios';
+import { load as yamlLoad } from 'js-yaml';
+/**
+ * Fetch OpenAPI spec from service endpoint
+ */
+export async function fetchOpenAPISpec(url, options = {}) {
+    const { timeout = 5000, headers = {} } = options;
+    // Try common OpenAPI spec endpoints
+    const endpoints = [
+        url,
+        `${url}/openapi.json`,
+        `${url}/api-docs`,
+        `${url}/swagger.json`,
+        `${url}/v3/api-docs`
+    ];
+    for (const endpoint of endpoints) {
+        try {
+            const response = await axios.get(endpoint, {
+                timeout,
+                headers: {
+                    'Accept': 'application/json, application/yaml',
+                    ...headers
+                },
+                validateStatus: (status) => status < 500 // Accept 4xx as valid responses
+            });
+            if (response.status === 200) {
+                // Parse JSON or YAML
+                let spec;
+                if (typeof response.data === 'string') {
+                    // Try parsing as YAML first, then JSON
+                    try {
+                        spec = yamlLoad(response.data);
+                    }
+                    catch {
+                        spec = JSON.parse(response.data);
+                    }
+                }
+                else {
+                    spec = response.data;
+                }
+                // Validate it's an OpenAPI spec
+                if (spec.openapi && spec.paths) {
+                    return spec;
+                }
+            }
+        }
+        catch (error) {
+            // Try next endpoint
+            continue;
+        }
+    }
+    return null;
+}
+/**
+ * Parse OpenAPI spec and generate command definitions
+ */
+export async function parseOpenAPIToCommands(spec, namespace) {
+    const commands = [];
+    for (const [path, pathItem] of Object.entries(spec.paths)) {
+        for (const [method, operation] of Object.entries(pathItem)) {
+            if (!isHttpMethod(method))
+                continue;
+            const command = generateCommandFromOperation(path, method.toUpperCase(), operation, namespace);
+            if (command) {
+                commands.push(command);
+            }
+        }
+    }
+    return commands;
+}
+/**
+ * Generate a command definition from an OpenAPI operation
+ */
+function generateCommandFromOperation(path, method, operation, namespace) {
+    // Skip health/internal endpoints
+    if (path.includes('/health') || path.includes('/internal')) {
+        return null;
+    }
+    // Generate command name from path and operation
+    const commandName = generateCommandName(path, method, operation);
+    // Extract parameters
+    const params = extractParameters(operation);
+    // Determine if operation supports streaming
+    const streaming = operation['x-streaming'] === true ||
+        operation.description?.toLowerCase().includes('stream') ||
+        false;
+    // Generate examples
+    const examples = generateExamples(namespace, commandName, params);
+    return {
+        name: commandName,
+        namespace,
+        description: operation.summary || operation.description || `${method} ${path}`,
+        endpoint: path,
+        method,
+        params,
+        streaming,
+        examples
+    };
+}
+/**
+ * Generate command name from path and operation
+ */
+function generateCommandName(path, method, operation) {
+    // Use operationId if available
+    if (operation.operationId) {
+        return kebabCase(operation.operationId);
+    }
+    // Generate from path and method
+    // Example: POST /documents → store-document
+    // Example: GET /documents/{id} → get-document
+    // Example: DELETE /documents/{id} → delete-document
+    const pathParts = path
+        .split('/')
+        .filter(p => p && !p.startsWith('{'))
+        .map(p => p.replace(/[^a-zA-Z0-9]/g, ''));
+    const action = getActionFromMethod(method);
+    const resource = pathParts[pathParts.length - 1] || 'item';
+    return `${action}-${resource}`;
+}
+/**
+ * Get action verb from HTTP method
+ */
+function getActionFromMethod(method) {
+    const actions = {
+        'GET': 'get',
+        'POST': 'create',
+        'PUT': 'update',
+        'PATCH': 'update',
+        'DELETE': 'delete'
+    };
+    return actions[method.toUpperCase()] || 'execute';
+}
+/**
+ * Extract parameters from OpenAPI operation
+ */
+function extractParameters(operation) {
+    const params = [];
+    // Extract from parameters array
+    if (operation.parameters) {
+        for (const param of operation.parameters) {
+            params.push({
+                name: param.name,
+                type: mapOpenAPIType(param.schema.type),
+                required: param.required || false,
+                description: param.description || '',
+                default: param.schema.default,
+                enum: param.schema.enum,
+                format: param.schema.format
+            });
+        }
+    }
+    // Extract from request body
+    if (operation.requestBody) {
+        const content = operation.requestBody.content;
+        const jsonContent = content['application/json'];
+        if (jsonContent?.schema) {
+            const bodyParams = extractSchemaParameters(jsonContent.schema, operation.requestBody.required || false);
+            params.push(...bodyParams);
+        }
+    }
+    return params;
+}
+/**
+ * Extract parameters from JSON schema
+ */
+function extractSchemaParameters(schema, required = false) {
+    const params = [];
+    if (schema.type === 'object' && schema.properties) {
+        const requiredProps = new Set(schema.required || []);
+        for (const [name, propSchema] of Object.entries(schema.properties)) {
+            const prop = propSchema;
+            params.push({
+                name,
+                type: mapOpenAPIType(prop.type),
+                required: requiredProps.has(name),
+                description: prop.description || '',
+                default: prop.default,
+                enum: prop.enum,
+                format: prop.format
+            });
+        }
+    }
+    else if (schema.$ref) {
+        // TODO: Resolve $ref if needed
+        params.push({
+            name: 'body',
+            type: 'object',
+            required,
+            description: 'Request body',
+            format: 'json'
+        });
+    }
+    else {
+        // Simple type
+        params.push({
+            name: 'body',
+            type: mapOpenAPIType(schema.type),
+            required,
+            description: schema.description || 'Request body'
+        });
+    }
+    return params;
+}
+/**
+ * Map OpenAPI type to CLI parameter type
+ */
+function mapOpenAPIType(type) {
+    const typeMap = {
+        'string': 'string',
+        'number': 'number',
+        'integer': 'number',
+        'boolean': 'boolean',
+        'array': 'array',
+        'object': 'object',
+        'file': 'file'
+    };
+    return typeMap[type] || 'string';
+}
+/**
+ * Generate usage examples for command
+ */
+function generateExamples(namespace, commandName, params) {
+    const examples = [];
+    // Basic example
+    const requiredParams = params.filter(p => p.required);
+    if (requiredParams.length > 0) {
+        const paramStr = requiredParams
+            .map(p => {
+            if (p.type === 'boolean') {
+                return `--${p.name}`;
+            }
+            else if (p.type === 'file') {
+                return `--${p.name} /path/to/file`;
+            }
+            else if (p.enum && p.enum.length > 0) {
+                return `--${p.name} ${p.enum[0]}`;
+            }
+            else {
+                return `--${p.name} <value>`;
+            }
+        })
+            .join(' ');
+        examples.push(`nexus ${namespace} ${commandName} ${paramStr}`);
+    }
+    else {
+        examples.push(`nexus ${namespace} ${commandName}`);
+    }
+    // Example with optional params
+    const optionalParams = params.filter(p => !p.required);
+    if (optionalParams.length > 0 && optionalParams.length <= 2) {
+        const allParams = [...requiredParams, ...optionalParams.slice(0, 2)]
+            .map(p => {
+            if (p.type === 'boolean') {
+                return `--${p.name}`;
+            }
+            else if (p.default !== undefined) {
+                return `--${p.name} ${p.default}`;
+            }
+            else {
+                return `--${p.name} <value>`;
+            }
+        })
+            .join(' ');
+        examples.push(`nexus ${namespace} ${commandName} ${allParams}`);
+    }
+    // JSON output example
+    if (examples.length > 0) {
+        examples.push(`${examples[0]} --output-format json`);
+    }
+    return examples.slice(0, 3); // Max 3 examples
+}
+/**
+ * Check if string is a valid HTTP method
+ */
+function isHttpMethod(method) {
+    return ['get', 'post', 'put', 'delete', 'patch'].includes(method.toLowerCase());
+}
+/**
+ * Convert string to kebab-case
+ */
+function kebabCase(str) {
+    return str
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .replace(/[\s_]+/g, '-')
+        .toLowerCase();
+}
+/**
+ * Resolve $ref references in OpenAPI spec
+ */
+export function resolveRefs(spec, ref) {
+    // Example ref: "#/components/schemas/User"
+    const parts = ref.replace('#/', '').split('/');
+    let current = spec;
+    for (const part of parts) {
+        current = current[part];
+        if (!current)
+            return null;
+    }
+    return current;
+}
+/**
+ * Get all operations from OpenAPI spec
+ */
+export function getAllOperations(spec) {
+    const operations = [];
+    for (const [path, pathItem] of Object.entries(spec.paths)) {
+        for (const [method, operation] of Object.entries(pathItem)) {
+            if (isHttpMethod(method)) {
+                operations.push({
+                    path,
+                    method: method.toUpperCase(),
+                    operation: operation
+                });
+            }
+        }
+    }
+    return operations;
+}
+/**
+ * Get authentication requirements from OpenAPI spec
+ */
+export function getAuthRequirements(spec) {
+    const securitySchemes = spec.components?.securitySchemes;
+    if (!securitySchemes) {
+        return { type: 'none' };
+    }
+    // Get first security scheme
+    const [schemeName, scheme] = Object.entries(securitySchemes)[0] || [];
+    if (!scheme) {
+        return { type: 'none' };
+    }
+    if (scheme.type === 'apiKey') {
+        return {
+            type: 'apiKey',
+            location: scheme.in,
+            name: scheme.name
+        };
+    }
+    if (scheme.type === 'http' && scheme.scheme === 'bearer') {
+        return { type: 'bearer' };
+    }
+    if (scheme.type === 'oauth2') {
+        return { type: 'oauth2' };
+    }
+    return { type: 'none' };
+}
+//# sourceMappingURL=openapi-parser.js.map

package/dist/core/discovery/openapi-parser.js.map

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

package/dist/core/discovery/plugin-discovery.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Plugin Discovery
+ *
+ * Auto-discovers plugins from ~/.nexus/plugins/ directory
+ * Loads and validates plugin manifests
+ */
+import type { Plugin, PluginManifest, PluginCommand } from '../../types/plugin.js';
+export interface PluginDiscoveryOptions {
+    pluginDir?: string;
+    validateStructure?: boolean;
+    loadDisabled?: boolean;
+}
+/**
+ * Discover all plugins in plugin directory
+ */
+export declare function discoverPlugins(options?: PluginDiscoveryOptions): Promise<Plugin[]>;
+/**
+ * Load a single plugin from directory
+ */
+export declare function loadPlugin(pluginPath: string, validateStructure?: boolean): Promise<Plugin>;
+/**
+ * Load plugin.json manifest
+ */
+export declare function loadPluginManifest(manifestPath: string): Promise<PluginManifest>;
+/**
+ * Check plugin dependencies
+ */
+export declare function checkPluginDependencies(plugin: Plugin, availableServices: Set<string>): Promise<{
+    satisfied: boolean;
+    missing: string[];
+}>;
+/**
+ * Filter plugins by permission requirements
+ */
+export declare function filterPluginsByPermissions(plugins: Plugin[], allowedPermissions: Set<string>): Plugin[];
+/**
+ * Get plugin by name
+ */
+export declare function getPlugin(name: string, options?: PluginDiscoveryOptions): Promise<Plugin | null>;
+/**
+ * Get all plugin commands
+ */
+export declare function getPluginCommands(plugins: Plugin[]): Map<string, PluginCommand[]>;
+/**
+ * Search plugins by keyword
+ */
+export declare function searchPlugins(plugins: Plugin[], query: string): Plugin[];
+/**
+ * Group plugins by category
+ */
+export declare function groupPluginsByCategory(plugins: Plugin[]): Map<string, Plugin[]>;
+/**
+ * Get plugin statistics
+ */
+export declare function getPluginStats(plugins: Plugin[]): {
+    total: number;
+    enabled: number;
+    disabled: number;
+    totalCommands: number;
+    byCategory: Record<string, number>;
+    byPermission: Record<string, number>;
+};
+//# sourceMappingURL=plugin-discovery.d.ts.map

package/dist/core/discovery/plugin-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-discovery.d.ts","sourceRoot":"","sources":["../../../src/core/discovery/plugin-discovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEnF,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,MAAM,EAAE,CAAC,CA6CnB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,iBAAiB,GAAE,OAAc,GAChC,OAAO,CAAC,MAAM,CAAC,CAqBjB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAQtF;AAsJD;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC7B,OAAO,CAAC;IACT,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC,CAeD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EAAE,EACjB,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC9B,MAAM,EAAE,CAsBV;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAQjF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA0BxE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAc/E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC,CA0BA"}