@ucdjs/release-scripts 0.1.0-beta.60 → 0.1.0-beta.61

package/README.md

@@ -1,3 +1,102 @@
 # @ucdjs/release-scripts
 
-This repository contains release and publish scripts for the UCDJS organization.
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+
+Monorepo release automation for pnpm workspaces. Handles version calculation, dependency graph resolution, changelog generation, and GitHub integration.
+
+## Installation
+
+```bash
+npm install @ucdjs/release-scripts
+```
+
+## Usage
+
+```typescript
+import { createReleaseScripts } from "@ucdjs/release-scripts";
+
+const release = await createReleaseScripts({
+  repo: "owner/repo",
+  githubToken: process.env.GITHUB_TOKEN,
+});
+
+// Prepare a release (calculate versions, update package.json files, create PR)
+const result = await release.prepare();
+
+// Verify a release branch matches expected state
+await release.verify();
+
+// Publish packages to npm
+await release.publish();
+```
+
+### Configuration
+
+```typescript
+const release = await createReleaseScripts({
+  repo: "owner/repo",
+  githubToken: "...",
+  workspaceRoot: process.cwd(),
+  dryRun: false,
+  safeguards: true,
+  globalCommitMode: "dependencies",
+  packages: {
+    include: ["@scope/pkg-a", "@scope/pkg-b"],
+    exclude: ["@scope/internal"],
+    excludePrivate: true,
+  },
+  branch: {
+    release: "release/next",
+    default: "main",
+  },
+  npm: {
+    provenance: true,
+    access: "public",
+  },
+  changelog: {
+    enabled: true,
+    emojis: true,
+  },
+});
+```
+
+### Package Discovery
+
+```typescript
+// List all workspace packages
+const packages = await release.packages.list();
+
+// Get a specific package
+const pkg = await release.packages.get("@scope/pkg-a");
+```
+
+### Workflows
+
+#### `prepare()`
+
+Calculates version bumps from conventional commits, updates `package.json` files, generates changelogs, and creates/updates a release pull request.
+
+#### `verify()`
+
+Validates that a release branch matches expected release artifacts. Compares expected vs actual versions and dependency ranges, then sets a GitHub commit status.
+
+#### `publish()`
+
+Publishes packages to npm in topological order with provenance support, creates git tags, and pushes them to the remote.
+
+## CLI Flags
+
+When used in a script, the following flags are supported:
+
+- `--dry` / `-d` - Dry-run mode, no changes are made
+- `--verbose` / `-v` - Enable verbose logging
+
+## 📄 License
+
+Published under [MIT License](./LICENSE).
+
+[npm-version-src]: https://img.shields.io/npm/v/@ucdjs/release-scripts?style=flat&colorA=18181B&colorB=4169E1
+[npm-version-href]: https://npmjs.com/package/@ucdjs/release-scripts
+[npm-downloads-src]: https://img.shields.io/npm/dm/@ucdjs/release-scripts?style=flat&colorA=18181B&colorB=4169E1
+[npm-downloads-href]: https://npmjs.com/package/@ucdjs/release-scripts

package/dist/{eta-DAZlmVBQ.mjs → eta-g9ausaEx.mjs}

@@ -1,6 +1,5 @@
 import * as path from "node:path";
 import * as fs from "node:fs";
