mm_func 1.0.0 → 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 */ });
 ```
 
@@ -47,6 +47,7 @@ var admin = funcAdmin('os', { /* config */ });
 | --- | --- |
 | `addFunc(name, func, sort = 100, alias = '')` | 添加函数钩子，返回别名 |
 | `delFunc(name, alias = '')` | 删除函数钩子，别名省略时清空该名称下全部 |
+| `getFunc(name)` | 获取第一个函数体，未注册时返回 undefined |
 | `hasFunc(name)` | 判断函数是否存在 |
 | `listFuncs(name)` | 列出函数名称（省略 name）或函数项列表 |
 | `runFunc(name, ...args)` | 异步按序执行，支持 Promise，返回最后一个真值 |

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/func.js

@@ -110,6 +110,16 @@ class Func {
     return removed;
   }
 
+  /**
+   * 获取函数
+   * @param {string} name - 函数名称
+   * @returns {Function|undefined} 第一个函数体；未注册时为 undefined
+   */
+  getFunc(name) {
+    var arr = this._methods[name];
+    return arr && arr.length ? arr[0].func : undefined;
+  }
+
   /**
    * 判断函数是否存在
    * @param {string} name - 函数名称

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.0",
+    "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 类');
@@ -28,7 +28,14 @@ async function test() {
   assert.strictEqual(await func.runFunc('none'), undefined);
   console.log('√ 未注册返回 undefined');
 
-  // 4. 别名：具名函数自动取函数名
+  // 4. getFunc：取函数体
+  var got = func.getFunc('list');
+  assert.strictEqual(typeof got, 'function');
+  assert.strictEqual(got.name, 'makeList');
+  assert.strictEqual(func.getFunc('none'), undefined);
+  console.log('√ getFunc 取函数体');
+
+  // 5. 别名：具名函数自动取函数名
   var func2 = new Func();
   var alias = func2.addFunc('test', function myFunc() {});
   assert.strictEqual(alias, 'myFunc');

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"
+}