enablement-build-monorepo-version 8.4.1 → 8.4.5

package/README.md

@@ -27,6 +27,8 @@ npx enablement-build-monorepo-version@latest [flags]
 | `--hash`                      | off                 | Compute and **save** current hashes to the hash state file. Must be run before `--changed` / `--version` to establish a baseline.                                                                                                                                                                      |
 | `--changed`                   | off                 | Print the list of changed packages and emit a `changed` pipeline variable.                                                                                                                                                                                                                             |
 | `--version`                   | off                 | Emit a pipeline variable per changed package containing its next version.                                                                                                                                                                                                                              |
+| `--patchonly`                 | off                 | Restrict package version bumps to the patch number, even for commits normally classified as minor or major. |
+| `--suffix <value>`            | —                   | Force this prerelease suffix on every bumped version, replacing any existing suffix. A leading `-` is optional. |
 | `--save`                      | off                 | Write the bumped version back into each changed package's version manifests (`package.json`, `version.json`, and/or `pyproject.toml`). Requires `--version`.                                                                                                                                           |
 | `--tag`                       | off                 | Create a git tag (`<short-name>/<version>`) for each changed package, where `short-name` is the npm package name with its scope prefix removed (e.g. `@scope/lib-foo` → `lib-foo/1.2.3`).                                                                                                              |
 | `--retag`                     | off                 | Convert existing tags that use the old folder-name format to the new short-package-name format. Non-destructive: old tags are left in place.                                                                                                                                                           |
@@ -43,6 +45,8 @@ npx enablement-build-monorepo-version@latest [flags]
 | `--hashExcludeFiles <list>`   | see below           | Comma-separated file names to skip when hashing.                                                                                                                                                                                                                                                       |
 | `--hashFiles <list>`          | —                   | Comma-separated individual file paths to include in the hash state (outside of `children` folders).                                                                                                                                                                                                    |
 
+Existing prerelease suffixes (for example, `-devA`) are retained when bumping versions unless `--suffix` is provided.
+
 **Default excluded folders:** `node_modules`, `coverage`, `dist`, `bin`, `obj`, `__pycache__`, `.vs`, `.nx`, `.vscode`, `.idea`, `.git`, `.github`, `.azuredevops`, `.release`
 
 **Default excluded files:** `.npmrc`, `CHANGELOG.md`, `README.md`

package/package.json

@@ -1,12 +1,17 @@
 {
   "name": "enablement-build-monorepo-version",
-  "version": "8.4.1",
+  "version": "8.4.5",
   "description": "This detects changes in the children packages of a monorepo.",
   "type": "module",
   "module": "./src/index.mjs",
   "bin": "./src/index.mjs",
   "license": "MIT",
   "author": "Contributors",
+  "scripts": {
+    "start": "node src/index.mjs",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "test:watch": "node --experimental-vm-modules node_modules/jest/bin/jest.js --watch"
+  },
   "jest": {
     "testEnvironment": "node",
     "testMatch": [
@@ -14,15 +19,10 @@
     ]
   },
   "dependencies": {
-    "minimatch": "~10.1.1",
-    "enablement-build-manifest": "1.8.2"
+    "enablement-build-manifest": "workspace:*",
+    "minimatch": "~10.1.1"
   },
   "devDependencies": {
     "jest": "^30.4.2"
-  },
-  "scripts": {
-    "start": "node src/index.mjs",
-    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
-    "test:watch": "node --experimental-vm-modules node_modules/jest/bin/jest.js --watch"
   }
 }

package/src/index.mjs

@@ -12,11 +12,14 @@ const packageVersion = packageMetadata.version;
 import { dependencyMap, compare, getCurrentVersion, updateVersion, retagToPackageNames, detectOldFormatTags, resolveWorkspaceChildren, excludeChildren, applyInitScripts, RELEASE_SCRIPTS, emitVariable, hashElement, resolveHashFilePath, ensureHashFileExists, loadHashFile, writeHashFile } from "./lib.mjs";
 
 
