@ucdjs/release-scripts 0.1.0-beta.41 → 0.1.0-beta.43

package/dist/index.mjs

@@ -60,6 +60,51 @@ const args = mri(process.argv.slice(2));
 const isDryRun = !!args.dry;
 const isVerbose = !!args.verbose;
 const isForce = !!args.force;
+function toTrimmedString(value) {
+	if (typeof value === "string") {
+		const normalized = value.trim();
+		return normalized.length > 0 ? normalized : void 0;
+	}
+	if (value instanceof Uint8Array) {
+		const normalized = new TextDecoder().decode(value).trim();
+		return normalized.length > 0 ? normalized : void 0;
+	}
+	if (isRecord(value) && typeof value.toString === "function") {
+		const rendered = value.toString();
+		if (typeof rendered === "string" && rendered !== "[object Object]") {
+			const normalized = rendered.trim();
+			return normalized.length > 0 ? normalized : void 0;
+		}
+	}
+}
+function getNestedField(record, keys) {
+	let current = record;
+	for (const key of keys) {
+		if (!isRecord(current) || !(key in current)) return;
+		current = current[key];
+	}
+	return current;
+}
+function extractStderrLike(record) {
+	const candidates = [
+		record.stderr,
+		record.stdout,
+		record.shortMessage,
+		record.originalMessage,
+		getNestedField(record, ["result", "stderr"]),
+		getNestedField(record, ["result", "stdout"]),
+		getNestedField(record, ["output", "stderr"]),
+		getNestedField(record, ["output", "stdout"]),
+		getNestedField(record, ["cause", "stderr"]),
+		getNestedField(record, ["cause", "stdout"]),
+		getNestedField(record, ["cause", "shortMessage"]),
+		getNestedField(record, ["cause", "originalMessage"])
+	];
+	for (const candidate of candidates) {
+		const rendered = toTrimmedString(candidate);
+		if (rendered) return rendered;
+	}
+}
 const ucdjsReleaseOverridesPath = ".github/ucdjs-release.overrides.json";
 const isCI = typeof process.env.CI === "string" && process.env.CI !== "" && process.env.CI.toLowerCase() !== "false";
 const logger = {
@@ -123,8 +168,49 @@ async function dryRun(bin, args, opts) {
 	return logger.verbose(farver.blue(`[dryrun] ${bin} ${args.join(" ")}`), opts || "");
 }
 const runIfNotDry = isDryRun ? dryRun : run;
-function exitWithError(message, hint) {
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+function formatUnknownError(error) {
+	if (error instanceof Error) {
+		const base = {
+			message: error.message || error.name,
+			stack: error.stack
+		};
+		const maybeError = error;
+		if (typeof maybeError.code === "string") base.code = maybeError.code;
+		if (typeof maybeError.status === "number") base.status = maybeError.status;
+		base.stderr = extractStderrLike(maybeError);
+		if (typeof maybeError.shortMessage === "string" && maybeError.shortMessage.trim() && base.message.startsWith("Process exited with non-zero status")) base.message = maybeError.shortMessage.trim();
+		if (!base.stderr && typeof maybeError.cause === "string" && maybeError.cause.trim()) base.stderr = maybeError.cause.trim();
+		return base;
+	}
+	if (typeof error === "string") return { message: error };
+	if (isRecord(error)) {
+		const formatted = { message: typeof error.message === "string" ? error.message : typeof error.error === "string" ? error.error : JSON.stringify(error) };
+		if (typeof error.code === "string") formatted.code = error.code;
+		if (typeof error.status === "number") formatted.status = error.status;
+		formatted.stderr = extractStderrLike(error);
+		return formatted;
+	}
+	return { message: String(error) };
+}
+function exitWithError(message, hint, cause) {
 	logger.error(farver.bold(message));
+	if (cause !== void 0) {
+		const formatted = formatUnknownError(cause);
+		if (formatted.message && formatted.message !== message) console.error(farver.gray(`  Cause: ${formatted.message}`));
+		if (formatted.code) console.error(farver.gray(`  Code: ${formatted.code}`));
+		if (typeof formatted.status === "number") console.error(farver.gray(`  Status: ${formatted.status}`));
+		if (formatted.stderr) {
+			console.error(farver.gray("  Stderr:"));
+			console.error(farver.gray(`  ${formatted.stderr}`));
+		}
+		if (isVerbose && formatted.stack) {
+			console.error(farver.gray("  Stack:"));
+			console.error(farver.gray(`  ${formatted.stack}`));
+		}
+	}
 	if (hint) console.error(farver.gray(`  ${hint}`));
 	process.exit(1);
 }
@@ -140,6 +226,15 @@ if (isDryRun || isVerbose || isForce) {
 
 //#endregion
 //#region src/core/github.ts
+function toGitHubError(operation, error) {
+	const formatted = formatUnknownError(error);
+	return {
+		type: "github",
+		operation,
+		message: formatted.message,
+		status: formatted.status
+	};
+}
 var GitHubClient = class {
 	owner;
 	repo;
@@ -152,18 +247,36 @@ var GitHubClient = class {
 	}
 	async request(path, init = {}) {
 		const url = path.startsWith("http") ? path : `${this.apiBase}${path}`;
-		const res = await fetch(url, {
-			...init,
-			headers: {
-				...init.headers,
-				"Accept": "application/vnd.github.v3+json",
-				"Authorization": `token ${this.githubToken}`,
-				"User-Agent": "ucdjs-release-scripts (+https://github.com/ucdjs/ucdjs-release-scripts)"
-			}
-		});
+		const method = init.method ?? "GET";
+		let res;
+		try {
+			res = await fetch(url, {
+				...init,
+				headers: {
+					...init.headers,
+					"Accept": "application/vnd.github.v3+json",
+					"Authorization": `token ${this.githubToken}`,
+					"User-Agent": "ucdjs-release-scripts (+https://github.com/ucdjs/ucdjs-release-scripts)"
+				}
+			});
+		} catch (error) {
+			throw Object.assign(/* @__PURE__ */ new Error(`[${method} ${path}] GitHub request failed: ${formatUnknownError(error).message}`), { status: void 0 });
+		}
 		if (!res.ok) {
 			const errorText = await res.text();
-			throw new Error(`GitHub API request failed with status ${res.status}: ${errorText || "No response body"}`);
+			const parsedMessage = (() => {
+				try {
+					const parsed = JSON.parse(errorText);
+					if (typeof parsed.message === "string" && parsed.message.trim()) {
+						if (Array.isArray(parsed.errors) && parsed.errors.length > 0) return `${parsed.message} (${JSON.stringify(parsed.errors)})`;
+						return parsed.message;
+					}
+					return errorText;
+				} catch {
+					return errorText;
+				}
+			})();
+			throw Object.assign(/* @__PURE__ */ new Error(`[${method} ${path}] GitHub API request failed (${res.status} ${res.statusText}): ${parsedMessage || "No response body"}`), { status: res.status });
 		}
 		if (res.status === 204) return;
 		return res.json();
@@ -238,14 +351,14 @@ var GitHubClient = class {
 			if (!data.items || data.items.length === 0) return info;
 			info.login = data.items[0].login;
 		} catch (err) {
-			logger.warn(`Failed to resolve author info for email ${info.email}: ${err.message}`);
+			logger.warn(`Failed to resolve author info for email ${info.email}: ${formatUnknownError(err).message}`);
 		}
 		if (info.login) return info;
 		if (info.commits.length > 0) try {
 			const data = await this.request(`/repos/${this.owner}/${this.repo}/commits/${info.commits[0]}`);
 			if (data.author && data.author.login) info.login = data.author.login;
 		} catch (err) {
-			logger.warn(`Failed to resolve author info from commits for email ${info.email}: ${err.message}`);
+			logger.warn(`Failed to resolve author info from commits for email ${info.email}: ${formatUnknownError(err).message}`);
 		}
 		return info;
 	}
@@ -391,11 +504,12 @@ function err(error) {
 //#endregion
 //#region src/core/git.ts
 function toGitError(operation, error) {
+	const formatted = formatUnknownError(error);
 	return {
 		type: "git",
 		operation,
-		message: error instanceof Error ? error.message : String(error),
-		stderr: (typeof error === "object" && error && "stderr" in error ? String(error.stderr ?? "") : void 0)?.trim() || void 0
+		message: formatted.message,
+		stderr: formatted.stderr
 	};
 }
 async function isWorkingDirectoryClean(workspaceRoot) {
@@ -425,7 +539,8 @@ async function doesBranchExist(branch, workspaceRoot) {
 			stdio: "pipe"
 		} });
 		return ok(true);
-	} catch {
+	} catch (error) {
+		logger.verbose(`Failed to verify branch "${branch}": ${formatUnknownError(error).message}`);
 		return ok(false);
 	}
 }
@@ -495,8 +610,8 @@ async function checkoutBranch(branch, workspaceRoot) {
 				stdio: "pipe"
 			} });
 			logger.verbose(`Available branches:\n${branchResult.stdout}`);
