Prebuild install node@22.14.0 failed with N-API version undefined

[minhoryang]

Issue Summary

│ prebuild-install warn This package does not support N-API version undefined
│ prebuild-install warn install No prebuilt binaries found (target=undefined runtime=napi arch=x64 libc= platform=darwin)
│ gyp info it worked if it ends with ok
│ gyp info using node-gyp@8.4.1
│ gyp info using node@22.14.0 | darwin | x64

Steps to Reproduce

1. $ nodenv local 22.14.0
2. $ pnpm install sqlite3@5.1.7

Version

5.1.7

Node.js Version

22.14.0

How did you install the library?

darwin x64, pnpm

[Freezystem]

We also get this error on node@24.0.1 and npm@11.3.0.

npm error code 1
npm error path /home/nico/repos/api/node_modules/sqlite3
npm error command failed
npm error command sh -c prebuild-install -r napi || node-gyp rebuild
npm error prebuild-install warn This package does not support N-API version undefined
npm error (node:87726) [DEP0176] DeprecationWarning: fs.R_OK is deprecated, use fs.constants.R_OK instead
npm error (Use `node --trace-deprecation ...` to show where the warning was created)
npm error prebuild-install warn install No prebuilt binaries found (target=undefined runtime=napi arch=x64 libc= platform=linux)
npm error gyp info it worked if it ends with ok
npm error gyp info using node-gyp@8.4.1
npm error gyp info using node@24.0.1 | linux | x64
npm error (node:87747) [DEP0060] DeprecationWarning: The `util._extend` API is deprecated. Please use Object.assign() instead.
npm error (Use `node --trace-deprecation ...` to show where the warning was created)
npm error gyp info find Python using Python version 3.13.3 found at "/usr/bin/python3"
npm error gyp info spawn /usr/bin/python3
npm error gyp info spawn args [
npm error gyp info spawn args   '/home/nico/repos/api/node_modules/node-gyp/gyp/gyp_main.py',
npm error gyp info spawn args   'binding.gyp',
npm error gyp info spawn args   '-f',
npm error gyp info spawn args   'make',
npm error gyp info spawn args   '-I',
npm error gyp info spawn args   '/home/nico/repos/api/node_modules/sqlite3/build/config.gypi',
npm error gyp info spawn args   '-I',
npm error gyp info spawn args   '/home/nico/repos/api/node_modules/node-gyp/addon.gypi',
npm error gyp info spawn args   '-I',
npm error gyp info spawn args   '/home/nico/.cache/node-gyp/24.0.1/include/node/common.gypi',
npm error gyp info spawn args   '-Dlibrary=shared_library',
npm error gyp info spawn args   '-Dvisibility=default',
npm error gyp info spawn args   '-Dnode_root_dir=/home/nico/.cache/node-gyp/24.0.1',
npm error gyp info spawn args   '-Dnode_gyp_dir=/home/nico/repos/api/node_modules/node-gyp',
npm error gyp info spawn args   '-Dnode_lib_file=/home/nico/.cache/node-gyp/24.0.1/<(target_arch)/node.lib',
npm error gyp info spawn args   '-Dmodule_root_dir=/home/nico/repos/api/node_modules/sqlite3',
npm error gyp info spawn args   '-Dnode_engine=v8',
npm error gyp info spawn args   '--depth=.',
npm error gyp info spawn args   '--no-parallel',
npm error gyp info spawn args   '--generator-output',
npm error gyp info spawn args   'build',
npm error gyp info spawn args   '-Goutput_dir=.'
npm error gyp info spawn args ]
npm error Traceback (most recent call last):
npm error   File "/home/nico/repos/api/node_modules/node-gyp/gyp/gyp_main.py", line 42, in <module>
npm error     import gyp  # noqa: E402
npm error     ^^^^^^^^^^
npm error   File "/home/nico/repos/api/node_modules/node-gyp/gyp/pylib/gyp/__init__.py", line 9, in <module>
npm error     import gyp.input
npm error   File "/home/nico/repos/api/node_modules/node-gyp/gyp/pylib/gyp/input.py", line 19, in <module>
npm error     from distutils.version import StrictVersion
npm error ModuleNotFoundError: No module named 'distutils'
npm error gyp ERR! configure error 
npm error gyp ERR! stack Error: `gyp` failed with exit code: 1
npm error gyp ERR! stack     at ChildProcess.onCpExit (/home/nico/repos/api/node_modules/node-gyp/lib/configure.js:259:16)
npm error gyp ERR! stack     at ChildProcess.emit (node:events:507:28)
npm error gyp ERR! stack     at ChildProcess._handle.onexit (node:internal/child_process:294:12)
npm error gyp ERR! System Linux 6.14.0-15-generic
npm error gyp ERR! command "/home/nico/.nvm/versions/node/v24.0.1/bin/node" "/home/nico/repos/api/node_modules/.bin/node-gyp" "rebuild"
npm error gyp ERR! cwd /home/nico/repos/api/node_modules/sqlite3
npm error gyp ERR! node -v v24.0.1
npm error gyp ERR! node-gyp -v v8.4.1
npm error gyp ERR! not ok

EDIT: node-gyp supports Node 22/24 from v10 but drops Node 14. ⚠ Node 16 support is also dropped in v11. Maybe you could give a version range in npm peerDependencies to allow a range of Node from 14 to 24:

"peerDependencies": {
    "node-gyp": ">=8 <=11"
  },

[Freezystem]

I actually fixed the installation by clearing the package-lock.json and node_modules directory.
I think that an old version of prebuild-install was installed instead of the latest 7.1.3 that updates the N-API package.

[Apkovy]

I had the same problem and tried a lot of things. I reinstalled Node completely on my Windows machine, updated Visual Studio 2022 with build tools, updated npm to latest version , removed node_modules and package_lock.json and cleaned the npm cache. To no avail.

In error log I always saw the node-gyp version v8.4.1 without realizing it is the culprit. Until I saw the @Freezystem comment EDIT. It is what helped me finally.

I ran npm install -g node-gyp and checked the installed version. The version v11.2.0 was printed on the screen.

After that the npm install was successfull.

Note: I don't know, why node-gyp remained freezed in the version v8.4.1 even when I was reinstalling Node 22.16.0 from standalone installation package.

[ihqtim]

We're hitting this issue on Node.js 22.16.0:
npm error prebuild-install warn install No prebuilt binaries found (target=undefined runtime=napi arch=x64 libc= platform=linux)
Definitely prefer the pre-built binaries as the sqlite3 library is npm installed into a range of environments here (Ubuntu, Windows, client computers, amd, arm); reluctant to get the required build tools installed in all these environments.

Any chance a fix for this being released in the near future so that Node.js 22.16.0 "just works" with sqlite3?

[ihqtim]

We added this to the package.json as a temporary workaround:
"overrides": { "sqlite3": { "prebuild-install": "7.1.3" } },