Claude-Code-Workflow/ccw/tests/update-checker.test.ts

/**
 * Unit tests for update-checker utility module.
 *
 * Tests version comparison logic with semver support including prerelease versions.
 */

import { describe, it } from 'node:test';
import assert from 'node:assert/strict';

// We need to test the compareVersions function which is not exported
// So we'll create a standalone copy for testing purposes
function parseVersion(version: string): { major: number; minor: number; patch: number; prerelease: string[] } {
  const cleaned = version.replace(/^v/, '');
  const [mainPart, prereleasePart] = cleaned.split('-');
  const parts = mainPart.split('.');
  const major = parseInt(parts[0], 10) || 0;
  const minor = parseInt(parts[1], 10) || 0;
  const patch = parseInt(parts[2], 10) || 0;
  const prerelease = prereleasePart ? prereleasePart.split('.') : [];

  return { major, minor, patch, prerelease };
}

function compareVersions(a: string, b: string): number {
  const vA = parseVersion(a);
  const vB = parseVersion(b);

  // Compare major.minor.patch
  if (vA.major !== vB.major) return vA.major > vB.major ? 1 : -1;
  if (vA.minor !== vB.minor) return vA.minor > vB.minor ? 1 : -1;
  if (vA.patch !== vB.patch) return vA.patch > vB.patch ? 1 : -1;

  // Handle prerelease: no prerelease > has prerelease
  // e.g., 1.0.0 > 1.0.0-alpha
  if (vA.prerelease.length === 0 && vB.prerelease.length > 0) return 1;
  if (vA.prerelease.length > 0 && vB.prerelease.length === 0) return -1;

  // Compare prerelease identifiers
  const maxLen = Math.max(vA.prerelease.length, vB.prerelease.length);
  for (let i = 0; i < maxLen; i++) {
    const partA = vA.prerelease[i];
    const partB = vB.prerelease[i];

    // Missing part is less (1.0.0-alpha < 1.0.0-alpha.1)
    if (partA === undefined) return -1;
    if (partB === undefined) return 1;

    // Numeric comparison if both are numbers
    const numA = parseInt(partA, 10);
    const numB = parseInt(partB, 10);
    if (!isNaN(numA) && !isNaN(numB)) {
      if (numA !== numB) return numA > numB ? 1 : -1;
    } else {
      // String comparison
      if (partA !== partB) return partA > partB ? 1 : -1;
    }
  }

  return 0;
}

describe('update-checker: parseVersion', () => {
  it('should parse basic version', () => {
    const result = parseVersion('1.2.3');
    assert.equal(result.major, 1);
    assert.equal(result.minor, 2);
    assert.equal(result.patch, 3);
    assert.deepEqual(result.prerelease, []);
  });

  it('should parse version with v prefix', () => {
    const result = parseVersion('v1.2.3');
    assert.equal(result.major, 1);
    assert.equal(result.minor, 2);
    assert.equal(result.patch, 3);
  });

  it('should parse version with alpha prerelease', () => {
    const result = parseVersion('1.0.0-alpha');
    assert.equal(result.major, 1);
    assert.equal(result.minor, 0);
    assert.equal(result.patch, 0);
    assert.deepEqual(result.prerelease, ['alpha']);
  });

  it('should parse version with numeric prerelease', () => {
    const result = parseVersion('1.0.0-alpha.1');
    assert.deepEqual(result.prerelease, ['alpha', '1']);
  });

  it('should parse version with rc prerelease', () => {
    const result = parseVersion('2.5.0-rc.3');
    assert.equal(result.major, 2);
    assert.equal(result.minor, 5);
    assert.equal(result.patch, 0);
    assert.deepEqual(result.prerelease, ['rc', '3']);
  });

  it('should handle missing patch version', () => {
    const result = parseVersion('1.2');
    assert.equal(result.major, 1);
    assert.equal(result.minor, 2);
    assert.equal(result.patch, 0);
  });

  it('should handle missing minor and patch', () => {
    const result = parseVersion('3');
    assert.equal(result.major, 3);
    assert.equal(result.minor, 0);
    assert.equal(result.patch, 0);
  });
});

