autorel 2.3.1 → 2.3.3

package/dist/autorel.d.ts

@@ -0,0 +1,2 @@
+import { Config } from '.';
+export declare function autorel(args: Config): Promise<string | undefined>;

package/dist/autorel.js

@@ -0,0 +1,115 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.autorel = void 0;
+/* eslint-disable max-lines-per-function */
+const convCom = __importStar(require("./conventionalcommits"));
+const git = __importStar(require("./services/git"));
+const npm = __importStar(require("./services/npm"));
+const changelog_1 = require("./changelog");
+const github = __importStar(require("./services/github"));
+const logger_1 = __importDefault(require("./lib/logger"));
+const updatePackageJsonVersion_1 = require("./updatePackageJsonVersion");
+const colorette_1 = require("colorette");
+const getPrereleaseChannel_1 = require("./getPrereleaseChannel");
+const getTags_1 = require("./getTags");
+const validateUseVersion_1 = require("./validateUseVersion");
+const getNextTag_1 = require("./getNextTag");
+const runUserReleaseScripts_1 = require("./runUserReleaseScripts");
+const runUserPrereleaseScripts_1 = require("./runUserPrereleaseScripts");
+async function autorel(args) {
+    const prereleaseChannel = (0, getPrereleaseChannel_1.getPrereleaseChannel)(args);
+    if (args.dryRun) {
+        logger_1.default.warn('Running in dry-run mode. No changes will be made.');
+    }
+    if (prereleaseChannel && !args.useVersion) {
+        const stmt = `Using prerelease channel: ${(0, colorette_1.bold)(prereleaseChannel)}`;
+        logger_1.default.info(!args.useVersion ? stmt : (0, colorette_1.strikethrough)(stmt));
+    }
+    else {
+        const stmt = 'This is a production release.';
+        logger_1.default.info(!args.useVersion ? stmt : (0, colorette_1.strikethrough)(stmt));
+    }
+    git.gitFetch();
+    const { highestTag, highestChannelTag, highestStableTag, tagFromWhichToFindCommits, } = (0, getTags_1.getTags)(prereleaseChannel);
+    const commits = git.getCommitsFromTag(tagFromWhichToFindCommits);
+    logger_1.default.info(`Found ${(0, colorette_1.bold)(commits.length.toString())} commit(s).`);
+    const parsedCommits = commits.map((commit) => convCom.parseConventionalCommit(commit.message, commit.hash))
+        .filter((commit) => !!commit);
+    const commitTypeMap = new Map(args.commitTypes.map((type) => [type.type, type]));
+    const releaseType = convCom.determineReleaseType(parsedCommits, commitTypeMap);
+    const releaseTypeStr = (releaseType === 'none' && (0, colorette_1.gray)('none'))
+        || (releaseType === 'major' && (0, colorette_1.redBright)('major'))
+        || (releaseType === 'minor' && (0, colorette_1.yellowBright)('minor'))
+        || (releaseType === 'patch' && (0, colorette_1.greenBright)('patch'));
+    logger_1.default.info(`The release type is: ${(0, colorette_1.bold)(String(releaseTypeStr))}`);
+    if (releaseType === 'none' && !args.useVersion) {
+        logger_1.default.info('No release is needed. Have a nice day (^_^)/');
+        return;
+    }
+    (0, validateUseVersion_1.validateUseVersion)(args.useVersion, releaseType);
+    const nextTag = (0, getNextTag_1.getNextTag)({
+        releaseType,
+        highestTag,
+        highestStableTag,
+        highestChannelTag,
+        useVersion: args.useVersion,
+        prereleaseChannel,
+    });
+    const changelog = (0, changelog_1.generateChangelog)(parsedCommits, commitTypeMap, args.breakingChangeTitle);
+    logger_1.default.info(`The next version is: ${(0, colorette_1.bold)(nextTag)}`);
+    logger_1.default.debug(`The changelog is:\n${changelog}`);
+    if (args.dryRun)
+        return;
+    (0, runUserPrereleaseScripts_1.runUserPreleaseScripts)(args);
+    git.createAndPushTag(nextTag);
+    const { owner, repository } = git.getRepo();
+    // publish to GitHub
+    if (!args.skipRelease) {
+        github.createRelease({
+            token: process.env.GITHUB_TOKEN,
+            owner,
+            repository,
+            tag: nextTag,
+            name: nextTag,
+            body: changelog,
+        });
+    }
+    // publish to npm
+    if (args.publish) {
+        (0, updatePackageJsonVersion_1.updatePackageJsonVersion)(nextTag);
+        npm.publishPackage(prereleaseChannel);
+    }
+    // set env variables
+    process.env.NEXT_VERSION = nextTag.replace('v', '');
+    process.env.NEXT_TAG = nextTag;
+    (0, runUserReleaseScripts_1.runUserReleaseScripts)(args);
+    return nextTag.replace('v', '');
+}
+exports.autorel = autorel;
+//# sourceMappingURL=autorel.js.map

