nestjs-openapi-parser 0.0.1

package/dist/parser/path-builder.js

@@ -0,0 +1,464 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PathBuilder = void 0;
+const ts_morph_1 = require("ts-morph");
+const ast_index_1 = require("./ast-index");
+const tags_1 = require("./tags");
+const HTTP_METHODS = {
+    Get: 'get',
+    Post: 'post',
+    Put: 'put',
+    Delete: 'delete',
+    Patch: 'patch',
+};
+// NestJS's `HttpStatus` enum (from `@nestjs/common`) member name → numeric code.
+// Used to resolve `@HttpCode(HttpStatus.NO_CONTENT)` statically, since we can't
+// import `@nestjs/common` to read the value at runtime.
+const HTTP_STATUS_CODES = {
+    CONTINUE: 100,
+    SWITCHING_PROTOCOLS: 101,
+    PROCESSING: 102,
+    EARLYHINTS: 103,
+    OK: 200,
+    CREATED: 201,
+    ACCEPTED: 202,
+    NON_AUTHORITATIVE_INFORMATION: 203,
+    NO_CONTENT: 204,
+    RESET_CONTENT: 205,
+    PARTIAL_CONTENT: 206,
+    AMBIGUOUS: 300,
+    MOVED_PERMANENTLY: 301,
+    FOUND: 302,
+    SEE_OTHER: 303,
+    NOT_MODIFIED: 304,
+    TEMPORARY_REDIRECT: 307,
+    PERMANENT_REDIRECT: 308,
+    BAD_REQUEST: 400,
+    UNAUTHORIZED: 401,
+    PAYMENT_REQUIRED: 402,
+    FORBIDDEN: 403,
+    NOT_FOUND: 404,
+    METHOD_NOT_ALLOWED: 405,
+    NOT_ACCEPTABLE: 406,
+    PROXY_AUTHENTICATION_REQUIRED: 407,
+    REQUEST_TIMEOUT: 408,
+    CONFLICT: 409,
+    GONE: 410,
+    LENGTH_REQUIRED: 411,
+    PRECONDITION_FAILED: 412,
+    PAYLOAD_TOO_LARGE: 413,
+    URI_TOO_LONG: 414,
+    UNSUPPORTED_MEDIA_TYPE: 415,
+    REQUESTED_RANGE_NOT_SATISFIABLE: 416,
+    EXPECTATION_FAILED: 417,
+    I_AM_A_TEAPOT: 418,
+    MISDIRECTED: 421,
+    UNPROCESSABLE_ENTITY: 422,
+    FAILED_DEPENDENCY: 424,
+    PRECONDITION_REQUIRED: 428,
+    TOO_MANY_REQUESTS: 429,
+    INTERNAL_SERVER_ERROR: 500,
+    NOT_IMPLEMENTED: 501,
+    BAD_GATEWAY: 502,
+    SERVICE_UNAVAILABLE: 503,
+    GATEWAY_TIMEOUT: 504,
+    HTTP_VERSION_NOT_SUPPORTED: 505,
+};
+/** Humanize a method name: split camelCase/PascalCase boundaries and capitalize. */
+function humanizeMethodName(name) {
+    const spaced = name
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2');
+    return spaced.charAt(0).toUpperCase() + spaced.slice(1);
+}
+/**
+ * Converts NestJS controllers into the OpenAPI `paths` object by static analysis:
+ * `@Controller` + HTTP route decorators, `@Param/@Query/@Body/@Headers`, method
+ * return types, and pluggable hooks for response envelope and security.
+ */
+class PathBuilder {
+    index;
+    schemaBuilder;
+    paths = {};
+    usedOperationIds = new Set();
+    tags = new Map();
+    /** Distinct method-level `@Tag` names seen, declared in root after controllers. */
+    methodTagNames = new Set();
+    globalPrefix;
+    hooks;
+    registeredSchemes;
+    activeScopes;
+    knownScopes;
+    constructor(index, schemaBuilder, options = {}) {
+        this.index = index;
+        this.schemaBuilder = schemaBuilder;
+        this.globalPrefix = options.globalPrefix ?? '';
+        this.hooks = options.hooks ?? {};
+        this.registeredSchemes = options.registeredSchemes ?? [];
+        this.activeScopes = options.activeScopes ?? new Set();
+        this.knownScopes = options.knownScopes;
+    }
+    build() {
+        for (const controller of this.index.getControllers()) {
+            this.processController(controller);
+        }
+        // Declare any method-level @Tag name no controller already declared, so the
+        // operation's tag isn't dangling. Done after all controllers so a controller's
+        // description always wins over a description-less method-tag placeholder.
+        for (const name of this.methodTagNames) {
+            if (!this.tags.has(name))
+                this.tags.set(name, undefined);
+        }
+        return this.paths;
+    }
+    /**
+     * Root `tags[]` entries: one per distinct tag name in play. Controller tags
+     * (name from `@Tag`/the default-tag hook, description from the class JSDoc;
+     * first controller wins on a shared name) come first, then any method-level
+     * `@Tag` name a controller didn't already declare — description-less, since a
+     * method's JSDoc is its operation description, not a tag description.
+     */
+    getTags() {
+        return [...this.tags.entries()].map(([name, description]) => description ? { name, description } : { name });
+    }
+    processController(controller) {
+        if (!(0, tags_1.isVisible)((0, tags_1.getScopes)((0, tags_1.getTags)(controller)), this.activeScopes))
+            return;
+        // @Controller and the route decorators each accept `string | string[]`; an
+        // array prefix/path means the handler is mapped to several routes at once.
+        const basePathArgs = this.stringArgs(controller.getDecorator('Controller'), 0);
+        const basePaths = basePathArgs.length ? basePathArgs : [''];
+        const controllerTagBag = (0, tags_1.getTags)(controller);
+        const tag = controllerTagBag.Tag?.[0] ?? (this.hooks.controllerTag ?? this.defaultTag)(controller);
+        if (!this.tags.has(tag)) {
+            const rawDesc = controller.getJsDocs()[0]?.getCommentText();
+            const desc = rawDesc
+                ? (0, tags_1.filterScopedComments)(rawDesc, this.activeScopes, {
+                    itemPath: `${controller.getName() ?? '<anon>'} (tag)`,
+                    knownScopes: this.knownScopes,
+                })
+                : undefined;
+            this.tags.set(tag, desc || undefined);
+        }
+        for (const method of controller.getInstanceMethods()) {
+            if (!(0, tags_1.isVisible)((0, tags_1.getScopes)((0, tags_1.getTags)(method)), this.activeScopes))
+                continue;
+            const httpDecorator = method.getDecorators().find((d) => HTTP_METHODS[d.getName()]);
+            if (!httpDecorator)
+                continue;
+            const httpMethod = HTTP_METHODS[httpDecorator.getName()];
+            const routeArgs = this.stringArgs(httpDecorator, 0);
+            const routePaths = routeArgs.length ? routeArgs : [''];
+            const methodTag = (0, tags_1.getTags)(method).Tag?.[0] ?? tag;
+            // One operation per (controller prefix × route path × optional-param
+            // expansion) combination. Each gets its own operationId (uniqueOperationId
+            // de-dups) and its own path params, since placeholders can differ per path.
+            for (const base of basePaths) {
+                for (const route of routePaths) {
+                    const rawPath = this.joinPath(this.globalPrefix, base, route);
+                    for (const fullPath of this.expandRoutePaths(rawPath, controller, method)) {
+                        this.methodTagNames.add(methodTag);
+                        const templateParams = this.pathParamNames(fullPath);
+                        const operation = this.buildOperation(controller, method, httpMethod, methodTag, templateParams);
+                        this.paths[fullPath] ??= {};
+                        this.paths[fullPath][httpMethod] = operation;
+                    }
+                }
+            }
+        }
+    }
+    buildOperation(controller, method, httpMethod, tag, pathParamNames) {
+        const operation = {
+            operationId: this.uniqueOperationId(tag, method.getName()),
+            tags: [tag],
+        };
+        const summary = this.resolveSummary(controller, method, httpMethod);
+        if (summary)
+            operation.summary = summary;
+        const rawDesc = method.getJsDocs()[0]?.getCommentText();
+        const desc = rawDesc
+            ? (0, tags_1.filterScopedComments)(rawDesc, this.activeScopes, {
+                itemPath: `${controller.getName() ?? '<anon>'}.${method.getName()}`,
+                knownScopes: this.knownScopes,
+            })
+            : undefined;
+        if (desc)
+            operation.description = desc;
+        // Collect explicit @Param('name') schemas keyed by name, plus query/header
+        // params in declaration order. Path params are emitted from the route
+        // template below, not from this loop, so the spec can never reference a
+        // `{param}` that has no parameter object.
+        const explicitPathParams = new Map();
+        const otherParameters = [];
+        let requestBody;
+        for (const param of method.getParameters()) {
+            const decorator = param
+                .getDecorators()
+                .find((d) => ['Param', 'Query', 'Body', 'Headers'].includes(d.getName()));
+            if (!decorator)
+                continue;
+            switch (decorator.getName()) {
+                case 'Param': {
+                    const name = this.stringArg(decorator, 0);
+                    // A @Param('name') whose name isn't in the route template can't be a
+                    // valid path parameter, so it's recorded here and only used if the
+                    // template actually declares it.
+                    if (name)
+                        explicitPathParams.set(name, this.paramSchema(decorator, param));
+                    break;
+                }
+                case 'Query':
+                    otherParameters.push(...this.buildQueryParameters(decorator, param));
+                    break;
+                case 'Headers': {
+                    const headerName = this.stringArg(decorator, 0);
+                    if (headerName) {
+                        otherParameters.push({
+                            name: headerName,
+                            in: 'header',
+                            required: false,
+                            schema: { type: 'string' },
+                        });
+                    }
+                    break;
+                }
+                case 'Body':
+                    requestBody = this.buildRequestBody(param);
+                    break;
+            }
+        }
+        // Every `{param}` in the route template must have a path-parameter entry, in
+        // template order — even when the handler never binds it with @Param('name')
+        // (e.g. it uses `@Param() all`, `@Req()`, or the name simply doesn't match).
+        // Such placeholders default to `string`.
+        const parameters = pathParamNames.map((name) => ({
+            name,
+            in: 'path',
+            required: true,
+            schema: explicitPathParams.get(name) ?? { type: 'string' },
+        }));
+        parameters.push(...otherParameters);
+        if (parameters.length)
+            operation.parameters = parameters;
+        if (requestBody)
+            operation.requestBody = requestBody;
+        operation.responses = this.buildResponses(method, httpMethod);
+        const security = this.buildSecurity(controller, method);
+        if (security !== undefined)
+            operation.security = security;
+        return operation;
+    }
+    /**
+     * The operation `summary`: a method-level `@Name` JSDoc tag (highest priority),
+     * else the `endpointSummary` hook when it returns a value, else the default —
+     * the method name humanized.
+     */
+    resolveSummary(controller, method, httpMethod) {
+        const named = (0, tags_1.getTags)(method).Name?.[0];
+        if (named)
+            return named;
+        const defaultSummary = humanizeMethodName(method.getName());
+        return (this.hooks.endpointSummary?.({ controller, method, httpMethod, defaultSummary }) ??
+            defaultSummary);
+    }
+    buildQueryParameters(decorator, param) {
+        const argName = this.stringArg(decorator, 0);
+        if (argName) {
+            return [
+                { name: argName, in: 'query', required: false, schema: this.paramSchema(decorator, param) },
+            ];
+        }
+        // `@Query() dto: SomeDTO` -> expand DTO properties into individual query params.
+        const className = ast_index_1.AstIndex.symbolName(param.getType());
+        const clazz = className ? this.index.getClass(className) : undefined;
+        if (!clazz)
+            return [];
+        const members = this.schemaBuilder.buildMembers(clazz);
+        return Object.entries(members.properties).map(([name, schema]) => ({
+            name,
+            in: 'query',
+            required: members.required.includes(name),
+            schema,
+        }));
+    }
+    buildRequestBody(param) {
+        const schema = this.schemaBuilder.typeToSchema(param.getType());
+        return { required: true, content: { 'application/json': { schema } } };
+    }
+    buildResponses(method, httpMethod) {
+        let returnType = method.getReturnType();
+        if (ast_index_1.AstIndex.symbolName(returnType) === 'Promise') {
+            const args = returnType.getTypeArguments();
+            if (args.length)
+                returnType = args[0];
+        }
+        const responseSchema = this.computeResponseSchema(method, returnType);
+        const status = this.responseStatus(method, httpMethod);
+        const response = { description: 'Successful response' };
+        if (responseSchema !== undefined) {
+            response.content = { 'application/json': { schema: responseSchema } };
+        }
+        return { [status]: response };
+    }
+    /**
+     * The success status code for an operation: an explicit `@HttpCode(...)` when
+     * present — either a numeric literal (`@HttpCode(204)`) or an `HttpStatus`
+     * member (`@HttpCode(HttpStatus.NO_CONTENT)`) — otherwise NestJS's default:
+     * 201 for POST, 200 for every other verb.
+     */
+    responseStatus(method, httpMethod) {
+        const arg = method.getDecorator('HttpCode')?.getArguments()[0];
+        if (arg) {
+            if (ts_morph_1.Node.isNumericLiteral(arg))
+                return String(arg.getLiteralValue());
+            if (ts_morph_1.Node.isPropertyAccessExpression(arg)) {
+                const code = HTTP_STATUS_CODES[arg.getName()];
+                if (code !== undefined)
+                    return String(code);
+            }
+        }
+        return httpMethod === 'post' ? '201' : '200';
+    }
+    computeResponseSchema(method, returnType) {
+        const isEmpty = returnType.isVoid() || returnType.isUndefined();
+        if (!this.hooks.buildResponseSchema) {
+            return isEmpty ? undefined : this.schemaBuilder.typeToSchema(returnType);
+        }
+        return this.hooks.buildResponseSchema({
+            method,
+            returnType,
+            returnTypeName: ast_index_1.AstIndex.symbolName(returnType),
+            returnTypeArgs: returnType.getTypeArguments(),
+            defaultSchema: () => (isEmpty ? {} : this.schemaBuilder.typeToSchema(returnType)),
+            typeToSchema: (t) => this.schemaBuilder.typeToSchema(t),
+        });
+    }
+    buildSecurity(controller, method) {
+        if (this.hooks.resolveSecurity) {
+            return this.hooks.resolveSecurity({
+                controller,
+                method,
+                registeredSchemes: this.registeredSchemes,
+            });
+        }
+        // Default: every registered scheme applies (logical OR).
+        if (this.registeredSchemes.length === 0)
+            return undefined;
+        return this.registeredSchemes.map((name) => ({ [name]: [] }));
+    }
+    paramSchema(decorator, param) {
+        const argsText = decorator
+            .getArguments()
+            .map((a) => a.getText())
+            .join(' ');
+        if (argsText.includes('ParseUUIDPipe'))
+            return { type: 'string', format: 'uuid' };
+        if (argsText.includes('ParseIntPipe'))
+            return { type: 'integer' };
+        if (argsText.includes('ParseBoolPipe'))
+            return { type: 'boolean' };
+        return this.schemaBuilder.typeToSchema(param.getType());
+    }
+    stringArg(decorator, index) {
+        if (!decorator)
+            return undefined;
+        const arg = decorator.getArguments()[index];
+        return arg && ts_morph_1.Node.isStringLiteral(arg) ? arg.getLiteralValue() : undefined;
+    }
+    /**
+     * Read a decorator argument that may be a string literal or an array of string
+     * literals (`@Get('a')` or `@Get(['a', 'b'])`), returning the distinct values.
+     * Non-string and dynamic entries are skipped; the result is empty when absent.
+     */
+    stringArgs(decorator, index) {
+        if (!decorator)
+            return [];
+        const arg = decorator.getArguments()[index];
+        if (!arg)
+            return [];
+        let values = [];
+        if (ts_morph_1.Node.isStringLiteral(arg)) {
+            values = [arg.getLiteralValue()];
+        }
+        else if (ts_morph_1.Node.isArrayLiteralExpression(arg)) {
+            values = arg
+                .getElements()
+                .filter(ts_morph_1.Node.isStringLiteral)
+                .map((el) => el.getLiteralValue());
+        }
+        return [...new Set(values)];
+    }
+    defaultTag(controller) {
+        const base = (controller.getName() ?? 'Default').replace(/Controller$/, '');
+        return base.replace(/([a-z0-9])([A-Z])/g, '$1 $2').replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2');
+    }
+    uniqueOperationId(tag, methodName) {
+        const base = `${tag.replace(/\s+/g, '')}_${methodName}`;
+        let id = base;
+        let counter = 2;
+        while (this.usedOperationIds.has(id))
+            id = `${base}_${counter++}`;
+        this.usedOperationIds.add(id);
+        return id;
+    }
+    joinPath(...parts) {
+        return ('/' + parts.filter(Boolean).join('/')).replace(/\/{2,}/g, '/');
+    }
+    /**
+     * Turn a raw NestJS route (with `:params`) into the OpenAPI path(s) it maps to.
+     *
+     *  - An optional param (`:id?`) expands into the with/without pair, because
+     *    OpenAPI path params are always required (`a/:id?` → `/a` and `/a/{id}`).
+     *  - Constructs OpenAPI can't represent — inline regex (`:id(\d+)`), wildcards
+     *    (`*`, `:splat*`), `+`/`*` modifiers, and more than one optional param —
+     *    cause the route to be skipped with a warning.
+     */
+    expandRoutePaths(rawPath, controller, method) {
+        const where = () => `${controller.getName() ?? '<anon>'}.${method.getName()}`;
+        const skip = (reason) => {
+            console.warn(`[nestparser] Skipping route "${rawPath}" (${where()}): ${reason}`);
+            return [];
+        };
+        if (/[*+()]/.test(rawPath)) {
+            return skip("unsupported path pattern (regex, wildcard or modifier). Only ':param' and optional ':param?' are handled.");
+        }
+        const segments = rawPath.split('/').filter(Boolean);
+        const optionalIdx = segments.flatMap((s, i) => (/^:[A-Za-z0-9_]+\?$/.test(s) ? [i] : []));
+        if (optionalIdx.length > 1) {
+            return skip("more than one optional ':param?' in a route is not supported.");
+        }
+        if (optionalIdx.length === 0) {
+            return [this.toOpenApiPath('/' + segments.join('/'))];
+        }
+        // Exactly one optional: emit the route without that segment, and with it
+        // present (the trailing `?` dropped so it's a normal required param).
+        const i = optionalIdx[0];
+        const without = segments.filter((_, idx) => idx !== i);
+        const present = segments.map((s, idx) => (idx === i ? s.slice(0, -1) : s));
+        return [
+            this.toOpenApiPath('/' + without.join('/')),
+            this.toOpenApiPath('/' + present.join('/')),
+        ];
+    }
+    toOpenApiPath(routePath) {
+        let out = routePath.replace(/:([A-Za-z0-9_]+)/g, '{$1}');
+        if (out.length > 1 && out.endsWith('/'))
+            out = out.slice(0, -1);
+        return out;
+    }
+    /** Names of the `{param}` placeholders in an OpenAPI path, in order, deduped. */
+    pathParamNames(openApiPath) {
+        const names = [];
+        const seen = new Set();
+        for (const match of openApiPath.matchAll(/\{([^}]+)\}/g)) {
+            const name = match[1];
+            if (!seen.has(name)) {
+                seen.add(name);
+                names.push(name);
+            }
+        }
+        return names;
+    }
+}
+exports.PathBuilder = PathBuilder;
+//# sourceMappingURL=path-builder.js.map

