merge master into main

Author: oleg-koval

.github/workflows/ci.yml

@@ -54,8 +54,6 @@ jobs:
     if: github.event_name == 'push' || github.event.pull_request.head.repo.full_name == github.repository
     permissions:
       contents: read
-      issues: write
-      pull-requests: write
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
@@ -71,14 +69,5 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
-      - name: Validate release tokens are present
-        run: |
-          test -n "$GITHUB_TOKEN"
-          test -n "$NPM_TOKEN"
-
       - name: Run semantic-release in dry-run mode
-        env:
-          CI: true
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
         run: npm run release:dry-run

CHANGELOG.md

@@ -1,3 +1,10 @@
+# [1.6.0](https://github.com/oleg-koval/semantic-release-npm-github-publish/compare/v1.5.5...v1.6.0) (2026-04-04)
+
+
+### ✨ Features
+
+* **release:** add beta channel and docs automation ([#56](https://github.com/oleg-koval/semantic-release-npm-github-publish/issues/56)) ([6610c1c](https://github.com/oleg-koval/semantic-release-npm-github-publish/commit/6610c1c7d18366638268d3ff17b84a97e7cec484))
+
 ## [1.5.5](https://github.com/oleg-koval/semantic-release-npm-github-publish/compare/v1.5.4...v1.5.5) (2023-12-22)
 
 

commit-transform.js

@@ -12,59 +12,51 @@ const COMMIT_HASH_LENGTH = 7;
  * @return {Object} the transformed commit.
  */
 module.exports = (commit, context) => {
-	if (commit.notes) {
-		commit.notes.forEach(note => {
-			note.title = 'Breaking changes';
-		});
-	}
-
-	if (types.types[commit.type] && (types.types[commit.type].changelog || (commit.notes && commit.notes.length > 0))) {
-		commit.groupType = `${types.types[commit.type].emoji ? `${types.types[commit.type].emoji} ` : ''}${
-			types.types[commit.type].title
-		}`;
-		commit.type = commit.groupType;
-	} else {
+	const commitType = types.types[commit.type];
+	const notes = Array.isArray(commit.notes)
+		? commit.notes.map(note => ({
+				...note,
+				title: 'Breaking changes',
+			}))
+		: [];
+
+	if (!commitType || (!commitType.changelog && notes.length === 0)) {
 		return null;
 	}
 
-	if (commit.scope === '*') {
-		commit.scope = '';
-	}
-
-	if (typeof commit.hash === 'string') {
-		commit.shortHash = commit.hash.slice(0, COMMIT_HASH_LENGTH);
-	}
+	const groupType = `${commitType.emoji ? `${commitType.emoji} ` : ''}${commitType.title}`;
 
 	const references = [];
+	let subject = commit.subject;
 
-	if (typeof commit.subject === 'string') {
+	if (typeof subject === 'string') {
 		let url = context.repository ? `${context.host}/${context.owner}/${context.repository}` : context.repoUrl;
 
 		if (url) {
 			url += '/issues/';
 			// Issue URLs.
-			commit.subject = commit.subject.replace(/#(\d+)/g, (_, issue) => {
+			subject = subject.replace(/#(\d+)/g, (_, issue) => {
 				references.push(issue);
 				return `[#${issue}](${url}${issue})`;
 			});
 		}
 
 		if (context.host) {
 			// User URLs.
-			commit.subject = commit.subject.replace(/\B@([a-z0-9](?:-?[a-z0-9]){0,38})/g, `[@$1](${context.host}/$1)`);
+			subject = subject.replace(/\B@([a-z0-9](?:-?[a-z0-9]){0,38})/g, `[@$1](${context.host}/$1)`);
 		}
 	}
 
-	if (commit.references) {
-		// Remove references that already appear in the subject
-		commit.references = commit.references.filter(reference => {
-			if (!references.includes(reference.issue)) {
-				return true;
-			}
-
-			return false;
-		});
-	}
-
-	return commit;
+	return {
+		...commit,
+		groupType,
+		type: groupType,
+		scope: commit.scope === '*' ? '' : commit.scope,
+		shortHash: typeof commit.hash === 'string' ? commit.hash.slice(0, COMMIT_HASH_LENGTH) : commit.shortHash,
+		subject,
+		notes,
+		references: Array.isArray(commit.references)
+			? commit.references.filter(reference => !references.includes(reference.issue))
+			: commit.references,
+	};
 };

docs/README.md

@@ -4,5 +4,4 @@ Repository documentation kept in sync by `docs-index-keeper`.
 
 | Doc | Purpose |
 | --- | --- |
-| [release-channels.md](./release-channels.md) | Stable and beta release channel behavior for this repository |
-| [release-channels](release-channels.md) | Release Channels |
+| [release-channels.md](./release-channels.md) | Stable and beta release channel behavior for this repository |

package-lock.json

@@ -59,7 +59,7 @@
   "scripts": {
     "docs:index:check": "docs-index-keeper check",
     "docs:index:update": "docs-index-keeper update",
-    "release:dry-run": "semantic-release --dry-run --debug --extends ./release.repo.config.js",
+    "release:dry-run": "node ./scripts/release-dry-run.mjs",
     "test": "node --test",
     "test:config": "node -e \"const config = require('./release.config.js'); if (!Array.isArray(config.plugins) || config.plugins.length === 0) { throw new Error('release config did not load plugins'); }\"",
     "semantic-release": "semantic-release --extends ./release.repo.config.js",
@@ -69,6 +69,6 @@
   "docsIndexKeeper": {
     "indexFile": "docs/README.md"
   },
-  "version": "1.5.5",
+  "version": "1.6.0",
   "snyk": true
 }

package.json

@@ -0,0 +1,9 @@
+const repoConfig = require('./release.repo.config');
+
+module.exports = {
+	...repoConfig,
+	plugins: [
+		repoConfig.plugins[0],
+		'@semantic-release/release-notes-generator',
+	],
+};

release.dry-run.config.js

@@ -0,0 +1,24 @@
+import {createRequire} from 'node:module';
+
+import semanticRelease from 'semantic-release';
+
+const require = createRequire(import.meta.url);
+const config = require('../release.dry-run.config');
+
+const result = await semanticRelease(
+	{
+		...config,
+		ci: false,
+		dryRun: true,
+	},
+	{
+		cwd: process.cwd(),
+		env: process.env,
+		stderr: process.stderr,
+		stdout: process.stdout,
+	}
+);
+
+if (!result) {
+	console.log('[semantic-release] no release generated for the current branch');
+}

scripts/release-dry-run.mjs

@@ -6,6 +6,7 @@ const test = require('node:test');
 const {analyzeCommits} = require('@semantic-release/commit-analyzer');
 
 const transformCommit = require('../commit-transform');
+const dryRunReleaseConfig = require('../release.dry-run.config');
 const releaseConfig = require('../release.config');
 const repoReleaseConfig = require('../release.repo.config');
 
@@ -52,6 +53,16 @@ test('keeps beta prereleases as a repo-only branch policy', () => {
 	]);
 });
 
+test('uses auth-free plugins for release dry runs', () => {
+	assert.deepEqual(
+		dryRunReleaseConfig.plugins.map(plugin => Array.isArray(plugin) ? plugin[0] : plugin),
+		[
+			'@semantic-release/commit-analyzer',
+			'@semantic-release/release-notes-generator',
+		]
+	);
+});
+
 test('keeps standard feat/fix and breaking-change semantics', async () => {
 	assert.equal(await analyzeReleaseType(['fix: correct output']), 'patch');
 	assert.equal(await analyzeReleaseType(['feat: add publish summary']), 'minor');
@@ -91,6 +102,28 @@ test('formats changelog commit groups with curated titles', () => {
 	);
 });
 
+test('transforms immutable commit objects without mutating input', () => {
+	const immutableCommit = Object.freeze({
+		hash: '1234567890abcdef',
+		notes: Object.freeze([Object.freeze({text: 'breaking'})]),
+		references: Object.freeze([Object.freeze({issue: '42'})]),
+		scope: '*',
+		subject: 'add summary for #42',
+		type: 'feat',
+	});
+
+	const transformed = transformCommit(immutableCommit, {
+		host: 'https://github.com',
+		owner: 'oleg-koval',
+		repository: 'semantic-release-npm-github-publish',
+	});
+
+	assert.equal(transformed.scope, '');
+	assert.equal(transformed.notes[0].title, 'Breaking changes');
+	assert.equal(immutableCommit.notes[0].title, undefined);
+	assert.equal(transformed.references.length, 0);
+});
+
 test('drops unknown commit types from the changelog', () => {
 	assert.equal(
 		transformCommit(