MailUI4Agents/client/electron/test/stores/appearanceSync.test.ts

/**
 * 外观同步的行为判据（2026-09-14）。
 *
 * 背景：用户质问「为什么背景是保存在本地而不是服务器！」⇒ 主题与壁纸搬到服务端
 * （账号级），本地只做缓存。这一层出错**不会抛异常**，只会表现为"设置看起来保存了，
 * 换设备却是别的样子"或"改动没存上却显示已同步" —— 所以必须逐条钉住：
 *
 *   1. 拉取以服务端为准（换设备能拿回来）
 *   2. ★ 拉取**不会**再推回去（否则自己触发自己：一次拉取顺带一次 PUT，
 *      服务端 updated_at 被无意义刷新，还会掩盖真实的本地改动）
 *   3. 本地改动会推上去（payload 形状要对）
 *   4. 推不上去要变成 pending，未登录/不可达是 local-only —— **降级可见**
 *   5. 壁纸只在换图时上传一次（几 MB 的东西不该每次 PUT 都跟着走）
 */
import { beforeEach, describe, expect, it, vi } from 'vitest';

import { setActiveAuth } from '../../src/api/config';
import { useAppearanceSync } from '../../src/stores/appearanceSync';
import { useBackgroundStore } from '../../src/stores/backgroundStore';
import { useThemeStore } from '../../src/stores/themeStore';
import { payloadFromLocal, snapshotFromResponse } from '../../src/lib/appearance';

type Call = { url: string; method: string; body?: any };

function fakeFetch(handler: (call: Call) => Response | Promise<Response>) {
  const calls: Call[] = [];
  globalThis.fetch = (async (input: any, init: any = {}) => {
    const url = String(input);
    const call: Call = { url, method: init.method || 'GET', body: init.body };
    calls.push(call);
    return handler(call);
  }) as any;
  return calls;
}

const json = (body: unknown, status = 200) =>
  new Response(JSON.stringify(body), { status, headers: { 'Content-Type': 'application/json' } });

const REMOTE = {
  theme: 'dark',
  bg_kind: 'preset',
  bg_preset_id: 'dusk',
  bg_dim: 33,
  bg_blur: 7,
  has_image: false
};

beforeEach(() => {
  localStorage.clear();
  setActiveAuth({ base: 'http://gw', token: 'tok' });
  useAppearanceSync.setState({ status: 'idle', lastSyncedAt: 0, applyingRemote: false });
  useThemeStore.getState().setPref('system');
  useBackgroundStore.setState({ kind: 'none', presetId: 'aurora', imageDataUrl: '', dim: 12, blur: 4 });
});

describe('快照换算（纯函数）', () => {
  it('服务端的值能灌进本地形状，认不出的退回默认', () => {
    expect(snapshotFromResponse(REMOTE)).toEqual({
      theme: 'dark',
      bgKind: 'preset',
      bgPresetId: 'dusk',
      bgDim: 33,
      bgBlur: 7
    });
    expect(snapshotFromResponse({ theme: 'neon', bg_kind: 'video' } as any)).toMatchObject({
      theme: 'system',
      bgKind: 'none'
    });
  });

  it('★ image 档但没图 → 退回 none（免得服务端存成"有图却没有"）', () => {
    const p = payloadFromLocal({ theme: 'dark', kind: 'image', presetId: 'aurora', imageDataUrl: '', dim: 12, blur: 4 });
    expect(p.bg_kind).toBe('none');
    const q = payloadFromLocal({ theme: 'dark', kind: 'image', presetId: 'aurora', imageDataUrl: 'data:image/png;base64,AA', dim: 12, blur: 4 });
    expect(q.bg_kind).toBe('image');
  });

  it('越界的 dim/blur 被夹住（服务端也会夹，但本地不该先送出脏值）', () => {
    const p = payloadFromLocal({ theme: 'light', kind: 'preset', presetId: 'aurora', imageDataUrl: '', dim: 999, blur: -3 });
    expect(p.bg_dim).toBe(90);
    expect(p.bg_blur).toBe(0);
  });
});

describe('拉取与推送', () => {
  it('拉取以服务端为准（换设备能拿回来）', async () => {
    fakeFetch(() => json(REMOTE));
    await useAppearanceSync.getState().pull();
    expect(useThemeStore.getState().pref).toBe('dark');
    const bg = useBackgroundStore.getState();
    expect(bg.kind).toBe('preset');
    expect(bg.presetId).toBe('dusk');
    expect(bg.dim).toBe(33);
    expect(useAppearanceSync.getState().status).toBe('synced');
  });

  it('★ 拉取不会再推回去（否则是自触发回环）', async () => {
    const calls = fakeFetch(() => json(REMOTE));
    await useAppearanceSync.getState().pull();
    const writes = calls.filter(c => c.method !== 'GET');
    expect(writes, `拉取期间不该有任何写请求：${JSON.stringify(writes)}`).toEqual([]);
  });

  it('本地改动推上去，且 payload 形状对', async () => {
    const calls = fakeFetch(() => json({ saved: true }));
    useThemeStore.getState().setPref('light');
    useBackgroundStore.getState().setPreset('mint');
    await useAppearanceSync.getState().push();

    const put = calls.find(c => c.method === 'PUT');
    expect(put, '应当发出 PUT').toBeTruthy();
    const body = JSON.parse(String(put!.body));
    expect(body).toMatchObject({ theme: 'light', bg_kind: 'preset', bg_preset_id: 'mint' });
    expect(useAppearanceSync.getState().status).toBe('synced');
  });

  it('未登录 → local-only（降级必须可见）', async () => {
    setActiveAuth({ base: '', token: '' });
    fakeFetch(() => json(REMOTE));
    await useAppearanceSync.getState().pull();
    expect(useAppearanceSync.getState().status).toBe('local-only');
  });

  it('服务端不可达 → local-only，不是"已同步"', async () => {
    fakeFetch(() => json({}, 500));
    await useAppearanceSync.getState().pull();
    expect(useAppearanceSync.getState().status).toBe('local-only');
  });

  it('推送失败 → pending（稍后重试，而不是假装成功）', async () => {
    fakeFetch(() => json({}, 503));
    await useAppearanceSync.getState().push();
    expect(useAppearanceSync.getState().status).toBe('pending');
  });

  it('★ 壁纸只在换图时上传一次（几 MB 不该每次 PUT 都跟着走）', async () => {
    const calls = fakeFetch(() => json({ has_image: true }));
    useBackgroundStore.getState().setImage('data:image/png;base64,AAAB');
    await useAppearanceSync.getState().push();
    const posts = () => calls.filter(c => c.method === 'POST').length;
    expect(posts(), '第一次推送应上传图片').toBe(1);

    // 只改参数、不换图 → 不该再上传
    useBackgroundStore.getState().setDim(40);
    await useAppearanceSync.getState().push();
    expect(posts(), '没换图时不该重复上传').toBe(1);
  });
});