denoify/src/tools/Version.ts

For NPM module authors that would like to support Deno but do not want to write and maintain a port.

export type Version = {
    major: number;
    minor: number;
    patch: number;
};

export namespace Version {
    export function parse(versionStr: string): Version {
        const match = versionStr.match(/^([0-9]+)\.([0-9]+)\.([0-9]+)$/);

        if (!match) {
            throw new Error(`${versionStr} is not a valid NPM version`);
        }

        return {
            "major": parseInt(match[1]),
            "minor": parseInt(match[2]),
            "patch": parseInt(match[3])
        };
    }

    export function stringify(v: Version) {
        return `${v.major}.${v.minor}.${v.patch}`;
    }

    /**
     *
     * v1  <  v2  => -1
     * v1 === v2  => 0
     * v1  >  v2  => 1
     *
     */
    export function compare(v1: Version, v2: Version): -1 | 0 | 1 {
        const sign = (n: number): -1 | 0 | 1 => (n === 0 ? 0 : n < 0 ? -1 : 1);

        if (v1.major === v2.major) {
            if (v1.minor === v2.minor) {
                return sign(v1.patch - v2.patch);
            } else {
                return sign(v1.minor - v2.minor);
            }
        } else {
            return sign(v1.major - v2.major);
        }
    }

    export function bumpType(params: { versionBehindStr: string; versionAheadStr: string }): "SAME" | "MAJOR" | "MINOR" | "PATCH" {
        const versionAhead = parse(params.versionAheadStr);
        const versionBehind = parse(params.versionBehindStr);

        if (compare(versionBehind, versionAhead) === 1) {
            throw new Error(`Version regression ${versionBehind} -> ${versionAhead}`);
        }

        if (versionBehind.major !== versionAhead.major) {
            return "MAJOR";
        } else if (versionBehind.minor !== versionAhead.minor) {
            return "MINOR";
        } else if (versionBehind.patch !== versionAhead.patch) {
            return "PATCH";
        } else {
            return "SAME";
        }
    }
}