package/dist/parser/path-builder.js.map

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

package/dist/parser/schema-builder.d.ts

@@ -0,0 +1,70 @@
+import { ClassDeclaration, Type } from 'ts-morph';
+import type { OpenApiSchema } from '../types/openapi';
+import { AstIndex } from './ast-index';
+export interface SchemaBuilderOptions {
+    activeScopes?: Set<string>;
+    /** Scope vocabulary used to recognize `<scope>…</scope>` description fragments. */
+    knownScopes?: Set<string>;
+}
+export interface SchemaMembers {
+    properties: Record<string, OpenApiSchema>;
+    required: string[];
+}
+/**
+ * Converts TypeScript classes (entities & DTOs) into OpenAPI `components.schemas`.
+ * Handles:
+ *  - required derived from `@IsOptional()` / `?` (configurable)
+ *  - `@Exclude()` properties omitted (configurable)
+ *  - union object types -> `oneOf`, string-literal unions -> enum
+ *  - `PartialType / PickType / OmitType / IntersectionType` heritage
+ */
+export declare class SchemaBuilder {
+    private readonly index;
+    private readonly schemas;
+    private readonly pending;
+    private readonly done;
+    private readonly activeScopes;
+    private readonly knownScopes;
+    constructor(index: AstIndex, options?: SchemaBuilderOptions);
+    /** Register a reference to a class schema and return the `$ref` fragment. */
+    registerRef(name: string): OpenApiSchema;
+    /** Process the queue until no schema remains to build. */
+    build(): void;
+    getSchemas(): Record<string, OpenApiSchema>;
+    /** Public entry to map an arbitrary type to an OpenAPI schema fragment. */
+    typeToSchema(type: Type): OpenApiSchema;
+    /** Flatten a class's properties (own + inherited / mapped-type heritage). */
+    buildMembers(clazz: ClassDeclaration): SchemaMembers;
+    private buildOwnMembers;
+    /** Resolve `PartialType() / PickType() / OmitType() / IntersectionType()` heritage. */
+    private resolveHeritage;
+    private schemaForType;
+    /**
+     * Build the schema for a named TS enum, deriving `type` from the member
+     * values rather than assuming strings:
+     *  - all strings        -> `string`
+     *  - all integers       -> `integer`
+     *  - all numbers (some non-integer) -> `number`
+     *  - mixed string/number -> `type` omitted (no single OpenAPI type fits)
+     */
+    private enumSchema;
+    /**
+     * Merge class-validator constraints from a property's decorators into its
+     * schema. Unknown decorators are ignored. A `$ref` is left untouched (its
+     * siblings are ignored by OpenAPI 3.0, so constraints don't belong on it).
+     *
+     *  - `@Min/@Max`                  -> `minimum` / `maximum`
+     *  - `@MinLength/@MaxLength`      -> `minLength` / `maxLength`
+     *  - `@Length(min, max)`         -> `minLength` + `maxLength`
+     *  - `@ArrayMinSize/@ArrayMaxSize` -> `minItems` / `maxItems`
+     *  - `@IsEmail/@IsUrl/@IsUUID/@IsDateString` -> `format`
+     *  - `@Matches(/re/)`            -> `pattern`
+     *  - `@IsInt`                    -> narrows `number` to `integer`
+     *  - `@IsPositive/@IsNegative`   -> exclusive `minimum` / `maximum` of 0
+     */
+    private applyValidatorConstraints;
+    private mergeMembers;
+    private pick;
+    private omit;
+    private parseStringArray;
+}