@tsed/swagger 6.87.1 → 6.89.0

package/lib/{SwaggerModule.d.ts → cjs/SwaggerModule.d.ts}

@@ -1,6 +1,7 @@
 import { BeforeRoutesInit, Configuration, InjectorService, OnReady, PlatformApplication } from "@tsed/common";
 import { SwaggerSettings } from "./interfaces";
 import { SwaggerService } from "./services/SwaggerService";
+import { Env } from "@tsed/core";
 /**
  * @ignore
  */
@@ -9,6 +10,7 @@ export declare class SwaggerModule implements BeforeRoutesInit, OnReady {
     app: PlatformApplication;
     configuration: Configuration;
     swaggerService: SwaggerService;
+    env: Env;
     private loaded;
     get settings(): SwaggerSettings[];
     /**

package/lib/cjs/SwaggerModule.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SwaggerModule = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@tsed/common");
+const fs_1 = (0, tslib_1.__importDefault)(require("fs"));
+const path_1 = require("path");
+const cssMiddleware_1 = require("./middlewares/cssMiddleware");
+const indexMiddleware_1 = require("./middlewares/indexMiddleware");
+const jsMiddleware_1 = require("./middlewares/jsMiddleware");
+const redirectMiddleware_1 = require("./middlewares/redirectMiddleware");
+const SwaggerService_1 = require("./services/SwaggerService");
+const core_1 = require("@tsed/core");
+const swaggerUiPath = require("swagger-ui-dist").absolutePath();
+/**
+ * @ignore
+ */
+let SwaggerModule = class SwaggerModule {
+    constructor() {
+        this.loaded = false;
+    }
+    get settings() {
+        return [].concat(this.configuration.get("swagger")).filter((o) => !!o);
+    }
+    /**
+     *
+     */
+    $beforeRoutesInit() {
+        if (this.loaded) {
+            return;
+        }
+        const urls = this.getUrls();
+        this.settings.forEach((conf) => {
+            const { path = "/" } = conf;
+            this.app.get(path, (0, common_1.useCtxHandler)((0, redirectMiddleware_1.redirectMiddleware)(path)));
+            this.app.use(path, this.createRouter(conf, urls));
+        });
+        this.loaded = true;
+    }
+    $onReady() {
+        // istanbul ignore next
+        if (this.configuration.getBestHost) {
+            const host = this.configuration.getBestHost();
+            if (!host) {
+                return;
+            }
+            const displayLog = (conf) => {
+                const { path = "/", fileName = "swagger.json", doc } = conf;
+                let url = "/";
+                if (host) {
+                    url = typeof host.port === "number" ? `${host.protocol}://${host.address}:${host.port}` : "";
+                }
+                this.injector.logger.info(`[${doc || "default"}] Swagger JSON is available on ${url}${(0, common_1.normalizePath)(path, fileName)}`);
+                this.injector.logger.info(`[${doc || "default"}] Swagger UI is available on ${url}${path}/`);
+            };
+            this.settings.forEach((conf) => {
+                displayLog(conf);
+            });
+        }
+        this.generateSpecFiles();
+    }
+    generateSpecFiles() {
+        return Promise.all(this.settings.map((conf) => {
+            const { outFile } = conf;
+            if (this.env === core_1.Env.PROD || outFile) {
+                const spec = this.swaggerService.getOpenAPISpec(conf);
+                if (outFile) {
+                    return fs_1.default.writeFile(outFile, JSON.stringify(spec, null, 2), { encoding: "utf8" }, () => { });
+                }
+            }
+        }));
+    }
+    getUrls() {
+        return this.settings.reduce((acc, conf) => {
+            const { path = "/", fileName = "swagger.json", doc, hidden } = conf;
+            if (!hidden) {
+                acc.push({ url: (0, common_1.normalizePath)(path, fileName), name: doc || path });
+            }
+            return acc;
+        }, []);
+    }
+    /**
+     *
+     * @param conf
+     * @param urls
+     */
+    createRouter(conf, urls) {
+        const { disableSpec = false, fileName = "swagger.json", cssPath, jsPath, viewPath = (0, path_1.join)(__dirname, "../views/index.ejs") } = conf;
+        const router = common_1.PlatformRouter.create(this.injector);
+        if (!disableSpec) {
+            router.get((0, common_1.normalizePath)("/", fileName), (0, common_1.useCtxHandler)(this.middlewareSwaggerJson(conf)));
+        }
+        if (viewPath) {
+            if (cssPath) {
+                router.get("/main.css", (0, common_1.useCtxHandler)((0, cssMiddleware_1.cssMiddleware)(cssPath)));
+            }
+            if (jsPath) {
+                router.get("/main.js", (0, common_1.useCtxHandler)((0, jsMiddleware_1.jsMiddleware)(jsPath)));
+            }
+            router.get("/", (0, common_1.useCtxHandler)((0, indexMiddleware_1.indexMiddleware)(viewPath, { urls, ...conf })));
+            router.statics("/", { root: swaggerUiPath });
+        }
+        return router;
+    }
+    middlewareSwaggerJson(conf) {
+        return (ctx) => {
+            ctx.response.status(200).body(this.swaggerService.getOpenAPISpec(conf));
+        };
+    }
+};
+(0, tslib_1.__decorate)([
+    (0, common_1.Inject)(),
+    (0, tslib_1.__metadata)("design:type", common_1.InjectorService)
+], SwaggerModule.prototype, "injector", void 0);
+(0, tslib_1.__decorate)([
+    (0, common_1.Inject)(),
+    (0, tslib_1.__metadata)("design:type", common_1.PlatformApplication)
+], SwaggerModule.prototype, "app", void 0);
+(0, tslib_1.__decorate)([
+    (0, common_1.Configuration)(),
+    (0, tslib_1.__metadata)("design:type", Object)
+], SwaggerModule.prototype, "configuration", void 0);
+(0, tslib_1.__decorate)([
+    (0, common_1.Inject)(),
+    (0, tslib_1.__metadata)("design:type", SwaggerService_1.SwaggerService)
+], SwaggerModule.prototype, "swaggerService", void 0);
+(0, tslib_1.__decorate)([
+    (0, common_1.Constant)("env"),
+    (0, tslib_1.__metadata)("design:type", String)
+], SwaggerModule.prototype, "env", void 0);
+SwaggerModule = (0, tslib_1.__decorate)([
+    (0, common_1.Module)()
+], SwaggerModule);
+exports.SwaggerModule = SwaggerModule;
+//# sourceMappingURL=SwaggerModule.js.map

package/lib/cjs/SwaggerModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SwaggerModule.js","sourceRoot":"","sources":["../../src/SwaggerModule.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  BeforeRoutesInit,\n  Configuration,\n  Constant,\n  Inject,\n  InjectorService,\n  Module,\n  normalizePath,\n  OnReady,\n  PlatformApplication,\n  PlatformContext,\n  PlatformRouter,\n  useCtxHandler\n} from \"@tsed/common\";\nimport Fs from \"fs\";\nimport {join} from \"path\";\nimport {SwaggerSettings} from \"./interfaces\";\nimport {cssMiddleware} from \"./middlewares/cssMiddleware\";\nimport {indexMiddleware} from \"./middlewares/indexMiddleware\";\nimport {jsMiddleware} from \"./middlewares/jsMiddleware\";\nimport {redirectMiddleware} from \"./middlewares/redirectMiddleware\";\nimport {SwaggerService} from \"./services/SwaggerService\";\nimport {Env} from \"@tsed/core\";\n\nconst swaggerUiPath = require(\"swagger-ui-dist\").absolutePath();\n\n/**\n * @ignore\n */\n@Module()\nexport class SwaggerModule implements BeforeRoutesInit, OnReady {\n  @Inject()\n  injector: InjectorService;\n\n  @Inject()\n  app: PlatformApplication;\n\n  @Configuration()\n  configuration: Configuration;\n\n  @Inject()\n  swaggerService: SwaggerService;\n\n  @Constant(\"env\")\n  env: Env;\n\n  private loaded = false;\n\n  get settings() {\n    return ([] as SwaggerSettings[]).concat(this.configuration.get<SwaggerSettings[]>(\"swagger\")).filter((o) => !!o);\n  }\n\n  /**\n   *\n   */\n  $beforeRoutesInit() {\n    if (this.loaded) {\n      return;\n    }\n\n    const urls: any[] = this.getUrls();\n\n    this.settings.forEach((conf: SwaggerSettings) => {\n      const {path = \"/\"} = conf;\n\n      this.app.get(path, useCtxHandler(redirectMiddleware(path)));\n      this.app.use(path, this.createRouter(conf, urls));\n    });\n\n    this.loaded = true;\n  }\n\n  $onReady() {\n    // istanbul ignore next\n    if (this.configuration.getBestHost) {\n      const host = this.configuration.getBestHost();\n\n      if (!host) {\n        return;\n      }\n\n      const displayLog = (conf: SwaggerSettings) => {\n        const {path = \"/\", fileName = \"swagger.json\", doc} = conf;\n\n        let url = \"/\";\n\n        if (host) {\n          url = typeof host.port === \"number\" ? `${host.protocol}://${host.address}:${host.port}` : \"\";\n        }\n\n        this.injector.logger.info(`[${doc || \"default\"}] Swagger JSON is available on ${url}${normalizePath(path, fileName)}`);\n        this.injector.logger.info(`[${doc || \"default\"}] Swagger UI is available on ${url}${path}/`);\n      };\n\n      this.settings.forEach((conf) => {\n        displayLog(conf);\n      });\n    }\n\n    this.generateSpecFiles();\n  }\n\n  generateSpecFiles() {\n    return Promise.all(\n      this.settings.map((conf) => {\n        const {outFile} = conf;\n\n        if (this.env === Env.PROD || outFile) {\n          const spec = this.swaggerService.getOpenAPISpec(conf);\n\n          if (outFile) {\n            return Fs.writeFile(outFile, JSON.stringify(spec, null, 2), {encoding: \"utf8\"}, () => {});\n          }\n        }\n      })\n    );\n  }\n\n  private getUrls() {\n    return this.settings.reduce((acc: any[], conf) => {\n      const {path = \"/\", fileName = \"swagger.json\", doc, hidden} = conf;\n\n      if (!hidden) {\n        acc.push({url: normalizePath(path, fileName), name: doc || path});\n      }\n\n      return acc;\n    }, []);\n  }\n\n  /**\n   *\n   * @param conf\n   * @param urls\n   */\n  private createRouter(conf: SwaggerSettings, urls: string[]) {\n    const {disableSpec = false, fileName = \"swagger.json\", cssPath, jsPath, viewPath = join(__dirname, \"../views/index.ejs\")} = conf;\n    const router = PlatformRouter.create(this.injector);\n\n    if (!disableSpec) {\n      router.get(normalizePath(\"/\", fileName), useCtxHandler(this.middlewareSwaggerJson(conf)));\n    }\n\n    if (viewPath) {\n      if (cssPath) {\n        router.get(\"/main.css\", useCtxHandler(cssMiddleware(cssPath)));\n      }\n\n      if (jsPath) {\n        router.get(\"/main.js\", useCtxHandler(jsMiddleware(jsPath)));\n      }\n\n      router.get(\"/\", useCtxHandler(indexMiddleware(viewPath, {urls, ...conf})));\n      router.statics(\"/\", {root: swaggerUiPath});\n    }\n\n    return router;\n  }\n\n  private middlewareSwaggerJson(conf: SwaggerSettings) {\n    return (ctx: PlatformContext) => {\n      ctx.response.status(200).body(this.swaggerService.getOpenAPISpec(conf));\n    };\n  }\n}\n"]}

