refactor(tools): use asynchronous execa

Co-authored-by: Claude Sonnet 4.5 <jamie.tanna+github-copilot@mend.io>

Author: jamietanna

tools/mkdocs.ts

@@ -1,5 +1,5 @@
 import { Command } from 'commander';
-import type { ExecaSyncReturnValue } from 'execa';
+import type { ExecaReturnValue } from 'execa';
 import fs from 'fs-extra';
 import { logger } from '../lib/logger/index.ts';
 import { generateDocs } from './docs/index.ts';
@@ -26,15 +26,15 @@ program
     if (opts.strict) {
       args.push('--strict');
     }
-    const res = exec('pdm', args, {
+    const res = await exec('pdm', args, {
       cwd: 'tools/mkdocs',
       stdio: 'inherit',
       env: {
         ...process.env,
         RENOVATE_VERSION: opts.version ?? '',
       },
     });
-    checkResult(res);
+    await checkResult(res);
   });
 
 program
@@ -50,11 +50,11 @@ program
     if (opts.strict) {
       args.push('--strict');
     }
-    const res = exec('pdm', args, {
+    const res = await exec('pdm', args, {
       cwd: 'tools/mkdocs',
       stdio: 'inherit',
     });
-    checkResult(res);
+    await checkResult(res);
   });
 
 async function prepareDocs(opts: any): Promise<void> {
@@ -68,7 +68,7 @@ async function prepareDocs(opts: any): Promise<void> {
   }
 }
 
-function checkResult(res: ExecaSyncReturnValue<string>): void {
+async function checkResult(res: ExecaReturnValue<string>): Promise<void> {
   if (res.signal) {
     logger.error(`Signal received: ${res.signal}`);
     process.exit(-1);

tools/prepare-deps.mjs

@@ -1,7 +1,7 @@
-import { execaSync } from 'execa';
+import { execa } from 'execa';
 
-function testRe2() {
-  execaSync(
+async function testRe2() {
+  await execa(
     'node',
     [
       '-e',
@@ -12,8 +12,8 @@ function testRe2() {
   console.log(`Ok.`);
 }
 
-function testSqlite() {
-  execaSync(
+async function testSqlite() {
+  await execa(
     'node',
     [
       '-e',
@@ -24,19 +24,19 @@ function testSqlite() {
   console.log(`Ok.`);
 }
 
-(() => {
+(async () => {
   console.log('Checking re2 ... ');
   try {
-    testRe2();
+    await testRe2();
   } catch (e) {
     console.error(`Failed.\n${e}`);
     try {
       if (e.exitCode === 1) {
         console.log(`Retry re2 install ...`);
-        execaSync('pnpm', ['rb', 're2'], {
+        await execa('pnpm', ['rb', 're2'], {
           stdio: 'inherit',
         });
-        testRe2();
+        await testRe2();
         return;
       }
     } catch (e1) {
@@ -47,19 +47,19 @@ function testSqlite() {
   }
 })();
 
-(() => {
+(async () => {
   console.log('Checking better-sqlite3 ... ');
   try {
-    testSqlite();
+    await testSqlite();
   } catch (e) {
     console.error(`Failed.\n${e}`);
     try {
       if (e.exitCode === 1) {
         console.log(`Retry better-sqlite3 install ...`);
-        execaSync('pnpm', ['rb', 'better-sqlite3'], {
+        await execa('pnpm', ['rb', 'better-sqlite3'], {
           stdio: 'inherit',
         });
-        testSqlite();
+        await testSqlite();
         return;
       }
     } catch (e1) {

tools/prepare-release.ts

@@ -31,14 +31,14 @@ void (async () => {
   await program.parseAsync();
   const opts = program.opts();
   logger.info(`Preparing v${opts.version?.toString()} ...`);
-  build();
+  await build();
   await generateDocs(undefined, undefined, opts.version?.toString());
   await bake('build', opts);
 })();
 
-function build(): void {
+async function build(): Promise<void> {
   logger.info('Building ...');
-  const res = exec('pnpm', ['build']);
+  const res = await exec('pnpm', ['build']);
 
   if (res.signal) {
     logger.error(`Signal received: ${res.signal}`);

tools/utils/exec.ts

@@ -1,19 +1,19 @@
-import type { ExecaSyncReturnValue, SyncOptions } from 'execa';
-import { execaSync } from 'execa';
+import type { ExecaReturnValue, Options } from 'execa';
+import { execa } from 'execa';
 
 const maxBuffer = 20 * 1024 * 1024;
 
 /**
- * Execute a command synchronously using execa
+ * Execute a command asynchronously using execa
  * @param {string} cmd
  * @param {string[]} args
  */
-export function exec(
+export async function exec(
   cmd: string,
   args: string[] = [],
-  opts: SyncOptions = {},
-): ExecaSyncReturnValue<string> {
-  return execaSync(cmd, args, {
+  opts: Options = {},
+): Promise<ExecaReturnValue<string>> {
+  return await execa(cmd, args, {
     ...opts,
     maxBuffer,
     encoding: 'utf8',