@midwayjs/swagger 1.2.0 → 3.0.0-beta.12

package/dist/swaggerExplorer.js

@@ -0,0 +1,601 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SwaggerExplorer = void 0;
+const decorator_1 = require("@midwayjs/decorator");
+const constants_1 = require("./constants");
+const documentBuilder_1 = require("./documentBuilder");
+let SwaggerExplorer = class SwaggerExplorer {
+    constructor() {
+        this.documentBuilder = new documentBuilder_1.DocumentBuilder();
+    }
+    async init() {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4;
+        this.documentBuilder.setTitle(this.swaggerConfig.title);
+        this.documentBuilder.setVersion(this.swaggerConfig.version);
+        this.documentBuilder.setDescription(this.swaggerConfig.description);
+        if (((_a = this.swaggerConfig) === null || _a === void 0 ? void 0 : _a.contact) &&
+            typeof ((_b = this.swaggerConfig) === null || _b === void 0 ? void 0 : _b.contact) === 'object') {
+            this.documentBuilder.setContact((_d = (_c = this.swaggerConfig) === null || _c === void 0 ? void 0 : _c.contact) === null || _d === void 0 ? void 0 : _d.name, (_f = (_e = this.swaggerConfig) === null || _e === void 0 ? void 0 : _e.contact) === null || _f === void 0 ? void 0 : _f.url, (_h = (_g = this.swaggerConfig) === null || _g === void 0 ? void 0 : _g.contact) === null || _h === void 0 ? void 0 : _h.email);
+        }
+        if (((_j = this.swaggerConfig) === null || _j === void 0 ? void 0 : _j.license) &&
+            typeof ((_k = this.swaggerConfig) === null || _k === void 0 ? void 0 : _k.license) === 'object') {
+            this.documentBuilder.setLicense((_m = (_l = this.swaggerConfig) === null || _l === void 0 ? void 0 : _l.license) === null || _m === void 0 ? void 0 : _m.name, (_p = (_o = this.swaggerConfig) === null || _o === void 0 ? void 0 : _o.license) === null || _p === void 0 ? void 0 : _p.url);
+        }
+        if (this.swaggerConfig.basePath) {
+            this.documentBuilder.setBasePath(this.swaggerConfig.basePath);
+        }
+        if (this.swaggerConfig.termsOfService) {
+            this.documentBuilder.setTermsOfService(this.swaggerConfig.termsOfService);
+        }
+        if (((_q = this.swaggerConfig) === null || _q === void 0 ? void 0 : _q.externalDocs) &&
+            typeof ((_r = this.swaggerConfig) === null || _r === void 0 ? void 0 : _r.externalDocs) === 'object') {
+            this.documentBuilder.setExternalDoc((_t = (_s = this.swaggerConfig) === null || _s === void 0 ? void 0 : _s.externalDocs) === null || _t === void 0 ? void 0 : _t.description, (_v = (_u = this.swaggerConfig) === null || _u === void 0 ? void 0 : _u.externalDocs) === null || _v === void 0 ? void 0 : _v.url);
+        }
+        if (((_w = this.swaggerConfig) === null || _w === void 0 ? void 0 : _w.servers) &&
+            Array.isArray((_x = this.swaggerConfig) === null || _x === void 0 ? void 0 : _x.servers)) {
+            for (const serv of (_y = this.swaggerConfig) === null || _y === void 0 ? void 0 : _y.servers) {
+                this.documentBuilder.addServer(serv === null || serv === void 0 ? void 0 : serv.url, serv === null || serv === void 0 ? void 0 : serv.description);
+            }
+        }
+        if (((_z = this.swaggerConfig) === null || _z === void 0 ? void 0 : _z.tags) && Array.isArray((_0 = this.swaggerConfig) === null || _0 === void 0 ? void 0 : _0.tags)) {
+            for (const t of (_1 = this.swaggerConfig) === null || _1 === void 0 ? void 0 : _1.tags) {
+                this.documentBuilder.addTag(t.name, t.description, t.externalDocs);
+            }
+        }
+        // 设置 auth 类型
+        if (Array.isArray((_2 = this.swaggerConfig) === null || _2 === void 0 ? void 0 : _2.auth)) {
+            for (const a of (_3 = this.swaggerConfig) === null || _3 === void 0 ? void 0 : _3.auth) {
+                this.setAuth(a);
+            }
+        }
+        else {
+            this.setAuth((_4 = this.swaggerConfig) === null || _4 === void 0 ? void 0 : _4.auth);
+        }
+    }
+    scanApp() {
+        const routes = (0, decorator_1.listModule)(decorator_1.CONTROLLER_KEY);
+        for (const route of routes) {
+            this.generatePath(route);
+        }
+    }
+    getData() {
+        return this.documentBuilder.build();
+    }
+    generatePath(target) {
+        const metaForMethods = (0, decorator_1.getClassMetadata)(decorator_1.INJECT_CUSTOM_METHOD, target) || [];
+        const exs = metaForMethods.filter(item => item.key === constants_1.DECORATORS.API_EXCLUDE_CONTROLLER);
+        if (exs[0]) {
+            return;
+        }
+        const metaForParams = (0, decorator_1.getClassMetadata)(decorator_1.INJECT_CUSTOM_PARAM, target) || [];
+        const controllerOption = (0, decorator_1.getClassMetadata)(decorator_1.CONTROLLER_KEY, target);
+        const prefix = controllerOption.prefix;
+        const tags = metaForMethods.filter(item => item.key === constants_1.DECORATORS.API_TAGS);
+        let strTags = [];
+        if (tags.length > 0) {
+            for (const t of tags) {
+                // 这里 metadata => string[]
+                strTags = strTags.concat(t.metadata);
+                this.documentBuilder.addTag(t.metadata);
+            }
+        }
+        else {
+            const tag = { name: '', description: '' };
+            if (prefix !== '/') {
+                tag.name =
+                    (controllerOption === null || controllerOption === void 0 ? void 0 : controllerOption.routerOptions.tagName) ||
+                        (/^\//.test(prefix) ? prefix.split('/')[1] : prefix);
+                tag.description =
+                    (controllerOption === null || controllerOption === void 0 ? void 0 : controllerOption.routerOptions.description) || tag.name;
+            }
+            else {
+                tag.name = (controllerOption === null || controllerOption === void 0 ? void 0 : controllerOption.routerOptions.tagName) || 'default';
+                tag.description =
+                    (controllerOption === null || controllerOption === void 0 ? void 0 : controllerOption.routerOptions.description) || tag.name;
+            }
+            if (tag.name) {
+                this.documentBuilder.addTag(tag.name, tag.description);
+            }
+        }
+        // const globalMiddleware = controllerOption.routerOptions.middleware;
+        // get router info
+        const webRouterInfo = (0, decorator_1.getClassMetadata)(decorator_1.WEB_ROUTER_KEY, target);
+        let header = null;
+        const headers = metaForMethods.filter(item => item.key === constants_1.DECORATORS.API_HEADERS);
+        if (headers.length > 0) {
+            header = headers[0].metadata;
+        }
+        const security = metaForMethods.filter(item => item.key === constants_1.DECORATORS.API_SECURITY);
+        const paths = {};
+        if (webRouterInfo && typeof webRouterInfo[Symbol.iterator] === 'function') {
+            for (const webRouter of webRouterInfo) {
+                let url = (prefix + webRouter.path).replace('//', '/');
+                url = replaceUrl(url, parseParamsInPath(url));
+                // 判断是否忽略当前路由
+                const endpoints = metaForMethods.filter(item => item.key === constants_1.DECORATORS.API_EXCLUDE_ENDPOINT &&
+                    item.propertyName === webRouter.method);
+                if (endpoints[0]) {
+                    continue;
+                }
+                this.generateRouteMethod(url, webRouter, paths, metaForMethods, metaForParams, header, target);
+                // 这里赋值 tags
+                if (paths[url][webRouter.requestMethod].tags.length === 0) {
+                    paths[url][webRouter.requestMethod].tags = strTags;
+                }
+                // extension => prefix 为 x-
+                const exts = metaForMethods.filter(item => item.key === constants_1.DECORATORS.API_EXTENSION &&
+                    item.propertyName === webRouter.method);
+                for (const e of exts) {
+                    if (e.metadata) {
+                        Object.assign(paths[url][webRouter.requestMethod], e.metadata);
+                    }
+                }
+                if (security.length > 0) {
+                    if (!paths[url][webRouter.requestMethod].security) {
+                        paths[url][webRouter.requestMethod].security = [];
+                    }
+                    for (const s of security) {
+                        if (!s.metadata) {
+                            continue;
+                        }
+                        paths[url][webRouter.requestMethod].security.push(s.metadata);
+                    }
+                }
+            }
+        }
+        this.documentBuilder.addPaths(paths);
+    }
+    /**
+     * 构造 router 提取方法
+     */
+    generateRouteMethod(url, webRouter, paths, metaForMethods, metaForParams, header, target) {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        const operMeta = metaForMethods.filter(item => item.key === constants_1.DECORATORS.API_OPERATION &&
+            item.propertyName === webRouter.method)[0];
+        let opts = paths[url];
+        if (!opts) {
+            opts = {};
+        }
+        const parameters = [];
+        opts[webRouter.requestMethod] = {
+            summary: (_a = operMeta === null || operMeta === void 0 ? void 0 : operMeta.metadata) === null || _a === void 0 ? void 0 : _a.summary,
+            description: (_b = operMeta === null || operMeta === void 0 ? void 0 : operMeta.metadata) === null || _b === void 0 ? void 0 : _b.description,
+            operationId: ((_c = operMeta === null || operMeta === void 0 ? void 0 : operMeta.metadata) === null || _c === void 0 ? void 0 : _c.operationId) || webRouter.method,
+            tags: ((_d = operMeta === null || operMeta === void 0 ? void 0 : operMeta.metadata) === null || _d === void 0 ? void 0 : _d.tags) || [],
+        };
+        /**
+         * [{"key":"web:router_param","parameterIndex":1,"propertyName":"create","metadata":{"type":2}},
+         * {"key":"web:router_param","parameterIndex":0,"propertyName":"create","metadata":{"type":1,"propertyData":"createCatDto"}}]
+         */
+        const routerArgs = metaForParams[webRouter.method] || [];
+        // WEB_ROUTER_PARAM_KEY
+        let args = routerArgs.filter(item => item.key === decorator_1.WEB_ROUTER_PARAM_KEY);
+        args = args.filter(item => item.key === decorator_1.WEB_ROUTER_PARAM_KEY);
+        const types = (0, decorator_1.getMethodParamTypes)(target, webRouter.method);
+        const params = metaForMethods.filter(item => item.key === constants_1.DECORATORS.API_PARAMETERS &&
+            item.propertyName === webRouter.method);
+        for (const arg of args) {
+            const currentType = types[arg.parameterIndex];
+            const p = {
+                name: (_f = (_e = arg === null || arg === void 0 ? void 0 : arg.metadata) === null || _e === void 0 ? void 0 : _e.propertyData) !== null && _f !== void 0 ? _f : '',
+                in: convertTypeToString((_g = arg.metadata) === null || _g === void 0 ? void 0 : _g.type),
+                required: false,
+            };
+            if (p.in === 'path') {
+                p.required = true;
+                if (url.indexOf('{' + p.name + '}') === -1) {
+                    continue;
+                }
+            }
+            if ((0, decorator_1.isClass)(currentType)) {
+                this.parseClzz(currentType);
+                p.schema = {
+                    $ref: '#/components/schemas/' + currentType.name,
+                };
+            }
+            else {
+                p.schema = {
+                    type: convertSchemaType((_h = currentType === null || currentType === void 0 ? void 0 : currentType.name) !== null && _h !== void 0 ? _h : currentType),
+                };
+            }
+            this.parseFromParamsToP(params[params.length - 1 - arg.parameterIndex], p);
+            if (p.in === 'body') {
+                if (!p.content) {
+                    p.content = {};
+                    p.content[p.contentType || 'application/json'] = {
+                        schema: p.schema,
+                    };
+                }
+                const requestBody = {
+                    required: true,
+                    description: p.description || p.name,
+                    content: p.content,
+                };
+                opts[webRouter.requestMethod].requestBody = requestBody;
+                delete p.contentType;
+                delete p.content;
+                // in body 不需要处理
+                continue;
+            }
+            parameters.push(p);
+        }
+        // class header 需要使用 ApiHeader 装饰器
+        if (header) {
+            parameters.unshift(header);
+        }
+        opts[webRouter.requestMethod].parameters = parameters;
+        const responses = metaForMethods.filter(item => item.key === constants_1.DECORATORS.API_RESPONSE &&
+            item.propertyName === webRouter.method);
+        const returnResponses = {};
+        for (const r of responses) {
+            const resp = r.metadata;
+            const keys = Object.keys(resp);
+            for (const k of keys) {
+                // 这里是引用，赋值可以直接更改
+                const tt = resp[k];
+                if (tt.type) {
+                    if ((0, decorator_1.isClass)(tt.type)) {
+                        this.parseClzz(tt.type);
+                        if (tt.isArray) {
+                            tt.content = {
+                                'application/json': {
+                                    schema: {
+                                        type: 'array',
+                                        items: {
+                                            $ref: '#/components/schemas/' + tt.type.name,
+                                        },
+                                    },
+                                },
+                            };
+                        }
+                        else {
+                            tt.content = {
+                                'application/json': {
+                                    schema: {
+                                        $ref: '#/components/schemas/' + tt.type.name,
+                                    },
+                                },
+                            };
+                        }
+                    }
+                    else {
+                        tt.content = {
+                            'text/plan': {
+                                schema: {
+                                    type: convertSchemaType(tt.type),
+                                },
+                            },
+                        };
+                    }
+                }
+                delete tt.status;
+                delete tt.type;
+                delete tt.isArray;
+                delete tt.format;
+            }
+            Object.assign(returnResponses, resp);
+        }
+        if (Object.keys(returnResponses).length > 0) {
+            opts[webRouter.requestMethod].responses = returnResponses;
+        }
+        else {
+            opts[webRouter.requestMethod].responses = {
+                200: {
+                    description: 'OK',
+                },
+            };
+        }
+        paths[url] = opts;
+    }
+    /**
+     * 提取参数
+     * @param params
+     * @param p
+     */
+    parseFromParamsToP(paramMeta, p) {
+        var _a, _b, _c, _d;
+        if (paramMeta) {
+            const param = paramMeta.metadata;
+            if (param) {
+                p.description = param.description;
+                if (param.in === 'query') {
+                    p.allowEmptyValue = param.allowEmptyValue || false;
+                }
+                if (param.example) {
+                    p.example = param.example;
+                }
+                if (param.examples) {
+                    p.examples = param.examples;
+                }
+                if (param.deprecated) {
+                    p.deprecated = param.deprecated;
+                }
+                if (param.contentType) {
+                    p.contentType = param.contentType;
+                }
+                p.in = (_a = param === null || param === void 0 ? void 0 : param.in) !== null && _a !== void 0 ? _a : p.in;
+                p.required = (_b = param === null || param === void 0 ? void 0 : param.required) !== null && _b !== void 0 ? _b : p.required;
+                if (p.in === 'query') {
+                    p.style = 'form';
+                }
+                else if (p.in === 'path' || p.in === 'header') {
+                    p.style = 'simple';
+                }
+                else if (p.in === 'cookie') {
+                    p.style = 'form';
+                }
+                p.explode = p.style === 'form';
+                // response content
+                if (param === null || param === void 0 ? void 0 : param.content) {
+                    p.content = param === null || param === void 0 ? void 0 : param.content;
+                }
+                if (param.schema) {
+                    p.schema = param.schema;
+                }
+                else {
+                    if (param.type) {
+                        if ((0, decorator_1.isClass)(param.type)) {
+                            this.parseClzz(param.type);
+                            p.schema = {
+                                $ref: '#/components/schemas/' + param.type.name,
+                            };
+                        }
+                        if (param.isArray) {
+                            p.schema = {
+                                type: 'array',
+                                items: {
+                                    type: (_d = (_c = p === null || p === void 0 ? void 0 : p.schema) === null || _c === void 0 ? void 0 : _c.$ref) !== null && _d !== void 0 ? _d : convertSchemaType(param.type),
+                                    format: param.format,
+                                },
+                            };
+                        }
+                        else {
+                            if (!p.schema) {
+                                p.schema = {
+                                    type: param.type ? convertSchemaType(param.type) : p.type,
+                                    format: param.format || p.format,
+                                };
+                            }
+                        }
+                    }
+                    else if (param.format) {
+                        p.schema.format = param.format;
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * 解析类型的 ApiProperty
+     * @param clzz
+     */
+    parseClzz(clzz) {
+        const props = (0, decorator_1.getClassMetadata)(decorator_1.INJECT_CUSTOM_PROPERTY, clzz);
+        const tt = {
+            type: 'object',
+            properties: {},
+        };
+        if (props) {
+            Object.keys(props).forEach(key => {
+                var _a, _b;
+                const metadata = props[key].metadata;
+                if (metadata === null || metadata === void 0 ? void 0 : metadata.example) {
+                    if (!tt.example) {
+                        tt.example = {};
+                    }
+                    tt.example[key] = metadata === null || metadata === void 0 ? void 0 : metadata.example;
+                    delete metadata.example;
+                }
+                if ((metadata === null || metadata === void 0 ? void 0 : metadata.required) !== false) {
+                    if (!tt.required) {
+                        tt.required = [];
+                    }
+                    tt.required.push(key);
+                    delete metadata.required;
+                }
+                if (metadata === null || metadata === void 0 ? void 0 : metadata.enum) {
+                    tt.properties[key] = {
+                        type: metadata === null || metadata === void 0 ? void 0 : metadata.type,
+                        enum: metadata === null || metadata === void 0 ? void 0 : metadata.enum,
+                        default: metadata === null || metadata === void 0 ? void 0 : metadata.default,
+                    };
+                    if (metadata === null || metadata === void 0 ? void 0 : metadata.description) {
+                        tt.properties[key].description = metadata === null || metadata === void 0 ? void 0 : metadata.description;
+                    }
+                    return;
+                }
+                if ((_a = metadata === null || metadata === void 0 ? void 0 : metadata.items) === null || _a === void 0 ? void 0 : _a.enum) {
+                    tt.properties[key] = {
+                        type: metadata === null || metadata === void 0 ? void 0 : metadata.type,
+                        items: metadata === null || metadata === void 0 ? void 0 : metadata.items,
+                        default: metadata === null || metadata === void 0 ? void 0 : metadata.default,
+                    };
+                    if (metadata === null || metadata === void 0 ? void 0 : metadata.description) {
+                        tt.properties[key].description = metadata === null || metadata === void 0 ? void 0 : metadata.description;
+                    }
+                    return;
+                }
+                let isArray = false;
+                let currentType = metadata === null || metadata === void 0 ? void 0 : metadata.type;
+                metadata === null || metadata === void 0 ? true : delete metadata.type;
+                if (currentType === 'array') {
+                    isArray = true;
+                    currentType = (_b = metadata === null || metadata === void 0 ? void 0 : metadata.items) === null || _b === void 0 ? void 0 : _b.type;
+                    delete metadata.items;
+                }
+                if ((0, decorator_1.isClass)(currentType)) {
+                    this.parseClzz(currentType);
+                    if (isArray) {
+                        tt.properties[key] = {
+                            type: 'array',
+                            items: {
+                                $ref: '#components/schemas/' + (currentType === null || currentType === void 0 ? void 0 : currentType.name),
+                            },
+                        };
+                    }
+                    else {
+                        tt.properties[key] = {
+                            $ref: '#components/schemas/' + (currentType === null || currentType === void 0 ? void 0 : currentType.name),
+                        };
+                    }
+                }
+                else {
+                    if (isArray) {
+                        tt.properties[key] = {
+                            type: 'array',
+                            items: {
+                                type: convertSchemaType((currentType === null || currentType === void 0 ? void 0 : currentType.name) || currentType),
+                            },
+                        };
+                    }
+                    else {
+                        tt.properties[key] = {
+                            type: (0, decorator_1.getPropertyType)(clzz.prototype, key).name,
+                            format: metadata === null || metadata === void 0 ? void 0 : metadata.format,
+                        };
+                        delete metadata.format;
+                    }
+                }
+                Object.assign(tt.properties[key], metadata);
+            });
+        }
+        this.documentBuilder.addSchema({
+            [clzz.name]: tt,
+        });
+    }
+    /**
+     * 授权验证
+     * @param opts
+     * @returns
+     */
+    setAuth(opts) {
+        if (!opts) {
+            return;
+        }
+        const authType = opts.authType;
+        delete opts.authType;
+        // TODO 加 security
+        switch (authType) {
+            case 'basic':
+                {
+                    const name = opts.name;
+                    delete opts.name;
+                    this.documentBuilder.addBasicAuth(opts, name);
+                }
+                break;
+            case 'bearer':
+                {
+                    const name = opts.name;
+                    delete opts.name;
+                    this.documentBuilder.addBearerAuth(opts, name);
+                }
+                break;
+            case 'cookie':
+                {
+                    const cname = opts.cookieName;
+                    const secName = opts.securityName;
+                    delete opts.cookieName;
+                    delete opts.securityName;
+                    this.documentBuilder.addCookieAuth(cname, opts, secName);
+                }
+                break;
+            case 'oauth2':
+                {
+                    const name = opts.name;
+                    delete opts.name;
+                    this.documentBuilder.addOAuth2(opts, name);
+                }
+                break;
+            case 'apikey':
+                {
+                    const name = opts.name;
+                    delete opts.name;
+                    this.documentBuilder.addApiKey(opts, name);
+                }
+                break;
+            case 'custom':
+                {
+                    this.documentBuilder.addSecurity(opts === null || opts === void 0 ? void 0 : opts.name, opts);
+                }
+                break;
+        }
+    }
+};
+__decorate([
+    (0, decorator_1.Config)('swagger'),
+    __metadata("design:type", Object)
+], SwaggerExplorer.prototype, "swaggerConfig", void 0);
+__decorate([
+    (0, decorator_1.Init)(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], SwaggerExplorer.prototype, "init", null);
+SwaggerExplorer = __decorate([
+    (0, decorator_1.Provide)(),
+    (0, decorator_1.Scope)(decorator_1.ScopeEnum.Singleton)
+], SwaggerExplorer);
+exports.SwaggerExplorer = SwaggerExplorer;
+/**
+ * 解释路由上的参数
+ * @param url
+ */
+function parseParamsInPath(url) {
+    const names = [];
+    url.split('/').forEach(item => {
+        if (item.startsWith(':')) {
+            const paramName = item.substr(1);
+            names.push(paramName);
+        }
+    });
+    return names;
+}
+/**
+ * 替换成 openapi 的url
+ * @param url
+ * @param names
+ */
+function replaceUrl(url, names) {
+    names.forEach(n => {
+        url = url.replace(`:${n}`, `{${n}}`);
+    });
+    return url;
+}
+function convertTypeToString(type) {
+    switch (type) {
+        case decorator_1.RouteParamTypes.HEADERS:
+            return 'header';
+        case decorator_1.RouteParamTypes.QUERY:
+            return 'query';
+        case decorator_1.RouteParamTypes.PARAM:
+            return 'path';
+        case decorator_1.RouteParamTypes.BODY:
+            return 'body';
+        default:
+            return 'header';
+    }
+}
+function convertSchemaType(value) {
+    switch (value) {
+        case 'Object':
+            return 'object';
+        case 'Boolean':
+            return 'boolean';
+        case 'Number':
+            return 'number';
+        case 'String':
+            return 'string';
+        default:
+            return 'object';
+    }
+}
+//# sourceMappingURL=swaggerExplorer.js.map

package/dist/swaggerMiddleware.d.ts

@@ -0,0 +1,10 @@
+import type { IMiddleware, IMidwayApplication, IMidwayContext, NextFunction } from '@midwayjs/core';
+export declare class SwaggerMiddleware implements IMiddleware<IMidwayContext, NextFunction, unknown> {
+    private swaggerConfig;
+    private swaggerUiAssetPath;
+    private swaggerExplorer;
+    init(): Promise<void>;
+    resolve(app: IMidwayApplication): (req: any, res: any, next: NextFunction) => Promise<any>;
+    static getName(): string;
+}
+//# sourceMappingURL=swaggerMiddleware.d.ts.map