Global install fails on Node.js 22 / 24 due to isolated-vm native build error on macOS (arm64)

[Denn1sHe]

Hi, thanks for building webcrack — it’s a great tool.

I’m opening this issue because the global installation currently fails on macOS (Apple Silicon)
when using Node.js 22 or 24, which are recommended in the README.

Environment:

• OS: macOS (macos 26.1)
• Arch: arm64 (Apple Silicon)
• Node.js: v24.12.0 (also reproducible on v22.x)
• Package manager: pnpm
• Installation method: global install
• webcrack: latest
• Dependency causing failure: isolated-vm@5.0.4

Install command:
pnpm add -g webcrack --allow-build=isolated-vm

Result:
The installation fails while building the native dependency isolated-vm
during node-gyp rebuild.

Key errors from the build output:

• "C++20 or later required."
• unknown type name 'requires'
• unknown type name 'concept'
• std::ranges not found
• errors originating from V8 headers (v8config.h, v8-local-handle.h, cppgc headers)

This appears to be related to Node.js 22 / 24 shipping newer V8 headers
that require C++20, while isolated-vm does not currently build
successfully in this environment on macOS arm64.

Workaround:

• Downgrading Node.js to v20 LTS allows webcrack to install and run successfully.

Questions / suggestions:

1. Is webcrack currently tested against Node.js 22 / 24 on macOS arm64?
2. Is this a known limitation of the isolated-vm dependency?
3. Would it make sense to document Node.js 20 LTS as a recommended or fallback version
   until the isolated-vm build issue is resolved?

I’m happy to help test or provide full build logs if needed.
Thanks again for the project.

[smiRaphi]

Same here on 24 LTS Windows x64

[Cayincc]

same issue

npm error gyp info using node-gyp@11.4.2
npm error gyp info using node@24.11.0 | darwin | arm64
npm error gyp info find Python using Python version 3.13.9 found at "/opt/homebrew/Caskroom/miniconda/base/bin/python3"
npm error gyp info spawn /opt/homebrew/Caskroom/miniconda/base/bin/python3
npm error gyp info spawn args [
npm error gyp info spawn args '/Users/cayin.wan/.nvm/versions/node/v24.11.0/lib/node_modules/npm/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 '/Users/cayin.wan/.nvm/versions/node/v24.11.0/lib/node_modules/webcrack/node_modules/isolated-vm/build/config.gypi',
npm error gyp info spawn args '-I',
npm error gyp info spawn args '/Users/cayin.wan/.nvm/versions/node/v24.11.0/lib/node_modules/npm/node_modules/node-gyp/addon.gypi',
npm error gyp info spawn args '-I',
npm error gyp info spawn args '/Users/cayin.wan/Library/Caches/node-gyp/24.11.0/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=/Users/cayin.wan/Library/Caches/node-gyp/24.11.0',
npm error gyp info spawn args '-Dnode_gyp_dir=/Users/cayin.wan/.nvm/versions/node/v24.11.0/lib/node_modules/npm/node_modules/node-gyp',
npm error gyp info spawn args '-Dnode_lib_file=/Users/cayin.wan/Library/Caches/node-gyp/24.11.0/<(target_arch)/node.lib',
npm error gyp info spawn args '-Dmodule_root_dir=/Users/cayin.wan/.nvm/versions/node/v24.11.0/lib/node_modules/webcrack/node_modules/isolated-vm',
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 ]

[Bad3r]

I ran into similar compilation failures packaging webcrack for NixOS (Linux x86_64, GCC 15, Node.js 22).

Root cause: isolated-vm@5.0.x is incompatible with Node.js 22+ V8 headers. On Linux/GCC, the specific error was a type mismatch in timer.h/timer.cc:

error: no declaration matches 'void ivm::timer_t::wait_detached(uint32_t, ...)'
candidate is: 'static void ivm::timer_t::wait_detached(int, ...)'

Solution: Upgrade to isolated-vm@6.0.2 which requires Node.js >= 22.0.0 and includes fixes for V8 API compatibility.

In my NixOS package, patching packages/webcrack/package.json to use "isolated-vm": "^6.0.2" and updating pnpm-lock.yaml accordingly resolved the build failures. The native module compiles and loads correctly with Node.js 22.

Suggested fix for upstream: Bump the isolated-vm dependency from ^5.0.1 to ^6.0.2 in packages/webcrack/package.json. This would also bump the minimum Node.js requirement to 22+, which aligns with the README's current recommendations.

[0xdevalias]

See also, this older related / duplicate issue:

• installation fails with newer node because of isolated-vm #183

And maybe also:

• Fix isolated-vm build under pnpm 10+ using pnpm.onlyBuiltDependencies (avoids manual install workaround) #185

[j4k0xb]

Fixed in release 2.16.0.