@lark-apaas/coding-preset-vite-react 1.0.13-alpha.13 → 1.0.13-alpha.3

package/lib/server-log/openapi/services.js

@@ -0,0 +1,276 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enhanceOpenApiWithSourceInfo = enhanceOpenApiWithSourceInfo;
+exports.parseApiRoutes = parseApiRoutes;
+const node_fs_1 = require("node:fs");
+const fsSync = __importStar(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const typescript_1 = __importDefault(require("typescript"));
+const utils_1 = require("./utils");
+/**
+ * Enhances OpenAPI JSON with source file location metadata
+ * Can be called programmatically or run as a script
+ */
+async function enhanceOpenApiWithSourceInfo(options = {}) {
+    const startTime = Date.now();
+    const openapiPath = options.openapiPath || node_path_1.default.resolve(__dirname, '../client/src/api/gen/openapi.json');
+    const serverDir = options.serverDir || node_path_1.default.resolve(__dirname, '../server');
+    const writeFile = options.writeFile !== false;
+    let openapi;
+    if (options.openapiData) {
+        // Use provided data (for in-memory enhancement)
+        openapi = JSON.parse(JSON.stringify(options.openapiData)); // Deep clone
+    }
+    else {
+        // Read from file
+        const openapiContent = await node_fs_1.promises.readFile(openapiPath, 'utf-8');
+        openapi = JSON.parse(openapiContent);
+    }
+    const controllerFiles = await (0, utils_1.findControllerFiles)(serverDir);
+    const sourceMap = await (0, utils_1.buildSourceMap)(controllerFiles, processControllerFile);
+    const enhanced = (0, utils_1.enhanceOpenApiPaths)(openapi, sourceMap);
+    if (writeFile) {
+        await node_fs_1.promises.writeFile(openapiPath, JSON.stringify(openapi, null, 2) + '\n', 'utf-8');
+    }
+    const duration = Date.now() - startTime;
+    return {
+        openapi,
+        stats: {
+            duration,
+            controllersFound: controllerFiles.length,
+            endpointsExtracted: sourceMap.size,
+            endpointsEnhanced: enhanced,
+        },
+    };
+}
+/**
+ * Process a single controller file
+ */
+async function processControllerFile(filePath) {
+    const relativePath = node_path_1.default.relative(process.cwd(), filePath);
+    // Parse file
+    const content = await node_fs_1.promises.readFile(filePath, 'utf-8');
+    const sourceFile = typescript_1.default.createSourceFile(filePath, content, typescript_1.default.ScriptTarget.Latest, true);
+    return extractControllerMetadata(sourceFile, relativePath);
+}
+/**
+ * Extract controller metadata from TypeScript source file
+ */
+function extractControllerMetadata(sourceFile, filePath) {
+    const metadata = new Map();
+    let controllerPath = '';
+    let className = '';
+    // Helper function to get decorators from both old and new TypeScript APIs
+    function getDecorators(node) {
+        // TypeScript 5.x: decorators are in modifiers array
+        if ('modifiers' in node && Array.isArray(node.modifiers)) {
+            return node.modifiers.filter((mod) => mod.kind === typescript_1.default.SyntaxKind.Decorator);
+        }
+        // TypeScript 4.x: decorators are in decorators array
+        if ('decorators' in node && Array.isArray(node.decorators)) {
+            return node.decorators;
+        }
+        return [];
+    }
+    function visit(node) {
+        // Extract @Controller decorator and its path
+        if (typescript_1.default.isClassDeclaration(node)) {
+            const decorators = getDecorators(node);
+            // Extract class name
+            if (node.name) {
+                className = node.name.getText(sourceFile);
+            }
+            for (const decorator of decorators) {
+                if (typescript_1.default.isCallExpression(decorator.expression)) {
+                    const expression = decorator.expression;
+                    const decoratorName = expression.expression.getText(sourceFile);
+                    if (decoratorName === 'Controller') {
+                        if (expression.arguments.length > 0) {
+                            const arg = expression.arguments[0];
+                            if (typescript_1.default.isStringLiteral(arg)) {
+                                controllerPath = arg.text;
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        // Extract methods with HTTP decorators
+        if (typescript_1.default.isMethodDeclaration(node) && node.name) {
+            const methodName = node.name.getText(sourceFile);
+            let httpMethod = '';
+            let routePath = '';
+            const { line } = sourceFile.getLineAndCharacterOfPosition(node.getStart(sourceFile));
+            const decorators = getDecorators(node);
+            for (const decorator of decorators) {
+                if (typescript_1.default.isCallExpression(decorator.expression)) {
+                    const decoratorName = decorator.expression.expression.getText(sourceFile);
+                    if (['Get', 'Post', 'Put', 'Delete', 'Patch', 'Options', 'Head', 'All'].includes(decoratorName)) {
+                        httpMethod = decoratorName.toLowerCase();
+                        if (decorator.expression.arguments.length > 0) {
+                            const arg = decorator.expression.arguments[0];
+                            if (typescript_1.default.isStringLiteral(arg)) {
+                                routePath = arg.text;
+                            }
+                        }
+                    }
+                }
+            }
+            if (httpMethod && methodName && className) {
+                const operationId = `${className}_${methodName}`;
+                metadata.set(operationId, {
+                    file: filePath,
+                    line: line + 1,
+                    method: httpMethod,
+                    controllerPath,
+                    routePath,
+                });
+            }
+        }
+        typescript_1.default.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    return metadata;
+}
+// --- API Route Parsing (synchronous, for build-time injection) ---
+const HTTP_DECORATOR_NAMES = ['Get', 'Post', 'Put', 'Delete', 'Patch', 'Options', 'Head', 'All'];
+function findControllerFilesSync(dir) {
+    const files = [];
+    function scan(currentDir) {
+        let entries;
+        try {
+            entries = fsSync.readdirSync(currentDir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const fullPath = node_path_1.default.join(currentDir, entry.name);
+            if (entry.isDirectory()) {
+                scan(fullPath);
+            }
+            else if (entry.isFile() && entry.name.endsWith('.controller.ts')) {
+                files.push(fullPath);
+            }
+        }
+    }
+    scan(dir);
+    return files;
+}
+function normalizeApiPath(controllerPath, routePath) {
+    const combined = routePath ? `${controllerPath}/${routePath}` : controllerPath;
+    let normalized = combined.replace(/\/+/g, '/');
+    if (!normalized.startsWith('/'))
+        normalized = `/${normalized}`;
+    if (normalized.length > 1 && normalized.endsWith('/'))
+        normalized = normalized.slice(0, -1);
+    return normalized;
+}
+function parseControllerRoutes(filePath) {
+    let content;
+    try {
+        content = fsSync.readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    const sourceFile = typescript_1.default.createSourceFile(filePath, content, typescript_1.default.ScriptTarget.Latest, true);
+    const routes = [];
+    function getDecoratorsCompat(node) {
+        if ('modifiers' in node && Array.isArray(node.modifiers)) {
+            return node.modifiers.filter((mod) => mod.kind === typescript_1.default.SyntaxKind.Decorator);
+        }
+        if ('decorators' in node && Array.isArray(node.decorators)) {
+            return node.decorators;
+        }
+        return [];
+    }
+    function getStringArg(expr) {
+        if (expr.arguments.length > 0 && typescript_1.default.isStringLiteral(expr.arguments[0])) {
+            return expr.arguments[0].text;
+        }
+        return '';
+    }
+    function visit(node) {
+        if (typescript_1.default.isClassDeclaration(node)) {
+            let controllerPath = '';
+            for (const dec of getDecoratorsCompat(node)) {
+                if (typescript_1.default.isCallExpression(dec.expression)) {
+                    const name = dec.expression.expression.getText(sourceFile);
+                    if (name === 'Controller') {
+                        controllerPath = getStringArg(dec.expression);
+                        break;
+                    }
+                }
+            }
+            for (const member of node.members) {
+                if (!typescript_1.default.isMethodDeclaration(member))
+                    continue;
+                for (const dec of getDecoratorsCompat(member)) {
+                    if (!typescript_1.default.isCallExpression(dec.expression))
+                        continue;
+                    const decoratorName = dec.expression.expression.getText(sourceFile);
+                    if (!HTTP_DECORATOR_NAMES.includes(decoratorName))
+                        continue;
+                    const routePath = getStringArg(dec.expression);
+                    const fullPath = normalizeApiPath(controllerPath, routePath);
+                    const method = decoratorName === 'All' ? '*' : decoratorName.toUpperCase();
+                    routes.push({ method, path: fullPath });
+                }
+            }
+        }
+        typescript_1.default.forEachChild(node, visit);
+    }
+    visit(sourceFile);
+    return routes;
+}
+/**
+ * Scan serverDir for NestJS controller files and extract all parameterized API routes.
+ * Synchronous — safe to call at preset config time (before bundling).
+ */
+function parseApiRoutes(serverDir) {
+    const resolvedDir = node_path_1.default.resolve(serverDir);
+    const controllerFiles = findControllerFilesSync(resolvedDir);
+    const routes = [];
+    for (const filePath of controllerFiles) {
+        routes.push(...parseControllerRoutes(filePath));
+    }
+    return routes;
+}
+//# sourceMappingURL=services.js.map

package/lib/server-log/openapi/services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.js","sourceRoot":"","sources":["../../../src/server-log/openapi/services.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWA,oEAoCC;AAkND,wCAQC;AAzQD,qCAAyC;AACzC,gDAAkC;AAClC,0DAA6B;AAC7B,4DAA4B;AAE5B,mCAAmF;AAEnF;;;GAGG;AACI,KAAK,UAAU,4BAA4B,CAAC,UAA0B,EAAE;IAC7E,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,mBAAI,CAAC,OAAO,CAAC,SAAS,EAAE,oCAAoC,CAAC,CAAC;IACzG,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,mBAAI,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC5E,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,KAAK,KAAK,CAAC;IAE9C,IAAI,OAAY,CAAC;IACjB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,gDAAgD;QAChD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,aAAa;IAC1E,CAAC;SAAM,CAAC;QACN,iBAAiB;QACjB,MAAM,cAAc,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/D,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,IAAA,2BAAmB,EAAC,SAAS,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,MAAM,IAAA,sBAAc,EAAC,eAAe,EAAE,qBAAqB,CAAC,CAAC;IAC/E,MAAM,QAAQ,GAAG,IAAA,2BAAmB,EAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAEzD,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,kBAAE,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAExC,OAAO;QACL,OAAO;QACP,KAAK,EAAE;YACL,QAAQ;YACR,gBAAgB,EAAE,eAAe,CAAC,MAAM;YACxC,kBAAkB,EAAE,SAAS,CAAC,IAAI;YAClC,iBAAiB,EAAE,QAAQ;SAC5B;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,qBAAqB,CAAC,QAAgB;IACnD,MAAM,YAAY,GAAG,mBAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;IAE5D,aAAa;IACb,MAAM,OAAO,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,UAAU,GAAG,oBAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,oBAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAExF,OAAO,yBAAyB,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAAC,UAAyB,EAAE,QAAgB;IAC5E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC/C,IAAI,cAAc,GAAG,EAAE,CAAC;IACxB,IAAI,SAAS,GAAG,EAAE,CAAC;IAEnB,0EAA0E;IAC1E,SAAS,aAAa,CAAC,IAAa;QAClC,oDAAoD;QACpD,IAAI,WAAW,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACzD,OAAQ,IAAI,CAAC,SAA+B,CAAC,MAAM,CACjD,CAAC,GAAG,EAAuB,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,oBAAE,CAAC,UAAU,CAAC,SAAS,CACnE,CAAC;QACJ,CAAC;QACD,qDAAqD;QACrD,IAAI,YAAY,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3D,OAAO,IAAI,CAAC,UAAqC,CAAC;QACpD,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,SAAS,KAAK,CAAC,IAAa;QAC1B,6CAA6C;QAC7C,IAAI,oBAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;YAEvC,qBAAqB;YACrB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC5C,CAAC;YAED,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;gBACnC,IAAI,oBAAE,CAAC,gBAAgB,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC9C,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC;oBACxC,MAAM,aAAa,GAAG,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;oBAEhE,IAAI,aAAa,KAAK,YAAY,EAAE,CAAC;wBACnC,IAAI,UAAU,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BACpC,MAAM,GAAG,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;4BACpC,IAAI,oBAAE,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;gCAC5B,cAAc,GAAG,GAAG,CAAC,IAAI,CAAC;4BAC5B,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,uCAAuC;QACvC,IAAI,oBAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YACjD,IAAI,UAAU,GAAG,EAAE,CAAC;YACpB,IAAI,SAAS,GAAG,EAAE,CAAC;YACnB,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;YAErF,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;YAEvC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;gBACnC,IAAI,oBAAE,CAAC,gBAAgB,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC9C,MAAM,aAAa,GAAG,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;oBAC1E,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;wBAChG,UAAU,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;wBACzC,IAAI,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BAC9C,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;4BAC9C,IAAI,oBAAE,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;gCAC5B,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC;4BACvB,CAAC;wBACH,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAED,IAAI,UAAU,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;gBAC1C,MAAM,WAAW,GAAG,GAAG,SAAS,IAAI,UAAU,EAAE,CAAC;gBACjD,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE;oBACxB,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,IAAI,GAAG,CAAC;oBACd,MAAM,EAAE,UAAU;oBAClB,cAAc;oBACd,SAAS;iBACV,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,oBAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,CAAC;IAClB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,oEAAoE;AAEpE,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AAEjG,SAAS,uBAAuB,CAAC,GAAW;IAC1C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,SAAS,IAAI,CAAC,UAAkB;QAC9B,IAAI,OAAwB,CAAC;QAC7B,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACnD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,CAAC,QAAQ,CAAC,CAAC;YACjB,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACnE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,gBAAgB,CAAC,cAAsB,EAAE,SAAiB;IACjE,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,cAAc,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;IAC/E,IAAI,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;IAC/D,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5F,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,qBAAqB,CAAC,QAAgB;IAC7C,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,UAAU,GAAG,oBAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,oBAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACxF,MAAM,MAAM,GAA4C,EAAE,CAAC;IAE3D,SAAS,mBAAmB,CAAC,IAAa;QACxC,IAAI,WAAW,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACzD,OAAQ,IAAI,CAAC,SAA+B,CAAC,MAAM,CACjD,CAAC,GAAG,EAAuB,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,oBAAE,CAAC,UAAU,CAAC,SAAS,CACnE,CAAC;QACJ,CAAC;QACD,IAAI,YAAY,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3D,OAAO,IAAI,CAAC,UAAqC,CAAC;QACpD,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,SAAS,YAAY,CAAC,IAAuB;QAC3C,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,oBAAE,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAChC,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,SAAS,KAAK,CAAC,IAAa;QAC1B,IAAI,oBAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,IAAI,cAAc,GAAG,EAAE,CAAC;YACxB,KAAK,MAAM,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5C,IAAI,oBAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;oBACxC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;oBAC3D,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;wBAC1B,cAAc,GAAG,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;wBAC9C,MAAM;oBACR,CAAC;gBACH,CAAC;YACH,CAAC;YAED,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClC,IAAI,CAAC,oBAAE,CAAC,mBAAmB,CAAC,MAAM,CAAC;oBAAE,SAAS;gBAC9C,KAAK,MAAM,GAAG,IAAI,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC9C,IAAI,CAAC,oBAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC;wBAAE,SAAS;oBACnD,MAAM,aAAa,GAAG,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;oBACpE,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,aAAa,CAAC;wBAAE,SAAS;oBAE5D,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;oBAC/C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;oBAC7D,MAAM,MAAM,GAAG,aAAa,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;oBAC3E,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC;QACD,oBAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,CAAC;IAClB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAAC,SAAiB;IAC9C,MAAM,WAAW,GAAG,mBAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,eAAe,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC;IAC7D,MAAM,MAAM,GAA4C,EAAE,CAAC;IAC3D,KAAK,MAAM,QAAQ,IAAI,eAAe,EAAE,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/server-log/openapi/spec-controller.d.ts

@@ -0,0 +1,4 @@
+import type { Request, Response } from 'express';
+import type { MiddlewareContext } from '../types';
+export declare function createOpenapiSpecHandler(openapiSpecFilePath: string): (_req: Request, res: Response, context: MiddlewareContext) => Promise<Response<any, Record<string, any>> | undefined>;
+//# sourceMappingURL=spec-controller.d.ts.map

package/lib/server-log/openapi/spec-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-controller.d.ts","sourceRoot":"","sources":["../../../src/server-log/openapi/spec-controller.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAclD,wBAAgB,wBAAwB,CAAC,mBAAmB,EAAE,MAAM,IAGpD,MAAM,OAAO,EAAE,KAAK,QAAQ,EAAE,SAAS,iBAAiB,6DAqDvE"}

package/lib/server-log/openapi/spec-controller.js

@@ -0,0 +1,136 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOpenapiSpecHandler = createOpenapiSpecHandler;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const MAX_REF_DEPTH = 5;
+const EMPTY_OPENAPI_SPEC = {
+    openapi: '3.0.0',
+    info: { title: '开放 API', version: '0.0.0' },
+    paths: {},
+    components: { schemas: {} },
+};
+function createOpenapiSpecHandler(openapiSpecFilePath) {
+    let cache = null;
+    return async (_req, res, context) => {
+        try {
+            let fileBuffer;
+            try {
+                fileBuffer = await promises_1.default.readFile(openapiSpecFilePath, 'utf-8');
+            }
+            catch (err) {
+                if (err?.code === 'ENOENT') {
+                    return res.json(EMPTY_OPENAPI_SPEC);
+                }
+                throw err;
+            }
+            const currentHash = node_crypto_1.default.createHash('md5').update(fileBuffer).digest('hex');
+            if (cache && cache.fileHash === currentHash) {
+                return res.json(cache.data);
+            }
+            let parsed;
+            try {
+                parsed = JSON.parse(fileBuffer);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : 'Invalid JSON';
+                return res.status(500).json({
+                    error: 'Failed to load OpenAPI spec',
+                    message: `${openapiSpecFilePath} invalid: ${message}`,
+                });
+            }
+            if (!parsed || typeof parsed !== 'object' || !parsed.paths || typeof parsed.paths !== 'object') {
+                return res.status(500).json({
+                    error: 'Failed to load OpenAPI spec',
+                    message: `${openapiSpecFilePath} missing "paths"`,
+                });
+            }
+            const result = buildFilteredSpec(parsed, context.basePath ?? '');
+            cache = {
+                data: result,
+                fileHash: currentHash,
+            };
+            res.json(result);
+            return;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            res.status(500).json({
+                error: 'Failed to load OpenAPI spec',
+                message,
+            });
+            return;
+        }
+    };
+}
+function buildFilteredSpec(spec, globalPrefix) {
+    const schemas = (spec.components?.schemas ?? {});
+    const paths = (spec.paths ?? {});
+    const filteredPaths = {};
+    const cleanPrefix = globalPrefix.replace(/\/+$/, '');
+    for (const [pathKey, methods] of Object.entries(paths)) {
+        const cleanPath = stripPrefix(pathKey, cleanPrefix);
+        if (!cleanPath.startsWith('/openapi'))
+            continue;
+        filteredPaths[cleanPath] = {};
+        for (const [method, operation] of Object.entries(methods)) {
+            if (['parameters', 'summary', 'description', 'servers'].includes(method))
+                continue;
+            filteredPaths[cleanPath][method] = resolveRefsDeep(structuredClone(operation), schemas);
+        }
+    }
+    return {
+        openapi: spec.openapi ?? '3.0.0',
+        paths: filteredPaths,
+        components: {
+            schemas: resolveAllSchemaRefs(structuredClone(schemas)),
+        },
+    };
+}
+function stripPrefix(pathStr, prefix) {
+    if (prefix && pathStr.startsWith(prefix)) {
+        return pathStr.slice(prefix.length);
+    }
+    return pathStr;
+}
+function resolveRefsDeep(obj, schemas, depth = 0) {
+    if (depth > MAX_REF_DEPTH || obj === null || obj === undefined)
+        return obj;
+    if (typeof obj !== 'object')
+        return obj;
+    if (Array.isArray(obj)) {
+        return obj.map((item) => resolveRefsDeep(item, schemas, depth));
+    }
+    const record = obj;
+    if (typeof record['$ref'] === 'string') {
+        const resolved = resolveRef(record['$ref'], schemas);
+        if (resolved !== undefined) {
+            return resolveRefsDeep(structuredClone(resolved), schemas, depth + 1);
+        }
+        return record;
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(record)) {
+        result[key] = resolveRefsDeep(value, schemas, depth);
+    }
+    return result;
+}
+function resolveRef(ref, schemas) {
+    const prefix = '#/components/schemas/';
+    if (ref.startsWith(prefix)) {
+        const name = ref.slice(prefix.length);
+        return schemas[name];
+    }
+    return undefined;
+}
+function resolveAllSchemaRefs(schemas) {
+    const result = {};
+    for (const [name, schema] of Object.entries(schemas)) {
+        result[name] = resolveRefsDeep(schema, schemas);
+    }
+    return result;
+}
+//# sourceMappingURL=spec-controller.js.map

package/lib/server-log/openapi/spec-controller.js.map

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

package/lib/server-log/openapi/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Options for OpenAPI middleware
+ */
+export interface OpenapiMiddlewareOptions {
+    /** Path to the openapi.json file */
+    openapiFilePath: string;
+    /** Path to the OpenAPI spec source file (when set, serves /openapi/spec with /openapi/* filtered and $refs resolved) */
+    openapiSpecFilePath?: string;
+    /** Enable source code enhancement */
+    enableEnhancement?: boolean;
+    /** Server directory for source code scanning (defaults to context.rootDir) */
+    serverDir?: string;
+}
+/**
+ * Source file information for API endpoint
+ */
+export interface SourceInfo {
+    file: string;
+    line: number;
+    method: string;
+    controllerPath: string;
+    routePath: string;
+}
+/**
+ * Options for enhancing OpenAPI specification
+ */
+export interface EnhanceOptions {
+    openapiPath?: string;
+    serverDir?: string;
+    openapiData?: any;
+    writeFile?: boolean;
+}
+/**
+ * Statistics about the enhancement process
+ */
+export interface EnhanceStats {
+    duration: number;
+    controllersFound: number;
+    endpointsExtracted: number;
+    endpointsEnhanced: number;
+}
+/**
+ * Result of OpenAPI enhancement
+ */
+export interface EnhanceResult {
+    openapi: any;
+    stats: EnhanceStats;
+}
+/**
+ * OpenAPI cache entry
+ */
+export interface OpenapiCache {
+    data: any;
+    fileHash: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/server-log/openapi/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/server-log/openapi/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,oCAAoC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,wHAAwH;IACxH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qCAAqC;IACrC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,GAAG,CAAC;IACb,KAAK,EAAE,YAAY,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,GAAG,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/lib/server-log/openapi/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/server-log/openapi/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/server-log/openapi/types.ts"],"names":[],"mappings":""}

package/lib/server-log/openapi/utils.d.ts

@@ -0,0 +1,18 @@
+import type { SourceInfo } from './types';
+/**
+ * Find all controller files in a directory
+ */
+export declare function findControllerFiles(dir: string): Promise<string[]>;
+/**
+ * Build source map from controller files
+ */
+export declare function buildSourceMap(controllerFiles: string[], processFile: (filePath: string) => Promise<Map<string, SourceInfo>>): Promise<Map<string, SourceInfo>>;
+/**
+ * Enhance OpenAPI paths with source information
+ */
+export declare function enhanceOpenApiPaths(openapi: any, sourceMap: Map<string, SourceInfo>): number;
+/**
+ * Transform OpenAPI paths by removing basePath prefix
+ */
+export declare function transformOpenapiPaths(openapi: any, basePath: string): any;
+//# sourceMappingURL=utils.d.ts.map

package/lib/server-log/openapi/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/server-log/openapi/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBxE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,eAAe,EAAE,MAAM,EAAE,EACzB,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,GAClE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAqBlC;AAqCD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,MAAM,CAyB5F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,CAgBzE"}

package/lib/server-log/openapi/utils.js

@@ -0,0 +1,128 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findControllerFiles = findControllerFiles;
+exports.buildSourceMap = buildSourceMap;
+exports.enhanceOpenApiPaths = enhanceOpenApiPaths;
+exports.transformOpenapiPaths = transformOpenapiPaths;
+const node_path_1 = __importDefault(require("node:path"));
+const node_fs_1 = require("node:fs");
+/**
+ * Find all controller files in a directory
+ */
+async function findControllerFiles(dir) {
+    const files = [];
+    async function scan(currentDir) {
+        const entries = await node_fs_1.promises.readdir(currentDir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = node_path_1.default.join(currentDir, entry.name);
+            if (entry.isDirectory()) {
+                await scan(fullPath);
+            }
+            else if (entry.isFile() && entry.name.endsWith('.controller.ts')) {
+                files.push(fullPath);
+            }
+        }
+    }
+    await scan(dir);
+    return files;
+}
+/**
+ * Build source map from controller files
+ */
+async function buildSourceMap(controllerFiles, processFile) {
+    const sourceMap = new Map();
+    // Process files in parallel with a concurrency limit
+    const concurrency = 10;
+    const results = [];
+    for (let i = 0; i < controllerFiles.length; i += concurrency) {
+        const batch = controllerFiles.slice(i, i + concurrency);
+        const batchResults = await Promise.all(batch.map((filePath) => processFile(filePath)));
+        results.push(...batchResults);
+    }
+    // Merge results
+    for (const metadata of results) {
+        for (const [operationId, info] of metadata.entries()) {
+            sourceMap.set(operationId, info);
+        }
+    }
+    return sourceMap;
+}
+/**
+ * Try to match operationId with different formats
+ * Supports:
+ * - Direct match: ClassName_methodName
+ * - Camel case: classNameMethodName
+ * - Method only: methodName
+ */
+function findSourceInfo(operationId, sourceMap) {
+    // Try direct match first
+    const directMatch = sourceMap.get(operationId);
+    if (directMatch) {
+        return directMatch;
+    }
+    // Try matching with different formats
+    for (const [key, value] of sourceMap.entries()) {
+        // key format: ClassName_methodName
+        const [className, methodName] = key.split('_');
+        if (!className || !methodName)
+            continue;
+        // Try camelCase format: classNameMethodName
+        const camelCaseId = className.charAt(0).toLowerCase() + className.slice(1) + methodName.charAt(0).toUpperCase() + methodName.slice(1);
+        if (operationId === camelCaseId) {
+            return value;
+        }
+        // Try method name only
+        if (operationId === methodName) {
+            return value;
+        }
+    }
+    return undefined;
+}
+/**
+ * Enhance OpenAPI paths with source information
+ */
+function enhanceOpenApiPaths(openapi, sourceMap) {
+    let enhancedCount = 0;
+    if (!openapi.paths) {
+        return enhancedCount;
+    }
+    for (const pathItem of Object.values(openapi.paths)) {
+        if (!pathItem || typeof pathItem !== 'object')
+            continue;
+        for (const operation of Object.values(pathItem)) {
+            if (operation && typeof operation === 'object' && 'operationId' in operation) {
+                const sourceInfo = findSourceInfo(operation.operationId, sourceMap);
+                if (sourceInfo) {
+                    operation['x-source'] = {
+                        file: sourceInfo.file,
+                        line: sourceInfo.line,
+                    };
+                    enhancedCount++;
+                }
+            }
+        }
+    }
+    return enhancedCount;
+}
+/**
+ * Transform OpenAPI paths by removing basePath prefix
+ */
+function transformOpenapiPaths(openapi, basePath) {
+    if (basePath === '/' || !openapi.paths) {
+        return openapi;
+    }
+    const newPaths = {};
+    Object.keys(openapi.paths).forEach((key) => {
+        const staticApiKey = key.startsWith(basePath) ? key.slice(basePath.length) : key;
+        newPaths[staticApiKey] = openapi.paths[key];
+    });
+    return {
+        ...openapi,
+        paths: newPaths,
+        basePath,
+    };
+}
+//# sourceMappingURL=utils.js.map