package/lib/cjs/decorators/docs.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Docs = void 0;
+const core_1 = require("@tsed/core");
+/**
+ * Set the type documentation for this class.
+ *
+ * See [swagger documentation](/tutorials/swagger.html)
+ *
+ * @decorator
+ * @swagger
+ * @param docs
+ */
+function Docs(...docs) {
+    return (0, core_1.StoreMerge)("docs", docs);
+}
+exports.Docs = Docs;
+//# sourceMappingURL=docs.js.map

package/lib/cjs/decorators/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/decorators/docs.ts"],"names":[],"mappings":";;;AAAA,qCAAsC;AAEtC;;;;;;;;GAQG;AACH,SAAgB,IAAI,CAAC,GAAG,IAAc;IACpC,OAAO,IAAA,iBAAU,EAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC;AAFD,oBAEC","sourcesContent":["import {StoreMerge} from \"@tsed/core\";\n\n/**\n * Set the type documentation for this class.\n *\n * See [swagger documentation](/tutorials/swagger.html)\n *\n * @decorator\n * @swagger\n * @param docs\n */\nexport function Docs(...docs: string[]) {\n  return StoreMerge(\"docs\", docs);\n}\n"]}

package/lib/cjs/decorators/hidden.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Hidden = void 0;
+const schema_1 = require("@tsed/schema");
+/**
+ * Disable documentation for the class and his endpoint.
+ *
+ * ````typescript
+ * @Controller('/')
+ * export class Ctrl {
+ *
+ *   @Get('/')
+ *   @Hidden()
+ *   hiddenRoute(){
+ *
+ *   }
+ * }
+ *
+ * @Controller('/')
+ * @Hidden()
+ * export class Ctrl {
+ *   @Get('/')
+ *   hiddenRoute() {
+ *
+ *   }
+ *   @Get('/2')
+ *   hiddenRoute2() {
+ *
+ *   }
+ * }
+ * ```
+ *
+ * @decorator
+ * @swagger
+ */
+function Hidden() {
+    return (0, schema_1.Hidden)();
+}
+exports.Hidden = Hidden;
+//# sourceMappingURL=hidden.js.map