-function bumpPatchVersion(version) {
+function bumpPatchVersion(version, forcedSuffix) {
   const value = (version || '0.0.0').trim();
   const parts = value.split('-');
   const base = parts[0] || '0.0.0';
-  const suffix = parts.length > 1 ? parts.slice(1).join('-') : '';
+  let suffix = parts.length > 1 ? parts.slice(1).join('-') : '';
+  if (forcedSuffix !== null && forcedSuffix !== undefined) {
+    suffix = String(forcedSuffix).replace(/^-+/, '');
+  }
 
   const nums = base.split('.');
   const major = Number.parseInt(nums[0] || '0', 10) || 0;
@@ -35,7 +38,7 @@ async function updateRootVersionIfNeeded(options, changeList) {
 
   const pkg = JSON.parse(readFileSync(rootPackageFile, 'utf8'));
   const previous = pkg.version || '0.0.0';
-  const next = bumpPatchVersion(previous);
+  const next = bumpPatchVersion(previous, options.suffix);
 
   if (options.try) {
     console.log('\x1b[36m%s\x1b[0m', `[try] Would update ${rootPackageFile} version ${previous} -> ${next}`);
@@ -196,7 +199,13 @@ async function main(options) {
     let children = options.children.replace(/\s/g, ",");
     children.split(',').forEach((packageFolder) => {
       scanlist.push(new Promise((resolve, reject) => {
-        hashElement(path.join(options.prefixPath, packageFolder), hashOptions).then(async hash => {
+        const folderPath = path.join(options.prefixPath, packageFolder);
+        if (!existsSync(folderPath)) {
+          console.log('\x1b[33m%s\x1b[0m', `Warning: workspace folder "${packageFolder}" does not exist, skipping`);
+          resolve("OK");
+          return;
+        }
+        hashElement(folderPath, hashOptions).then(async hash => {
           const children = hash.children;
           if (options.debug) console.log("HASH", JSON.stringify(children));
 
@@ -257,7 +266,8 @@ async function main(options) {
           resolve("OK");
         })
         .catch(error => {
-          return console.error('hashing failed:', error);
+          console.error('hashing failed:', error);
+          resolve("OK");
         });
       }));
     });
@@ -336,6 +346,8 @@ async function main(options) {
 let options = {
   saveVersion: false,
   changed: false,
+  patchonly: false,
+  suffix: null,
   version: false,
   hash: false,
   tag: false,
@@ -365,6 +377,15 @@ if (process.argv.length === 2) {
     if (argv[i] === "--save") options.saveVersion = true;
     else if (argv[i] === "--debug") options.debug = true;
     else if (argv[i] === "--changed") options.changed = true;
+    else if (argv[i] === "--patchonly") options.patchonly = true;
+    else if (argv[i] === "--suffix") {
+      if (!argv[i + 1] || argv[i + 1].startsWith("--")) {
+        console.error("Expected a value for --suffix");
+        process.exit(1);
+      }
+      options.suffix = argv[i + 1];
+      i++;
+    }
     else if (argv[i] === "--version") options.version = true;
     else if (argv[i] === "--hash") options.hash = true;
     else if (argv[i] === "--tag") options.tag = true;

package/src/version.mjs

@@ -51,7 +51,10 @@ function processMessage(message, tag, imageName, options, args) {
     let minor = Number.parseInt(parts[1] || '0', 10) || 0;
     let patch = Number.parseInt(parts[2] || '0', 10) || 0;
 
-    const bump = getBumpType(message);
+    const bump = options.patchonly ? "patch" : getBumpType(message);
+    if (options.suffix !== null && options.suffix !== undefined) {
+        suffix = String(options.suffix).replace(/^-+/, "");
+    }
     let build = false;
 
     if (bump === "major") {

package/tests/version.test.mjs

@@ -25,6 +25,36 @@ describe('version bump parsing', () => {
     expect(result.version).toBe('2.0.0');
   });
 
+  it('preserves a suffix during a normal bump without patchonly', () => {
+    const result = processMessage('feat: add endpoint', '1.2.3-devA', 'pkg', options, {});
+    expect(result.version).toBe('1.3.0-devA');
+  });
+
+  it('limits breaking changes to a patch bump when patchonly is enabled', () => {
+    const result = processMessage('feat!: remove old API', '1.2.3', 'pkg', { ...options, patchonly: true }, {});
+    expect(result.version).toBe('1.2.4');
+  });
+
+  it('limits minor changes to a patch bump when patchonly is enabled', () => {
+    const result = processMessage('feat: add endpoint', '1.2.3', 'pkg', { ...options, patchonly: true }, {});
+    expect(result.version).toBe('1.2.4');
+  });
+
+  it('preserves a suffix when patchonly is enabled', () => {
+    const result = processMessage('feat!: remove old API', '1.2.3-devA', 'pkg', { ...options, patchonly: true }, {});
+    expect(result.version).toBe('1.2.4-devA');
+  });
+
+  it('adds a forced suffix when the version has none', () => {
+    const result = processMessage('fix: adjust typo', '1.2.3', 'pkg', { ...options, suffix: 'devA' }, {});
+    expect(result.version).toBe('1.2.4-devA');
+  });
+
+  it('replaces an existing suffix with the forced suffix', () => {
+    const result = processMessage('feat: add endpoint', '1.2.3-old', 'pkg', { ...options, suffix: '-devA' }, {});
+    expect(result.version).toBe('1.3.0-devA');
+  });
+
   it('classifies bump types directly', () => {
     expect(getBumpType('feat(parser): support x')).toBe('minor');
     expect(getBumpType('refactor(core): split module')).toBe('minor');