mm_expand 2.3.4 → 2.3.6

package/lib/object.js

@@ -1,12 +1,7 @@
-const {
-  inspect
-} = require('util');
-const {
-  XMLBuilder
-} = require('fast-xml-parser');
+const { inspect } = require('util');
 /* == 基础函数 == */
 /**
- * @description 尝试将值转换为目标类型
+ * 尝试将值转换为目标类型
  * @param {any} value 要转换的值
  * @param {string} target_type 目标类型
  * @returns {any} 转换后的值，转换失败返回原值
@@ -33,7 +28,7 @@ function _tryConvertType(value, target_type) {
 }
 
 /**
- * @description 根据目标类型转换值
+ * 根据目标类型转换值
  * @param {any} value 要转换的值
  * @param {string} target_type 目标类型
  * @returns {any} 转换后的值
@@ -41,32 +36,32 @@ function _tryConvertType(value, target_type) {
  */
 function _convertValueByType(value, target_type) {
   switch (target_type) {
-  case 'number':
+    case 'number':
     // 尝试转换为数字
-    var num = Number(value);
-    return isNaN(num) ? value : num;
+      var num = Number(value);
+      return isNaN(num) ? value : num;
 
-  case 'string':
+    case 'string':
     // 转换为字符串，但对象转字符串视为失败
-    if (typeof value === 'object' && value !== null) {
-      return value; // 对象转字符串失败，返回原值
-    }
-    return String(value);
+      if (typeof value === 'object' && value !== null) {
+        return value; // 对象转字符串失败，返回原值
+      }
+      return String(value);
 
-  case 'boolean':
+    case 'boolean':
     // 转换为布尔值
-    if (value === 'false' || value === '0' || value === 0) {
-      return false;
-    }
-    return Boolean(value);
+      if (value === 'false' || value === '0' || value === 0) {
+        return false;
+      }
+      return Boolean(value);
 
-  default:
+    default:
     // 其他类型无法转换，返回原值
-    return value;
+      return value;
   }
 }
 /**
- * @description 查询对象属性明细
+ * 查询对象属性明细
  * @param {object} obj 目标对象
  * @param {string|Array} prop_path 属性名或路径数组
  * @returns {string} 属性详细信息
@@ -88,7 +83,7 @@ function getInfo(obj, prop_path) {
 }
 
 /**
- * @description 获取基本类型信息
+ * 获取基本类型信息
  * @param {any} obj 目标对象
  * @param {string|Array} prop_path 属性路径
  * @returns {string|null} 基本类型信息或null
@@ -111,7 +106,7 @@ function _getBasicInfo(obj, prop_path) {
 }
 
 /**
- * @description 获取属性路径信息
+ * 获取属性路径信息
  * @param {object} obj 目标对象
  * @param {string|Array} prop_path 属性路径
  * @returns {string} 属性信息
@@ -137,7 +132,7 @@ function _getPropertyInfo(obj, prop_path) {
   return inspect(current, { depth: 1, colors: false });
 }
 /**
- * @description 判断对象是否相似
+ * 判断对象是否相似
  * @param {object} source 被判断对象
  * @param {object} target 用作判断的对象
  * @param {boolean} exact 是否完全相同
@@ -166,7 +161,7 @@ function as(source, target, exact, depth = 0) {
   return processObject(source, target, exact, depth);
 }
 /**
- * @description 处理数组相似性比较
+ * 处理数组相似性比较
  * @param {Array} source_arr 源数组
  * @param {Array} target_arr 目标数组
  * @param {boolean} exact 是否精确匹配
@@ -186,7 +181,7 @@ function processArray(source_arr, target_arr, exact, depth) {
   return true;
 }
 /**
- * @description 处理对象相似性比较
+ * 处理对象相似性比较
  * @param {object} source_obj 源对象
  * @param {object} target_obj 目标对象
  * @param {boolean} exact 是否精确匹配
@@ -206,7 +201,7 @@ function processObject(source_obj, target_obj, exact, depth) {
   return true;
 }
 /**
- * @description 添加对象属性
+ * 添加对象属性
  * @param {object} target 被添加的对象
  * @param {object} source 用作添加的对象
  * @param {boolean} supplement 是否补充没有的对象
@@ -244,7 +239,7 @@ function push(target, source, supplement) {
 }
 
 /**
- * @description 转换值类型
+ * 转换值类型
  * @param {any} target_val 目标值
  * @param {any} source_val 源值
  * @returns {any} 转换后的值
@@ -271,7 +266,7 @@ function convertValue(target_val, source_val) {
 
 
 /**
- * @description 清空对象中的空值属性
+ * 清空对象中的空值属性
  * @param {any} target 目标对象或值
  * @param {boolean} zero 是否清空0值
  * @returns {any} 清空后的对象或值
@@ -310,7 +305,7 @@ function clear(target, zero = false) {
 }
 
 /**
- * @description 判断值是否为空值
+ * 判断值是否为空值
  * @param {any} value 要判断的值
  * @param {boolean} zero 是否将0视为空值
  * @returns {boolean} 是否为空值
@@ -334,7 +329,7 @@ function isEmptyValue(value, zero = false) {
   return false;
 }
 /**
- * @description 转为json字符串
+ * 转为json字符串
  * @param {object} source 被转换的对象
  * @param {boolean} format 是否格式化
  * @returns {string} json格式字符串
@@ -347,7 +342,7 @@ function toJson(source, format) {
   }
 }
 /**
- * @description 将内容转换为CDATA格式
+ * 将内容转换为CDATA格式
  * @param {any} content 要转换的内容
  * @returns {string|any} CDATA格式的字符串或原始内容
  */
