ts-ci/src/tools/NpmModuleVersion.ts

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

export namespace NpmModuleVersion {

    export function parse(versionStr: string): NpmModuleVersion {

        const match = versionStr.match(/^([0-9]+)\.([0-9]+)\.([0-9]+)(?:-beta.([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: NpmModuleVersion) {
        return `${v.major}.${v.minor}.${v.patch}`;
    }

    /**
     * 
     * v1  <  v2  => -1
     * v1 === v2  => 0
     * v1  >  v2  => 1
     * 
     */
    export function compare(v1: NpmModuleVersion, v2: NpmModuleVersion): -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";

        }

    }

}