package/dist/getNextTag.d.ts

@@ -0,0 +1,9 @@
+import { ReleaseType } from './semver';
+export declare function getNextTag({ highestTag, highestStableTag, highestChannelTag, useVersion, prereleaseChannel, releaseType, }: {
+    highestTag: string | undefined;
+    highestStableTag: string | undefined;
+    highestChannelTag: string | undefined;
+    useVersion: string | undefined;
+    prereleaseChannel: string | undefined;
+    releaseType: ReleaseType;
+}): string;

package/dist/getNextTag.js

@@ -0,0 +1,40 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNextTag = void 0;
+const semver = __importStar(require("./semver"));
+function getNextTag({ highestTag, highestStableTag, highestChannelTag, useVersion, prereleaseChannel, releaseType, }) {
+    return useVersion
+        ? `v${useVersion}`
+        : semver.toTag(semver.incrVer({
+            latestVer: semver.fromTag(highestTag || 'v0.0.0'),
+            latestStableVer: semver.fromTag(highestStableTag || 'v0.0.0'),
+            releaseType,
+            prereleaseChannel,
+            latestChannelVer: highestChannelTag ? semver.fromTag(highestChannelTag) ?? undefined : undefined,
+        }));
+}
+exports.getNextTag = getNextTag;
+//# sourceMappingURL=getNextTag.js.map

package/dist/getTags.d.ts

@@ -0,0 +1,6 @@
+export declare function getTags(prereleaseChannel?: string): {
+    highestTag: string | undefined;
+    highestStableTag: string | undefined;
+    highestChannelTag: string | undefined;
+    tagFromWhichToFindCommits: string | undefined;
+};

package/dist/getTags.js

@@ -0,0 +1,60 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTags = void 0;
+const git = __importStar(require("./services/git"));
+const semver = __importStar(require("./semver"));
+const logger_1 = __importDefault(require("./lib/logger"));
+const colorette_1 = require("colorette");
+function getTags(prereleaseChannel) {
+    const recentTags = git.getRecentTags();
+    const highestTag = semver.highestTag(recentTags);
+    const highestStableTag = semver.highestStableTag(recentTags);
+    const highestChannelTag = prereleaseChannel
+        ? semver.highestChannelTag(recentTags, prereleaseChannel)
+        : undefined;
+    // Determine the starting Git tag to compare against when generating
+    // release notes or changelogs (i.e. the point “since” which to find commits).
+    // If a pre-release channel is specified, and that channel has a tag, and
+    // it is higher than the stable tag, use that tag. Otherwise, use the stable tag.
+    const tagFromWhichToFindCommits = highestChannelTag
+        ? semver.highestTag([highestChannelTag, highestStableTag ?? 'v0.0.0'])
+        : highestStableTag;
+    !!highestChannelTag && logger_1.default.info(`The last pre-release channel version (${prereleaseChannel}) is: ${(0, colorette_1.bold)(highestChannelTag)}`);
+    logger_1.default.info(`The last stable/production version is: ${highestStableTag ? (0, colorette_1.bold)(highestStableTag) : (0, colorette_1.gray)('none')}`);
+    logger_1.default.info(`The current/highest version is: ${highestTag ? (0, colorette_1.bold)(highestTag) : (0, colorette_1.gray)('none')}`);
+    logger_1.default.info(`Fetching commits since ${tagFromWhichToFindCommits ?? 'the beginning of the repository'}...`);
+    return {
+        highestTag,
+        highestStableTag,
+        highestChannelTag,
+        tagFromWhichToFindCommits,
+    };
+}
+exports.getTags = getTags;
+//# sourceMappingURL=getTags.js.map

