smartmigration/test/test.versionresolver.ts

import { tap, expect } from '@git.zone/tstest/tapbundle';
import { VersionResolver, SmartMigrationError } from '../ts/index.js';
import type { IMigrationStepDefinition } from '../ts/index.js';

const noopHandler = async () => {};

function makeStep(id: string, from: string, to: string): IMigrationStepDefinition {
  return { id, fromVersion: from, toVersion: to, isResumable: false, handler: noopHandler };
}

tap.test('equals / lessThan / greaterThan', async () => {
  expect(VersionResolver.equals('1.0.0', '1.0.0')).toBeTrue();
  expect(VersionResolver.equals('1.0.0', '1.0.1')).toBeFalse();
  expect(VersionResolver.lessThan('1.0.0', '1.0.1')).toBeTrue();
  expect(VersionResolver.greaterThan('2.0.0', '1.99.99')).toBeTrue();
});

tap.test('assertValid: throws on garbage', async () => {
  let caught: SmartMigrationError | undefined;
  try {
    VersionResolver.assertValid('not-a-version', 'test');
  } catch (err) {
    caught = err as SmartMigrationError;
  }
  expect(caught).toBeInstanceOf(SmartMigrationError);
  expect(caught!.code).toEqual('INVALID_VERSION');
});

tap.test('validateChain: empty chain is valid', async () => {
  VersionResolver.validateChain([]);
});

tap.test('validateChain: catches duplicate ids', async () => {
  let caught: SmartMigrationError | undefined;
  try {
    VersionResolver.validateChain([
      makeStep('a', '1.0.0', '1.1.0'),
      makeStep('a', '1.1.0', '1.2.0'),
    ]);
  } catch (err) {
    caught = err as SmartMigrationError;
  }
  expect(caught!.code).toEqual('DUPLICATE_STEP_ID');
});

tap.test('validateChain: catches non-increasing step', async () => {
  let caught: SmartMigrationError | undefined;
  try {
    VersionResolver.validateChain([makeStep('a', '1.5.0', '1.5.0')]);
  } catch (err) {
    caught = err as SmartMigrationError;
  }
  expect(caught!.code).toEqual('NON_INCREASING_STEP');
});

tap.test('validateChain: catches gap in chain', async () => {
  let caught: SmartMigrationError | undefined;
  try {
    VersionResolver.validateChain([
      makeStep('a', '1.0.0', '1.1.0'),
      makeStep('b', '1.2.0', '1.3.0'), // gap! a.to=1.1.0, b.from=1.2.0
    ]);
  } catch (err) {
    caught = err as SmartMigrationError;
  }
  expect(caught!.code).toEqual('CHAIN_GAP');
});

tap.test('validateChain: contiguous chain passes', async () => {
  VersionResolver.validateChain([
    makeStep('a', '1.0.0', '1.1.0'),
    makeStep('b', '1.1.0', '1.5.0'),
    makeStep('c', '1.5.0', '2.0.0'),
  ]);
});

tap.test('computePlan: returns empty when current === target', async () => {
  const steps = [makeStep('a', '1.0.0', '1.1.0')];
  expect(VersionResolver.computePlan(steps, '1.0.0', '1.0.0')).toEqual([]);
});

tap.test('computePlan: returns full chain when starting from beginning', async () => {
  const steps = [
    makeStep('a', '1.0.0', '1.1.0'),
    makeStep('b', '1.1.0', '1.5.0'),
    makeStep('c', '1.5.0', '2.0.0'),
  ];
  const plan = VersionResolver.computePlan(steps, '1.0.0', '2.0.0');
  expect(plan.map((s) => s.id)).toEqual(['a', 'b', 'c']);
});

