66 lines
2.5 KiB
TypeScript
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)
|
|
}
|