package/lib/cjs/decorators/hidden.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hidden.js","sourceRoot":"","sources":["../../../src/decorators/hidden.ts"],"names":[],"mappings":";;;AAAA,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,SAAgB,MAAM;IACpB,OAAO,IAAA,eAAC,GAAE,CAAC;AACb,CAAC;AAFD,wBAEC","sourcesContent":["import {Hidden as H} from \"@tsed/schema\";\n\n/**\n * Disable documentation for the class and his endpoint.\n *\n * ````typescript\n * @Controller('/')\n * export class Ctrl {\n *\n *   @Get('/')\n *   @Hidden()\n *   hiddenRoute(){\n *\n *   }\n * }\n *\n * @Controller('/')\n * @Hidden()\n * export class Ctrl {\n *   @Get('/')\n *   hiddenRoute() {\n *\n *   }\n *   @Get('/2')\n *   hiddenRoute2() {\n *\n *   }\n * }\n * ```\n *\n * @decorator\n * @swagger\n */\nexport function Hidden() {\n  return H();\n}\n"]}

package/lib/cjs/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+(0, tslib_1.__exportStar)(require("./services/SwaggerService"), exports);
+(0, tslib_1.__exportStar)(require("./SwaggerModule"), exports);
+(0, tslib_1.__exportStar)(require("./interfaces"), exports);
+(0, tslib_1.__exportStar)(require("./decorators/docs"), exports);
+(0, tslib_1.__exportStar)(require("./decorators/hidden"), exports);
+//# sourceMappingURL=index.js.map

package/lib/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,yEAA0C;AAC1C,+DAAgC;AAChC,4DAA6B;AAC7B,iEAAkC;AAClC,mEAAoC","sourcesContent":["export * from \"./services/SwaggerService\";\nexport * from \"./SwaggerModule\";\nexport * from \"./interfaces\";\nexport * from \"./decorators/docs\";\nexport * from \"./decorators/hidden\";\n"]}

