openapi-ts-request 0.1.0

package/dist/generator/serviceGenarator.js

@@ -0,0 +1,640 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const fs_1 = require("fs");
+const glob_1 = require("glob");
+const lodash_1 = require("lodash");
+const nunjucks_1 = tslib_1.__importDefault(require("nunjucks"));
+const path_1 = require("path");
+const rimraf_1 = require("rimraf");
+const log_1 = tslib_1.__importDefault(require("../log"));
+const type_1 = require("../type");
+const config_1 = require("./config");
+const file_1 = require("./file");
+const util_1 = require("./util");
+class ServiceGenerator {
+    constructor(config, openAPIData) {
+        var _a, _b;
+        this.apiData = {};
+        this.classNameList = [];
+        this.finalPath = '';
+        this.config = Object.assign({ templatesFolder: (0, path_1.join)(__dirname, '../../', 'templates') }, config);
+        const hookCustomFileNames = ((_a = this.config.hook) === null || _a === void 0 ? void 0 : _a.customFileNames) || util_1.getDefaultFileTag;
+        if ((_b = this.config.hook) === null || _b === void 0 ? void 0 : _b.afterOpenApiDataInited) {
+            this.openAPIData =
+                this.config.hook.afterOpenApiDataInited(openAPIData) || openAPIData;
+        }
+        else {
+            this.openAPIData = openAPIData;
+        }
+        // 用 tag 分组 paths, { [tag]: [pathMap, pathMap] }
+        (0, lodash_1.keys)(this.openAPIData.paths).forEach((pathKey) => {
+            const pathItem = this.openAPIData.paths[pathKey];
+            (0, lodash_1.forEach)(config_1.methods, (method) => {
+                const operationObject = pathItem[method];
+                if (!operationObject) {
+                    return;
+                }
+                let tags = hookCustomFileNames(operationObject, pathKey, method);
+                if (!tags) {
+                    tags = (0, util_1.getDefaultFileTag)(operationObject, pathKey);
+                }
+                tags.forEach((tag) => {
+                    var _a;
+                    // 筛选出 tags 关联的paths
+                    if (!(0, lodash_1.isEmpty)((_a = this.config) === null || _a === void 0 ? void 0 : _a.allowedTags) &&
+                        !(0, lodash_1.includes)(this.config.allowedTags, tag.toLowerCase())) {
+                        return;
+                    }
+                    const tagKey = this.config.isCamelCase
+                        ? (0, lodash_1.camelCase)((0, util_1.resolveTypeName)(tag))
+                        : (0, util_1.resolveTypeName)(tag);
+                    if (!this.apiData[tagKey]) {
+                        this.apiData[tagKey] = [];
+                    }
+                    this.apiData[tagKey].push(Object.assign({ path: pathKey, method }, operationObject));
+                });
+            });
+        });
+    }
+    genFile() {
+        try {
+            (0, glob_1.globSync)(`${this.config.serversPath}/**/*`)
+                .filter((item) => !item.includes('_deperated'))
+                .forEach((item) => {
+                (0, rimraf_1.sync)(item);
+            });
+        }
+        catch (error) {
+            (0, log_1.default)(`🚥 api 生成失败: ${error}`);
+        }
+        // 处理重复的 typeName
+        const interfaceTPConfigs = this.getInterfaceTPConfigs();
+        (0, util_1.handleDuplicateTypeNames)(interfaceTPConfigs);
+        // 生成 ts 类型声明
+        this.genFileFromTemplate(`${config_1.interfaceFileName}.ts`, config_1.TypescriptFileType.interface, {
+            nullable: this.config.nullable,
+            list: interfaceTPConfigs,
+        });
+        // 生成枚举翻译
+        this.genFileFromTemplate(`${config_1.displayEnumLabelFileName}.ts`, config_1.TypescriptFileType.displayEnumLabel, {
+            list: (0, lodash_1.filter)(interfaceTPConfigs, (item) => item.isEnum),
+            namespace: this.config.namespace,
+            interfaceFileName: config_1.interfaceFileName,
+        });
+        const prettierError = [];
+        // 生成 service controller 文件
+        this.getServiceTPConfigs().forEach((tp) => {
+            const hasError = this.genFileFromTemplate((0, util_1.getFinalFileName)(`${tp.className}.ts`), config_1.TypescriptFileType.serviceController, Object.assign({ namespace: this.config.namespace, requestOptionsType: this.config.requestOptionsType, requestImportStatement: this.config.requestImportStatement, interfaceFileName: config_1.interfaceFileName }, tp));
+            prettierError.push(hasError);
+        });
+        if (prettierError.includes(true)) {
+            (0, log_1.default)('🚥 格式化失败，请检查 service controller 文件内可能存在的语法错误');
+        }
+        // 生成 service index 文件
+        this.genFileFromTemplate(`${config_1.serviceEntryFileName}.ts`, config_1.TypescriptFileType.serviceIndex, {
+            list: this.classNameList,
+            namespace: this.config.namespace,
+            interfaceFileName: config_1.interfaceFileName,
+        });
+        // 打印日志
+        (0, log_1.default)('✅ 成功生成 api 文件');
+    }
+    getInterfaceTPConfigs() {
+        var _a;
+        const schemas = (_a = this.openAPIData.components) === null || _a === void 0 ? void 0 : _a.schemas;
+        const lastTypes = [];
+        // 强行替换掉请求参数params的类型，生成方法对应的 xxxxParams 类型
+        (0, lodash_1.keys)(this.openAPIData.paths).forEach((pathKey) => {
+            const pathItem = this.openAPIData.paths[pathKey];
+            (0, lodash_1.forEach)(config_1.methods, (method) => {
+                var _a, _b, _c, _d;
+                const operationObject = pathItem[method];
+                if (!operationObject) {
+                    return;
+                }
+                // 筛选出 pathItem 包含的 $ref 对应的schema
+                if (!(0, lodash_1.isEmpty)((_a = this.config) === null || _a === void 0 ? void 0 : _a.allowedTags) &&
+                    !(0, lodash_1.isEmpty)(operationObject.tags)) {
+                    if (!(0, lodash_1.isEmpty)((0, lodash_1.intersection)(this.config.allowedTags, (0, lodash_1.map)(operationObject.tags, (tag) => tag.toLowerCase())))) {
+                        (0, util_1.markAllowSchema)(JSON.stringify(pathItem), schemas);
+                    }
+                    else {
+                        return;
+                    }
+                }
+                operationObject.parameters = (_b = operationObject.parameters) === null || _b === void 0 ? void 0 : _b.filter((item) => (item === null || item === void 0 ? void 0 : item.in) !== `${config_1.parametersInsEnum.header}`);
+                const props = [];
+                (_c = operationObject.parameters) === null || _c === void 0 ? void 0 : _c.forEach((parameter) => {
+                    var _a;
+                    props.push({
+                        name: parameter.name,
+                        desc: (_a = parameter.description) !== null && _a !== void 0 ? _a : '',
+                        required: parameter.required || false,
+                        type: this.getType(parameter.schema),
+                    });
+                });
+                // parameters may be in path
+                (_d = pathItem.parameters) === null || _d === void 0 ? void 0 : _d.forEach((parameter) => {
+                    var _a;
+                    props.push({
+                        name: parameter.name,
+                        desc: (_a = parameter.description) !== null && _a !== void 0 ? _a : '',
+                        required: parameter.required,
+                        type: this.getType(parameter.schema),
+                    });
+                });
+                if (props.length > 0) {
+                    lastTypes.push({
+                        typeName: this.getTypeName(Object.assign(Object.assign({}, operationObject), { method, path: pathKey })),
+                        type: 'Record<string, any>',
+                        props: [props],
+                        isEnum: false,
+                    });
+                }
+            });
+        });
+        (0, lodash_1.keys)(schemas).forEach((schemaKey) => {
+            const schema = schemas[schemaKey];
+            const result = this.resolveObject(schema);
+            const getDefinesType = () => {
+                if (result === null || result === void 0 ? void 0 : result.type) {
+                    return schema.type === 'object'
+                        ? type_1.SchemaObjectType.object
+                        : config_1.numberEnum.includes(result.type)
+                            ? type_1.SchemaObjectType.number
+                            : result.type;
+                }
+                return 'Record<string, any>';
+            };
+            // 解析 props 属性中的枚举
+            if ((0, lodash_1.isArray)(result.props) && result.props.length > 0) {
+                (0, lodash_1.forEach)(result.props[0], (item) => {
+                    if (item.enum) {
+                        const enumObj = this.resolveEnumObject(item);
+                        lastTypes.push({
+                            typeName: `${(0, lodash_1.upperFirst)(item.name)}Enum`,
+                            type: enumObj.type,
+                            props: [],
+                            isEnum: enumObj.isEnum,
+                            displayLabelFuncName: (0, lodash_1.camelCase)(`display-${item.name}-Enum`),
+                            enumLabelType: enumObj.enumLabelType,
+                        });
+                    }
+                });
+            }
+            if ((0, lodash_1.isEmpty)(this.config.allowedTags) ||
+                schema.isAllowed) {
+                const isEnum = result.isEnum;
+                const typeName = (0, util_1.resolveTypeName)(schemaKey);
+                lastTypes.push({
+                    typeName,
+                    type: getDefinesType(),
+                    props: (result.props || []),
+                    isEnum,
+                    displayLabelFuncName: isEnum
+                        ? (0, lodash_1.camelCase)(`display-${typeName}-Enum`)
+                        : '',
+                    enumLabelType: isEnum ? result.enumLabelType : '',
+                });
+            }
+        });
+        return lastTypes === null || lastTypes === void 0 ? void 0 : lastTypes.sort((a, b) => a.typeName.localeCompare(b.typeName)); // typeName排序
+    }
+    getServiceTPConfigs() {
+        return (0, lodash_1.keys)(this.apiData)
+            .map((tag, index) => {
+            var _a, _b;
+            // functionName tag 级别防重
+            const tmpFunctionRD = {};
+            const genParams = this.apiData[tag]
+                .filter((api) => 
+            // 暂不支持变量, path 需要普通前缀请使用例如: apiPrefix: "`api`", path 需要变量前缀请使用例如: apiPrefix: "api"
+            !api.path.includes('${'))
+                .map((api) => {
+                var _a, _b, _c, _d, _e, _f;
+                const newApi = api;
+                try {
+                    const params = this.getParamsTP(newApi.parameters, newApi.path) || {};
+                    const body = this.getBodyTP(newApi.requestBody);
+                    const response = this.getResponseTP(newApi.responses);
+                    const file = this.getFileTP(newApi.requestBody);
+                    let formData = false;
+                    if (((_a = body === null || body === void 0 ? void 0 : body.mediaType) === null || _a === void 0 ? void 0 : _a.includes('form-data')) || file) {
+                        formData = true;
+                    }
+                    let functionName = this.getFuncationName(newApi);
+                    if (functionName && tmpFunctionRD[functionName]) {
+                        functionName = `${functionName}_${(tmpFunctionRD[functionName] += 1)}`;
+                    }
+                    else if (functionName) {
+                        tmpFunctionRD[functionName] = 1;
+                    }
+                    let formattedPath = newApi.path.replace(/:([^/]*)|{([^}]*)}/gi, (_, str, str2) => `$\{${str || str2}}`);
+                    // 为 path 中的 params 添加 alias
+                    const escapedPathParams = (0, lodash_1.map)(params.path, (item, index) => (Object.assign(Object.assign({}, item), { alias: `param${index}` })));
+                    if (escapedPathParams.length) {
+                        escapedPathParams.forEach((param) => {
+                            formattedPath = formattedPath.replace(`$\{${param.name}}`, `$\{${param.alias}}`);
+                        });
+                    }
+                    const finalParams = escapedPathParams && escapedPathParams.length
+                        ? Object.assign(Object.assign({}, params), { path: escapedPathParams }) : params;
+                    // 处理 query 中的复杂对象
+                    if (finalParams === null || finalParams === void 0 ? void 0 : finalParams.query) {
+                        finalParams.query = finalParams.query.map((item) => (Object.assign(Object.assign({}, item), { isComplexType: item.isObject })));
+                    }
+                    // 处理 api path 前缀
+                    const getPrefixPath = () => {
+                        if (!this.config.apiPrefix) {
+                            return formattedPath;
+                        }
+                        // 静态 apiPrefix
+                        const prefix = (0, lodash_1.isFunction)(this.config.apiPrefix)
+                            ? `${this.config.apiPrefix({
+                                path: formattedPath,
+                                method: newApi.method,
+                                namespace: tag,
+                                functionName,
+                            })}`.trim()
+                            : this.config.apiPrefix.trim();
+                        if (!prefix) {
+                            return formattedPath;
+                        }
+                        if (prefix.startsWith("'") ||
+                            prefix.startsWith('"') ||
+                            prefix.startsWith('`')) {
+                            const finalPrefix = prefix.slice(1, prefix.length - 1);
+                            if (formattedPath.startsWith(finalPrefix) ||
+                                formattedPath.startsWith(`/${finalPrefix}`)) {
+                                return formattedPath;
+                            }
+                            return `${finalPrefix}${formattedPath}`;
+                        }
+                        // prefix 变量
+                        return `$\{${prefix}}${formattedPath}`;
+                    };
+                    return Object.assign(Object.assign({}, newApi), { functionName: this.config.isCamelCase
+                            ? (0, lodash_1.camelCase)(functionName)
+                            : functionName, typeName: this.getTypeName(newApi), path: getPrefixPath(), pathInComment: formattedPath.replace(/\*/g, '&#42;'), hasPathVariables: formattedPath.includes('{'), hasApiPrefix: !!this.config.apiPrefix, method: newApi.method, 
+                        // 如果 functionName 和 summary 相同，则不显示 summary
+                        desc: functionName === newApi.summary
+                            ? newApi.description
+                            : [
+                                newApi.summary,
+                                newApi.description,
+                                ((_c = (_b = newApi.responses) === null || _b === void 0 ? void 0 : _b.default) === null || _c === void 0 ? void 0 : _c.description)
+                                    ? `返回值: ${((_d = newApi.responses) === null || _d === void 0 ? void 0 : _d.default).description}`
+                                    : '',
+                            ]
+                                .filter((s) => s)
+                                .join(' '), hasHeader: !!(params === null || params === void 0 ? void 0 : params.header) || !!(body === null || body === void 0 ? void 0 : body.mediaType), params: finalParams, hasParams: Boolean((0, lodash_1.keys)(finalParams).length), options: ((_f = (_e = this.config.hook) === null || _e === void 0 ? void 0 : _e.customOptionsDefaultValue) === null || _f === void 0 ? void 0 : _f.call(_e, newApi)) || {}, body,
+                        file, hasFormData: formData, response });
+                }
+                catch (error) {
+                    console.error('[GenSDK] gen service param error:', error);
+                    throw error;
+                }
+            })
+                // 排序下，防止git乱
+                .sort((a, b) => a.path.localeCompare(b.path));
+            const fileName = (0, util_1.replaceDot)(tag) || `api${index}`;
+            let className = fileName;
+            if ((_a = this.config.hook) === null || _a === void 0 ? void 0 : _a.customClassName) {
+                className = this.config.hook.customClassName(tag);
+            }
+            if (genParams.length) {
+                this.classNameList.push({
+                    fileName: className,
+                    controllerName: className,
+                });
+            }
+            return {
+                genType: 'ts',
+                className,
+                instanceName: `${(_b = fileName[0]) === null || _b === void 0 ? void 0 : _b.toLowerCase()}${fileName.slice(1)}`,
+                list: genParams,
+            };
+        })
+            .filter((item) => { var _a; return !!((_a = item === null || item === void 0 ? void 0 : item.list) === null || _a === void 0 ? void 0 : _a.length); });
+    }
+    genFileFromTemplate(fileName, type, params) {
+        try {
+            const template = this.getTemplate(type);
+            // 设置输出不转义
+            nunjucks_1.default.configure({
+                autoescape: false,
+            });
+            return (0, file_1.writeFile)(this.config.serversPath, fileName, nunjucks_1.default.renderString(template, Object.assign({ ddisableTypeCheck: false }, params)));
+        }
+        catch (error) {
+            console.error('[GenSDK] file gen fail:', fileName, 'type:', type);
+            throw error;
+        }
+    }
+    getTemplate(type) {
+        return (0, fs_1.readFileSync)((0, path_1.join)(this.config.templatesFolder, `${type}.njk`), 'utf8');
+    }
+    getFuncationName(data) {
+        // 获取路径相同部分
+        const pathBasePrefix = (0, util_1.getBasePrefix)((0, lodash_1.keys)(this.openAPIData.paths));
+        return this.config.hook && this.config.hook.customFunctionName
+            ? this.config.hook.customFunctionName(data)
+            : data.operationId
+                ? (0, util_1.resolveFunctionName)((0, util_1.stripDot)(data.operationId), data.method)
+                : data.method + (0, util_1.genDefaultFunctionName)(data.path, pathBasePrefix);
+    }
+    getType(schemaObject, namespace) {
+        var _a, _b;
+        const customTypeHookFunc = (_a = this.config.hook) === null || _a === void 0 ? void 0 : _a.customType;
+        const schemas = (_b = this.openAPIData.components) === null || _b === void 0 ? void 0 : _b.schemas;
+        if (customTypeHookFunc) {
+            const type = customTypeHookFunc({
+                schemaObject,
+                namespace,
+                schemas,
+                originGetType: util_1.getDefaultType,
+            });
+            if (typeof type === 'string') {
+                return type;
+            }
+        }
+        return (0, util_1.getDefaultType)(schemaObject, namespace, schemas);
+    }
+    getTypeName(data) {
+        var _a, _b, _c;
+        const namespace = this.config.namespace ? `${this.config.namespace}.` : '';
+        const typeName = ((_c = (_b = (_a = this.config) === null || _a === void 0 ? void 0 : _a.hook) === null || _b === void 0 ? void 0 : _b.customTypeName) === null || _c === void 0 ? void 0 : _c.call(_b, data)) || this.getFuncationName(data);
+        return (0, util_1.resolveTypeName)(`${namespace}${typeName !== null && typeName !== void 0 ? typeName : data.operationId}Params`);
+    }
+    getBodyTP(requestBody) {
+        const reqBody = this.resolveRefObject(requestBody);
+        if ((0, lodash_1.isEmpty)(reqBody)) {
+            return null;
+        }
+        const reqContent = reqBody.content;
+        if (!(0, lodash_1.isObject)(reqContent)) {
+            return null;
+        }
+        let mediaType = (0, lodash_1.keys)(reqContent)[0];
+        const schema = reqContent[mediaType].schema || config_1.DEFAULT_SCHEMA;
+        if (mediaType === '*/*') {
+            mediaType = '';
+        }
+        // 如果 requestBody 有 required 属性，则正常展示；如果没有，默认非必填
+        const required = typeof (requestBody === null || requestBody === void 0 ? void 0 : requestBody.required) === 'boolean' ? requestBody.required : false;
+        if (schema.type === 'object' && schema.properties) {
+            const propertiesList = (0, lodash_1.keys)(schema.properties)
+                .map((propertyKey) => {
+                var _a, _b;
+                const propertyObj = schema.properties[propertyKey];
+                if (propertyObj &&
+                    ![type_1.SchemaObjectFormat.binary, type_1.SchemaObjectFormat.base64].includes(propertyObj.format) &&
+                    !(0, util_1.isBinaryArraySchemaObject)(propertyObj)) {
+                    // 测试了很多用例，很少有用例走到这里
+                    return {
+                        key: propertyKey,
+                        schema: Object.assign(Object.assign({}, propertyObj), { type: this.getType(propertyObj, this.config.namespace), required: (_b = (_a = schema.required) === null || _a === void 0 ? void 0 : _a.includes(propertyKey)) !== null && _b !== void 0 ? _b : false }),
+                    };
+                }
+                return null;
+            })
+                .filter((p) => p);
+            return Object.assign(Object.assign({ mediaType }, schema), { required,
+                propertiesList });
+        }
+        return {
+            mediaType,
+            required,
+            type: this.getType(schema, this.config.namespace),
+        };
+    }
+    getFileTP(requestBody) {
+        var _a;
+        const reqBody = this.resolveRefObject(requestBody);
+        if ((_a = reqBody === null || reqBody === void 0 ? void 0 : reqBody.content) === null || _a === void 0 ? void 0 : _a['multipart/form-data']) {
+            const ret = this.resolveFileTP(reqBody.content['multipart/form-data'].schema);
+            return ret.length > 0 ? ret : null;
+        }
+        return null;
+    }
+    resolveFileTP(obj) {
+        var _a;
+        let ret = [];
+        const resolved = this.resolveObject(obj);
+        const props = (((_a = resolved.props) === null || _a === void 0 ? void 0 : _a.length) > 0 &&
+            resolved.props[0].filter((p) => p.format === 'binary' ||
+                p.format === 'base64' ||
+                (0, util_1.isBinaryArraySchemaObject)(p))) ||
+            [];
+        if (props.length > 0) {
+            ret = props.map((p) => {
+                // 这里 p.type 是自定义type, 注意别混淆
+                return {
+                    title: p.name,
+                    multiple: p.type === `${type_1.SchemaObjectType.array}` ||
+                        p.type === `${type_1.SchemaObjectType.stringArray}`,
+                };
+            });
+        }
+        if (resolved.type)
+            ret = [...ret, ...this.resolveFileTP(resolved.type)];
+        return ret;
+    }
+    getResponseTP(responses = {}) {
+        var _a;
+        const { components } = this.openAPIData;
+        const response = responses &&
+            this.resolveRefObject(responses.default || responses['200'] || responses['201']);
+        const defaultResponse = {
+            mediaType: '*/*',
+            type: 'any',
+        };
+        if (!response) {
+            return defaultResponse;
+        }
+        const resContent = response.content;
+        const resContentMediaTypes = (0, lodash_1.keys)(resContent);
+        const mediaType = resContentMediaTypes.includes('application/json')
+            ? 'application/json'
+            : resContentMediaTypes[0]; // 优先使用 application/json
+        if (!(0, lodash_1.isObject)(resContent) || !mediaType) {
+            return defaultResponse;
+        }
+        let schema = (resContent[mediaType].schema ||
+            config_1.DEFAULT_SCHEMA);
+        if ((0, util_1.isReferenceObject)(schema)) {
+            const refPaths = schema.$ref.split('/');
+            const refName = refPaths[refPaths.length - 1];
+            const childrenSchema = components.schemas[refName];
+            if ((0, util_1.isNonArraySchemaObject)(childrenSchema) && this.config.dataFields) {
+                schema = (((_a = this.config.dataFields
+                    .map((field) => childrenSchema.properties[field])
+                    .filter(Boolean)) === null || _a === void 0 ? void 0 : _a[0]) ||
+                    resContent[mediaType].schema ||
+                    config_1.DEFAULT_SCHEMA);
+            }
+        }
+        if ((0, util_1.isSchemaObject)(schema)) {
+            (0, lodash_1.keys)(schema.properties).map((fieldName) => {
+                var _a, _b;
+                schema.properties[fieldName]['required'] =
+                    (_b = (_a = schema.required) === null || _a === void 0 ? void 0 : _a.includes(fieldName)) !== null && _b !== void 0 ? _b : false;
+            });
+        }
+        return {
+            mediaType,
+            type: this.getType(schema, this.config.namespace),
+        };
+    }
+    getParamsTP(parameters = [], path = null) {
+        const templateParams = {};
+        if (parameters === null || parameters === void 0 ? void 0 : parameters.length) {
+            (0, lodash_1.forEach)(config_1.parametersIn, (source) => {
+                const params = parameters
+                    .map((p) => this.resolveRefObject(p))
+                    .filter((p) => p.in === source)
+                    .map((p) => {
+                    var _a, _b, _c, _d;
+                    const isDirectObject = (((_a = p.schema) === null || _a === void 0 ? void 0 : _a.type) ||
+                        p.type) === 'object';
+                    const refList = (((_b = p.schema) === null || _b === void 0 ? void 0 : _b.$ref) ||
+                        p.$ref ||
+                        '').split('/');
+                    const ref = refList[refList.length - 1];
+                    const deRefObj = (0, lodash_1.entries)((_c = this.openAPIData.components) === null || _c === void 0 ? void 0 : _c.schemas).find(([k]) => k === ref) || [];
+                    const isRefObject = ((_d = deRefObj[1]) === null || _d === void 0 ? void 0 : _d.type) === 'object';
+                    return Object.assign(Object.assign({}, p), { isObject: isDirectObject || isRefObject, type: this.getType(p.schema || config_1.DEFAULT_SCHEMA, this.config.namespace) });
+                });
+                if (params.length) {
+                    templateParams[source] = params;
+                }
+            });
+        }
+        if (path && path.length > 0) {
+            const regex = /\{(\w+)\}/g;
+            templateParams.path = templateParams.path || [];
+            let match = null;
+            while ((match = regex.exec(path))) {
+                if (!templateParams.path.some((p) => p.name === match[1])) {
+                    templateParams.path.push(Object.assign(Object.assign({}, config_1.DEFAULT_PATH_PARAM), { name: match[1] }));
+                }
+            }
+            // 如果 path 没有内容，则将删除 path 参数，避免影响后续的 hasParams 判断
+            if (!templateParams.path.length)
+                delete templateParams.path;
+        }
+        return templateParams;
+    }
+    resolveObject(schemaObject) {
+        // 不使用 schemaObject: ISchemaObject = {}
+        schemaObject = schemaObject !== null && schemaObject !== void 0 ? schemaObject : {};
+        // 引用类型
+        if ((0, util_1.isReferenceObject)(schemaObject)) {
+            return this.resolveRefObject(schemaObject);
+        }
+        // 枚举类型
+        if (schemaObject.enum) {
+            return this.resolveEnumObject(schemaObject);
+        }
+        // 继承类型
+        if (schemaObject.allOf && schemaObject.allOf.length) {
+            return this.resolveAllOfObject(schemaObject);
+        }
+        // 对象类型
+        if (schemaObject.properties) {
+            return this.resolveProperties(schemaObject);
+        }
+        // 数组类型
+        if ((0, util_1.isArraySchemaObject)(schemaObject)) {
+            return this.resolveArray(schemaObject);
+        }
+        return schemaObject;
+    }
+    resolveArray(schemaObject) {
+        if ((0, util_1.isReferenceObject)(schemaObject.items)) {
+            const refPaths = schemaObject.items.$ref.split('/');
+            return {
+                type: `${refPaths[refPaths.length - 1]}[]`,
+            };
+        }
+        // 这里需要解析出具体属性，但由于 parser 层还不确定，所以暂时先返回 any[]
+        return { type: 'any[]' };
+    }
+    resolveProperties(schemaObject) {
+        return {
+            props: [this.getProps(schemaObject)],
+        };
+    }
+    resolveEnumObject(schemaObject) {
+        const enumArray = schemaObject.enum;
+        const enumStr = `{${(0, lodash_1.map)(enumArray, (value) => `${value}="${value}"`).join(',')}}`;
+        let enumLabelTypeStr = '';
+        // 翻译枚举
+        if (schemaObject['x-enum-varnames'] && schemaObject['x-enum-comments']) {
+            enumLabelTypeStr = `{${(0, lodash_1.map)(enumArray, (value, index) => {
+                const enumKey = schemaObject['x-enum-varnames'][index];
+                return `${value}:"${schemaObject['x-enum-comments'][enumKey]}"`;
+            }).join(',')}}`;
+        }
+        else {
+            enumLabelTypeStr = `{${(0, lodash_1.map)(enumArray, (value) => `${value}:"${value}"`).join(',')}}`;
+        }
+        return {
+            isEnum: true,
+            type: Array.isArray(enumArray) ? enumStr : 'string',
+            enumLabelType: enumLabelTypeStr,
+        };
+    }
+    resolveAllOfObject(schemaObject) {
+        const props = (0, lodash_1.map)(schemaObject.allOf, (item) => {
+            return (0, util_1.isReferenceObject)(item)
+                ? [Object.assign(Object.assign({}, item), { type: this.getType(item) })]
+                : this.getProps(item);
+        });
+        if (schemaObject.properties) {
+            const extProps = this.getProps(schemaObject);
+            return { props: [...props, extProps] };
+        }
+        return { props };
+    }
+    // 获取 TS 类型的属性列表
+    getProps(schemaObject) {
+        var _a;
+        const requiredPropKeys = (_a = schemaObject === null || schemaObject === void 0 ? void 0 : schemaObject.required) !== null && _a !== void 0 ? _a : false;
+        const properties = schemaObject.properties;
+        return (0, lodash_1.keys)(properties).map((propKey) => {
+            const schema = ((properties === null || properties === void 0 ? void 0 : properties[propKey]) || config_1.DEFAULT_SCHEMA);
+            // 剔除属性键值中的特殊符号，因为函数入参变量存在特殊符号会导致解析文件失败
+            // eslint-disable-next-line no-useless-escape
+            propKey = propKey.replace(/[\[|\]]/g, '');
+            // 复用 schema 部分字段
+            return Object.assign(Object.assign({}, schema), { name: propKey, type: this.getType(schema), desc: [schema.title, schema.description]
+                    .filter((item) => item)
+                    .join(' '), 
+                // 如果没有 required 信息，默认全部是非必填
+                required: requiredPropKeys
+                    ? requiredPropKeys.some((key) => key === propKey)
+                    : false });
+        });
+    }
+    resolveRefObject(refObject) {
+        var _a, _b;
+        if (!(0, util_1.isReferenceObject)(refObject)) {
+            return refObject;
+        }
+        // 测试了很多用例，很少有用例走到这里
+        const refPaths = refObject.$ref.split('/');
+        if (refPaths[0] === '#') {
+            const schema = (_b = (_a = this.openAPIData.components) === null || _a === void 0 ? void 0 : _a.schemas) === null || _b === void 0 ? void 0 : _b[refPaths[refPaths.length - 1]];
+            if (!schema) {
+                throw new Error(`[GenSDK] Data Error! Notfoud: ${refObject.$ref}`);
+            }
+            return Object.assign(Object.assign({}, (this.resolveRefObject(schema) || {})), { type: (0, util_1.isReferenceObject)(schema)
+                    ? this.resolveRefObject(schema).type
+                    : schema.type });
+        }
+        return refObject;
+    }
+}
+exports.default = ServiceGenerator;

package/dist/generator/type.d.ts

@@ -0,0 +1,34 @@
+import { OperationObject, ParameterObject, SchemaObject } from '../type';
+import { TypescriptFileType } from './config';
+export type ITypescriptFileType = keyof typeof TypescriptFileType;
+export interface APIDataType extends OperationObject {
+    path: string;
+    method: string;
+}
+export type TagAPIDataType = Record<string, APIDataType[]>;
+export interface ControllerType {
+    fileName: string;
+    controllerName: string;
+}
+export interface IPropBasicObject {
+    name: string;
+    desc: string;
+    required?: boolean;
+    type: string;
+}
+export type IPropObject = IPropBasicObject & Partial<Omit<SchemaObject, 'type' | 'required'>>;
+export interface ITypeItem {
+    typeName: string;
+    type: string | boolean | SchemaObject;
+    props: IPropObject[][];
+    isEnum: boolean;
+    displayLabelFuncName?: string;
+    enumLabelType?: string;
+}
+export type ICustomSchemaObject = SchemaObject & {
+    isAllowed?: boolean;
+};
+export type ICustomParameterObject = ParameterObject & {
+    isObject: boolean;
+    type: string;
+};

package/dist/generator/type.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });