@g1cloud/api-gen 1.0.0

package/dist/lib.js

@@ -0,0 +1,199 @@
+"use strict";
+/**
+ * Library entry point for programmatic API generation
+ * This module exports the core functionality for use by MCP server and other integrations
+ */
+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.generateOpenAPI = generateOpenAPI;
+exports.generateOpenAPIPerController = generateOpenAPIPerController;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+const javaParser_1 = require("./parser/javaParser");
+const controllerAnalyzer_1 = require("./analyzer/controllerAnalyzer");
+const openapiGenerator_1 = require("./generator/openapiGenerator");
+/**
+ * Generate OpenAPI specification from Spring Boot Java source code
+ * Returns a single combined spec for all controllers
+ */
+async function generateOpenAPI(options) {
+    const sources = options.source;
+    if (sources.length === 0) {
+        throw new Error('At least one source path is required');
+    }
+    // Validate source paths exist
+    for (const src of sources) {
+        const sourcePath = path.resolve(src);
+        if (!fs.existsSync(sourcePath)) {
+            throw new Error(`Source path does not exist: ${sourcePath}`);
+        }
+    }
+    // Parse Java files from all source directories
+    const javaClasses = new Map();
+    for (const src of sources) {
+        const sourcePath = path.resolve(src);
+        const classes = await (0, javaParser_1.parseJavaSource)(sourcePath);
+        for (const [name, cls] of classes) {
+            javaClasses.set(name, cls);
+        }
+    }
+    if (javaClasses.size === 0) {
+        throw new Error('No Java files found in the specified directories');
+    }
+    // Initialize processing context
+    const apiSourcePath = options.apiSource ? path.resolve(options.apiSource) : undefined;
+    const context = {
+        javaClasses,
+        controllers: [],
+        dtoSchemas: new Map(),
+        referencedTypes: new Set(),
+        apiSourcePath,
+    };
+    // Analyze controllers
+    const controllers = (0, controllerAnalyzer_1.analyzeControllers)(context);
+    context.controllers = controllers;
+    if (controllers.length === 0) {
+        throw new Error('No REST controllers found in the source files');
+    }
+    // Generate OpenAPI spec
+    const cliOptions = {
+        source: sources,
+        apiSource: options.apiSource,
+        title: options.title || 'API Documentation',
+        version: options.version || '1.0.0',
+        basePath: options.basePath,
+    };
+    const spec = (0, openapiGenerator_1.generateOpenAPISpec)(controllers, context, cliOptions);
+    // Convert to YAML
+    const yamlContent = yaml.dump(spec, {
+        indent: 2,
+        lineWidth: -1,
+        noRefs: true,
+        sortKeys: false,
+    });
+    const totalEndpoints = controllers.reduce((sum, c) => sum + c.endpoints.length, 0);
+    return {
+        spec,
+        yaml: yamlContent,
+        summary: {
+            controllerCount: controllers.length,
+            endpointCount: totalEndpoints,
+            schemaCount: Object.keys(spec.components.schemas).length,
+            controllers: controllers.map(c => ({
+                name: c.className,
+                endpointCount: c.endpoints.length,
+            })),
+        },
+    };
+}
+/**
+ * Generate separate OpenAPI specifications per controller
+ */
+async function generateOpenAPIPerController(options) {
+    const sources = options.source;
+    if (sources.length === 0) {
+        throw new Error('At least one source path is required');
+    }
+    // Validate source paths exist
+    for (const src of sources) {
+        const sourcePath = path.resolve(src);
+        if (!fs.existsSync(sourcePath)) {
+            throw new Error(`Source path does not exist: ${sourcePath}`);
+        }
+    }
+    // Parse Java files from all source directories
+    const javaClasses = new Map();
+    for (const src of sources) {
+        const sourcePath = path.resolve(src);
+        const classes = await (0, javaParser_1.parseJavaSource)(sourcePath);
+        for (const [name, cls] of classes) {
+            javaClasses.set(name, cls);
+        }
+    }
+    if (javaClasses.size === 0) {
+        throw new Error('No Java files found in the specified directories');
+    }
+    // Initialize processing context
+    const apiSourcePath = options.apiSource ? path.resolve(options.apiSource) : undefined;
+    const context = {
+        javaClasses,
+        controllers: [],
+        dtoSchemas: new Map(),
+        referencedTypes: new Set(),
+        apiSourcePath,
+    };
+    // Analyze controllers
+    const controllers = (0, controllerAnalyzer_1.analyzeControllers)(context);
+    context.controllers = controllers;
+    if (controllers.length === 0) {
+        throw new Error('No REST controllers found in the source files');
+    }
+    // Generate OpenAPI specs per controller
+    const cliOptions = {
+        source: sources,
+        apiSource: options.apiSource,
+        title: options.title || 'API Documentation',
+        version: options.version || '1.0.0',
+        basePath: options.basePath,
+    };
+    const specs = new Map();
+    const controllerSummaries = [];
+    for (const controller of controllers) {
+        const spec = (0, openapiGenerator_1.generateOpenAPISpecForController)(controller, context, cliOptions);
+        const yamlContent = yaml.dump(spec, {
+            indent: 2,
+            lineWidth: -1,
+            noRefs: true,
+            sortKeys: false,
+        });
+        specs.set(controller.className, { spec, yaml: yamlContent });
+        controllerSummaries.push({
+            name: controller.className,
+            endpointCount: controller.endpoints.length,
+            schemaCount: Object.keys(spec.components.schemas).length,
+        });
+    }
+    const totalEndpoints = controllers.reduce((sum, c) => sum + c.endpoints.length, 0);
+    return {
+        specs,
+        summary: {
+            controllerCount: controllers.length,
+            totalEndpointCount: totalEndpoints,
+            controllers: controllerSummaries,
+        },
+    };
+}
+//# sourceMappingURL=lib.js.map