package/lib/cjs/interfaces/SwaggerSettings.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=SwaggerSettings.js.map

package/lib/cjs/interfaces/SwaggerSettings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SwaggerSettings.js","sourceRoot":"","sources":["../../../src/interfaces/SwaggerSettings.ts"],"names":[],"mappings":"","sourcesContent":["import {OpenSpec2, OpenSpec3, OpenSpecVersions, OS2Versions, OS3Versions} from \"@tsed/openspec\";\n\nexport interface SwaggerUIOptions {\n  configUrl?: string;\n  url?: string;\n  urls?: {url: string; name: string; primaryName?: string}[];\n  layout?: string;\n  validatorUrl?: string;\n  oauth?: any;\n  authorize?: any;\n\n  [key: string]: any;\n}\n\nexport interface SwaggerSettingsBase {\n  /**\n   * The url subpath to access to the documentation.\n   */\n  path: string;\n  /**\n   * Specify the spec version you want to generate.\n   */\n  specVersion?: OpenSpecVersions;\n  /**\n   * Swagger file name. By default swagger.json\n   */\n  fileName?: string;\n  /**\n   * Hidden documentation. Use this to hide documentation link in the dropdown.\n   */\n  hidden?: string;\n  /**\n   * The documentation key used by `@Docs` decorator to create several swagger documentations.\n   */\n  doc?: string;\n  /**\n   * The path to the CSS file.\n   */\n  cssPath?: string;\n  /**\n   * The path to the JS file.\n   */\n  jsPath?: string;\n  /**\n   * The path to the ejs file to create html page.\n   */\n  viewPath?: string | false;\n  /**\n   * SwaggerUI options. See (https://github.com/swagger-api/swagger-ui/blob/HEAD/docs/usage/configuration.md)\n   */\n  options?: SwaggerUIOptions;\n  /**\n   * Display the search field in the navbar.\n   */\n  showExplorer?: boolean;\n  /**\n   * Load the base spec documentation from the specified path.\n   */\n  specPath?: string;\n  /**\n   * Write the `swagger.json` spec documentation on the specified path.\n   */\n  outFile?: string;\n  /**\n   * A function to generate the operationId.\n   */\n  operationIdFormatter?: (name: string, propertyKey: string, path: string) => string;\n  /**\n   * A pattern to generate the operationId. Format of operationId field (%c: class name, %m: method name).\n   */\n  operationIdPattern?: string;\n  /**\n   *\n   */\n  disableSpec?: boolean;\n  /**\n   * Include only controllers whose paths match the pattern list provided.\n   */\n  pathPatterns?: string[];\n}\n\n/**\n * @deprecated Since 2021-09-03. Will be removed in v7.\n */\nexport interface SwaggerOS2Settings extends SwaggerSettingsBase {\n  specVersion?: OS2Versions;\n  /**\n   * OpenSpec 2\n   */\n  spec?: Partial<OpenSpec2>;\n}\n\nexport interface SwaggerOS3Settings extends SwaggerSettingsBase {\n  specVersion?: OS3Versions;\n  /**\n   * OpenSpec 3\n   */\n  spec?: Partial<OpenSpec3>;\n}\n\nexport type SwaggerSettings = SwaggerOS2Settings | SwaggerOS3Settings;\n"]}

package/lib/cjs/interfaces/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+(0, tslib_1.__exportStar)(require("./SwaggerSettings"), exports);
+//# sourceMappingURL=index.js.map

package/lib/cjs/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interfaces/index.ts"],"names":[],"mappings":";;;AAUA,iEAAkC","sourcesContent":["import {SwaggerSettings} from \"./SwaggerSettings\";\n\ndeclare global {\n  namespace TsED {\n    interface Configuration {\n      swagger: SwaggerSettings[];\n    }\n  }\n}\n\nexport * from \"./SwaggerSettings\";\n"]}

package/lib/cjs/middlewares/cssMiddleware.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cssMiddleware = void 0;
+const tslib_1 = require("tslib");
+const fs_1 = (0, tslib_1.__importDefault)(require("fs"));
+const path_1 = require("path");
+/**
+ * @ignore
+ * @param path
+ */
+function cssMiddleware(path) {
+    return (ctx) => {
+        const content = fs_1.default.readFileSync((0, path_1.resolve)(path), { encoding: "utf8" });
+        ctx.response
+            .setHeaders({
+            "Content-Type": "text/css"
+        })
+            .status(200)
+            .body(content);
+    };
+}
+exports.cssMiddleware = cssMiddleware;
+//# sourceMappingURL=cssMiddleware.js.map

