diff options
Diffstat (limited to 'mod.ts')
| -rw-r--r-- | mod.ts | 269 |
1 files changed, 269 insertions, 0 deletions
@@ -0,0 +1,269 @@ + + + +//// export + +export class ChronVer { + private static readonly DATE_REGEX = /^(\d{4})\.(\d{2})\.(\d{2})$/; + private static readonly VERSION_REGEX = /^(\d{4})\.(?:0[1-9]|1[0-2])\.(?:0[1-9]|[12]\d|3[01])(?:\.(\d+))?(?:-(break|[a-zA-Z0-9-]+)(?:\.(\d+))?)?$/; + + readonly changeset: number; /*** changeset number (0 if not specified) ***/ + readonly day: number; /*** day component (1-31) ***/ + readonly feature?: string; /*** feature name (if specified) ***/ + readonly isBreaking: boolean; /*** whether this is a breaking change ***/ + readonly month: number; /*** month component (1-12) ***/ + readonly year: number; /*** year component ***/ + + constructor(version?: string) { + if (!version) { + const now = new Date(); + + this.changeset = 0; + this.day = now.getDate(); + this.isBreaking = false; + this.month = now.getMonth() + 1; + this.year = now.getFullYear(); + + return; + } + + const parsed = this.parseVersionString(version); + + this.changeset = parsed.changeset; + this.day = parsed.day; + this.feature = parsed.feature; + this.isBreaking = parsed.isBreaking; + this.month = parsed.month; + this.year = parsed.year; + + this.validate(); + } + + //// private methods + + private getDaysInMonth(year: number, month: number): number { + return new Date(year, month, 0).getDate(); + } + + private parseVersionString(version: string): { changeset: number; day: number; feature?: string; isBreaking: boolean; month: number; year: number; } { + const match = version.match(ChronVer.VERSION_REGEX); + + if (!match) + throw new ChronVerError(`Invalid ChronVer format: "${version}"`); + + const [, yearStr, changesetStr, label, featureChangeset] = match; + const parts = version.split("."); + + if (parts.length < 3) + throw new ChronVerError(`Invalid ChronVer format: "${version}"`); + + const year = parseInt(yearStr, 10); + const month = parseInt(parts[1], 10); + const day = parseInt(parts[2], 10); + const isBreaking = label === "break"; + + let changeset = changesetStr ? + parseInt(changesetStr, 10) : + 0; + + let feature: string | undefined; + + if (label && !isBreaking) { + feature = label; + + if (!changeset) { + changeset = featureChangeset ? + parseInt(featureChangeset, 10) : + 0; + } + } + + return { + changeset, + day, + feature, + isBreaking, + month, + year + }; + } + + private validate(): void { + if (this.year < 1) + throw new ChronVerError("Year must be positive"); + + if (this.month < 1 || this.month > 12) + throw new ChronVerError("Month must be between 1 and 12"); + + const maxDays = this.getDaysInMonth(this.year, this.month); + + if (this.day < 1 || this.day > maxDays) + throw new ChronVerError(`Day must be between 1 and ${maxDays} for ${this.year}-${this.month.toString().padStart(2, "0")}`); + + if (this.changeset < 0) + throw new ChronVerError("Changeset cannot be negative"); + + if (this.feature && !/^[a-zA-Z0-9-]+$/.test(this.feature)) + throw new ChronVerError("Feature name must contain only alphanumeric characters and hyphens"); + } + + //// public methods + + compare(other: ChronVer): number { + /*** compare date components ***/ + const comparisons = [ + this.year - other.year, + this.month - other.month, + this.day - other.day, + this.changeset - other.changeset + ]; + + for (const diff of comparisons) { + if (diff !== 0) + return Math.sign(diff); + } + + if (this.isBreaking !== other.isBreaking) + return this.isBreaking ? 1 : -1; /*** compare breaking changes ***/ + + /*** at this point, changeset is zero ***/ + return 0; + } + + equals(other: ChronVer): boolean { + return this.compare(other) === 0; + } + + getDateString(): string { + return `${this.year}.${this.month.toString().padStart(2, "0")}.${this.day.toString().padStart(2, "0")}`; + } + + increment(): ChronVer { + const today = new Date(); + + const isToday = this.year === today.getFullYear() && + this.month === (today.getMonth() + 1) && + this.day === today.getDate(); + + if (isToday) /*** already ran today, increment changeset ***/ + return new ChronVer(`${this.year}.${this.month.toString().padStart(2, "0")}.${this.day.toString().padStart(2, "0")}.${this.changeset + 1}`); + + return new ChronVer(); + } + + isNewerThan(other: ChronVer): boolean { + return this.compare(other) > 0; + } + + isOlderThan(other: ChronVer): boolean { + return this.compare(other) < 0; + } + + toString(): string { + const base = `${this.year}.${this.month.toString().padStart(2, "0")}.${this.day.toString().padStart(2, "0")}`; + let result = base; + + if (this.changeset > 0) + result += `.${this.changeset}`; + + if (this.feature) + result += `-${this.feature}`; + + if (this.isBreaking) + result += "-break"; + + return result; + } + + //// static methods + + static compare(v1: string, v2: string): number { + try { + const version1 = new ChronVer(v1); + const version2 = new ChronVer(v2); + + return version1.compare(version2); + } catch(error) { + throw new ChronVerError(`Failed to compare versions: ${(error as Error).message}`); + } + } + + static fromDate(date: Date, changeset: number = 0): ChronVer { + const dateStr = `${date.getFullYear()}.${(date.getMonth() + 1).toString().padStart(2, "0")}.${date.getDate().toString().padStart(2, "0")}`; + return new ChronVer(changeset > 0 ? `${dateStr}.${changeset}` : dateStr); + } + + static async incrementInFile(filename: string = "package.json"): Promise<string> { + try { + const content = await Deno.readTextFile(filename); + const json = JSON.parse(content); + + if (!json.version) { + json.version = new ChronVer().toString(); + } else { + const currentVersion = new ChronVer(json.version); + json.version = currentVersion.increment().toString(); + } + + await Deno.writeTextFile(filename, JSON.stringify(json, null, 2) + "\n"); + return json.version; + } catch(error) { + if ( /*** not found errors ***/ + error instanceof Deno.errors.NotFound || + (error as Error).message.includes("No such file") || + (error as Error).message.includes("ENOENT") || + (error as Error).message.includes("not found")) + throw new ChronVerError(`File not found: ${filename}`); + + if (error instanceof SyntaxError) /*** json parsing errors ***/ + throw new ChronVerError(`Invalid JSON in ${filename}: ${(error as Error).message}`); + + if ((error as Error).message.includes("permission") || (error as Error).message.includes("EACCES")) + throw new ChronVerError(`Permission denied accessing ${filename}`); /*** permission errors ***/ + + throw new ChronVerError(`Failed to update ${filename}: ${(error as Error).message}`); + } + } + + static isValid(version: string): boolean { + try { + new ChronVer(version); + return true; + } catch { + return false; + } + } + + static parseVersion(version: string): { changeset: number; date: string; feature?: string; isBreaking: boolean; version: string; } | null { + if (!this.isValid(version)) + return null; + + try { + const chronVer = new ChronVer(version); + + return { + changeset: chronVer.changeset, + date: chronVer.getDateString(), + feature: chronVer.feature, + isBreaking: chronVer.isBreaking, + version + }; + } catch { + return null; + } + } + + static sort(versions: string[], descending: boolean = false): string[] { + return versions.slice().sort((a, b) => { + const result = ChronVer.compare(a, b); + return descending ? -result : result; + }); + } +} + +export class ChronVerError extends Error { + constructor(message: string) { + super(message); + this.name = "ChronVerError"; + } +} |