const simpleGit = require('simple-git'); const path = require('path'); const fs = require('fs'); class S4Versioning { constructor(git) { this.git = git || simpleGit(); } // Regex for parsing S4 version static get REGEX() { return /^([0-9]+)\.([0-9]+)\.([0-9]+)-([a-z]+)\.([0-9]+)\+([0-9]{8})\.([0-9]{4})\.([0-9a-f]+)\.([a-zA-Z0-9._\/-]+)$/; } /** * Parse an S4 version string into components */ static parse(versionStr) { const match = versionStr.match(S4Versioning.REGEX); if (!match) return null; return { major: parseInt(match[1]), minor: parseInt(match[2]), patch: parseInt(match[3]), stage: match[4], build: parseInt(match[5]), date: match[6], time: match[7], commit: match[8], branch: match[9], original: versionStr }; } /** * Generate S4 version string from components */ static stringify(components) { const { major, minor, patch, stage, build, date, time, commit, branch } = components; return `${major}.${minor}.${patch}-${stage}.${build}+${date}.${time}.${commit}.${branch}`; } /** * Migrate a standard SemVer or empty version to S4 */ async migrate(currentVersion) { // Basic SemVer parsing (loose) const semVerMatch = currentVersion.match(/^([0-9]+)\.([0-9]+)\.([0-9]+)(?:-([a-zA-Z0-9.]+))?/); let base = { major: 0, minor: 0, patch: 0, stage: 'dev', build: 1 }; if (semVerMatch) { base.major = parseInt(semVerMatch[1]); base.minor = parseInt(semVerMatch[2]); base.patch = parseInt(semVerMatch[3]); // Attempt to salvage stage if present, else default to dev if (semVerMatch[4]) { const parts = semVerMatch[4].split('.'); const possibleStage = parts.find(p => /^[a-z]+$/.test(p)); if (possibleStage) base.stage = possibleStage; } } const ctx = await this.getContext(); return S4Versioning.stringify({ ...base, ...ctx }); } /** * Get current Git and Time context */ async getContext() { const now = new Date(); const pad = (n) => n.toString().padStart(2, '0'); const date = `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}`; const time = `${pad(now.getHours())}${pad(now.getMinutes())}`; let commit = '0000000'; let branch = 'unknown'; try { const isRepo = await this.git.checkIsRepo(); if (isRepo) { commit = (await this.git.revparse(['--short=7', 'HEAD'])).trim(); branch = (await this.git.revparse(['--abbrev-ref', 'HEAD'])).trim(); } } catch (e) { // Ignore git errors, stick to defaults } // Sanitize branch name for S4 compliance branch = branch.replace(/[^a-zA-Z0-9._\/-]/g, '-'); return { date, time, commit, branch }; } /** * Calculate next version based on bump type */ async bump(currentStr, type = 'auto', stageVal = null) { let parsed = S4Versioning.parse(currentStr); // If not S4, migrate first if (!parsed) { const migrated = await this.migrate(currentStr); parsed = S4Versioning.parse(migrated); } const ctx = await this.getContext(); const next = { ...parsed, ...ctx }; // Update context (date, time, commit, branch) // Handle stage change if (stageVal && stageVal !== parsed.stage) { next.stage = stageVal; next.build = 1; // Stage change resets build usually? S4 "Sequence" implies uniqueness. // S4 doc: "When to Increment: Each new build of the same version on the same day" // Changing stage is effectively a new version identity. } else { // Keep existing stage if not specified } // Logic for bumping switch (type) { case 'major': next.major++; next.minor = 0; next.patch = 0; next.build = 1; break; case 'minor': next.minor++; next.patch = 0; next.build = 1; break; case 'patch': next.patch++; next.build = 1; break; case 'auto': // Smart Auto Logic // 1. If Date Changed, reset build to 1 if (parsed.date !== ctx.date) { next.build = 1; } // 2. If Date is SAME else { // If Commit Changed -> It's a new build of the same day if (parsed.commit !== ctx.commit) { next.build = parsed.build + 1; } // If Commit is SAME and user requested bump, force build increment? // "auto" implies we just want the "next" logical version for the current state. // If nothing changed, maybe we shouldn't bump? // But usually CI calls this to FORCE a new version. else { next.build = parsed.build + 1; } } break; } return S4Versioning.stringify(next); } } module.exports = { S4Versioning };