ds-harness-remote-fast/packages/plugin/src/version-compare.ts

66 lines
2.5 KiB
TypeScript

/**
* Client-safe `x.y.z[-prerelease]` comparison shared by the Host update check
* and the injected client UI (no Node imports; both esbuild bundles include it).
*/
interface ParsedVersion {
core: [number, number, number]
prerelease: string[]
}
const VERSION_PATTERN = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/
function parseVersion(value: string): ParsedVersion | undefined {
const match = VERSION_PATTERN.exec(value.trim().replace(/^v/, ''))
if (match === null) return undefined
return {
core: [Number(match[1]), Number(match[2]), Number(match[3])],
prerelease: match[4] === undefined ? [] : match[4].split('.'),
}
}
function comparePrerelease(left: string[], right: string[]): number {
// A release outranks every prerelease of the same core version.
if (left.length === 0 && right.length === 0) return 0
if (left.length === 0) return 1
if (right.length === 0) return -1
for (let index = 0; index < Math.max(left.length, right.length); index += 1) {
const part = left[index]
const other = right[index]
// A shorter prerelease list with equal prefix ranks lower.
if (part === undefined) return -1
if (other === undefined) return 1
if (part === other) continue
const partNumeric = /^\d+$/.test(part)
const otherNumeric = /^\d+$/.test(other)
if (partNumeric && otherNumeric) return Math.sign(Number(part) - Number(other))
// Numeric identifiers rank below alphanumeric ones.
if (partNumeric) return -1
if (otherNumeric) return 1
return part < other ? -1 : 1
}
return 0
}
/**
* Compare two `x.y.z[-prerelease]` versions: negative when `left` is older,
* `0` when equal (including both unparseable), positive when `left` is newer.
* A value that fails to parse compares as equal to everything, so a malformed
* registry tag can never force or suppress an update hint on its own.
*
* @param left First version string.
* @param right Second version string.
* @returns Negative, zero, or positive as `left` is older, equal, or newer.
*/
export function compareVersions(left: string, right: string): number {
const parsedLeft = parseVersion(left)
const parsedRight = parseVersion(right)
if (parsedLeft === undefined || parsedRight === undefined) return 0
for (let index = 0; index < 3; index += 1) {
if (parsedLeft.core[index] !== parsedRight.core[index]) {
return Math.sign(parsedLeft.core[index] - parsedRight.core[index])
}
}
return comparePrerelease(parsedLeft.prerelease, parsedRight.prerelease)
}