memory-eternal 0.10.5 → 0.10.7

package/lib/config-sync.js

@@ -204,6 +204,30 @@ export function patchApplied(config, patch) {
   return true
 }
 
+/**
+ * 只保留「本宿主 schema 里存在」的键（升级期「新独立页 + 旧宿主」的必备过滤）。
+ *
+ * 为什么必须过滤：独立 Web 端提交的是**整张表单**。升级期它可能带上旧宿主还不认识的键
+ * （实测：独立页 0.10.7 提交含 `secretHint` 的整包 → 0.10.6 宿主按白名单丢掉它 →
+ * `patchApplied` 回读校验必然对不上 → 连试 5 次后标 `dropped`，用户还会看到
+ * 「HMR transactions cannot be nested」这种与配置内容无关的报错）。过滤之后，旧宿主只应用
+ * 它认识的那部分，不认识的记一行日志、等宿主升级后自然生效。
+ *
+ * @param {object} patch
+ * @param {Set<string>|string[]} knownKeys
+ * @returns {{known:object, ignored:string[]}}
+ */
+export function filterKnownKeys(patch, knownKeys) {
+  const known = knownKeys instanceof Set ? knownKeys : new Set(knownKeys || [])
+  const out = {}
+  const ignored = []
+  for (const [k, v] of Object.entries(patch || {})) {
+    if (known.has(k)) out[k] = v
+    else ignored.push(k)
+  }
+  return { known: out, ignored }
+}
+
 /**
  * 应用一次 patch，并在抛错后**回读确认**（issue #21 的核心修复）。
  *