spectra-cli 4.1.1

package/dist/panoramic/api-surface/fastapi-extractor.js

@@ -0,0 +1,287 @@
+import { collectProjectFiles, extractBalancedContent, extractDependencyNames, extractStringArray, getNamedArgumentValue, getPositionalArguments, getRelativePath, joinUrlPaths, PYTHON_EXTENSIONS, resolvePythonModulePath, splitTopLevel, stripWrappingQuotes, tryReadFile, uniqueStrings, } from './utils.js';
+import { collectAuthHints, dedupeEndpoints, normalizeTypeText } from './endpoint-utils.js';
+function parseFastApiRouteParameters(argsText, pathValue) {
+    const parameters = [];
+    const authHints = [];
+    const defMatch = argsText.match(/^\s*([A-Za-z_]\w*)\s*:\s*([^=,]+?)(?:\s*=\s*(.+))?$/);
+    if (!defMatch) {
+        return { parameters, auth: authHints };
+    }
+    const name = defMatch[1];
+    const annotation = normalizeTypeText(defMatch[2]);
+    const defaultExpr = defMatch[3]?.trim();
+    if (defaultExpr && /\b(?:Depends|Security)\(/.test(defaultExpr)) {
+        authHints.push(...extractDependencyNames(defaultExpr));
+        return { parameters, auth: authHints };
+    }
+    let location = 'query';
+    if (defaultExpr && /\bPath\(/.test(defaultExpr))
+        location = 'path';
+    else if (defaultExpr && /\bQuery\(/.test(defaultExpr))
+        location = 'query';
+    else if (defaultExpr && /\bBody\(/.test(defaultExpr))
+        location = 'body';
+    else if (defaultExpr && /\bHeader\(/.test(defaultExpr))
+        location = 'header';
+    else if (defaultExpr && /\bCookie\(/.test(defaultExpr))
+        location = 'cookie';
+    else if (defaultExpr && /\bForm\(/.test(defaultExpr))
+        location = 'form';
+    else if (new RegExp(`\\{${name}\\}`).test(pathValue))
+        location = 'path';
+    const required = location === 'path'
+        ? true
+        : !defaultExpr || defaultExpr.includes('...');
+    parameters.push({
+        name,
+        in: location,
+        type: annotation,
+        required,
+    });
+    return { parameters, auth: authHints };
+}
+function analyzeFastApiFile(projectRoot, filePath, content) {
+    const routers = new Map();
+    const imports = new Map();
+    for (const line of content.split('\n')) {
+        const fromImportMatch = line.match(/^\s*from\s+([.\w]+)\s+import\s+(.+)\s*$/);
+        if (!fromImportMatch) {
+            continue;
+        }
+        const modulePath = fromImportMatch[1];
+        const resolvedFile = resolvePythonModulePath(filePath, modulePath, projectRoot);
+        if (!resolvedFile) {
+            continue;
+        }
+        for (const entry of splitTopLevel(fromImportMatch[2])) {
+            const aliasMatch = entry.match(/^\s*([A-Za-z_]\w*)(?:\s+as\s+([A-Za-z_]\w*))?\s*$/);
+            if (!aliasMatch) {
+                continue;
+            }
+            const importedName = aliasMatch[1];
+            const localName = aliasMatch[2] ?? importedName;
+            imports.set(localName, {
+                targetFile: resolvedFile,
+                exportName: importedName,
+            });
+        }
+    }
+    const routerDeclPattern = /\b([A-Za-z_]\w*)\s*=\s*(FastAPI|APIRouter)\s*\(/g;
+    let routerMatch;
+    while ((routerMatch = routerDeclPattern.exec(content)) !== null) {
+        const localName = routerMatch[1];
+        const kind = routerMatch[2] === 'FastAPI' ? 'app' : 'router';
+        const openParenIndex = routerDeclPattern.lastIndex - 1;
+        const balanced = extractBalancedContent(content, openParenIndex);
+        if (!balanced) {
+            continue;
+        }
+        const argsText = balanced.content;
+        const prefix = stripWrappingQuotes(getNamedArgumentValue(argsText, 'prefix') ?? '') ?? '';
+        const tags = extractStringArray(getNamedArgumentValue(argsText, 'tags'));
+        const auth = extractDependencyNames(getNamedArgumentValue(argsText, 'dependencies') ?? '');
+        routers.set(localName, {
+            id: `${filePath}#${localName}`,
+            filePath,
+            localName,
+            kind,
+            prefix,
+            tags,
+            auth,
+            routes: [],
+            mounts: [],
+        });
+        routerDeclPattern.lastIndex = balanced.endIndex + 1;
+    }
+    const routePattern = /@([A-Za-z_]\w*)\.(get|post|put|patch|delete|options|head|trace)\s*\(/g;
+    let routeMatch;
+    while ((routeMatch = routePattern.exec(content)) !== null) {
+        const routerName = routeMatch[1];
+        const router = routers.get(routerName);
+        if (!router) {
+            continue;
+        }
+        const balanced = extractBalancedContent(content, routePattern.lastIndex - 1);
+        if (!balanced) {
+            continue;
+        }
+        const argsText = balanced.content;
+        const afterDecorator = content.slice(balanced.endIndex + 1);
+        const defMatch = afterDecorator.match(/^\s*(?:async\s+)?def\s+([A-Za-z_]\w*)\(([\s\S]*?)\)(?:\s*->\s*([^:\n]+))?:/m);
+        if (!defMatch) {
+            continue;
+        }
+        const positionalArgs = getPositionalArguments(argsText);
+        const rawPath = stripWrappingQuotes(positionalArgs[0] ?? '') ?? '/';
+        const routeTags = extractStringArray(getNamedArgumentValue(argsText, 'tags'));
+        const routeAuth = extractDependencyNames(argsText);
+        const responseModel = normalizeTypeText(getNamedArgumentValue(argsText, 'response_model') ?? defMatch[3]);
+        const parameters = [];
+        const functionAuth = [];
+        for (const rawParam of splitTopLevel(defMatch[2])) {
+            const trimmed = rawParam.trim();
+            if (!trimmed || trimmed === 'self' || trimmed === 'cls') {
+                continue;
+            }
+            const parsed = parseFastApiRouteParameters(trimmed, rawPath);
+            parameters.push(...parsed.parameters);
+            functionAuth.push(...parsed.auth);
+        }
+        router.routes.push({
+            method: routeMatch[2].toUpperCase(),
+            path: rawPath,
+            parameters,
+            responseType: responseModel,
+            auth: uniqueStrings([...routeAuth, ...functionAuth]),
+            tags: routeTags,
+            summary: stripWrappingQuotes(getNamedArgumentValue(argsText, 'summary') ?? '') ?? undefined,
+            operationId: defMatch[1],
+            sourceFile: getRelativePath(projectRoot, filePath),
+        });
+        routePattern.lastIndex = balanced.endIndex + 1;
+    }
+    const includeRouterPattern = /\b([A-Za-z_]\w*)\.include_router\s*\(/g;
+    let includeMatch;
+    while ((includeMatch = includeRouterPattern.exec(content)) !== null) {
+        const parentName = includeMatch[1];
+        const parent = routers.get(parentName);
+        if (!parent) {
+            continue;
+        }
+        const balanced = extractBalancedContent(content, includeRouterPattern.lastIndex - 1);
+        if (!balanced) {
+            continue;
+        }
+        const argsText = balanced.content;
+        const positionalArgs = getPositionalArguments(argsText);
+        const childName = positionalArgs[0]?.trim();
+        if (!childName || !/^[A-Za-z_]\w*$/.test(childName)) {
+            continue;
+        }
+        parent.mounts.push({
+            targetLocalName: childName,
+            prefix: stripWrappingQuotes(getNamedArgumentValue(argsText, 'prefix') ?? '') ?? '',
+            tags: extractStringArray(getNamedArgumentValue(argsText, 'tags')),
+            auth: extractDependencyNames(getNamedArgumentValue(argsText, 'dependencies') ?? ''),
+        });
+        includeRouterPattern.lastIndex = balanced.endIndex + 1;
+    }
+    return {
+        filePath,
+        routers,
+        imports,
+    };
+}
+function resolveFastApiRouters(analyses) {
+    const resolved = new Map();
+    const byFile = new Map(analyses.map((analysis) => [analysis.filePath, analysis]));
+    for (const analysis of analyses) {
+        for (const router of analysis.routers.values()) {
+            const mounts = [];
+            for (const mount of router.mounts) {
+                let targetId;
+                if (analysis.routers.has(mount.targetLocalName)) {
+                    targetId = analysis.routers.get(mount.targetLocalName).id;
+                }
+                else {
+                    const binding = analysis.imports.get(mount.targetLocalName);
+                    const importedAnalysis = binding ? byFile.get(binding.targetFile) : undefined;
+                    const importedRouter = importedAnalysis?.routers.get(binding?.exportName ?? '');
+                    if (importedRouter) {
+                        targetId = importedRouter.id;
+                    }
+                }
+                if (targetId) {
+                    mounts.push({
+                        prefix: mount.prefix,
+                        tags: mount.tags,
+                        auth: mount.auth,
+                        targetId,
+                    });
+                }
+            }
+            resolved.set(router.id, {
+                ...router,
+                mounts,
+            });
+        }
+    }
+    return resolved;
+}
+export function extractFromFastApi(projectRoot) {
+    const files = collectProjectFiles(projectRoot, { extensions: PYTHON_EXTENSIONS });
+    const analyses = files
+        .map((filePath) => {
+        const content = tryReadFile(filePath);
+        return content ? analyzeFastApiFile(projectRoot, filePath, content) : null;
+    })
+        .filter((item) => item !== null);
+    const routers = resolveFastApiRouters(analyses);
+    if (routers.size === 0) {
+        return null;
+    }
+    const parentCounts = new Map();
+    for (const router of routers.values()) {
+        parentCounts.set(router.id, parentCounts.get(router.id) ?? 0);
+        for (const mount of router.mounts) {
+            parentCounts.set(mount.targetId, (parentCounts.get(mount.targetId) ?? 0) + 1);
+        }
+    }
+    const roots = [...routers.values()].filter((router) => router.kind === 'app' || (parentCounts.get(router.id) ?? 0) === 0);
+    const endpoints = [];
+    const sourceFiles = new Set();
+    const visited = new Set();
+    function walk(routerId, prefix, inheritedTags, inheritedAuth) {
+        const router = routers.get(routerId);
+        if (!router) {
+            return;
+        }
+        const combinedPrefix = joinUrlPaths(prefix, router.prefix);
+        const routerTags = uniqueStrings([...inheritedTags, ...router.tags]);
+        const routerAuth = uniqueStrings([...inheritedAuth, ...router.auth]);
+        for (const route of router.routes) {
+            const fullPath = joinUrlPaths(combinedPrefix, route.path);
+            const auth = collectAuthHints([...routerAuth, ...route.auth]);
+            const tags = uniqueStrings([...routerTags, ...route.tags]);
+            sourceFiles.add(route.sourceFile);
+            endpoints.push({
+                method: route.method,
+                path: fullPath,
+                parameters: route.parameters,
+                responses: [{
+                        statusCode: '200',
+                        type: normalizeTypeText(route.responseType),
+                    }],
+                responseType: normalizeTypeText(route.responseType),
+                auth,
+                tags,
+                source: 'introspection',
+                sourceFile: route.sourceFile,
+                summary: route.summary,
+                operationId: route.operationId,
+            });
+        }
+        for (const mount of router.mounts) {
+            const visitKey = `${routerId}->${mount.targetId}:${mount.prefix}`;
+            if (visited.has(visitKey)) {
+                continue;
+            }
+            visited.add(visitKey);
+            walk(mount.targetId, joinUrlPaths(combinedPrefix, mount.prefix), [...routerTags, ...mount.tags], [...routerAuth, ...mount.auth]);
+        }
+    }
+    const rootRouters = roots.length > 0 ? roots : [...routers.values()];
+    for (const root of rootRouters) {
+        walk(root.id, '', [], []);
+    }
+    const deduped = dedupeEndpoints(endpoints);
+    if (deduped.length === 0) {
+        return null;
+    }
+    return {
+        source: 'introspection',
+        endpoints: deduped,
+        sourceFiles: [...sourceFiles].sort(),
+    };
+}
+//# sourceMappingURL=fastapi-extractor.js.map

package/dist/panoramic/api-surface/fastapi-extractor.js.map

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

package/dist/panoramic/api-surface/framework-introspection.d.ts

@@ -0,0 +1,3 @@
+import type { ExtractionResult } from './types.js';
+export declare function extractFromFrameworkIntrospection(projectRoot: string): ExtractionResult | null;
+//# sourceMappingURL=framework-introspection.d.ts.map

package/dist/panoramic/api-surface/framework-introspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-introspection.d.ts","sourceRoot":"","sources":["../../../src/panoramic/api-surface/framework-introspection.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAmD,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAwMpG,wBAAgB,iCAAiC,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAoB9F"}

package/dist/panoramic/api-surface/framework-introspection.js

@@ -0,0 +1,189 @@
+/**
+ * tsoa / NestJS 框架自省 + 桥接函数
+ */
+import { Project, Node } from 'ts-morph';
+import { collectProjectFiles, getRelativePath, joinUrlPaths, stripWrappingQuotes, TS_SOURCE_EXTENSIONS, TSOA_HTTP_DECORATORS, uniqueStrings, } from './utils.js';
+import { dedupeEndpoints, normalizeTypeText } from './endpoint-utils.js';
+import { extractFromFastApi } from './fastapi-extractor.js';
+import { createLogger } from '../utils/logger.js';
+const logger = createLogger('framework-introspection');
+// ============================================================
+// tsoa 解析函数
+// ============================================================
+function extractDecoratorStringArg(decorator) {
+    if (!decorator || !Node.isDecorator(decorator)) {
+        return null;
+    }
+    const firstArg = decorator.getArguments()[0];
+    if (!firstArg) {
+        return null;
+    }
+    return stripWrappingQuotes(firstArg.getText());
+}
+function extractDecoratorStringArgs(decorator) {
+    if (!decorator || !Node.isDecorator(decorator)) {
+        return [];
+    }
+    return decorator.getArguments()
+        .map((arg) => stripWrappingQuotes(arg.getText()))
+        .filter((item) => item !== null);
+}
+function extractTsoaSecurity(decorators) {
+    const authHints = [];
+    for (const decorator of decorators) {
+        if (!Node.isDecorator(decorator) || decorator.getName() !== 'Security') {
+            continue;
+        }
+        const arg = decorator.getArguments()[0];
+        const value = arg ? stripWrappingQuotes(arg.getText()) : null;
+        if (value) {
+            authHints.push(value);
+        }
+    }
+    return uniqueStrings(authHints).sort();
+}
+function parseTsoaParameter(parameter) {
+    if (!Node.isParameterDeclaration(parameter)) {
+        return null;
+    }
+    const decorators = parameter.getDecorators();
+    if (decorators.length === 0) {
+        return null;
+    }
+    let location = null;
+    let name = parameter.getName();
+    for (const decorator of decorators) {
+        const decoratorName = decorator.getName();
+        if (decoratorName === 'Path')
+            location = 'path';
+        else if (decoratorName === 'Query')
+            location = 'query';
+        else if (decoratorName === 'Body' || decoratorName === 'BodyProp')
+            location = 'body';
+        else if (decoratorName === 'Header')
+            location = 'header';
+        else if (decoratorName === 'Cookie')
+            location = 'cookie';
+        else if (decoratorName === 'FormField')
+            location = 'form';
+        if (location) {
+            const alias = extractDecoratorStringArg(decorator);
+            if (alias) {
+                name = alias;
+            }
+            break;
+        }
+    }
+    if (!location) {
+        return null;
+    }
+    return {
+        name,
+        in: location,
+        type: normalizeTypeText(parameter.getTypeNode()?.getText()),
+        required: location === 'path' ? true : !parameter.isOptional(),
+    };
+}
+function extractFromTsoa(projectRoot) {
+    const files = collectProjectFiles(projectRoot, {
+        extensions: TS_SOURCE_EXTENSIONS.filter((ext) => ext !== '.js' && ext !== '.jsx'),
+    });
+    if (files.length === 0) {
+        return null;
+    }
+    const project = new Project({
+        skipAddingFilesFromTsConfig: true,
+        compilerOptions: {
+            allowJs: true,
+            experimentalDecorators: true,
+        },
+    });
+    for (const filePath of files) {
+        try {
+            project.addSourceFileAtPath(filePath);
+        }
+        catch (err) {
+            logger.warn(`TS/JS 文件解析失败，已跳过: ${filePath}`, String(err));
+        }
+    }
+    const endpoints = [];
+    const sourceFiles = new Set();
+    for (const sourceFile of project.getSourceFiles()) {
+        const relativePath = getRelativePath(projectRoot, sourceFile.getFilePath());
+        for (const classDecl of sourceFile.getClasses()) {
+            const routeDecorator = classDecl.getDecorators().find((decorator) => decorator.getName() === 'Route');
+            if (!routeDecorator) {
+                continue;
+            }
+            const classRoute = extractDecoratorStringArg(routeDecorator) ?? '/';
+            const classTags = extractDecoratorStringArgs(classDecl.getDecorators().find((decorator) => decorator.getName() === 'Tags'));
+            const classSecurity = extractTsoaSecurity(classDecl.getDecorators());
+            for (const methodDecl of classDecl.getMethods()) {
+                const httpDecorator = methodDecl.getDecorators().find((decorator) => TSOA_HTTP_DECORATORS.has(decorator.getName()));
+                if (!httpDecorator) {
+                    continue;
+                }
+                const method = TSOA_HTTP_DECORATORS.get(httpDecorator.getName());
+                const methodRoute = extractDecoratorStringArg(httpDecorator) ?? '/';
+                const methodTags = extractDecoratorStringArgs(methodDecl.getDecorators().find((decorator) => decorator.getName() === 'Tags'));
+                const auth = uniqueStrings([
+                    ...classSecurity,
+                    ...extractTsoaSecurity(methodDecl.getDecorators()),
+                ]);
+                const parameters = methodDecl.getParameters()
+                    .map((parameter) => parseTsoaParameter(parameter))
+                    .filter((parameter) => parameter !== null);
+                const responseType = normalizeTypeText(methodDecl.getReturnTypeNode()?.getText());
+                const fullPath = joinUrlPaths(classRoute, methodRoute);
+                sourceFiles.add(relativePath);
+                endpoints.push({
+                    method,
+                    path: fullPath,
+                    parameters,
+                    responses: [{
+                            statusCode: '200',
+                            type: responseType,
+                        }],
+                    responseType,
+                    auth,
+                    tags: uniqueStrings([...classTags, ...methodTags]),
+                    source: 'introspection',
+                    sourceFile: relativePath,
+                    operationId: methodDecl.getName(),
+                });
+            }
+        }
+    }
+    const deduped = dedupeEndpoints(endpoints);
+    if (deduped.length === 0) {
+        return null;
+    }
+    return {
+        source: 'introspection',
+        endpoints: deduped,
+        sourceFiles: [...sourceFiles].sort(),
+    };
+}
+// ============================================================
+// 桥接函数：合并 FastAPI + tsoa 结果
+// ============================================================
+export function extractFromFrameworkIntrospection(projectRoot) {
+    const fastApiResult = extractFromFastApi(projectRoot);
+    const tsoaResult = extractFromTsoa(projectRoot);
+    const endpoints = dedupeEndpoints([
+        ...(fastApiResult?.endpoints ?? []),
+        ...(tsoaResult?.endpoints ?? []),
+    ]);
+    if (endpoints.length === 0) {
+        return null;
+    }
+    return {
+        source: 'introspection',
+        endpoints,
+        sourceFiles: uniqueStrings([
+            ...(fastApiResult?.sourceFiles ?? []),
+            ...(tsoaResult?.sourceFiles ?? []),
+        ]).sort(),
+    };
+}
+//# sourceMappingURL=framework-introspection.js.map

package/dist/panoramic/api-surface/framework-introspection.js.map

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

package/dist/panoramic/api-surface/index.d.ts

@@ -0,0 +1,13 @@
+import type { DocumentGenerator, ProjectContext, GenerateOptions } from '../interfaces.js';
+import type { ApiSurfaceInput, ApiSurfaceOutput } from './types.js';
+export type { ApiSource, ApiParameterLocation, ApiParameter, ApiResponse, ApiEndpoint, ApiSurfaceInput, ApiSurfaceOutput, } from './types.js';
+export declare class ApiSurfaceGenerator implements DocumentGenerator<ApiSurfaceInput, ApiSurfaceOutput> {
+    readonly id: "api-surface";
+    readonly name: "API Surface Reference \u751F\u6210\u5668";
+    readonly description = "\u6309 schema -> introspection -> ast \u4F18\u5148\u7EA7\u751F\u6210 API Surface Reference";
+    isApplicable(context: ProjectContext): Promise<boolean>;
+    extract(context: ProjectContext): Promise<ApiSurfaceInput>;
+    generate(input: ApiSurfaceInput, _options?: GenerateOptions): Promise<ApiSurfaceOutput>;
+    render(output: ApiSurfaceOutput): string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/panoramic/api-surface/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/panoramic/api-surface/index.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE3F,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAKjB,MAAM,YAAY,CAAC;AAuBpB,YAAY,EACV,SAAS,EACT,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,WAAW,EACX,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAoKpB,qBAAa,mBACX,YAAW,iBAAiB,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAE/D,QAAQ,CAAC,EAAE,EAAG,aAAa,CAAU;IACrC,QAAQ,CAAC,IAAI,EAAG,0CAA2B,CAAU;IACrD,QAAQ,CAAC,WAAW,gGAAkE;IAEhF,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IA0BvD,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAyC1D,QAAQ,CACZ,KAAK,EAAE,eAAe,EACtB,QAAQ,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,gBAAgB,CAAC;IAwB5B,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM;CAIzC"}