Update the script responsible for updating the package version (#3934)

## Description

Updates the `set-package-version` script to also support beta and
release candidate versions. Since those two may not be published from a
stable branch, they require explicit version to be set.

The version format for those releases would be:
```
{major}.{minor}.{patch}-rc.{rcVersion}
{major}.{minor}.{patch}-beta.{betaVersion}
```

## Test plan

Run the script in different configurations

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: j-piasecki

scripts/release/set-package-version.js

@@ -2,9 +2,17 @@ const fs = require('fs');
 const { execSync } = require('child_process');
 const { getPackageVersionByTag } = require('./npm-utils');
 const { parseVersion, getStableBranchVersion } = require('./version-utils');
+const assert = require('assert');
 
 const PACKAGE_PATH = './packages/react-native-gesture-handler/package.json';
 
+const ReleaseType = {
+  STABLE: 'stable',
+  BETA: 'beta',
+  RELEASE_CANDIDATE: 'rc',
+  COMMITLY: 'commitly',
+};
+
 function getLatestVersion() {
   const latestVersion = getPackageVersionByTag('react-native-gesture-handler', 'latest');
 
@@ -37,9 +45,24 @@ function getNextStableVersion() {
   }
 }
 
-function getVersion(isCommitly) {
-  if (isCommitly) {
-    const [major, minor] = getLatestVersion()
+function getNextPreReleaseVersion(releaseType, version) {
+  let dotIndex = 1;
+  while (true) {
+    const targetVersion = `${version}-${releaseType}.${dotIndex}`;
+    
+    try {
+      // if the version is already published, increment the pre-release sequence (rc/beta number) and try again
+      getPackageVersionByTag('react-native-gesture-handler', targetVersion);
+      dotIndex++;
+    } catch (error) {
+      return targetVersion;
+    }
+  }
+}
+
+function getVersion(releaseType, preReleaseVersion = null) {
+  if (releaseType === ReleaseType.COMMITLY) {
+    const [major, minor] = getLatestVersion();
 
     const currentSHA = execSync('git rev-parse HEAD').toString().trim();
     const now = new Date();
@@ -50,15 +73,62 @@ function getVersion(isCommitly) {
 
     const commitlyVersion = `${major}.${minor + 1}.${0}-nightly-${currentDate}-${currentSHA.slice(0, 9)}`;
     return commitlyVersion;
+  } else if (releaseType === ReleaseType.BETA || releaseType === ReleaseType.RELEASE_CANDIDATE) {
+    if (preReleaseVersion == null) {
+      throw new Error(`Version must be provided for ${releaseType} releases`);
+    }
+
+    return getNextPreReleaseVersion(releaseType, preReleaseVersion);
   }
 
   const [major, minor, patch] = getNextStableVersion();
   return `${major}.${minor}.${patch}`;
 }
 
 function setPackageVersion() {
-  const isCommitly = process.argv.includes('--commitly');
-  const version = getVersion(isCommitly);
+  let version = null;
+  let isCommitly = false;
+  let isBeta = false;
+  let isReleaseCandidate = false;
+
+  for (let i = 2; i < process.argv.length; i++) {
+    const arg = process.argv[i];
+    if (arg === '--commitly') {
+      isCommitly = true;
+    } else if (arg === '--beta') {
+      isBeta = true;
+    } else if (arg === '--rc') {
+      isReleaseCandidate = true;
+    } else if (arg === '--version') {
+      if (i + 1 < process.argv.length) {
+        version = process.argv[i + 1];
+        i++;
+      } else {
+        throw new Error('Expected a version after --version');
+      }
+    }
+  }
+
+  assert([isCommitly, isBeta, isReleaseCandidate].filter(Boolean).length <= 1, 'Release flags --commitly, --beta, and --rc are mutually exclusive; specify at most one');
+  assert(version === null || isBeta || isReleaseCandidate, 'Version should not be provided for stable nor commitly releases');
+  assert(version !== null || (!isBeta && !isReleaseCandidate), 'Version must be provided for beta and release candidate releases');
+
+  const releaseType = isCommitly
+    ? ReleaseType.COMMITLY
+    : isBeta
+      ? ReleaseType.BETA
+      : isReleaseCandidate
+        ? ReleaseType.RELEASE_CANDIDATE
+        : ReleaseType.STABLE;
+
+  if (version != null) {
+    const versionRegex = /^(\d+)\.(\d+)\.(\d+)$/;
+    if (!versionRegex.test(version)) {
+      throw new Error(`Provided version "${version}" is not valid. Expected format: x.y.z`);
+    }
+  }
+
+  version = getVersion(releaseType, version);
 
   const packageJson = JSON.parse(fs.readFileSync(PACKAGE_PATH, 'utf8'));
   packageJson.version = version;
@@ -68,4 +138,6 @@ function setPackageVersion() {
   console.log(version);
 }
 
-setPackageVersion();
+if (require.main === module) {
+  setPackageVersion();
+}

scripts/release/should-be-latest.js

@@ -2,9 +2,15 @@ const { getPackageVersionByTag } = require('./npm-utils');
 const { parseVersion } = require('./version-utils');
 
 function shouldBeLatest(version) {
+  const [newMajor, newMinor, newPatch, newPreRelease] = parseVersion(version);
+
+  // Pre-releases should never be latest
+  if (newPreRelease !== null) {
+    return false;
+  }
+
   const latestVersion = getPackageVersionByTag('react-native-gesture-handler', 'latest');
   const [major, minor, patch] = parseVersion(latestVersion);
-  const [newMajor, newMinor, newPatch] = parseVersion(version);
 
   // TODO: We'll worry about 3.x.x later :)
   if (newMajor !== major) {

scripts/release/version-utils.js

@@ -1,11 +1,15 @@
 const { execSync } = require('child_process');
 
-const VERSION_REGEX = /^(\d+)\.(\d+)\.(\d+)$/;
+const VERSION_REGEX = /^(\d+)\.(\d+)\.(\d+)(-.*)?$/;
 const BRANCH_REGEX = /^(\d+)\.(\d+)-stable$/;
 
 function parseVersion(version) {
-  const [, major, minor, patch] = version.match(VERSION_REGEX);
-  return [Number(major), Number(minor), Number(patch)];
+  const match = version.match(VERSION_REGEX);
+  if (!match) {
+    throw new Error(`Invalid version string: ${version}`);
+  }
+  const [, major, minor, patch, preRelease] = match;
+  return [Number(major), Number(minor), Number(patch), preRelease || null];
 }
 
 function getStableBranchVersion() {