nodejs-store 2.6.0 → 3.0.0

package/src/schema.js

@@ -41,9 +41,26 @@ function register(defn) {
   const computes = {};
   for (const [key, val] of Object.entries(defn.computes || {})) {
     const fnRef = val.fnRef || key;
-    if (val.fn) core.setFn(fnRef, val.fn);
+    if (val.fn) {
+      const userFn = val.fn;
+      // FFI 边界契约：JS `undefined` 无法表示为 JSON 值（core 回调桥 SyncFnBridge
+      // 对 fn 返回值做 serde 序列化，undefined 即 InvalidArg）；归一为 null——
+      // 与 py 侧 lambda 返回 None → null 同语义，非错误兜底
+      core.setFn(fnRef, (item, ctx) => {
+        const r = userFn(item, ctx);
+        return r === undefined ? null : r;
+      });
+    }
     if (val.asyncFn) _asyncFns[fnRef] = val.asyncFn;
-    computes[key] = { fnRef };
+    // 镜像保留声明元数据（对齐 py_store.schema.register）：agg 形态与 read 白名单
+    // 供 AI 摘要（ask.describeForAi）等消费者读取；可执行物（fn/asyncFn）不入镜像
+    // （执行判决唯一在 core 规划 + Host 尾处理）
+    const meta = {};
+    for (const k of ['type', 'depends', 'agg', 'read']) {
+      if (k in val) meta[k] = val[k];
+    }
+    meta.fnRef = fnRef;
+    computes[key] = meta;
   }
 
   _schemas[defn.name] = {
@@ -110,6 +127,21 @@ function setRequireContext(needCtx = true) {
   core.setRequireContext(Boolean(needCtx));
 }
 
+/** 豁免角色清单（命中者在一切判决环节直接放行）。默认空——无豁免（清单化语义） */
+function setExemptRoles(roles) {
+  core.setExemptRoles(roles);
+}
+
+/** 拒写角色清单（命中者一切写路径拒绝，读不受影响）。默认空——无拒写 */
+function setDenyWriteRoles(roles) {
+  core.setDenyWriteRoles(roles);
+}
+
+/** schema 白名单缺失/为空时的默认姿态：'open'（默认，放行）| 'closed'（全拒） */
+function setUnconfiguredPolicy(policy) {
+  core.setUnconfiguredPolicy(policy);
+}
+
 /** 「上下文强制」开关当前值（对齐 py_store.schema.require_context） */
 function requireContext() {
   return core.requireContext();
@@ -143,6 +175,9 @@ module.exports = {
   list,
   setRequireContext,
   requireContext,
+  setExemptRoles,
+  setDenyWriteRoles,
+  setUnconfiguredPolicy,
   setProfile,
   getProfile,
   getAsyncFn,