mslxdff 0.1.203 → 0.1.207

package/src/state/schemas/token.js

@@ -1,48 +1,48 @@
-import { mkdirSync, readFileSync, writeFileSync, existsSync, statSync, chmodSync } from "node:fs";
-import { dirname } from "node:path";
-import { defaultStateFile, tokenFile, generateToken, readState, writeStateImmediate, getEntry } from "../store.js";
-import { fmtShanghaiYMDHMS } from "../../time.js";
-
-// 主 Bearer token 镜像落盘：0600 + 显式 chmod。
-// 注意 writeFileSync 的 mode 只在“新建文件”时生效，已存在的文件权限不会被它改；
-// 升级前生成的老文件会永远停在 0644（同机其他用户可读），所以必须再 chmod 一次兜住。
-function syncTokenFile(token, file) {
-  try {
-    const tf = tokenFile(file);
-    mkdirSync(dirname(tf), { recursive: true });
-    writeFileSync(tf, String(token || "").trim() + "\n", { encoding: "utf8", mode: 0o600 });
-    try { chmodSync(tf, 0o600); } catch {}
-  } catch {}
-}
-
-export async function loadToken({ file = defaultStateFile() } = {}) {
-  const state = readState(file);
-  if (typeof state.token === "string" && state.token.length > 0) {
-    syncTokenFile(state.token, file);
-    return { token: state.token, created: false };
-  }
-  if (existsSync(file)) {
-    try {
-      const raw = JSON.parse(readFileSync(file, "utf8"));
-      if (typeof raw.token === "string" && raw.token.length > 0) {
-        syncTokenFile(raw.token, file);
-        const e = getEntry(file);
-        e.data = raw;
-        try { e.mtimeMs = statSync(file).mtimeMs; } catch {}
-        return { token: raw.token, created: false };
-      }
-    } catch {}
-  }
-  const tok = generateToken();
-  const saved = writeStateImmediate(file, { token: tok, createdAt: fmtShanghaiYMDHMS(new Date()) }).token;
-  syncTokenFile(saved, file);
-  return { token: saved, created: true };
-}
-
-export async function refreshToken({ file = defaultStateFile() } = {}) {
-  const tok = writeStateImmediate(file, { token: generateToken(), createdAt: fmtShanghaiYMDHMS(new Date()) }).token;
-  syncTokenFile(tok, file);
-  return tok;
-}
-
-export { generateToken, tokenFile };
+import { mkdirSync, readFileSync, writeFileSync, existsSync, statSync, chmodSync } from "node:fs";
+import { dirname } from "node:path";
+import { defaultStateFile, tokenFile, generateToken, readState, writeStateImmediate, getEntry } from "../store.js";
+import { fmtShanghaiYMDHMS } from "../../time.js";
+
+// 主 Bearer token 镜像落盘：0600 + 显式 chmod。
+// 注意 writeFileSync 的 mode 只在“新建文件”时生效，已存在的文件权限不会被它改；
+// 升级前生成的老文件会永远停在 0644（同机其他用户可读），所以必须再 chmod 一次兜住。
+function syncTokenFile(token, file) {
+  try {
+    const tf = tokenFile(file);
+    mkdirSync(dirname(tf), { recursive: true });
+    writeFileSync(tf, String(token || "").trim() + "\n", { encoding: "utf8", mode: 0o600 });
+    try { chmodSync(tf, 0o600); } catch {}
+  } catch {}
+}
+
+export async function loadToken({ file = defaultStateFile() } = {}) {
+  const state = readState(file);
+  if (typeof state.token === "string" && state.token.length > 0) {
+    syncTokenFile(state.token, file);
+    return { token: state.token, created: false };
+  }
+  if (existsSync(file)) {
+    try {
+      const raw = JSON.parse(readFileSync(file, "utf8"));
+      if (typeof raw.token === "string" && raw.token.length > 0) {
+        syncTokenFile(raw.token, file);
+        const e = getEntry(file);
+        e.data = raw;
+        try { e.mtimeMs = statSync(file).mtimeMs; } catch {}
+        return { token: raw.token, created: false };
+      }
+    } catch {}
+  }
+  const tok = generateToken();
+  const saved = writeStateImmediate(file, { token: tok, createdAt: fmtShanghaiYMDHMS(new Date()) }).token;
+  syncTokenFile(saved, file);
+  return { token: saved, created: true };
+}
+
+export async function refreshToken({ file = defaultStateFile() } = {}) {
+  const tok = writeStateImmediate(file, { token: generateToken(), createdAt: fmtShanghaiYMDHMS(new Date()) }).token;
+  syncTokenFile(tok, file);
+  return tok;
+}
+
+export { generateToken, tokenFile };

