@lark-apaas/coding-preset-vite-react 1.0.13-alpha.0 → 1.0.13-alpha.10

package/lib/server-log/dev-logs/utils.d.ts

@@ -0,0 +1,68 @@
+import type { LogEntry } from './types';
+/**
+ * Resolve log directory path
+ */
+export declare function resolveLogDir(provided?: string): string;
+/**
+ * Get relative path from current working directory
+ */
+export declare function getRelativePath(filePath: string): string;
+/**
+ * Check if file exists
+ */
+export declare function fileExists(filePath: string): Promise<boolean>;
+/**
+ * Parse a log line as JSON
+ */
+export declare function parseLogLine(line: string): LogEntry | undefined;
+/**
+ * Extract number from message using regex pattern
+ */
+export declare function extractNumber(message: string, pattern: RegExp): number | undefined;
+/**
+ * Parse limit parameter with default and max value
+ */
+export declare function parseLimit(value: string | undefined, defaultValue: number, maxValue: number): number;
+/**
+ * Parse positive integer with fallback
+ */
+export declare function parsePositiveInt(value: string | undefined, fallback: number): number;
+/**
+ * Resolve log file path with security checks
+ */
+export declare function resolveLogFilePath(baseDir: string, fileName: string): string;
+/**
+ * Check if actual request path matches expected OpenAPI/Swagger path pattern
+ *
+ * @param actualPath - The actual request path from logs (e.g., /api/users/123)
+ * @param pattern - The OpenAPI path pattern to match against (e.g., /api/users/{id})
+ * @returns true if the path matches the pattern
+ *
+ * @example
+ * matchesPath('/api/users/123', '/api/users/{id}') // true
+ * matchesPath('/api/users/123', '/api/users') // true (prefix match)
+ * matchesPath('/api/posts/456', '/api/users/{id}') // false
+ */
+export declare function matchesPath(actualPath: string | undefined, pattern: string): boolean;
+/**
+ * Check if actual request method matches expected HTTP method
+ *
+ * @param actualMethod - The actual request method from logs (e.g., 'GET', 'POST')
+ * @param expectedMethod - The expected HTTP method to match against (e.g., 'GET')
+ * @returns true if the method matches (case-insensitive)
+ *
+ * @example
+ * matchesMethod('GET', 'GET') // true
+ * matchesMethod('get', 'GET') // true
+ * matchesMethod('POST', 'GET') // false
+ * matchesMethod(undefined, 'GET') // false
+ */
+export declare function matchesMethod(actualMethod: string | undefined, expectedMethod: string): boolean;
+/**
+ * Serialize error for JSON response
+ */
+export declare function serializeError(error: unknown): {
+    name?: string;
+    message: string;
+};
+//# sourceMappingURL=utils.d.ts.map

package/lib/server-log/dev-logs/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/server-log/dev-logs/utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGxC;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOnE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAS/D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQlF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWpG;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOpF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgB5E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEpF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAK/F;AAGD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAIjF"}

