update

tests/unit/renderer/store/notes-load-seq-guard.test.ts

@@ -0,0 +1,168 @@
+// tests/unit/renderer/store/notes-load-seq-guard.test.ts
+//
+// 守 r218「notes store load() 序号守卫 + 不做 in-flight join」契约。
+//
+// ── 被守卫的缺陷(用户可见)──────────────────────────────────────────
+//   旧实现 load() 走 `loadOnce` 单飞 join:第二次 load 若撞上第一次在途,
+//   **不发新 IPC**,直接并到那个在途 promise 上。于是一条现实的时序链:
+//     t0  load#1 发出(慢 IPC —— 主进程正忙着 reload / DB 写入);
+//     t1  一篇笔记被删掉(本窗口 / 另一个窗口 / 同步盘),主进程广播
+//         NOTES_CHANGED ⇒ renderer 推送监听器调 load();
+//     t2  这次 load **并到 load#1 上**(listNotes 的请求在 t0 就已到达
+//         主进程、先于删除被处理 ⇒ 返回的旧快照里**还有刚删的笔记**);
+//     t3  旧快照落地 —— 之后**没有任何后续 fetch**。
+//   ⇒ 列表永远停在旧状态:刚删的笔记还在列表里,要等下一次无关的外部
+//   事件才自愈。join 是缓存设计的残留,与 r193「不缓存、每次都真发 IPC」
+//   的意图直接矛盾。
+//
+// ── 修法(r218)────────────────────────────────────────────────────────
+//   镜像 literature store 的 r73 序号守卫,且 notes 侧**不做 join**:
+//   每次 load 都发新 IPC(listNotes 在主进程是内存 map 直读,并发几发
+//   没有成本);`_loadIssued` 每请求 +1,`_loadApplied` 记录已落地的最新
+//   序号,迟到的旧快照 / 旧失败 `seq < _loadApplied` 直接丢弃。
+//
+// ── 本测锁的三条 ─────────────────────────────────────────────────────
+//   A. 在途旧 load 期间再 load ⇒ 必须发**第二次** IPC,且最终落地**新**
+//      快照(缺陷本体;HEAD 上 join ⇒ 只发 1 次且拿到旧快照 ⇒ 红);
+//   B. 乱序到达:新快照先落地、旧响应后到达 ⇒ 旧响应被序号闸丢弃;
+//   C. 迟到的**旧失败**不得把已落地的新快照标成 lastError(catch 也过闸)。
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+vi.mock('../../../../src/renderer/src/store/workspace', () => ({
+  useWorkspaceStore: {
+    getState: () => ({
+      pendingFocusNote: { hasPending: false, payload: null },
+      consumeFocusNoteRequest: () => {},
+    }),
+  },
+}));
+vi.mock('../../../../src/renderer/src/lib/toast', () => ({
+  useToast: {
+    getState: () => ({ show: () => {} }),
+  },
+}));
+
+import { useNotesStore } from '../../../../src/renderer/src/store/notes';
+import type { StandaloneNoteSummary } from '../../../../src/shared/types';
+
+function summary(id: string, relPath: string): StandaloneNoteSummary {
+  return { id, relPath, filename: relPath, title: null, tags: null, mtime: 0 };
+}
+
+interface Deferred {
+  promise: Promise<{ ok: true; data: StandaloneNoteSummary[] }>;
+  resolve: (v: { ok: true; data: StandaloneNoteSummary[] }) => void;
+  reject: (e: unknown) => void;
+}
+
+function deferred(): Deferred {
+  let resolve!: Deferred['resolve'];
+  let reject!: Deferred['reject'];
+  const promise = new Promise<{ ok: true; data: StandaloneNoteSummary[] }>((res, rej) => {
+    resolve = res;
+    reject = rej;
+  });
+  return { promise, resolve, reject };
+}
+
+describe('notes store load() 序号守卫(r218)', () => {
+  let listNotes: ReturnType<typeof vi.fn>;
+
+  beforeEach(() => {
+    listNotes = vi.fn();
+    (globalThis as unknown as { window: { api: unknown } }).window = {
+      api: {
+        listNotes,
+        onNotesChanged: vi.fn().mockReturnValue(() => {}),
+      },
+    };
+    useNotesStore.setState({
+      notes: [],
+      selectedIds: new Set<string>(),
+      selectedId: null,
+      activeNoteFull: null,
+      anchorId: null,
+      clipboard: null,
+      lastError: null,
+      displayOrderById: {},
+    });
+  });
+
+  afterEach(() => {
+    vi.restoreAllMocks();
+  });
+
+  it('A 在途旧 load 期间再 load ⇒ 发第二次 IPC,最终落地新快照', async () => {
+    const d1 = deferred();
+    const d2 = deferred();
+    listNotes.mockReturnValueOnce(d1.promise).mockReturnValueOnce(d2.promise);
+
+    const l1 = useNotesStore.getState().load(); // 变更前发出的慢请求
+    const l2 = useNotesStore.getState().load(); // 变更后(NOTES_CHANGED)的刷新
+
+    expect(
+      listNotes,
+      '第二次 load 并到了在途 promise 上 ⇒ 变更后的状态永远拉不到',
+    ).toHaveBeenCalledTimes(2);
+
+    d1.resolve({ ok: true, data: [summary('stale', 'stale.md')] });
+    await l1;
+    d2.resolve({ ok: true, data: [] }); // 删除后的真实列表
+    await l2;
+
+    expect(
+      useNotesStore.getState().notes.map((n) => n.id),
+      '旧快照盖过了新快照(刚删的笔记还在列表里)',
+    ).toEqual([]);
+  });
+
+  it('B 乱序到达:新快照先落地,迟到的旧响应被丢弃', async () => {
+    const d1 = deferred();
+    const d2 = deferred();
+    listNotes.mockReturnValueOnce(d1.promise).mockReturnValueOnce(d2.promise);
+
+    const l1 = useNotesStore.getState().load();
+    const l2 = useNotesStore.getState().load();
+    expect(listNotes).toHaveBeenCalledTimes(2);
+
+    // 新快照先回来并落地
+    d2.resolve({ ok: true, data: [summary('b', 'b.md')] });
+    await l2;
+    // 旧快照**后**回来 —— 必须被序号闸丢掉
+    d1.resolve({ ok: true, data: [summary('a', 'a.md')] });
+    await l1;
+
+    expect(useNotesStore.getState().notes.map((n) => n.id)).toEqual(['b']);
+  });
+
+  it('C 迟到的旧失败不得把已落地的新快照标成 lastError', async () => {
+    const d1 = deferred();
+    const d2 = deferred();
+    listNotes.mockReturnValueOnce(d1.promise).mockReturnValueOnce(d2.promise);
+
+    const l1 = useNotesStore.getState().load();
+    const l2 = useNotesStore.getState().load();
+    expect(listNotes).toHaveBeenCalledTimes(2);
+
+    d2.resolve({ ok: true, data: [summary('b', 'b.md')] });
+    await l2;
+    expect(useNotesStore.getState().lastError).toBeNull();
+
+    // 旧请求**之后**失败 —— 不得覆盖新快照,也不得置 lastError
+    d1.reject(new Error('boom'));
+    await l1;
+
+    expect(useNotesStore.getState().notes.map((n) => n.id)).toEqual(['b']);
+    expect(
+      useNotesStore.getState().lastError,
+      '迟到的旧失败把新列表标成了「load 失败」',
+    ).toBeNull();
+  });
+
+  it('D 单次 load 正常落地(防回归)', async () => {
+    listNotes.mockResolvedValue({ ok: true, data: [summary('a', 'a.md')] });
+    await useNotesStore.getState().load();
+    expect(useNotesStore.getState().notes.map((n) => n.id)).toEqual(['a']);
+    expect(useNotesStore.getState().lastError).toBeNull();
+  });
+});