tap.test('computePlan: returns partial chain when starting in the middle', async () => {
  const steps = [
    makeStep('a', '1.0.0', '1.1.0'),
    makeStep('b', '1.1.0', '1.5.0'),
    makeStep('c', '1.5.0', '2.0.0'),
  ];
  const plan = VersionResolver.computePlan(steps, '1.1.0', '2.0.0');
  expect(plan.map((s) => s.id)).toEqual(['b', 'c']);
});

tap.test('computePlan: returns sub-slice when target is mid-chain', async () => {
  const steps = [
    makeStep('a', '1.0.0', '1.1.0'),
    makeStep('b', '1.1.0', '1.5.0'),
    makeStep('c', '1.5.0', '2.0.0'),
  ];
  const plan = VersionResolver.computePlan(steps, '1.0.0', '1.5.0');
  expect(plan.map((s) => s.id)).toEqual(['a', 'b']);
});

tap.test('computePlan: skip-forward resume when current is inside a step range', async () => {
  // Chain: 1.0.0 → 1.1.0 → 2.0.0 → 3.0.0
  // Orphan install is stamped at 1.2.5 (between steps b and c). The planner
  // should resume at the first step whose toVersion > 1.2.5 (step b: 1.1.0 → 2.0.0),
  // then run step c to reach the target.
  const steps = [
    makeStep('a', '1.0.0', '1.1.0'),
    makeStep('b', '1.1.0', '2.0.0'),
    makeStep('c', '2.0.0', '3.0.0'),
  ];
  const plan = VersionResolver.computePlan(steps, '1.2.5', '3.0.0');
  expect(plan.map((s) => s.id)).toEqual(['b', 'c']);
});

tap.test('computePlan: skip-forward when current is below the first step fromVersion', async () => {
  // Chain: 1.0.0 → 1.1.0 → 2.0.0
  // Current 0.9.0 (below the chain's starting point). Should resume at step a
  // (its toVersion 1.1.0 > 0.9.0).
  const steps = [
    makeStep('a', '1.0.0', '1.1.0'),
    makeStep('b', '1.1.0', '2.0.0'),
  ];
  const plan = VersionResolver.computePlan(steps, '0.9.0', '2.0.0');
  expect(plan.map((s) => s.id)).toEqual(['a', 'b']);
});

tap.test('computePlan: throws TARGET_NOT_REACHABLE when current is past all step toVersions', async () => {
  // Chain: 1.0.0 → 1.1.0 → 2.0.0
  // Current 2.5.0 (past the chain's ending point), target 3.0.0.
  // No step can advance us (all toVersions ≤ 2.5.0 < target). Throw.
  const steps = [
    makeStep('a', '1.0.0', '1.1.0'),
    makeStep('b', '1.1.0', '2.0.0'),
  ];
  let caught: SmartMigrationError | undefined;
  try {
    VersionResolver.computePlan(steps, '2.5.0', '3.0.0');
  } catch (err) {
    caught = err as SmartMigrationError;
  }
  expect(caught).toBeDefined();
  expect(caught!.code).toEqual('TARGET_NOT_REACHABLE');
});

tap.test('computePlan: throws when target overshoots', async () => {
  const steps = [
    makeStep('a', '1.0.0', '1.1.0'),
    makeStep('b', '1.1.0', '2.0.0'),
  ];
  let caught: SmartMigrationError | undefined;
  try {
    VersionResolver.computePlan(steps, '1.0.0', '1.5.0');
  } catch (err) {
    caught = err as SmartMigrationError;
  }
  expect(caught!.code).toEqual('TARGET_NOT_REACHABLE');
});

tap.test('computePlan: rejects downgrade', async () => {
  const steps = [makeStep('a', '1.0.0', '2.0.0')];
  let caught: SmartMigrationError | undefined;
  try {
    VersionResolver.computePlan(steps, '2.0.0', '1.0.0');
  } catch (err) {
    caught = err as SmartMigrationError;
  }
  expect(caught!.code).toEqual('DOWNGRADE_NOT_SUPPORTED');
});

export default tap.start();