-		} catch {
-			logger.verbose("Could not list available branches");
+		} catch (error) {
+			logger.verbose(`Could not list available branches: ${formatUnknownError(error).message}`);
 		}
 		return err(gitError);
 	}
@@ -539,7 +654,8 @@ async function isBranchAheadOfRemote(branch, workspaceRoot) {
 			stdio: "pipe"
 		} });
 		return ok(Number.parseInt(result.stdout.trim(), 10) > 0);
-	} catch {
+	} catch (error) {
+		logger.verbose(`Failed to compare branch "${branch}" with remote: ${formatUnknownError(error).message}`);
 		return ok(true);
 	}
 }
@@ -575,7 +691,7 @@ async function pushBranch(branch, workspaceRoot, options) {
 			"origin",
 			branch
 		];
-		if (options?.forceWithLease) {
+		if (options?.forceWithLease) try {
 			await run("git", [
 				"fetch",
 				"origin",
@@ -586,7 +702,12 @@ async function pushBranch(branch, workspaceRoot, options) {
 			} });
 			args.push("--force-with-lease");
 			logger.info(`Pushing branch: ${farver.green(branch)} ${farver.dim("(with lease)")}`);
-		} else if (options?.force) {
+		} catch (error) {
+			const fetchError = toGitError("pushBranch.fetch", error);
+			if (fetchError.stderr?.includes("couldn't find remote ref") || fetchError.message.includes("couldn't find remote ref")) logger.verbose(`Remote branch origin/${branch} does not exist yet, falling back to regular push without --force-with-lease.`);
+			else return err(fetchError);
+		}
+		else if (options?.force) {
 			args.push("--force");
 			logger.info(`Force pushing branch: ${farver.green(branch)}`);
 		} else logger.info(`Pushing branch: ${farver.green(branch)}`);
@@ -605,7 +726,8 @@ async function readFileFromGit(workspaceRoot, ref, filePath) {
 			cwd: workspaceRoot,
 			stdio: "pipe"
 		} })).stdout);
