@napi-rs/cli 3.7.4 → 3.8.0

package/README.md

@@ -15,6 +15,11 @@ yarn add @napi-rs/cli -D
 yarn napi build
 ```
 
+## Requirements
+
+`@napi-rs/cli` supports Node.js `^20.17.0`, `^22.13.0`, and `>=23.5.0`.
+Earlier Node.js releases are no longer supported by the CLI runtime.
+
 ## Commands
 
 | Command         | desc                                                           | docs                                                |
@@ -28,6 +33,34 @@ yarn napi build
 | version         | Update version in created npm packages by `create-npm-dirs`    | [./docs/version.md](./docs/version.md)              |
 | pre-publish     | Update package.json and copy addons into per platform packages | [./docs/pre-publish.md](./docs/pre-publish.md)      |
 
+## Disposing generated WASI bindings
+
+Generated WASI bindings expose deterministic cleanup through a non-enumerable
+symbol on the binding object:
+
+```js
+const binding = require('<package>')
+const dispose = binding[Symbol.for('napi.rs.wasi.dispose')]
+
+if (dispose) {
+  await dispose()
+}
+```
+
+The symbol is present only when the loaded binding is WASI. Browser WASI
+loaders expose it on their default export. Disposal releases the instance: it
+destroys the emnapi context and then terminates the workers owned by that
+binding. Pending napi-rs runtime promises are settled or cancelled first only
+when the binary exports the `napi_prepare_wasm_env_cleanup` preparation hook
+(a planned napi-side follow-up); otherwise they may remain pending forever,
+so settle in-flight work before disposing. Concurrent calls share one
+promise, successful disposal is idempotent, and a failed cleanup phase can be
+retried by calling the same function again. Do not call addon exports after
+disposal completes.
+
+See [WASI targets and loaders](./docs/wasi.md) for threaded, threadless,
+browser, and workerd packaging behavior.
+
 ### Debug mode
 
 ```bash

package/cli.mjs

@@ -1,15 +1,12 @@
 #!/usr/bin/env node
 
-import { execSync } from 'node:child_process'
-import { resolve } from 'node:path'
-import { fileURLToPath } from 'node:url'
+import { existsSync } from 'node:fs'
 
-execSync(
-  `node --import @oxc-node/core/register ${resolve(
-    fileURLToPath(import.meta.url),
-    '../src/cli.ts',
-  )} ${process.argv.slice(2).join(' ')}`,
-  {
-    stdio: 'inherit',
-  },
-)
+const isSourceCheckout = existsSync(new URL('../Cargo.toml', import.meta.url))
+
+if (isSourceCheckout) {
+  await import('@oxc-node/core/register')
+  await import('./src/cli.ts')
+} else {
+  await import('./dist/cli.js')
+}