@tsed/swagger 7.0.0-beta.2 → 7.0.0-beta.20
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/jest.config.js +14 -0
- package/lib/cjs/SwaggerModule.js +32 -28
- package/lib/cjs/SwaggerModule.js.map +1 -1
- package/lib/cjs/index.js +15 -5
- package/lib/cjs/index.js.map +1 -1
- package/lib/cjs/interfaces/SwaggerSettings.js.map +1 -1
- package/lib/cjs/interfaces/interfaces.js +3 -0
- package/lib/cjs/interfaces/interfaces.js.map +1 -0
- package/lib/cjs/middlewares/cssMiddleware.js +1 -1
- package/lib/cjs/middlewares/cssMiddleware.js.map +1 -1
- package/lib/cjs/middlewares/jsMiddleware.js +1 -1
- package/lib/cjs/middlewares/jsMiddleware.js.map +1 -1
- package/lib/cjs/package.json +3 -0
- package/lib/cjs/services/SwaggerService.js +23 -83
- package/lib/cjs/services/SwaggerService.js.map +1 -1
- package/lib/cjs/utils/includeRoute.js +2 -2
- package/lib/cjs/utils/includeRoute.js.map +1 -1
- package/lib/cjs/utils/matchPath.js +1 -1
- package/lib/cjs/utils/matchPath.js.map +1 -1
- package/lib/esm/SwaggerModule.js +25 -21
- package/lib/esm/SwaggerModule.js.map +1 -1
- package/lib/esm/index.js +15 -5
- package/lib/esm/index.js.map +1 -1
- package/lib/esm/interfaces/SwaggerSettings.js.map +1 -1
- package/lib/esm/interfaces/interfaces.js +2 -0
- package/lib/esm/interfaces/interfaces.js.map +1 -0
- package/lib/esm/package.json +3 -0
- package/lib/esm/services/SwaggerService.js +23 -83
- package/lib/esm/services/SwaggerService.js.map +1 -1
- package/lib/esm/utils/includeRoute.js +1 -1
- package/lib/esm/utils/includeRoute.js.map +1 -1
- package/lib/types/SwaggerModule.d.ts +3 -2
- package/lib/types/index.d.ts +12 -2
- package/lib/types/interfaces/SwaggerSettings.d.ts +9 -2
- package/lib/types/interfaces/{index.d.ts → interfaces.d.ts} +0 -1
- package/lib/types/services/SwaggerService.d.ts +6 -16
- package/lib/types/utils/includeRoute.d.ts +3 -3
- package/package.json +30 -21
- package/readme.md +74 -87
- package/lib/cjs/interfaces/index.js +0 -5
- package/lib/cjs/interfaces/index.js.map +0 -1
- package/lib/cjs/utils/index.js +0 -9
- package/lib/cjs/utils/index.js.map +0 -1
- package/lib/cjs/utils/mapOpenSpec.js +0 -29
- package/lib/cjs/utils/mapOpenSpec.js.map +0 -1
- package/lib/cjs/utils/mapOpenSpec3.js +0 -26
- package/lib/cjs/utils/mapOpenSpec3.js.map +0 -1
- package/lib/cjs/utils/mapOpenSpecInfo.js +0 -21
- package/lib/cjs/utils/mapOpenSpecInfo.js.map +0 -1
- package/lib/esm/interfaces/index.js +0 -2
- package/lib/esm/interfaces/index.js.map +0 -1
- package/lib/esm/utils/index.js +0 -6
- package/lib/esm/utils/index.js.map +0 -1
- package/lib/esm/utils/mapOpenSpec.js +0 -25
- package/lib/esm/utils/mapOpenSpec.js.map +0 -1
- package/lib/esm/utils/mapOpenSpec3.js +0 -22
- package/lib/esm/utils/mapOpenSpec3.js.map +0 -1
- package/lib/esm/utils/mapOpenSpecInfo.js +0 -17
- package/lib/esm/utils/mapOpenSpecInfo.js.map +0 -1
- package/lib/types/utils/index.d.ts +0 -5
- package/lib/types/utils/mapOpenSpec.d.ts +0 -10
- package/lib/types/utils/mapOpenSpec3.d.ts +0 -8
- package/lib/types/utils/mapOpenSpecInfo.d.ts +0 -6
package/jest.config.js
ADDED
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
// For a detailed explanation regarding each configuration property, visit:
|
|
2
|
+
// https://jestjs.io/docs/en/configuration.html
|
|
3
|
+
|
|
4
|
+
module.exports = {
|
|
5
|
+
...require("@tsed/jest-config")(__dirname, "swagger"),
|
|
6
|
+
coverageThreshold: {
|
|
7
|
+
global: {
|
|
8
|
+
statements: 100,
|
|
9
|
+
branches: 88.37,
|
|
10
|
+
functions: 96.55,
|
|
11
|
+
lines: 100
|
|
12
|
+
}
|
|
13
|
+
}
|
|
14
|
+
};
|
package/lib/cjs/SwaggerModule.js
CHANGED
|
@@ -3,22 +3,26 @@ Object.defineProperty(exports, "__esModule", { value: true });
|
|
|
3
3
|
exports.SwaggerModule = void 0;
|
|
4
4
|
const tslib_1 = require("tslib");
|
|
5
5
|
const common_1 = require("@tsed/common");
|
|
6
|
-
const
|
|
6
|
+
const platform_router_1 = require("@tsed/platform-router");
|
|
7
|
+
const fs_1 = tslib_1.__importDefault(require("fs"));
|
|
7
8
|
const path_1 = require("path");
|
|
9
|
+
const core_1 = require("@tsed/core");
|
|
10
|
+
const swagger_ui_dist_1 = require("swagger-ui-dist");
|
|
8
11
|
const cssMiddleware_1 = require("./middlewares/cssMiddleware");
|
|
9
12
|
const indexMiddleware_1 = require("./middlewares/indexMiddleware");
|
|
10
13
|
const jsMiddleware_1 = require("./middlewares/jsMiddleware");
|
|
11
14
|
const redirectMiddleware_1 = require("./middlewares/redirectMiddleware");
|
|
12
15
|
const SwaggerService_1 = require("./services/SwaggerService");
|
|
13
|
-
const core_1 = require("@tsed/core");
|
|
14
|
-
const swaggerUiPath = require("swagger-ui-dist").absolutePath();
|
|
15
16
|
/**
|
|
16
17
|
* @ignore
|
|
17
18
|
*/
|
|
18
19
|
let SwaggerModule = class SwaggerModule {
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
20
|
+
injector;
|
|
21
|
+
app;
|
|
22
|
+
configuration;
|
|
23
|
+
swaggerService;
|
|
24
|
+
env;
|
|
25
|
+
loaded = false;
|
|
22
26
|
get settings() {
|
|
23
27
|
return [].concat(this.configuration.get("swagger")).filter((o) => !!o);
|
|
24
28
|
}
|
|
@@ -32,7 +36,7 @@ let SwaggerModule = class SwaggerModule {
|
|
|
32
36
|
const urls = this.getUrls();
|
|
33
37
|
this.settings.forEach((conf) => {
|
|
34
38
|
const { path = "/" } = conf;
|
|
35
|
-
this.app.get(path, (0,
|
|
39
|
+
this.app.get(path, (0, platform_router_1.useContextHandler)((0, redirectMiddleware_1.redirectMiddleware)(path)));
|
|
36
40
|
this.app.use(path, this.createRouter(conf, urls));
|
|
37
41
|
});
|
|
38
42
|
this.loaded = true;
|
|
@@ -54,10 +58,10 @@ let SwaggerModule = class SwaggerModule {
|
|
|
54
58
|
this.generateSpecFiles();
|
|
55
59
|
}
|
|
56
60
|
generateSpecFiles() {
|
|
57
|
-
return Promise.all(this.settings.map((conf) => {
|
|
61
|
+
return Promise.all(this.settings.map(async (conf) => {
|
|
58
62
|
const { outFile } = conf;
|
|
59
63
|
if (this.env === core_1.Env.PROD || outFile) {
|
|
60
|
-
const spec = this.swaggerService.getOpenAPISpec(conf);
|
|
64
|
+
const spec = await this.swaggerService.getOpenAPISpec(conf);
|
|
61
65
|
if (outFile) {
|
|
62
66
|
return fs_1.default.writeFile(outFile, JSON.stringify(spec, null, 2), { encoding: "utf8" }, () => { });
|
|
63
67
|
}
|
|
@@ -80,49 +84,49 @@ let SwaggerModule = class SwaggerModule {
|
|
|
80
84
|
*/
|
|
81
85
|
createRouter(conf, urls) {
|
|
82
86
|
const { disableSpec = false, fileName = "swagger.json", cssPath, jsPath, viewPath = (0, path_1.join)(__dirname, "../views/index.ejs") } = conf;
|
|
83
|
-
const router =
|
|
87
|
+
const router = new platform_router_1.PlatformRouter(this.injector);
|
|
84
88
|
if (!disableSpec) {
|
|
85
|
-
router.get((0, common_1.normalizePath)("/", fileName), (0,
|
|
89
|
+
router.get((0, common_1.normalizePath)("/", fileName), (0, platform_router_1.useContextHandler)(this.middlewareSwaggerJson(conf)));
|
|
86
90
|
}
|
|
87
91
|
if (viewPath) {
|
|
88
92
|
if (cssPath) {
|
|
89
|
-
router.get("/main.css", (0,
|
|
93
|
+
router.get("/main.css", (0, platform_router_1.useContextHandler)((0, cssMiddleware_1.cssMiddleware)(cssPath)));
|
|
90
94
|
}
|
|
91
95
|
if (jsPath) {
|
|
92
|
-
router.get("/main.js", (0,
|
|
96
|
+
router.get("/main.js", (0, platform_router_1.useContextHandler)((0, jsMiddleware_1.jsMiddleware)(jsPath)));
|
|
93
97
|
}
|
|
94
|
-
router.get("/", (0,
|
|
95
|
-
router.statics("/", { root:
|
|
98
|
+
router.get("/", (0, platform_router_1.useContextHandler)((0, indexMiddleware_1.indexMiddleware)(viewPath, { urls, ...conf })));
|
|
99
|
+
router.statics("/", { root: (0, swagger_ui_dist_1.absolutePath)() });
|
|
96
100
|
}
|
|
97
101
|
return router;
|
|
98
102
|
}
|
|
99
103
|
middlewareSwaggerJson(conf) {
|
|
100
|
-
return (ctx) => {
|
|
101
|
-
ctx.response.status(200).body(this.swaggerService.getOpenAPISpec(conf));
|
|
104
|
+
return async (ctx) => {
|
|
105
|
+
ctx.response.status(200).body(await this.swaggerService.getOpenAPISpec(conf));
|
|
102
106
|
};
|
|
103
107
|
}
|
|
104
108
|
};
|
|
105
|
-
|
|
109
|
+
tslib_1.__decorate([
|
|
106
110
|
(0, common_1.Inject)(),
|
|
107
|
-
|
|
111
|
+
tslib_1.__metadata("design:type", common_1.InjectorService)
|
|
108
112
|
], SwaggerModule.prototype, "injector", void 0);
|
|
109
|
-
|
|
113
|
+
tslib_1.__decorate([
|
|
110
114
|
(0, common_1.Inject)(),
|
|
111
|
-
|
|
115
|
+
tslib_1.__metadata("design:type", common_1.PlatformApplication)
|
|
112
116
|
], SwaggerModule.prototype, "app", void 0);
|
|
113
|
-
|
|
117
|
+
tslib_1.__decorate([
|
|
114
118
|
(0, common_1.Configuration)(),
|
|
115
|
-
|
|
119
|
+
tslib_1.__metadata("design:type", Object)
|
|
116
120
|
], SwaggerModule.prototype, "configuration", void 0);
|
|
117
|
-
|
|
121
|
+
tslib_1.__decorate([
|
|
118
122
|
(0, common_1.Inject)(),
|
|
119
|
-
|
|
123
|
+
tslib_1.__metadata("design:type", SwaggerService_1.SwaggerService)
|
|
120
124
|
], SwaggerModule.prototype, "swaggerService", void 0);
|
|
121
|
-
|
|
125
|
+
tslib_1.__decorate([
|
|
122
126
|
(0, common_1.Constant)("env"),
|
|
123
|
-
|
|
127
|
+
tslib_1.__metadata("design:type", String)
|
|
124
128
|
], SwaggerModule.prototype, "env", void 0);
|
|
125
|
-
SwaggerModule =
|
|
129
|
+
SwaggerModule = tslib_1.__decorate([
|
|
126
130
|
(0, common_1.Module)()
|
|
127
131
|
], SwaggerModule);
|
|
128
132
|
exports.SwaggerModule = SwaggerModule;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"SwaggerModule.js","sourceRoot":"","sources":["../../src/SwaggerModule.ts"],"names":[],"mappings":";;;;AAAA,
|
|
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} from \"@tsed/common\";\nimport {PlatformRouter, useContextHandler} from \"@tsed/platform-router\";\nimport Fs from \"fs\";\nimport {join} from \"path\";\nimport {Env} from \"@tsed/core\";\nimport {absolutePath} from \"swagger-ui-dist\";\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\";\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, useContextHandler(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 = new PlatformRouter(this.injector);\n\n if (!disableSpec) {\n router.get(normalizePath(\"/\", fileName), useContextHandler(this.middlewareSwaggerJson(conf)));\n }\n\n if (viewPath) {\n if (cssPath) {\n router.get(\"/main.css\", useContextHandler(cssMiddleware(cssPath)));\n }\n\n if (jsPath) {\n router.get(\"/main.js\", useContextHandler(jsMiddleware(jsPath)));\n }\n\n router.get(\"/\", useContextHandler(indexMiddleware(viewPath, {urls, ...conf})));\n router.statics(\"/\", {root: absolutePath()});\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/index.js
CHANGED
|
@@ -1,9 +1,19 @@
|
|
|
1
1
|
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* @file Automatically generated by barrelsby.
|
|
4
|
+
*/
|
|
2
5
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
6
|
const tslib_1 = require("tslib");
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
7
|
+
tslib_1.__exportStar(require("./SwaggerModule"), exports);
|
|
8
|
+
tslib_1.__exportStar(require("./decorators/docs"), exports);
|
|
9
|
+
tslib_1.__exportStar(require("./decorators/hidden"), exports);
|
|
10
|
+
tslib_1.__exportStar(require("./interfaces/SwaggerSettings"), exports);
|
|
11
|
+
tslib_1.__exportStar(require("./interfaces/interfaces"), exports);
|
|
12
|
+
tslib_1.__exportStar(require("./middlewares/cssMiddleware"), exports);
|
|
13
|
+
tslib_1.__exportStar(require("./middlewares/indexMiddleware"), exports);
|
|
14
|
+
tslib_1.__exportStar(require("./middlewares/jsMiddleware"), exports);
|
|
15
|
+
tslib_1.__exportStar(require("./middlewares/redirectMiddleware"), exports);
|
|
16
|
+
tslib_1.__exportStar(require("./services/SwaggerService"), exports);
|
|
17
|
+
tslib_1.__exportStar(require("./utils/includeRoute"), exports);
|
|
18
|
+
tslib_1.__exportStar(require("./utils/matchPath"), exports);
|
|
9
19
|
//# sourceMappingURL=index.js.map
|
package/lib/cjs/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;
|
|
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"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"SwaggerSettings.js","sourceRoot":"","sources":["../../../src/interfaces/SwaggerSettings.ts"],"names":[],"mappings":"","sourcesContent":["import {OpenSpec3, OpenSpecVersions, 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 SwaggerOS3Settings extends SwaggerSettingsBase {\n specVersion?: OS3Versions;\n /**\n * OpenSpec 3\n */\n spec?: Partial<OpenSpec3>;\n}\n\nexport type SwaggerSettings = SwaggerOS3Settings;\n"]}
|
|
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"]}
|
|
@@ -0,0 +1 @@
|
|
|
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"]}
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.cssMiddleware = void 0;
|
|
4
4
|
const tslib_1 = require("tslib");
|
|
5
|
-
const fs_1 =
|
|
5
|
+
const fs_1 = tslib_1.__importDefault(require("fs"));
|
|
6
6
|
const path_1 = require("path");
|
|
7
7
|
/**
|
|
8
8
|
* @ignore
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cssMiddleware.js","sourceRoot":"","sources":["../../../src/middlewares/cssMiddleware.ts"],"names":[],"mappings":";;;;AACA,
|
|
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"]}
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.jsMiddleware = void 0;
|
|
4
4
|
const tslib_1 = require("tslib");
|
|
5
|
-
const fs_1 =
|
|
5
|
+
const fs_1 = tslib_1.__importDefault(require("fs"));
|
|
6
6
|
const path_1 = require("path");
|
|
7
7
|
/**
|
|
8
8
|
* @ignore
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"jsMiddleware.js","sourceRoot":"","sources":["../../../src/middlewares/jsMiddleware.ts"],"names":[],"mappings":";;;;AACA,
|
|
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"]}
|
|
@@ -1,104 +1,44 @@
|
|
|
1
1
|
"use strict";
|
|
2
|
-
var _SwaggerService_specs;
|
|
3
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
4
3
|
exports.SwaggerService = void 0;
|
|
5
4
|
const tslib_1 = require("tslib");
|
|
6
5
|
const common_1 = require("@tsed/common");
|
|
7
|
-
const core_1 = require("@tsed/core");
|
|
8
6
|
const schema_1 = require("@tsed/schema");
|
|
9
|
-
const fs_1 = (0, tslib_1.__importDefault)(require("fs"));
|
|
10
7
|
const includeRoute_1 = require("../utils/includeRoute");
|
|
11
|
-
const mapOpenSpec_1 = require("../utils/mapOpenSpec");
|
|
12
8
|
let SwaggerService = class SwaggerService {
|
|
9
|
+
injectorService;
|
|
10
|
+
platform;
|
|
11
|
+
configuration;
|
|
12
|
+
#specs = new Map();
|
|
13
13
|
constructor(injectorService, platform, configuration) {
|
|
14
14
|
this.injectorService = injectorService;
|
|
15
15
|
this.platform = platform;
|
|
16
16
|
this.configuration = configuration;
|
|
17
|
-
_SwaggerService_specs.set(this, new Map());
|
|
18
17
|
}
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
const
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
operationIdPattern: conf.operationIdPattern,
|
|
34
|
-
append(spec) {
|
|
35
|
-
finalSpec = (0, schema_1.mergeSpec)(finalSpec, spec);
|
|
36
|
-
}
|
|
37
|
-
};
|
|
38
|
-
this.platform.getMountedControllers().forEach(({ route, provider }) => {
|
|
39
|
-
if ((0, includeRoute_1.includeRoute)(route, provider, conf)) {
|
|
40
|
-
const spec = this.buildRoutes(provider, {
|
|
41
|
-
...options,
|
|
42
|
-
rootPath: route.replace(provider.path, "")
|
|
43
|
-
});
|
|
44
|
-
options.append(spec);
|
|
45
|
-
}
|
|
18
|
+
async getOpenAPISpec(conf) {
|
|
19
|
+
if (!this.#specs.has(conf.path)) {
|
|
20
|
+
const { version = "1.0.0", acceptMimes } = this.configuration;
|
|
21
|
+
const specPath = conf.specPath ? this.configuration.resolve(conf.specPath) : conf.specPath;
|
|
22
|
+
const tokens = this.platform
|
|
23
|
+
.getMountedControllers()
|
|
24
|
+
.filter(({ route, provider }) => (0, includeRoute_1.includeRoute)(route, provider, conf))
|
|
25
|
+
.map(({ route, provider }) => ({ token: provider.token, rootPath: route }));
|
|
26
|
+
const spec = await (0, schema_1.generateSpec)({
|
|
27
|
+
tokens,
|
|
28
|
+
...conf,
|
|
29
|
+
specPath,
|
|
30
|
+
version,
|
|
31
|
+
acceptMimes
|
|
46
32
|
});
|
|
47
|
-
|
|
33
|
+
this.#specs.set(conf.path, spec);
|
|
48
34
|
}
|
|
49
|
-
return
|
|
50
|
-
}
|
|
51
|
-
/**
|
|
52
|
-
* Return the global api information.
|
|
53
|
-
*/
|
|
54
|
-
getDefaultSpec(conf) {
|
|
55
|
-
const { version = "1.0.0", acceptMimes } = this.configuration;
|
|
56
|
-
const { specPath, specVersion } = conf;
|
|
57
|
-
const fileSpec = specPath ? this.readSpecPath(specPath) : {};
|
|
58
|
-
return (0, mapOpenSpec_1.mapOpenSpec)((0, core_1.getValue)(conf, "spec", {}), {
|
|
59
|
-
fileSpec,
|
|
60
|
-
version,
|
|
61
|
-
specVersion,
|
|
62
|
-
acceptMimes
|
|
63
|
-
});
|
|
64
|
-
}
|
|
65
|
-
readSpecPath(path) {
|
|
66
|
-
path = this.configuration.resolve(path);
|
|
67
|
-
if (fs_1.default.existsSync(path)) {
|
|
68
|
-
const json = fs_1.default.readFileSync(path, { encoding: "utf8" });
|
|
69
|
-
/* istanbul ignore else */
|
|
70
|
-
if (json !== "") {
|
|
71
|
-
return JSON.parse(json);
|
|
72
|
-
}
|
|
73
|
-
}
|
|
74
|
-
return {};
|
|
75
|
-
}
|
|
76
|
-
/**
|
|
77
|
-
*
|
|
78
|
-
* @param ctrl
|
|
79
|
-
* @param options
|
|
80
|
-
*/
|
|
81
|
-
buildRoutes(ctrl, options) {
|
|
82
|
-
const rootPath = options.rootPath + ctrl.path;
|
|
83
|
-
ctrl.children
|
|
84
|
-
.map((ctrl) => this.injectorService.getProvider(ctrl))
|
|
85
|
-
.forEach((provider) => {
|
|
86
|
-
if (!provider.store.get("hidden")) {
|
|
87
|
-
const spec = this.buildRoutes(provider, {
|
|
88
|
-
...options,
|
|
89
|
-
rootPath
|
|
90
|
-
});
|
|
91
|
-
options.append(spec);
|
|
92
|
-
}
|
|
93
|
-
});
|
|
94
|
-
return (0, schema_1.getSpec)(ctrl.token, options);
|
|
35
|
+
return this.#specs.get(conf.path);
|
|
95
36
|
}
|
|
96
37
|
};
|
|
97
|
-
|
|
98
|
-
SwaggerService = (0, tslib_1.__decorate)([
|
|
38
|
+
SwaggerService = tslib_1.__decorate([
|
|
99
39
|
(0, common_1.Injectable)(),
|
|
100
|
-
|
|
101
|
-
|
|
40
|
+
tslib_1.__param(2, (0, common_1.Configuration)()),
|
|
41
|
+
tslib_1.__metadata("design:paramtypes", [common_1.InjectorService,
|
|
102
42
|
common_1.Platform, Object])
|
|
103
43
|
], SwaggerService);
|
|
104
44
|
exports.SwaggerService = SwaggerService;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"SwaggerService.js","sourceRoot":"","sources":["../../../src/services/SwaggerService.ts"],"names":[],"mappings":"
|
|
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;IAIf;IACA;IACiB;IAL3B,MAAM,GAAuC,IAAI,GAAG,EAAE,CAAC;IAEvD,YACU,eAAgC,EAChC,QAAkB,EACD,aAA4B;QAF7C,oBAAe,GAAf,eAAe,CAAiB;QAChC,aAAQ,GAAR,QAAQ,CAAU;QACD,kBAAa,GAAb,aAAa,CAAe;IACpD,CAAC;IASG,KAAK,CAAC,cAAc,CAAC,IAAqB;QAC/C,IAAI,CAAC,IAAI,CAAC,MAAM,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,EAAC,CAAC,CAAC,CAAC;YAE1E,MAAM,IAAI,GAAG,MAAM,IAAA,qBAAY,EAAC;gBAC9B,MAAM;gBACN,GAAG,IAAI;gBACP,QAAQ;gBACR,OAAO;gBACP,WAAW;aACZ,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;SAClC;QAED,OAAO,IAAI,CAAC,MAAM,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}));\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"]}
|
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.includeRoute = void 0;
|
|
4
|
-
const
|
|
4
|
+
const matchPath_1 = require("./matchPath");
|
|
5
5
|
function includeRoute(route, provider, conf) {
|
|
6
6
|
const hidden = provider.store.get("hidden");
|
|
7
7
|
const docs = provider.store.get("docs") || [];
|
|
8
8
|
const { doc, pathPatterns } = conf;
|
|
9
9
|
const inDoc = doc && docs.indexOf(doc) > -1;
|
|
10
|
-
const pathPatternMatch = pathPatterns && (0,
|
|
10
|
+
const pathPatternMatch = pathPatterns && (0, matchPath_1.matchPath)(route, pathPatterns);
|
|
11
11
|
if (hidden) {
|
|
12
12
|
return false;
|
|
13
13
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"includeRoute.js","sourceRoot":"","sources":["../../../src/utils/includeRoute.ts"],"names":[],"mappings":";;;
|
|
1
|
+
{"version":3,"file":"includeRoute.js","sourceRoot":"","sources":["../../../src/utils/includeRoute.ts"],"names":[],"mappings":";;;AAEA,2CAAsC;AAEtC,SAAgB,YAAY,CAAC,KAAa,EAAE,QAAkB,EAAE,IAAqB;IACnF,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 {Provider} from \"@tsed/di\";\nimport {SwaggerSettings} from \"../interfaces/SwaggerSettings\";\nimport {matchPath} from \"./matchPath\";\n\nexport function includeRoute(route: string, provider: Provider, 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"]}
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.matchPath = void 0;
|
|
4
4
|
const tslib_1 = require("tslib");
|
|
5
|
-
const micromatch_1 =
|
|
5
|
+
const micromatch_1 = tslib_1.__importDefault(require("micromatch"));
|
|
6
6
|
function matchPath(path, patterns) {
|
|
7
7
|
return patterns && patterns.length ? micromatch_1.default.isMatch(path, patterns) : true;
|
|
8
8
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"matchPath.js","sourceRoot":"","sources":["../../../src/utils/matchPath.ts"],"names":[],"mappings":";;;;AAAA,
|
|
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
CHANGED
|
@@ -1,21 +1,25 @@
|
|
|
1
1
|
import { __decorate, __metadata } from "tslib";
|
|
2
|
-
import { Configuration, Constant, Inject, InjectorService, Module, normalizePath, PlatformApplication
|
|
2
|
+
import { Configuration, Constant, Inject, InjectorService, Module, normalizePath, PlatformApplication } from "@tsed/common";
|
|
3
|
+
import { PlatformRouter, useContextHandler } from "@tsed/platform-router";
|
|
3
4
|
import Fs from "fs";
|
|
4
5
|
import { join } from "path";
|
|
5
|
-
import { cssMiddleware } from "./middlewares/cssMiddleware";
|
|
6
|
-
import { indexMiddleware } from "./middlewares/indexMiddleware";
|
|
7
|
-
import { jsMiddleware } from "./middlewares/jsMiddleware";
|
|
8
|
-
import { redirectMiddleware } from "./middlewares/redirectMiddleware";
|
|
9
|
-
import { SwaggerService } from "./services/SwaggerService";
|
|
10
6
|
import { Env } from "@tsed/core";
|
|
11
|
-
|
|
7
|
+
import { absolutePath } from "swagger-ui-dist";
|
|
8
|
+
import { cssMiddleware } from "./middlewares/cssMiddleware.js";
|
|
9
|
+
import { indexMiddleware } from "./middlewares/indexMiddleware.js";
|
|
10
|
+
import { jsMiddleware } from "./middlewares/jsMiddleware.js";
|
|
11
|
+
import { redirectMiddleware } from "./middlewares/redirectMiddleware.js";
|
|
12
|
+
import { SwaggerService } from "./services/SwaggerService.js";
|
|
12
13
|
/**
|
|
13
14
|
* @ignore
|
|
14
15
|
*/
|
|
15
16
|
let SwaggerModule = class SwaggerModule {
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
17
|
+
injector;
|
|
18
|
+
app;
|
|
19
|
+
configuration;
|
|
20
|
+
swaggerService;
|
|
21
|
+
env;
|
|
22
|
+
loaded = false;
|
|
19
23
|
get settings() {
|
|
20
24
|
return [].concat(this.configuration.get("swagger")).filter((o) => !!o);
|
|
21
25
|
}
|
|
@@ -29,7 +33,7 @@ let SwaggerModule = class SwaggerModule {
|
|
|
29
33
|
const urls = this.getUrls();
|
|
30
34
|
this.settings.forEach((conf) => {
|
|
31
35
|
const { path = "/" } = conf;
|
|
32
|
-
this.app.get(path,
|
|
36
|
+
this.app.get(path, useContextHandler(redirectMiddleware(path)));
|
|
33
37
|
this.app.use(path, this.createRouter(conf, urls));
|
|
34
38
|
});
|
|
35
39
|
this.loaded = true;
|
|
@@ -51,10 +55,10 @@ let SwaggerModule = class SwaggerModule {
|
|
|
51
55
|
this.generateSpecFiles();
|
|
52
56
|
}
|
|
53
57
|
generateSpecFiles() {
|
|
54
|
-
return Promise.all(this.settings.map((conf) => {
|
|
58
|
+
return Promise.all(this.settings.map(async (conf) => {
|
|
55
59
|
const { outFile } = conf;
|
|
56
60
|
if (this.env === Env.PROD || outFile) {
|
|
57
|
-
const spec = this.swaggerService.getOpenAPISpec(conf);
|
|
61
|
+
const spec = await this.swaggerService.getOpenAPISpec(conf);
|
|
58
62
|
if (outFile) {
|
|
59
63
|
return Fs.writeFile(outFile, JSON.stringify(spec, null, 2), { encoding: "utf8" }, () => { });
|
|
60
64
|
}
|
|
@@ -77,25 +81,25 @@ let SwaggerModule = class SwaggerModule {
|
|
|
77
81
|
*/
|
|
78
82
|
createRouter(conf, urls) {
|
|
79
83
|
const { disableSpec = false, fileName = "swagger.json", cssPath, jsPath, viewPath = join(__dirname, "../views/index.ejs") } = conf;
|
|
80
|
-
const router = PlatformRouter
|
|
84
|
+
const router = new PlatformRouter(this.injector);
|
|
81
85
|
if (!disableSpec) {
|
|
82
|
-
router.get(normalizePath("/", fileName),
|
|
86
|
+
router.get(normalizePath("/", fileName), useContextHandler(this.middlewareSwaggerJson(conf)));
|
|
83
87
|
}
|
|
84
88
|
if (viewPath) {
|
|
85
89
|
if (cssPath) {
|
|
86
|
-
router.get("/main.css",
|
|
90
|
+
router.get("/main.css", useContextHandler(cssMiddleware(cssPath)));
|
|
87
91
|
}
|
|
88
92
|
if (jsPath) {
|
|
89
|
-
router.get("/main.js",
|
|
93
|
+
router.get("/main.js", useContextHandler(jsMiddleware(jsPath)));
|
|
90
94
|
}
|
|
91
|
-
router.get("/",
|
|
92
|
-
router.statics("/", { root:
|
|
95
|
+
router.get("/", useContextHandler(indexMiddleware(viewPath, { urls, ...conf })));
|
|
96
|
+
router.statics("/", { root: absolutePath() });
|
|
93
97
|
}
|
|
94
98
|
return router;
|
|
95
99
|
}
|
|
96
100
|
middlewareSwaggerJson(conf) {
|
|
97
|
-
return (ctx) => {
|
|
98
|
-
ctx.response.status(200).body(this.swaggerService.getOpenAPISpec(conf));
|
|
101
|
+
return async (ctx) => {
|
|
102
|
+
ctx.response.status(200).body(await this.swaggerService.getOpenAPISpec(conf));
|
|
99
103
|
};
|
|
100
104
|
}
|
|
101
105
|
};
|