-
 //#region node_modules/.pnpm/eta@4.5.1/node_modules/eta/dist/index.mjs
 var EtaError = class extends Error {
 	constructor(message) {
@@ -476,6 +475,5 @@ var Eta = class extends Eta$1 {
 	readFile = readFile;
 	resolvePath = resolvePath;
 };
-
 //#endregion
-export { Eta as t };
+export { Eta as t };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { t as Eta } from "./eta-DAZlmVBQ.mjs";
+import { t as Eta } from "./eta-g9ausaEx.mjs";
 import process from "node:process";
 import readline from "node:readline";
 import { parseArgs } from "node:util";
@@ -10,7 +10,6 @@ import { getCommits, groupByType } from "commit-parser";
 import { dedent } from "@luxass/utils";
 import semver, { gt } from "semver";
 import prompts from "prompts";
-
 //#region src/shared/utils.ts
 const ucdjsReleaseOverridesPath = ".github/ucdjs-release.overrides.json";
 function parseCLIFlags() {
@@ -114,7 +113,6 @@ async function dryRun(bin, args, opts) {
 async function runIfNotDry(bin, args, opts) {
 	return getIsDryRun() ? dryRun(bin, args, opts) : run(bin, args, opts);
 }
-
 //#endregion
 //#region src/shared/errors.ts
 function isRecord(value) {
@@ -219,16 +217,16 @@ function printReleaseError(error) {
 function exitWithError(message, hint, cause) {
 	throw new ReleaseError(message, hint, cause);
 }
-
 //#endregion
 //#region src/operations/changelog-format.ts
+const HASH_PREFIX_RE = /^#/;
 function formatCommitLine({ commit, owner, repo, authors }) {
 	const commitUrl = `https://github.com/${owner}/${repo}/commit/${commit.hash}`;
 	let line = `${commit.description}`;
 	const references = commit.references ?? [];
 	for (const ref of references) {
 		if (!ref.value) continue;
-		const number = Number.parseInt(ref.value.replace(/^#/, ""), 10);
+		const number = Number.parseInt(ref.value.replace(HASH_PREFIX_RE, ""), 10);
 		if (Number.isNaN(number)) continue;
 		if (ref.type === "issue") {
 			line += ` ([Issue ${ref.value}](https://github.com/${owner}/${repo}/issues/${number}))`;
@@ -263,7 +261,6 @@ function buildTemplateGroups(options) {
 		};
 	});
 }
-
 //#endregion
 //#region src/core/github.ts
 function toGitHubError(operation, error) {
@@ -459,9 +456,10 @@ var GitHubClient = class {
 function createGitHubClient(options) {
 	return new GitHubClient(options);
 }
+const NON_WHITESPACE_RE = /\S/;
 function dedentString(str) {
 	const lines = str.split("\n");
-	const minIndent = lines.filter((line) => line.trim().length > 0).reduce((min, line) => Math.min(min, line.search(/\S/)), Infinity);
+	const minIndent = lines.filter((line) => line.trim().length > 0).reduce((min, line) => Math.min(min, line.search(NON_WHITESPACE_RE)), Infinity);
 	return lines.map((line) => minIndent === Infinity ? line : line.slice(minIndent)).join("\n").trim();
 }
 function generatePullRequestBody(updates, body) {
@@ -475,7 +473,6 @@ function generatePullRequestBody(updates, body) {
 		hasDirectChanges: u.hasDirectChanges
 	})) });
 }
-
 //#endregion
 //#region src/options.ts
 const DEFAULT_PR_BODY_TEMPLATE = dedent`
@@ -586,7 +583,6 @@ function normalizeReleaseScriptsOptions(options) {
 		}
 	};
 }
-
 //#endregion
 //#region src/types.ts
 function ok(value) {
@@ -601,9 +597,10 @@ function err(error) {
 		error
 	};
 }
-
 //#endregion
 //#region src/core/git.ts
+const CHECKOUT_BRANCH_RE = /Switched to (?:a new )?branch '(.+)'/;
+const COMMIT_HASH_RE = /^[0-9a-f]{40}$/i;
 function toGitError(operation, error) {
 	const formatted = formatUnknownError(error);
 	return {
@@ -686,6 +683,30 @@ async function isWorkingDirectoryClean(workspaceRoot) {
 * @param {string} workspaceRoot - The root directory of the workspace
 * @returns {Promise<boolean>} Promise resolving to true if branch exists, false otherwise
 */
+/**
+* Check if a remote branch exists on origin
+* @param {string} branch - The branch name to check
+* @param {string} workspaceRoot - The root directory of the workspace
+* @returns {Promise<Result<boolean, GitError>>} Promise resolving to true if remote branch exists
+*/
+async function doesRemoteBranchExist(branch, workspaceRoot) {
+	try {
+		await run("git", [
+			"ls-remote",
+			"--exit-code",
+			"--heads",
+			"origin",
+			branch
+		], { nodeOptions: {
+			cwd: workspaceRoot,
+			stdio: "pipe"
+		} });
+		return ok(true);
+	} catch (error) {
+		logger.verbose(`Remote branch "origin/${branch}" does not exist: ${formatUnknownError(error).message}`);
+		return ok(false);
+	}
+}
 async function doesBranchExist(branch, workspaceRoot) {
 	try {
 		await run("git", [
@@ -751,7 +772,7 @@ async function checkoutBranch(branch, workspaceRoot) {
 			cwd: workspaceRoot,
 			stdio: "pipe"
 		} })).stderr.trim();
-		const match = output.match(/Switched to (?:a new )?branch '(.+)'/);
+		const match = output.match(CHECKOUT_BRANCH_RE);
 		if (match && match[1] === branch) {
 			logger.info(`Successfully switched to branch: ${farver.green(branch)}`);
 			return ok(true);
@@ -985,10 +1006,9 @@ async function getGroupedFilesByCommitSha(workspaceRoot, from, to) {
 		} });
 		const lines = stdout.trim().split("\n").filter((line) => line.trim() !== "");
 		let currentSha = null;
-		const HASH_REGEX = /^[0-9a-f]{40}$/i;
 		for (const line of lines) {
 			const trimmedLine = line.trim();
-			if (HASH_REGEX.test(trimmedLine)) {
+			if (COMMIT_HASH_RE.test(trimmedLine)) {
 				currentSha = trimmedLine;
 				commitsMap.set(currentSha, []);
 				continue;
@@ -1055,9 +1075,9 @@ async function createAndPushPackageTag(packageName, version, workspaceRoot) {
 	if (!createResult.ok) return createResult;
 	return pushTag(`${packageName}@${version}`, workspaceRoot);
 }
-
 //#endregion
 //#region src/core/changelog.ts
+const CHANGELOG_VERSION_RE = /##\s+(?:<small>)?\[?([^\](\s<]+)/;
 const excludeAuthors = [
 	/\[bot\]/i,
 	/dependabot/i,
@@ -1125,7 +1145,7 @@ async function updateChangelog(options) {
 		const insertAt = parsed.headerLineEnd + 1;
 		const before = lines.slice(0, insertAt);
 		const after = lines.slice(insertAt);
-		if (before.length > 0 && before[before.length - 1] !== "") before.push("");
+		if (before.length > 0 && before.at(-1) !== "") before.push("");
 		updatedContent = [
 			...before,
 			newEntry,
@@ -1154,7 +1174,7 @@ async function resolveCommitAuthors(commits, githubClient) {
 		});
 		commitAuthors.set(commit.hash, authorsForCommit);
 	}
-	const authors = Array.from(authorMap.values());
+	const authors = [...authorMap.values()];
 	await Promise.all(authors.map((info) => githubClient.resolveAuthorInfo(info)));
 	return commitAuthors;
 }
@@ -1174,7 +1194,7 @@ function parseChangelog(content) {
 	for (let i = headerLineEnd + 1; i < lines.length; i++) {
 		const line = lines[i].trim();
 		if (line.startsWith("## ")) {
-			const versionMatch = line.match(/##\s+(?:<small>)?\[?([^\](\s<]+)/);
+			const versionMatch = line.match(CHANGELOG_VERSION_RE);
 			if (versionMatch) {
 				const version = versionMatch[1];
 				const lineStart = i;
@@ -1199,7 +1219,6 @@ function parseChangelog(content) {
 		headerLineEnd
 	};
 }
-
 //#endregion
 //#region src/operations/semver.ts
 function isValidSemver(version) {
@@ -1235,7 +1254,6 @@ function getNextPrereleaseVersion(currentVersion, mode, identifier) {
 	if (!next) throw new Error(`Failed to compute prerelease version for ${currentVersion}`);
 	return next;
 }
-
 //#endregion
 //#region src/core/prompts.ts
 async function selectPackagePrompt(packages) {
@@ -1417,7 +1435,6 @@ async function confirmOverridePrompt(pkg, overrideVersion) {
 	if (!response.choice) return null;
 	return response.choice;
 }
-
 //#endregion
 //#region src/core/workspace.ts
 function toWorkspaceError(operation, error) {
@@ -1501,7 +1518,7 @@ async function findWorkspacePackages(workspaceRoot, options) {
 			};
 		});
 		const packages = await Promise.all(promises);
-		if (excludedPackages.size > 0) logger.info(`Excluded packages: ${farver.green(Array.from(excludedPackages).join(", "))}`);
+		if (excludedPackages.size > 0) logger.info(`Excluded packages: ${farver.green([...excludedPackages].join(", "))}`);
 		return packages.filter((pkg) => pkg !== null);
 	} catch (err) {
 		logger.error("Error discovering workspace packages:", err);
@@ -1517,7 +1534,6 @@ function shouldIncludePackage(pkg, options) {
 	if (options.exclude?.includes(pkg.name)) return false;
 	return true;
 }
-
 //#endregion
 //#region src/operations/branch.ts
 async function prepareReleaseBranch(options) {
@@ -1538,9 +1554,13 @@ async function prepareReleaseBranch(options) {
 	const checkedOut = await checkoutBranch(releaseBranch, workspaceRoot);
 	if (!checkedOut.ok) return checkedOut;
 	if (branchExists.value) {
-		const pulled = await pullLatestChanges(releaseBranch, workspaceRoot);
-		if (!pulled.ok) return pulled;
-		if (!pulled.value) logger.warn("Failed to pull latest changes, continuing anyway.");
+		const remoteExists = await doesRemoteBranchExist(releaseBranch, workspaceRoot);
+		if (!remoteExists.ok) return remoteExists;
+		if (remoteExists.value) {
+			const pulled = await pullLatestChanges(releaseBranch, workspaceRoot);
+			if (!pulled.ok) return pulled;
+			if (!pulled.value) logger.warn("Failed to pull latest changes, continuing anyway.");
+		} else logger.info(`Remote branch "origin/${releaseBranch}" does not exist yet, skipping pull.`);
 	}
 	const rebased = await rebaseBranch(defaultBranch, workspaceRoot);
 	if (!rebased.ok) return rebased;
@@ -1557,7 +1577,6 @@ async function syncReleaseChanges(options) {
 	if (!pushed.ok) return pushed;
 	return ok(true);
 }
-
 //#endregion
 //#region src/versioning/commits.ts
 /**
@@ -1643,7 +1662,7 @@ function findCommitRange(packageCommits) {
 	for (const commits of packageCommits.values()) {
 		if (commits.length === 0) continue;
 		const firstCommit = commits[0].shortHash;
-		const lastCommit = commits[commits.length - 1].shortHash;
+		const lastCommit = commits.at(-1).shortHash;
 		if (!newestCommit) newestCommit = firstCommit;
 		oldestCommit = lastCommit;
 	}
@@ -1712,7 +1731,6 @@ async function getGlobalCommitsPerPackage(workspaceRoot, packageCommits, allPack
 	}
 	return result;
 }
-
 //#endregion
 //#region src/operations/version.ts
 function determineHighestBump(commits) {
@@ -1744,7 +1762,6 @@ function determineBumpType(commit) {
 	if (commit.type === "fix" || commit.type === "perf") return "patch";
 	return "none";
 }
-
 //#endregion
 //#region src/versioning/package.ts
 /**
@@ -1874,7 +1891,6 @@ function createDependentUpdates(graph, workspacePackages, directUpdates, exclude
 	}
 	return allUpdates;
 }
-
 //#endregion
 //#region src/versioning/version.ts
 const messageColorMap = {
@@ -2148,7 +2164,6 @@ function getDependencyUpdates(pkg, allUpdates) {
 	if (updates.size === 0) logger.verbose(`  - No dependency updates needed`);
 	return updates;
 }
-
 //#endregion
 //#region src/operations/calculate.ts
 async function calculateUpdates(options) {
@@ -2181,7 +2196,6 @@ function ensureHasPackages(packages) {
 	});
 	return ok(packages);
 }
-
 //#endregion
 //#region src/operations/pr.ts
 async function syncPullRequest(options) {
@@ -2218,7 +2232,6 @@ async function syncPullRequest(options) {
 		created: !doesExist
 	});
 }
-
 //#endregion
 //#region src/workflows/prepare.ts
 async function prepareWorkflow(options) {
@@ -2258,6 +2271,23 @@ async function prepareWorkflow(options) {
 		logger.info("No existing version overrides file found. Continuing...");
 		logger.verbose(`Reading overrides file failed: ${formatUnknownError(error).message}`);
 	}
+	if (Object.keys(existingOverrides).length > 0) {
+		const packageNames = new Set(workspacePackages.map((p) => p.name));
+		const staleEntries = [];
+		for (const [pkgName, override] of Object.entries(existingOverrides)) {
+			if (!packageNames.has(pkgName)) {
+				staleEntries.push(pkgName);
+				delete existingOverrides[pkgName];
+				continue;
+			}
+			const pkg = workspacePackages.find((p) => p.name === pkgName);
+			if (pkg && semver.valid(override.version) && semver.gte(pkg.version, override.version)) {
+				staleEntries.push(pkgName);
+				delete existingOverrides[pkgName];
+			}
+		}
+		if (staleEntries.length > 0) logger.info(`Removed ${staleEntries.length} stale override(s): ${staleEntries.join(", ")}`);
+	}
 	const updatesResult = await calculateUpdates({
 		workspacePackages,
 		workspaceRoot: options.workspaceRoot,
@@ -2391,7 +2421,6 @@ async function prepareWorkflow(options) {
 		created: prResult.value.created
 	};
 }
-
 //#endregion
 //#region src/core/npm.ts
 function toNPMError(operation, error, code) {
@@ -2504,7 +2533,7 @@ async function publishPackage(packageName, version, workspaceRoot, options) {
 	} catch (error) {
 		const code = classifyPublishErrorCode(error);
 		if (code === "EPUBLISHCONFLICT" && attempt < maxAttempts) {
-			const delay = backoffMs[attempt - 1] ?? backoffMs[backoffMs.length - 1];
+			const delay = backoffMs[attempt - 1] ?? backoffMs.at(-1);
 			logger.warn(`Publish conflict for ${packageName}@${version} (attempt ${attempt}/${maxAttempts}). Retrying in ${Math.ceil(delay / 1e3)}s...`);
 			await wait(delay);
 			continue;
@@ -2513,7 +2542,6 @@ async function publishPackage(packageName, version, workspaceRoot, options) {
 	}
 	return err(toNPMError("publishPackage", /* @__PURE__ */ new Error(`Failed to publish ${packageName}@${version} after ${maxAttempts} attempts`), "EPUBLISHCONFLICT"));
 }
-
 //#endregion
 //#region src/workflows/publish.ts
 async function getReleaseBodyFromChangelog(workspaceRoot, packageName, packagePath, version) {
@@ -2678,7 +2706,6 @@ async function publishWorkflow(options) {
 	}
 	logger.success("All packages published successfully!");
 }
-
 //#endregion
 //#region src/workflows/verify.ts
 async function verifyWorkflow(options) {
@@ -2773,7 +2800,6 @@ async function verifyWorkflow(options) {
 		logger.success("Verification successful. Commit status set to 'success'.");
 	}
 }
-
 //#endregion
 //#region src/index.ts
 function withErrorBoundary(fn) {
@@ -2831,6 +2857,5 @@ async function createReleaseScripts(options) {
 		}
 	};
 }
-
 //#endregion
-export { createReleaseScripts };
+export { createReleaseScripts };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ucdjs/release-scripts",
-  "version": "0.1.0-beta.60",
+  "version": "0.1.0-beta.61",
   "description": "@ucdjs release scripts",
   "type": "module",
   "license": "MIT",
@@ -26,23 +26,26 @@
   ],
   "dependencies": {
     "@luxass/utils": "2.7.3",
-    "commit-parser": "1.3.0",
+    "commit-parser": "1.3.1",
     "farver": "1.0.0-beta.1",
     "prompts": "2.4.2",
     "semver": "7.7.4",
-    "tinyexec": "1.0.2"
+    "tinyexec": "1.0.4"
   },
   "devDependencies": {
-    "@luxass/eslint-config": "7.2.0",
+    "@luxass/eslint-config": "7.3.0",
     "@types/node": "22.18.12",
     "@types/prompts": "2.4.9",
     "@types/semver": "7.7.1",
-    "eslint": "10.0.0",
+    "eslint": "10.0.3",
     "eta": "4.5.1",
-    "tsdown": "0.20.3",
+    "tsdown": "0.21.2",
     "typescript": "5.9.3",
-    "vitest": "4.0.18",
-    "vitest-testdirs": "4.4.2"
+    "vitest": "4.1.0",
+    "vitest-testdirs": "4.4.3"
+  },
+  "inlinedDependencies": {
+    "eta": "4.5.1"
   },
   "scripts": {
     "build": "tsdown",