@trapi/swagger 1.0.0-alpha.2 → 1.0.0-alpha.3

package/dist/config/index.d.ts

@@ -0,0 +1,3 @@
+export * from './type';
+export * from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAOA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/*
+ * Copyright (c) 2023.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./type"), exports);
+__exportStar(require("./utils"), exports);
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,yCAAuB;AACvB,0CAAwB"}

package/dist/config/type.d.ts

@@ -0,0 +1,83 @@
+import type { CollectionFormat, Metadata, Options as MetadataOptions } from '@trapi/metadata';
+import type { SecurityDefinitions } from '../type';
+export type ServerOption = {
+    url: string;
+    description?: string;
+};
+export interface Options {
+    /**
+     * Generate a yaml file
+     */
+    yaml?: boolean;
+    /**
+     * Specify if an output file should be generated.
+     *
+     * default: true
+     */
+    output: boolean;
+    /**
+     * Generated swagger.{json|yaml} will output here.
+     *
+     * default: process.cwd()
+     */
+    outputDirectory: string;
+    /**
+     * Generated documentation base file name.
+     *
+     * default: swagger
+     */
+    outputFileName: string;
+    /**
+     * API host, expressTemplate.g. localhost:3000 or https://myapi.com
+     */
+    servers?: ServerOption[];
+    /**
+     * Metadata options or metadata itself.
+     */
+    metadata?: MetadataOptions | Metadata;
+    /**
+     * API version number; defaults to npm package version
+     */
+    version?: string;
+    /**
+     * API name; defaults to npm package name
+     */
+    name?: string;
+    /**
+     * 'API description; defaults to npm package description
+     */
+    description?: string;
+    /**
+     * API license; defaults to npm package license
+     */
+    license?: string;
+    /**
+     * Extend generated swagger spec with this object
+     * Note that generated properties will always take precedence over what get specified here
+     */
+    specificationExtra?: Record<string, any>;
+    /**
+     * Security Definitions Object
+     * A declaration of the security schemes available to be used in the
+     * specification. This does not enforce the security schemes on the operations
+     * and only serves to provide the relevant details for each scheme.
+     */
+    securityDefinitions?: SecurityDefinitions;
+    /**
+     * Default consumes property for the entire API
+     */
+    consumes?: string[];
+    /**
+     * Default produces property for the entire API
+     */
+    produces?: string[];
+    /**
+     * Default collectionFormat property for query parameters of array type.
+     * Possible values are `csv`, `ssv`, `tsv`, `pipes`, `multi`. If not specified, Swagger defaults to `csv`.
+     */
+    collectionFormat?: `${CollectionFormat}`;
+}
+export type OptionsInput = Omit<Partial<Options>, 'servers'> & {
+    servers?: string | string[] | ServerOption | ServerOption[];
+};
+//# sourceMappingURL=type.d.ts.map

package/dist/config/type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../src/config/type.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC9F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,MAAM,MAAM,YAAY,GAAG;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,WAAW,OAAO;IACpB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,EAAE,eAAe,GAAG,QAAQ,CAAC;IAEtC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEzC;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,GAAG,gBAAgB,EAAE,CAAC;CAC5C;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,GAAG;IAC3D,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,YAAY,GAAG,YAAY,EAAE,CAAA;CAC9D,CAAC"}

package/dist/config/type.js

