@smarlhens/npm-check-engines 1.0.0 → 1.2.0

package/LICENSE.md

@@ -0,0 +1,55 @@
+# Blue Oak Model License
+
+Version 1.0.0
+
+## Purpose
+
+This license gives everyone as much permission to work with
+this software as possible, while protecting contributors
+from liability.
+
+## Acceptance
+
+In order to receive this license, you must agree to its
+rules. The rules of this license are both obligations
+under that agreement and conditions to your license.
+You must not do anything with this software that triggers
+a rule that you cannot or will not follow.
+
+## Copyright
+
+Each contributor licenses you to do everything with this
+software that would otherwise infringe that contributor's
+copyright in it.
+
+## Notices
+
+You must ensure that everyone who gets a copy of
+any part of this software from you, with or without
+changes, also gets the text of this license or a link to
+<https://blueoakcouncil.org/license/1.0.0>.
+
+## Excuse
+
+If anyone notifies you in writing that you have not
+complied with [Notices](#notices), you can keep your
+license by taking all practical steps to comply within 30
+days after the notice. If you do not do so, your license
+ends immediately.
+
+## Patent
+
+Each contributor licenses you to do everything with this
+software that would otherwise infringe any patent claims
+they can license or become able to license.
+
+## Reliability
+
+No contributor can revoke this license.
+
+## No Liability
+
+**_As far as the law allows, this software comes as is,
+without any warranty or condition, and no contributor
+will be liable to anyone for any damages related to this
+software or this license, under any kind of legal claim._**

package/README.md

@@ -0,0 +1,265 @@
+# NPM check engines
+
+[![CI](https://github.com/smarlhens/riri-node-tools/actions/workflows/ci.yml/badge.svg)](https://github.com/smarlhens/riri-node-tools/actions/workflows/ci.yml)
+[![napi-nce](https://github.com/smarlhens/riri-node-tools/actions/workflows/napi-nce.yml/badge.svg)](https://github.com/smarlhens/riri-node-tools/actions/workflows/napi-nce.yml)
+![node-current (scoped)](https://img.shields.io/node/v/@smarlhens/npm-check-engines)
+[![license](https://img.shields.io/github/license/smarlhens/riri-node-tools)](https://github.com/smarlhens/riri-node-tools/blob/main/LICENSE.md)
+[![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg)](https://conventionalcommits.org)
+
+**npm-check-engines upgrades your package.json node engines constraint to the most restrictive used by your dependencies.**
+
+This package ships a native Rust core via [NAPI-RS](https://napi.rs/) as part of the [riri-node-tools](https://github.com/smarlhens/riri-node-tools) monorepo.
+
+---
+
+## Table of Contents
+
+- [Prerequisites](#prerequisites)
+- [Installation](#installation)
+- [Usage](#usage)
+  - [CLI](#cli)
+  - [Node API](#node-api)
+- [CLI Options](#cli-options)
+- [Debug](#debug)
+- [Thanks](#thanks)
+
+---
+
+## Prerequisites
+
+- [Node.js](https://nodejs.org/en/download/) **version `^22.13.0 || ^24.0.0 || ^25.0.0 || >=26.0.0`**
+
+Supported platforms:
+
+| OS      | Arch                                 |
+| ------- | ------------------------------------ |
+| Linux   | x64 (glibc/musl), arm64 (glibc/musl) |
+| macOS   | x64, arm64                           |
+| Windows | x64                                  |
+
+---
+
+## Installation
+
+Install globally:
+
+```sh
+npm install -g @smarlhens/npm-check-engines
+```
+
+Or run with [npx](https://docs.npmjs.com/cli/v8/commands/npx):
+
+```sh
+npx @smarlhens/npm-check-engines
+```
+
+---
+
+## Usage
+
+### CLI
+
+Compute the most restrictive `engines.node` constraint for the project in the current directory based on the lockfile (`package-lock.json`, `yarn.lock`, or `pnpm-lock.yaml`):
+
+```sh
+nce
+```
+
+Sample output (against `fixtures/nce-policy-supported-eol-bump`):
+
+```text
+    node  >=18.0.0  →  ^22.0.0 || ^24.0.0 || ^25.0.0 || >=26.0.0
+    npm   *         →  >=10.5.1
+
+  Run nce -u to upgrade package.json.
+```
+
+Update `package.json` (and lockfile, when relevant) with the computed ranges:
+
+```sh
+nce -u
+```
+
+Emit machine-readable JSON:
+
+```sh
+nce --json
+```
+
+### Node API
+
+```typescript
+import { checkEngines } from '@smarlhens/npm-check-engines';
+
+const packageJson = '...'; // stringified package.json
+const lockfileContent = '...'; // stringified lockfile
+
+const { computedEngines, changes } = checkEngines({
+  packageJson,
+  lockfileContent,
+  lockfileType: 'npm', // optional: 'npm' | 'yarn' | 'pnpm' — auto-detected when omitted
+  filterEngines: ['node'], // optional: restrict which engines to compute
+  precision: 'patch', // optional: 'major' | 'minor' | 'patch'
+});
+
+console.log(computedEngines); // { node: '^20.17.0 || ^22.13.0 || >=23.5.0', ... }
+for (const { engine, from, to } of changes) {
+  console.log(`${engine}: "${from}" → "${to}"`);
+}
+```
+
+Additional helpers exported by the package:
+
+```typescript
+import {
+  humanizeRange,
+  intersects,
+  isSubsetOf,
+  restrictiveRange,
+  satisfies,
+  runCli,
+} from '@smarlhens/npm-check-engines';
+```
+
+- `humanizeRange(input, precision?)` — trim trailing zero components per precision rule
+- `intersects(a, b)` — do two ranges overlap
+- `isSubsetOf(a, b)` — is `a` fully contained in `b`
+- `restrictiveRange(a, b)` — return the most restrictive of two ranges
+- `satisfies(range, version)` — does a concrete version satisfy a range
+- `runCli(argv)` — run the `nce` CLI in-process; `argv[0]` must be the program name. Returns exit code.
+
+---
+
+## CLI Options
+
+```text
+Check and update Node.js engine constraints in package.json based on the dependency tree from the lockfile
+
+Usage: nce [OPTIONS]
+
+Options:
+  -q, --quiet
+          Silent mode — no output
+
+  -v, --verbose
+          Verbose output
+
+  -d, --debug
+          Debug mode — detailed logging
+
+  -e, --engines <ENGINES>
+          Engine keys to check (e.g. node, npm, yarn). Defaults to all
+
+  -u, --update
+          Update package.json (and lockfile) with computed ranges
+
+      --enable-engine-strict
+          Create or update .npmrc with engine-strict=true
+
+      --json
+          Output results as JSON
+
+      --sort
+          Sort package.json keys (sort-package-json conventions); writes the file even without --update or pending changes
+
+      --precision <PRECISION>
+          Version precision in output: major (e.g. >=24), minor (e.g. >=24.0), or patch (e.g. >=24.0.0). Trailing .0 components are trimmed accordingly. Non-zero components are never dropped
+
+          Possible values:
+          - major: Trim all trailing .0 (minimum 1 component)
+          - minor: Trim trailing .0 patch only (minimum 2 components)
+          - patch: Always show major.minor.patch
+
+          [default: patch]
+
+      --node-policy <NODE_POLICY>
+          Node.js lifecycle policy gate for engines.node
+
+          [default: supported]
+          [possible values: any, stable, supported, lts, maintenance]
+
+      --allow-eol
+          Suppress EOL warnings (does not widen the policy)
+
+      --bump-npm
+          Bump engines.npm floor to match the lowest node major in range
+
+      --no-bump-npm
+          Disable the npm coupling pass
+
+      --npm-precision <NPM_PRECISION>
+          Precision applied to the npm bump floor
+
+          Possible values:
+          - major: Trim all trailing .0 (minimum 1 component)
+          - minor: Trim trailing .0 patch only (minimum 2 components)
+          - patch: Always show major.minor.patch
+
+          [default: major]
+
+      --refresh
+          Fetch fresh lifecycle data from upstream and update the user cache. Continues with the rest of the run after writing the cache
+
+  -h, --help
+          Print help (see a summary with '-h')
+
+  -V, --version
+          Print version
+```
+
+---
+
+## Debug
+
+```sh
+nce -d
+```
+
+The `-d/--debug` flag enables detailed logging to stderr. No environment variable is required.
+
+<details>
+<summary>Sample debug output (against <code>fixtures/nce-policy-supported-eol-bump</code>)</summary>
+
+```text
+  ▸ Detecting lockfile......
+  ✓ Detected package-lock.json
+  ▸ Reading package.json......
+  ✓ Read package.json
+  ▸ Parsing lockfile......
+  ✓ Parsed lockfile
+  ▸ Computing engine constraints......
+    Compare: * and >=18.0.0 engine=node package=<root>
+    New most restrictive range: >=18.0.0 engine=node
+    Final computed engine range constraint: >=18.0.0 engine=node
+    Compare: * and >=18.0.0 engine=node package=<root>
+    New most restrictive range: >=18.0.0 engine=node
+    Final computed engine range constraint: >=18.0.0 engine=node
+    Package has no engines engine=npm package=<root>
+    Final computed engine range constraint: * engine=npm
+    Package has no engines engine=npm package=<root>
+    Final computed engine range constraint: * engine=npm
+    Package has no engines engine=yarn package=<root>
+    Final computed engine range constraint: * engine=yarn
+    Package has no engines engine=yarn package=<root>
+    Final computed engine range constraint: * engine=yarn
+    Rewriting node range under policy gate: >=18.0.0 policy=Supported
+    Bumped disjunct: >=18.0.0 → ^22.0.0 || ^24.0.0 || ^25.0.0 || >=26.0.0
+    Rewritten node range: ^22.0.0 || ^24.0.0 || ^25.0.0 || >=26.0.0
+    npm floor derived from node range: target 10.5.1 (declared: Some("*")) apply=true
+    Bumping engines.npm floor to: >=10.5.1
+  ✓ Computed engine constraints
+    node  >=18.0.0  →  ^22.0.0 || ^24.0.0 || ^25.0.0 || >=26.0.0
+    npm   *         →  >=10.5.1
+
+  Run nce -d -u to upgrade package.json.
+```
+
+</details>
+
+---
+
+## Thanks
+
+Originally inspired by [npm-check-updates](https://github.com/raineorshine/npm-check-updates).
+
+---

package/index.d.ts

@@ -0,0 +1,38 @@
+/* auto-generated by NAPI-RS */
+/* eslint-disable */
+export declare function checkEngines(options: CheckEnginesOptions): CheckEnginesResult
+
+export interface CheckEnginesOptions {
+  packageJson: string
+  lockfileContent: string
+  lockfileType?: string
+  filterEngines?: Array<string>
+  precision?: string
+}
+
+export interface CheckEnginesResult {
+  computedEngines: Record<string, string>
+  changes: Array<EngineChange>
+}
+
+export interface EngineChange {
+  engine: string
+  from: string
+  to: string
+}
+
+export declare function humanizeRange(input: string, precision?: string | undefined | null): string
+
+export declare function intersects(range1: string, range2: string): boolean
+
+export declare function isSubsetOf(range1: string, range2: string): boolean
+
+export declare function restrictiveRange(range1: string, range2: string): string
+
+/**
+ * Run the `nce` CLI in-process. `argv` must include the program name at
+ * index 0 (e.g. `["nce", "--json"]`). Returns the exit code.
+ */
+export declare function runCli(argv: Array<string>): number
+
+export declare function satisfies(range: string, version: string): boolean

package/index.js

@@ -0,0 +1,585 @@
+// prettier-ignore
+/* eslint-disable */
+// @ts-nocheck
+/* auto-generated by NAPI-RS */
+
+const { readFileSync } = require('node:fs')
+let nativeBinding = null
+const loadErrors = []
+
+const isMusl = () => {
+  let musl = false
+  if (process.platform === 'linux') {
+    musl = isMuslFromFilesystem()
+    if (musl === null) {
+      musl = isMuslFromReport()
+    }
+    if (musl === null) {
+      musl = isMuslFromChildProcess()
+    }
+  }
+  return musl
+}
+
+const isFileMusl = (f) => f.includes('libc.musl-') || f.includes('ld-musl-')
+
+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
+    }
+  }
+  return false
+}
+
+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('./npm-check-engines.android-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@smarlhens/npm-check-engines-android-arm64')
+        const bindingPackageVersion = require('@smarlhens/npm-check-engines-android-arm64/package.json').version
+        if (bindingPackageVersion !== '1.2.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 1.2.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('./npm-check-engines.android-arm-eabi.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@smarlhens/npm-check-engines-android-arm-eabi')
+        const bindingPackageVersion = require('@smarlhens/npm-check-engines-android-arm-eabi/package.json').version
+        if (bindingPackageVersion !== '1.2.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 1.2.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 {
+        return require('./npm-check-engines.win32-x64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@smarlhens/npm-check-engines-win32-x64-gnu')
+        const bindingPackageVersion = require('@smarlhens/npm-check-engines-win32-x64-gnu/package.json').version
+        if (bindingPackageVersion !== '1.2.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 1.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      } else {
+        try {
+        return require('./npm-check-engines.win32-x64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@smarlhens/npm-check-engines-win32-x64-msvc')
+        const bindingPackageVersion = require('@smarlhens/npm-check-engines-win32-x64-msvc/package.json').version
+        if (bindingPackageVersion !== '1.2.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 1.2.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('./npm-check-engines.win32-ia32-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@smarlhens/npm-check-engines-win32-ia32-msvc')
+        const bindingPackageVersion = require('@smarlhens/npm-check-engines-win32-ia32-msvc/package.json').version
+        if (bindingPackageVersion !== '1.2.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 1.2.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('./npm-check-engines.win32-arm64-msvc.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@smarlhens/npm-check-engines-win32-arm64-msvc')
+        const bindingPackageVersion = require('@smarlhens/npm-check-engines-win32-arm64-msvc/package.json').version
+        if (bindingPackageVersion !== '1.2.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 1.2.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('./npm-check-engines.darwin-universal.node')
+    } catch (e) {
+      loadErrors.push(e)
+    }
+    try {
+      const binding = require('@smarlhens/npm-check-engines-darwin-universal')
+      const bindingPackageVersion = require('@smarlhens/npm-check-engines-darwin-universal/package.json').version
+      if (bindingPackageVersion !== '1.2.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 1.2.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('./npm-check-engines.darwin-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@smarlhens/npm-check-engines-darwin-x64')
+        const bindingPackageVersion = require('@smarlhens/npm-check-engines-darwin-x64/package.json').version
+        if (bindingPackageVersion !== '1.2.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 1.2.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('./npm-check-engines.darwin-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@smarlhens/npm-check-engines-darwin-arm64')
+        const bindingPackageVersion = require('@smarlhens/npm-check-engines-darwin-arm64/package.json').version
+        if (bindingPackageVersion !== '1.2.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 1.2.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('./npm-check-engines.freebsd-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@smarlhens/npm-check-engines-freebsd-x64')
+        const bindingPackageVersion = require('@smarlhens/npm-check-engines-freebsd-x64/package.json').version
+        if (bindingPackageVersion !== '1.2.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 1.2.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('./npm-check-engines.freebsd-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@smarlhens/npm-check-engines-freebsd-arm64')
+        const bindingPackageVersion = require('@smarlhens/npm-check-engines-freebsd-arm64/package.json').version
+        if (bindingPackageVersion !== '1.2.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 1.2.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('./npm-check-engines.linux-x64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@smarlhens/npm-check-engines-linux-x64-musl')
+          const bindingPackageVersion = require('@smarlhens/npm-check-engines-linux-x64-musl/package.json').version
+          if (bindingPackageVersion !== '1.2.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 1.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./npm-check-engines.linux-x64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@smarlhens/npm-check-engines-linux-x64-gnu')
+          const bindingPackageVersion = require('@smarlhens/npm-check-engines-linux-x64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.2.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 1.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm64') {
+      if (isMusl()) {
+        try {
+          return require('./npm-check-engines.linux-arm64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@smarlhens/npm-check-engines-linux-arm64-musl')
+          const bindingPackageVersion = require('@smarlhens/npm-check-engines-linux-arm64-musl/package.json').version
+          if (bindingPackageVersion !== '1.2.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 1.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./npm-check-engines.linux-arm64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@smarlhens/npm-check-engines-linux-arm64-gnu')
+          const bindingPackageVersion = require('@smarlhens/npm-check-engines-linux-arm64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.2.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 1.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'arm') {
+      if (isMusl()) {
+        try {
+          return require('./npm-check-engines.linux-arm-musleabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@smarlhens/npm-check-engines-linux-arm-musleabihf')
+          const bindingPackageVersion = require('@smarlhens/npm-check-engines-linux-arm-musleabihf/package.json').version
+          if (bindingPackageVersion !== '1.2.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 1.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./npm-check-engines.linux-arm-gnueabihf.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@smarlhens/npm-check-engines-linux-arm-gnueabihf')
+          const bindingPackageVersion = require('@smarlhens/npm-check-engines-linux-arm-gnueabihf/package.json').version
+          if (bindingPackageVersion !== '1.2.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 1.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'loong64') {
+      if (isMusl()) {
+        try {
+          return require('./npm-check-engines.linux-loong64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@smarlhens/npm-check-engines-linux-loong64-musl')
+          const bindingPackageVersion = require('@smarlhens/npm-check-engines-linux-loong64-musl/package.json').version
+          if (bindingPackageVersion !== '1.2.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 1.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./npm-check-engines.linux-loong64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@smarlhens/npm-check-engines-linux-loong64-gnu')
+          const bindingPackageVersion = require('@smarlhens/npm-check-engines-linux-loong64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.2.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 1.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'riscv64') {
+      if (isMusl()) {
+        try {
+          return require('./npm-check-engines.linux-riscv64-musl.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@smarlhens/npm-check-engines-linux-riscv64-musl')
+          const bindingPackageVersion = require('@smarlhens/npm-check-engines-linux-riscv64-musl/package.json').version
+          if (bindingPackageVersion !== '1.2.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 1.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      } else {
+        try {
+          return require('./npm-check-engines.linux-riscv64-gnu.node')
+        } catch (e) {
+          loadErrors.push(e)
+        }
+        try {
+          const binding = require('@smarlhens/npm-check-engines-linux-riscv64-gnu')
+          const bindingPackageVersion = require('@smarlhens/npm-check-engines-linux-riscv64-gnu/package.json').version
+          if (bindingPackageVersion !== '1.2.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 1.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
+          return binding
+        } catch (e) {
+          loadErrors.push(e)
+        }
+      }
+    } else if (process.arch === 'ppc64') {
+      try {
+        return require('./npm-check-engines.linux-ppc64-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@smarlhens/npm-check-engines-linux-ppc64-gnu')
+        const bindingPackageVersion = require('@smarlhens/npm-check-engines-linux-ppc64-gnu/package.json').version
+        if (bindingPackageVersion !== '1.2.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 1.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        }
+        return binding
+      } catch (e) {
+        loadErrors.push(e)
+      }
+    } else if (process.arch === 's390x') {
+      try {
+        return require('./npm-check-engines.linux-s390x-gnu.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@smarlhens/npm-check-engines-linux-s390x-gnu')
+        const bindingPackageVersion = require('@smarlhens/npm-check-engines-linux-s390x-gnu/package.json').version
+        if (bindingPackageVersion !== '1.2.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 1.2.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}`))
+    }
+  } else if (process.platform === 'openharmony') {
+    if (process.arch === 'arm64') {
+      try {
+        return require('./npm-check-engines.openharmony-arm64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@smarlhens/npm-check-engines-openharmony-arm64')
+        const bindingPackageVersion = require('@smarlhens/npm-check-engines-openharmony-arm64/package.json').version
+        if (bindingPackageVersion !== '1.2.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 1.2.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('./npm-check-engines.openharmony-x64.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@smarlhens/npm-check-engines-openharmony-x64')
+        const bindingPackageVersion = require('@smarlhens/npm-check-engines-openharmony-x64/package.json').version
+        if (bindingPackageVersion !== '1.2.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 1.2.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('./npm-check-engines.openharmony-arm.node')
+      } catch (e) {
+        loadErrors.push(e)
+      }
+      try {
+        const binding = require('@smarlhens/npm-check-engines-openharmony-arm')
+        const bindingPackageVersion = require('@smarlhens/npm-check-engines-openharmony-arm/package.json').version
+        if (bindingPackageVersion !== '1.2.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 1.2.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('./npm-check-engines.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('@smarlhens/npm-check-engines-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 (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`)
+}
+
+module.exports = nativeBinding
+module.exports.checkEngines = nativeBinding.checkEngines
+module.exports.humanizeRange = nativeBinding.humanizeRange
+module.exports.intersects = nativeBinding.intersects
+module.exports.isSubsetOf = nativeBinding.isSubsetOf
+module.exports.restrictiveRange = nativeBinding.restrictiveRange
+module.exports.runCli = nativeBinding.runCli
+module.exports.satisfies = nativeBinding.satisfies

package/package.json

@@ -1,7 +1,28 @@
 {
   "name": "@smarlhens/npm-check-engines",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Check and update Node.js engine constraints in package.json",
+  "keywords": [
+    "cli",
+    "engine-strict",
+    "engines",
+    "eol",
+    "lifecycle",
+    "lockfile",
+    "napi",
+    "node",
+    "node-engines",
+    "node-lts",
+    "node-version",
+    "nodejs",
+    "npm",
+    "package.json",
+    "pnpm",
+    "rust",
+    "semver",
+    "typescript",
+    "yarn"
+  ],
   "license": "BlueOak-1.0.0",
   "author": "Samuel MARLHENS <samuel.marlhens@proton.me>",
   "repository": {
@@ -27,7 +48,7 @@
     "artifacts": "napi artifacts",
     "build": "napi build --platform --release",
     "build:debug": "napi build --platform",
-    "prepublishOnly": "napi prepublish -t npm",
+    "prepublishOnly": "napi prepublish -t npm --no-gh-release",
     "version": "napi version"
   },
   "devDependencies": {
@@ -46,15 +67,16 @@
     ]
   },
   "engines": {
-    "node": "^20.17.0 || ^22.13.0 || >=23.5.0"
+    "node": "^22.13.0 || ^24.0.0 || ^25.0.0 || >=26.0.0",
+    "npm": ">=10.9.2"
   },
   "optionalDependencies": {
-    "@smarlhens/npm-check-engines-linux-x64-gnu": "1.0.0",
-    "@smarlhens/npm-check-engines-linux-x64-musl": "1.0.0",
-    "@smarlhens/npm-check-engines-linux-arm64-gnu": "1.0.0",
-    "@smarlhens/npm-check-engines-linux-arm64-musl": "1.0.0",
-    "@smarlhens/npm-check-engines-darwin-x64": "1.0.0",
-    "@smarlhens/npm-check-engines-darwin-arm64": "1.0.0",
-    "@smarlhens/npm-check-engines-win32-x64-msvc": "1.0.0"
+    "@smarlhens/npm-check-engines-linux-x64-gnu": "1.2.0",
+    "@smarlhens/npm-check-engines-linux-x64-musl": "1.2.0",
+    "@smarlhens/npm-check-engines-linux-arm64-gnu": "1.2.0",
+    "@smarlhens/npm-check-engines-linux-arm64-musl": "1.2.0",
+    "@smarlhens/npm-check-engines-darwin-x64": "1.2.0",
+    "@smarlhens/npm-check-engines-darwin-arm64": "1.2.0",
+    "@smarlhens/npm-check-engines-win32-x64-msvc": "1.2.0"
   }
 }