package/lib/server-log/dev-logs/utils.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveLogDir = resolveLogDir;
+exports.getRelativePath = getRelativePath;
+exports.fileExists = fileExists;
+exports.parseLogLine = parseLogLine;
+exports.extractNumber = extractNumber;
+exports.parseLimit = parseLimit;
+exports.parsePositiveInt = parsePositiveInt;
+exports.resolveLogFilePath = resolveLogFilePath;
+exports.matchesPath = matchesPath;
+exports.matchesMethod = matchesMethod;
+exports.serializeError = serializeError;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const path_matcher_1 = require("./helper/path-matcher");
+/**
+ * Resolve log directory path
+ */
+function resolveLogDir(provided) {
+    if (!provided) {
+        return (0, node_path_1.join)(process.cwd(), 'logs');
+    }
+    return (0, node_path_1.isAbsolute)(provided) ? provided : (0, node_path_1.join)(process.cwd(), provided);
+}
+/**
+ * Get relative path from current working directory
+ */
+function getRelativePath(filePath) {
+    return (0, node_path_1.relative)(process.cwd(), filePath);
+}
+/**
+ * Check if file exists
+ */
+async function fileExists(filePath) {
+    try {
+        await node_fs_1.promises.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Parse a log line as JSON
+ */
+function parseLogLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return undefined;
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Extract number from message using regex pattern
+ */
+function extractNumber(message, pattern) {
+    if (typeof message !== 'string')
+        return undefined;
+    const match = message.match(pattern);
+    if (!match)
+        return undefined;
+    const value = Number(match[1]);
+    return Number.isFinite(value) ? value : undefined;
+}
+/**
+ * Parse limit parameter with default and max value
+ */
+function parseLimit(value, defaultValue, maxValue) {
+    if (typeof value !== 'string' || !value.trim()) {
+        return defaultValue;
+    }
+    const parsed = Number(value);
+    if (Number.isFinite(parsed) && parsed > 0) {
+        return Math.min(Math.floor(parsed), maxValue);
+    }
+    return defaultValue;
+}
+/**
+ * Parse positive integer with fallback
+ */
+function parsePositiveInt(value, fallback) {
+    if (typeof value !== 'string' || !value.trim()) {
+        return fallback;
+    }
+    const parsed = Number(value);
+    return Number.isFinite(parsed) && parsed > 0 ? Math.floor(parsed) : fallback;
+}
+/**
+ * Resolve log file path with security checks
+ */
+function resolveLogFilePath(baseDir, fileName) {
+    const sanitized = fileName.replace(/\\/g, '/');
+    const segments = sanitized.split('/').filter(Boolean);
+    if (segments.some((segment) => segment === '..')) {
+        throw new Error('Invalid log file path');
+    }
+    const resolved = (0, node_path_1.join)(baseDir, segments.join('/'));
+    const rel = (0, node_path_1.relative)(baseDir, resolved);
+    if (rel.startsWith('..')) {
+        throw new Error('Access to the specified log file is denied');
+    }
+    return resolved;
+}
+/**
+ * Check if actual request path matches expected OpenAPI/Swagger path pattern
+ *
+ * @param actualPath - The actual request path from logs (e.g., /api/users/123)
+ * @param pattern - The OpenAPI path pattern to match against (e.g., /api/users/{id})
+ * @returns true if the path matches the pattern
+ *
+ * @example
+ * matchesPath('/api/users/123', '/api/users/{id}') // true
+ * matchesPath('/api/users/123', '/api/users') // true (prefix match)
+ * matchesPath('/api/posts/456', '/api/users/{id}') // false
+ */
+function matchesPath(actualPath, pattern) {
+    return (0, path_matcher_1.matchesPathPattern)(actualPath, pattern);
+}
+/**
+ * Check if actual request method matches expected HTTP method
+ *
+ * @param actualMethod - The actual request method from logs (e.g., 'GET', 'POST')
+ * @param expectedMethod - The expected HTTP method to match against (e.g., 'GET')
+ * @returns true if the method matches (case-insensitive)
+ *
+ * @example
+ * matchesMethod('GET', 'GET') // true
+ * matchesMethod('get', 'GET') // true
+ * matchesMethod('POST', 'GET') // false
+ * matchesMethod(undefined, 'GET') // false
+ */
+function matchesMethod(actualMethod, expectedMethod) {
+    if (!actualMethod || !expectedMethod) {
+        return false;
+    }
+    return actualMethod.toUpperCase() === expectedMethod.toUpperCase();
+}
+/**
+ * Serialize error for JSON response
+ */
+function serializeError(error) {
+    return error instanceof Error
+        ? { name: error.name, message: error.message }
+        : { message: String(error) };
+}
+//# sourceMappingURL=utils.js.map

package/lib/server-log/dev-logs/utils.js.map

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

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

@@ -0,0 +1,7 @@
+import type { Request, Response } from 'express';
+import type { MiddlewareContext } from '../types';
+/**
+ * Create OpenAPI request handler with caching
+ */
+export declare function createOpenapiHandler(openapiFilePath: string, enableEnhancement: boolean, serverDir?: string): (_req: Request, res: Response, context: MiddlewareContext) => Promise<Response<any, Record<string, any>> | undefined>;
+//# sourceMappingURL=controller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../src/server-log/openapi/controller.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,MAAM,EACvB,iBAAiB,EAAE,OAAO,EAC1B,SAAS,CAAC,EAAE,MAAM,IAKJ,MAAM,OAAO,EAAE,KAAK,QAAQ,EAAE,SAAS,iBAAiB,6DAiDvE"}

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

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOpenapiHandler = createOpenapiHandler;
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const services_1 = require("./services");
+const utils_1 = require("./utils");
+/**
+ * Create OpenAPI request handler with caching
+ */
+function createOpenapiHandler(openapiFilePath, enableEnhancement, serverDir) {
+    // In-memory cache
+    let cache = null;
+    return async (_req, res, context) => {
+        try {
+            // Read OpenAPI file
+            const fileBuffer = await promises_1.default.readFile(openapiFilePath, 'utf-8');
+            // Calculate file hash for cache invalidation
+            const currentHash = node_crypto_1.default.createHash('md5').update(fileBuffer).digest('hex');
+            // Use cache if file content hasn't changed
+            if (cache && cache.fileHash === currentHash) {
+                return res.json(cache.data);
+            }
+            // Parse OpenAPI
+            let payload = JSON.parse(fileBuffer);
+            // Enhance with x-source if enabled
+            if (enableEnhancement && context.isDev) {
+                const { openapi: enhancedPayload, stats } = await (0, services_1.enhanceOpenApiWithSourceInfo)({
+                    openapiData: payload,
+                    writeFile: false, // Don't write to file, keep in memory
+                    serverDir: serverDir || context.rootDir, // Use provided serverDir or fallback to context.rootDir
+                });
+                payload = enhancedPayload;
+                // Log performance
+                console.log(`[OpenAPI] Enhanced in ${stats.duration}ms (${stats.endpointsEnhanced} endpoints)`);
+            }
+            // Transform paths: remove basePath prefix from all API paths
+            const result = (0, utils_1.transformOpenapiPaths)(payload, context.basePath);
+            // Update cache
+            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;
+        }
+    };
+}
+//# sourceMappingURL=controller.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../../src/server-log/openapi/controller.ts"],"names":[],"mappings":";;;;;AAaA,oDAyDC;AAtED,gEAAkC;AAClC,8DAAiC;AAEjC,yCAA0D;AAC1D,mCAAgD;AAMhD;;GAEG;AACH,SAAgB,oBAAoB,CAClC,eAAuB,EACvB,iBAA0B,EAC1B,SAAkB;IAElB,kBAAkB;IAClB,IAAI,KAAK,GAAwB,IAAI,CAAC;IAEtC,OAAO,KAAK,EAAE,IAAa,EAAE,GAAa,EAAE,OAA0B,EAAE,EAAE;QACxE,IAAI,CAAC;YACH,oBAAoB;YACpB,MAAM,UAAU,GAAG,MAAM,kBAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;YAE/D,6CAA6C;YAC7C,MAAM,WAAW,GAAG,qBAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAE9E,2CAA2C;YAC3C,IAAI,KAAK,IAAI,KAAK,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;gBAC5C,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;YAED,gBAAgB;YAChB,IAAI,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAErC,mCAAmC;YACnC,IAAI,iBAAiB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBACvC,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,GAAG,MAAM,IAAA,uCAA4B,EAAC;oBAC7E,WAAW,EAAE,OAAO;oBACpB,SAAS,EAAE,KAAK,EAAE,sCAAsC;oBACxD,SAAS,EAAE,SAAS,IAAI,OAAO,CAAC,OAAO,EAAE,wDAAwD;iBAClG,CAAC,CAAC;gBACH,OAAO,GAAG,eAAe,CAAC;gBAE1B,kBAAkB;gBAClB,OAAO,CAAC,GAAG,CAAC,yBAAyB,KAAK,CAAC,QAAQ,OAAO,KAAK,CAAC,iBAAiB,aAAa,CAAC,CAAC;YAClG,CAAC;YAED,6DAA6D;YAC7D,MAAM,MAAM,GAAG,IAAA,6BAAqB,EAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;YAEhE,eAAe;YACf,KAAK,GAAG;gBACN,IAAI,EAAE,MAAM;gBACZ,QAAQ,EAAE,WAAW;aACtB,CAAC;YAEF,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACjB,OAAO;QACT,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YACzE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,KAAK,EAAE,6BAA6B;gBACpC,OAAO;aACR,CAAC,CAAC;YACH,OAAO;QACT,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,10 @@
+import type { RouteMiddleware } from '../types';
+import type { OpenapiMiddlewareOptions } from './types';
+/**
+ * Creates OpenAPI middleware that serves enhanced openapi.json
+ * Supports both rspack/webpack and Vite dev servers
+ */
+export declare function createOpenapiMiddleware(options: OpenapiMiddlewareOptions): RouteMiddleware;
+export type { OpenapiMiddlewareOptions, SourceInfo, EnhanceOptions, EnhanceResult } from './types';
+export { enhanceOpenApiWithSourceInfo, parseApiRoutes } from './services';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server-log/openapi/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,UAAU,CAAC;AAC9E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAmBxD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,eAAe,CA0B1F;AAGD,YAAY,EAAE,wBAAwB,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnG,OAAO,EAAE,4BAA4B,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseApiRoutes = exports.enhanceOpenApiWithSourceInfo = void 0;
+exports.createOpenapiMiddleware = createOpenapiMiddleware;
+const router_1 = require("./router");
+/**
+ * Routes provided by OpenAPI middleware
+ */
+const OPENAPI_ROUTES = [
+    {
+        method: 'GET',
+        path: '/openapi.json',
+        description: 'Serve enhanced OpenAPI specification with source code references',
+    },
+    {
+        method: 'GET',
+        path: '/openapi/spec',
+        description: 'Serve OpenAPI specification for /openapi/*',
+    },
+];
+/**
+ * Creates OpenAPI middleware that serves enhanced openapi.json
+ * Supports both rspack/webpack and Vite dev servers
+ */
+function createOpenapiMiddleware(options) {
+    const { openapiFilePath, openapiSpecFilePath, enableEnhancement = true, serverDir } = options;
+    const routes = openapiSpecFilePath
+        ? OPENAPI_ROUTES
+        : OPENAPI_ROUTES.filter((route) => route.path !== '/openapi/spec');
+    return {
+        name: 'openapi',
+        mountPath: '/dev',
+        routes,
+        enabled: (context) => context.isDev,
+        createRouter: (context) => {
+            return (0, router_1.createOpenapiRouter)({
+                openapiFilePath,
+                openapiSpecFilePath,
+                enableEnhancement,
+                serverDir,
+            }, context);
+        },
+    };
+}
+var services_1 = require("./services");
+Object.defineProperty(exports, "enhanceOpenApiWithSourceInfo", { enumerable: true, get: function () { return services_1.enhanceOpenApiWithSourceInfo; } });
+Object.defineProperty(exports, "parseApiRoutes", { enumerable: true, get: function () { return services_1.parseApiRoutes; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server-log/openapi/index.ts"],"names":[],"mappings":";;;AAwBA,0DA0BC;AAhDD,qCAA+C;AAE/C;;GAEG;AACH,MAAM,cAAc,GAAgB;IAClC;QACE,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,kEAAkE;KAChF;IACD;QACE,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,4CAA4C;KAC1D;CACF,CAAC;AAEF;;;GAGG;AACH,SAAgB,uBAAuB,CAAC,OAAiC;IACvE,MAAM,EAAE,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,GAAG,IAAI,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE9F,MAAM,MAAM,GAAG,mBAAmB;QAChC,CAAC,CAAC,cAAc;QAChB,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC;IAErE,OAAO;QACL,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,MAAM;QACjB,MAAM;QAEN,OAAO,EAAE,CAAC,OAA0B,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK;QAEtD,YAAY,EAAE,CAAC,OAA0B,EAAE,EAAE;YAC3C,OAAO,IAAA,4BAAmB,EACxB;gBACE,eAAe;gBACf,mBAAmB;gBACnB,iBAAiB;gBACjB,SAAS;aACV,EACD,OAAO,CACR,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAID,uCAA0E;AAAjE,wHAAA,4BAA4B,OAAA;AAAE,0GAAA,cAAc,OAAA"}

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

@@ -0,0 +1,20 @@
+import { Router } from 'express';
+import type { MiddlewareContext } from '../types';
+/**
+ * Options for creating OpenAPI router
+ */
+export interface OpenapiRouterOptions {
+    /** Path to the openapi.json file */
+    openapiFilePath: string;
+    /** Path to the OpenAPI spec source file for /openapi/spec; when omitted, the route is not registered */
+    openapiSpecFilePath?: string;
+    /** Enable source code enhancement */
+    enableEnhancement: boolean;
+    /** Server directory for source code scanning */
+    serverDir?: string;
+}
+/**
+ * Create OpenAPI router
+ */
+export declare function createOpenapiRouter(options: OpenapiRouterOptions, context: MiddlewareContext): Router;
+//# sourceMappingURL=router.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/server-log/openapi/router.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAIlD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oCAAoC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,wGAAwG;IACxG,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qCAAqC;IACrC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,iBAAiB,GACzB,MAAM,CAeR"}

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

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOpenapiRouter = createOpenapiRouter;
+const express_1 = __importDefault(require("express"));
+const controller_1 = require("./controller");
+const spec_controller_1 = require("./spec-controller");
+/**
+ * Create OpenAPI router
+ */
+function createOpenapiRouter(options, context) {
+    const { openapiFilePath, openapiSpecFilePath, enableEnhancement, serverDir } = options;
+    const router = express_1.default.Router();
+    const handler = (0, controller_1.createOpenapiHandler)(openapiFilePath, enableEnhancement, serverDir);
+    // GET /openapi.json - Serve enhanced OpenAPI specification with x-source
+    router.get('/openapi.json', (req, res) => handler(req, res, context));
+    // GET /openapi/spec - Serve filtered OpenAPI spec for /openapi/* with refs resolved
+    if (openapiSpecFilePath) {
+        const specHandler = (0, spec_controller_1.createOpenapiSpecHandler)(openapiSpecFilePath);
+        router.get('/openapi/spec', (req, res) => specHandler(req, res, context));
+    }
+    return router;
+}
+//# sourceMappingURL=router.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/server-log/openapi/router.ts"],"names":[],"mappings":";;;;;AAsBA,kDAkBC;AAxCD,sDAA0C;AAE1C,6CAAoD;AACpD,uDAA6D;AAgB7D;;GAEG;AACH,SAAgB,mBAAmB,CACjC,OAA6B,EAC7B,OAA0B;IAE1B,MAAM,EAAE,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IACvF,MAAM,MAAM,GAAG,iBAAO,CAAC,MAAM,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,IAAA,iCAAoB,EAAC,eAAe,EAAE,iBAAiB,EAAE,SAAS,CAAC,CAAC;IAEpF,yEAAyE;IACzE,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAEtE,oFAAoF;IACpF,IAAI,mBAAmB,EAAE,CAAC;QACxB,MAAM,WAAW,GAAG,IAAA,0CAAwB,EAAC,mBAAmB,CAAC,CAAC;QAClE,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { EnhanceOptions, EnhanceResult } from './types';
+/**
+ * Enhances OpenAPI JSON with source file location metadata
+ * Can be called programmatically or run as a script
+ */
+export declare function enhanceOpenApiWithSourceInfo(options?: EnhanceOptions): Promise<EnhanceResult>;
+/**
+ * Scan serverDir for NestJS controller files and extract all parameterized API routes.
+ * Synchronous — safe to call at preset config time (before bundling).
+ */
+export declare function parseApiRoutes(serverDir: string): Array<{
+    method: string;
+    path: string;
+}>;
+//# sourceMappingURL=services.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../src/server-log/openapi/services.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGzE;;;GAGG;AACH,wBAAsB,4BAA4B,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAoCvG;AA8MD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAQzF"}