@clerk/shared/dist/versionCheck.js

Internal package utils used by the Clerk SDKs

Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });

//#region src/versionCheck.ts
/**
* Parses a version string into major, minor, and patch numbers.
* Returns null if the version string cannot be parsed.
*
* @example
* parseVersion("18.3.1") // { major: 18, minor: 3, patch: 1 }
* parseVersion("19.0.0-rc.1") // { major: 19, minor: 0, patch: 0 }
* parseVersion("invalid") // null
*/
function parseVersion(version) {
	const match = version.match(/^(\d+)\.(\d+)\.(\d+)/);
	if (!match) return null;
	const [, majorStr, minorStr, patchStr] = match;
	return {
		major: parseInt(majorStr, 10),
		minor: parseInt(minorStr, 10),
		patch: parseInt(patchStr, 10)
	};
}
/**
* Checks if a parsed version satisfies the given version bounds.
*
* @param version - The parsed version to check
* @param version.major
* @param bounds - Array of version bounds to check against
* @param version.minor
* @param version.patch
* @returns true if the version satisfies any of the bounds
*/
function checkVersionAgainstBounds(version, bounds) {
	const { major, minor, patch } = version;
	return bounds.some(([bMajor, minMinor, maxMinor, minPatch]) => {
		if (major !== bMajor) return false;
		if (maxMinor === -1) return minor > minMinor || minor === minMinor && patch >= minPatch;
		return minor === maxMinor && patch >= minPatch;
	});
}
/**
* Checks if a version string is compatible with the given bounds.
* This is a convenience function that combines parsing and checking.
*
* @param version - The version string to check (e.g., "18.3.1")
* @param bounds - Array of version bounds to check against
* @returns true if the version is compatible, false otherwise
*/
function isVersionCompatible(version, bounds) {
	const parsed = parseVersion(version);
	if (!parsed) return false;
	return checkVersionAgainstBounds(parsed, bounds);
}
/**
* Returns true if the given version is at least the minimum version.
* Both versions are compared by their major.minor.patch components only.
* Pre-release suffixes are ignored (e.g., "5.114.0-canary.123" is treated as "5.114.0").
*
* @param version - The version string to check (e.g., "5.114.0")
* @param minVersion - The minimum required version (e.g., "5.100.0")
* @returns true if version >= minVersion, false otherwise (including if either cannot be parsed)
*
* @example
* isVersionAtLeast("5.114.0", "5.100.0") // true
* isVersionAtLeast("5.99.0", "5.100.0") // false
* isVersionAtLeast("5.100.0-canary.123", "5.100.0") // true
*/
function isVersionAtLeast(version, minVersion) {
	if (!version) return false;
	const parsed = parseVersion(version);
	const minParsed = parseVersion(minVersion);
	if (!parsed || !minParsed) return false;
	if (parsed.major !== minParsed.major) return parsed.major > minParsed.major;
	if (parsed.minor !== minParsed.minor) return parsed.minor > minParsed.minor;
	return parsed.patch >= minParsed.patch;
}

//#endregion
exports.checkVersionAgainstBounds = checkVersionAgainstBounds;
exports.isVersionAtLeast = isVersionAtLeast;
exports.isVersionCompatible = isVersionCompatible;
exports.parseVersion = parseVersion;
//# sourceMappingURL=versionCheck.js.map