package/lib/cjs/middlewares/cssMiddleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cssMiddleware.js","sourceRoot":"","sources":["../../../src/middlewares/cssMiddleware.ts"],"names":[],"mappings":";;;;AACA,yDAAoB;AACpB,+BAA6B;AAE7B;;;GAGG;AACH,SAAgB,aAAa,CAAC,IAAY;IACxC,OAAO,CAAC,GAAoB,EAAE,EAAE;QAC9B,MAAM,OAAO,GAAG,YAAE,CAAC,YAAY,CAAC,IAAA,cAAO,EAAC,IAAI,CAAC,EAAE,EAAC,QAAQ,EAAE,MAAM,EAAC,CAAC,CAAC;QACnE,GAAG,CAAC,QAAQ;aACT,UAAU,CAAC;YACV,cAAc,EAAE,UAAU;SAC3B,CAAC;aACD,MAAM,CAAC,GAAG,CAAC;aACX,IAAI,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC,CAAC;AACJ,CAAC;AAVD,sCAUC","sourcesContent":["import {PlatformContext} from \"@tsed/common\";\nimport Fs from \"fs\";\nimport {resolve} from \"path\";\n\n/**\n * @ignore\n * @param path\n */\nexport function cssMiddleware(path: string) {\n  return (ctx: PlatformContext) => {\n    const content = Fs.readFileSync(resolve(path), {encoding: \"utf8\"});\n    ctx.response\n      .setHeaders({\n        \"Content-Type\": \"text/css\"\n      })\n      .status(200)\n      .body(content);\n  };\n}\n"]}

package/lib/cjs/middlewares/indexMiddleware.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.indexMiddleware = void 0;
+/**
+ * @ignore
+ * @param viewPath
+ * @param conf
+ */
+function indexMiddleware(viewPath, conf) {
+    return async (ctx) => {
+        const { path = "/", options = {}, showExplorer, cssPath, jsPath, urls } = conf;
+        ctx.response.body(await ctx.response.render(viewPath, {
+            spec: {},
+            url: `${path}/swagger.json`,
+            urls,
+            showExplorer,
+            cssPath,
+            jsPath,
+            swaggerOptions: options
+        }));
+    };
+}
+exports.indexMiddleware = indexMiddleware;
+//# sourceMappingURL=indexMiddleware.js.map

package/lib/cjs/middlewares/indexMiddleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexMiddleware.js","sourceRoot":"","sources":["../../../src/middlewares/indexMiddleware.ts"],"names":[],"mappings":";;;AAGA;;;;GAIG;AACH,SAAgB,eAAe,CAAC,QAAgB,EAAE,IAAwC;IACxF,OAAO,KAAK,EAAE,GAAoB,EAAE,EAAE;QACpC,MAAM,EAAC,IAAI,GAAG,GAAG,EAAE,OAAO,GAAG,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAC,GAAG,IAAI,CAAC;QAE7E,GAAG,CAAC,QAAQ,CAAC,IAAI,CACf,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE;YAClC,IAAI,EAAE,EAAE;YACR,GAAG,EAAE,GAAG,IAAI,eAAe;YAC3B,IAAI;YACJ,YAAY;YACZ,OAAO;YACP,MAAM;YACN,cAAc,EAAE,OAAO;SACxB,CAAC,CACH,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAhBD,0CAgBC","sourcesContent":["import {PlatformContext} from \"@tsed/common\";\nimport {SwaggerSettings} from \"../interfaces/SwaggerSettings\";\n\n/**\n * @ignore\n * @param viewPath\n * @param conf\n */\nexport function indexMiddleware(viewPath: string, conf: SwaggerSettings & {urls: string[]}) {\n  return async (ctx: PlatformContext) => {\n    const {path = \"/\", options = {}, showExplorer, cssPath, jsPath, urls} = conf;\n\n    ctx.response.body(\n      await ctx.response.render(viewPath, {\n        spec: {},\n        url: `${path}/swagger.json`,\n        urls,\n        showExplorer,\n        cssPath,\n        jsPath,\n        swaggerOptions: options\n      })\n    );\n  };\n}\n"]}

package/lib/cjs/middlewares/jsMiddleware.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsMiddleware = void 0;
+const tslib_1 = require("tslib");
+const fs_1 = (0, tslib_1.__importDefault)(require("fs"));
+const path_1 = require("path");
+/**
+ * @ignore
+ * @param path
+ */
+function jsMiddleware(path) {
+    return (ctx) => {
+        const content = fs_1.default.readFileSync((0, path_1.resolve)(path), { encoding: "utf8" });
+        ctx.response.setHeaders({ "Content-Type": "application/javascript" }).status(200).body(content);
+    };
+}
+exports.jsMiddleware = jsMiddleware;
+//# sourceMappingURL=jsMiddleware.js.map

package/lib/cjs/middlewares/jsMiddleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsMiddleware.js","sourceRoot":"","sources":["../../../src/middlewares/jsMiddleware.ts"],"names":[],"mappings":";;;;AACA,yDAAoB;AACpB,+BAA6B;AAE7B;;;GAGG;AACH,SAAgB,YAAY,CAAC,IAAY;IACvC,OAAO,CAAC,GAAoB,EAAE,EAAE;QAC9B,MAAM,OAAO,GAAG,YAAE,CAAC,YAAY,CAAC,IAAA,cAAO,EAAC,IAAI,CAAC,EAAE,EAAC,QAAQ,EAAE,MAAM,EAAC,CAAC,CAAC;QACnE,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAC,cAAc,EAAE,wBAAwB,EAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChG,CAAC,CAAC;AACJ,CAAC;AALD,oCAKC","sourcesContent":["import {PlatformContext} from \"@tsed/common\";\nimport Fs from \"fs\";\nimport {resolve} from \"path\";\n\n/**\n * @ignore\n * @param path\n */\nexport function jsMiddleware(path: string) {\n  return (ctx: PlatformContext) => {\n    const content = Fs.readFileSync(resolve(path), {encoding: \"utf8\"});\n    ctx.response.setHeaders({\"Content-Type\": \"application/javascript\"}).status(200).body(content);\n  };\n}\n"]}

