@trapi/swagger 0.3.8 → 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,89 +1,58 @@
 "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.
  */
-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 (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AbstractSpecGenerator = void 0;
-const decorators_1 = require("@trapi/decorators");
-const path = __importStar(require("path"));
-const fs_1 = require("fs");
-const YAML = __importStar(require("yamljs"));
+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);
     }
-    save() {
-        return __awaiter(this, void 0, void 0, function* () {
-            const spec = this.build();
-            const swaggerDir = path.resolve(this.config.outputDirectory);
-            yield fs_1.promises.mkdir(swaggerDir, { recursive: true });
-            const data = {
-                json: {
-                    path: path.join(swaggerDir, 'swagger.json'),
-                    name: 'swagger.json',
-                    content: JSON.stringify(spec, null, '\t'),
-                },
-                yaml: undefined,
-            };
-            if (this.config.yaml) {
-                data.yaml = {
-                    path: path.join(swaggerDir, 'swagger.yaml'),
-                    name: 'swagger.yaml',
-                    content: YAML.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(fs_1.promises.writeFile(output.path, output.content));
-            }
-            yield Promise.all(filePromises);
-            return data;
-        });
-    }
-    getMetaData() {
-        return this.metadata;
+    async save() {
+        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(this.spec, null, 4),
+            },
+        ];
+        if (this.config.yaml) {
+            data.push({
+                path: node_path_1.default.join(this.config.outputDirectory, `${this.config.outputDirectory}.yaml`),
+                name: 'swagger.yaml',
+                content: yamljs_1.default.stringify(this.spec, 1000),
+            });
+        }
+        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 = {
@@ -99,10 +68,10 @@ class AbstractSpecGenerator {
         return info;
     }
     getSwaggerType(type) {
-        if ((0, decorators_1.isVoidType)(type)) {
+        if ((0, metadata_1.isVoidType)(type)) {
             return {};
         }
-        if ((0, decorators_1.isReferenceType)(type)) {
+        if ((0, metadata_1.isReferenceType)(type)) {
             return this.getSwaggerTypeForReferenceType(type);
         }
         if (type.typeName === 'any' ||
@@ -121,19 +90,19 @@ class AbstractSpecGenerator {
             type.typeName === 'string') {
             return this.getSwaggerTypeForPrimitiveType(type.typeName);
         }
-        if ((0, decorators_1.isArrayType)(type)) {
+        if ((0, metadata_1.isArrayType)(type)) {
             return this.getSwaggerTypeForArrayType(type);
         }
-        if ((0, decorators_1.isEnumType)(type)) {
+        if ((0, metadata_1.isEnumType)(type)) {
             return this.getSwaggerTypeForEnumType(type);
         }
-        if ((0, decorators_1.isUnionType)(type)) {
+        if ((0, metadata_1.isUnionType)(type)) {
             return this.getSwaggerTypeForUnionType(type);
         }
-        if ((0, decorators_1.isIntersectionType)(type)) {
+        if ((0, metadata_1.isIntersectionType)(type)) {
             return this.getSwaggerTypeForIntersectionType(type);
         }
-        if ((0, decorators_1.isNestedObjectLiteralType)(type)) {
+        if ((0, metadata_1.isNestedObjectLiteralType)(type)) {
             return this.getSwaggerTypeForObjectLiteral(type);
         }
         return {};
@@ -148,7 +117,7 @@ class AbstractSpecGenerator {
         }
         if (type.members.length === 2 && type.members.find((typeInUnion) => typeInUnion.typeName === 'enum' && typeInUnion.members.includes(null))) {
             // Backwards compatible representation of dataType or null, $ref does not allow any sibling attributes, so we have to bail out
-            const nullEnumIndex = type.members.findIndex((a) => (0, decorators_1.isEnumType)(a) && a.members.includes(null));
+            const nullEnumIndex = type.members.findIndex((a) => (0, metadata_1.isEnumType)(a) && a.members.includes(null));
             const typeIndex = nullEnumIndex === 1 ? 0 : 1;
             const swaggerType = this.getSwaggerType(type.members[typeIndex]);
             const isRef = (0, utils_1.hasOwnProperty)(swaggerType, '$ref') && !!swaggerType.$ref;
@@ -159,17 +128,17 @@ class AbstractSpecGenerator {
             return swaggerType;
         }
         if (type.members.length === 2) {
-            let index = type.members.findIndex((member) => (0, decorators_1.isArrayType)(member));
+            let index = type.members.findIndex((member) => (0, metadata_1.isArrayType)(member));
             if (index !== -1) {
                 const otherIndex = index === 0 ? 1 : 0;
                 if (type.members[index].elementType.typeName === type.members[otherIndex].typeName) {
                     return this.getSwaggerType(type.members[otherIndex]);
                 }
             }
-            index = type.members.findIndex((member) => (0, decorators_1.isAnyType)(member));
+            index = type.members.findIndex((member) => (0, metadata_1.isAnyType)(member));
             if (index !== -1) {
                 const otherIndex = index === 0 ? 1 : 0;
-                if ((0, decorators_1.isAnyType)(type.members[index])) {
+                if ((0, metadata_1.isAnyType)(type.members[index])) {
                     return this.getSwaggerType(type.members[otherIndex]);
                 }
             }
@@ -208,7 +177,12 @@ class AbstractSpecGenerator {
             .filter((prop) => prop.required).map((prop) => prop.name);
         // An empty list required: [] is not valid.
         // If all properties are optional, do not specify the required keyword.
-        return Object.assign(Object.assign(Object.assign({ properties }, (additionalProperties && { additionalProperties })), (required && required.length && { required })), { type: 'object' });
+        return {
+            properties,
+            ...(additionalProperties && { additionalProperties }),
+            ...(required && required.length && { required }),
+            type: 'object',
+        };
     }
     determineTypesUsedInEnum(anEnum) {
         return anEnum.reduce((theSet, curr) => {
@@ -221,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