zx-bulk-release 2.21.0 → 2.21.1

package/CHANGELOG.md

@@ -1,3 +1,8 @@
+## [2.21.1](https://github.com/semrel-extra/zx-bulk-release/compare/v2.21.0...v2.21.1) (2026-04-11)
+
+### Fixes & improvements
+* docs: add snapshot flow example ([5b2c2b5](https://github.com/semrel-extra/zx-bulk-release/commit/5b2c2b5faac712892c9feeea7ebae6e1dd36e93f))
+
 ## [2.21.0](https://github.com/semrel-extra/zx-bulk-release/compare/v2.20.0...v2.21.0) (2026-04-10)
 
 ### Fixes & improvements

package/README.md

@@ -1,9 +1,9 @@
 # zx-bulk-release
 > [zx](https://github.com/google/zx)-based alternative for [multi-semantic-release](https://github.com/dhoulb/multi-semantic-release)
 
-[![CI](https://github.com/semrel-extra/zx-bulk-release/workflows/CI/badge.svg?branch=master)](https://github.com/semrel-extra/zx-bulk-release/actions)
-[![Maintainability](https://qlty.sh/badges/semrel-extra/zx-bulk-release/maintainability.svg)](https://qlty.sh/gh/semrel-extra/zx-bulk-release)
-[![Test Coverage](https://qlty.sh/badges/semrel-extra/zx-bulk-release/test_coverage.svg)](https://qlty.sh/gh/semrel-extra/zx-bulk-release)
+[![CI](https://github.com/semrel-extra/zx-bulk-release/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/semrel-extra/zx-bulk-release/actions/workflows/ci.yml)
+[![Maintainability](https://qlty.sh/gh/semrel-extra/projects/zx-bulk-release/maintainability.svg)](https://qlty.sh/gh/semrel-extra/projects/zx-bulk-release)
+[![Code Coverage](https://qlty.sh/gh/semrel-extra/projects/zx-bulk-release/coverage.svg)](https://qlty.sh/gh/semrel-extra/projects/zx-bulk-release)
 [![npm (tag)](https://img.shields.io/npm/v/zx-bulk-release)](https://www.npmjs.com/package/zx-bulk-release)
 
 ## Key features
@@ -147,6 +147,50 @@ OIDC mode is also auto-detected when `NPM_TOKEN` is not set and `ACTIONS_ID_TOKE
 
 When OIDC is active, `NPM_TOKEN` and `NPMRC` are ignored for publishing and `--provenance` is enabled automatically.
 
+### Snapshot releases from PRs
+The `--snapshot` flag publishes packages to the `snapshot` npm dist-tag with a pre-release version like `1.2.1-snap.a3f0c12`. This is useful for testing changes from a feature branch before merging.
+
+**What snapshot does differently:**
+- Version gets a `-snap.<short-sha>` suffix instead of a clean bump
+- Git release tags are **not** pushed
+- Only `npm` and `publishCmd` publishers run (no gh-release, no changelog, no gh-pages, no meta)
+- npm tag is `snapshot` instead of `latest`
+
+**Workflow example** (`.github/workflows/snapshot.yml`):
+```yaml
+name: Snapshot
+on:
+  pull_request:
+    types: [labeled]
+
+jobs:
+  snapshot:
+    if: github.event.label.name == 'snapshot'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write    # for OIDC trusted publishing
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: yarn install
+      - run: npx zx-bulk-release --snapshot
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+```
+
+**How to use:**
+1. Push a feature branch and open a PR.
+2. Add the `snapshot` label to the PR.
+3. The workflow publishes snapshot versions to npm.
+4. Consumers install snapshots via `npm install yourpkg@snapshot`.
+5. After merge, the regular release flow on `master` publishes clean versions to `latest`.
+
 ### Selective testing along the change graph
 In a monorepo, `--dry-run` combined with `--no-build` lets you run tests only for packages affected by the current changes — following the dependency graph, without publishing anything. This gives you a precise CI check scoped to what actually changed:
 ```shell

package/package.json

@@ -1,25 +1,27 @@
 {
   "name": "zx-bulk-release",
   "alias": "bulk-release",
-  "version": "2.21.0",
+  "version": "2.21.1",
   "description": "zx-based alternative for multi-semantic-release",
   "type": "module",
   "exports": {
     ".": "./src/main/js/index.js",
-    "./test-utils": "./src/test/js/test-utils.js",
+    "./test-utils": "./src/test/js/utils/repo.js",
     "./meta": "./src/main/js/processor/generators/meta.js"
   },
   "bin": "./src/main/js/cli.js",
   "files": [
     "src/main/js",
-    "src/test/js/test-utils.js",
+    "src/test/js/utils",
     "CHANGELOG.md",
     "LICENSE",
     "README.md"
   ],
   "scripts": {
-    "test": "c8 uvu ./src/test -i fixtures -i utils && c8 report -r lcov",
+    "test": "npm run test:unit",
+    "test:unit": "uvu ./src/test -i fixtures -i utils -i integration",
     "test:it": "node ./src/test/js/integration.test.js",
+    "test:cov": "c8 sh -c 'npx uvu ./src/test -i fixtures -i utils -i integration && node ./src/test/js/integration.test.js' && c8 report -r lcov",
     "docs": "mkdir -p docs && cp ./README.md ./docs/README.md",
     "publish:beta": "npm publish --tag beta --no-git-tag-version",
     "build": "esbuild src/main/js/index.js --platform=node --outdir=target --bundle --format=esm --external:typescript"
@@ -45,5 +47,10 @@
     "url": "git+https://github.com/semrel-extra/zx-bulk-release.git"
   },
   "author": "Anton Golub <antongolub@antongolub.com>",
-  "license": "MIT"
+  "license": "MIT",
+  "c8": {
+    "exclude": [
+      "src/test/**"
+    ]
+  }
 }

package/src/test/js/utils/gh-server.js

@@ -0,0 +1,33 @@
+import http from 'node:http'
+
+export const createGhServer = async () => {
+  const requests = []
+  let routes = {}
+
+  const server = http.createServer((req, res) => {
+    let body = ''
+    req.on('data', c => body += c)
+    req.on('end', () => {
+      requests.push({method: req.method, url: req.url, headers: req.headers, body})
+      const key = `${req.method} ${req.url}`
+      for (const [pattern, handler] of Object.entries(routes)) {
+        if (key.includes(pattern) || new RegExp(pattern).test(key)) {
+          return handler(req, res, body)
+        }
+      }
+      res.writeHead(404)
+      res.end('{}')
+    })
+  })
+
+  await new Promise(r => server.listen(0, '127.0.0.1', r))
+
+  return {
+    url: `http://127.0.0.1:${server.address().port}`,
+    requests,
+    routes,
+    reset() { requests.length = 0; routes = {}; return routes },
+    setRoutes(r) { Object.assign(routes, r) },
+    close() { server.close() },
+  }
+}

package/src/test/js/utils/mock.js

@@ -0,0 +1,132 @@
+import {PassThrough} from 'node:stream'
+import {EventEmitter} from 'node:events'
+import {tempy} from 'zx-extra'
+
+export const tmpDir = tempy.temporaryDirectory()
+
+function proc(stdout = '', code = 0) {
+  const p = new EventEmitter()
+  p.stdout = new PassThrough()
+  p.stderr = new PassThrough()
+  p.stdin = new PassThrough()
+  p.pid = 1
+  process.nextTick(() => {
+    p.stdout.end(stdout)
+    p.stderr.end('')
+    p.emit('close', code, null)
+    p.emit('exit', code, null)
+  })
+  return p
+}
+
+export function createMock(responses = []) {
+  const calls = []
+  const spawn = (cmd, args) => {
+    const command = args?.[args.length - 1] || cmd
+    calls.push(command)
+    for (const [pattern, output, code] of responses) {
+      if (typeof pattern === 'string' ? command.includes(pattern) : pattern.test(command))
+        return proc(output, code ?? 0)
+    }
+    return proc('')
+  }
+  return {spawn, calls}
+}
+
+export const has = (calls, pattern) =>
+  calls.some(c => typeof pattern === 'string' ? c.includes(pattern) : pattern.test(c))
+
+export const gitResponses = (overrides = {}) => [
+  ['git rev-parse --show-toplevel', overrides.root ?? tmpDir],
+  ['git rev-parse HEAD', overrides.sha ?? 'abc1234567890'],
+  ['git config --get remote.origin.url', overrides.origin ?? 'https://github.com/test-org/test-repo.git'],
+  ['git tag -l', overrides.tags ?? ''],
+  [/git log .+--format/, overrides.log ?? ''],
+  ['git config user.name', ''],
+  ['git config user.email', ''],
+  [/git tag -m/, ''],
+  ['git push', ''],
+  ['git fetch', ''],
+  ['git clone', ''],
+  ['git init', ''],
+  ['git add', ''],
+  ['git commit', ''],
+  [/git remote/, ''],
+  [/git config --unset/, ''],
+]
+
+export const npmResponses = (overrides = {}) => [
+  ['npm --version', overrides.npmVersion ?? '10.0.0'],
+  ['npm publish', ''],
+  ['npm view', overrides.view ?? ''],
+]
+
+export const defaultResponses = (overrides = {}) => [
+  ...gitResponses(overrides),
+  ...npmResponses(overrides),
+  [/curl/, overrides.curl ?? '{}'],
+  [/echo/, ''],
+]
+
+export const makePkg = (overrides = {}) => ({
+  name: overrides.name ?? 'test-pkg',
+  version: overrides.version ?? '1.0.1',
+  absPath: overrides.absPath ?? `${tmpDir}/packages/test-pkg`,
+  relPath: overrides.relPath ?? 'packages/test-pkg',
+  manifest: {
+    name: overrides.name ?? 'test-pkg',
+    version: overrides.version ?? '1.0.1',
+    private: overrides.private ?? false,
+    ...overrides.manifest,
+  },
+  config: {
+    buildCmd: 'echo build',
+    testCmd: 'echo test',
+    gitCommitterName: 'Bot',
+    gitCommitterEmail: 'bot@test.com',
+    ghBasicAuth: 'x-access-token:ghp_test',
+    ghToken: 'ghp_test',
+    npmPublish: true,
+    npmFetch: false,
+    changelog: 'changelog',
+    ...overrides.config,
+  },
+  changes: overrides.changes ?? [{group: 'Fixes', releaseType: 'patch', change: 'fix: test'}],
+  releaseType: overrides.releaseType ?? 'patch',
+  tag: overrides.tag ?? '2026.1.1-test-pkg.1.0.1-f0',
+  latest: overrides.latest ?? {tag: null, meta: null},
+  ctx: overrides.ctx ?? null,
+  ...overrides.extra,
+})
+
+export const makeCtx = (overrides = {}) => ({
+  cwd: overrides.cwd ?? tmpDir,
+  env: {PATH: process.env.PATH, HOME: process.env.HOME, GH_TOKEN: 'ghp_test', NPM_TOKEN: 'npm_test', ...overrides.env},
+  flags: {build: true, test: true, publish: true, ...overrides.flags},
+  root: {absPath: tmpDir, ...overrides.root},
+  packages: overrides.packages ?? {},
+  queue: overrides.queue ?? [],
+  prev: overrides.prev ?? {},
+  graphs: overrides.graphs ?? {},
+  report: overrides.report ?? makeReport(),
+  publishers: overrides.publishers ?? [],
+  run: overrides.run ?? (async () => {}),
+  git: {sha: 'abc1234567890', root: tmpDir, ...overrides.git},
+})
+
+export const makeReport = () => {
+  const events = []
+  return {
+    status: 'initial',
+    events,
+    packages: {},
+    log(...chunks) { events.push({level: 'info', msg: chunks}); return this },
+    warn(...chunks) { events.push({level: 'warn', msg: chunks}); return this },
+    error(...chunks) { events.push({level: 'error', msg: chunks}); return this },
+    set() { return this },
+    get() { return this },
+    setStatus() { return this },
+    getStatus() { return this },
+    save() { return this },
+  }
+}

package/src/test/js/{test-utils.js → utils/repo.js}

@@ -2,7 +2,7 @@ import {fs, path, tempy, $, sleep} from 'zx-extra'
 import {fileURLToPath} from 'node:url'
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
-export const fixtures = path.resolve(__dirname, '../fixtures')
+export const fixtures = path.resolve(__dirname, '../../fixtures')
 
 export const createNpmRegistry = () => {
   let p
@@ -10,8 +10,8 @@ export const createNpmRegistry = () => {
   return {
     address: $.env.NPM_REGISTRY || 'http://localhost:4873',
     async start() {
-      fs.removeSync(path.resolve(__dirname, '../../../storage'))
-      const config = path.resolve(__dirname, '../../../verdaccio.config.yaml')
+      fs.removeSync(path.resolve(__dirname, '../../../../storage'))
+      const config = path.resolve(__dirname, '../../../../verdaccio.config.yaml')
       p = $({preferLocal: true})`verdaccio --config ${config}`
 
       return sleep(1000)