package/lib/cjs/middlewares/redirectMiddleware.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.redirectMiddleware = void 0;
+/**
+ * @ignore
+ * @param path
+ */
+function redirectMiddleware(path) {
+    return (ctx) => {
+        if (ctx.request.url === path && !ctx.request.url.match(/\/$/)) {
+            ctx.response.redirect(302, `${path}/`);
+        }
+    };
+}
+exports.redirectMiddleware = redirectMiddleware;
+//# sourceMappingURL=redirectMiddleware.js.map

package/lib/cjs/middlewares/redirectMiddleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirectMiddleware.js","sourceRoot":"","sources":["../../../src/middlewares/redirectMiddleware.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,IAAY;IAC7C,OAAO,CAAC,GAAoB,EAAE,EAAE;QAC9B,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;YAC7D,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,CAAC,CAAC;SACxC;IACH,CAAC,CAAC;AACJ,CAAC;AAND,gDAMC","sourcesContent":["import {PlatformContext} from \"@tsed/common\";\n\n/**\n * @ignore\n * @param path\n */\nexport function redirectMiddleware(path: string) {\n  return (ctx: PlatformContext) => {\n    if (ctx.request.url === path && !ctx.request.url.match(/\\/$/)) {\n      ctx.response.redirect(302, `${path}/`);\n    }\n  };\n}\n"]}

package/lib/cjs/services/SwaggerService.js

@@ -0,0 +1,103 @@
+"use strict";
+var _SwaggerService_specs;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SwaggerService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@tsed/common");
+const core_1 = require("@tsed/core");
+const schema_1 = require("@tsed/schema");
+const fs_1 = (0, tslib_1.__importDefault)(require("fs"));
+const getSpecType_1 = require("../utils/getSpecType");
+const includeRoute_1 = require("../utils/includeRoute");
+const mapOpenSpec_1 = require("../utils/mapOpenSpec");
+let SwaggerService = class SwaggerService {
+    constructor(injectorService, platform, configuration) {
+        this.injectorService = injectorService;
+        this.platform = platform;
+        this.configuration = configuration;
+        _SwaggerService_specs.set(this, new Map());
+    }
+    getOpenAPISpec(conf) {
+        if (!(0, tslib_1.__classPrivateFieldGet)(this, _SwaggerService_specs, "f").has(conf.path)) {
+            const defaultSpec = this.getDefaultSpec(conf);
+            const specType = (0, getSpecType_1.getSpecTypeFromSpec)(defaultSpec);
+            let finalSpec = {};
+            const options = {
+                paths: {},
+                tags: [],
+                schemas: {},
+                specType,
+                operationIdFormatter: conf.operationIdFormatter,
+                operationIdPattern: conf.operationIdPattern,
+                append(spec) {
+                    finalSpec = (0, schema_1.mergeSpec)(finalSpec, spec);
+                }
+            };
+            this.platform.getMountedControllers().forEach(({ route, provider }) => {
+                if ((0, includeRoute_1.includeRoute)(route, provider, conf)) {
+                    const spec = this.buildRoutes(provider, {
+                        ...options,
+                        rootPath: route.replace(provider.path, "")
+                    });
+                    options.append(spec);
+                }
+            });
+            (0, tslib_1.__classPrivateFieldGet)(this, _SwaggerService_specs, "f").set(conf.path, (0, schema_1.mergeSpec)(defaultSpec, finalSpec));
+        }
+        return (0, tslib_1.__classPrivateFieldGet)(this, _SwaggerService_specs, "f").get(conf.path);
+    }
+    /**
+     * Return the global api information.
+     */
+    getDefaultSpec(conf) {
+        const { version = "1.0.0", acceptMimes } = this.configuration;
+        const { specPath, specVersion } = conf;
+        const fileSpec = specPath ? this.readSpecPath(specPath) : {};
+        return (0, mapOpenSpec_1.mapOpenSpec)((0, core_1.getValue)(conf, "spec", {}), {
+            fileSpec,
+            version,
+            specVersion,
+            acceptMimes
+        });
+    }
+    readSpecPath(path) {
+        path = this.configuration.resolve(path);
+        if (fs_1.default.existsSync(path)) {
+            const json = fs_1.default.readFileSync(path, { encoding: "utf8" });
+            /* istanbul ignore else */
+            if (json !== "") {
+                return JSON.parse(json);
+            }
+        }
+        return {};
+    }
+    /**
+     *
+     * @param ctrl
+     * @param options
+     */
+    buildRoutes(ctrl, options) {
+        const rootPath = options.rootPath + ctrl.path;
+        ctrl.children
+            .map((ctrl) => this.injectorService.getProvider(ctrl))
+            .forEach((provider) => {
+            if (!provider.store.get("hidden")) {
+                const spec = this.buildRoutes(provider, {
+                    ...options,
+                    rootPath
+                });
+                options.append(spec);
+            }
+        });
+        return (0, schema_1.getSpec)(ctrl.token, options);
+    }
+};
+_SwaggerService_specs = new WeakMap();
+SwaggerService = (0, tslib_1.__decorate)([
+    (0, common_1.Injectable)(),
+    (0, tslib_1.__param)(2, (0, common_1.Configuration)()),
+    (0, tslib_1.__metadata)("design:paramtypes", [common_1.InjectorService,
+        common_1.Platform, Object])
+], SwaggerService);
+exports.SwaggerService = SwaggerService;
+//# sourceMappingURL=SwaggerService.js.map

