@tsed/swagger 7.0.0-alpha.1 → 7.0.0-beta.10

package/jest.config.js

@@ -0,0 +1,14 @@
+// For a detailed explanation regarding each configuration property, visit:
+// https://jestjs.io/docs/en/configuration.html
+
+module.exports = {
+  ...require("@tsed/jest-config")(__dirname, "swagger"),
+  coverageThreshold: {
+    global: {
+      statements: 98.27,
+      branches: 80,
+      functions: 96.66,
+      lines: 98.19
+    }
+  }
+};

package/lib/cjs/SwaggerModule.js

@@ -0,0 +1,130 @@
+"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 = 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 swagger_ui_dist_1 = require("swagger-ui-dist");
+const swaggerUiPath = (0, swagger_ui_dist_1.absolutePath)();
+/**
+ * @ignore
+ */
+let SwaggerModule = class SwaggerModule {
+    constructor() {
+        this.loaded = false;
+    }
+    get settings() {
+        return [].concat(this.configuration.get("swagger")).filter((o) => !!o);
+    }
+    /**
+     *
+     */
+    $onRoutesInit() {
+        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();
+            const url = host.toString();
+            const displayLog = (conf) => {
+                const { path = "/", fileName = "swagger.json", doc } = conf;
+                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(async (conf) => {
+            const { outFile } = conf;
+            if (this.env === core_1.Env.PROD || outFile) {
+                const spec = await 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 async (ctx) => {
+            ctx.response.status(200).body(await this.swaggerService.getOpenAPISpec(conf));
+        };
+    }
+};
+tslib_1.__decorate([
+    (0, common_1.Inject)(),
+    tslib_1.__metadata("design:type", common_1.InjectorService)
+], SwaggerModule.prototype, "injector", void 0);
+tslib_1.__decorate([
+    (0, common_1.Inject)(),
+    tslib_1.__metadata("design:type", common_1.PlatformApplication)
+], SwaggerModule.prototype, "app", void 0);
+tslib_1.__decorate([
+    (0, common_1.Configuration)(),
+    tslib_1.__metadata("design:type", Object)
+], SwaggerModule.prototype, "configuration", void 0);
+tslib_1.__decorate([
+    (0, common_1.Inject)(),
+    tslib_1.__metadata("design:type", SwaggerService_1.SwaggerService)
+], SwaggerModule.prototype, "swaggerService", void 0);
+tslib_1.__decorate([
+    (0, common_1.Constant)("env"),
+    tslib_1.__metadata("design:type", String)
+], SwaggerModule.prototype, "env", void 0);
+SwaggerModule = 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  OnRoutesInit,\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/SwaggerSettings\";\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\";\nimport {absolutePath} from \"swagger-ui-dist\";\n\nconst swaggerUiPath = absolutePath();\n\n/**\n * @ignore\n */\n@Module()\nexport class SwaggerModule implements OnRoutesInit, 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  $onRoutesInit() {\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      const url = host.toString();\n\n      const displayLog = (conf: SwaggerSettings) => {\n        const {path = \"/\", fileName = \"swagger.json\", doc} = conf;\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(async (conf) => {\n        const {outFile} = conf;\n\n        if (this.env === Env.PROD || outFile) {\n          const spec = await 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 async (ctx: PlatformContext) => {\n      ctx.response.status(200).body(await 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,19 @@
+"use strict";
+/**
+ * @file Automatically generated by barrelsby.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./SwaggerModule"), exports);
+tslib_1.__exportStar(require("./decorators/docs"), exports);
+tslib_1.__exportStar(require("./decorators/hidden"), exports);
+tslib_1.__exportStar(require("./interfaces/SwaggerSettings"), exports);
+tslib_1.__exportStar(require("./interfaces/interfaces"), exports);
+tslib_1.__exportStar(require("./middlewares/cssMiddleware"), exports);
+tslib_1.__exportStar(require("./middlewares/indexMiddleware"), exports);
+tslib_1.__exportStar(require("./middlewares/jsMiddleware"), exports);
+tslib_1.__exportStar(require("./middlewares/redirectMiddleware"), exports);
+tslib_1.__exportStar(require("./services/SwaggerService"), exports);
+tslib_1.__exportStar(require("./utils/includeRoute"), exports);
+tslib_1.__exportStar(require("./utils/matchPath"), 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;;GAEG;;;AAEH,0DAAgC;AAChC,4DAAkC;AAClC,8DAAoC;AACpC,uEAA6C;AAC7C,kEAAwC;AACxC,sEAA4C;AAC5C,wEAA8C;AAC9C,qEAA2C;AAC3C,2EAAiD;AACjD,oEAA0C;AAC1C,+DAAqC;AACrC,4DAAkC","sourcesContent":["/**\n * @file Automatically generated by barrelsby.\n */\n\nexport * from \"./SwaggerModule\";\nexport * from \"./decorators/docs\";\nexport * from \"./decorators/hidden\";\nexport * from \"./interfaces/SwaggerSettings\";\nexport * from \"./interfaces/interfaces\";\nexport * from \"./middlewares/cssMiddleware\";\nexport * from \"./middlewares/indexMiddleware\";\nexport * from \"./middlewares/jsMiddleware\";\nexport * from \"./middlewares/redirectMiddleware\";\nexport * from \"./services/SwaggerService\";\nexport * from \"./utils/includeRoute\";\nexport * from \"./utils/matchPath\";\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\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/interfaces.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../src/interfaces/interfaces.ts"],"names":[],"mappings":"","sourcesContent":["import {SwaggerSettings} from \"./SwaggerSettings\";\n\ndeclare global {\n  namespace TsED {\n    interface Configuration {\n      swagger: SwaggerSettings[];\n    }\n  }\n}\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 = 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,oDAAoB;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 = 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,oDAAoB;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/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/lib/cjs/services/SwaggerService.js

@@ -0,0 +1,44 @@
+"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 schema_1 = require("@tsed/schema");
+const includeRoute_1 = require("../utils/includeRoute");
+let SwaggerService = class SwaggerService {
+    constructor(injectorService, platform, configuration) {
+        this.injectorService = injectorService;
+        this.platform = platform;
+        this.configuration = configuration;
+        _SwaggerService_specs.set(this, new Map());
+    }
+    async getOpenAPISpec(conf) {
+        if (!tslib_1.__classPrivateFieldGet(this, _SwaggerService_specs, "f").has(conf.path)) {
+            const { version = "1.0.0", acceptMimes } = this.configuration;
+            const specPath = conf.specPath ? this.configuration.resolve(conf.specPath) : conf.specPath;
+            const tokens = this.platform
+                .getMountedControllers()
+                .filter(({ route, provider }) => (0, includeRoute_1.includeRoute)(route, provider, conf))
+                .map(({ route, provider }) => ({ token: provider.token, rootPath: route.replace(provider.path, "") }));
+            const spec = await (0, schema_1.generateSpec)({
+                tokens,
+                ...conf,
+                specPath,
+                version,
+                acceptMimes
+            });
+            tslib_1.__classPrivateFieldGet(this, _SwaggerService_specs, "f").set(conf.path, spec);
+        }
+        return tslib_1.__classPrivateFieldGet(this, _SwaggerService_specs, "f").get(conf.path);
+    }
+};
+_SwaggerService_specs = new WeakMap();
+SwaggerService = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(2, (0, common_1.Configuration)()),
+    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":";;;;;AAAA,yCAAkF;AAElF,yCAA0C;AAE1C,wDAAmD;AAGnD,IAAa,cAAc,GAA3B,MAAa,cAAc;IAGzB,YACU,eAAgC,EAChC,QAAkB,EACD,aAA4B;QAF7C,oBAAe,GAAf,eAAe,CAAiB;QAChC,aAAQ,GAAR,QAAQ,CAAU;QACD,kBAAa,GAAb,aAAa,CAAe;QALvD,gCAA6C,IAAI,GAAG,EAAE,EAAC;IAMpD,CAAC;IASG,KAAK,CAAC,cAAc,CAAC,IAAqB;QAC/C,IAAI,CAAC,+BAAA,IAAI,6BAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC/B,MAAM,EAAC,OAAO,GAAG,OAAO,EAAE,WAAW,EAAC,GAAG,IAAI,CAAC,aAAa,CAAC;YAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;YAE3F,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ;iBACzB,qBAAqB,EAAE;iBACvB,MAAM,CAAC,CAAC,EAAC,KAAK,EAAE,QAAQ,EAAC,EAAE,EAAE,CAAC,IAAA,2BAAY,EAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;iBAClE,GAAG,CAAC,CAAC,EAAC,KAAK,EAAE,QAAQ,EAAC,EAAE,EAAE,CAAC,CAAC,EAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,EAAC,CAAC,CAAC,CAAC;YAErG,MAAM,IAAI,GAAG,MAAM,IAAA,qBAAY,EAAC;gBAC9B,MAAM;gBACN,GAAG,IAAI;gBACP,QAAQ;gBACR,OAAO;gBACP,WAAW;aACZ,CAAC,CAAC;YAEH,+BAAA,IAAI,6BAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;SAClC;QAED,OAAO,+BAAA,IAAI,6BAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACF,CAAA;;AAvCY,cAAc;IAD1B,IAAA,mBAAU,GAAE;IAOR,mBAAA,IAAA,sBAAa,GAAE,CAAA;6CAFS,wBAAe;QACtB,iBAAQ;GALjB,cAAc,CAuC1B;AAvCY,wCAAc","sourcesContent":["import {Configuration, Injectable, InjectorService, Platform} from \"@tsed/common\";\nimport {OpenSpec2, OpenSpec3} from \"@tsed/openspec\";\nimport {generateSpec} from \"@tsed/schema\";\nimport {SwaggerOS2Settings, SwaggerOS3Settings, SwaggerSettings} from \"../interfaces/SwaggerSettings\";\nimport {includeRoute} from \"../utils/includeRoute\";\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 async getOpenAPISpec(conf: SwaggerOS3Settings): Promise<OpenSpec3>;\n  public async getOpenAPISpec(conf: SwaggerOS2Settings): Promise<OpenSpec2>;\n  public async getOpenAPISpec(conf: SwaggerSettings): Promise<OpenSpec2>;\n  public async getOpenAPISpec(conf: SwaggerSettings) {\n    if (!this.#specs.has(conf.path)) {\n      const {version = \"1.0.0\", acceptMimes} = this.configuration;\n      const specPath = conf.specPath ? this.configuration.resolve(conf.specPath) : conf.specPath;\n\n      const tokens = this.platform\n        .getMountedControllers()\n        .filter(({route, provider}) => includeRoute(route, provider, conf))\n        .map(({route, provider}) => ({token: provider.token, rootPath: route.replace(provider.path, \"\")}));\n\n      const spec = await generateSpec({\n        tokens,\n        ...conf,\n        specPath,\n        version,\n        acceptMimes\n      });\n\n      this.#specs.set(conf.path, spec);\n    }\n\n    return this.#specs.get(conf.path);\n  }\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 matchPath_1 = require("./matchPath");
+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, matchPath_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,2CAAsC;AAGtC,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,qBAAS,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 \"./matchPath\";\nimport {SwaggerSettings} from \"../interfaces/SwaggerSettings\";\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/matchPath.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchPath = void 0;
+const tslib_1 = require("tslib");
+const micromatch_1 = tslib_1.__importDefault(require("micromatch"));
+function matchPath(path, patterns) {
+    return patterns && patterns.length ? micromatch_1.default.isMatch(path, patterns) : true;
+}
+exports.matchPath = matchPath;
+//# sourceMappingURL=matchPath.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"matchPath.js","sourceRoot":"","sources":["../../../src/utils/matchPath.ts"],"names":[],"mappings":";;;;AAAA,oEAAoC;AAEpC,SAAgB,SAAS,CAAC,IAAY,EAAE,QAAmB;IACzD,OAAO,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,oBAAU,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjF,CAAC;AAFD,8BAEC","sourcesContent":["import micromatch from \"micromatch\";\n\nexport function matchPath(path: string, patterns?: string[]) {\n  return patterns && patterns.length ? micromatch.isMatch(path, patterns) : true;\n}\n"]}

package/lib/esm/SwaggerModule.js

@@ -0,0 +1,127 @@
+import { __decorate, __metadata } from "tslib";
+import { Configuration, Constant, Inject, InjectorService, Module, normalizePath, PlatformApplication, PlatformRouter, useCtxHandler } from "@tsed/common";
+import Fs from "fs";
+import { join } from "path";
+import { cssMiddleware } from "./middlewares/cssMiddleware.js";
+import { indexMiddleware } from "./middlewares/indexMiddleware.js";
+import { jsMiddleware } from "./middlewares/jsMiddleware.js";
+import { redirectMiddleware } from "./middlewares/redirectMiddleware.js";
+import { SwaggerService } from "./services/SwaggerService.js";
+import { Env } from "@tsed/core";
+import { absolutePath } from "swagger-ui-dist";
+const swaggerUiPath = absolutePath();
+/**
+ * @ignore
+ */
+let SwaggerModule = class SwaggerModule {
+    constructor() {
+        this.loaded = false;
+    }
+    get settings() {
+        return [].concat(this.configuration.get("swagger")).filter((o) => !!o);
+    }
+    /**
+     *
+     */
+    $onRoutesInit() {
+        if (this.loaded) {
+            return;
+        }
+        const urls = this.getUrls();
+        this.settings.forEach((conf) => {
+            const { path = "/" } = conf;
+            this.app.get(path, useCtxHandler(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();
+            const url = host.toString();
+            const displayLog = (conf) => {
+                const { path = "/", fileName = "swagger.json", doc } = conf;
+                this.injector.logger.info(`[${doc || "default"}] Swagger JSON is available on ${url}${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(async (conf) => {
+            const { outFile } = conf;
+            if (this.env === Env.PROD || outFile) {
+                const spec = await this.swaggerService.getOpenAPISpec(conf);
+                if (outFile) {
+                    return Fs.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: normalizePath(path, fileName), name: doc || path });
+            }
+            return acc;
+        }, []);
+    }
+    /**
+     *
+     * @param conf
+     * @param urls
+     */
+    createRouter(conf, urls) {
+        const { disableSpec = false, fileName = "swagger.json", cssPath, jsPath, viewPath = join(__dirname, "../views/index.ejs") } = conf;
+        const router = PlatformRouter.create(this.injector);
+        if (!disableSpec) {
+            router.get(normalizePath("/", fileName), useCtxHandler(this.middlewareSwaggerJson(conf)));
+        }
+        if (viewPath) {
+            if (cssPath) {
+                router.get("/main.css", useCtxHandler(cssMiddleware(cssPath)));
+            }
+            if (jsPath) {
+                router.get("/main.js", useCtxHandler(jsMiddleware(jsPath)));
+            }
+            router.get("/", useCtxHandler(indexMiddleware(viewPath, { urls, ...conf })));
+            router.statics("/", { root: swaggerUiPath });
+        }
+        return router;
+    }
+    middlewareSwaggerJson(conf) {
+        return async (ctx) => {
+            ctx.response.status(200).body(await this.swaggerService.getOpenAPISpec(conf));
+        };
+    }
+};
+__decorate([
+    Inject(),
+    __metadata("design:type", InjectorService)
+], SwaggerModule.prototype, "injector", void 0);
+__decorate([
+    Inject(),
+    __metadata("design:type", PlatformApplication)
+], SwaggerModule.prototype, "app", void 0);
+__decorate([
+    Configuration(),
+    __metadata("design:type", Object)
+], SwaggerModule.prototype, "configuration", void 0);
+__decorate([
+    Inject(),
+    __metadata("design:type", SwaggerService)
+], SwaggerModule.prototype, "swaggerService", void 0);
+__decorate([
+    Constant("env"),
+    __metadata("design:type", String)
+], SwaggerModule.prototype, "env", void 0);
+SwaggerModule = __decorate([
+    Module()
+], SwaggerModule);
+export { SwaggerModule };
+//# sourceMappingURL=SwaggerModule.js.map

package/lib/esm/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  OnRoutesInit,\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/SwaggerSettings\";\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\";\nimport {absolutePath} from \"swagger-ui-dist\";\n\nconst swaggerUiPath = absolutePath();\n\n/**\n * @ignore\n */\n@Module()\nexport class SwaggerModule implements OnRoutesInit, 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  $onRoutesInit() {\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      const url = host.toString();\n\n      const displayLog = (conf: SwaggerSettings) => {\n        const {path = \"/\", fileName = \"swagger.json\", doc} = conf;\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(async (conf) => {\n        const {outFile} = conf;\n\n        if (this.env === Env.PROD || outFile) {\n          const spec = await 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 async (ctx: PlatformContext) => {\n      ctx.response.status(200).body(await this.swaggerService.getOpenAPISpec(conf));\n    };\n  }\n}\n"]}