update

tests/unit/renderer/lib/bootstrap-apply-once.test.ts

@@ -0,0 +1,102 @@
+// tests/unit/renderer/lib/bootstrap-apply-once.test.ts
+//
+// 守卫(r206,2026-10-20):bootstrap 结果「应用且仅应用一次」的单点契约。
+//
+// 起因(r87):r85 的单飞修了「重复 IPC」,没修「重复应用」—— 两个 awaiter
+// 拿到同一结果后**各自** applyBootstrapSettings + setState({paths,loaded})。
+// pendingLayout 的消费在 applyPendingLayoutFallback 里
+// `void api.updateSettings(...).then(removeItem)` —— key 清理是异步的,
+// 同帧双 apply ⇒ 双 updateSettings 写(同值,LOW)。修:apply 收口到
+// lib/bootstrap.ts 的 applyBootstrapOnce 单点。
+//
+// 契约三分支:
+//   - r.ok 且尚未应用 → 'applied':applyBootstrapSettings + setState({paths, loaded:true});
+//   - r.ok 但已应用(另一 continuation 先落地 / 测试直接置 loaded)
+//     → 'already-applied':**零 store 写、零 IPC** —— 首落地值不被覆写;
+//   - !r.ok → 'ipc-failed':**纯判定不碰 state**。调用方按各自职责处理
+//     (main:log.warn + loaded=true 标记「本轮启动尝试过」;App:legacy
+//     settings/paths pair 修复)。两个调用方都会拿到同一个 'ipc-failed',
+//     修复只由 App 执行一次 —— 这是有意分工,不是守卫缺失。
+//
+// 隔离:本文件**不**用 vi.resetModules() —— applyBootstrapOnce 读写的
+// paths store 是模块级 zustand 单例,resetModules 会造出**另一份**实例,
+// 令「apply 写进去的 loaded」读不到(本轮第一版就踩了这个坑)。
+// 改为每例显式 setState 复位 loaded。
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import type { BootstrapPayload, IpcResult } from '@shared/types';
+
+const { applyBootstrapSettings } = vi.hoisted(() => ({ applyBootstrapSettings: vi.fn() }));
+vi.mock('@renderer/store/settings', () => ({ applyBootstrapSettings }));
+
+const PAYLOAD = {
+  settings: { themePreset: 'default' } as unknown as BootstrapPayload['settings'],
+  paths: { rootPath: '/tmp/x' } as unknown as BootstrapPayload['paths'],
+} as BootstrapPayload;
+
+const OK = { ok: true, data: PAYLOAD } as IpcResult<BootstrapPayload>;
+const FAIL = { ok: false, code: 'INTERNAL', message: 'boom' } as IpcResult<BootstrapPayload>;
+
+describe('bootstrap apply-once(r206)', () => {
+  beforeEach(async () => {
+    applyBootstrapSettings.mockReset();
+    const { usePathsStore } = await import('@renderer/store/paths');
+    usePathsStore.setState({ loaded: false, paths: null as never });
+  });
+
+  it('r.ok 且未加载 → applied,并写 settings + paths + loaded', async () => {
+    const { applyBootstrapOnce } = await import('@renderer/lib/bootstrap');
+    const { usePathsStore } = await import('@renderer/store/paths');
+
+    const out = applyBootstrapOnce(OK);
+
+    expect(out).toBe('applied');
+    expect(applyBootstrapSettings).toHaveBeenCalledTimes(1);
+    expect(applyBootstrapSettings).toHaveBeenCalledWith(PAYLOAD.settings);
+    const st = usePathsStore.getState();
+    expect(st.loaded).toBe(true);
+    expect(st.paths).toEqual(PAYLOAD.paths);
+  });
+
+  it('已应用(loaded=true)→ already-applied,零 store 写', async () => {
+    const { applyBootstrapOnce } = await import('@renderer/lib/bootstrap');
+    const { usePathsStore } = await import('@renderer/store/paths');
+    usePathsStore.setState({ loaded: true, paths: { rootPath: '/keep' } as never });
+
+    const out = applyBootstrapOnce(OK);
+
+    expect(out).toBe('already-applied');
+    expect(applyBootstrapSettings).not.toHaveBeenCalled();
+    // 首落地的值不被覆写
+    expect(usePathsStore.getState().paths).toEqual({ rootPath: '/keep' });
+  });
+
+  it('!r.ok → ipc-failed,且**不碰 state**(loaded 仍为 false)', async () => {
+    const { applyBootstrapOnce } = await import('@renderer/lib/bootstrap');
+    const { usePathsStore } = await import('@renderer/store/paths');
+
+    const out = applyBootstrapOnce(FAIL);
+
+    expect(out).toBe('ipc-failed');
+    expect(applyBootstrapSettings).not.toHaveBeenCalled();
+    expect(usePathsStore.getState().loaded).toBe(false);
+  });
+
+  it('连续两次 apply 同一个结果:第二次是 already-applied(只写一次)', async () => {
+    const { applyBootstrapOnce } = await import('@renderer/lib/bootstrap');
+
+    expect(applyBootstrapOnce(OK)).toBe('applied');
+    expect(applyBootstrapOnce(OK)).toBe('already-applied');
+    expect(applyBootstrapSettings).toHaveBeenCalledTimes(1);
+  });
+
+  it('ipc-failed 不写 loaded —— 「本轮启动尝试过」由调用方自己置', async () => {
+    // main.tsx 的语义是「失败也置 loaded=true」,但那是**调用方**的动作,
+    // 不是 applyBootstrapOnce 的动作。本例锁住这个分工边界。
+    const { applyBootstrapOnce } = await import('@renderer/lib/bootstrap');
+    const { usePathsStore } = await import('@renderer/store/paths');
+
+    applyBootstrapOnce(FAIL);
+
+    expect(usePathsStore.getState().loaded).toBe(false);
+  });
+});