mm_effect 1.0.0 → 1.0.1

package/index.js

@@ -1,18 +1,32 @@
 'use strict';
 
+const Effect = require('./lib/effect');
+
 /**
- * SideEffect —— 副作用管理模块。
- *
- * 骨架已就绪：构造时接收配置对象，具体功能待开发。
+ * 作用域实例表
+ * @type {Map<string, Effect>}
  */
-class SideEffect {
-  /**
-   * 构造函数
-   * @param {Object} [config] 模块配置
-   */
-  constructor(config = {}) {
-    this.config = config;
+const effects = new Map();
+
+/**
+ * 获取指定作用域的副作用管理器实例，不存在时创建
+ * @param {string} [scope] 作用域名称，缺省时使用 os
+ * @param {Object} [config] 副作用配置项
+ * @returns {Effect} 副作用实例
+ */
+function effectAdmin(scope, config) {
+  if (!scope) {
+    scope = 'os';
+  }
+  let effect = effects.get(scope);
+  if (!effect) {
+    effect = new Effect(config);
+    effects.set(scope, effect);
   }
+  return effect;
 }
 
-module.exports = SideEffect;
+module.exports = {
+  Effect,
+  effectAdmin
+};

package/lib/effect.js

@@ -0,0 +1,18 @@
+'use strict';
+
+/**
+ * Effect —— 副作用管理模块。
+ *
+ * 骨架已就绪：构造时接收配置对象，具体功能待开发。
+ */
+class Effect {
+  /**
+   * 构造函数
+   * @param {Object} [config] 模块配置
+   */
+  constructor(config = {}) {
+    this.config = config;
+  }
+}
+
+module.exports = Effect;

package/package.json

@@ -1,26 +1,26 @@
 {
-  "name": "mm_effect",
-  "version": "1.0.0",
-  "description": "副作用管理模块：提供副作用的注册与管理能力",
-  "main": "index.js",
-  "repository": {
-    "type": "git",
-    "url": "git+https://gitee.com/qiuwenwu91/mm_effect.git"
-  },
-  "keywords": [
-    "mm_mod",
-    "mm_infra",
-    "side_effect",
-    "副作用"
-  ],
-  "layer": "infra",
-  "group": "common",
-  "author": "邱文武",
-  "license": "ISC",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "scripts": {
-    "test": "node test.js"
-  }
-}
+    "name": "mm_effect",
+    "version": "1.0.1",
+    "description": "副作用管理模块：提供副作用的注册与管理能力",
+    "main": "index.js",
+    "repository": {
+        "type": "git",
+        "url": "git+https://gitee.com/qiuwenwu91/mm_effect.git"
+    },
+    "keywords": [
+        "mm_mod",
+        "mm_infra",
+        "side_effect",
+        "副作用"
+    ],
+    "layer": "infra",
+    "group": "common",
+    "author": "邱文武",
+    "license": "ISC",
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "scripts": {
+        "test": "node test.js"
+    }
+}

package/test.js

@@ -1,10 +1,30 @@
 'use strict';
 
 const assert = require('assert');
-const SideEffect = require('./index.js');
+const mod = require('./index.js');
 
-const instance = new SideEffect();
-assert.ok(instance instanceof SideEffect, 'instance 应为 SideEffect 实例');
+// 1. 导出结构校验
+assert.strictEqual(typeof mod.Effect, 'function', '应导出 Effect 类');
+assert.strictEqual(typeof mod.effectAdmin, 'function', '应导出 effectAdmin 函数');
+
+const { Effect } = mod;
+
+// 2. 实例化与默认配置
+const instance = new Effect();
+assert.ok(instance instanceof Effect, 'instance 应为 Effect 实例');
 assert.deepStrictEqual(instance.config, {}, '默认配置应为空对象');
 
-console.log('mm_side_effect test passed');
+// 3. 传入配置
+const configured = new Effect({ async: true });
+assert.deepStrictEqual(configured.config, { async: true }, '应保存传入的配置');
+
+// 4. 工厂函数：同作用域返回同一实例
+const scoped = mod.effectAdmin('test');
+assert.ok(scoped instanceof Effect, 'effectAdmin 应返回 Effect 实例');
+assert.strictEqual(mod.effectAdmin('test'), scoped, '同作用域应返回同一实例');
+
+// 5. 缺省作用域为 os
+assert.ok(mod.effectAdmin() instanceof Effect, '缺省作用域应返回 Effect 实例');
+assert.strictEqual(mod.effectAdmin(), mod.effectAdmin('os'), '缺省作用域应与 os 一致');
+
+console.log('mm_effect test passed');