diff --git a/packages/plugin/src/version-compare.ts b/packages/plugin/src/version-compare.ts new file mode 100644 index 0000000..1768ca6 --- /dev/null +++ b/packages/plugin/src/version-compare.ts @@ -0,0 +1,65 @@ +/** + * 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) +}