@@ -359,7 +354,7 @@ function toCDATA(content) {
   }
 }
 /**
- * @description 转为xml字符串
+ * 转为xml字符串
  * @param {object} source 被转换的对象
  * @param {boolean} format 是否格式化
  * @param {boolean} attributes 是否使用属性格式
@@ -378,23 +373,23 @@ function toXml(source, format, attributes, cdata = false) {
   if (attributes) {
     // 合并属性选项，不覆盖格式化选项
     Object.assign(options, {
-      ignoreAttributes: false,
-      suppressBoolAttrs: false,
-      suppressUnpairedNode: false,
-      processEntities: false // 禁用实体转换
+      ignore_attr: false,
+      suppress_bool_attrs: false,
+      suppress_unpaired: false,
+      process_entities: false // 禁用实体转换
     });
   }
 
   if (cdata) {
     options.cdataPropName = cdata ? '_cdata' : undefined;
-    source = toCDATA({...source});
+    var source_xml = toCDATA({...source});
   }
 
-  const builder = new XMLBuilder(options);
-  return builder.build(source);
+  const builder = new Xml(options);
+  return builder.build(source_xml || source);
 };
 /**
- * @description 转url字符串
+ * 转url字符串
  * @param {object} source 被转换的对象
  * @param {string} base 基础url地址
  * @returns {string} url参数格式字符串
@@ -425,7 +420,7 @@ function toUrl(source, base) {
 };
 
 /**
- * @description 将对象保存为JSON文件
+ * 将对象保存为JSON文件
  * @param {object} source 源对象
  * @param {string|object} target 目标路径或可写流
  * @param {boolean} format 是否格式化
@@ -441,7 +436,7 @@ function saveJson(source, target, format = true) {
   return json_str;
 };
 /**
- * @description 将对象保存为XML文件
+ * 将对象保存为XML文件
  * @param {object} source 源对象
  * @param {string|object} target 目标路径或可写流
  * @param {object} options 选项
@@ -450,8 +445,9 @@ function saveJson(source, target, format = true) {
  * @param {boolean} options.cdata 是否使用CDATA
  * @returns {string} XML字符串
  */
