Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

9.8 KB
Raw Blame
import { describe, expect, it } from 'vitest';
import {
  compareVersions,
  evaluateBundleUpdate,
  parseLatestRelease,
  preferredInstallUrl,
  shouldCheckBundleUpdate,
} from './bundleUpdate';

const VALID = {
  version: '1.2.0',
  buildNumber: '2026070101',
  runtimeVersion: 'rtv-new',
  installUrl: 'https://npkg.example.com/install/42',
  itmsUrl: 'itms-services://?action=download-manifest&url=https%3A%2F%2Fx%2Fplist%2F42',
};

const UNSUPPORTED_VERSIONS = [
  '1.0.0-beta.1',
  '1.0.0+build.1',
  'v2.0.0',
  '1..2',
  '1.0.-1',
  '1.0.1e2',
  '1.0.Infinity',
  '1.0.9007199254740992',
];

describe('shouldCheckBundleUpdate', () => {
  it.each([
    ['非自建分发', false, false, false, false],
    ['正式自建分发', true, false, false, true],
    ['审核模式', true, true, false, false],
    ['TestFlight', true, false, true, false],
  ] as const)(
    '%s → %s',
    (_label, isSelfHosted, isReviewMode, isTestFlightBuild, expected) => {
      expect(shouldCheckBundleUpdate({
        isSelfHosted,
        isReviewMode,
        isTestFlightBuild,
        isGooglePlayInstallation: false,
      })).toBe(expected);
    },
  );

  it('Google Play 安装跳过官网 APK 整包记录', () => {
    expect(shouldCheckBundleUpdate({
      isSelfHosted: true,
      isReviewMode: false,
      isTestFlightBuild: false,
      isGooglePlayInstallation: true,
    })).toBe(false);
  });
});

describe('parseLatestRelease', () => {
  it('接受完整记录', () => {
    expect(parseLatestRelease(VALID)?.runtimeVersion).toBe('rtv-new');
  });
  it('缺 runtimeVersion 或安装地址 → null', () => {
    expect(parseLatestRelease({ ...VALID, runtimeVersion: '' })).toBeNull();
    expect(parseLatestRelease({ ...VALID, installUrl: '', itmsUrl: '' })).toBeNull();
  });
  it('非对象 → null', () => {
    expect(parseLatestRelease(null)).toBeNull();
    expect(parseLatestRelease('x')).toBeNull();
  });

  it.each(UNSUPPORTED_VERSIONS)('version=%s 不受支持 → 无效记录', (version) => {
    expect(parseLatestRelease({ ...VALID, version })).toBeNull();
  });

  it.each(UNSUPPORTED_VERSIONS)('minVersion=%s 不受支持 → 无效记录', (minVersion) => {
    expect(parseLatestRelease({ ...VALID, minVersion })).toBeNull();
  });

  it.each(['1', '1.2', '01.002.0003', '1.2.0.0', '1.0.9007199254740991'])('保留纯数字版本 %s 的兼容性', (version) => {
    expect(parseLatestRelease({ ...VALID, version })?.version).toBe(version);
  });
});

describe('compareVersions', () => {
  it('语义化比较', () => {
    expect(compareVersions('1.0.0', '1.0.1')).toBe(-1);
    expect(compareVersions('1.2.0', '1.2.0')).toBe(0);
    expect(compareVersions('2.0', '1.9.9')).toBe(1);
  });
});

