@oorabona/release-it-preset 0.9.0 → 0.10.0

package/README.md

@@ -4,6 +4,7 @@ Shared [release-it](https://github.com/release-it/release-it) configuration and
 
 [![codecov](https://codecov.io/github/oorabona/release-it-preset/graph/badge.svg?token=6RMN34Z7TX)](https://codecov.io/github/oorabona/release-it-preset)
 [![CI](https://github.com/oorabona/release-it-preset/actions/workflows/ci.yml/badge.svg)](https://github.com/oorabona/release-it-preset/actions/workflows/ci.yml)
+[![Audit](https://github.com/oorabona/release-it-preset/actions/workflows/audit.yml/badge.svg)](https://github.com/oorabona/release-it-preset/actions/workflows/audit.yml)
 [![NPM Version](https://img.shields.io/npm/v/release-it-preset.svg)](https://npmjs.org/package/@oorabona/release-it-preset)
 [![NPM Downloads](https://img.shields.io/npm/dm/release-it-preset.svg)](https://npmjs.org/package/@oorabona/release-it-preset)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.3+-blue.svg)](https://www.typescriptlang.org/)

package/dist/scripts/check-config.js

@@ -15,6 +15,7 @@
 import { execSync } from 'node:child_process';
 import { existsSync, readFileSync } from 'node:fs';
 import { getGitHubRepoUrl } from './lib/git-utils.js';
+import { runScript } from './lib/run-script.js';
 export function safeExec(command, deps) {
     try {
         return deps.execSync(command, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
@@ -256,7 +257,7 @@ export function displayNpmStatus(deps, npmUsername) {
  */
 /* c8 ignore start */
 if (import.meta.url === `file://${process.argv[1]}`) {
-    async function main() {
+    void runScript({ error: console.error, exit: process.exit }, async () => {
         console.log('🔍 Checking release configuration and project status...');
         const deps = {
             execSync,
@@ -276,10 +277,6 @@ if (import.meta.url === `file://${process.argv[1]}`) {
         console.log('\n✨ Check complete!');
         console.log('\nTo validate release readiness, run:');
         console.log('  pnpm release-it-preset validate\n');
-    }
-    main().catch((error) => {
-        console.error('❌ Check failed:', error);
-        process.exit(1);
     });
 }
 /* c8 ignore end */

package/dist/scripts/check-pr-status.js

@@ -13,6 +13,7 @@
 import { execSync } from 'node:child_process';
 import { appendFileSync } from 'node:fs';
 import { STRICT_CONVENTIONAL_COMMIT_REGEX } from './lib/commit-parser.js';
+import { runScript } from './lib/run-script.js';
 const SKIP_CHANGELOG_REGEX = /\[skip-changelog]/i;
 export function safeExec(command, deps) {
     try {
@@ -155,10 +156,12 @@ export function renderSummary(result, deps) {
 }
 /* c8 ignore start */
 if (import.meta.url === `file://${process.argv[1]}`) {
-    const deps = createDefaultDeps();
-    const args = parseArgs(process.argv.slice(2));
-    const result = runPrCheck(args, deps);
-    writeOutputs(result, deps);
-    renderSummary(result, deps);
+    void runScript({ error: console.error, exit: process.exit }, () => {
+        const deps = createDefaultDeps();
+        const args = parseArgs(process.argv.slice(2));
+        const result = runPrCheck(args, deps);
+        writeOutputs(result, deps);
+        renderSummary(result, deps);
+    });
 }
 /* c8 ignore end */

package/dist/scripts/extract-changelog.js

@@ -18,6 +18,7 @@ import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { validateAndNormalizeSemver } from './lib/semver-utils.js';
 import { escapeRegExp } from './lib/string-utils.js';
+import { runScript } from './lib/run-script.js';
 export function extractChangelog(version, deps) {
     // Validate semver format
     const normalizedVersion = validateAndNormalizeSemver(version);
@@ -45,22 +46,19 @@ export function extractChangelog(version, deps) {
  */
 /* c8 ignore start */
 if (import.meta.url === `file://${process.argv[1]}`) {
-    const version = process.argv[2];
-    if (!version) {
-        console.error('Usage: tsx scripts/extract-changelog.ts <version>');
-        process.exit(1);
-    }
-    try {
+    void runScript({ error: console.error, exit: process.exit }, () => {
+        const version = process.argv[2];
+        if (!version) {
+            console.error('Usage: tsx scripts/extract-changelog.ts <version>');
+            process.exit(1);
+            return;
+        }
         const result = extractChangelog(version, {
             readFileSync,
             getEnv: (key) => process.env[key],
             getCwd: () => process.cwd(),
         });
         console.log(result);
-    }
-    catch (error) {
-        console.error(`❌ ${error instanceof Error ? error.message : error}`);
-        process.exit(1);
-    }
+    });
 }
 /* c8 ignore end */

package/dist/scripts/init-project.js

@@ -15,6 +15,7 @@
  */
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { createInterface } from 'node:readline';
+import { runScript } from './lib/run-script.js';
 const CHANGELOG_TEMPLATE = `# Changelog
 
 All notable changes to this project will be documented in this file.
@@ -163,29 +164,28 @@ export async function initProject(options, deps) {
  */
 /* c8 ignore start */
 if (import.meta.url === `file://${process.argv[1]}`) {
-    async function realPrompt(question) {
-        const rl = createInterface({
-            input: process.stdin,
-            output: process.stdout,
-        });
-        return new Promise((resolve) => {
-            rl.question(`${question} (y/N): `, (answer) => {
-                rl.close();
-                resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+    void runScript({ error: console.error, exit: process.exit }, async () => {
+        async function realPrompt(question) {
+            const rl = createInterface({
+                input: process.stdin,
+                output: process.stdout,
+            });
+            return new Promise((resolve) => {
+                rl.question(`${question} (y/N): `, (answer) => {
+                    rl.close();
+                    resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+                });
             });
+        }
+        const options = parseArgs();
+        await initProject(options, {
+            existsSync,
+            readFileSync,
+            writeFileSync,
+            prompt: realPrompt,
+            log: console.log,
+            warn: console.warn,
         });
-    }
-    const options = parseArgs();
-    initProject(options, {
-        existsSync,
-        readFileSync,
-        writeFileSync,
-        prompt: realPrompt,
-        log: console.log,
-        warn: console.warn,
-    }).catch((error) => {
-        console.error('❌ Initialization failed:', error);
-        process.exit(1);
     });
 }
 /* c8 ignore end */

package/dist/scripts/lib/errors.js

@@ -0,0 +1,45 @@
+/**
+ * Typed error hierarchy for script-level failures.
+ *
+ * Each subclass maps to a specific CLI exit code so that callers and
+ * the `runScript()` wrapper can surface the right exit code without
+ * inspecting raw strings.
+ *
+ * Usage:
+ *   throw new ValidationError('CHANGELOG.md not found')
+ *   // → exits with code 2
+ *
+ *   throw new GitError('git tag not found')
+ *   // → exits with code 1
+ */
+/**
+ * Base class for all script-level errors that map to a CLI exit code.
+ * Throw a subclass to signal a specific failure mode; uncaught throws
+ * fall through to exit code 1 via runScript().
+ */
+export class ScriptError extends Error {
+    exitCode;
+    constructor(message, options) {
+        super(message, options?.cause !== undefined ? { cause: options.cause } : undefined);
+        this.name = this.constructor.name;
+        this.exitCode = options?.exitCode ?? 1;
+    }
+}
+/** Pre-flight or input-validation failure (e.g. missing CHANGELOG, wrong branch, dirty tree). Exit 2. */
+export class ValidationError extends ScriptError {
+    constructor(message, options) {
+        super(message, { exitCode: 2, cause: options?.cause });
+    }
+}
+/** Git operation failure (tag not found, command non-zero, parse error on git output). Exit 1. */
+export class GitError extends ScriptError {
+    constructor(message, options) {
+        super(message, { exitCode: 1, cause: options?.cause });
+    }
+}
+/** Changelog parse/write failure (malformed file, missing [Unreleased], etc.). Exit 1. */
+export class ChangelogError extends ScriptError {
+    constructor(message, options) {
+        super(message, { exitCode: 1, cause: options?.cause });
+    }
+}

package/dist/scripts/lib/run-script.js

@@ -0,0 +1,28 @@
+import { ScriptError } from './errors.js';
+/**
+ * Wraps a script's main function with consistent error handling and
+ * exit-code mapping. ScriptError subclasses exit with their specific
+ * exitCode; any other thrown value exits 1 with a generic message.
+ *
+ * The function may be sync or async. Returns a promise that resolves
+ * before exit() is called for the failure path; on success the promise
+ * simply resolves (exit() is not invoked — caller can let process end
+ * naturally with code 0).
+ */
+export async function runScript(deps, fn) {
+    try {
+        await fn();
+    }
+    catch (err) {
+        if (err instanceof ScriptError) {
+            deps.error(`❌ ${err.message}`);
+            deps.exit(err.exitCode);
+        }
+        if (err instanceof Error) {
+            deps.error(`❌ Unexpected error: ${err.message}`);
+            deps.exit(1);
+        }
+        deps.error(`❌ Unknown error: ${String(err)}`);
+        deps.exit(1);
+    }
+}

package/dist/scripts/populate-unreleased-changelog.js

@@ -21,6 +21,7 @@ import { execSync } from 'node:child_process';
 import { readFileSync, writeFileSync } from 'node:fs';
 import { getGitHubRepoUrl } from './lib/git-utils.js';
 import { CONVENTIONAL_COMMIT_REGEX } from './lib/commit-parser.js';
+import { runScript } from './lib/run-script.js';
 /**
  * Extract all conventional commit patterns from a commit body
  */
@@ -223,20 +224,14 @@ export function populateChangelog(deps) {
  */
 /* c8 ignore start */
 if (import.meta.url === `file://${process.argv[1]}`) {
-    try {
-        populateChangelog({
-            execSync,
-            readFileSync,
-            writeFileSync,
-            getEnv: (key) => process.env[key],
-            log: console.log,
-            warn: console.warn,
-            error: console.error,
-        });
-    }
-    catch (error) {
-        console.error('❌ Failed to populate [Unreleased] section:', error);
-        process.exit(1);
-    }
+    void runScript({ error: console.error, exit: process.exit }, () => populateChangelog({
+        execSync,
+        readFileSync,
+        writeFileSync,
+        getEnv: (key) => process.env[key],
+        log: console.log,
+        warn: console.warn,
+        error: console.error,
+    }));
 }
 /* c8 ignore end */

package/dist/scripts/republish-changelog.js

@@ -24,6 +24,7 @@ import { execSync } from 'node:child_process';
 import { getGitHubRepoUrl } from './lib/git-utils.js';
 import { escapeRegExp } from './lib/string-utils.js';
 import { validateAndNormalizeSemver } from './lib/semver-utils.js';
+import { runScript } from './lib/run-script.js';
 export function updateReferenceLinks(changelog, versionLabels, linkTarget, unreleasedLine) {
     const lines = changelog.split(/\r?\n/);
     const updatedLines = [];
@@ -162,26 +163,19 @@ export function republishChangelog(version, deps) {
  */
 /* c8 ignore start */
 if (import.meta.url === `file://${process.argv[1]}`) {
-    async function main() {
-        try {
-            const pkg = await import(join(process.cwd(), 'package.json'), { with: { type: 'json' } });
-            const version = pkg.default.version;
-            republishChangelog(version, {
-                execSync,
-                readFileSync,
-                writeFileSync,
-                getEnv: (key) => process.env[key],
-                getCwd: () => process.cwd(),
-                getDate: () => new Date().toISOString().split('T')[0],
-                log: console.log,
-                warn: console.warn,
-            });
-        }
-        catch (error) {
-            console.error(`❌ ${error instanceof Error ? error.message : error}`);
-            process.exit(1);
-        }
-    }
-    main();
+    void runScript({ error: console.error, exit: process.exit }, async () => {
+        const pkg = await import(join(process.cwd(), 'package.json'), { with: { type: 'json' } });
+        const version = pkg.default.version;
+        republishChangelog(version, {
+            execSync,
+            readFileSync,
+            writeFileSync,
+            getEnv: (key) => process.env[key],
+            getCwd: () => process.cwd(),
+            getDate: () => new Date().toISOString().split('T')[0],
+            log: console.log,
+            warn: console.warn,
+        });
+    });
 }
 /* c8 ignore end */

package/dist/scripts/retry-publish.js

@@ -17,6 +17,7 @@
  */
 import { execSync } from 'node:child_process';
 import { readFileSync } from 'node:fs';
+import { runScript } from './lib/run-script.js';
 export function retryPublish(deps) {
     deps.log('🔄 Starting retry publish process...');
     const currentBranch = deps.execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf8' }).trim();
@@ -82,17 +83,13 @@ export function retryPublish(deps) {
  */
 /* c8 ignore start */
 if (import.meta.url === `file://${process.argv[1]}`) {
-    try {
+    void runScript({ error: console.error, exit: process.exit }, () => {
         retryPublish({
             execSync,
             readFileSync,
             log: console.log,
             warn: console.warn,
         });
-    }
-    catch (error) {
-        console.error(`❌ Pre-flight checks failed: ${error instanceof Error ? error.message : error}`);
-        process.exit(1);
-    }
+    });
 }
 /* c8 ignore end */

package/dist/scripts/validate-release.js

@@ -18,6 +18,8 @@
  */
 import { execSync } from 'node:child_process';
 import { existsSync, readFileSync } from 'node:fs';
+import { ValidationError } from './lib/errors.js';
+import { runScript } from './lib/run-script.js';
 export function parseArgs(argv) {
     return {
         allowDirty: argv.includes('--allow-dirty'),
@@ -248,7 +250,7 @@ export function validateRelease(deps, options) {
  */
 /* c8 ignore start */
 if (import.meta.url === `file://${process.argv[1]}`) {
-    async function main() {
+    void runScript({ error: console.error, exit: process.exit }, async () => {
         const options = parseArgs(process.argv.slice(2));
         console.log('🔍 Validating release readiness...\n');
         const deps = {
@@ -273,16 +275,10 @@ if (import.meta.url === `file://${process.argv[1]}`) {
         console.log();
         if (allPassed) {
             console.log('✨ All validations passed! Ready to release.');
-            process.exit(0);
         }
         else {
-            console.log('❌ Some validations failed. Please fix the issues above before releasing.');
-            process.exit(1);
+            throw new ValidationError('Some validations failed. Please fix the issues above before releasing.');
         }
-    }
-    main().catch((error) => {
-        console.error('❌ Validation failed:', error);
-        process.exit(1);
     });
 }
 /* c8 ignore end */

package/dist/types/lib/errors.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Typed error hierarchy for script-level failures.
+ *
+ * Each subclass maps to a specific CLI exit code so that callers and
+ * the `runScript()` wrapper can surface the right exit code without
+ * inspecting raw strings.
+ *
+ * Usage:
+ *   throw new ValidationError('CHANGELOG.md not found')
+ *   // → exits with code 2
+ *
+ *   throw new GitError('git tag not found')
+ *   // → exits with code 1
+ */
+/**
+ * Base class for all script-level errors that map to a CLI exit code.
+ * Throw a subclass to signal a specific failure mode; uncaught throws
+ * fall through to exit code 1 via runScript().
+ */
+export declare class ScriptError extends Error {
+    readonly exitCode: number;
+    constructor(message: string, options?: {
+        exitCode?: number;
+        cause?: unknown;
+    });
+}
+/** Pre-flight or input-validation failure (e.g. missing CHANGELOG, wrong branch, dirty tree). Exit 2. */
+export declare class ValidationError extends ScriptError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** Git operation failure (tag not found, command non-zero, parse error on git output). Exit 1. */
+export declare class GitError extends ScriptError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** Changelog parse/write failure (malformed file, missing [Unreleased], etc.). Exit 1. */
+export declare class ChangelogError extends ScriptError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}

package/dist/types/lib/run-script.d.ts

@@ -0,0 +1,15 @@
+export interface RunScriptDeps {
+    error: (msg: string) => void;
+    exit: (code: number) => never;
+}
+/**
+ * Wraps a script's main function with consistent error handling and
+ * exit-code mapping. ScriptError subclasses exit with their specific
+ * exitCode; any other thrown value exits 1 with a generic message.
+ *
+ * The function may be sync or async. Returns a promise that resolves
+ * before exit() is called for the failure path; on success the promise
+ * simply resolves (exit() is not invoked — caller can let process end
+ * naturally with code 0).
+ */
+export declare function runScript(deps: RunScriptDeps, fn: () => void | Promise<void>): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oorabona/release-it-preset",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Shared release-it configuration and scripts for the organisation",
   "type": "module",
   "keywords": [
@@ -69,23 +69,25 @@
     "test:unit": "vitest run tests/unit/*.test.ts",
     "test:unit:watch": "vitest tests/unit/*.test.ts",
     "test:unit:coverage": "vitest run tests/unit/*.test.ts --coverage",
+    "test:e2e": "vitest run tests/e2e/*.test.ts --testTimeout=30000",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "test:ui": "vitest --ui",
     "prepublishOnly": "pnpm build && echo 'Running prepublish checks...' && test -f README.md && test -f LICENSE"
   },
   "peerDependencies": {
-    "release-it": "^19.0.0"
+    "release-it": "^20.0.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.2.5",
-    "@types/node": "^24.6.2",
-    "@vitest/coverage-v8": "^3.2.4",
-    "nano-staged": "^0.8.0",
-    "rimraf": "^6.0.1",
-    "tsx": "^4.20.6",
-    "typescript": "^5.7.3",
-    "vitest": "^3.2.4"
+    "@biomejs/biome": "^2.4.13",
+    "@types/node": "^25.6.0",
+    "@vitest/coverage-v8": "^4.1.5",
+    "nano-staged": "^1.0.2",
+    "release-it": "^20.0.1",
+    "rimraf": "^6.1.3",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
   },
   "engines": {
     "node": ">=18.0.0"