describe('update-checker: compareVersions', () => {
  describe('major version comparison', () => {
    it('should return 1 when first major is greater', () => {
      assert.equal(compareVersions('2.0.0', '1.0.0'), 1);
      assert.equal(compareVersions('3.5.2', '2.8.9'), 1);
    });

    it('should return -1 when first major is less', () => {
      assert.equal(compareVersions('1.0.0', '2.0.0'), -1);
      assert.equal(compareVersions('1.9.9', '2.0.0'), -1);
    });
  });

  describe('minor version comparison', () => {
    it('should return 1 when major equal and first minor is greater', () => {
      assert.equal(compareVersions('1.2.0', '1.1.0'), 1);
      assert.equal(compareVersions('3.5.0', '3.4.9'), 1);
    });

    it('should return -1 when major equal and first minor is less', () => {
      assert.equal(compareVersions('1.1.0', '1.2.0'), -1);
      assert.equal(compareVersions('2.3.5', '2.4.0'), -1);
    });
  });

  describe('patch version comparison', () => {
    it('should return 1 when major.minor equal and first patch is greater', () => {
      assert.equal(compareVersions('1.2.5', '1.2.3'), 1);
      assert.equal(compareVersions('2.0.1', '2.0.0'), 1);
    });

    it('should return -1 when major.minor equal and first patch is less', () => {
      assert.equal(compareVersions('1.2.3', '1.2.5'), -1);
      assert.equal(compareVersions('3.1.0', '3.1.2'), -1);
    });
  });

  describe('equal versions', () => {
    it('should return 0 for identical versions', () => {
      assert.equal(compareVersions('1.2.3', '1.2.3'), 0);
      assert.equal(compareVersions('v1.2.3', '1.2.3'), 0);
    });

    it('should return 0 for equal versions with missing parts', () => {
      assert.equal(compareVersions('1.2', '1.2.0'), 0);
      assert.equal(compareVersions('2', '2.0.0'), 0);
    });
  });

  describe('prerelease version comparison', () => {
    it('should treat stable version as greater than prerelease', () => {
      assert.equal(compareVersions('1.0.0', '1.0.0-alpha'), 1);
      assert.equal(compareVersions('1.0.0', '1.0.0-beta'), 1);
      assert.equal(compareVersions('1.0.0', '1.0.0-rc.1'), 1);
    });

    it('should treat prerelease version as less than stable', () => {
      assert.equal(compareVersions('1.0.0-alpha', '1.0.0'), -1);
      assert.equal(compareVersions('1.0.0-beta', '1.0.0'), -1);
      assert.equal(compareVersions('2.5.0-rc.2', '2.5.0'), -1);
    });

    it('should compare prerelease identifiers alphabetically', () => {
      assert.equal(compareVersions('1.0.0-beta', '1.0.0-alpha'), 1);
      assert.equal(compareVersions('1.0.0-alpha', '1.0.0-beta'), -1);
      assert.equal(compareVersions('1.0.0-rc', '1.0.0-beta'), 1);
    });

    it('should compare numeric prerelease identifiers numerically', () => {
      assert.equal(compareVersions('1.0.0-alpha.2', '1.0.0-alpha.1'), 1);
      assert.equal(compareVersions('1.0.0-alpha.1', '1.0.0-alpha.2'), -1);
      assert.equal(compareVersions('1.0.0-beta.10', '1.0.0-beta.2'), 1);
    });

    it('should handle missing prerelease parts', () => {
      assert.equal(compareVersions('1.0.0-alpha.1', '1.0.0-alpha'), 1);
      assert.equal(compareVersions('1.0.0-alpha', '1.0.0-alpha.1'), -1);
    });

    it('should handle complex prerelease comparisons', () => {
      assert.equal(compareVersions('1.0.0-alpha.1', '1.0.0-alpha.1'), 0);
      assert.equal(compareVersions('1.0.0-rc.1', '1.0.0-beta.10'), 1);
      assert.equal(compareVersions('2.0.0-beta.1', '2.0.0-alpha.9'), 1);
    });
  });

  describe('real-world version scenarios', () => {
    it('should correctly order common npm package versions', () => {
      const versions = [
        '1.0.0-alpha',
        '1.0.0-alpha.1',
        '1.0.0-beta',
        '1.0.0-beta.2',
        '1.0.0-rc.1',
        '1.0.0',
        '1.0.1',
        '1.1.0',
        '2.0.0'
      ];

      for (let i = 0; i < versions.length - 1; i++) {
        const result = compareVersions(versions[i + 1], versions[i]);
        assert.equal(result, 1, `Expected ${versions[i + 1]} > ${versions[i]}`);
      }
    });

    it('should handle version with v prefix correctly', () => {
      assert.equal(compareVersions('v2.0.0', '1.9.9'), 1);
      assert.equal(compareVersions('v1.0.0-beta', 'v1.0.0'), -1);
    });
  });
});