package/src/state/schemas/use-group.js

@@ -1,102 +1,102 @@
-import { defaultStateFile, readState, writeStateImmediate } from "../store.js";
-import { classifyProvider } from "../../providers/classify.js";
-import { getModelAlias, normalizeProviderId, DEFAULT_PROVIDER } from "../../providers/model-id.js";
-
-function parseBool(v) {
-  if (typeof v === "boolean") return v;
-  if (typeof v === "number") return v !== 0;
-  if (typeof v === "string") {
-    const s = v.trim().toLowerCase();
-    if (["0", "false", "off", "no", "disable", "disabled", "close", "closed"].includes(s)) return false;
-    if (["1", "true", "on", "yes", "enable", "enabled", "open"].includes(s)) return true;
-  }
-  return null;
-}
-
-export function loadUseGroup({ file = defaultStateFile() } = {}) {
-  const raw = readState(file).useGroup;
-  const parsed = parseBool(raw);
-  return parsed === null ? true : parsed; // 默认开
-}
-
-export function saveUseGroup(value, { file = defaultStateFile() } = {}) {
-  const b = Boolean(value);
-  writeStateImmediate(file, { useGroup: b });
-  return b;
-}
-
-export function getUseGroupEnv() {
-  const raw = process.env.MSLXDFF_USE_GROUP;
-  if (raw === undefined || raw === null || raw === "") return null;
-  return parseBool(raw);
-}
-
-export function getEffectiveUseGroup({ file = defaultStateFile() } = {}) {
-  const env = getUseGroupEnv();
-  if (env !== null) return env;
-  return loadUseGroup({ file });
-}
-
-// key 供应商组员开关：默认 off（仅 opencode 免费池走 peer 兜底，其他带 key 上游恒直连）。
-// MSLXDFF_USE_GROUP_KEYS=1/on 可显式开回来（调试/弱网应急）；同样受全局 off 约束。
-export function getUseGroupKeysEnv() {
-  const raw = process.env.MSLXDFF_USE_GROUP_KEYS;
-  if (raw === undefined || raw === null || raw === "") return false;
-  return parseBool(raw) === true;
-}
-
-// 取模型对应的供应商 head：兼容 canonical（workbuddy/xxx、cline/xxx）、
-// dash 别名（cline-xxx → 还原后取 head）、裸 id（归 opencode）。
-// oc/ 别名归一到 opencode（与 splitModelId 一致：别名表小写 key，先小写再归一）。
-export function providerHeadOf(model) {
-  let s = String(model || "").trim();
-  if (!s) return "";
-  try {
-    const aliased = getModelAlias(s);
-    if (aliased) s = aliased;
-  } catch {}
-  const slash = s.indexOf("/");
-  if (slash > 0) {
-    try {
-      const head = normalizeProviderId(s.slice(0, slash).toLowerCase());
-      return String(head || "").toLowerCase();
-    } catch {
-      return s.slice(0, slash).toLowerCase();
-    }
-  }
-  return DEFAULT_PROVIDER;
-}
-
-// 全局开关：off 则所有供应商都不走组员网络（via-route/hedge/peer/broadband 全禁），仅本机直连
-// workbuddy/cline 系硬禁组员（ADR-0015 local-only）：本机账号绑定（workbuddy auths/*.json + uid / cline refreshToken），
-// 组员没有该账号转过去也用不了，且本地直连最快——无论全局开关一律仅本机直连。
-// model 兼容 canonical（workbuddy/xxx、cline/xxx）与 dash（workbuddy-xxx、cline-xxx）两种形态。
-export function isHardLocalOnly(model) {
-  const head = providerHeadOf(model);
-  if (!head) return false;
-  try {
-    return classifyProvider(head) === "local-only";
-  } catch {
-    return head === "workbuddy" || head === "cline";
-  }
-}
-
-// key 供应商默认直连（ADR-0023）：opencode（quota-pool，裸 id/oc 前缀）沿用全局开关；
-// 其余带前缀的一律仅本机直连，除非 MSLXDFF_USE_GROUP_KEYS=1 显式开回。
-export function isKeyProviderDirectOnly(model) {
-  const head = providerHeadOf(model);
-  if (!head || head === "opencode") return false;
-  if (isHardLocalOnly(model)) return true;
-  if (getUseGroupKeysEnv()) return false;
-  return true;
-}
-
-export function shouldUseGroupForModel(model, { file = defaultStateFile() } = {}) {
-  if (isHardLocalOnly(model)) return false;
-  if (isKeyProviderDirectOnly(model)) return false;
-  return getEffectiveUseGroup({ file });
-}
-
-export function isUseGroupEnabled({ file } = {}) {
-  return getEffectiveUseGroup({ file });
-}
+import { defaultStateFile, readState, writeStateImmediate } from "../store.js";
+import { classifyProvider } from "../../providers/classify.js";
+import { getModelAlias, normalizeProviderId, DEFAULT_PROVIDER } from "../../providers/model-id.js";
+
+function parseBool(v) {
+  if (typeof v === "boolean") return v;
+  if (typeof v === "number") return v !== 0;
+  if (typeof v === "string") {
+    const s = v.trim().toLowerCase();
+    if (["0", "false", "off", "no", "disable", "disabled", "close", "closed"].includes(s)) return false;
+    if (["1", "true", "on", "yes", "enable", "enabled", "open"].includes(s)) return true;
+  }
+  return null;
+}
+
+export function loadUseGroup({ file = defaultStateFile() } = {}) {
+  const raw = readState(file).useGroup;
+  const parsed = parseBool(raw);
+  return parsed === null ? true : parsed; // 默认开
+}
+
+export function saveUseGroup(value, { file = defaultStateFile() } = {}) {
+  const b = Boolean(value);
+  writeStateImmediate(file, { useGroup: b });
+  return b;
+}
+
+export function getUseGroupEnv() {
+  const raw = process.env.MSLXDFF_USE_GROUP;
+  if (raw === undefined || raw === null || raw === "") return null;
+  return parseBool(raw);
+}
+
+export function getEffectiveUseGroup({ file = defaultStateFile() } = {}) {
+  const env = getUseGroupEnv();
+  if (env !== null) return env;
+  return loadUseGroup({ file });
+}
+
+// key 供应商组员开关：默认 off（仅 opencode 免费池走 peer 兜底，其他带 key 上游恒直连）。
+// MSLXDFF_USE_GROUP_KEYS=1/on 可显式开回来（调试/弱网应急）；同样受全局 off 约束。
+export function getUseGroupKeysEnv() {
+  const raw = process.env.MSLXDFF_USE_GROUP_KEYS;
+  if (raw === undefined || raw === null || raw === "") return false;
+  return parseBool(raw) === true;
+}
+
+// 取模型对应的供应商 head：兼容 canonical（workbuddy/xxx、cline/xxx）、
+// dash 别名（cline-xxx → 还原后取 head）、裸 id（归 opencode）。
+// oc/ 别名归一到 opencode（与 splitModelId 一致：别名表小写 key，先小写再归一）。
+export function providerHeadOf(model) {
+  let s = String(model || "").trim();
+  if (!s) return "";
+  try {
+    const aliased = getModelAlias(s);
+    if (aliased) s = aliased;
+  } catch {}
+  const slash = s.indexOf("/");
+  if (slash > 0) {
+    try {
+      const head = normalizeProviderId(s.slice(0, slash).toLowerCase());
+      return String(head || "").toLowerCase();
+    } catch {
+      return s.slice(0, slash).toLowerCase();
+    }
+  }
+  return DEFAULT_PROVIDER;
+}
+
+// 全局开关：off 则所有供应商都不走组员网络（via-route/hedge/peer/broadband 全禁），仅本机直连
+// workbuddy/cline 系硬禁组员（ADR-0015 local-only）：本机账号绑定（workbuddy auths/*.json + uid / cline refreshToken），
+// 组员没有该账号转过去也用不了，且本地直连最快——无论全局开关一律仅本机直连。
+// model 兼容 canonical（workbuddy/xxx、cline/xxx）与 dash（workbuddy-xxx、cline-xxx）两种形态。
+export function isHardLocalOnly(model) {
+  const head = providerHeadOf(model);
+  if (!head) return false;
+  try {
+    return classifyProvider(head) === "local-only";
+  } catch {
+    return head === "workbuddy" || head === "cline";
+  }
+}
+
+// key 供应商默认直连（ADR-0023）：opencode（quota-pool，裸 id/oc 前缀）沿用全局开关；
+// 其余带前缀的一律仅本机直连，除非 MSLXDFF_USE_GROUP_KEYS=1 显式开回。
+export function isKeyProviderDirectOnly(model) {
+  const head = providerHeadOf(model);
+  if (!head || head === "opencode") return false;
+  if (isHardLocalOnly(model)) return true;
+  if (getUseGroupKeysEnv()) return false;
+  return true;
+}
+
+export function shouldUseGroupForModel(model, { file = defaultStateFile() } = {}) {
+  if (isHardLocalOnly(model)) return false;
+  if (isKeyProviderDirectOnly(model)) return false;
+  return getEffectiveUseGroup({ file });
+}
+
+export function isUseGroupEnabled({ file } = {}) {
+  return getEffectiveUseGroup({ file });
+}