package/lib/cjs/services/SwaggerService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SwaggerService.js","sourceRoot":"","sources":["../../../src/services/SwaggerService.ts"],"names":[],"mappings":"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","sourcesContent":["import {Configuration, ControllerProvider, Injectable, InjectorService, Platform} from \"@tsed/common\";\nimport {getValue} from \"@tsed/core\";\nimport {OpenSpec2, OpenSpec3} from \"@tsed/openspec\";\nimport {getSpec, mergeSpec, SpecSerializerOptions} from \"@tsed/schema\";\nimport Fs from \"fs\";\nimport {SwaggerOS2Settings, SwaggerOS3Settings, SwaggerSettings} from \"../interfaces/SwaggerSettings\";\nimport {getSpecTypeFromSpec} from \"../utils/getSpecType\";\nimport {includeRoute} from \"../utils/includeRoute\";\nimport {mapOpenSpec} from \"../utils/mapOpenSpec\";\n\n@Injectable()\nexport class SwaggerService {\n  #specs: Map<string, OpenSpec3 | OpenSpec2> = new Map();\n\n  constructor(\n    private injectorService: InjectorService,\n    private platform: Platform,\n    @Configuration() private configuration: Configuration\n  ) {}\n\n  /**\n   * Generate Spec for the given configuration\n   * @returns {Spec}\n   */\n  public getOpenAPISpec(conf: SwaggerOS3Settings): OpenSpec3;\n  public getOpenAPISpec(conf: SwaggerOS2Settings): OpenSpec2;\n  public getOpenAPISpec(conf: SwaggerSettings): OpenSpec2;\n  public getOpenAPISpec(conf: SwaggerSettings) {\n    if (!this.#specs.has(conf.path)) {\n      const defaultSpec: any = this.getDefaultSpec(conf);\n      const specType = getSpecTypeFromSpec(defaultSpec);\n      let finalSpec: any = {};\n\n      const options: SpecSerializerOptions = {\n        paths: {},\n        tags: [],\n        schemas: {},\n        specType,\n        operationIdFormatter: conf.operationIdFormatter,\n        operationIdPattern: conf.operationIdPattern,\n        append(spec: any) {\n          finalSpec = mergeSpec(finalSpec, spec);\n        }\n      };\n\n      this.platform.getMountedControllers().forEach(({route, provider}) => {\n        if (includeRoute(route, provider, conf)) {\n          const spec = this.buildRoutes(provider, {\n            ...options,\n            rootPath: route.replace(provider.path, \"\")\n          });\n\n          options.append(spec);\n        }\n      });\n\n      this.#specs.set(conf.path, mergeSpec(defaultSpec, finalSpec) as any);\n    }\n\n    return this.#specs.get(conf.path);\n  }\n\n  /**\n   * Return the global api information.\n   */\n  protected getDefaultSpec(conf: Partial<SwaggerSettings>): Partial<OpenSpec2 | OpenSpec3> {\n    const {version = \"1.0.0\", acceptMimes} = this.configuration;\n    const {specPath, specVersion} = conf;\n    const fileSpec: Partial<OpenSpec2 | OpenSpec3> = specPath ? this.readSpecPath(specPath) : {};\n\n    return mapOpenSpec(getValue(conf, \"spec\", {}), {\n      fileSpec,\n      version,\n      specVersion,\n      acceptMimes\n    });\n  }\n\n  protected readSpecPath(path: string) {\n    path = this.configuration.resolve(path);\n    if (Fs.existsSync(path)) {\n      const json = Fs.readFileSync(path, {encoding: \"utf8\"});\n      /* istanbul ignore else */\n      if (json !== \"\") {\n        return JSON.parse(json);\n      }\n    }\n\n    return {};\n  }\n\n  /**\n   *\n   * @param ctrl\n   * @param options\n   */\n  protected buildRoutes(ctrl: ControllerProvider, options: SpecSerializerOptions) {\n    const rootPath = options.rootPath + ctrl.path;\n\n    ctrl.children\n      .map((ctrl) => this.injectorService.getProvider(ctrl))\n      .forEach((provider: ControllerProvider) => {\n        if (!provider.store.get(\"hidden\")) {\n          const spec = this.buildRoutes(provider, {\n            ...options,\n            rootPath\n          });\n\n          options.append(spec);\n        }\n      });\n\n    return getSpec(ctrl.token, options);\n  }\n}\n"]}

package/lib/cjs/utils/getSpecType.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSpecTypeFromSpec = exports.getSpecType = void 0;
+const schema_1 = require("@tsed/schema");
+/**
+ * @ignore
+ * @param version
+ */
+function getSpecType(version) {
+    return version.startsWith("3.") ? schema_1.SpecTypes.OPENAPI : schema_1.SpecTypes.SWAGGER;
+}
+exports.getSpecType = getSpecType;
+/**
+ * @ignore
+ * @param spec
+ */
+function getSpecTypeFromSpec(spec) {
+    return "openapi" in spec ? schema_1.SpecTypes.OPENAPI : schema_1.SpecTypes.SWAGGER;
+}
+exports.getSpecTypeFromSpec = getSpecTypeFromSpec;
+//# sourceMappingURL=getSpecType.js.map

