@ckeditor/ckeditor5-dev-release-tools 53.0.0 → 53.1.0

package/lib/index.js

@@ -23,14 +23,16 @@ export {
 	getNextInternal,
 	getCurrent,
 	getDateIdentifier,
-	getLastTagFromGit
+	getLastTagFromGit,
+	getVersionForTag,
+	isLatestOrNextStableVersion,
+	isVersionPublishableForTag
 } from './utils/versions.js';
 export { default as getChangesForVersion } from './utils/getchangesforversion.js';
 export { default as getChangelog } from './utils/getchangelog.js';
 export { default as executeInParallel } from './utils/executeinparallel.js';
 export { default as validateRepositoryToRelease } from './utils/validaterepositorytorelease.js';
 export { default as getNpmTagFromVersion } from './utils/getnpmtagfromversion.js';
-export { default as isVersionPublishableForTag } from './utils/isversionpublishablefortag.js';
 export { default as provideToken } from './utils/providetoken.js';
 
 // Backwards compatibility for the old API.

package/lib/utils/versions.js

@@ -3,6 +3,7 @@
  * For licensing, see LICENSE.md.
  */
 
+import semver from 'semver';
 import { npm, tools, workspaces } from '@ckeditor/ckeditor5-dev-utils';
 import getChangelog from './getchangelog.js';
 
@@ -162,6 +163,61 @@ export function getDateIdentifier() {
 	return `${ year }${ month }${ day }`;
 }
 
+/**
+ * Returns the latest version of the package on the npm tag.
+ * If the package does not have any version on that tag yet, `null` is returned.
+ *
+ * @param {string} packageName
+ * @param {string} npmTag
+ * @returns {Promise.<string|null>}
+ */
+export function getVersionForTag( packageName, npmTag ) {
+	return npm.manifest( `${ packageName }@${ npmTag }` )
+		.then( result => result.version )
+		.catch( () => null );
+}
+
+/**
+ * Checks if the version can be considered as the newest stable release of the package.
+ * It checks whether the version given in the argument is or could be the latest version.
+ * The package may not have this version published on npm yet, but it is also considered as the latest stable.
+ *
+ * @param {string} packageName
+ * @param {string} version
+ * @returns {Promise.<boolean>}
+ */
+export async function isLatestOrNextStableVersion( packageName, version ) {
+	if ( semver.prerelease( version ) ) {
+		return false;
+	}
+
+	const npmVersion = await getVersionForTag( packageName, 'latest' );
+
+	if ( npmVersion && semver.lt( version, npmVersion ) ) {
+		return false;
+	}
+
+	return true;
+}
+
+/**
+ * Verifies if the package can be published in the provided version on the npm tag.
+ *
+ * @param {string} packageName
+ * @param {string} version
+ * @param {string} npmTag
+ * @returns {Promise.<boolean>}
+ */
+export async function isVersionPublishableForTag( packageName, version, npmTag ) {
+	const npmVersion = await getVersionForTag( packageName, npmTag );
+
+	if ( npmVersion && semver.lte( version, npmVersion ) ) {
+		return false;
+	}
+
+	return true;
+}
+
 /**
  * @typedef {string} ReleaseIdentifier The pre-release identifier without the last dynamic part (the pre-release sequential number).
  * It consists of the core base version ("<major>.<minor>.<path>"), a hyphen ("-"), and a pre-release identifier name (e.g. "alpha").

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ckeditor/ckeditor5-dev-release-tools",
-  "version": "53.0.0",
+  "version": "53.1.0",
   "description": "Tools used for releasing CKEditor 5 and related packages.",
   "keywords": [],
   "author": "CKSource (http://cksource.com/)",
@@ -22,7 +22,7 @@
     "lib"
   ],
   "dependencies": {
-    "@ckeditor/ckeditor5-dev-utils": "^53.0.0",
+    "@ckeditor/ckeditor5-dev-utils": "^53.1.0",
     "@octokit/rest": "^22.0.0",
     "chalk": "^5.0.0",
     "cli-columns": "^4.0.0",

package/lib/utils/isversionpublishablefortag.js

@@ -1,28 +0,0 @@
-/**
- * @license Copyright (c) 2003-2025, CKSource Holding sp. z o.o. All rights reserved.
- * For licensing, see LICENSE.md.
- */
-
-import { npm } from '@ckeditor/ckeditor5-dev-utils';
-import semver from 'semver';
-
-/**
- * This util aims to verify if the given `packageName` can be published with the given `version` on the `npmTag`.
- *
- * @param {string} packageName
- * @param {string} version
- * @param {string} npmTag
- * @returns {Promise.<boolean>}
- */
-export default async function isVersionPublishableForTag( packageName, version, npmTag ) {
-	const npmVersion = await npm.manifest( `${ packageName }@${ npmTag }` )
-		.then( ( { version } ) => version )
-		// An `npmTag` does not exist, or it's the first release of a package.
-		.catch( () => null );
-
-	if ( npmVersion && semver.lte( version, npmVersion ) ) {
-		return false;
-	}
-
-	return true;
-}