package/dist/index.d.ts

@@ -20,6 +20,6 @@ export type Config = {
     commitTypes: CommitType[];
     branches: ReleaseBranch[];
 };
-export declare function autorel(args: Config): Promise<string | undefined>;
 export * from './defaults';
 export * from './config';
+export * from './autorel';

package/dist/index.js

@@ -10,147 +10,11 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     if (k2 === undefined) k2 = k;
     o[k2] = m[k];
 }));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
 var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.autorel = void 0;
-/* eslint-disable max-lines-per-function */
-const semver = __importStar(require("./semver"));
-const convCom = __importStar(require("./conventionalcommits"));
-const git = __importStar(require("./services/git"));
-const npm = __importStar(require("./services/npm"));
-const changelog_1 = require("./changelog");
-const github = __importStar(require("./services/github"));
-const logger_1 = __importDefault(require("./lib/logger"));
-const updatePackageJsonVersion_1 = require("./updatePackageJsonVersion");
-const sh_1 = require("./services/sh");
-const colorette_1 = require("colorette");
-const getPrereleaseChannel_1 = require("./getPrereleaseChannel");
-async function autorel(args) {
-    const prereleaseChannel = (0, getPrereleaseChannel_1.getPrereleaseChannel)(args);
-    if (args.dryRun) {
-        logger_1.default.warn('Running in dry-run mode. No changes will be made.');
-    }
-    if (prereleaseChannel && !args.useVersion) {
-        const stmt = `Using prerelease channel: ${(0, colorette_1.bold)(prereleaseChannel)}`;
-        logger_1.default.info(!args.useVersion ? stmt : (0, colorette_1.strikethrough)(stmt));
-    }
-    else {
-        const stmt = 'This is a production release.';
-        logger_1.default.info(!args.useVersion ? stmt : (0, colorette_1.strikethrough)(stmt));
-    }
-    const commitTypeMap = new Map(args.commitTypes.map((type) => [type.type, type]));
-    git.gitFetch();
-    const latestTags = git.getLatestTags();
-    const latestTag = semver.latestTag(latestTags);
-    const lastStableTag = semver.latestStableTag(latestTags);
-    const lastChannelTag = prereleaseChannel
-        ? semver.latestChannelTag(latestTags, prereleaseChannel)
-        : undefined;
-    // Determine the starting Git tag to compare against when generating
-    // release notes or changelogs (i.e. the point “since” which to find commits).
-    // If a pre-release channel is specified and a last channel tag exists,
-    // use the last channel tag. Otherwise, use the last stable tag.
-    const tagFromWhichToFindCommits = lastChannelTag ?? lastStableTag;
-    !!lastChannelTag && logger_1.default.info(`The last pre-release channel version (${prereleaseChannel}) is: ${(0, colorette_1.bold)(lastChannelTag)}`);
-    logger_1.default.info(`The last stable/production version is: ${lastStableTag ? (0, colorette_1.bold)(lastStableTag) : (0, colorette_1.gray)('none')}`);
-    logger_1.default.info(`The current/highest version is: ${latestTag ? (0, colorette_1.bold)(latestTag) : (0, colorette_1.gray)('none')}`);
-    logger_1.default.info(`Fetching commits since ${tagFromWhichToFindCommits ?? 'the beginning of the repository'}...`);
-    const commits = git.getCommitsFromTag(tagFromWhichToFindCommits);
-    logger_1.default.info(`Found ${(0, colorette_1.bold)(commits.length.toString())} commit(s).`);
-    const parsedCommits = commits.map((commit) => convCom.parseConventionalCommit(commit.message, commit.hash))
-        .filter((commit) => !!commit);
-    const releaseType = convCom.determineReleaseType(parsedCommits, commitTypeMap);
-    const releaseTypeStr = (releaseType === 'none' && (0, colorette_1.gray)('none'))
-        || (releaseType === 'major' && (0, colorette_1.redBright)('major'))
-        || (releaseType === 'minor' && (0, colorette_1.yellowBright)('minor'))
-        || (releaseType === 'patch' && (0, colorette_1.greenBright)('patch'));
-    logger_1.default.info(`The release type is: ${(0, colorette_1.bold)(String(releaseTypeStr))}`);
-    if (releaseType === 'none' && !args.useVersion) {
-        logger_1.default.info('No release is needed. Have a nice day (^_^)/');
-        return;
-    }
-    // Validate useVersion & log warnings
-    if (args.useVersion) {
-        if (/^v(.+)$/.test(args.useVersion))
-            throw new Error('useVersion should not start with a "v".');
-        if (!semver.isValidTag(args.useVersion))
-            throw new Error('useVersion must be a valid SemVer version');
-        if (releaseType === 'none') {
-            logger_1.default.warn(`We didn't find any commmits that would create a release, but you have set 'useVersion', which will force a release as: ${(0, colorette_1.bold)(args.useVersion)}.`);
-        }
-        else {
-            logger_1.default.warn(`The next version was explicitly set by useVersion to be: ${(0, colorette_1.bold)(args.useVersion)}.`);
-        }
-    }
-    const nextTag = args.useVersion
-        ? `v${args.useVersion}`
-        : semver.toTag(semver.incrVer({
-            latestVer: semver.fromTag(latestTag || 'v0.0.0'),
-            latestStableVer: semver.fromTag(lastStableTag || 'v0.0.0'),
-            releaseType,
-            prereleaseChannel,
-            latestChannelVer: lastChannelTag ? semver.fromTag(lastChannelTag) ?? undefined : undefined,
-        }));
-    const changelog = (0, changelog_1.generateChangelog)(parsedCommits, commitTypeMap, args.breakingChangeTitle);
-    logger_1.default.info(`The next version is: ${(0, colorette_1.bold)(nextTag)}`);
-    logger_1.default.debug(`The changelog is:\n${changelog}`);
-    if (args.dryRun)
-        return;
-    if (args.preRun) {
-        logger_1.default.info('Running pre-release bash script...');
-        (0, sh_1.bash)(args.preRun);
-    }
-    git.createAndPushTag(nextTag);
-    const { owner, repository } = git.getRepo();
-    !args.skipRelease && github.createRelease({
-        token: process.env.GITHUB_TOKEN,
-        owner,
-        repository,
-        tag: nextTag,
-        name: nextTag,
-        body: changelog,
-    });
-    // publish to npm
-    if (args.publish) {
-        (0, updatePackageJsonVersion_1.updatePackageJsonVersion)(nextTag);
-        npm.publishPackage(prereleaseChannel);
-    }
-    process.env.NEXT_VERSION = nextTag.replace('v', '');
-    process.env.NEXT_TAG = nextTag;
-    // run post-release bash script
-    if (args.run) {
-        logger_1.default.info('Running post-release bash script...');
-        (0, sh_1.bash)(args.run);
-    }
-    else if (args.runScript) {
-        // TODO: delete this block in the next major version
-        logger_1.default.warn('----------------------------');
-        logger_1.default.warn('🚨 The "runScript" option is deprecated. Please use "run" instead. 🚨');
-        logger_1.default.warn('🚨 The "runScript" option will be removed in the next major version. 🚨');
-        logger_1.default.warn('----------------------------');
-        logger_1.default.info('Running post-release bash script...');
-        (0, sh_1.bash)(args.runScript);
-    }
-    return nextTag.replace('v', '');
-}
-exports.autorel = autorel;
 __exportStar(require("./defaults"), exports);
 __exportStar(require("./config"), exports);
