mm_effect 0.0.0-stage → 1.0.1

package/README.md

@@ -1,3 +1,15 @@
-# Temporary Holding Version
+# 副作用（mm_effect）
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+## 说明
+
+mm_effect 是副作用管理模块，提供副作用的注册与管理能力。
+
+## 安装
+
+```bash
+npm install mm_effect
+```
+
+## 状态
+
+模块骨架已创建，功能开发中。

package/index.js

@@ -0,0 +1,32 @@
+'use strict';
+
+const Effect = require('./lib/effect');
+
+/**
+ * 作用域实例表
+ * @type {Map<string, Effect>}
+ */
+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 = {
+  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,6 +1,26 @@
 {
-  "name": "mm_effect",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+    "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

@@ -0,0 +1,30 @@
+'use strict';
+
+const assert = require('assert');
+const mod = require('./index.js');
+
+// 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, {}, '默认配置应为空对象');
+
+// 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');