mm_func 1.0.1 → 1.2.0

package/README.md

@@ -37,7 +37,7 @@ func.delFunc('list', 'makeStatic');
 func.clear('list'); // 清空指定函数
 func.clear();       // 清空全部
 
-// 通过 Admin 工厂按作用域取实例（需安装 mm_corejs）
+// 通过 Admin 工厂按作用域取实例（需安装 mm_admin）
 var admin = funcAdmin('os', { /* config */ });
 ```
 

package/index.js

@@ -1,27 +1,17 @@
 const Func = require('./lib/func');
-let Admin = null;
-try {
-  Admin = require('mm_corejs').Admin;
-} catch (e) {
-  // mm_corejs 未安装时仅提供核心类，Admin 工厂不可用
-}
+const { reg } = require('mm_admin');
 
-let admin = null;
-if (Admin) {
-  admin = new Admin();
-  admin.setClass(Func);
-}
+const admin = reg('mm_func');
+admin.setClass(Func);
 
 module.exports = {
   Func,
   admin,
   funcAdmin(scope, config = {}) {
-    if (!admin) {
-      throw new Error('mm_func: mm_corejs 未安装，Admin 工厂不可用');
-    }
-    if (!scope) {
-      scope = 'os';
-    }
-    return admin.get(scope, config);
+    return admin.get(scope || 'os', config);
   }
 };
+
+/* mm-tool-logic-export 工具能力层：其它模块可 require("<pkg>").tools.<name> 直接引用 */
+Object.defineProperty(module.exports, 'tools', { enumerable: true, configurable: true,
+  get: function () { return require('./lib/tools'); } });

package/lib/tools/function/index.js

@@ -0,0 +1,41 @@
+/**
+ * 函数调用器
+ * 调用 mm_func 全局作用域（funcAdmin('os')）中注册的具名函数
+ */
+const { funcAdmin } = require('../../../index.js');
+
+async function main(params, ctx, options) {
+  const func_name = params.function || '';
+  const args = params.args || [];
+
+  if (!func_name) {
+    ctx.output = {
+      error: {
+        code: 'EXEC_MISSING_PARAM',
+        message: '函数名不能为空'
+      }
+    };
+    return ctx.output;
+  }
+
+  var func_store = funcAdmin('os');
+  if (!func_store.hasFunc(func_name)) {
+    ctx.output = {
+      error: {
+        code: 'EXEC_NOT_FOUND',
+        message: '函数 ' + func_name + ' 未找到'
+      }
+    };
+    return ctx.output;
+  }
+
+  const result = await func_store.runFunc(func_name, ...args);
+
+  ctx.output = {
+    msg: '函数执行完成',
+    output: result
+  };
+  return ctx.output;
+}
+
+module.exports = { main };

package/lib/tools/index.js

@@ -0,0 +1,16 @@
+'use strict';
+const fs = require('fs');
+const path = require('path');
+/** 模块能力层：懒加载工具实现，避免模块入口被 require 时加载全部实现 */
+module.exports = new Proxy({}, {
+  get(_t, key) {
+    if (typeof key !== 'string') return undefined;
+    if (!fs.existsSync(path.join(__dirname, key, 'index.js'))) return undefined;
+    return require('./' + key);
+  },
+  has(_t, key) {
+    return typeof key === 'string' && fs.existsSync(path.join(__dirname, key, 'index.js'));
+  },
+  ownKeys() { return fs.readdirSync(__dirname, { withFileTypes: true }).filter(e => e.isDirectory()).map(e => e.name); },
+  getOwnPropertyDescriptor(_t, key) { return this.has(_t, key) ? { enumerable: true, configurable: true } : undefined; }
+});

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mm_func",
-    "version": "1.0.1",
+    "version": "1.2.0",
     "description": "函数钩子管理模块：提供函数钩子 addFunc/delFunc/runFunc 的注册与按名执行能力",
     "main": "index.js",
     "repository": {
@@ -14,8 +14,8 @@
         "hook",
         "函数"
     ],
-    "layer": "infra",
-    "group": "common",
+    "layer": "shared",
+    "group": "hooks",
     "author": "邱文武",
     "license": "ISC",
     "engines": {
@@ -25,6 +25,6 @@
         "test": "node test.js"
     },
     "dependencies": {
-        "mm_corejs": "^1.1.6"
+        "mm_admin": "^1.1.0"
     }
 }

package/test.js

@@ -2,7 +2,7 @@
 
 const assert = require('assert');
 const mod = require('./index.js');
-const Func = require('./lib/func');
+const Func = require('./lib/func.js');
 
 // 1. 导出结构校验
 assert.strictEqual(typeof mod.Func, 'function', '应导出 Func 类');

package/tool/function/index.js

@@ -0,0 +1,7 @@
+'use strict';
+/**
+ * function —— 工具契约适配层
+ * 业务实现归位于模块 lib/tools/function/，本文件只把模块能力暴露给加载器。
+ * 其它模块可直接 require('mm_func').tools.function 复用。
+ */
+module.exports = require('../../lib/tools/function');

package/tool/function/tool.json

@@ -0,0 +1,52 @@
+{
+  "name": "function",
+  "handler": "executor",
+  "title": "函数调用器",
+  "description": "调用全局注册函数 global.$[funcName]，支持传入参数数组。适用场景：需要复用全局函数、避免重复实现公共逻辑时。工作流提示：function 必填指定全局函数名，args 按序传参数数组，函数返回值在 output。",
+  "type": "core",
+  "params": {
+    "type": "object",
+    "properties": {
+      "function": {
+        "type": "string",
+        "description": "全局函数名"
+      },
+      "args": {
+        "type": "array",
+        "description": "传入函数的参数数组"
+      }
+    },
+    "required": [
+      "function"
+    ]
+  },
+  "returns": {
+    "type": "object",
+    "description": "返回执行结果，正常时包含 msg 和函数输出，异常时包含 error",
+    "properties": {
+      "msg": {
+        "type": "string",
+        "description": "函数执行完成"
+      },
+      "output": {
+        "description": "函数调用返回值"
+      },
+      "error": {
+        "type": "object",
+        "description": "错误信息，仅调用出错时返回",
+        "properties": {
+          "code": {
+            "type": "string",
+            "description": "错误码 (EXEC_ 前缀)"
+          },
+          "message": {
+            "type": "string",
+            "description": "错误描述"
+          }
+        }
+      }
+    }
+  },
+  "options": {},
+  "group": "core"
+}