+__exportStar(require("./autorel"), exports);
 //# sourceMappingURL=index.js.map

package/dist/runUserPrereleaseScripts.d.ts

@@ -0,0 +1,2 @@
+import { Config } from '.';
+export declare function runUserPreleaseScripts(args: Config): void;

package/dist/runUserPrereleaseScripts.js

@@ -0,0 +1,18 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runUserPreleaseScripts = void 0;
+const logger_1 = __importDefault(require("./lib/logger"));
+const sh_1 = require("./services/sh");
+function runUserPreleaseScripts(args) {
+    if (args.dryRun)
+        return;
+    if (!args.preRun)
+        return;
+    logger_1.default.info('Running pre-release bash script...');
+    (0, sh_1.bash)(args.preRun);
+}
+exports.runUserPreleaseScripts = runUserPreleaseScripts;
+//# sourceMappingURL=runUserPrereleaseScripts.js.map

package/dist/runUserReleaseScripts.d.ts

@@ -0,0 +1,2 @@
+import { Config } from '.';
+export declare function runUserReleaseScripts(args: Config): void;

package/dist/runUserReleaseScripts.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runUserReleaseScripts = void 0;
+const logger_1 = __importDefault(require("./lib/logger"));
+const sh_1 = require("./services/sh");
+function runUserReleaseScripts(args) {
+    if (args.dryRun)
+        return;
+    if (args.run) {
+        logger_1.default.info('Running post-release bash script...');
+        (0, sh_1.bash)(args.run);
+    }
+    else if (args.runScript) {
+        // TODO: delete this block in the next major version
+        logger_1.default.warn('----------------------------');
+        logger_1.default.warn('🚨 The "runScript" option is deprecated. Please use "run" instead. 🚨');
+        logger_1.default.warn('🚨 The "runScript" option will be removed in the next major version. 🚨');
+        logger_1.default.warn('----------------------------');
+        logger_1.default.info('Running post-release bash script...');
+        (0, sh_1.bash)(args.runScript);
+    }
+}
+exports.runUserReleaseScripts = runUserReleaseScripts;
+//# sourceMappingURL=runUserReleaseScripts.js.map