package/src/state/store.js

@@ -1,176 +1,176 @@
-import { randomBytes } from "node:crypto";
-import { mkdirSync, readFileSync, writeFileSync, statSync } from "node:fs";
-import { writeFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import os from "node:os";
-import { loadFromDisk, atomicWriteSync, getMtimeMs, ensureDir } from "./persist.js";
-import { mergeState, COLD_WINS } from "./merge.js";
-
-export const DEFAULT_PORT = 8989;
-
-export function isTestEnv() {
-  if (process.env.NODE_ENV === "test") return true;
-  if (process.env.MSLXDFF_STATE_FILE && String(process.env.MSLXDFF_STATE_FILE).includes("mslxdff-test")) return true;
-  if (process.argv.some((a) => String(a).includes("--test") || String(a).endsWith(".test.js"))) return true;
-  if (Array.isArray(process.execArgv) && process.execArgv.some((a) => String(a).includes("--test"))) return true;
-  if (process.env.NODE_TEST_CONTEXT) return true;
-  return false;
-}
-
-export function defaultStateFile() {
-  if (process.env.MSLXDFF_STATE_FILE) return process.env.MSLXDFF_STATE_FILE;
-  if (isTestEnv()) return join(os.tmpdir(), "mslxdff-test-state.json");
-  return join(os.homedir(), ".config", "mslxdff", "state.json");
-}
-
-export function tokenFile(file) {
-  if (process.env.MSLXDFF_TOKEN_FILE) return process.env.MSLXDFF_TOKEN_FILE;
-  const sf = file || defaultStateFile();
-  const realDefault = join(os.homedir(), ".config", "mslxdff", "state.json");
-  if (sf !== realDefault) return join(dirname(sf), "token");
-  if (isTestEnv()) return join(os.tmpdir(), "mslxdff-test-token");
-  return join(os.homedir(), ".config", "mslxdff", "token");
-}
-
-export function generateToken() {
-  return randomBytes(32).toString("hex");
-}
-
-// ---- 缓存层：读走内存，写分“热/冷”两档，热数据 500ms 批量刷盘 ----
-const stateCache = new Map(); // file -> { data, dirty, timer, mtimeMs }
-const FLUSH_MS = (() => {
-  const n = Number(process.env.MSLXDFF_STATE_FLUSH_MS);
-  return Number.isInteger(n) && n >= 0 ? n : 500;
-})();
-
-function getEntry(file) {
-  let e = stateCache.get(file);
-  if (!e) {
-    e = { data: null, dirty: false, timer: null, mtimeMs: 0 };
-    stateCache.set(file, e);
-  }
-  return e;
-}
-
-// 合并规则已抽至 merge.js 单一真相
-
-function readState(file) {
-  const e = getEntry(file);
-  if (e.data !== null) {
-    try {
-      const st = statSync(file);
-      if (st.mtimeMs === e.mtimeMs) return e.data;
-      if (e.dirty) {
-        const disk = loadFromDisk(file);
-        const diskObj = typeof disk === "object" && disk !== null ? disk : {};
-        const merged = mergeState(diskObj, e.data);
-        e.data = merged;
-        e.mtimeMs = st.mtimeMs;
-        return e.data;
-      }
-    } catch {
-      if (e.data) return e.data;
-    }
-  }
-  const disk = loadFromDisk(file);
-  const obj = typeof disk === "object" && disk !== null ? disk : {};
-  e.data = obj;
-  try {
-    const st = statSync(file);
-    e.mtimeMs = st.mtimeMs;
-  } catch {
-    e.mtimeMs = Date.now();
-  }
-  e.dirty = false;
-  return e.data;
-}
-
-function writeStateImmediate(file, patch) {
-  const e = getEntry(file);
-  const base = e.data !== null ? e.data : readState(file);
-  const merged = { ...base, ...patch };
-  e.data = merged;
-  e.dirty = false;
-  if (e.timer) {
-    clearTimeout(e.timer);
-    e.timer = null;
-  }
-  ensureDir(file);
-  const mtime = atomicWriteSync(file, merged);
-  e.mtimeMs = mtime;
-  return merged;
-}
-
-function scheduleFlush(file) {
-  const e = getEntry(file);
-  if (e.timer) return;
-  if (FLUSH_MS === 0) {
-    flushStateSync(file);
-    return;
-  }
-  e.timer = setTimeout(() => {
-    e.timer = null;
-    void flushState(file);
-  }, FLUSH_MS);
-  e.timer.unref?.();
-}
-
-async function flushState(file) {
-  const e = stateCache.get(file);
-  if (!e || !e.dirty || !e.data) return;
-  const snapshot = e.data;
-  try {
-    ensureDir(file);
-    const mtime = await atomicWriteAsync(file, snapshot);
-    e.dirty = false;
-    e.mtimeMs = mtime;
-  } catch {
-    // retain dirty
-  }
-}
-
-function writeStateDeferred(file, patch) {
-  const e = getEntry(file);
-  const base = e.data !== null ? e.data : readState(file);
-  const merged = { ...base, ...patch };
-  e.data = merged;
-  e.dirty = true;
-  scheduleFlush(file);
-  return merged;
-}
-
-export function flushStateSync(file = defaultStateFile()) {
-  const e = stateCache.get(file);
-  if (!e || !e.dirty || !e.data) return;
-  try {
-    ensureDir(file);
-    const mtime = atomicWriteSync(file, e.data);
-    e.dirty = false;
-    e.mtimeMs = mtime;
-    if (e.timer) {
-      clearTimeout(e.timer);
-      e.timer = null;
-    }
-  } catch {}
-}
-
-export function clearStateCache(file) {
-  if (file) stateCache.delete(file);
-  else stateCache.clear();
-}
-
-// internal helper for facade compat
-function writeState(file, patch) {
-  return writeStateImmediate(file, patch);
-}
-
-export {
-  readState,
-  writeStateImmediate,
-  writeStateDeferred,
-  scheduleFlush,
-  flushState,
-  writeState,
-  getEntry,
-  stateCache,
-};
+import { randomBytes } from "node:crypto";
+import { mkdirSync, readFileSync, writeFileSync, statSync } from "node:fs";
+import { writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import os from "node:os";
+import { loadFromDisk, atomicWriteSync, getMtimeMs, ensureDir } from "./persist.js";
+import { mergeState, COLD_WINS } from "./merge.js";
+
+export const DEFAULT_PORT = 8989;
+
+export function isTestEnv() {
+  if (process.env.NODE_ENV === "test") return true;
+  if (process.env.MSLXDFF_STATE_FILE && String(process.env.MSLXDFF_STATE_FILE).includes("mslxdff-test")) return true;
+  if (process.argv.some((a) => String(a).includes("--test") || String(a).endsWith(".test.js"))) return true;
+  if (Array.isArray(process.execArgv) && process.execArgv.some((a) => String(a).includes("--test"))) return true;
+  if (process.env.NODE_TEST_CONTEXT) return true;
+  return false;
+}
+
+export function defaultStateFile() {
+  if (process.env.MSLXDFF_STATE_FILE) return process.env.MSLXDFF_STATE_FILE;
+  if (isTestEnv()) return join(os.tmpdir(), "mslxdff-test-state.json");
+  return join(os.homedir(), ".config", "mslxdff", "state.json");
+}
+
+export function tokenFile(file) {
+  if (process.env.MSLXDFF_TOKEN_FILE) return process.env.MSLXDFF_TOKEN_FILE;
+  const sf = file || defaultStateFile();
+  const realDefault = join(os.homedir(), ".config", "mslxdff", "state.json");
+  if (sf !== realDefault) return join(dirname(sf), "token");
+  if (isTestEnv()) return join(os.tmpdir(), "mslxdff-test-token");
+  return join(os.homedir(), ".config", "mslxdff", "token");
+}
+
+export function generateToken() {
+  return randomBytes(32).toString("hex");
+}
+
+// ---- 缓存层：读走内存，写分“热/冷”两档，热数据 500ms 批量刷盘 ----
+const stateCache = new Map(); // file -> { data, dirty, timer, mtimeMs }
+const FLUSH_MS = (() => {
+  const n = Number(process.env.MSLXDFF_STATE_FLUSH_MS);
+  return Number.isInteger(n) && n >= 0 ? n : 500;
+})();
+
+function getEntry(file) {
+  let e = stateCache.get(file);
+  if (!e) {
+    e = { data: null, dirty: false, timer: null, mtimeMs: 0 };
+    stateCache.set(file, e);
+  }
+  return e;
+}
+
+// 合并规则已抽至 merge.js 单一真相
+
+function readState(file) {
+  const e = getEntry(file);
+  if (e.data !== null) {
+    try {
+      const st = statSync(file);
+      if (st.mtimeMs === e.mtimeMs) return e.data;
+      if (e.dirty) {
+        const disk = loadFromDisk(file);
+        const diskObj = typeof disk === "object" && disk !== null ? disk : {};
+        const merged = mergeState(diskObj, e.data);
+        e.data = merged;
+        e.mtimeMs = st.mtimeMs;
+        return e.data;
+      }
+    } catch {
+      if (e.data) return e.data;
+    }
+  }
+  const disk = loadFromDisk(file);
+  const obj = typeof disk === "object" && disk !== null ? disk : {};
+  e.data = obj;
+  try {
+    const st = statSync(file);
+    e.mtimeMs = st.mtimeMs;
+  } catch {
+    e.mtimeMs = Date.now();
+  }
+  e.dirty = false;
+  return e.data;
+}
+
+function writeStateImmediate(file, patch) {
+  const e = getEntry(file);
+  const base = e.data !== null ? e.data : readState(file);
+  const merged = { ...base, ...patch };
+  e.data = merged;
+  e.dirty = false;
+  if (e.timer) {
+    clearTimeout(e.timer);
+    e.timer = null;
+  }
+  ensureDir(file);
+  const mtime = atomicWriteSync(file, merged);
+  e.mtimeMs = mtime;
+  return merged;
+}
+
+function scheduleFlush(file) {
+  const e = getEntry(file);
+  if (e.timer) return;
+  if (FLUSH_MS === 0) {
+    flushStateSync(file);
+    return;
+  }
+  e.timer = setTimeout(() => {
+    e.timer = null;
+    void flushState(file);
+  }, FLUSH_MS);
+  e.timer.unref?.();
+}
+
+async function flushState(file) {
+  const e = stateCache.get(file);
+  if (!e || !e.dirty || !e.data) return;
+  const snapshot = e.data;
+  try {
+    ensureDir(file);
+    const mtime = await atomicWriteAsync(file, snapshot);
+    e.dirty = false;
+    e.mtimeMs = mtime;
+  } catch {
+    // retain dirty
+  }
+}
+
+function writeStateDeferred(file, patch) {
+  const e = getEntry(file);
+  const base = e.data !== null ? e.data : readState(file);
+  const merged = { ...base, ...patch };
+  e.data = merged;
+  e.dirty = true;
+  scheduleFlush(file);
+  return merged;
+}
+
+export function flushStateSync(file = defaultStateFile()) {
+  const e = stateCache.get(file);
+  if (!e || !e.dirty || !e.data) return;
+  try {
+    ensureDir(file);
+    const mtime = atomicWriteSync(file, e.data);
+    e.dirty = false;
+    e.mtimeMs = mtime;
+    if (e.timer) {
+      clearTimeout(e.timer);
+      e.timer = null;
+    }
+  } catch {}
+}
+
+export function clearStateCache(file) {
+  if (file) stateCache.delete(file);
+  else stateCache.clear();
+}
+
+// internal helper for facade compat
+function writeState(file, patch) {
+  return writeStateImmediate(file, patch);
+}
+
+export {
+  readState,
+  writeStateImmediate,
+  writeStateDeferred,
+  scheduleFlush,
+  flushState,
+  writeState,
+  getEntry,
+  stateCache,
+};

package/src/state.js

@@ -1 +1 @@
-export * from "./state/facade.js";
+export * from "./state/facade.js";