-function saveXml(source, target, options = {}) {
+function saveXml(source, target, _options = {}) {
   // 设置默认选项
+  var options = _options;
   if (typeof options !== 'object' || options === null) {
     options = {};
   }
@@ -470,7 +466,7 @@ function saveXml(source, target, options = {}) {
   return xml_str;
 };
 /**
- * @description 复制对象或值
+ * 复制对象或值
  * @param {any} source 源对象或值
  * @param {boolean} deep 是否深拷贝，默认true
  * @param {number} depth 递归深度，防止无限递归
@@ -503,7 +499,7 @@ function copy(source, deep = true, depth = 0) {
 }
 
 /**
- * @description 复制数组
+ * 复制数组
  * @param {Array} source 源数组
  * @param {boolean} deep 是否深拷贝
  * @param {number} depth 递归深度
@@ -526,7 +522,7 @@ function _copyArray(source, deep, depth) {
 }
 
 /**
- * @description 复制对象
+ * 复制对象
  * @param {object} source 源对象
  * @param {boolean} deep 是否深拷贝
  * @param {number} depth 递归深度
@@ -552,7 +548,7 @@ function _copyObject(source, deep, depth) {
 }
 
 /**
- * @description 获取对象的属性名数组
+ * 获取对象的属性名数组
  * @param {object} source 源对象
  * @param {boolean} include_proto 是否包含原型链属性，默认false
  * @param {boolean} include_private 是否包含私有方法，默认false
@@ -575,7 +571,7 @@ function keys(source, include_proto = false, include_private = false) {
 }
 
 /**
- * @description 收集原型链属性
+ * 收集原型链属性
  * @param {object} source 源对象
  * @param {Array} result 结果数组
  * @param {boolean} include_private 是否包含私有方法
@@ -590,7 +586,7 @@ function _collectProtoKeys(source, result, include_private) {
 }
 
 /**
- * @description 收集自身属性
+ * 收集自身属性
  * @param {object} source 源对象
  * @param {Array} result 结果数组
  * @param {boolean} include_private 是否包含私有方法
@@ -605,7 +601,7 @@ function _collectOwnKeys(source, result, include_private) {
 }
 
 /**
- * @description 判断是否应该包含该键
+ * 判断是否应该包含该键
  * @param {string} key 键名
  * @param {boolean} include_private 是否包含私有方法
  * @returns {boolean} 是否包含
@@ -615,7 +611,7 @@ function _shouldIncludeKey(key, include_private) {
   return include_private || !key.startsWith('_');
 }
 /**
- * @description 添加对象属性
+ * 添加对象属性
  * @param {object} target 目标对象（被添加的对象）
  * @param {object} source 源对象（提供要添加的属性）
  * @param {boolean} overwrite 是否覆盖目标对象，true则修改原对象，false则返回新对象
@@ -644,7 +640,7 @@ function add(target, source, overwrite = true, depth = 0) {
 }
 
 /**
- * @description 添加单个属性
+ * 添加单个属性
  * @param {object} result 结果对象
  * @param {string} key 属性键
  * @param {any} source_val 源值
@@ -672,7 +668,7 @@ function _addProperty(result, key, source_val, options) {
 }
 
 /**
- * @description 判断是否应该进行深层合并
+ * 判断是否应该进行深层合并
  * @param {any} target_val 目标值
  * @param {any} source_val 源值
  * @returns {boolean} 是否应该深层合并
@@ -687,7 +683,7 @@ function _shouldDeepMerge(target_val, source_val) {
 }
 
 /**
- * @description 删除对象属性（ECS组件删除）
+ * 删除对象属性（ECS组件删除）
  * @param {object} target 目标对象
  * @param {string|Array} key_path 组件路径（支持点分隔符或数组）
  * @param {boolean} overwrite 是否覆盖目标对象，true则修改原对象，false则返回新对象
@@ -733,7 +729,7 @@ function del(target, key_path, overwrite = true) {
 
 
 /**
- * @description 修改对象属性
+ * 修改对象属性
  * @param {object} target 目标对象（被修改的对象）
  * @param {object} source 源对象（提供要设置的属性）
  * @param {boolean} overwrite 是否覆盖目标对象，true则修改原对象，false则返回新对象
@@ -762,7 +758,7 @@ function set(target, source, overwrite = true, depth = 0) {
 }
 
 /**
- * @description 设置单个属性
+ * 设置单个属性
  * @param {object} result 结果对象
  * @param {string} key 属性键
  * @param {any} source_val 源值
@@ -797,7 +793,7 @@ function _setProperty(result, key, source_val, options) {
 }
 
 /**
- * @description 设置相同类型的属性
+ * 设置相同类型的属性
  * @param {object} result 结果对象
  * @param {string} key 属性键
  * @param {object} values 值对象
@@ -825,7 +821,7 @@ function _setSameTypeProperty(result, key, values, options) {
 }
 
 /**
- * @description 设置不同类型的属性
+ * 设置不同类型的属性
  * @param {object} result 结果对象
  * @param {string} key 属性键
  * @param {object} values 值对象
@@ -836,19 +832,20 @@ function _setSameTypeProperty(result, key, values, options) {
  */
 function _setDiffTypeProp(result, key, values) {
   // 类型不一致时尝试转换
-  var converted_val = _tryConvertType(values.source_val, values.target_type);
+  var conv_val = _tryConvertType(values.source_val, values.target_type);
 
   // 检查转换后的类型是否与目标类型一致
-  if (typeof converted_val === values.target_type) {
+  if (typeof conv_val === values.target_type) {
     // 转换成功，赋值
-    result[key] = converted_val;
+    result[key] = conv_val;
   }
   // 转换失败时不赋值（保持原值）
 }
 
 /**
- * @description 将数组转换为对象
+ * 将数组转换为对象
  * @param {Array} source 源数组
+ * @param key
  * @returns {object} 转换后的对象
  */
 function arrToObj(source, key = 'key') {
@@ -866,13 +863,13 @@ function arrToObj(source, key = 'key') {
   return result;
 }
 /**
- * @description 查询对象属性
+ * 查询对象属性
  * @param {object} source 对象
  * @param {string|Array} condition 查询条件或路径数组
  * @returns {any} 返回查询结果
  */
 /**
- * @description 获取对象属性（ECS组件获取）
+ * 获取对象属性（ECS组件获取）
  * @param {object} target 目标对象
  * @param {string|Array} key_path 组件路径（支持点分隔符或数组）
  * @param {any} default_val 组件不存在时的默认值
@@ -901,7 +898,7 @@ function get(target, key_path, default_val = undefined, overwrite = true) {
 }
 
 /**
- * @description 解析键路径
+ * 解析键路径
  * @param {string|Array} key_path 键路径
  * @returns {Array|null} 路径数组或null
  * @private
@@ -917,7 +914,7 @@ function _parseKeyPath(key_path) {
 }
 
 /**
- * @description 遍历路径查找值
+ * 遍历路径查找值
  * @param {object} target 目标对象
  * @param {Array} path_arr 路径数组
  * @returns {any} 找到的值或undefined
@@ -938,7 +935,7 @@ function _traversePath(target, path_arr) {
 }
 
 /**
- * @description 处理默认值
+ * 处理默认值
  * @param {object} target 目标对象
  * @param {Array} path_arr 路径数组
  * @param {any} default_val 默认值
@@ -957,7 +954,7 @@ function _handleDefaultValue(target, path_arr, default_val, overwrite) {
 }
 
 /**
- * @description 补全对象路径
+ * 补全对象路径
  * @param {object} target 目标对象
  * @param {Array} path_arr 路径数组
  * @param {object} default_val 默认值对象
@@ -993,7 +990,7 @@ function _completeObjectPath(target, path_arr, default_val, overwrite) {
 }
 
 /**
- * @description 根据路径获取对象属性值
+ * 根据路径获取对象属性值
  * @param {object} source 源对象
  * @param {string|Array} path 属性路径
  * @returns {any} 属性值
@@ -1015,7 +1012,7 @@ function prop(source, path) {
   return result;
 }
 /**
- * @description 将对象转换为数组
+ * 将对象转换为数组
  * @param {object} source 源对象
  * @param {string} key 键名
  * @returns {Array} 转换后的数组
@@ -1034,7 +1031,7 @@ function objToArr(source, key = 'key') {
   return result;
 }
 /**
- * @description 数值增减操作
+ * 数值增减操作
  * @param {object} source 源对象
  * @param {string} key 属性键名
  * @param {number} value 增减值

package/lib/req.js

@@ -11,18 +11,18 @@ class Req extends Base {
      * @type {string}
      * @default "sys"
      */
-    scope: "sys",
+    scope: 'sys',
     /**
      * 响应格式
      * @type {string} "json-rpc" | "json-rpc3" | "restful"
      * @default "json-rpc"
      */
-    format: "json-rpc"
+    format: 'json-rpc'
   };
   /**
    * 构造函数
-   * @constructor
-   * @param {Object} config 配置项
+   * @class
+   * @param {object} config 配置项
    */
   constructor(config) {
     super(config);
@@ -43,16 +43,16 @@ Req.prototype.genId = function () {
  * 发送请求
  * @param {string} method 方法名
  * @param {...any} args 参数
- * @returns {Object} 发送的JSON格式
+ * @returns {object} 发送的JSON格式
  */
 Req.prototype.send = function (method, ...args) {
   if (this._methods[method]) {
     return this._methods[method](...args);
   }
-  else if (this.config.format === "json-rpc") {
+  else if (this.config.format === 'json-rpc') {
     return this._sendJsonRPC(method, args);
   }
-  else if (this.config.format === "json-rpc3") {
+  else if (this.config.format === 'json-rpc3') {
     return this._sendJsonRPC3(method, ...args);
   }
   else {
@@ -65,7 +65,7 @@ Req.prototype.send = function (method, ...args) {
  * @param {string} method 方法名
  * @param {Array} params 参数数组
  * @param {string} [id] 请求ID
- * @returns {Object} JSON-RPC 2.0格式
+ * @returns {object} JSON-RPC 2.0格式
  */
 Req.prototype._sendJsonRPC = function (method, params, id) {
   return {
@@ -73,16 +73,16 @@ Req.prototype._sendJsonRPC = function (method, params, id) {
     method,
     params
   };
-}
+};
 
 /**
  * 发送JSON-RPC 3.0请求
  * @param {string} method 方法名
- * @param {Object} [query] 查询参数
- * @param {Object} [body] 请求体
+ * @param {object} [query] 查询参数
+ * @param {object} [body] 请求体
  * @param {Array} [meta] 元数据数组
  * @param {string} [id] 请求ID
- * @returns {Object} JSON-RPC 3.0格式
+ * @returns {object} JSON-RPC 3.0格式
  */
 Req.prototype._sendJsonRPC3 = function (method, query, body, meta, id) {
   return {
@@ -94,16 +94,16 @@ Req.prototype._sendJsonRPC3 = function (method, query, body, meta, id) {
       meta: meta || []
     }
   };
-}
+};
 
 /**
  * 发送RESTful请求
  * @param {string} method 方法名
- * @param {Object} [query] 查询参数
- * @param {Object} [body] 请求体
+ * @param {object} [query] 查询参数
+ * @param {object} [body] 请求体
  * @param {Array} [meta] 元数据数组
  * @param {string} [id] 请求ID
- * @returns {Object} RESTful格式
+ * @returns {object} RESTful格式
  */
 Req.prototype._sendRESTful = function (method, query, body, meta, id) {
   return {
@@ -113,16 +113,16 @@ Req.prototype._sendRESTful = function (method, query, body, meta, id) {
     body: body || {},
     meta: meta || []
   };
-}
+};
 
 /**
  * 解析请求
- * @param {Object} req 请求对象
- * @returns {Object} 解析后的对象
+ * @param {object} req 请求对象
+ * @returns {object} 解析后的对象
  */
 Req.prototype.parse = function (req) {
-  const id = req.id;
-  const method = req.method;
+  let id = req.id;
+  let method = req.method;
   let params = [];
 
   if (req.params) {
@@ -130,14 +130,14 @@ Req.prototype.parse = function (req) {
       params = req.params;
     }
     else {
-      if (typeof req.params === "object") {
-        let ctx = Object.assign({}, req.params);
+      if (typeof req.params === 'object') {
+        let ctx = { ...req.params};
         if (ctx.query || ctx.body) {
           params.push(ctx.query || null);
           params.push(ctx.body || null);
           delete ctx.query;
           delete ctx.body;
-          for (const key in ctx) {
+          for (let key in ctx) {
             params.push(ctx[key]);
           }
         }
@@ -159,25 +159,25 @@ Req.prototype.parse = function (req) {
       params.push(req.meta || null);
     }
   }
-  if (this.config.format === "json-rpc") {
+  if (this.config.format === 'json-rpc') {
     if (req.params) {
       params = req.params;
     }
   }
-  else if (this.config.format === "json-rpc3") {
+  else if (this.config.format === 'json-rpc3') {
     var pm = {};
     pm.query = params.length > 0 ? params[0] || null : null;
     pm.body = params.length > 1 ? params[1] || null : null;
     pm.meta = params.length > 2 ? params[2] || null : null;
     params = pm;
   }
-  else if (this.config.format === "restful") {
+  else if (this.config.format === 'restful') {
     var ret = {
       id,
       method,
       query: params.length > 0 ? params[0] || null : null,
       body: params.length > 1 ? params[1] || null : null
-    }
+    };
     if (params.length > 2) {
       ret.meta = params[2];
     }
@@ -188,7 +188,7 @@ Req.prototype.parse = function (req) {
     method,
     params
   };
-}
+};
 
 /**
  * 设置自定义方法
@@ -196,8 +196,8 @@ Req.prototype.parse = function (req) {
  * @param {Function} func 处理方法
  */
 Req.prototype.setMethod = function (method, func) {
-  if (typeof func !== "function") {
-    throw new Error("func必须是一个函数类型");
+  if (typeof func !== 'function') {
+    throw new Error('func必须是一个函数类型');
   }
   this._methods[method] = func;
 };
@@ -221,7 +221,7 @@ Req.prototype.getMethod = function (method) {
 
 /**
  * 获取所有自定义方法
- * @returns {Object} 所有自定义方法
+ * @returns {object} 所有自定义方法
  */
 Req.prototype.getMethods = function () {
   return this._methods;
@@ -231,15 +231,15 @@ Req.prototype.getMethods = function () {
  * 运行自定义方法
  * @param {string} method 方法名
  * @param {Array} params 参数数组
- * @returns {Object} 处理结果
+ * @returns {object} 处理结果
  */
 Req.prototype.run = function (method, params) {
-  const func = this._methods[method];
+  let func = this._methods[method];
   if (func) {
     return func.apply(this, params);
   }
   else {
-    throw new Error("方法不存在");
+    throw new Error('方法不存在');
   }
 };
 
@@ -249,16 +249,16 @@ Req.prototype.run = function (method, params) {
  */
 Req.prototype.setFormat = function (format) {
   switch (format?.toLowerCase()) {
-    case "json":
-    case "json-rpc":
-      this.config.format = "json-rpc";
+    case 'json':
+    case 'json-rpc':
+      this.config.format = 'json-rpc';
       break;
-    case "json3":
-    case "json-rpc3":
-      this.config.format = "json-rpc3";
+    case 'json3':
+    case 'json-rpc3':
+      this.config.format = 'json-rpc3';
       break;
     default:
-      this.config.format = "restful";
+      this.config.format = 'restful';
       break;
   }
 };