mm_datas 5.3.0 → 5.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -5,7 +5,7 @@
5
5
  * model.schema 是一份标准 JSON Schema(draft-07 子集):
6
6
  * { $schema, type:'object', properties:{...}, required:[...], additionalProperties:false }
7
7
  * 类型只用 string / number / boolean / object / array / null,不出现 int / integer。
8
- * 规则判定全部委托 mm_validator,mm_data 只负责关键词翻译与错误路径。
8
+ * 规则判定全部委托 mm_validator,mm_datas 只负责关键词翻译与错误路径。
9
9
  *
10
10
  * 运行:node example/custom_demo.js
11
11
  */
@@ -3,13 +3,13 @@
3
3
  * 可选演示:显式加载示例 RPG 模型集
4
4
  *
5
5
  * 这 15 个 JSON 只是「使用者提供的一份集合定义」的样例,
6
- * mm_data 默认不会加载它们;换成自己的目录、自己的表即可。
6
+ * mm_datas 默认不会加载它们;换成自己的目录、自己的表即可。
7
7
  * 每个模型的 schema 都是标准 JSON Schema(draft-07 子集),类型只用 number,不含 int/integer。
8
8
  * 运行:node example/preset_demo.js
9
9
  */
10
10
  const mm = require('../index.js');
11
11
 
12
- // 独立命名空间,不污染默认池 reg('mm_data')
12
+ // 独立命名空间,不污染默认池 reg('mm_datas')
13
13
  const pool = mm.createPool('rpg_preset', { models: mm.EXAMPLE_MODEL_DIR });
14
14
  const reg = mm.dataAdmin.registry(pool);
15
15
 
package/index.js CHANGED
@@ -1,8 +1,8 @@
1
1
  'use strict';
2
2
  /**
3
- * mm_data —— 基于 mm_admin 实例池的通用数据管理模块
3
+ * mm_datas —— 基于 mm_admin 实例池的通用数据管理模块
4
4
  *
5
- * const { dataAdmin, DataManager } = require('mm_data');
5
+ * const { dataAdmin, DataManager } = require('mm_datas');
6
6
  *
7
7
  * const role = dataAdmin('role'); // mm_admin 池按名字缓存的 DataManager 实例
8
8
  * role instanceof DataManager; // true,role 就是「角色数据集合」
package/lib/backend.js CHANGED
@@ -1,7 +1,7 @@
1
1
  'use strict';
2
2
 
3
3
  /**
4
- * mm_data 的外部访问层与持久化布局
4
+ * mm_datas 的外部访问层与持久化布局
5
5
  *
6
6
  * 约定(v5):
7
7
  * - 模型文件统一命名为 <集合名>_model.json;扫描到几个这样的文件,就创建几种集合。
@@ -19,7 +19,7 @@
19
19
  * scope 按「命名空间 + 用途」隔离(文件层再叠加目录),避免多池复用同一实例。
20
20
  *
21
21
  * 依赖都是「可选增强」:require 不到、连接失败、或默认未启用时一律降级,
22
- * mm_data 的同步 CRUD 永远可用。只有显式的异步入口(connect / flush / restore /
22
+ * mm_datas 的同步 CRUD 永远可用。只有显式的异步入口(connect / flush / restore /
23
23
  * cacheGet / cacheList)才会真正调用它们。
24
24
  */
25
25
  const fs = require('fs');
