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,7 +26,7 @@ program
     if (opts.strict) {
       args.push('--strict');
     }
-    const res = exec('pdm', args, {
+    const res = await exec('pdm', args, {
       cwd: 'tools/mkdocs',
       stdio: 'inherit',
       env: {
@@ -50,7 +50,7 @@ program
     if (opts.strict) {
       args.push('--strict');
     }
-    const res = exec('pdm', args, {
+    const res = await exec('pdm', args, {
       cwd: 'tools/mkdocs',
       stdio: 'inherit',
     });
@@ -68,7 +68,7 @@ async function prepareDocs(opts: any): Promise<void> {
   }
 }
 
-function checkResult(res: ExecaSyncReturnValue<string>): void {
+function checkResult(res: ExecaReturnValue<string>): 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.`);
 }
 
-(() => {
+void (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() {
   }
 })();
 
-(() => {
+void (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/publish-release.ts

@@ -29,11 +29,11 @@ void (async () => {
   const meta = await bake('push', opts);
 
   if (meta?.['push-slim']?.['containerimage.digest']) {
-    sign(
+    await sign(
       `ghcr.io/renovatebot/renovate@${meta['push-slim']['containerimage.digest']}`,
       opts,
     );
-    sign(
+    await sign(
       `renovate/renovate@${meta['push-slim']['containerimage.digest']}`,
       opts,
     );
@@ -42,11 +42,11 @@ void (async () => {
   }
 
   if (meta?.['push-full']?.['containerimage.digest']) {
-    sign(
+    await sign(
       `ghcr.io/renovatebot/renovate@${meta['push-full']['containerimage.digest']}`,
       opts,
     );
-    sign(
+    await sign(
       `renovate/renovate@${meta['push-full']['containerimage.digest']}`,
       opts,
     );

tools/utils/docker.ts

@@ -66,7 +66,7 @@ export async function bake(
   args.push(target);
 
   for (let tries = opts.tries ?? 0; tries >= 0; tries--) {
-    const result = exec(`docker`, args);
+    const result = await exec(`docker`, args);
     if (result.signal) {
       logger.error(`Signal received: ${result.signal}`);
       process.exit(-1);
@@ -97,15 +97,15 @@ export async function bake(
   return meta;
 }
 
-export function sign(
+export async function sign(
   image: string,
   opts: {
     args?: string[];
     exitOnError?: boolean;
   },
-): void {
+): Promise<void> {
   logger.info(`Signing ${image} ...`);
-  const result = exec('cosign', ['sign', '--yes', image]);
+  const result = await exec('cosign', ['sign', '--yes', image]);
   if (result.signal) {
     logger.error(`Signal received: ${result.signal}`);
     process.exit(-1);

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',