Add helper function to define release version

.github/scripts/defineVersion.js

@@ -0,0 +1,57 @@
+const semver = require('semver');
+
+function determinePreReleaseTag(existingVersion, targetReleaseLevel) {
+  const existingPreReleaseVersion = semver.prerelease(existingVersion);
+  if (existingPreReleaseVersion && existingPreReleaseVersion.length > 0) {
+    return `prerelease`;
+  }
+
+  return `pre${targetReleaseLevel}`;
+}
+
+function defineNewVersion(targetReleaseLevel, existingVersion, prereleaseTag) {
+  let releaseTag = targetReleaseLevel;
+
+  if (prereleaseTag) {
+    releaseTag = determinePreReleaseTag(existingVersion, targetReleaseLevel);
+  }
+
+  return semver.inc(existingVersion, releaseTag, prereleaseTag, undefined);
+}
+
+function getPlayerUiVersion(versionInput) {
+  let targetVersion = versionInput ?? process.env.CI_BRANCH;
+
+  if (!targetVersion) {
+    console.log('no version provided using CI_BRANCH');
+    process.exit(1);
+  }
+
+  const playerUiVersion = semver.valid(targetVersion);
+  if (!playerUiVersion) {
+    console.error(`${targetVersion} is not a valid semver`);
+    process.exit(1);
+  }
+
+  return {
+    major: semver.major(playerUiVersion),
+    minor: semver.minor(playerUiVersion),
+    patch: semver.patch(playerUiVersion),
+    prereleaseLabels: semver.prerelease(playerUiVersion),
+    full: playerUiVersion,
+  };
+}
+
+function defineReleaseVersion({ core }, targetReleaseLevel, prereleaseTag, givenVersion) {
+  core.info(
+    `Defining new release version for level ${targetReleaseLevel} and prereleaseTag ${prereleaseTag} given the version ${givenVersion}`,
+  );
+
+  const newVersion = defineNewVersion(targetReleaseLevel, givenVersion, prereleaseTag);
+
+  const parsedPlayerVersion = getPlayerUiVersion(newVersion);
+  core.info(`Using release version ${parsedPlayerVersion.full}`);
+  return parsedPlayerVersion;
+}
+
+module.exports.defineReleaseVersion = defineReleaseVersion;