package/dist/semver/compare.d.ts

@@ -11,9 +11,18 @@ export declare function compareVersions(version1: SemVer, version2: SemVer): num
  * Returns the highest version of two SemVer objects (nomalized).
  */
 export declare function highestVersion(version1: SemVer, version2: SemVer): SemVer;
-export declare function latestTag(tags: string[]): string | undefined;
-export declare function latestChannelTag(tags: string[], channel: string): string | undefined;
-export declare function latestStableTag(tags: string[]): string | undefined;
+/**
+ * Returns the tag with the highest version.
+ */
+export declare function highestTag(tags: string[]): string | undefined;
+/**
+ * Returns the tag with the highest version for a specific channel.
+ */
+export declare function highestChannelTag(tags: string[], channel: string): string | undefined;
+/**
+ * Returns the tag with the highest version that does not have a channel.
+ */
+export declare function highestStableTag(tags: string[]): string | undefined;
 /**
  * Returns the raw tag string with the highest version.
  */

package/dist/semver/compare.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.highest = exports.latestStableTag = exports.latestChannelTag = exports.latestTag = exports.highestVersion = exports.compareVersions = void 0;
+exports.highest = exports.highestStableTag = exports.highestChannelTag = exports.highestTag = exports.highestVersion = exports.compareVersions = void 0;
 const parse_1 = require("./parse");
 /**
  * Compares two versions and returns:
@@ -52,29 +52,38 @@ function highestVersion(version1, version2) {
     return (0, parse_1.normalizeVer)(comparison > 0 ? version1 : version2);
 }
 exports.highestVersion = highestVersion;
-function latestTag(tags) {
+/**
+ * Returns the tag with the highest version.
+ */
+function highestTag(tags) {
     const parsed = (0, parse_1.parseTags)(tags);
     if (parsed.length === 0)
         return undefined;
     return highest(parsed).raw;
 }
