yapi-apifox-to-typescript 4.2.3 → 5.0.0

package/lib/cjs/ApifoxToYApiData.js

@@ -1,588 +1,312 @@
-"use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault").default;
-
-exports.__esModule = true;
-exports.ApifoxToYApiData = void 0;
-
-var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
-
-var _createForOfIteratorHelperLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/createForOfIteratorHelperLoose"));
-
-var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
-
-var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
-
-var _axios = _interopRequireDefault(require("axios"));
-
-var _types = require("./types");
-
-var _utils = require("./utils");
-
-var ApifoxToYApiData = /*#__PURE__*/function () {
-  function ApifoxToYApiData(options) {
-    this.openApiDoc = null;
-    this.options = void 0;
-    this.project = {
-      _id: 0,
-      _url: '',
-      name: 'ApifoxProject',
-      desc: '',
-      basepath: '',
-      tag: [],
-      env: [{
-        name: '',
-        domain: ''
-      }]
-    };
-    this.schemas = {};
-    this.interfaceIdCounter = 0;
-    this.options = options;
-  }
-
-  var _proto = ApifoxToYApiData.prototype;
-
-  _proto.resolveRef = function resolveRef(ref) {
-    if (!ref.startsWith('#/components/schemas/')) {
-      return null;
-    }
-
-    var schemaName = ref.replace('#/components/schemas/', '');
-    return this.schemas[schemaName] || null;
-  };
-
-  _proto.resolveSchema = function resolveSchema(schema) {
-    if (!schema) return undefined;
-
-    if (schema.$ref) {
-      return this.resolveRef(schema.$ref) || schema;
-    }
-
-    return schema;
-  };
-
-  _proto.getSchemaType = function getSchemaType(schema) {
-    if (!schema) return 'string';
-    var resolved = this.resolveSchema(schema);
-    if (!resolved) return 'string';
-    return resolved.type || 'string';
-  };
-
-  _proto.getRequestParamType = function getRequestParamType(schema) {
-    var schemaType = this.getSchemaType(schema);
-    if (schemaType === 'boolean') return _types.RequestParamType.boolean;
-    if (schemaType === 'number') return _types.RequestParamType.number;
-    return _types.RequestParamType.string;
-  };
-
-  _proto.getRequestQueryType = function getRequestQueryType(schema) {
-    var schemaType = this.getSchemaType(schema);
-    if (schemaType === 'boolean') return _types.RequestQueryType.boolean;
-    if (schemaType === 'number') return _types.RequestQueryType.number;
-    return _types.RequestQueryType.string;
-  };
-
-  _proto.convertParametersToReqParams = function convertParametersToReqParams(parameters, type) {
-    var _this = this;
-
-    if (parameters === void 0) {
-      parameters = [];
-    }
-
-    if (type === 'path') {
-      return parameters.filter(function (p) {
-        return p.in === 'path';
-      }).map(function (p) {
-        return {
-          name: p.name,
-          desc: p.description || '',
-          example: p.example || '',
-          required: p.required ? _types.Required.true : _types.Required.false,
-          type: _this.getRequestParamType(p.schema)
-        };
-      });
-    }
-
-    return parameters.filter(function (p) {
-      return p.in === 'query';
-    }).map(function (p) {
-      return {
-        name: p.name,
-        desc: p.description || '',
-        example: p.example || '',
-        required: p.required ? _types.Required.true : _types.Required.false,
-        type: _this.getRequestQueryType(p.schema)
-      };
-    });
-  };
-
-  _proto.convertRequestBody = function convertRequestBody(requestBody) {
-    if (!(requestBody != null && requestBody.content)) {
-      return {
-        req_body_type: _types.RequestBodyType.none,
-        req_body_is_json_schema: false,
-        req_body_form: [],
-        req_body_other: '',
-        contentType: ''
-      };
-    }
-
-    var contentTypes = Object.keys(requestBody.content);
-    var jsonContentType = contentTypes.find(function (ct) {
-      return ct.includes('application/json');
-    });
-    var formContentType = contentTypes.find(function (ct) {
-      return ct.includes('application/x-www-form-urlencoded') || ct.includes('multipart/form-data');
-    });
-
-    if (jsonContentType) {
-      var schema = requestBody.content[jsonContentType].schema;
-      return {
-        req_body_type: _types.RequestBodyType.json,
-        req_body_is_json_schema: true,
-        req_body_form: [],
-        req_body_other: schema ? JSON.stringify(this.normalizeSchema(schema)) : '',
-        contentType: jsonContentType
-      };
-    }
-
-    if (formContentType) {
-      var _schema = requestBody.content[formContentType].schema;
-      var resolvedSchema = this.resolveSchema(_schema);
-      var formItems = [];
-
-      if (resolvedSchema != null && resolvedSchema.properties) {
-        var requiredFields = resolvedSchema.required || [];
-
-        for (var _i = 0, _Object$entries = Object.entries(resolvedSchema.properties); _i < _Object$entries.length; _i++) {
-          var _Object$entries$_i = _Object$entries[_i],
-              name = _Object$entries$_i[0],
-              prop = _Object$entries$_i[1];
-          var resolvedProp = this.resolveSchema(prop);
-          formItems.push({
-            name: name,
-            type: (resolvedProp == null ? void 0 : resolvedProp.type) === 'file' || (resolvedProp == null ? void 0 : resolvedProp.format) === 'binary' ? _types.RequestFormItemType.file : _types.RequestFormItemType.text,
-            desc: (resolvedProp == null ? void 0 : resolvedProp.description) || '',
-            example: (resolvedProp == null ? void 0 : resolvedProp.example) || '',
-            required: requiredFields.includes(name) ? _types.Required.true : _types.Required.false
-          });
-        }
-      }
-
-      return {
-        req_body_type: _types.RequestBodyType.form,
-        req_body_is_json_schema: false,
-        req_body_form: formItems,
-        req_body_other: '',
-        contentType: formContentType
-      };
-    }
-
-    return {
-      req_body_type: _types.RequestBodyType.raw,
-      req_body_is_json_schema: false,
-      req_body_form: [],
-      req_body_other: '',
-      contentType: contentTypes[0] || ''
-    };
-  };
-
-  _proto.normalizeSchema = function normalizeSchema(schema, visited) {
-    if (visited === void 0) {
-      visited = new Set();
-    }
-
-    var result = (0, _extends2.default)({}, schema);
-
-    if (schema.$ref) {
-      if (visited.has(schema.$ref)) {
-        // 循环引用，直接返回空对象避免无限递归
-        return {
-          type: 'object'
-        };
-      }
-
-      visited.add(schema.$ref);
-      var resolved = this.resolveRef(schema.$ref);
-
-      if (resolved) {
-        return this.normalizeSchema(resolved, new Set(visited));
-      }
-    }
-
-    if (schema.properties) {
-      result.properties = {};
-
-      for (var _i2 = 0, _Object$entries2 = Object.entries(schema.properties); _i2 < _Object$entries2.length; _i2++) {
-        var _Object$entries2$_i = _Object$entries2[_i2],
-            key = _Object$entries2$_i[0],
-            _value = _Object$entries2$_i[1];
-
-        if (_value) {
-          result.properties[key] = this.normalizeSchema(_value, new Set(visited));
-        }
-      }
-    }
-
-    if (schema.items) {
-      result.items = this.normalizeSchema(schema.items, new Set(visited));
-    }
-
-    delete result.$ref;
-    return result;
-  };
-
-  _proto.convertResponse = function convertResponse(responses) {
-    if (responses === void 0) {
-      responses = {};
-    }
-
-    var successResponse = responses['200'] || responses['201'] || responses['204'];
-
-    if (!(successResponse != null && successResponse.content)) {
-      return {
-        res_body_type: _types.ResponseBodyType.json,
-        res_body_is_json_schema: false,
-        res_body: ''
-      };
-    }
-
-    var jsonContent = successResponse.content['application/json'];
-
-    if (jsonContent != null && jsonContent.schema) {
-      return {
-        res_body_type: _types.ResponseBodyType.json,
-        res_body_is_json_schema: true,
-        res_body: JSON.stringify(this.normalizeSchema(jsonContent.schema))
-      };
-    }
-
-    return {
-      res_body_type: _types.ResponseBodyType.json,
-      res_body_is_json_schema: false,
-      res_body: ''
-    };
-  };
-
-  _proto.generateInterfaceId = function generateInterfaceId() {
-    this.interfaceIdCounter += 1;
-    return this.interfaceIdCounter;
-  }
-  /**
-   * 获取接口所属的目录名称
-   * Apifox 优先使用 x-apifox-folder 字段，其次才用 tags[0]
-   */
-  ;
-
-  _proto.getOperationFolder = function getOperationFolder(operation) {
-    // 优先使用 x-apifox-folder
-    if (operation['x-apifox-folder']) {
-      return operation['x-apifox-folder'];
-    } // 其次使用 tags[0]
-
-
-    if (operation.tags && operation.tags.length > 0) {
-      return operation.tags[0];
-    }
-
-    return 'default';
-  };
-
-  _proto.convertOperationToInterface = function convertOperationToInterface(path, method, operation, categoryName, categoryId) {
-    var _operation$tags;
-
-    var parameters = operation.parameters || [];
-    var pathParams = this.convertParametersToReqParams(parameters, 'path');
-    var queryParams = this.convertParametersToReqParams(parameters, 'query'); // const headerParams = parameters.filter(p => p.in === 'header')
-
-    var reqHeaders = [];
-    var requestBodyInfo = this.convertRequestBody(operation.requestBody);
-
-    if (requestBodyInfo.contentType) {
-      reqHeaders.push({
-        name: 'Content-Type',
-        value: requestBodyInfo.contentType,
-        desc: '',
-        example: '',
-        required: _types.Required.true
-      });
-    }
-
-    var responseInfo = this.convertResponse(operation.responses); // 获取接口所属目录：优先使用 x-apifox-folder，其次用 tags
-
-    var folderName = this.getOperationFolder(operation);
-    var interfaceTags = (_operation$tags = operation.tags) != null && _operation$tags.length ? operation.tags : folderName !== 'default' ? [folderName] : [];
-    return {
-      _id: this.generateInterfaceId(),
-      _category: {
-        _id: categoryId,
-        _url: '',
-        name: categoryName,
-        desc: '',
-        add_time: 0,
-        up_time: 0
-      },
-      _project: (0, _extends2.default)({}, this.project),
-      _url: '',
-      title: operation.summary || path,
-      status: operation.deprecated ? 'undone' : 'done',
-      markdown: operation.description || '',
-      path: path,
-      method: method.toUpperCase(),
-      project_id: this.options.projectId,
-      catid: categoryId,
-      tag: interfaceTags,
-      req_headers: reqHeaders,
-      req_params: pathParams,
-      req_query: queryParams,
-      req_body_type: requestBodyInfo.req_body_type,
-      req_body_is_json_schema: requestBodyInfo.req_body_is_json_schema,
-      req_body_form: requestBodyInfo.req_body_form,
-      req_body_other: requestBodyInfo.req_body_other,
-      res_body_type: responseInfo.res_body_type,
-      res_body_is_json_schema: responseInfo.res_body_is_json_schema,
-      res_body: responseInfo.res_body,
-      add_time: Math.floor(Date.now() / 1000),
-      up_time: Math.floor(Date.now() / 1000),
-      uid: 0
-    };
-  };
-
-  _proto.getProjectInfo = /*#__PURE__*/function () {
-    var _getProjectInfo = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee() {
-      var _this$options$addFold, _this$options$oasVers, _this$options$exportF, _this$openApiDoc, _this$openApiDoc$comp, _this$openApiDoc2, _this$openApiDoc2$inf, _this$openApiDoc3, _this$openApiDoc3$inf;
-
-      var baseUrl, response;
-      return _regenerator.default.wrap(function _callee$(_context) {
-        while (1) {
-          switch (_context.prev = _context.next) {
-            case 0:
-              baseUrl = this.options.serverUrl.replace(/\/$/, '');
-              _context.next = 3;
-              return _axios.default.post(baseUrl + "/v1/projects/" + this.options.projectId + "/export-openapi?locale=zh-CN", {
-                scope: {
-                  type: 'ALL',
-                  excludedByTags: []
-                },
-                options: {
-                  includeApifoxExtensionProperties: true,
-                  addFoldersToTags: (_this$options$addFold = this.options.addFoldersToTags) != null ? _this$options$addFold : true
-                },
-                oasVersion: (_this$options$oasVers = this.options.oasVersion) != null ? _this$options$oasVers : '3.0',
-                exportFormat: (_this$options$exportF = this.options.exportFormat) != null ? _this$options$exportF : 'JSON'
-              }, {
-                headers: {
-                  'Authorization': "Bearer " + this.options.token,
-                  'X-Apifox-Api-Version': '2024-03-28',
-                  'Content-Type': 'application/json'
-                }
-              });
-
-            case 3:
-              response = _context.sent;
-              this.openApiDoc = response.data;
-
-              if ((_this$openApiDoc = this.openApiDoc) != null && (_this$openApiDoc$comp = _this$openApiDoc.components) != null && _this$openApiDoc$comp.schemas) {
-                this.schemas = this.openApiDoc.components.schemas;
-              }
-
-              this.project._id = this.options.projectId;
-              this.project.name = ((_this$openApiDoc2 = this.openApiDoc) == null ? void 0 : (_this$openApiDoc2$inf = _this$openApiDoc2.info) == null ? void 0 : _this$openApiDoc2$inf.title) || 'ApifoxProject';
-              this.project.desc = ((_this$openApiDoc3 = this.openApiDoc) == null ? void 0 : (_this$openApiDoc3$inf = _this$openApiDoc3.info) == null ? void 0 : _this$openApiDoc3$inf.description) || '';
-              return _context.abrupt("return", (0, _extends2.default)({}, this.project, {
-                cats: [],
-                getMockUrl: function getMockUrl() {
-                  return '';
-                },
-                getDevUrl: function getDevUrl() {
-                  return '';
-                },
-                getProdUrl: function getProdUrl() {
-                  return '';
-                }
-              }));
-
-            case 10:
-            case "end":
-              return _context.stop();
-          }
-        }
-      }, _callee, this);
-    }));
-
-    function getProjectInfo() {
-      return _getProjectInfo.apply(this, arguments);
-    }
-
-    return getProjectInfo;
-  }();
-
-  _proto.getTagId = function getTagId(tagName) {
-    var hash = 0;
-
-    for (var i = 0; i < tagName.length; i++) {
-      var _char = tagName.charCodeAt(i);
-
-      hash = (hash << 5) - hash + _char;
-      hash = hash & hash;
-    }
-
-    return Math.abs(hash);
-  }
-  /**
-   * 从 OpenAPI tags 中获取目录对应的 tag
-   * 如果 x-apifox-folder 在 tags 中存在，则返回对应的 tag；否则返回 x-apifox-folder 本身
-   */
-  ;
-
-  _proto.getMatchingTag = function getMatchingTag(xApifoxFolder) {
-    var _this$openApiDoc4;
-
-    if (!((_this$openApiDoc4 = this.openApiDoc) != null && _this$openApiDoc4.tags)) return null; // 先精确匹配
-
-    var exactMatch = this.openApiDoc.tags.find(function (tag) {
-      return tag.name === xApifoxFolder;
-    });
-    if (exactMatch) return exactMatch.name; // 如果 addFoldersToTags=true，可能目录名被添加到 tag 描述或其他地方
-    // 或者 tag.name 本身就包含了目录路径
-
-    return null;
-  };
-
-  _proto.getCats = function getCats(cats) {
-    var _this2 = this;
-
-    var categoryIds = (0, _utils.getFilteredCat)(cats, [], true);
-
-    if (categoryIds.length === 0 || categoryIds.includes(0)) {
-      var _this$openApiDoc5;
-
-      if (!((_this$openApiDoc5 = this.openApiDoc) != null && _this$openApiDoc5.tags)) {
-        return [];
-      }
-
-      var tagIds = this.openApiDoc.tags.map(function (tag) {
-        return _this2.getTagId(tag.name);
-      });
-      return tagIds;
-    }
-
-    return categoryIds;
-  };
-
-  _proto.getInterfaceList = /*#__PURE__*/function () {
-    var _getInterfaceList = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(syntheticalConfig) {
-      var _this$openApiDoc6;
-
-      var catId, interfaces, seenKeys, methods, _i3, _Object$entries3, _Object$entries3$_i, path, pathItem, _iterator, _step, method, operation, xApifoxFolder, tagId, key, categoryTag, interfaceInfo;
-
-      return _regenerator.default.wrap(function _callee2$(_context2) {
-        while (1) {
-          switch (_context2.prev = _context2.next) {
-            case 0:
-              if ((_this$openApiDoc6 = this.openApiDoc) != null && _this$openApiDoc6.paths) {
-                _context2.next = 2;
-                break;
-              }
-
-              return _context2.abrupt("return", []);
-
-            case 2:
-              catId = syntheticalConfig.id;
-              interfaces = []; // 用于去重：基于 path + method
-
-              seenKeys = new Set(); // 调试：获取 tag 名称
-              // let tagName = 'unknown'
-              // if (this.openApiDoc?.tags) {
-              //   const tag = this.openApiDoc.tags.find(
-              //     t => this.getTagId(t.name) === catId,
-              //   )
-              //   tagName = tag?.name || `unknown(${catId})`
-              // }
-
-              methods = ['get', 'post', 'put', 'delete', 'patch', 'head', 'options'];
-              _i3 = 0, _Object$entries3 = Object.entries(this.openApiDoc.paths);
-
-            case 7:
-              if (!(_i3 < _Object$entries3.length)) {
-                _context2.next = 30;
-                break;
-              }
-
-              _Object$entries3$_i = _Object$entries3[_i3], path = _Object$entries3$_i[0], pathItem = _Object$entries3$_i[1];
-              _iterator = (0, _createForOfIteratorHelperLoose2.default)(methods);
-
-            case 10:
-              if ((_step = _iterator()).done) {
-                _context2.next = 27;
-                break;
-              }
-
-              method = _step.value;
-              operation = pathItem[method];
-
-              if (operation) {
-                _context2.next = 15;
-                break;
-              }
-
-              return _context2.abrupt("continue", 25);
-
-            case 15:
-              // 获取接口的目录信息：优先使用 x-apifox-folder
-              xApifoxFolder = this.getOperationFolder(operation);
-              tagId = this.getTagId(xApifoxFolder);
-
-              if (!(tagId === catId)) {
-                _context2.next = 25;
-                break;
-              }
-
-              // 去重：基于 path + method
-              key = method.toUpperCase() + ":" + path;
-
-              if (!seenKeys.has(key)) {
-                _context2.next = 21;
-                break;
-              }
-
-              return _context2.abrupt("continue", 25);
-
-            case 21:
-              seenKeys.add(key); // 根据实际的目录名称来确定分类
-
-              categoryTag = xApifoxFolder;
-              interfaceInfo = this.convertOperationToInterface(path, method, operation, categoryTag, catId);
-              interfaces.push(interfaceInfo);
-
-            case 25:
-              _context2.next = 10;
-              break;
-
-            case 27:
-              _i3++;
-              _context2.next = 7;
-              break;
-
-            case 30:
-              return _context2.abrupt("return", interfaces);
-
-            case 31:
-            case "end":
-              return _context2.stop();
-          }
-        }
-      }, _callee2, this);
-    }));
-
-    function getInterfaceList(_x) {
-      return _getInterfaceList.apply(this, arguments);
-    }
-
-    return getInterfaceList;
-  }();
-
-  return ApifoxToYApiData;
-}();
-
-exports.ApifoxToYApiData = ApifoxToYApiData;
+const require_runtime = require("./_virtual/_rolldown/runtime.js");
+const require_types = require("./types.js");
+const require_utils = require("./utils.js");
+let axios = require("axios");
+axios = require_runtime.__toESM(axios);
+//#region src/ApifoxToYApiData.ts
+var ApifoxToYApiData = class {
+	constructor(options) {
+		this.openApiDoc = null;
+		this.project = {
+			_id: 0,
+			_url: "",
+			name: "ApifoxProject",
+			desc: "",
+			basepath: "",
+			tag: [],
+			env: [{
+				name: "",
+				domain: ""
+			}]
+		};
+		this.schemas = {};
+		this.interfaceIdCounter = 0;
+		this.options = options;
+	}
+	resolveRef(ref) {
+		if (!ref.startsWith("#/components/schemas/")) return null;
+		const schemaName = ref.replace("#/components/schemas/", "");
+		return this.schemas[schemaName] || null;
+	}
+	resolveSchema(schema) {
+		if (!schema) return void 0;
+		if (schema.$ref) return this.resolveRef(schema.$ref) || schema;
+		return schema;
+	}
+	getSchemaType(schema) {
+		if (!schema) return "string";
+		const resolved = this.resolveSchema(schema);
+		if (!resolved) return "string";
+		return resolved.type || "string";
+	}
+	getRequestParamType(schema) {
+		const schemaType = this.getSchemaType(schema);
+		if (schemaType === "boolean") return require_types.RequestParamType.boolean;
+		if (schemaType === "number") return require_types.RequestParamType.number;
+		return require_types.RequestParamType.string;
+	}
+	getRequestQueryType(schema) {
+		const schemaType = this.getSchemaType(schema);
+		if (schemaType === "boolean") return require_types.RequestQueryType.boolean;
+		if (schemaType === "number") return require_types.RequestQueryType.number;
+		return require_types.RequestQueryType.string;
+	}
+	convertParametersToReqParams(parameters = [], type) {
+		if (type === "path") return parameters.filter((p) => p.in === "path").map((p) => ({
+			name: p.name,
+			desc: p.description || "",
+			example: p.example || "",
+			required: p.required ? require_types.Required.true : require_types.Required.false,
+			type: this.getRequestParamType(p.schema)
+		}));
+		return parameters.filter((p) => p.in === "query").map((p) => ({
+			name: p.name,
+			desc: p.description || "",
+			example: p.example || "",
+			required: p.required ? require_types.Required.true : require_types.Required.false,
+			type: this.getRequestQueryType(p.schema)
+		}));
+	}
+	convertRequestBody(requestBody) {
+		if (!requestBody?.content) return {
+			req_body_type: require_types.RequestBodyType.none,
+			req_body_is_json_schema: false,
+			req_body_form: [],
+			req_body_other: "",
+			contentType: ""
+		};
+		const contentTypes = Object.keys(requestBody.content);
+		const jsonContentType = contentTypes.find((ct) => ct.includes("application/json"));
+		const formContentType = contentTypes.find((ct) => ct.includes("application/x-www-form-urlencoded") || ct.includes("multipart/form-data"));
+		if (jsonContentType) {
+			const schema = requestBody.content[jsonContentType].schema;
+			return {
+				req_body_type: require_types.RequestBodyType.json,
+				req_body_is_json_schema: true,
+				req_body_form: [],
+				req_body_other: schema ? JSON.stringify(this.normalizeSchema(schema)) : "",
+				contentType: jsonContentType
+			};
+		}
+		if (formContentType) {
+			const schema = requestBody.content[formContentType].schema;
+			const resolvedSchema = this.resolveSchema(schema);
+			const formItems = [];
+			if (resolvedSchema?.properties) {
+				const requiredFields = resolvedSchema.required || [];
+				for (const [name, prop] of Object.entries(resolvedSchema.properties)) {
+					const resolvedProp = this.resolveSchema(prop);
+					formItems.push({
+						name,
+						type: resolvedProp?.type === "file" || resolvedProp?.format === "binary" ? require_types.RequestFormItemType.file : require_types.RequestFormItemType.text,
+						desc: resolvedProp?.description || "",
+						example: resolvedProp?.example || "",
+						required: requiredFields.includes(name) ? require_types.Required.true : require_types.Required.false
+					});
+				}
+			}
+			return {
+				req_body_type: require_types.RequestBodyType.form,
+				req_body_is_json_schema: false,
+				req_body_form: formItems,
+				req_body_other: "",
+				contentType: formContentType
+			};
+		}
+		return {
+			req_body_type: require_types.RequestBodyType.raw,
+			req_body_is_json_schema: false,
+			req_body_form: [],
+			req_body_other: "",
+			contentType: contentTypes[0] || ""
+		};
+	}
+	normalizeSchema(schema, visited = /* @__PURE__ */ new Set()) {
+		const result = { ...schema };
+		if (schema.$ref) {
+			if (visited.has(schema.$ref)) return { type: "object" };
+			visited.add(schema.$ref);
+			const resolved = this.resolveRef(schema.$ref);
+			if (resolved) return this.normalizeSchema(resolved, new Set(visited));
+		}
+		if (schema.properties) {
+			result.properties = {};
+			for (const [key, value] of Object.entries(schema.properties)) if (value) result.properties[key] = this.normalizeSchema(value, new Set(visited));
+		}
+		if (schema.items) result.items = this.normalizeSchema(schema.items, new Set(visited));
+		delete result.$ref;
+		return result;
+	}
+	convertResponse(responses = {}) {
+		const successResponse = responses["200"] || responses["201"] || responses["204"];
+		if (!successResponse?.content) return {
+			res_body_type: require_types.ResponseBodyType.json,
+			res_body_is_json_schema: false,
+			res_body: ""
+		};
+		const jsonContent = successResponse.content["application/json"];
+		if (jsonContent?.schema) return {
+			res_body_type: require_types.ResponseBodyType.json,
+			res_body_is_json_schema: true,
+			res_body: JSON.stringify(this.normalizeSchema(jsonContent.schema))
+		};
+		return {
+			res_body_type: require_types.ResponseBodyType.json,
+			res_body_is_json_schema: false,
+			res_body: ""
+		};
+	}
+	generateInterfaceId() {
+		this.interfaceIdCounter += 1;
+		return this.interfaceIdCounter;
+	}
+	/**
+	* 获取接口所属的目录名称
+	* Apifox 优先使用 x-apifox-folder 字段，其次才用 tags[0]
+	*/
+	getOperationFolder(operation) {
+		if (operation["x-apifox-folder"]) return operation["x-apifox-folder"];
+		if (operation.tags && operation.tags.length > 0) return operation.tags[0];
+		return "default";
+	}
+	convertOperationToInterface(path, method, operation, categoryName, categoryId) {
+		const parameters = operation.parameters || [];
+		const pathParams = this.convertParametersToReqParams(parameters, "path");
+		const queryParams = this.convertParametersToReqParams(parameters, "query");
+		const reqHeaders = [];
+		const requestBodyInfo = this.convertRequestBody(operation.requestBody);
+		if (requestBodyInfo.contentType) reqHeaders.push({
+			name: "Content-Type",
+			value: requestBodyInfo.contentType,
+			desc: "",
+			example: "",
+			required: require_types.Required.true
+		});
+		const responseInfo = this.convertResponse(operation.responses);
+		const folderName = this.getOperationFolder(operation);
+		const interfaceTags = operation.tags?.length ? operation.tags : folderName !== "default" ? [folderName] : [];
+		return {
+			_id: this.generateInterfaceId(),
+			_category: {
+				_id: categoryId,
+				_url: "",
+				name: categoryName,
+				desc: "",
+				add_time: 0,
+				up_time: 0
+			},
+			_project: { ...this.project },
+			_url: "",
+			title: operation.summary || path,
+			status: operation.deprecated ? "undone" : "done",
+			markdown: operation.description || "",
+			path,
+			method: method.toUpperCase(),
+			project_id: this.options.projectId,
+			catid: categoryId,
+			tag: interfaceTags,
+			req_headers: reqHeaders,
+			req_params: pathParams,
+			req_query: queryParams,
+			req_body_type: requestBodyInfo.req_body_type,
+			req_body_is_json_schema: requestBodyInfo.req_body_is_json_schema,
+			req_body_form: requestBodyInfo.req_body_form,
+			req_body_other: requestBodyInfo.req_body_other,
+			res_body_type: responseInfo.res_body_type,
+			res_body_is_json_schema: responseInfo.res_body_is_json_schema,
+			res_body: responseInfo.res_body,
+			add_time: Math.floor(Date.now() / 1e3),
+			up_time: Math.floor(Date.now() / 1e3),
+			uid: 0
+		};
+	}
+	async getProjectInfo() {
+		const baseUrl = this.options.serverUrl.replace(/\/$/, "");
+		const response = await axios.default.post(`${baseUrl}/v1/projects/${this.options.projectId}/export-openapi?locale=zh-CN`, {
+			scope: {
+				type: "ALL",
+				excludedByTags: []
+			},
+			options: {
+				includeApifoxExtensionProperties: true,
+				addFoldersToTags: this.options.addFoldersToTags ?? true
+			},
+			oasVersion: this.options.oasVersion ?? "3.0",
+			exportFormat: this.options.exportFormat ?? "JSON"
+		}, { headers: {
+			Authorization: `Bearer ${this.options.token}`,
+			"X-Apifox-Api-Version": "2024-03-28",
+			"Content-Type": "application/json"
+		} });
+		this.openApiDoc = response.data;
+		if (this.openApiDoc?.components?.schemas) this.schemas = this.openApiDoc.components.schemas;
+		this.project._id = this.options.projectId;
+		this.project.name = this.openApiDoc?.info?.title || "ApifoxProject";
+		this.project.desc = this.openApiDoc?.info?.description || "";
+		return {
+			...this.project,
+			cats: [],
+			getMockUrl: () => "",
+			getDevUrl: () => "",
+			getProdUrl: () => ""
+		};
+	}
+	getTagId(tagName) {
+		let hash = 0;
+		for (let i = 0; i < tagName.length; i++) {
+			const char = tagName.charCodeAt(i);
+			hash = (hash << 5) - hash + char;
+			hash = hash & hash;
+		}
+		return Math.abs(hash);
+	}
+	/**
+	* 从 OpenAPI tags 中获取目录对应的 tag
+	* 如果 x-apifox-folder 在 tags 中存在，则返回对应的 tag；否则返回 x-apifox-folder 本身
+	*/
+	getMatchingTag(xApifoxFolder) {
+		if (!this.openApiDoc?.tags) return null;
+		const exactMatch = this.openApiDoc.tags.find((tag) => tag.name === xApifoxFolder);
+		if (exactMatch) return exactMatch.name;
+		return null;
+	}
+	getCats(cats) {
+		const categoryIds = require_utils.getFilteredCat(cats, [], true);
+		if (categoryIds.length === 0 || categoryIds.includes(0)) {
+			if (!this.openApiDoc?.tags) return [];
+			return this.openApiDoc.tags.map((tag) => this.getTagId(tag.name));
+		}
+		return categoryIds;
+	}
+	async getInterfaceList(syntheticalConfig) {
+		if (!this.openApiDoc?.paths) return [];
+		const catId = syntheticalConfig.id;
+		const interfaces = [];
+		const seenKeys = /* @__PURE__ */ new Set();
+		const methods = [
+			"get",
+			"post",
+			"put",
+			"delete",
+			"patch",
+			"head",
+			"options"
+		];
+		for (const [path, pathItem] of Object.entries(this.openApiDoc.paths)) for (const method of methods) {
+			const operation = pathItem[method];
+			if (!operation) continue;
+			const xApifoxFolder = this.getOperationFolder(operation);
+			if (this.getTagId(xApifoxFolder) === catId) {
+				const key = `${method.toUpperCase()}:${path}`;
+				if (seenKeys.has(key)) continue;
+				seenKeys.add(key);
+				const categoryTag = xApifoxFolder;
+				const interfaceInfo = this.convertOperationToInterface(path, method, operation, categoryTag, catId);
+				interfaces.push(interfaceInfo);
+			}
+		}
+		return interfaces;
+	}
+};
+//#endregion
+exports.ApifoxToYApiData = ApifoxToYApiData;