package/lib/cjs/utils/getSpecType.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSpecType.js","sourceRoot":"","sources":["../../../src/utils/getSpecType.ts"],"names":[],"mappings":";;;AACA,yCAAuC;AAEvC;;;GAGG;AACH,SAAgB,WAAW,CAAC,OAAe;IACzC,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,kBAAS,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAS,CAAC,OAAO,CAAC;AAC1E,CAAC;AAFD,kCAEC;AAED;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,IAAoC;IACtE,OAAO,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,kBAAS,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAS,CAAC,OAAO,CAAC;AACnE,CAAC;AAFD,kDAEC","sourcesContent":["import {OpenSpec2, OpenSpec3} from \"@tsed/openspec\";\nimport {SpecTypes} from \"@tsed/schema\";\n\n/**\n * @ignore\n * @param version\n */\nexport function getSpecType(version: string) {\n  return version.startsWith(\"3.\") ? SpecTypes.OPENAPI : SpecTypes.SWAGGER;\n}\n\n/**\n * @ignore\n * @param spec\n */\nexport function getSpecTypeFromSpec(spec: Partial<OpenSpec2 | OpenSpec3>) {\n  return \"openapi\" in spec ? SpecTypes.OPENAPI : SpecTypes.SWAGGER;\n}\n"]}

package/lib/cjs/utils/includeRoute.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.includeRoute = void 0;
+const _1 = require(".");
+function includeRoute(route, provider, conf) {
+    const hidden = provider.store.get("hidden");
+    const docs = provider.store.get("docs") || [];
+    const { doc, pathPatterns } = conf;
+    const inDoc = doc && docs.indexOf(doc) > -1;
+    const pathPatternMatch = pathPatterns && (0, _1.matchPath)(route, pathPatterns);
+    if (hidden) {
+        return false;
+    }
+    if (!doc && !pathPatterns) {
+        return true;
+    }
+    return !!(inDoc || pathPatternMatch);
+}
+exports.includeRoute = includeRoute;
+//# sourceMappingURL=includeRoute.js.map

package/lib/cjs/utils/includeRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"includeRoute.js","sourceRoot":"","sources":["../../../src/utils/includeRoute.ts"],"names":[],"mappings":";;;AACA,wBAA4B;AAG5B,SAAgB,YAAY,CAAC,KAAa,EAAE,QAA4B,EAAE,IAAqB;IAC7F,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,EAAC,GAAG,EAAE,YAAY,EAAC,GAAG,IAAI,CAAC;IACjC,MAAM,KAAK,GAAG,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,MAAM,gBAAgB,GAAG,YAAY,IAAI,IAAA,YAAS,EAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAExE,IAAI,MAAM,EAAE;QACV,OAAO,KAAK,CAAC;KACd;IAED,IAAI,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE;QACzB,OAAO,IAAI,CAAC;KACb;IAED,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,gBAAgB,CAAC,CAAC;AACvC,CAAC;AAhBD,oCAgBC","sourcesContent":["import {ControllerProvider} from \"@tsed/common\";\nimport {matchPath} from \".\";\nimport {SwaggerSettings} from \"..\";\n\nexport function includeRoute(route: string, provider: ControllerProvider, conf: SwaggerSettings): boolean {\n  const hidden = provider.store.get(\"hidden\");\n  const docs = provider.store.get(\"docs\") || [];\n  const {doc, pathPatterns} = conf;\n  const inDoc = doc && docs.indexOf(doc) > -1;\n  const pathPatternMatch = pathPatterns && matchPath(route, pathPatterns);\n\n  if (hidden) {\n    return false;\n  }\n\n  if (!doc && !pathPatterns) {\n    return true;\n  }\n\n  return !!(inDoc || pathPatternMatch);\n}\n"]}

package/lib/cjs/utils/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+(0, tslib_1.__exportStar)(require("./getSpecType"), exports);
+(0, tslib_1.__exportStar)(require("./mapOpenSpec"), exports);
+(0, tslib_1.__exportStar)(require("./mapOpenSpec2"), exports);
+(0, tslib_1.__exportStar)(require("./mapOpenSpec3"), exports);
+(0, tslib_1.__exportStar)(require("./mapOpenSpecInfo"), exports);
+(0, tslib_1.__exportStar)(require("./mapOpenSpecInfo"), exports);
+(0, tslib_1.__exportStar)(require("./matchPath"), exports);
+//# sourceMappingURL=index.js.map

package/lib/cjs/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";;;AAAA,6DAA8B;AAC9B,6DAA8B;AAC9B,8DAA+B;AAC/B,8DAA+B;AAC/B,iEAAkC;AAClC,iEAAkC;AAClC,2DAA4B","sourcesContent":["export * from \"./getSpecType\";\nexport * from \"./mapOpenSpec\";\nexport * from \"./mapOpenSpec2\";\nexport * from \"./mapOpenSpec3\";\nexport * from \"./mapOpenSpecInfo\";\nexport * from \"./mapOpenSpecInfo\";\nexport * from \"./matchPath\";\n"]}