@alphahydrae/exec 1.1.0 → 3.0.0

package/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2025 Simon Oulevay (Alpha Hydrae)
+Copyright (c) 2025-2026 Simon Oulevay (Alpha Hydrae)
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

package/README.md

@@ -41,7 +41,7 @@ npm i @alphahydrae/exec
 
 ## Support matrix
 
-| OS & Architecture | Node.js 18 | Node.js 20 | Node.js 22 |
+| OS & Architecture | Node.js 22 | Node.js 24 | Node.js 26 |
 | :---------------- | :--------: | :--------: | :--------: |
 | macOS x64         |     ✅     |     ✅     |     ✅     |
 | macOS arm64       |     ✅     |     ✅     |     ✅     |

package/exec.d.ts

@@ -1,18 +1,29 @@
+export type ExecvpOptions = {
+  readonly arg0?: string | null;
+};
+
 /**
  * Performs the execvp system call with the given file and arguments, replacing
  * the current process image with the new one.
  *
- *     execvp('ls', ['-l', '.']);
- *
- * This function does not return if successful, as the current process is
+ * This function does not return if successful, as the current process image is
  * replaced by the new one. An error may be thrown, with an error message
  * containing the error code returned by execvp.
  *
+ * @example
+ * import { execvp } from '@alphahydrae/exec';
+ * execvp('ls', ['-l', '.']);
+ *
  * @param {string} file The file to execute. If not a path, the PATH environment
  *                      variable is searched.
- * @param {string[]} args The arguments to pass to the new process.
- *                        `process.argv0` is automatically prepended to the
- *                        arguments.
+ * @param {string[]} args The arguments to pass to the new process. The `file`
+ *                        argument is automatically prepended to the arguments
+ *                        and passed as the first argument to the `execvp`
+ *                        system call.
+ * @param {Object} [options] Optional options.
+ * @param {string} [options.arg0=file] The value to pass as the first argument
+ *                                     to the `execvp` system call. Defaults to
+ *                                     the `file` argument.
  * @throws {Error} If the execvp system call fails.
  */
-export declare function execvp(file: string, args: string[]): void;
+export declare function execvp(file: string, args: string[], options?: ExecvpOptions): void;

package/index.d.ts

@@ -1,7 +1,18 @@
-/* tslint:disable */
-/* eslint-disable */
-
 /* auto-generated by NAPI-RS */
+/* eslint-disable */
+/**
+ * Clears the close-on-exec flag for the given file descriptor, preventing it
+ * from being closed automatically when a new process is executed with the exec
+ * family of functions.
+ *
+ * @example
+ * doNotCloseOnExit(process.stdout.fd);
+ *
+ * @param {number} file The file descriptor to close (e.g. `process.stdout.fd`).
+ * @returns {undefined}
+ * @throws {Error} If the fcntl system call fails.
+ */
+export declare function doNotCloseOnExit(fd: number): void
 
 /**
  * Performs the execvp system call with the given file and arguments, replacing
@@ -18,26 +29,13 @@
  *
  * @example
  * import { execvp } from '@alphahydrae/exec';
- * execvp('ls', ['ls', '-l', '.']);
+ * execvp('ls', ['/bin/ls', '-l', '.']);
  *
  * @param {string} file The file to execute. If not a path, the PATH environment
  *                      variable is searched.
  * @param {string[]} args The arguments to pass to the new process. Note that
- *                        the first argument should be the name of the file
- *                        being executed.
+ *                        the first argument, by convention, should point to
+ *                        the filename associated with the file being executed.
  * @throws {Error} If the execvp system call fails.
  */
 export declare function execvp(file: string, args: Array<string>): void
-/**
- * Clears the close-on-exec flag for the given file descriptor, preventing it
- * from being closed automatically when a new process is executed with the exec
- * family of functions.
- *
- * @example
- * doNotCloseOnExit(process.stdout.fd);
- *
- * @param {number} file The file descriptor to close (e.g. `process.stdout.fd`).
- * @returns {undefined}
- * @throws {Error} If the fcntl system call fails.
- */
-export declare function doNotCloseOnExit(fd: number): void

package/index.js

@@ -1,316 +1,580 @@
-/* tslint:disable */
+// prettier-ignore
 /* eslint-disable */
-/* prettier-ignore */
-
+// @ts-nocheck
 /* auto-generated by NAPI-RS */
 