@@ -0,0 +1,9 @@
+"use strict";
+/*
+ * Copyright (c) 2023.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=type.js.map

package/dist/config/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../src/config/type.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/config/utils.d.ts

@@ -0,0 +1,3 @@
+import type { Options, OptionsInput } from './type';
+export declare function buildOptions(input: OptionsInput): Options;
+//# sourceMappingURL=utils.d.ts.map

package/dist/config/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/config/utils.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAgB,MAAM,QAAQ,CAAC;AAElE,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAI,OAAO,CAiC1D"}

package/dist/config/utils.js

@@ -0,0 +1,52 @@
+"use strict";
+/*
+ * Copyright (c) 2023.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildOptions = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const node_process_1 = __importDefault(require("node:process"));
+function buildOptions(input) {
+    const servers = [];
+    if (Array.isArray(input.servers)) {
+        for (let i = 0; i < input.servers.length; i++) {
+            const server = input.servers[i];
+            if (typeof server === 'string') {
+                servers.push({ url: server });
+            }
+            else {
+                servers.push(server);
+            }
+        }
+    }
+    else if (typeof input.servers === 'string') {
+        servers.push({ url: input.servers });
+    }
+    else {
+        servers.push(input.servers);
+    }
+    let outputDirectory;
+    if (input.outputDirectory) {
+        outputDirectory = node_path_1.default.isAbsolute(input.outputDirectory) ?
+            input.outputDirectory :
+            node_path_1.default.join(node_process_1.default.cwd(), input.outputDirectory);
+    }
+    else {
+        outputDirectory = node_process_1.default.cwd();
+    }
+    return {
+        ...input,
+        output: input.output ?? true,
+        outputDirectory,
+        outputFileName: input.outputFileName || 'swagger',
+        servers,
+    };
+}
+exports.buildOptions = buildOptions;
+//# sourceMappingURL=utils.js.map

package/dist/config/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/config/utils.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;AAEH,0DAA6B;AAC7B,gEAAmC;AAGnC,SAAgB,YAAY,CAAC,KAAmB;IAC5C,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAChC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;gBAC5B,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;aACjC;iBAAM;gBACH,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;aACxB;SACJ;KACJ;SAAM,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE;QAC1C,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;KACxC;SAAM;QACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;KAC/B;IAED,IAAI,eAAwB,CAAC;IAC7B,IAAI,KAAK,CAAC,eAAe,EAAE;QACvB,eAAe,GAAG,mBAAI,CAAC,UAAU,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;YACtD,KAAK,CAAC,eAAe,CAAC,CAAC;YACvB,mBAAI,CAAC,IAAI,CAAC,sBAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;KACvD;SAAM;QACH,eAAe,GAAG,sBAAO,CAAC,GAAG,EAAE,CAAC;KACnC;IAED,OAAO;QACH,GAAG,KAAK;QACR,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;QAC5B,eAAe;QACf,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,SAAS;QACjD,OAAO;KACV,CAAC;AACN,CAAC;AAjCD,oCAiCC"}

package/dist/constants.d.ts

@@ -0,0 +1,15 @@
+export declare enum Version {
+    V2 = "V2",
+    V3 = "V3"
+}
+export declare enum DocumentFormat {
+    YAML = "yaml",
+    JSON = "json"
+}
+export declare enum SecurityType {
+    API_KEY = "apiKey",
+    BASIC = "basic",
+    HTTP = "http",
+    OAUTH2 = "oauth2"
+}
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAOA,oBAAY,OAAO;IACf,EAAE,OAAO;IACT,EAAE,OAAO;CACZ;AAED,oBAAY,cAAc;IACtB,IAAI,SAAS;IACb,IAAI,SAAS;CAChB;AAED,oBAAY,YAAY;IACpB,OAAO,WAAW;IAClB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,MAAM,WAAW;CACpB"}

package/dist/constants.js

@@ -0,0 +1,27 @@
+"use strict";
+/*
+ * Copyright (c) 2023.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SecurityType = exports.DocumentFormat = exports.Version = void 0;
+var Version;
+(function (Version) {
+    Version["V2"] = "V2";
+    Version["V3"] = "V3";
+})(Version = exports.Version || (exports.Version = {}));
+var DocumentFormat;
+(function (DocumentFormat) {
+    DocumentFormat["YAML"] = "yaml";
+    DocumentFormat["JSON"] = "json";
+})(DocumentFormat = exports.DocumentFormat || (exports.DocumentFormat = {}));
+var SecurityType;
+(function (SecurityType) {
+    SecurityType["API_KEY"] = "apiKey";
+    SecurityType["BASIC"] = "basic";
+    SecurityType["HTTP"] = "http";
+    SecurityType["OAUTH2"] = "oauth2";
+})(SecurityType = exports.SecurityType || (exports.SecurityType = {}));
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,IAAY,OAGX;AAHD,WAAY,OAAO;IACf,oBAAS,CAAA;IACT,oBAAS,CAAA;AACb,CAAC,EAHW,OAAO,GAAP,eAAO,KAAP,eAAO,QAGlB;AAED,IAAY,cAGX;AAHD,WAAY,cAAc;IACtB,+BAAa,CAAA;IACb,+BAAa,CAAA;AACjB,CAAC,EAHW,cAAc,GAAd,sBAAc,KAAd,sBAAc,QAGzB;AAED,IAAY,YAKX;AALD,WAAY,YAAY;IACpB,kCAAkB,CAAA;IAClB,+BAAe,CAAA;IACf,6BAAa,CAAA;IACb,iCAAiB,CAAA;AACrB,CAAC,EALW,YAAY,GAAZ,oBAAY,KAAZ,oBAAY,QAKvB"}

package/dist/generator/abstract.d.ts

@@ -0,0 +1,27 @@
+import type { BaseType, EnumType, IntersectionType, Metadata, NestedObjectLiteralType, Parameter, ParameterSource, ReferenceType, ResolverProperty, UnionType } from '@trapi/metadata';
+import type { Options, OptionsInput } from '../config';
+import type { DocumentFormat } from '../constants';
+import type { DocumentFormatData } from '../type';
+import type { BaseSchema, Info, SchemaV2, SchemaV3, SpecV2, SpecV3 } from '../schema';
+export declare abstract class AbstractSpecGenerator<Spec extends SpecV2 | SpecV3, Schema extends SchemaV3 | SchemaV2> {
+    protected spec: Spec | undefined;
+    protected readonly metadata: Metadata;
+    protected readonly config: Options;
+    constructor(metadata: Metadata, config: OptionsInput);
+    save(): Promise<Record<`${DocumentFormat}`, DocumentFormatData>>;
+    abstract build(): Promise<Spec>;
+    protected buildInfo(): Info;
+    protected getSwaggerType(type: BaseType): Schema | BaseSchema<Schema>;
+    protected abstract getSwaggerTypeForIntersectionType(type: IntersectionType): Schema;
+    protected abstract getSwaggerTypeForEnumType(enumType: EnumType): Schema;
+    protected getSwaggerTypeForUnionType(type: UnionType): Schema | BaseSchema<Schema>;
+    private getSwaggerTypeForPrimitiveType;
+    private getSwaggerTypeForArrayType;
+    getSwaggerTypeForObjectLiteral(objectLiteral: NestedObjectLiteralType): BaseSchema<Schema>;
+    protected abstract getSwaggerTypeForReferenceType(referenceType: ReferenceType): Schema;
+    protected abstract buildProperties(properties: ResolverProperty[]): Record<string, Schema>;
+    protected determineTypesUsedInEnum(anEnum: Array<string | number | boolean | null>): Set<"string" | "number" | "bigint" | "boolean" | "symbol" | "undefined" | "object" | "function">;
+    protected getOperationId(methodName: string): string;
+    protected groupParameters(items: Parameter[]): Partial<Record<ParameterSource, Parameter[]>>;
+}
+//# sourceMappingURL=abstract.d.ts.map

package/dist/generator/abstract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../src/generator/abstract.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAER,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,QAAQ,EACR,uBAAuB,EACvB,SAAS,EACT,eAAe,EAEf,aAAa,EACb,gBAAgB,EAEhB,SAAS,EACZ,MAAM,iBAAiB,CAAC;AAiBzB,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,KAAK,EACR,UAAU,EACV,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,MAAM,EACT,MAAM,WAAW,CAAC;AAEnB,8BAAsB,qBAAqB,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,EAAE,MAAM,SAAS,QAAQ,GAAG,QAAQ;IACxG,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;IAEjC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAEtC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;gBAEvB,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY;IAK9C,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,GAAG,cAAc,EAAE,EAAE,kBAAkB,CAAC,CAAC;aAwCtD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAEtC,SAAS,CAAC,SAAS;IAiBnB,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IAqCrE,SAAS,CAAC,QAAQ,CAAC,iCAAiC,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM;IAEpF,SAAS,CAAC,QAAQ,CAAC,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM;IAExE,SAAS,CAAC,0BAA0B,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IA8ClF,OAAO,CAAC,8BAA8B;IAwBtC,OAAO,CAAC,0BAA0B;IAI3B,8BAA8B,CAAC,aAAa,EAAE,uBAAuB,GAAG,UAAU,CAAC,MAAM,CAAC;IAkBjG,SAAS,CAAC,QAAQ,CAAC,8BAA8B,CAAC,aAAa,EAAE,aAAa,GAAG,MAAM;IAEvF,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,UAAU,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAE1F,SAAS,CAAC,wBAAwB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IASlF,SAAS,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM;IAI3C,SAAS,CAAC,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,GAAI,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,SAAS,EAAE,CAAC,CAAC;CAahG"}

package/dist/{specification → generator}/abstract.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- * Copyright (c) 2021.
+ * Copyright (c) 2021-2023.
  * Author Peter Placzek (tada5hi)
  * For the full copyright and license information,
  * view the LICENSE file that was distributed with this source code.
@@ -14,45 +14,45 @@ const metadata_1 = require("@trapi/metadata");
 const node_path_1 = __importDefault(require("node:path"));
 const node_fs_1 = __importDefault(require("node:fs"));
 const yamljs_1 = __importDefault(require("yamljs"));
+const config_1 = require("../config");
 const utils_1 = require("../utils");
 class AbstractSpecGenerator {
     constructor(metadata, config) {
         this.metadata = metadata;
-        this.config = config;
+        this.config = (0, config_1.buildOptions)(config);
     }
     async save() {
-        const spec = this.build();
-        const swaggerDir = node_path_1.default.resolve(this.config.outputDirectory);
-        await node_fs_1.default.promises.mkdir(swaggerDir, { recursive: true });
-        const data = {
-            json: {
-                path: node_path_1.default.join(swaggerDir, 'swagger.json'),
+        if (!this.config.output) {
+            return;
+        }
+        if (typeof this.spec === 'undefined') {
+            throw new Error('The spec has not been build yet...');
+        }
+        try {
+            await node_fs_1.default.promises.access(this.config.outputDirectory, node_fs_1.default.constants.R_OK | node_fs_1.default.constants.O_DIRECTORY);
+        }
+        catch (e) {
+            await node_fs_1.default.promises.mkdir(this.config.outputDirectory, { recursive: true });
+        }
+        const data = [
+            {
+                path: node_path_1.default.join(this.config.outputDirectory, `${this.config.outputFileName}.json`),
                 name: 'swagger.json',
-                content: JSON.stringify(spec, null, '\t'),
+                content: JSON.stringify(this.spec, null, 4),
             },
-            yaml: undefined,
-        };
+        ];
         if (this.config.yaml) {
-            data.yaml = {
-                path: node_path_1.default.join(swaggerDir, 'swagger.yaml'),
+            data.push({
+                path: node_path_1.default.join(this.config.outputDirectory, `${this.config.outputDirectory}.yaml`),
                 name: 'swagger.yaml',
-                content: yamljs_1.default.stringify(spec, 1000),
-            };
-        }
-        const filePromises = [];
-        const keys = Object.keys(data);
-        for (let i = 0; i < keys.length; i++) {
-            if (typeof data[keys[i]] === 'undefined') {
-                continue;
-            }
-            const output = data[keys[i]];
-            filePromises.push(node_fs_1.default.promises.writeFile(output.path, output.content));
+                content: yamljs_1.default.stringify(this.spec, 1000),
+            });
         }
-        await Promise.all(filePromises);
-        return data;
-    }
-    getMetaData() {
-        return this.metadata;
+        const promises = [];
+        for (let i = 0; i < data.length; i++) {
+            promises.push(node_fs_1.default.promises.writeFile(data[i].path, data[i].content, { encoding: 'utf-8' }));
+        }
+        await Promise.all(promises);
     }
     buildInfo() {
         const info = {
@@ -195,6 +195,16 @@ class AbstractSpecGenerator {
     getOperationId(methodName) {
         return methodName.charAt(0).toUpperCase() + methodName.substring(1);
     }
+    groupParameters(items) {
+        const output = {};
+        for (let i = 0; i < items.length; i++) {
+            if (typeof output[items[i].in] === 'undefined') {
+                output[items[i].in] = [];
+            }
+            output[items[i].in].push(items[i]);
+        }
+        return output;
+    }
 }
 exports.AbstractSpecGenerator = AbstractSpecGenerator;
 //# sourceMappingURL=abstract.js.map

package/dist/generator/abstract.js.map

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

package/dist/{specification → generator}/index.d.ts

@@ -2,6 +2,4 @@ export * from './v2';
 export * from './v3';
 export * from './abstract';
 export * from './module';
-export * from './type';
-export * from './utils';
 //# sourceMappingURL=index.d.ts.map

package/dist/generator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generator/index.ts"],"names":[],"mappings":"AAOA,cAAc,MAAM,CAAC;AACrB,cAAc,MAAM,CAAC;AACrB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC"}

package/dist/{specification → generator}/index.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- * Copyright (c) 2021.
+ * Copyright (c) 2023.
  * Author Peter Placzek (tada5hi)
  * For the full copyright and license information,
  * view the LICENSE file that was distributed with this source code.
@@ -24,6 +24,4 @@ __exportStar(require("./v2"), exports);
 __exportStar(require("./v3"), exports);
 __exportStar(require("./abstract"), exports);
 __exportStar(require("./module"), exports);
-__exportStar(require("./type"), exports);
-__exportStar(require("./utils"), exports);
 //# sourceMappingURL=index.js.map

package/dist/generator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generator/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,uCAAqB;AACrB,uCAAqB;AACrB,6CAA2B;AAC3B,2CAAyB"}

package/dist/generator/module.d.ts

@@ -0,0 +1,14 @@
+import type { CompilerOptions } from '@trapi/metadata';
+import type { OptionsInput } from '../config';
+import { Version } from '../constants';
+import type { SpecV2, SpecV3 } from '../schema';
+export declare function buildMetadata(options: OptionsInput, tsConfig?: CompilerOptions): Promise<import("@trapi/metadata").Metadata>;
+export type DocumentationGenerationContext<V extends `${Version}`> = {
+    version: V;
+    options: OptionsInput;
+    tsConfig?: CompilerOptions;
+};
+type OutputSpec<V extends `${Version}`> = V extends `${Version.V2}` ? SpecV2 : SpecV3;
+export declare function generate<V extends `${Version}`>(context: DocumentationGenerationContext<V>): Promise<OutputSpec<V>>;
+export {};
+//# sourceMappingURL=module.d.ts.map

package/dist/generator/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../src/generator/module.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAIhD,wBAAsB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,eAAe,+CAMpF;AAED,MAAM,MAAM,8BAA8B,CAAC,CAAC,SAAS,GAAG,OAAO,EAAE,IAAI;IACjE,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC7B,CAAC;AAEF,KAAK,UAAU,CAAC,CAAC,SAAS,GAAG,OAAO,EAAE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,EAAE,EAAE,GAC/D,MAAM,GACN,MAAM,CAAC;AAEX,wBAAsB,QAAQ,CAAC,CAAC,SAAS,GAAG,OAAO,EAAE,EACjD,OAAO,EAAE,8BAA8B,CAAC,CAAC,CAAC,GAC3C,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAexB"}

package/dist/generator/module.js

@@ -0,0 +1,35 @@
+"use strict";
+/*
+ * Copyright (c) 2021-2023.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generate = exports.buildMetadata = void 0;
+const metadata_1 = require("@trapi/metadata");
+const constants_1 = require("../constants");
+const v2_1 = require("./v2");
+const v3_1 = require("./v3");
+async function buildMetadata(options, tsConfig) {
+    if ((0, metadata_1.isMetadata)(options.metadata)) {
+        return options.metadata;
+    }
+    return (0, metadata_1.generateMetadata)(options.metadata, tsConfig);
+}
+exports.buildMetadata = buildMetadata;
+async function generate(context) {
+    const metadata = await buildMetadata(context.options);
+    switch (context.version) {
+        case constants_1.Version.V3: {
+            const generator = new v3_1.V3Generator(metadata, context.options);
+            return await generator.build();
+        }
+        default: {
+            const generator = new v2_1.V2Generator(metadata, context.options);
+            return await generator.build();
+        }
+    }
+}
+exports.generate = generate;
+//# sourceMappingURL=module.js.map

package/dist/generator/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../src/generator/module.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,8CAA+D;AAE/D,4CAAuC;AAEvC,6BAAmC;AACnC,6BAAmC;AAE5B,KAAK,UAAU,aAAa,CAAC,OAAqB,EAAE,QAA0B;IACjF,IAAI,IAAA,qBAAU,EAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;QAC9B,OAAO,OAAO,CAAC,QAAQ,CAAC;KAC3B;IAED,OAAO,IAAA,2BAAgB,EAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACxD,CAAC;AAND,sCAMC;AAYM,KAAK,UAAU,QAAQ,CAC1B,OAA0C;IAE1C,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtD,QAAQ,OAAO,CAAC,OAAO,EAAE;QACrB,KAAK,mBAAO,CAAC,EAAE,CAAC,CAAC;YACb,MAAM,SAAS,GAAG,IAAI,gBAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YAE7D,OAAO,MAAM,SAAS,CAAC,KAAK,EAAmB,CAAC;SACnD;QACD,OAAO,CAAC,CAAC;YACL,MAAM,SAAS,GAAG,IAAI,gBAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YAE7D,OAAO,MAAM,SAAS,CAAC,KAAK,EAAmB,CAAC;SACnD;KACJ;AACL,CAAC;AAjBD,4BAiBC"}

package/dist/generator/v2/index.d.ts

@@ -0,0 +1,2 @@
+export * from './module';
+//# sourceMappingURL=index.d.ts.map

package/dist/generator/v2/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generator/v2/index.ts"],"names":[],"mappings":"AAOA,cAAc,UAAU,CAAC"}

package/dist/{specification/utils → generator/v2}/index.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- * Copyright (c) 2022-2022.
+ * Copyright (c) 2023.
  * Author Peter Placzek (tada5hi)
  * For the full copyright and license information,
  * view the LICENSE file that was distributed with this source code.
@@ -20,5 +20,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./character"), exports);
+__exportStar(require("./module"), exports);
 //# sourceMappingURL=index.js.map

package/dist/generator/v2/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/generator/v2/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,2CAAyB"}

package/dist/generator/v2/module.d.ts

@@ -0,0 +1,25 @@
+import type { EnumType, IntersectionType, Parameter, ReferenceType, ResolverProperty } from '@trapi/metadata';
+import { AbstractSpecGenerator } from '../abstract';
+import type { ParameterV2, SchemaV2, SpecV2 } from '../../schema';
+export declare class V2Generator extends AbstractSpecGenerator<SpecV2, SchemaV2> {
+    build(): Promise<SpecV2>;
+    private static translateSecurityDefinitions;
+    private buildDefinition;
+    private buildDefinitions;
+    private decideEnumType;
+    private buildPaths;
+    private buildMethod;
+    private transformParameterSource;
+    protected buildParameter(input: Parameter): ParameterV2;
+    private buildMethodConsumes;
+    private hasFileParams;
+    private hasFormParams;
+    private supportsBodyParameters;
+    protected getSwaggerTypeForEnumType(enumType: EnumType): SchemaV2;
+    protected getSwaggerTypeForIntersectionType(type: IntersectionType): SchemaV2;
+    protected getSwaggerTypeForReferenceType(referenceType: ReferenceType): SchemaV2;
+    protected buildProperties(properties: ResolverProperty[]): Record<string, SchemaV2>;
+    private buildOperation;
+    private getMimeType;
+}
+//# sourceMappingURL=module.d.ts.map

package/dist/generator/v2/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/generator/v2/module.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACR,QAAQ,EACR,gBAAgB,EAEhB,SAAS,EAET,aAAa,EACb,gBAAgB,EAEnB,MAAM,iBAAiB,CAAC;AAUzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,KAAK,EAKR,WAAW,EAGX,QAAQ,EAER,MAAM,EACT,MAAM,cAAc,CAAC;AAGtB,qBAAa,WAAY,SAAQ,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC9D,KAAK,IAAK,OAAO,CAAC,MAAM,CAAC;IA+C/B,OAAO,CAAC,MAAM,CAAC,4BAA4B;IAmE3C,OAAO,CAAC,eAAe;IAyDvB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,cAAc;IA0BtB,OAAO,CAAC,UAAU;IAyBlB,OAAO,CAAC,WAAW;IAwGnB,OAAO,CAAC,wBAAwB;IA4BhC,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,WAAW;IA0EvD,OAAO,CAAC,mBAAmB;IAuB3B,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,sBAAsB;IAQ9B,SAAS,CAAC,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,GAAI,QAAQ;IAWlE,SAAS,CAAC,iCAAiC,CAAC,IAAI,EAAE,gBAAgB,GAAI,QAAQ;IAqB9E,SAAS,CAAC,8BAA8B,CAAC,aAAa,EAAE,aAAa,GAAG,QAAQ;IAIhF,SAAS,CAAC,eAAe,CAAC,UAAU,EAAE,gBAAgB,EAAE,GAAI,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC;IAcpF,OAAO,CAAC,cAAc;IA6CtB,OAAO,CAAC,WAAW;CAgBtB"}