-	} catch {
+	} catch (error) {
+		logger.verbose(`Failed to read ${filePath} from ${ref}: ${formatUnknownError(error).message}`);
 		return ok(null);
 	}
 }
@@ -1663,11 +1785,7 @@ async function syncPullRequest(options) {
 	} catch (error) {
 		return {
 			ok: false,
-			error: {
-				type: "github",
-				operation: "getExistingPullRequest",
-				message: error instanceof Error ? error.message : String(error)
-			}
+			error: toGitHubError("getExistingPullRequest", error)
 		};
 	}
 	const doesExist = !!existing;
@@ -1685,11 +1803,7 @@ async function syncPullRequest(options) {
 	} catch (error) {
 		return {
 			ok: false,
-			error: {
-				type: "github",
-				operation: "upsertPullRequest",
-				message: error instanceof Error ? error.message : String(error)
-			}
+			error: toGitHubError("upsertPullRequest", error)
 		};
 	}
 	return ok({
@@ -1703,10 +1817,11 @@ async function syncPullRequest(options) {
 async function prepareWorkflow(options) {
 	if (options.safeguards) {
 		const clean = await isWorkingDirectoryClean(options.workspaceRoot);
-		if (!clean.ok || !clean.value) exitWithError("Working directory is not clean. Please commit or stash your changes before proceeding.");
+		if (!clean.ok) exitWithError("Failed to verify working directory state.", "Ensure this is a valid git repository and try again.", clean.error);
+		if (!clean.value) exitWithError("Working directory is not clean. Please commit or stash your changes before proceeding.");
 	}
 	const discovered = await discoverWorkspacePackages(options.workspaceRoot, options);
-	if (!discovered.ok) exitWithError(`Failed to discover packages: ${discovered.error.message}`);
+	if (!discovered.ok) exitWithError("Failed to discover packages.", void 0, discovered.error);
 	const ensured = ensureHasPackages(discovered.value);
 	if (!ensured.ok) {
 		logger.warn(ensured.error.message);
@@ -1725,15 +1840,16 @@ async function prepareWorkflow(options) {
 		releaseBranch: options.branch.release,
 		defaultBranch: options.branch.default
 	});
-	if (!prepareBranchResult.ok) exitWithError(prepareBranchResult.error.message);
+	if (!prepareBranchResult.ok) exitWithError("Failed to prepare release branch.", void 0, prepareBranchResult.error);
 	const overridesPath = join(options.workspaceRoot, ucdjsReleaseOverridesPath);
 	let existingOverrides = {};
 	try {
 		const overridesContent = await readFile(overridesPath, "utf-8");
 		existingOverrides = JSON.parse(overridesContent);
 		logger.info("Found existing version overrides file.");
-	} catch {
+	} catch (error) {
 		logger.info("No existing version overrides file found. Continuing...");
+		logger.verbose(`Reading overrides file failed: ${formatUnknownError(error).message}`);
 	}
 	const updatesResult = await calculateUpdates({
 		workspacePackages,
@@ -1742,7 +1858,7 @@ async function prepareWorkflow(options) {
 		globalCommitMode: options.globalCommitMode === "none" ? false : options.globalCommitMode,
 		overrides: existingOverrides
 	});
-	if (!updatesResult.ok) exitWithError(updatesResult.error.message);
+	if (!updatesResult.ok) exitWithError("Failed to calculate package updates.", void 0, updatesResult.error);
 	const { allUpdates, applyUpdates, overrides: newOverrides } = updatesResult.value;
 	if (Object.keys(newOverrides).length > 0) {
 		logger.info("Writing version overrides file...");
@@ -1815,7 +1931,7 @@ async function prepareWorkflow(options) {
 		commitMessage: "chore: update release versions",
 		hasChanges: true
 	});
-	if (!hasChangesToPush.ok) exitWithError(hasChangesToPush.error.message);
+	if (!hasChangesToPush.ok) exitWithError("Failed to sync release changes.", void 0, hasChangesToPush.error);
 	if (!hasChangesToPush.value) {
 		const prResult = await syncPullRequest({
 			github: options.githubClient,
@@ -1825,7 +1941,7 @@ async function prepareWorkflow(options) {
 			pullRequestBody: options.pullRequest?.body,
 			updates: allUpdates
 		});
-		if (!prResult.ok) exitWithError(prResult.error.message);
+		if (!prResult.ok) exitWithError("Failed to sync release pull request.", void 0, prResult.error);
 		if (prResult.value.pullRequest) {
 			logger.item("No updates needed, PR is already up to date");
 			return {
@@ -1845,13 +1961,14 @@ async function prepareWorkflow(options) {
 		pullRequestBody: options.pullRequest?.body,
 		updates: allUpdates
 	});
-	if (!prResult.ok) exitWithError(prResult.error.message);
+	if (!prResult.ok) exitWithError("Failed to sync release pull request.", void 0, prResult.error);
 	if (prResult.value.pullRequest?.html_url) {
 		logger.section("🚀 Pull Request");
 		logger.success(`Pull request ${prResult.value.created ? "created" : "updated"}: ${prResult.value.pullRequest.html_url}`);
 	}
 	const returnToDefault = await checkoutBranch(options.branch.default, options.workspaceRoot);
-	if (!returnToDefault.ok || !returnToDefault.value) exitWithError(`Failed to checkout branch: ${options.branch.default}`);
+	if (!returnToDefault.ok) exitWithError(`Failed to checkout branch: ${options.branch.default}`, void 0, returnToDefault.error);
+	if (!returnToDefault.value) exitWithError(`Failed to checkout branch: ${options.branch.default}`);
 	return {
 		updates: allUpdates,
 		prUrl: prResult.value.pullRequest?.html_url,
@@ -1862,11 +1979,14 @@ async function prepareWorkflow(options) {
 //#endregion
 //#region src/core/npm.ts
 function toNPMError(operation, error, code) {
+	const formatted = formatUnknownError(error);
 	return {
 		type: "npm",
 		operation,
-		message: error instanceof Error ? error.message : String(error),
-		code
+		message: formatted.message,
+		code: code || formatted.code,
+		stderr: formatted.stderr,
+		status: formatted.status
 	};
 }
 /**
@@ -1961,7 +2081,7 @@ async function publishPackage(packageName, workspaceRoot, options) {
 		} });
 		return ok(void 0);
 	} catch (error) {
-		const errorMessage = error instanceof Error ? error.message : String(error);
+		const errorMessage = formatUnknownError(error).message;
 		return err(toNPMError("publishPackage", error, errorMessage.includes("E403") ? "E403" : errorMessage.includes("EPUBLISHCONFLICT") ? "EPUBLISHCONFLICT" : errorMessage.includes("EOTP") ? "EOTP" : void 0));
 	}
 }
@@ -1971,7 +2091,7 @@ async function publishPackage(packageName, workspaceRoot, options) {
 async function publishWorkflow(options) {
 	logger.section("📦 Publishing Packages");
 	const discovered = await discoverWorkspacePackages(options.workspaceRoot, options);
-	if (!discovered.ok) exitWithError(`Failed to discover packages: ${discovered.error.message}`);
+	if (!discovered.ok) exitWithError("Failed to discover packages.", void 0, discovered.error);
 	const workspacePackages = discovered.value;
 	logger.item(`Found ${workspacePackages.length} packages in workspace`);
 	const graph = buildPackageDependencyGraph(workspacePackages);
@@ -1997,7 +2117,7 @@ async function publishWorkflow(options) {
 		if (!existsResult.ok) {
 			logger.error(`Failed to check version: ${existsResult.error.message}`);
 			status.failed.push(packageName);
-			exitWithError(`Publishing failed for ${packageName}: ${existsResult.error.message}`, "Check your network connection and NPM registry access");
+			exitWithError(`Publishing failed for ${packageName}.`, "Check your network connection and NPM registry access", existsResult.error);
 		}
 		if (existsResult.value) {
 			logger.info(`Version ${farver.cyan(version)} already exists on NPM, skipping`);
@@ -2010,7 +2130,7 @@ async function publishWorkflow(options) {
 			if (!buildResult.ok) {
 				logger.error(`Failed to build package: ${buildResult.error.message}`);
 				status.failed.push(packageName);
-				exitWithError(`Publishing failed for ${packageName}: build failed`, "Check your build scripts and dependencies");
+				exitWithError(`Publishing failed for ${packageName}: build failed`, "Check your build scripts and dependencies", buildResult.error);
 			}
 		}
 		logger.step(`Publishing ${farver.cyan(`${packageName}@${version}`)} to NPM...`);
@@ -2022,7 +2142,7 @@ async function publishWorkflow(options) {
 			if (publishResult.error.code === "E403") hint = "Authentication failed. Ensure your NPM token or OIDC configuration is correct";
 			else if (publishResult.error.code === "EPUBLISHCONFLICT") hint = "Version conflict. The version may have been published recently";
 			else if (publishResult.error.code === "EOTP") hint = "2FA/OTP required. Provide the otp option or use OIDC authentication";
-			exitWithError(`Publishing failed for ${packageName}`, hint);
+			exitWithError(`Publishing failed for ${packageName}`, hint, publishResult.error);
 		}
 		logger.success(`Published ${farver.cyan(`${packageName}@${version}`)}`);
 		status.published.push(packageName);
@@ -2053,7 +2173,8 @@ async function publishWorkflow(options) {
 async function verifyWorkflow(options) {
 	if (options.safeguards) {
 		const clean = await isWorkingDirectoryClean(options.workspaceRoot);
-		if (!clean.ok || !clean.value) exitWithError("Working directory is not clean. Please commit or stash your changes before proceeding.");
+		if (!clean.ok) exitWithError("Failed to verify working directory state.", "Ensure this is a valid git repository and try again.", clean.error);
+		if (!clean.value) exitWithError("Working directory is not clean. Please commit or stash your changes before proceeding.");
 	}
 	const releaseBranch = options.branch.release;
 	const defaultBranch = options.branch.default;
@@ -2064,10 +2185,11 @@ async function verifyWorkflow(options) {
 	}
 	logger.info(`Found release PR #${releasePr.number}. Verifying against default branch "${defaultBranch}"...`);
 	const originalBranch = await getCurrentBranch(options.workspaceRoot);
-	if (!originalBranch.ok) exitWithError(originalBranch.error.message);
+	if (!originalBranch.ok) exitWithError("Failed to detect current branch.", void 0, originalBranch.error);
 	if (originalBranch.value !== defaultBranch) {
 		const checkout = await checkoutBranch(defaultBranch, options.workspaceRoot);
-		if (!checkout.ok || !checkout.value) exitWithError(`Failed to checkout branch: ${defaultBranch}`);
+		if (!checkout.ok) exitWithError(`Failed to checkout branch: ${defaultBranch}`, void 0, checkout.error);
+		if (!checkout.value) exitWithError(`Failed to checkout branch: ${defaultBranch}`);
 	}
 	let existingOverrides = {};
 	try {
@@ -2076,11 +2198,12 @@ async function verifyWorkflow(options) {
 			existingOverrides = JSON.parse(overridesContent.value);
 			logger.info("Found existing version overrides file on release branch.");
 		}
-	} catch {
+	} catch (error) {
 		logger.info("No version overrides file found on release branch. Continuing...");
+		logger.verbose(`Reading release overrides failed: ${formatUnknownError(error).message}`);
 	}
 	const discovered = await discoverWorkspacePackages(options.workspaceRoot, options);
-	if (!discovered.ok) exitWithError(`Failed to discover packages: ${discovered.error.message}`);
+	if (!discovered.ok) exitWithError("Failed to discover packages.", void 0, discovered.error);
 	const ensured = ensureHasPackages(discovered.value);
 	if (!ensured.ok) {
 		logger.warn(ensured.error.message);
@@ -2094,7 +2217,7 @@ async function verifyWorkflow(options) {
 		globalCommitMode: options.globalCommitMode === "none" ? false : options.globalCommitMode,
 		overrides: existingOverrides
 	});
-	if (!updatesResult.ok) exitWithError(updatesResult.error.message);
+	if (!updatesResult.ok) exitWithError("Failed to calculate expected package updates.", void 0, updatesResult.error);
 	const expectedUpdates = updatesResult.value.allUpdates;
 	const expectedVersionMap = new Map(expectedUpdates.map((u) => [u.package.name, u.newVersion]));
 	const prVersionMap = /* @__PURE__ */ new Map();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ucdjs/release-scripts",
-  "version": "0.1.0-beta.41",
+  "version": "0.1.0-beta.43",
   "description": "@ucdjs release scripts",
   "type": "module",
   "license": "MIT",