-exports.latestTag = latestTag;
-function latestChannelTag(tags, channel) {
+exports.highestTag = highestTag;
+/**
+ * Returns the tag with the highest version for a specific channel.
+ */
+function highestChannelTag(tags, channel) {
     const parsed = (0, parse_1.parseTags)(tags)
         .filter((entry) => entry.version.channel === channel);
     if (parsed.length === 0)
         return undefined;
     return highest(parsed).raw;
 }
-exports.latestChannelTag = latestChannelTag;
-function latestStableTag(tags) {
+exports.highestChannelTag = highestChannelTag;
+/**
+ * Returns the tag with the highest version that does not have a channel.
+ */
+function highestStableTag(tags) {
     const parsed = (0, parse_1.parseTags)(tags)
         .filter((entry) => !entry.version.channel);
     if (parsed.length === 0)
         return undefined;
     return highest(parsed).raw;
 }
-exports.latestStableTag = latestStableTag;
+exports.highestStableTag = highestStableTag;
 /**
  * Returns the raw tag string with the highest version.
  */

package/dist/services/git.d.ts

@@ -4,7 +4,12 @@ export type Commit = {
 };
 export declare function gitFetch(): void;
 export declare function createAndPushTag(tag: string): void;
-export declare function getLatestTags(): string[];
+export declare function deleteTagFromLocalAndRemote(tag: string): void;
+/**
+ * Returns the most recent 100 tags in the repository loosely sorted by version
+ * (does not take into account pre-release tags).
+ */
+export declare function getRecentTags(): string[];
 export declare function getRepo(): {
     owner: string;
     repository: string;

package/dist/services/git.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCurrentBranch = exports.getCommitsFromTag = exports.getRepo = exports.getLatestTags = exports.createAndPushTag = exports.gitFetch = void 0;
+exports.getCurrentBranch = exports.getCommitsFromTag = exports.getRepo = exports.getRecentTags = exports.deleteTagFromLocalAndRemote = exports.createAndPushTag = exports.gitFetch = void 0;
 const sh_1 = require("./sh");
 function gitFetch() {
     (0, sh_1.$) `git fetch`;
@@ -11,11 +11,20 @@ function createAndPushTag(tag) {
     (0, sh_1.$) `git push origin ${tag}`;
 }
 exports.createAndPushTag = createAndPushTag;
-function getLatestTags() {
+function deleteTagFromLocalAndRemote(tag) {
+    (0, sh_1.$) `git tag -d ${tag}`;
+    (0, sh_1.$) `git push origin :refs/tags/${tag}`;
+}
+exports.deleteTagFromLocalAndRemote = deleteTagFromLocalAndRemote;
+/**
+ * Returns the most recent 100 tags in the repository loosely sorted by version
+ * (does not take into account pre-release tags).
+ */
+function getRecentTags() {
     const tags = (0, sh_1.$) `git tag --sort=-v:refname | head -n 100`;
     return tags.split('\n').filter((tag) => tag.trim() !== '');
 }
-exports.getLatestTags = getLatestTags;
+exports.getRecentTags = getRecentTags;
 function getRepo() {
     if (process.env.GITHUB_REPOSITORY) {
         const [owner, repository] = process.env.GITHUB_REPOSITORY.split('/');

package/dist/validateUseVersion.d.ts

@@ -0,0 +1,2 @@
+import { ReleaseType } from './semver';
+export declare function validateUseVersion(useVersion: string | undefined, releaseType: ReleaseType): void;

package/dist/validateUseVersion.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateUseVersion = void 0;
+const colorette_1 = require("colorette");
+const logger_1 = __importDefault(require("./lib/logger"));
+const semver_1 = require("./semver");
+function validateUseVersion(useVersion, releaseType) {
+    if (!useVersion)
+        return;
+    if (/^v(.+)$/.test(useVersion))
+        throw new Error('useVersion should not start with a "v".');
+    if (!(0, semver_1.isValidTag)(useVersion))
+        throw new Error('useVersion must be a valid SemVer version');
+    if (releaseType === 'none') {
+        logger_1.default.warn(`We didn't find any commmits that would create a release, but you have set 'useVersion', which will force a release as: ${(0, colorette_1.bold)(useVersion)}.`);
+    }
+    else {
+        logger_1.default.warn(`The next version was explicitly set by useVersion to be: ${(0, colorette_1.bold)(useVersion)}.`);
+    }
+}
+exports.validateUseVersion = validateUseVersion;
+//# sourceMappingURL=validateUseVersion.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autorel",
-  "version": "2.3.1",
+  "version": "2.3.3",
   "description": "Automate semantic releases based on conventional commits. Similar to semantic-release but much simpler.",
   "license": "MIT",
   "author": "Marc H. Weiner <mhweiner234@gmail.com> (https://mhweiner.com)",