@tsoa-next/cli 7.1.0

package/dist/metadataGeneration/controllerGenerator.js

@@ -0,0 +1,229 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ControllerGenerator = void 0;
+const decoratorUtils_1 = require("./../utils/decoratorUtils");
+const exceptions_1 = require("./exceptions");
+const methodGenerator_1 = require("./methodGenerator");
+const typeResolver_1 = require("./typeResolver");
+const headerTypeHelpers_1 = require("../utils/headerTypeHelpers");
+const typescript_1 = require("typescript");
+class ControllerGenerator {
+    node;
+    current;
+    parentSecurity;
+    path;
+    tags;
+    security;
+    isHidden;
+    commonResponses;
+    produces;
+    constructor(node, current, parentSecurity = []) {
+        this.node = node;
+        this.current = current;
+        this.parentSecurity = parentSecurity;
+        this.path = this.getPath();
+        this.tags = this.getTags();
+        this.security = this.getSecurity();
+        this.isHidden = this.getIsHidden();
+        this.commonResponses = this.getCommonResponses();
+        this.produces = this.getProduces();
+    }
+    IsValid() {
+        return !!this.path || this.path === '';
+    }
+    Generate() {
+        if (!this.node.parent) {
+            throw new exceptions_1.GenerateMetadataError("Controller node doesn't have a valid parent source file.");
+        }
+        if (!this.node.name) {
+            throw new exceptions_1.GenerateMetadataError("Controller node doesn't have a valid name.");
+        }
+        const sourceFile = this.node.parent.getSourceFile();
+        return {
+            location: sourceFile.fileName,
+            methods: this.buildMethods(),
+            name: this.node.name.text,
+            path: this.path || '',
+            produces: this.produces,
+        };
+    }
+    buildMethods() {
+        return this.getMethodsWithInheritedMethods()
+            .map(m => new methodGenerator_1.MethodGenerator(m, this.current, this.commonResponses, this.path, this.tags, this.security, this.isHidden))
+            .filter(generator => generator.IsValid())
+            .map(generator => generator.Generate());
+    }
+    getMethodsWithInheritedMethods() {
+        const inheritanceChain = this.getInheritanceChainForRoutes();
+        if (inheritanceChain.length === 1) {
+            return this.node.members.filter(typescript_1.isMethodDeclaration);
+        }
+        // Process from base to derived so derived classes can override inherited names.
+        const methodsByName = new Map();
+        inheritanceChain.reverse().forEach(classDeclaration => {
+            classDeclaration.members.filter(typescript_1.isMethodDeclaration).forEach(method => {
+                const key = this.getMethodKey(method);
+                if (!key) {
+                    return;
+                }
+                methodsByName.set(key, method);
+            });
+        });
+        return [...methodsByName.values()];
+    }
+    getInheritanceChainForRoutes() {
+        const chain = [this.node];
+        let hasRuntimeControllerBase = false;
+        let currentClass = this.node;
+        while (currentClass) {
+            const { baseClass, extendsRuntimeController } = this.getDirectBaseClassInfo(currentClass);
+            if (extendsRuntimeController) {
+                hasRuntimeControllerBase = true;
+                break;
+            }
+            if (!baseClass) {
+                break;
+            }
+            chain.push(baseClass);
+            currentClass = baseClass;
+        }
+        return hasRuntimeControllerBase ? chain : [this.node];
+    }
+    getDirectBaseClassInfo(classDeclaration) {
+        const extendsClause = classDeclaration.heritageClauses?.find(clause => clause.token === typescript_1.SyntaxKind.ExtendsKeyword);
+        const extendsType = extendsClause?.types[0];
+        if (!extendsType) {
+            return { extendsRuntimeController: false };
+        }
+        if (this.extendsRuntimeController(extendsType)) {
+            return { extendsRuntimeController: true };
+        }
+        const expression = extendsType.expression;
+        const symbols = [this.current.typeChecker.getSymbolAtLocation(expression), this.current.typeChecker.getTypeAtLocation(expression).getSymbol()].filter((symbol) => !!symbol);
+        const symbolsToSearch = new Set(symbols);
+        symbols.forEach(symbol => {
+            if (symbol.flags & typescript_1.SymbolFlags.Alias) {
+                symbolsToSearch.add(this.current.typeChecker.getAliasedSymbol(symbol));
+            }
+        });
+        for (const symbol of symbolsToSearch) {
+            const declarations = symbol.declarations || (symbol.valueDeclaration ? [symbol.valueDeclaration] : []);
+            const classDeclarationNode = declarations.find(typescript_1.isClassDeclaration);
+            if (classDeclarationNode) {
+                return { baseClass: classDeclarationNode, extendsRuntimeController: false };
+            }
+        }
+        return { extendsRuntimeController: false };
+    }
+    extendsRuntimeController(extendsType) {
+        const expression = extendsType.expression;
+        const symbol = this.current.typeChecker.getSymbolAtLocation(expression) || this.current.typeChecker.getTypeAtLocation(expression).getSymbol();
+        if (!symbol) {
+            return false;
+        }
+        if (!(symbol.flags & typescript_1.SymbolFlags.Alias)) {
+            return false;
+        }
+        const aliasDeclarations = symbol.declarations || [];
+        return aliasDeclarations.some(declaration => {
+            if (!(0, typescript_1.isImportSpecifier)(declaration)) {
+                return false;
+            }
+            const importedName = declaration.propertyName?.text || declaration.name.text;
+            if (importedName !== 'Controller') {
+                return false;
+            }
+            const moduleSpecifier = this.getImportModuleSpecifier(declaration);
+            if (!moduleSpecifier) {
+                return false;
+            }
+            return moduleSpecifier.getText().replace(/['"]/g, '') === '@tsoa-next/runtime';
+        });
+    }
+    getMethodKey(method) {
+        if (!method.name) {
+            return undefined;
+        }
+        return (0, typescript_1.isIdentifier)(method.name) ? method.name.text : method.name.getText();
+    }
+    getImportModuleSpecifier(declaration) {
+        // ImportSpecifier -> NamedImports -> ImportClause -> ImportDeclaration
+        const importDeclaration = declaration.parent.parent.parent;
+        return 'moduleSpecifier' in importDeclaration ? importDeclaration.moduleSpecifier : undefined;
+    }
+    getPath() {
+        const decorators = (0, decoratorUtils_1.getDecorators)(this.node, identifier => identifier.text === 'Route');
+        if (!decorators || !decorators.length) {
+            return;
+        }
+        if (decorators.length > 1) {
+            throw new exceptions_1.GenerateMetadataError(`Only one Route decorator allowed in '${this.node.name.text}' class.`);
+        }
+        const decorator = decorators[0];
+        const expression = decorator.parent;
+        const decoratorArgument = expression.arguments[0];
+        return decoratorArgument ? `${decoratorArgument.text}` : '';
+    }
+    getCommonResponses() {
+        const decorators = (0, decoratorUtils_1.getDecorators)(this.node, identifier => identifier.text === 'Response');
+        if (!decorators || !decorators.length) {
+            return [];
+        }
+        return decorators.map(decorator => {
+            const expression = decorator.parent;
+            const [name, description, example] = (0, decoratorUtils_1.getDecoratorValues)(decorator, this.current.typeChecker);
+            if (!name) {
+                throw new exceptions_1.GenerateMetadataError(`Controller's responses should have an explicit name.`);
+            }
+            return {
+                description: description || '',
+                examples: example === undefined ? undefined : [example],
+                name,
+                schema: expression.typeArguments && expression.typeArguments.length > 0 && !this.isHidden ? new typeResolver_1.TypeResolver(expression.typeArguments[0], this.current).resolve() : undefined,
+                headers: (0, headerTypeHelpers_1.getHeaderType)(expression.typeArguments, 1, this.current),
+            };
+        });
+    }
+    getTags() {
+        const decorators = (0, decoratorUtils_1.getDecorators)(this.node, identifier => identifier.text === 'Tags');
+        if (!decorators || !decorators.length) {
+            return;
+        }
+        if (decorators.length > 1) {
+            throw new exceptions_1.GenerateMetadataError(`Only one Tags decorator allowed in '${this.node.name.text}' class.`);
+        }
+        const decorator = decorators[0];
+        const expression = decorator.parent;
+        return expression.arguments.map((a) => a.text);
+    }
+    getSecurity() {
+        const noSecurityDecorators = (0, decoratorUtils_1.getDecorators)(this.node, identifier => identifier.text === 'NoSecurity');
+        const securityDecorators = (0, decoratorUtils_1.getDecorators)(this.node, identifier => identifier.text === 'Security');
+        if (noSecurityDecorators?.length && securityDecorators?.length) {
+            throw new exceptions_1.GenerateMetadataError(`NoSecurity decorator cannot be used in conjunction with Security decorator in '${this.node.name.text}' class.`);
+        }
+        if (noSecurityDecorators?.length) {
+            return [];
+        }
+        if (!securityDecorators || !securityDecorators.length) {
+            return this.parentSecurity;
+        }
+        return securityDecorators.map(d => (0, decoratorUtils_1.getSecurites)(d, this.current.typeChecker));
+    }
+    getIsHidden() {
+        const hiddenDecorators = (0, decoratorUtils_1.getDecorators)(this.node, identifier => identifier.text === 'Hidden');
+        if (!hiddenDecorators || !hiddenDecorators.length) {
+            return false;
+        }
+        if (hiddenDecorators.length > 1) {
+            throw new exceptions_1.GenerateMetadataError(`Only one Hidden decorator allowed in '${this.node.name.text}' class.`);
+        }
+        return true;
+    }
+    getProduces() {
+        const produces = (0, decoratorUtils_1.getProduces)(this.node, this.current.typeChecker);
+        return produces.length ? produces : undefined;
+    }
+}
+exports.ControllerGenerator = ControllerGenerator;
+//# sourceMappingURL=controllerGenerator.js.map

package/dist/metadataGeneration/controllerGenerator.js.map

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

package/dist/metadataGeneration/exceptions.d.ts

@@ -0,0 +1,13 @@
+import { Node, TypeNode } from 'typescript';
+export declare class GenerateMetadataError extends Error {
+    constructor(message?: string, node?: Node | TypeNode, onlyCurrent?: boolean);
+}
+export declare class GenerateMetaDataWarning {
+    private message;
+    private node;
+    private onlyCurrent;
+    constructor(message: string, node: Node | TypeNode, onlyCurrent?: boolean);
+    toString(): string;
+}
+export declare function prettyLocationOfNode(node: Node | TypeNode): string;
+export declare function prettyTroubleCause(node: Node | TypeNode, onlyCurrent?: boolean): string;

package/dist/metadataGeneration/exceptions.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenerateMetaDataWarning = exports.GenerateMetadataError = void 0;
+exports.prettyLocationOfNode = prettyLocationOfNode;
+exports.prettyTroubleCause = prettyTroubleCause;
+const path_1 = require("path");
+class GenerateMetadataError extends Error {
+    constructor(message, node, onlyCurrent = false) {
+        super(message);
+        if (node) {
+            this.message = `${message}\n${prettyLocationOfNode(node)}\n${prettyTroubleCause(node, onlyCurrent)}`;
+        }
+    }
+}
+exports.GenerateMetadataError = GenerateMetadataError;
+class GenerateMetaDataWarning {
+    message;
+    node;
+    onlyCurrent;
+    constructor(message, node, onlyCurrent = false) {
+        this.message = message;
+        this.node = node;
+        this.onlyCurrent = onlyCurrent;
+    }
+    toString() {
+        return `Warning: ${this.message}\n${prettyLocationOfNode(this.node)}\n${prettyTroubleCause(this.node, this.onlyCurrent)}`;
+    }
+}
+exports.GenerateMetaDataWarning = GenerateMetaDataWarning;
+function prettyLocationOfNode(node) {
+    const sourceFile = node.getSourceFile();
+    if (sourceFile) {
+        const token = node.getFirstToken() || node.parent.getFirstToken();
+        const start = token ? `:${sourceFile.getLineAndCharacterOfPosition(token.getStart()).line + 1}` : '';
+        const end = token ? `:${sourceFile.getLineAndCharacterOfPosition(token.getEnd()).line + 1}` : '';
+        const normalizedPath = (0, path_1.normalize)(`${sourceFile.fileName}${start}${end}`);
+        return `At: ${normalizedPath}.`;
+    }
+    else {
+        return `At unknown position...`;
+    }
+}
+function prettyTroubleCause(node, onlyCurrent = false) {
+    let name;
+    if (onlyCurrent || !node.parent) {
+        name = node.pos !== -1 && node.parent ? node.getText() : node.name?.text || '<unknown name>';
+    }
+    else {
+        name = node.parent.pos !== -1 ? node.parent.getText() : node.parent.name?.text || '<unknown name>';
+    }
+    return `This was caused by '${name}'`;
+}
+//# sourceMappingURL=exceptions.js.map

package/dist/metadataGeneration/exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.js","sourceRoot":"","sources":["../../src/metadataGeneration/exceptions.ts"],"names":[],"mappings":";;;AAwBA,oDAWC;AAED,gDAQC;AA7CD,+BAAgC;AAGhC,MAAa,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAgB,EAAE,IAAsB,EAAE,WAAW,GAAG,KAAK;QACvE,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,OAAO,GAAG,GAAG,OAAQ,KAAK,oBAAoB,CAAC,IAAI,CAAC,KAAK,kBAAkB,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE,CAAA;QACvG,CAAC;IACH,CAAC;CACF;AAPD,sDAOC;AAED,MAAa,uBAAuB;IAExB;IACA;IACA;IAHV,YACU,OAAe,EACf,IAAqB,EACrB,cAAc,KAAK;QAFnB,YAAO,GAAP,OAAO,CAAQ;QACf,SAAI,GAAJ,IAAI,CAAiB;QACrB,gBAAW,GAAX,WAAW,CAAQ;IAC1B,CAAC;IAEJ,QAAQ;QACN,OAAO,YAAY,IAAI,CAAC,OAAO,KAAK,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,EAAE,CAAA;IAC3H,CAAC;CACF;AAVD,0DAUC;AAED,SAAgB,oBAAoB,CAAC,IAAqB;IACxD,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,CAAA;IACvC,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAA;QACjE,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,6BAA6B,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QACpG,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,6BAA6B,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAChG,MAAM,cAAc,GAAG,IAAA,gBAAS,EAAC,GAAG,UAAU,CAAC,QAAQ,GAAG,KAAK,GAAG,GAAG,EAAE,CAAC,CAAA;QACxE,OAAO,OAAO,cAAc,GAAG,CAAA;IACjC,CAAC;SAAM,CAAC;QACN,OAAO,wBAAwB,CAAA;IACjC,CAAC;AACH,CAAC;AAED,SAAgB,kBAAkB,CAAC,IAAqB,EAAE,WAAW,GAAG,KAAK;IAC3E,IAAI,IAAY,CAAA;IAChB,IAAI,WAAW,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAChC,IAAI,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAE,IAAY,CAAC,IAAI,EAAE,IAAI,IAAI,gBAAgB,CAAA;IACvG,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAE,IAAY,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,gBAAgB,CAAA;IAC7G,CAAC;IACD,OAAO,uBAAuB,IAAI,GAAG,CAAA;AACvC,CAAC"}

package/dist/metadataGeneration/extension.d.ts

@@ -0,0 +1,5 @@
+import * as ts from 'typescript';
+import { MetadataGenerator } from './metadataGenerator';
+import { Tsoa } from '@tsoa-next/runtime';
+export declare function getExtensions(decorators: ts.Identifier[], metadataGenerator: MetadataGenerator): Tsoa.Extension[];
+export declare function getExtensionsFromJSDocComments(comments: string[]): Tsoa.Extension[];

package/dist/metadataGeneration/extension.js

@@ -0,0 +1,85 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getExtensions = getExtensions;
+exports.getExtensionsFromJSDocComments = getExtensionsFromJSDocComments;
+const ts = __importStar(require("typescript"));
+const initializer_value_1 = require("./initializer-value");
+const jsonUtils_1 = require("../utils/jsonUtils");
+function getExtensions(decorators, metadataGenerator) {
+    const extensions = decorators.map(extensionDecorator => {
+        if (!ts.isCallExpression(extensionDecorator.parent)) {
+            throw new Error('The parent of the @Extension is not a CallExpression. Are you using it in the right place?');
+        }
+        const [decoratorKeyArg, decoratorValueArg] = extensionDecorator.parent.arguments;
+        if (!ts.isStringLiteral(decoratorKeyArg) && !ts.isIdentifier(decoratorKeyArg)) {
+            throw new Error('The first argument of @Extension must be a string');
+        }
+        const attributeKey = ts.isIdentifier(decoratorKeyArg) ? (0, initializer_value_1.getInitializerValue)(decoratorKeyArg, metadataGenerator.typeChecker) : decoratorKeyArg.text;
+        if (typeof attributeKey !== 'string') {
+            throw new Error('The first argument of @Extension must be a string');
+        }
+        if (!decoratorValueArg) {
+            throw new Error(`Extension '${attributeKey}' must contain a value`);
+        }
+        assertValidExtensionKey(attributeKey);
+        const attributeValue = (0, initializer_value_1.getInitializerValue)(decoratorValueArg, metadataGenerator.typeChecker);
+        if (!(0, initializer_value_1.isNonUndefinedInitializerValue)(attributeValue)) {
+            throw new Error(`Extension '${attributeKey}' cannot have an undefined initializer value`);
+        }
+        return { key: attributeKey, value: attributeValue };
+    });
+    return extensions;
+}
+function getExtensionsFromJSDocComments(comments) {
+    const extensions = [];
+    comments.forEach(comment => {
+        const extensionData = (0, jsonUtils_1.safeFromJson)(comment);
+        if (extensionData) {
+            const keys = Object.keys(extensionData);
+            keys.forEach(key => {
+                assertValidExtensionKey(key);
+                extensions.push({ key: key, value: extensionData[key] });
+            });
+        }
+    });
+    return extensions;
+}
+function assertValidExtensionKey(key) {
+    if (!key.startsWith('x-')) {
+        throw new Error('Extensions must begin with "x-" to be valid. Please see the following link for more information: https://swagger.io/docs/specification/openapi-extensions/');
+    }
+}
+//# sourceMappingURL=extension.js.map

package/dist/metadataGeneration/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../src/metadataGeneration/extension.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMA,sCAgCC;AAED,wEAcC;AAtDD,+CAAgC;AAChC,2DAAyF;AAGzF,kDAAiD;AAEjD,SAAgB,aAAa,CAAC,UAA2B,EAAE,iBAAoC;IAC7F,MAAM,UAAU,GAAqB,UAAU,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE;QACvE,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,4FAA4F,CAAC,CAAA;QAC/G,CAAC;QAED,MAAM,CAAC,eAAe,EAAE,iBAAiB,CAAC,GAAG,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAA;QAEhF,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,eAAe,CAAC,EAAE,CAAC;YAC9E,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;QACtE,CAAC;QAED,MAAM,YAAY,GAAG,EAAE,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAA,uCAAmB,EAAC,eAAe,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAA;QAElJ,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;QACtE,CAAC;QAED,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,cAAc,YAAY,wBAAwB,CAAC,CAAA;QACrE,CAAC;QAED,uBAAuB,CAAC,YAAY,CAAC,CAAA;QAErC,MAAM,cAAc,GAAG,IAAA,uCAAmB,EAAC,iBAAiB,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAA;QAC5F,IAAI,CAAC,IAAA,kDAA8B,EAAC,cAAc,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,cAAc,YAAY,8CAA8C,CAAC,CAAA;QAC3F,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,SAAgB,8BAA8B,CAAC,QAAkB;IAC/D,MAAM,UAAU,GAAqB,EAAE,CAAA;IACvC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;QACzB,MAAM,aAAa,GAAG,IAAA,wBAAY,EAAC,OAAO,CAAC,CAAA;QAC3C,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;YACvC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;gBACjB,uBAAuB,CAAC,GAAG,CAAC,CAAA;gBAC5B,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;YAC1D,CAAC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,SAAS,uBAAuB,CAAC,GAAW;IAC1C,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,4JAA4J,CAAC,CAAA;IAC/K,CAAC;AACH,CAAC"}

package/dist/metadataGeneration/initializer-value.d.ts

@@ -0,0 +1,6 @@
+import * as ts from 'typescript';
+import { Tsoa } from '@tsoa-next/runtime';
+export type InitializerValue = string | number | boolean | undefined | null | InitializerValue[];
+export type DefinedInitializerValue = string | number | boolean | null | DefinedInitializerValue[];
+export declare function isNonUndefinedInitializerValue(value: InitializerValue): value is DefinedInitializerValue;
+export declare function getInitializerValue(initializer?: ts.Expression | ts.ImportSpecifier, typeChecker?: ts.TypeChecker, type?: Tsoa.Type): InitializerValue | DefinedInitializerValue;

package/dist/metadataGeneration/initializer-value.js

@@ -0,0 +1,154 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNonUndefinedInitializerValue = isNonUndefinedInitializerValue;
+exports.getInitializerValue = getInitializerValue;
+const ts = __importStar(require("typescript"));
+const hasInitializer = (node) => Object.prototype.hasOwnProperty.call(node, 'initializer');
+const extractInitializer = (decl) => (decl && hasInitializer(decl) && decl.initializer) || undefined;
+const extractImportSpecifier = (symbol) => (symbol?.declarations && symbol.declarations.length > 0 && ts.isImportSpecifier(symbol.declarations[0]) && symbol.declarations[0]) || undefined;
+const isIterable = (obj) => obj != null && typeof obj[Symbol.iterator] === 'function';
+function isNonUndefinedInitializerValue(value) {
+    if (Array.isArray(value)) {
+        return value.every(isNonUndefinedInitializerValue);
+    }
+    else {
+        return value !== undefined;
+    }
+}
+function getInitializerValue(initializer, typeChecker, type) {
+    if (!initializer || !typeChecker) {
+        return;
+    }
+    switch (initializer.kind) {
+        case ts.SyntaxKind.ArrayLiteralExpression: {
+            const arrayLiteral = initializer;
+            return arrayLiteral.elements.reduce((acc, element) => {
+                if (ts.isSpreadElement(element)) {
+                    const spreadValue = getInitializerValue(element.expression, typeChecker);
+                    if (spreadValue && isIterable(spreadValue)) {
+                        return acc.concat(...spreadValue);
+                    }
+                    else {
+                        throw new Error(`${typeof spreadValue} is not iterable`);
+                    }
+                }
+                else {
+                    acc.push(getInitializerValue(element, typeChecker));
+                }
+                return acc;
+            }, []);
+        }
+        case ts.SyntaxKind.StringLiteral:
+        case ts.SyntaxKind.NoSubstitutionTemplateLiteral:
+            return initializer.text;
+        case ts.SyntaxKind.TrueKeyword:
+            return true;
+        case ts.SyntaxKind.FalseKeyword:
+            return false;
+        case ts.SyntaxKind.PrefixUnaryExpression: {
+            const prefixUnary = initializer;
+            switch (prefixUnary.operator) {
+                case ts.SyntaxKind.PlusToken:
+                    return Number(prefixUnary.operand.text);
+                case ts.SyntaxKind.MinusToken:
+                    return Number(`-${prefixUnary.operand.text}`);
+                default:
+                    throw new Error(`Unsupport prefix operator token: ${prefixUnary.operator}`);
+            }
+        }
+        case ts.SyntaxKind.NumberKeyword:
+        case ts.SyntaxKind.FirstLiteralToken:
+            return Number(initializer.text);
+        case ts.SyntaxKind.NewExpression: {
+            const newExpression = initializer;
+            const ident = newExpression.expression;
+            if (ident.text === 'Date') {
+                let date = new Date();
+                if (newExpression.arguments) {
+                    const newArguments = newExpression.arguments.filter(args => args.kind !== undefined);
+                    const argsValue = newArguments.map(args => getInitializerValue(args, typeChecker));
+                    if (argsValue.length > 0) {
+                        date = new Date(argsValue);
+                    }
+                }
+                const dateString = date.toISOString();
+                if (type && type.dataType === 'date') {
+                    return dateString.split('T')[0];
+                }
+                return dateString;
+            }
+            return;
+        }
+        case ts.SyntaxKind.NullKeyword:
+            return null;
+        case ts.SyntaxKind.ObjectLiteralExpression: {
+            const objectLiteral = initializer;
+            const nestedObject = {};
+            objectLiteral.properties.forEach((p) => {
+                if (ts.isSpreadAssignment(p)) {
+                    const spreadValue = getInitializerValue(p.expression, typeChecker);
+                    if (spreadValue) {
+                        if (typeof spreadValue === 'object') {
+                            Object.assign(nestedObject, spreadValue);
+                        }
+                        else {
+                            throw new Error(`Spread types may only be created from object types.`);
+                        }
+                    }
+                }
+                else {
+                    nestedObject[p.name.text] = getInitializerValue(p.initializer, typeChecker);
+                }
+            });
+            return nestedObject;
+        }
+        case ts.SyntaxKind.ImportSpecifier: {
+            const importSpecifier = initializer;
+            const importSymbol = typeChecker.getSymbolAtLocation(importSpecifier.name);
+            if (!importSymbol)
+                return;
+            const aliasedSymbol = typeChecker.getAliasedSymbol(importSymbol);
+            const declarations = aliasedSymbol.getDeclarations();
+            const declaration = declarations && declarations.length > 0 ? declarations[0] : undefined;
+            return getInitializerValue(extractInitializer(declaration), typeChecker);
+        }
+        default: {
+            const symbol = typeChecker.getSymbolAtLocation(initializer);
+            return getInitializerValue(extractInitializer(symbol?.valueDeclaration) || extractImportSpecifier(symbol), typeChecker);
+        }
+    }
+}
+//# sourceMappingURL=initializer-value.js.map

package/dist/metadataGeneration/initializer-value.js.map

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

package/dist/metadataGeneration/metadataGenerator.d.ts

@@ -0,0 +1,29 @@
+import { Config, Tsoa } from '@tsoa-next/runtime';
+import { type ClassDeclaration, type CompilerOptions, type TypeChecker } from 'typescript';
+export declare class MetadataGenerator {
+    private readonly compilerOptions?;
+    private readonly ignorePaths?;
+    private readonly rootSecurity;
+    readonly defaultNumberType: NonNullable<Config['defaultNumberType']>;
+    readonly controllerNodes: ClassDeclaration[];
+    readonly typeChecker: TypeChecker;
+    private readonly program;
+    private referenceTypeMap;
+    private modelDefinitionPosMap;
+    private expressionOrigNameMap;
+    constructor(entryFile: string, compilerOptions?: CompilerOptions | undefined, ignorePaths?: string[] | undefined, controllers?: string[], rootSecurity?: Tsoa.Security[], defaultNumberType?: NonNullable<Config['defaultNumberType']>, esm?: boolean);
+    Generate(): Tsoa.Metadata;
+    private setProgramToDynamicControllersFiles;
+    private extractNodeFromProgramSourceFiles;
+    private checkForMethodSignatureDuplicates;
+    private checkForPathParamSignatureDuplicates;
+    TypeChecker(): TypeChecker;
+    AddReferenceType(referenceType: Tsoa.ReferenceType): void;
+    GetReferenceType(refName: string): Tsoa.ReferenceType;
+    CheckModelUnicity(refName: string, positions: Array<{
+        fileName: string;
+        pos: number;
+    }>): void;
+    CheckExpressionUnicity(formattedRefName: string, refName: string): void;
+    private buildControllers;
+}