memory-eternal 0.10.6 → 0.10.8

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 的核心修复）。
  *
@@ -295,3 +319,78 @@ export async function drainPendingConfig(env, apply, maxTries = 5) {
   clearPendingConfig(env)
   return pending.patch
 }
+
+// ---- 方案 A：把「应用 pending」搬进宿主允许的上下文（2026-10-08 实测结论）----------------
+//
+// 实测（同一宿主机、同一个 settings.update）：
+//   · 从插件**回调**（setInterval / fs.watch）里调 → 抛「HMR transactions cannot be nested」，
+//     且**一个字节都没提交**（与 patch 内容无关：只含宿主认识的键、值真的变了，同样失败）；
+//   · 从插件**HTTP 请求处理器**里调 → 真的提交（130→132→130，revision 4→6）。
+// 所以修法不是「换个 API」，而是**换调用上下文**：独立端保存后，请宿主在这条路由里应用 pending。
+
+/** 宿主 drain 路由的令牌请求头（令牌写在心跳文件里，只有本机进程读得到）。 */
+export const DRAIN_TOKEN_HEADER = 'x-memory-eternal-token'
+
+/** 这个地址算不算「本机」：IPv4/IPv6 回环，含 IPv4-mapped 形式。 */
+export function isLoopbackAddress(address) {
+  const s = String(address || '').trim().toLowerCase()
+  if (!s) return false
+  if (s === 'localhost' || s === '::1' || s === '0:0:0:0:0:0:0:1') return true
+  const v4 = s.startsWith('::ffff:') ? s.slice(7) : s
+  return /^127\./.test(v4)
+}
+
+/**
+ * 宿主侧：校验一次「请立刻应用 pending」的调用。放行返回空串，否则返回人话原因。
+ *
+ * 为什么两件都要验：宿主上的插件 API 是**无鉴权**的（任何本机页面都能 POST），所以这里必须同时
+ * 卡「只接受本机来源」与「心跳里的令牌」——令牌只写在共享配置目录的心跳文件里，远端页面拿不到。
+ */
+export function drainRequestError({ method, headers, remoteAddress } = {}, token = '') {
+  if (String(method || '').toUpperCase() !== 'POST') return '需 POST'
+  if (!isLoopbackAddress(remoteAddress)) return '只接受本机请求'
+  if (!token) return '宿主未准备令牌'
+  const h = headers || {}
+  const got = String(h[DRAIN_TOKEN_HEADER] || h['X-Memory-Eternal-Token'] || '')
+  if (got !== token) return '令牌不匹配'
+  return ''
+}
+
+/**
+ * 独立端：请宿主**在 HTTP 请求上下文里**立刻应用 pending（方案 A 的客户端一半）。
+ *
+ * 失败分两类，调用方要区别对待：
+ *   · status 404/405/0（旧宿主没这条路由 / 连不上）→ 退回「等宿主自己 drain」的老路，不是错误；
+ *   · 其它 → 真错误（令牌不匹配、应用失败），把 body.error 如实报给用户。
+ *
+ * @param {{port?:number, token?:string, host?:string, timeoutMs?:number, fetchImpl?:Function}} opts
+ * @returns {Promise<{ok:boolean, status:number, body?:object, error?:string}>}
+ */
+export async function triggerHostDrain({ port, token, host = '127.0.0.1', timeoutMs = 2000, fetchImpl } = {}) {
+  const listenPort = Number(port) || 0
+  if (!listenPort || !token) return { ok: false, status: 0, error: '宿主端口/令牌未知（旧宿主，或心跳还没刷新）' }
+  const doFetch = fetchImpl || (typeof fetch === 'function' ? fetch : null)
+  if (!doFetch) return { ok: false, status: 0, error: '当前运行时没有 fetch' }
+  const url = 'http://' + host + ':' + listenPort + '/memory-eternal/api/drain-pending'
+  const controller = typeof AbortController === 'function' ? new AbortController() : null
+  const timer = controller ? setTimeout(() => { try { controller.abort() } catch { /* 已中止 */ } }, Math.max(0, Number(timeoutMs) || 0)) : null
+  try {
+    const res = await doFetch(url, {
+      method: 'POST',
+      headers: { [DRAIN_TOKEN_HEADER]: String(token) },
+      ...(controller ? { signal: controller.signal } : {}),
+    })
+    const text = await res.text()
+    let body = null
+    try { body = text ? JSON.parse(text) : null } catch { body = null }
+    const status = Number(res.status) || 0
+    if (!res.ok || !body || body.ok !== true) {
+      return { ok: false, status, body, error: (body && body.error) || ('HTTP ' + status) }
+    }
+    return { ok: true, status, body }
+  } catch (error) {
+    return { ok: false, status: 0, error: String((error && error.message) || error) }
+  } finally {
+    if (timer) clearTimeout(timer)
+  }
+}