-const { existsSync, readFileSync } = require('fs')
-const { join } = require('path')
+const { readFileSync } = require('node:fs')
+let nativeBinding = null
+const loadErrors = []
 
-const { platform, arch } = process
+const isMusl = () => {
+  let musl = false
+  if (process.platform === 'linux') {
+    musl = isMuslFromFilesystem()
+    if (musl === null) {
+      musl = isMuslFromReport()
+    }
+    if (musl === null) {
+      musl = isMuslFromChildProcess()
+    }
+  }
+  return musl
+}
 
-let nativeBinding = null
-let localFileExisted = false
-let loadError = null
+const isFileMusl = (f) => f.includes('libc.musl-') || f.includes('ld-musl-')
 
-function isMusl() {
-  // For Node 10
-  if (!process.report || typeof process.report.getReport !== 'function') {
-    try {
-      const lddPath = require('child_process').execSync('which ldd').toString().trim()
-      return readFileSync(lddPath, 'utf8').includes('musl')
-    } catch (e) {
+const isMuslFromFilesystem = () => {
+  try {
+    return readFileSync('/usr/bin/ldd', 'utf-8').includes('musl')
+  } catch {
+    return null
+  }
+}
+
+const isMuslFromReport = () => {
+  let report = null
+  if (typeof process.report?.getReport === 'function') {
+    process.report.excludeNetwork = true
+    report = process.report.getReport()
+  }
+  if (!report) {
+    return null
+  }
+  if (report.header && report.header.glibcVersionRuntime) {
+    return false
+  }
+  if (Array.isArray(report.sharedObjects)) {
+    if (report.sharedObjects.some(isFileMusl)) {
       return true
     }
-  } else {
-    const { glibcVersionRuntime } = process.report.getReport().header
-    return !glibcVersionRuntime
   }
+  return false
 }
 
-switch (platform) {
-  case 'android':
-    switch (arch) {
-      case 'arm64':
-        localFileExisted = existsSync(join(__dirname, 'exec.android-arm64.node'))
+const isMuslFromChildProcess = () => {
+  try {
+    return require('child_process').execSync('ldd --version', { encoding: 'utf8' }).includes('musl')
+  } catch (e) {
+    // If we reach this case, we don't know if the system is musl or not, so is better to just fallback to false
+    return false
+  }
+}
+
+function requireNative() {
+  if (process.env.NAPI_RS_NATIVE_LIBRARY_PATH) {
+    try {
+      return require(process.env.NAPI_RS_NATIVE_LIBRARY_PATH);
+    } catch (err) {
+      loadErrors.push(err)
+    }
+  } else if (process.platform === 'android') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./exec.android-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@alphahydrae/exec-android-arm64')
+        const bindingPackageVersion = require('@alphahydrae/exec-android-arm64/package.json').version
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./exec.android-arm-eabi.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@alphahydrae/exec-android-arm-eabi')
+        const bindingPackageVersion = require('@alphahydrae/exec-android-arm-eabi/package.json').version
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Android ${process.arch}`))
+    }
+  } else if (process.platform === 'win32') {
+    if (process.arch === 'x64') {
+      if (process.config?.variables?.shlib_suffix === 'dll.a' || process.config?.variables?.node_target_type === 'shared_library') {
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./exec.android-arm64.node')
-          } else {
-            nativeBinding = require('@alphahydrae/exec-android-arm64')
-          }
+        return require('./exec.win32-x64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@alphahydrae/exec-win32-x64-gnu')
+        const bindingPackageVersion = require('@alphahydrae/exec-win32-x64-gnu/package.json').version
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      } else {
+        try {
+        return require('./exec.win32-x64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@alphahydrae/exec-win32-x64-msvc')
+        const bindingPackageVersion = require('@alphahydrae/exec-win32-x64-msvc/package.json').version
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      }
+    } else if (process.arch === 'ia32') {
+      try {
+        return require('./exec.win32-ia32-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@alphahydrae/exec-win32-ia32-msvc')
+        const bindingPackageVersion = require('@alphahydrae/exec-win32-ia32-msvc/package.json').version
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./exec.win32-arm64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@alphahydrae/exec-win32-arm64-msvc')
+        const bindingPackageVersion = require('@alphahydrae/exec-win32-arm64-msvc/package.json').version
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Windows: ${process.arch}`))
+    }
+  } else if (process.platform === 'darwin') {
+    try {
+      return require('./exec.darwin-universal.node')
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    try {
+      const binding = require('@alphahydrae/exec-darwin-universal')
+      const bindingPackageVersion = require('@alphahydrae/exec-darwin-universal/package.json').version
+      if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      }
+      return binding
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    if (process.arch === 'x64') {
+      try {
+        return require('./exec.darwin-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@alphahydrae/exec-darwin-x64')
+        const bindingPackageVersion = require('@alphahydrae/exec-darwin-x64/package.json').version
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./exec.darwin-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@alphahydrae/exec-darwin-arm64')
+        const bindingPackageVersion = require('@alphahydrae/exec-darwin-arm64/package.json').version
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on macOS: ${process.arch}`))
+    }
+  } else if (process.platform === 'freebsd') {
+    if (process.arch === 'x64') {
+      try {
+        return require('./exec.freebsd-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@alphahydrae/exec-freebsd-x64')
+        const bindingPackageVersion = require('@alphahydrae/exec-freebsd-x64/package.json').version
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm64') {
+      try {
+        return require('./exec.freebsd-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@alphahydrae/exec-freebsd-arm64')
+        const bindingPackageVersion = require('@alphahydrae/exec-freebsd-arm64/package.json').version
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on FreeBSD: ${process.arch}`))
+    }
+  } else if (process.platform === 'linux') {
+    if (process.arch === 'x64') {
+      if (isMusl()) {
+        try {
+          return require('./exec.linux-x64-musl.node')
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
         }
-        break
-      case 'arm':
-        localFileExisted = existsSync(join(__dirname, 'exec.android-arm-eabi.node'))
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./exec.android-arm-eabi.node')
-          } else {
-            nativeBinding = require('@alphahydrae/exec-android-arm-eabi')
+          const binding = require('@alphahydrae/exec-linux-x64-musl')
+          const bindingPackageVersion = require('@alphahydrae/exec-linux-x64-musl/package.json').version
+          if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
         }
-        break
-      default:
-        throw new Error(`Unsupported architecture on Android ${arch}`)
-    }
-    break
-  case 'win32':
-    switch (arch) {
-      case 'x64':
-        localFileExisted = existsSync(
-          join(__dirname, 'exec.win32-x64-msvc.node')
-        )
+      } else {
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./exec.win32-x64-msvc.node')
-          } else {
-            nativeBinding = require('@alphahydrae/exec-win32-x64-msvc')
-          }
+          return require('./exec.linux-x64-gnu.node')
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
         }
-        break
-      case 'ia32':
-        localFileExisted = existsSync(
-          join(__dirname, 'exec.win32-ia32-msvc.node')
-        )
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./exec.win32-ia32-msvc.node')
-          } else {
-            nativeBinding = require('@alphahydrae/exec-win32-ia32-msvc')
+          const binding = require('@alphahydrae/exec-linux-x64-gnu')
+          const bindingPackageVersion = require('@alphahydrae/exec-linux-x64-gnu/package.json').version
+          if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
         }
-        break
-      case 'arm64':
-        localFileExisted = existsSync(
-          join(__dirname, 'exec.win32-arm64-msvc.node')
-        )
+      }
+    } else if (process.arch === 'arm64') {
+      if (isMusl()) {
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./exec.win32-arm64-msvc.node')
-          } else {
-            nativeBinding = require('@alphahydrae/exec-win32-arm64-msvc')
+          return require('./exec.linux-arm64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@alphahydrae/exec-linux-arm64-musl')
+          const bindingPackageVersion = require('@alphahydrae/exec-linux-arm64-musl/package.json').version
+          if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
         }
-        break
-      default:
-        throw new Error(`Unsupported architecture on Windows: ${arch}`)
-    }
-    break
-  case 'darwin':
-    localFileExisted = existsSync(join(__dirname, 'exec.darwin-universal.node'))
-    try {
-      if (localFileExisted) {
-        nativeBinding = require('./exec.darwin-universal.node')
       } else {
-        nativeBinding = require('@alphahydrae/exec-darwin-universal')
-      }
-      break
-    } catch {}
-    switch (arch) {
-      case 'x64':
-        localFileExisted = existsSync(join(__dirname, 'exec.darwin-x64.node'))
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./exec.darwin-x64.node')
-          } else {
-            nativeBinding = require('@alphahydrae/exec-darwin-x64')
-          }
+          return require('./exec.linux-arm64-gnu.node')
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
         }