package/dist/lib.js.map

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

package/dist/mcp-server.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * MCP Server for Spring Boot to OpenAPI generation
+ *
+ * This server exposes the API generation functionality as MCP tools
+ * that can be called by AI assistants.
+ */
+export {};
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}

package/dist/mcp-server.js

@@ -0,0 +1,257 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * MCP Server for Spring Boot to OpenAPI generation
+ *
+ * This server exposes the API generation functionality as MCP tools
+ * that can be called by AI assistants.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const lib_1 = require("./lib");
+// Create MCP server
+const server = new index_js_1.Server({
+    name: 'spring-to-openapi',
+    version: '1.0.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Define tool schemas
+const tools = [
+    {
+        name: 'generate-openapi',
+        description: 'Generate OpenAPI v3 YAML specification from Spring Boot Java source code. Returns a single combined spec for all REST controllers found.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                source: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Java source code directory path(s) to parse',
+                },
+                apiSource: {
+                    type: 'string',
+                    description: 'Optional: specific directory to search for RestControllers (defaults to first source)',
+                },
+                title: {
+                    type: 'string',
+                    description: 'API title (default: "API Documentation")',
+                },
+                version: {
+                    type: 'string',
+                    description: 'API version (default: "1.0.0")',
+                },
+                basePath: {
+                    type: 'string',
+                    description: 'API base path (e.g., "/api/v1")',
+                },
+            },
+            required: ['source'],
+        },
+    },
+    {
+        name: 'generate-openapi-per-controller',
+        description: 'Generate separate OpenAPI v3 YAML specifications for each REST controller. Useful when you need individual API docs per controller.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                source: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Java source code directory path(s) to parse',
+                },
+                apiSource: {
+                    type: 'string',
+                    description: 'Optional: specific directory to search for RestControllers',
+                },
+                title: {
+                    type: 'string',
+                    description: 'API title prefix',
+                },
+                version: {
+                    type: 'string',
+                    description: 'API version (default: "1.0.0")',
+                },
+                basePath: {
+                    type: 'string',
+                    description: 'API base path',
+                },
+                controllerName: {
+                    type: 'string',
+                    description: 'Optional: only generate for specific controller name',
+                },
+            },
+            required: ['source'],
+        },
+    },
+    {
+        name: 'list-controllers',
+        description: 'List all REST controllers found in the Spring Boot source code without generating full specs. Useful for exploring the codebase first.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                source: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Java source code directory path(s) to parse',
+                },
+                apiSource: {
+                    type: 'string',
+                    description: 'Optional: specific directory to search for RestControllers',
+                },
+            },
+            required: ['source'],
+        },
+    },
+];
+// Register tools list handler
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+    return { tools };
+});
+// Register tool call handler
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case 'generate-openapi': {
+                const { source, apiSource, title, version, basePath } = args;
+                const result = await (0, lib_1.generateOpenAPI)({
+                    source,
+                    apiSource,
+                    title,
+                    version,
+                    basePath,
+                });
+                const summaryText = [
+                    '## Generation Summary',
+                    `- Controllers: ${result.summary.controllerCount}`,
+                    `- Endpoints: ${result.summary.endpointCount}`,
+                    `- Schemas: ${result.summary.schemaCount}`,
+                    '',
+                    '### Controllers:',
+                    ...result.summary.controllers.map((c) => `- ${c.name}: ${c.endpointCount} endpoint(s)`),
+                    '',
+                    '---',
+                    '',
+                    '## OpenAPI Specification (YAML)',
+                    '',
+                    '```yaml',
+                    result.yaml,
+                    '```',
+                ].join('\n');
+                return {
+                    content: [{ type: 'text', text: summaryText }],
+                };
+            }
+            case 'generate-openapi-per-controller': {
+                const { source, apiSource, title, version, basePath, controllerName } = args;
+                const result = await (0, lib_1.generateOpenAPIPerController)({
+                    source,
+                    apiSource,
+                    title,
+                    version,
+                    basePath,
+                });
+                if (controllerName) {
+                    const spec = result.specs.get(controllerName);
+                    if (!spec) {
+                        const available = Array.from(result.specs.keys()).join(', ');
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: `Controller "${controllerName}" not found. Available controllers: ${available}`,
+                                },
+                            ],
+                            isError: true,
+                        };
+                    }
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: [
+                                    `## OpenAPI Specification for ${controllerName}`,
+                                    '',
+                                    '```yaml',
+                                    spec.yaml,
+                                    '```',
+                                ].join('\n'),
+                            },
+                        ],
+                    };
+                }
+                const parts = [
+                    '## Generation Summary',
+                    `- Total Controllers: ${result.summary.controllerCount}`,
+                    `- Total Endpoints: ${result.summary.totalEndpointCount}`,
+                    '',
+                    '### Controllers:',
+                    ...result.summary.controllers.map((c) => `- ${c.name}: ${c.endpointCount} endpoint(s), ${c.schemaCount} schema(s)`),
+                    '',
+                    '---',
+                    '',
+                ];
+                for (const [specName, spec] of result.specs) {
+                    parts.push(`## ${specName}`);
+                    parts.push('');
+                    parts.push('```yaml');
+                    parts.push(spec.yaml);
+                    parts.push('```');
+                    parts.push('');
+                }
+                return {
+                    content: [{ type: 'text', text: parts.join('\n') }],
+                };
+            }
+            case 'list-controllers': {
+                const { source, apiSource } = args;
+                const result = await (0, lib_1.generateOpenAPI)({
+                    source,
+                    apiSource,
+                });
+                const parts = [
+                    '## REST Controllers Found',
+                    '',
+                    `Total: ${result.summary.controllerCount} controller(s) with ${result.summary.endpointCount} endpoint(s)`,
+                    '',
+                ];
+                for (const controller of result.summary.controllers) {
+                    parts.push(`### ${controller.name}`);
+                    parts.push(`- Endpoints: ${controller.endpointCount}`);
+                    parts.push('');
+                }
+                return {
+                    content: [{ type: 'text', text: parts.join('\n') }],
+                };
+            }
+            default:
+                return {
+                    content: [{ type: 'text', text: `Unknown tool: ${name}` }],
+                    isError: true,
+                };
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// Start the server
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error('Spring-to-OpenAPI MCP Server running on stdio');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

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