@@ -101,7 +101,7 @@ function withTimeout(promise, ms, fallback) {
101
101
  class JsonDbLayout {
102
102
  constructor(dir, namespace) {
103
103
  this.dir = dir || path.join(process.cwd(), 'data');
104
- this.namespace = namespace || 'mm_data';
104
+ this.namespace = namespace || 'mm_datas';
105
105
  this.mod = MODULES.mm_jsondb;
106
106
  this.reason = '';
107
107
  this.factory = 'jsondbAdmin';
@@ -112,7 +112,7 @@ class JsonDbLayout {
112
112
  _scope() {
113
113
  const key = this.namespace + '|' + this.dir;
114
114
  const hash = crypto.createHash('sha1').update(key).digest('hex').slice(0, 16);
115
- return 'mm_data:jsondb:' + hash;
115
+ return 'mm_datas:jsondb:' + hash;
116
116
  }
117
117
 
118
118
  _bind(dir) {
@@ -317,7 +317,7 @@ const RowFileLayout = JsonDbLayout;
317
317
  class CacheAdapter {
318
318
  constructor(config) {
319
319
  this.name = 'mm_cache';
320
- this.config = Object.assign({ scope: 'mm_data', way: 'memory', ttl: 0 }, config || {});
320
+ this.config = Object.assign({ scope: 'mm_datas', way: 'memory', ttl: 0 }, config || {});
321
321
  this.mod = MODULES.mm_cache;
322
322
  this.installed = !!this.mod;
323
323
  this.enabled = !!(config && config.enabled !== false);
@@ -412,8 +412,8 @@ class MongoAdapter {
412
412
  constructor(config) {
413
413
  this.name = 'mm_mongodb';
414
414
  this.config = Object.assign({
415
- scope: 'mm_data', host: '127.0.0.1', port: 27017,
416
- database: 'mm_data', table: 'mm_data_rows'
415
+ scope: 'mm_datas', host: '127.0.0.1', port: 27017,
416
+ database: 'mm_datas', table: 'mm_datas_rows'
417
417
  }, config || {});
418
418
  this.mod = MODULES.mm_mongodb;
419
419
  this.installed = !!this.mod;
@@ -488,7 +488,7 @@ class SqlAdapter {
488
488
  this.name = 'mm_sql';
489
489
  this.config = Object.assign({
490
490
  db_type: 'sqlite',
491
- sqlite: { dir: path.join(process.cwd(), 'data', '_sql'), database: 'mm_data' }
491
+ sqlite: { dir: path.join(process.cwd(), 'data', '_sql'), database: 'mm_datas' }
492
492
  }, config || {});
493
493
  this.mod = MODULES.mm_sql;
494
494
  this.installed = !!this.mod;
@@ -565,7 +565,7 @@ function createAdapters(config) {
565
565
  config = config || {};
566
566
  // 每个实例池用独立 scope:mm_admin 会按 scope 复用实例,
567
567
  // 否则多个池共用同一个 Cache 客户端,connect() 里的 dispose() 会互相影响
568
- const ns = 'mm_data:' + (config.namespace || 'default');
568
+ const ns = 'mm_datas:' + (config.namespace || 'default');
569
569
  return {
570
570
  cache: new CacheAdapter(Object.assign({ scope: ns }, config.cache || {})),
571
571
  mongo: new MongoAdapter(Object.assign({ scope: ns }, config.mongodb || config.mangodb || {})),
package/lib/manager.js CHANGED
@@ -3,7 +3,7 @@
3
3
  /**
4
4
  * DataManager —— 管理数据类(mm_data 的唯一管理类)
5
5
  *
6
- * 由 mm_admin 实例池 reg('mm_data').get(name) 创建/缓存,一个实例 = 一个具名数据集合:
6
+ * 由 mm_admin 实例池 reg('mm_datas').get(name) 创建/缓存,一个实例 = 一个具名数据集合:
7
7
  * const role = dataAdmin('role'); // role.name === 'role',就是「角色数据集合」
8
8
  *
9
9
  * 所有实例通过 mm_admin 的 setServer 共享同一个 store(含 models / seq / tables),
@@ -94,7 +94,7 @@ class DataManager {
94
94
  this._store = server || this.config.store || S.createStore('memory', {});
95
95
  if (!this._store.models) this._store.models = new Map();
96
96
  if (!this._store.seq) this._store.seq = new Map();
97
- this._namespace = this.config.namespace || 'mm_data';
97
+ this._namespace = this.config.namespace || 'mm_datas';
98
98
 
99
99
  const def = this.config.def;
100
100
  if (!this._store.models.has(this.name)) {
package/lib/pool.js CHANGED
@@ -4,7 +4,7 @@
4
4
  * 基于 mm_admin 的实例池封装
5
5
  *
6
6
  * 范式与 mm_dao / mm_store 一致:
7
- * const pool = reg('mm_data'); // 全局注册表里唯一的管理器池
7
+ * const pool = reg('mm_datas'); // 全局注册表里唯一的管理器池
8
8
  * pool.setClass(DataManager); // 绑定本模块的管理数据类
9
9
  * pool.setServer(sharedStore); // 注入共享存储(所有集合共用)
10
10
  * pool.get('role', config) // 按名字缓存 DataManager 实例
@@ -18,7 +18,7 @@ const B = require('./backend.js');
18
18
  const mm = require('mm_admin');
19
19
  const { DataManager, EXAMPLE_MODEL_DIR } = require('./manager.js');
20
20
 
21
- const DEFAULT_NAMESPACE = 'mm_data';
21
+ const DEFAULT_NAMESPACE = 'mm_datas';
22
22
  let _current = null;
23
23
  let _resetSeq = 0;
24
24
 
@@ -100,7 +100,7 @@ function poolData(pool, name, def) {
100
100
 
101
101
  /**
102
102
  * 创建(或取得)一个具名实例池。不同 namespace 之间数据完全隔离。
103
- * @param {string} [namespace] 池名,缺省 'mm_data'
103
+ * @param {string} [namespace] 池名,缺省 'mm_datas'
104
104
  * @param {object} [config] { store, dir, autoSave, persist, flush_interval, models }
105
105
  */
106
106
  function createPool(namespace, config) {
package/lib/store.js CHANGED
@@ -262,7 +262,7 @@ class HybridStore extends MemoryStore {
262
262
  this.persist = config.persist !== false;
263
263
  this.autoSave = !!config.autoSave;
264
264
  this.flush_interval = Math.max(0, Number(config.flush_interval) || 0);
265
- this.namespace = config.namespace || 'mm_data';
265
+ this.namespace = config.namespace || 'mm_datas';
266
266
  // 文件层也走 jsondbAdmin 实例池,scope 需带上命名空间与目录
267
267
  this.layout = new B.RowFileLayout(this.dir, this.namespace);
268
268
  this.adapters = B.createAdapters(config);
package/package.json CHANGED
@@ -1,16 +1,16 @@
1
1
  {
2
2
  "name": "mm_datas",
3
- "version": "5.3.0",
3
+ "version": "5.3.1",
4
4
  "description": "基于 mm_admin 实例池的通用数据管理模块:*_model.json 决定集合,标准 JSON Schema(draft-07 子集,禁用 int/integer)由 mm_validator 校验;静态数据经 mm_jsondb 的 Store 文件层(pad:6 由模块自身补零)按 data/<集合>/000001.json 逐条落盘,动态数据走 mm_cache 缓存 + mm_mongodb 持久,mm_sql 作为可选数据源适配器;四个依赖统一经 jsondbAdmin/cacheAdmin/mongodbAdmin/sqlAdmin 获取;工具参数契约采用 OpenAI function calling 的 parameters 格式",
5
5
 
6
6
  "main": "index.js",
7
7
  "repository": {
8
8
  "type": "git",
9
- "url": "git+https://gitee.com/qiuwenwu91/mm_data.git"
9
+ "url": "git+https://gitee.com/qiuwenwu91/mm_datas.git"
10
10
  },
11
11
  "keywords": [
12
12
  "mm_mod",
13
- "mm_data",
13
+ "mm_datas",
14
14
  "mm_admin",
15
15
  "mm_validator",
16
16
  "DataManager",
package/test.js CHANGED
@@ -1,6 +1,6 @@
1
1
  'use strict';
2
2
  /**
3
- * mm_data 测试:mm_admin 实例池 + DataManager + 标准 JSON Schema(禁用 int/integer)
3
+ * mm_datas 测试:mm_admin 实例池 + DataManager + 标准 JSON Schema(禁用 int/integer)
4
4
  * 规则判定委托 mm_validator。运行:node test.js
5
5
  */
6
6
  const fs = require('fs');
@@ -52,7 +52,7 @@ async function run() {
52
52
  ok('dataAdmin() 返回 mm_admin 的 Admin 实例', mm.dataAdmin() instanceof mm.Admin);
53
53
  ok('池绑定了 DataManager 类', mm.dataAdmin().getClass() === mm.DataManager);
54
54
  ok('池通过 setServer 注入共享 store', !!mm.dataAdmin().getServer().models);
55
- ok('mm_admin 全局注册表里有 mm_data', mm.list().indexOf('mm_data') > -1);
55
+ ok('mm_admin 全局注册表里有 mm_datas', mm.list().indexOf('mm_datas') > -1);
56
56
  eq('初始注册表为空', mm.dataAdmin.registry().models().length, 0);
57
57
 
58
58
  const role = mm.dataAdmin('role');
@@ -704,7 +704,7 @@ async function run() {
704
704
  eq('文件层经 jsondbAdmin', b5.file_layer.factory, 'jsondbAdmin');
705
705
  eq('注入客户端不冒充 mongodbAdmin', b5.adapters.mongodb.factory, 'injected-client');
706
706
  eq('未注入时 mongodb 声明 mongodbAdmin',
707
- new B.MongoAdapter({ scope: 'mm_data:mongo_scope_probe' }).status().factory, 'mongodbAdmin');
707
+ new B.MongoAdapter({ scope: 'mm_datas:mongo_scope_probe' }).status().factory, 'mongodbAdmin');
708
708
 
709
709
  // 池返回的实例与 xxxAdmin 直接取到的是同一个对象,证明确实经 mm_admin 实例池
710
710
  ok('cacheAdmin 同一实例',
@@ -712,7 +712,7 @@ async function run() {
712
712
  ok('jsondbAdmin 同一实例',
713
713
  jsondbAdmin(jl._scope(), { dir: v5dir, database: '.', pad: 6 }) === jl.db);
714
714
 
715
- const sqlScope = 'mm_data:sqladmin_probe';
715
+ const sqlScope = 'mm_datas:sqladmin_probe';
716
716
  const sa = new B.SqlAdapter({
717
717
  enabled: true, scope: sqlScope, db_type: 'sqlite',
718
718
  sqlite: { dir: path.join(os.tmpdir(), 'mm_data_sqladmin_probe'), database: 'p' }
@@ -2,7 +2,7 @@
2
2
  "name": "data",
3
3
  "handler": "manager",
4
4
  "title": "通用数据集合管理器(DataManager)",
5
- "description": "基于 mm_admin 实例池:model 填任意集合名,取得的就是该集合的 DataManager 实例,同名复用。集合名、字段、主键、静态/动态、关联由调用方自定义;model schema 是标准 JSON Schema(draft-07 子集:$schema/type:object/properties/required/additionalProperties,字段用 type/required/enum/const/minimum/maximum/minLength/maxLength/minItems/maxItems/pattern/items/properties),类型只允许 string/number/boolean/object/array/null,禁止 int/integer(整数一律用 number)。规则判定全部委托 mm_validator,mm_data 只做关键词翻译与错误路径归一化;action=validator 可查询校验器与类型白名单。读在 obj / list+count,写在 msg+affected/id,异常返回 error。工具参数 parameters 采用 OpenAI function calling 标准格式(type:object + properties + required),type 为工作流通道 data,可由 getFunctionTool() 导出标准 function 工具定义直接注册给 LLM。工作流提示:action 选 get/list/add/set/del,query 传条件或主键值,body 传写入数据,with 传关联名;先 define/field/ref 声明结构再写入;validate 可只校验不写入。",
5
+ "description": "基于 mm_admin 实例池:model 填任意集合名,取得的就是该集合的 DataManager 实例,同名复用。集合名、字段、主键、静态/动态、关联由调用方自定义;model schema 是标准 JSON Schema(draft-07 子集:$schema/type:object/properties/required/additionalProperties,字段用 type/required/enum/const/minimum/maximum/minLength/maxLength/minItems/maxItems/pattern/items/properties),类型只允许 string/number/boolean/object/array/null,禁止 int/integer(整数一律用 number)。规则判定全部委托 mm_validator,mm_datas 只做关键词翻译与错误路径归一化;action=validator 可查询校验器与类型白名单。读在 obj / list+count,写在 msg+affected/id,异常返回 error。工具参数 parameters 采用 OpenAI function calling 标准格式(type:object + properties + required),type 为工作流通道 data,可由 getFunctionTool() 导出标准 function 工具定义直接注册给 LLM。工作流提示:action 选 get/list/add/set/del,query 传条件或主键值,body 传写入数据,with 传关联名;先 define/field/ref 声明结构再写入;validate 可只校验不写入。",
6
6
  "type": "data",
7
7
  "parameters": {
8
8
  "type": "object",
@@ -199,7 +199,7 @@
199
199
  "options": {
200
200
  "admin": {
201
201
  "type": "object",
202
- "description": "可注入已创建的 DataManager 实例或 mm_admin 实例池,省略时使用模块默认池 reg('mm_data')"
202
+ "description": "可注入已创建的 DataManager 实例或 mm_admin 实例池,省略时使用模块默认池 reg('mm_datas')"
203
203
  },
204
204
  "config": {
205
205
  "type": "object",