-        break
-      case 'arm64':
-        localFileExisted = existsSync(
-          join(__dirname, 'exec.darwin-arm64.node')
-        )
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./exec.darwin-arm64.node')
-          } else {
-            nativeBinding = require('@alphahydrae/exec-darwin-arm64')
+          const binding = require('@alphahydrae/exec-linux-arm64-gnu')
+          const bindingPackageVersion = require('@alphahydrae/exec-linux-arm64-gnu/package.json').version
+          if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
         }
-        break
-      default:
-        throw new Error(`Unsupported architecture on macOS: ${arch}`)
-    }
-    break
-  case 'freebsd':
-    if (arch !== 'x64') {
-      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
-    }
-    localFileExisted = existsSync(join(__dirname, 'exec.freebsd-x64.node'))
-    try {
-      if (localFileExisted) {
-        nativeBinding = require('./exec.freebsd-x64.node')
-      } else {
-        nativeBinding = require('@alphahydrae/exec-freebsd-x64')
       }
-    } catch (e) {
-      loadError = e
-    }
-    break
-  case 'linux':
-    switch (arch) {
-      case 'x64':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'exec.linux-x64-musl.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./exec.linux-x64-musl.node')
-            } else {
-              nativeBinding = require('@alphahydrae/exec-linux-x64-musl')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'exec.linux-x64-gnu.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./exec.linux-x64-gnu.node')
-            } else {
-              nativeBinding = require('@alphahydrae/exec-linux-x64-gnu')
-            }
-          } catch (e) {
-            loadError = e
-          }
+    } else if (process.arch === 'arm') {
+      if (isMusl()) {
+        try {
+          return require('./exec.linux-arm-musleabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
         }
-        break
-      case 'arm64':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'exec.linux-arm64-musl.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./exec.linux-arm64-musl.node')
-            } else {
-              nativeBinding = require('@alphahydrae/exec-linux-arm64-musl')
-            }
-          } catch (e) {
-            loadError = e
-          }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'exec.linux-arm64-gnu.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./exec.linux-arm64-gnu.node')
-            } else {
-              nativeBinding = require('@alphahydrae/exec-linux-arm64-gnu')
-            }
-          } catch (e) {
-            loadError = e
+        try {
+          const binding = require('@alphahydrae/exec-linux-arm-musleabihf')
+          const bindingPackageVersion = require('@alphahydrae/exec-linux-arm-musleabihf/package.json').version
+          if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./exec.linux-arm-gnueabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
         }
-        break
-      case 'arm':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'exec.linux-arm-musleabihf.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./exec.linux-arm-musleabihf.node')
-            } else {
-              nativeBinding = require('@alphahydrae/exec-linux-arm-musleabihf')
-            }
-          } catch (e) {
-            loadError = e
+        try {
+          const binding = require('@alphahydrae/exec-linux-arm-gnueabihf')
+          const bindingPackageVersion = require('@alphahydrae/exec-linux-arm-gnueabihf/package.json').version
+          if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'exec.linux-arm-gnueabihf.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./exec.linux-arm-gnueabihf.node')
-            } else {
-              nativeBinding = require('@alphahydrae/exec-linux-arm-gnueabihf')
-            }
-          } catch (e) {
-            loadError = e
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'loong64') {
+      if (isMusl()) {
+        try {
+          return require('./exec.linux-loong64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@alphahydrae/exec-linux-loong64-musl')
+          const bindingPackageVersion = require('@alphahydrae/exec-linux-loong64-musl/package.json').version
+          if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
         }
-        break
-      case 'riscv64':
-        if (isMusl()) {
-          localFileExisted = existsSync(
-            join(__dirname, 'exec.linux-riscv64-musl.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./exec.linux-riscv64-musl.node')
-            } else {
-              nativeBinding = require('@alphahydrae/exec-linux-riscv64-musl')
-            }
-          } catch (e) {
-            loadError = e
+      } else {
+        try {
+          return require('./exec.linux-loong64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@alphahydrae/exec-linux-loong64-gnu')
+          const bindingPackageVersion = require('@alphahydrae/exec-linux-loong64-gnu/package.json').version
+          if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
-        } else {
-          localFileExisted = existsSync(
-            join(__dirname, 'exec.linux-riscv64-gnu.node')
-          )
-          try {
-            if (localFileExisted) {
-              nativeBinding = require('./exec.linux-riscv64-gnu.node')
-            } else {
-              nativeBinding = require('@alphahydrae/exec-linux-riscv64-gnu')
-            }
-          } catch (e) {
-            loadError = e
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'riscv64') {
+      if (isMusl()) {
+        try {
+          return require('./exec.linux-riscv64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@alphahydrae/exec-linux-riscv64-musl')
+          const bindingPackageVersion = require('@alphahydrae/exec-linux-riscv64-musl/package.json').version
+          if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./exec.linux-riscv64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
         }
-        break
-      case 's390x':
-        localFileExisted = existsSync(
-          join(__dirname, 'exec.linux-s390x-gnu.node')
-        )
         try {
-          if (localFileExisted) {
-            nativeBinding = require('./exec.linux-s390x-gnu.node')
-          } else {
-            nativeBinding = require('@alphahydrae/exec-linux-s390x-gnu')
+          const binding = require('@alphahydrae/exec-linux-riscv64-gnu')
+          const bindingPackageVersion = require('@alphahydrae/exec-linux-riscv64-gnu/package.json').version
+          if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
+          return binding
         } catch (e) {
-          loadError = e
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'ppc64') {
+      try {
+        return require('./exec.linux-ppc64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@alphahydrae/exec-linux-ppc64-gnu')
+        const bindingPackageVersion = require('@alphahydrae/exec-linux-ppc64-gnu/package.json').version
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
-        break
-      default:
-        throw new Error(`Unsupported architecture on Linux: ${arch}`)
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 's390x') {
+      try {
+        return require('./exec.linux-s390x-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@alphahydrae/exec-linux-s390x-gnu')
+        const bindingPackageVersion = require('@alphahydrae/exec-linux-s390x-gnu/package.json').version
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on Linux: ${process.arch}`))
     }
-    break
-  default:
-    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
+  } else if (process.platform === 'openharmony') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./exec.openharmony-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@alphahydrae/exec-openharmony-arm64')
+        const bindingPackageVersion = require('@alphahydrae/exec-openharmony-arm64/package.json').version
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'x64') {
+      try {
+        return require('./exec.openharmony-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@alphahydrae/exec-openharmony-x64')
+        const bindingPackageVersion = require('@alphahydrae/exec-openharmony-x64/package.json').version
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 'arm') {
+      try {
+        return require('./exec.openharmony-arm.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@alphahydrae/exec-openharmony-arm')
+        const bindingPackageVersion = require('@alphahydrae/exec-openharmony-arm/package.json').version
+        if (bindingPackageVersion !== '2.0.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 2.0.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else {
+      loadErrors.push(new Error(`Unsupported architecture on OpenHarmony: ${process.arch}`))
+    }
+  } else {
+    loadErrors.push(new Error(`Unsupported OS: ${process.platform}, architecture: ${process.arch}`))
+  }
+}
+
+nativeBinding = requireNative()
+
+if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+  let wasiBinding = null
+  let wasiBindingError = null
+  try {
+    wasiBinding = require('./exec.wasi.cjs')
+    nativeBinding = wasiBinding
+  } catch (err) {
+    if (process.env.NAPI_RS_FORCE_WASI) {
+      wasiBindingError = err
+    }
+  }
+  if (!nativeBinding || process.env.NAPI_RS_FORCE_WASI) {
+    try {
+      wasiBinding = require('@alphahydrae/exec-wasm32-wasi')
+      nativeBinding = wasiBinding
+    } catch (err) {
+      if (process.env.NAPI_RS_FORCE_WASI) {
+        if (!wasiBindingError) {
+          wasiBindingError = err
+        } else {
+          wasiBindingError.cause = err
+        }
+        loadErrors.push(err)
+      }
+    }
+  }
+  if (process.env.NAPI_RS_FORCE_WASI === 'error' && !wasiBinding) {
+    const error = new Error('WASI binding not found and NAPI_RS_FORCE_WASI is set to error')
+    error.cause = wasiBindingError
+    throw error
+  }
 }
 
 if (!nativeBinding) {
-  if (loadError) {
-    throw loadError
+  if (loadErrors.length > 0) {
+    throw new Error(
+      `Cannot find native binding. ` +
+        `npm has a bug related to optional dependencies (https://github.com/npm/cli/issues/4828). ` +
+        'Please try `npm i` again after removing both package-lock.json and node_modules directory.',
+      {
+        cause: loadErrors.reduce((err, cur) => {
+          cur.cause = err
+          return cur
+        }),
+      },
+    )
   }
   throw new Error(`Failed to load native binding`)
 }
 
-const { execvp, doNotCloseOnExit } = nativeBinding
-
-module.exports.execvp = execvp
-module.exports.doNotCloseOnExit = doNotCloseOnExit
+module.exports = nativeBinding
+module.exports.doNotCloseOnExit = nativeBinding.doNotCloseOnExit
+module.exports.execvp = nativeBinding.execvp

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alphahydrae/exec",
-  "version": "1.1.0",
+  "version": "3.0.0",
   "description": "The execvp function for Node.js",
   "main": "exec.js",
   "repository": {
@@ -20,27 +20,25 @@
     "index.js"
   ],
   "napi": {
-    "name": "exec",
-    "triples": {
-      "defaults": false,
-      "additional": [
-        "x86_64-apple-darwin",
-        "x86_64-unknown-linux-gnu",
-        "x86_64-unknown-linux-musl",
-        "aarch64-apple-darwin",
-        "aarch64-unknown-linux-gnu",
-        "aarch64-unknown-linux-musl"
-      ]
-    }
+    "binaryName": "exec",
+    "targets": [
+      "x86_64-apple-darwin",
+      "x86_64-unknown-linux-gnu",
+      "x86_64-unknown-linux-musl",
+      "aarch64-apple-darwin",
+      "aarch64-unknown-linux-gnu",
+      "aarch64-unknown-linux-musl"
+    ]
   },
   "scripts": {
     "artifacts": "napi artifacts",
     "build": "napi build --platform --release",
     "build:debug": "napi build --platform",
     "build:package": "node scripts/build-packages.mjs",
-    "check": "npm run lint && npm run format",
-    "check:write": "npm run lint && npm run format:write",
+    "check": "npm test && npm run lint && npm run format",
+    "check:write": "npm test && npm run lint && npm run format:write",
     "doctoc": "doctoc --github --notitle README.md && prettier --write README.md",
+    "docs": "jsdoc --destination docs --readme README.md exec.js",
     "format": "npm run format:cargo && npm run format:prettier",
     "format:cargo": "cargo fmt --check",
     "format:cargo:write": "cargo fmt",
@@ -53,25 +51,26 @@
     "version": "napi version && npm run build:package && prettier --write ./npm/*/package.json"
   },
   "devDependencies": {
-    "@napi-rs/cli": "^2.18.4",
+    "@napi-rs/cli": "^3.6.2",
     "@swc-node/register": "^1.10.6",
     "@swc/core": "^1.10.12",
     "chalk": "^5.3.0",
     "doctoc": "^2.2.1",
-    "jest": "^29.7.0",
-    "npm-run-all2": "^7.0.0",
+    "jest": "^30.4.2",
+    "jsdoc": "^4.0.4",
+    "npm-run-all2": "^9.0.0",
     "prettier": "^3.4.2",
-    "typescript": "^5.5.3"
+    "typescript": "^6.0.3"
   },
   "engines": {
-    "node": "^18 || ^20 || ^22"
+    "node": "^22 || ^24 || ^26"
   },
   "optionalDependencies": {
-    "@alphahydrae/exec-darwin-x64": "1.1.0",
-    "@alphahydrae/exec-linux-x64-gnu": "1.1.0",
-    "@alphahydrae/exec-linux-x64-musl": "1.1.0",
-    "@alphahydrae/exec-darwin-arm64": "1.1.0",
-    "@alphahydrae/exec-linux-arm64-gnu": "1.1.0",
-    "@alphahydrae/exec-linux-arm64-musl": "1.1.0"
+    "@alphahydrae/exec-darwin-x64": "3.0.0",
+    "@alphahydrae/exec-linux-x64-gnu": "3.0.0",
+    "@alphahydrae/exec-linux-x64-musl": "3.0.0",
+    "@alphahydrae/exec-darwin-arm64": "3.0.0",
+    "@alphahydrae/exec-linux-arm64-gnu": "3.0.0",
+    "@alphahydrae/exec-linux-arm64-musl": "3.0.0"
   }
 }