software-mansion__argent/scripts/next-canary-version.mjs

#!/usr/bin/env node
/**
 * Compute the version for a canary prerelease published on every push to main:
 *
 *   <patch-bump of the highest STABLE published version>-next.<counter>
 *
 * e.g. with latest=0.13.0 and no canaries yet → `0.13.1-next.0`.
 *
 * Why patch-bump-of-stable: each main build is a preview of the next patch
 * release. A prerelease of 0.13.1 still outranks the 0.13.0 release by SemVer
 * precedence, so `next` always lands strictly above `latest`, while staying
 * below the eventual 0.13.1 stable.
 *
 * The counter resets per base: it's the next index after the highest
 * `<base>-next.<k>` already on npm, or 0 if this base has no canaries yet. So
 * each new patch line starts at `.0` and increments per publish:
 *   0.13.1-next.0, 0.13.1-next.1, ...  then 0.13.1 ships stable  ...
 *   0.13.2-next.0, 0.13.2-next.1, ...
 *
 * Because the counter is read from the registry, the `concurrency` group in
 * publish-next.yml serializes canary publishes so two runs can't read the same
 * index at once. That removes the concurrent race but not npm's read-after-write
 * lag (a freshly published version may not be visible to the next run's read for
 * a few seconds), so the publish step ALSO retries on a version-exists collision
 * by recomputing — see "Publish canary" in publish-next.yml. Either way a
 * collision fails safe (npm 409, no bad artifact, no tag move).
 *
 * Zero npm dependencies (runs in a lightweight CI job without `npm ci`); the
 * SemVer helpers are shared with sync-next-dist-tag.mjs.
 *
 * Usage:
 *   node scripts/next-canary-version.mjs           print the canary version
 *   node scripts/next-canary-version.mjs --write    also stamp it into
 *                                                    packages/argent/package.json
 */

import { execFileSync } from "node:child_process";
import { readFileSync, writeFileSync } from "node:fs";
import { argv as processArgv } from "node:process";
import { pathToFileURL } from "node:url";
import { compareSemver, parseSemver } from "./sync-next-dist-tag.mjs";

const PACKAGE = "@swmansion/argent";
const PKG_JSON = "packages/argent/package.json";

/**
 * Pure version math, separated from npm I/O so it can be unit-tested.
 * @param {string[]} versions  published versions (unparseable entries ignored)
 * @returns {string} the canary version, e.g. "0.13.1-next.0"
 */
export function computeCanaryVersion(versions) {
  const valid = versions.filter((v) => parseSemver(v) !== null);
  if (valid.length === 0) {
    throw new Error("no parseable published versions found");
  }

  const stable = valid.filter((v) => parseSemver(v).pre.length === 0);
  // Prefer the highest stable release and bump its patch. With no stable
  // release yet, preview the highest prerelease's own target version (no bump).
  const pool = stable.length > 0 ? stable : valid;
  const { main } = parseSemver(pool.slice().sort((a, b) => compareSemver(b, a))[0]);
  const [major, minor, patch] = main;
  const base = stable.length > 0 ? [major, minor, patch + 1] : [major, minor, patch];

  // Counter resets per base: next index after the highest existing
  // `<base>-next.<k>`, or 0 if this base has no canaries yet.
  let counter = 0;
  for (const v of valid) {
    const { main: m, pre } = parseSemver(v);
    const sameBase = m[0] === base[0] && m[1] === base[1] && m[2] === base[2];
    if (sameBase && pre.length === 2 && pre[0] === "next" && /^\d+$/.test(pre[1])) {
      counter = Math.max(counter, Number(pre[1]) + 1);
    }
  }

  return `${base[0]}.${base[1]}.${base[2]}-next.${counter}`;
}

function main() {
  const write = processArgv.includes("--write");
  const raw = JSON.parse(
    execFileSync("npm", ["view", PACKAGE, "versions", "--json"], { encoding: "utf8" })
  );
  // npm returns a bare string when a package has exactly one published version.
  const versions = Array.isArray(raw) ? raw : [raw];
  const version = computeCanaryVersion(versions);

  if (write) {
    const pkg = JSON.parse(readFileSync(PKG_JSON, "utf8"));
    pkg.version = version;
    writeFileSync(PKG_JSON, JSON.stringify(pkg, null, 2) + "\n");
  }

  process.stdout.write(version + "\n");
}

// Run only when invoked directly, not when imported by the test.
if (processArgv[1] && import.meta.url === pathToFileURL(processArgv[1]).href) {
  main();
}