heygen-com--hyperframes/scripts/set-version.test.ts

import assert from "node:assert/strict";
import { describe, it } from "node:test";
import {
  changelogArtifacts,
  compareSemver,
  findBlockingTags,
  findUnexpectedChanges,
  isPrerelease,
  parseReleaseOptions,
  releaseAllowedPaths,
  releaseRequiresChangelog,
  splitNulList,
} from "./set-version.ts";

describe("set-version release options", () => {
  it("parses stable release flags", () => {
    assert.deepEqual(parseReleaseOptions(["1.2.3", "--no-tag", "--skip-changelog-check"]), {
      version: "1.2.3",
      skipTag: true,
      skipChangelogCheck: true,
      skipMonotonicityCheck: false,
    });
  });

  it("parses --skip-monotonicity-check flag", () => {
    assert.deepEqual(parseReleaseOptions(["0.6.82", "--skip-monotonicity-check"]), {
      version: "0.6.82",
      skipTag: false,
      skipChangelogCheck: false,
      skipMonotonicityCheck: true,
    });
  });

  it("requires reviewed changelog artifacts for stable tagged releases", () => {
    assert.equal(
      releaseRequiresChangelog({
        version: "1.2.3",
        skipTag: false,
        skipChangelogCheck: false,
      }),
      true,
    );
  });

  it("does not require changelog artifacts for prereleases, no-tag bumps, or emergency skips", () => {
    assert.equal(isPrerelease("1.2.3-alpha.1"), true);
    assert.equal(
      releaseRequiresChangelog({
        version: "1.2.3-alpha.1",
        skipTag: false,
        skipChangelogCheck: false,
      }),
      false,
    );
    assert.equal(
      releaseRequiresChangelog({
        version: "1.2.3",
        skipTag: true,
        skipChangelogCheck: false,
      }),
      false,
    );
    assert.equal(
      releaseRequiresChangelog({
        version: "1.2.3",
        skipTag: false,
        skipChangelogCheck: true,
      }),
      false,
    );
  });

  it("tracks both GitHub release and docs changelog artifacts", () => {
    assert.deepEqual(changelogArtifacts("1.2.3"), [
      "releases/v1.2.3.md",
      "docs/changelog.mdx#HyperFrames v1.2.3",
    ]);
  });
});

describe("tag-monotonicity guard", () => {
  it("blocks a higher tag that is reachable from HEAD", () => {
    assert.deepEqual(
      findBlockingTags(["0.6.112", "0.7.0"], "0.6.113", () => true),
      ["0.7.0"],
    );
  });

  it("ignores a higher tag that is not reachable from HEAD (orphan)", () => {
    // v1.0.3 is higher but lives on a dead branch — not an ancestor of HEAD.
    assert.deepEqual(
      findBlockingTags(["0.6.112", "1.0.3"], "0.6.113", (t) => t !== "1.0.3"),
      [],
    );
  });

  it("ignores lower-or-equal tags regardless of reachability", () => {
    assert.deepEqual(
      findBlockingTags(["0.6.112", "0.6.113"], "0.6.113", () => true),
      [],
    );
  });
});

describe("semver comparison", () => {
  it("returns negative when a < b", () => {
    assert.ok(compareSemver("0.6.82", "1.0.3") < 0);
  });

  it("returns positive when a > b", () => {
    assert.ok(compareSemver("1.0.4", "0.6.82") > 0);
  });

  it("returns zero for equal versions", () => {
    assert.equal(compareSemver("0.6.82", "0.6.82"), 0);
  });

  it("compares major version first", () => {
    assert.ok(compareSemver("2.0.0", "1.99.99") > 0);
  });

  it("compares minor when major is equal", () => {
    assert.ok(compareSemver("0.7.0", "0.6.99") > 0);
  });

  it("compares patch when major and minor are equal", () => {
    assert.ok(compareSemver("0.6.83", "0.6.82") > 0);
  });
});

describe("changed-path guard", () => {
  it("splits NUL-separated git output and drops the empty trailing entry", () => {
    assert.deepEqual(splitNulList("packages/core/package.json\0releases/v1.2.3.md\0"), [
      "packages/core/package.json",
      "releases/v1.2.3.md",
    ]);
    assert.deepEqual(splitNulList(""), []);
  });

  it("accepts a release whose changes are all allowed paths", () => {
    const allowed = releaseAllowedPaths("1.2.3");
    assert.deepEqual(
      findUnexpectedChanges(
        [
          "packages/core/package.json",
          "packages/sdk/package.json",
          ".claude-plugin/plugin.json",
          "releases/v1.2.3.md",
        ],
        allowed,
      ),
      [],
    );
  });

  it("flags changes outside the allowed release paths", () => {
    const allowed = releaseAllowedPaths("1.2.3");
    assert.deepEqual(
      findUnexpectedChanges(["packages/core/package.json", "packages/core/src/index.ts"], allowed),
      ["packages/core/src/index.ts"],
    );
  });
});