describe('evaluateBundleUpdate', () => {
  it.each(UNSUPPORTED_VERSIONS)('服务端 version=%s 不受支持 → 不提示整包', (version) => {
    const evaluation = evaluateBundleUpdate({
      currentRuntimeVersion: 'rtv-old',
      currentVersion: '1.0.0',
      latest: { ...VALID, version },
    });
    expect(evaluation).toEqual({ needsUpdate: false, forced: false, target: null });
  });

  it.each(UNSUPPORTED_VERSIONS)('本机 currentVersion=%s 不受支持 → 不提示整包', (currentVersion) => {
    const evaluation = evaluateBundleUpdate({
      currentRuntimeVersion: 'rtv-old',
      currentVersion,
      latest: { ...VALID, minVersion: '1.2.0' },
    });
    expect(evaluation).toEqual({ needsUpdate: false, forced: false, target: null });
  });

  it.each(UNSUPPORTED_VERSIONS)('服务端 minVersion=%s 不受支持 → 不提示整包', (minVersion) => {
    const evaluation = evaluateBundleUpdate({
      currentRuntimeVersion: 'rtv-old',
      currentVersion: '1.0.0',
      latest: { ...VALID, minVersion },
    });
    expect(evaluation).toEqual({ needsUpdate: false, forced: false, target: null });
  });

  it('版本周围的空格不影响纯数字版本比较', () => {
    const evaluation = evaluateBundleUpdate({
      currentRuntimeVersion: 'rtv-old',
      currentVersion: ' 1.1.0 ',
      latest: { ...VALID, version: ' 1.2.0 ', minVersion: ' 1.1.0 ' },
    });
    expect(evaluation.needsUpdate).toBe(true);
    expect(evaluation.forced).toBe(false);
    expect(evaluation.target?.version).toBe('1.2.0');
  });

  it('runtimeVersion 相同 → 无整包更新(交给 JS OTA)', () => {
    const r = evaluateBundleUpdate({ currentRuntimeVersion: 'rtv-new', currentVersion: '1.1.0', latest: VALID });
    expect(r.needsUpdate).toBe(false);
    expect(r.target).toBeNull();
  });

  it('runtimeVersion 不同 → 需要整包更新', () => {
    const r = evaluateBundleUpdate({ currentRuntimeVersion: 'rtv-old', currentVersion: '1.1.0', latest: VALID });
    expect(r.needsUpdate).toBe(true);
    expect(r.forced).toBe(false);
    expect(r.target?.itmsUrl).toBe(VALID.itmsUrl);
  });

  it.each([
    ['0.1.4', 'rtv-old', undefined],
    ['0.1.4', 'rtv-new', undefined],
    ['0.1.5', 'rtv-old', undefined],
    ['0.1.5', 'rtv-new', undefined],
    ['0.1.5.0', 'rtv-old', undefined],
    ['0.1.4', 'rtv-old', '0.1.6'],
    ['0.1.5', 'rtv-old', '0.1.6'],
  ])('本机 0.1.5 忽略服务端 version=%s / runtime=%s / minVersion=%s 的整包', (version, runtimeVersion, minVersion) => {
    const evaluation = evaluateBundleUpdate({
      currentRuntimeVersion: 'rtv-new',
      currentVersion: '0.1.5',
      latest: { ...VALID, version, runtimeVersion, minVersion, buildNumber: 9999999999 },
    });
    expect(evaluation).toEqual({ needsUpdate: false, forced: false, target: null });
  });

  it('更高的多位 patch 版本 → 普通整包更新(按数值而非字符串比较)', () => {
    const evaluation = evaluateBundleUpdate({
      currentRuntimeVersion: 'rtv-old',
      currentVersion: '0.1.9',
      latest: { ...VALID, version: '0.1.10' },
    });
    expect(evaluation.needsUpdate).toBe(true);
    expect(evaluation.forced).toBe(false);
    expect(evaluation.target?.version).toBe('0.1.10');
  });

  it('minVersion 高于当前 → 强制', () => {
    const r = evaluateBundleUpdate({
      currentRuntimeVersion: 'rtv-old',
      currentVersion: '1.0.0',
      latest: { ...VALID, minVersion: '1.2.0' },
    });
    expect(r.needsUpdate).toBe(true);
    expect(r.forced).toBe(true);
  });

  it('minVersion 不高于当前 → 不强制', () => {
    const r = evaluateBundleUpdate({
      currentRuntimeVersion: 'rtv-old',
      currentVersion: '1.1.0',
      latest: { ...VALID, minVersion: '1.1.0' },
    });
    expect(r.needsUpdate).toBe(true);
    expect(r.forced).toBe(false);
  });

  it('runtimeVersion 相同但低于 minVersion → 仍然强更(门槛不经指纹门闸)', () => {
    // 服务端可以对某个已发布版本事后下发门槛;此时装机指纹与 /latest 一致,但 version
    // 低于门槛 —— 必须命中强更,否则发布链写了 minVersion 也拦不住同指纹的旧构建。
    const r = evaluateBundleUpdate({
      currentRuntimeVersion: 'rtv-new',
      currentVersion: '1.0.0',
      latest: { ...VALID, minVersion: '1.2.0' },
    });
    expect(r.needsUpdate).toBe(true);
    expect(r.forced).toBe(true);
    // 同指纹强更时 target.runtimeVersion 就等于当前值,消费方不得据此判断"换了指纹"。
    expect(r.target?.runtimeVersion).toBe('rtv-new');
  });

  it('runtimeVersion 相同且不低于 minVersion → 无更新', () => {
    const r = evaluateBundleUpdate({
      currentRuntimeVersion: 'rtv-new',
      currentVersion: '1.1.0',
      latest: { ...VALID, minVersion: '1.1.0' },
    });
    expect(r.needsUpdate).toBe(false);
    expect(r.target).toBeNull();
  });

  it.each([undefined, null, '', '   '])('record version=%s → 不提示(无法证明服务端版本更高)', (version) => {
    const evaluation = evaluateBundleUpdate({
      currentRuntimeVersion: 'rtv-old',
      currentVersion: '1.0.0',
      latest: { ...VALID, version, minVersion: '1.2.0' },
    });
    expect(evaluation).toEqual({ needsUpdate: false, forced: false, target: null });
  });

  it('minVersion 高于该记录自己的 version → 不强更(装完仍低于门槛,阻断屏会没有出口)', () => {
    // 发布链侧 assertMinVersionUsable 已禁止这种记录;客户端兜底手工改过 / 历史遗留的指针。
    const r = evaluateBundleUpdate({
      currentRuntimeVersion: 'rtv-old',
      currentVersion: '1.0.0',
      latest: { ...VALID, version: '1.1.0', minVersion: '1.2.0' },
    });
    expect(r.forced).toBe(false);
    expect(r.needsUpdate).toBe(true); // 仍是可跳过的普通更新
  });

  it('minVersion 等于该记录的 version → 正常强更(边界)', () => {
    const r = evaluateBundleUpdate({
      currentRuntimeVersion: 'rtv-old',
      currentVersion: '1.0.0',
      latest: { ...VALID, version: '1.2.0', minVersion: '1.2.0' },
    });
    expect(r.forced).toBe(true);
  });

  it.each([undefined, null, '', '   '])('currentVersion=%s → 不提示(无法比较,fail-open)', (currentVersion) => {
    const evaluation = evaluateBundleUpdate({
      currentRuntimeVersion: 'rtv-old',
      currentVersion,
      latest: { ...VALID, minVersion: '1.2.0' },
    });
    expect(evaluation).toEqual({ needsUpdate: false, forced: false, target: null });
  });

  it('拿不到当前 runtimeVersion(dev / 未启用)→ 无更新', () => {
    expect(evaluateBundleUpdate({ currentRuntimeVersion: null, currentVersion: '1.0.0', latest: VALID }).needsUpdate).toBe(false);
    expect(evaluateBundleUpdate({ currentRuntimeVersion: '', currentVersion: '1.0.0', latest: VALID }).needsUpdate).toBe(false);
  });

  it('/latest 无效 → 无更新', () => {
    expect(evaluateBundleUpdate({ currentRuntimeVersion: 'rtv-old', currentVersion: '1.0.0', latest: {} }).needsUpdate).toBe(false);
  });
});

describe('preferredInstallUrl', () => {
  it('优先 itms,回退 installUrl', () => {
    expect(preferredInstallUrl(VALID)).toBe(VALID.itmsUrl);
    expect(preferredInstallUrl({ installUrl: 'https://web' })).toBe('https://web');
    expect(preferredInstallUrl({})).toBeNull();
  });
});