[Bug]: Cannot build better-sqlite3@9.6.0 on macOS/Arch Linux #1650

New Issue

Closed

opened 2026-02-28 19:49:39 -06:00 by GiteaMirror · 7 comments

GiteaMirror commented 2026-02-28 19:49:39 -06:00

Owner

Copy Link

Originally created by @akgerber on GitHub (Dec 9, 2024).

Verified issue does not already exist?

• I have searched and found no existing issue
• I will be providing steps how to reproduce the bug (in most cases this will also mean uploading a demo budget file)

What happened?

I have been unable to build the better-sqlite3@npm:9.6.0 dependency as required by yarn install, I believe since I upgraded to MacOS Sequoia.

The initial problem (a missing climits file) I had was resolved by reinstalling developer tools, but this revealed a new problem:
yarn install log, truncated to the issue:

➤ YN0007: │ better-sqlite3@npm:9.6.0 must be built because it never has been before or the last one failed
➤ YN0009: │ better-sqlite3@npm:9.6.0 couldn't be built successfully (exit code 1, logs can be found here: /private/var/folders/1g/qjgtwn9967j9t7fltdr29vbr0000gp/T/xfs-c2f6d1ae/build.log)
➤ YN0000: └ Completed in 13s 163ms
➤ YN0000: · Failed with errors in 13s 543ms

The contents of /private/var/folders/1g/qjgtwn9967j9t7fltdr29vbr0000gp/T/xfs-c2f6d1ae/build.log

# This file contains the result of Yarn building a package (better-sqlite3@npm:9.6.0)
# Script name: install

prebuild-install warn install No prebuilt binaries found (target=23.3.0 runtime=node arch=arm64 libc= platform=darwin)
gyp info it worked if it ends with ok
gyp info using node-gyp@10.1.0
gyp info using node@23.3.0 | darwin | arm64
gyp info find Python using Python version 3.13.0 found at "/opt/homebrew/opt/python@3.13/bin/python3.13"

gyp info spawn /opt/homebrew/opt/python@3.13/bin/python3.13
gyp info spawn args [
gyp info spawn args '/Users/akgerber/Code/github/actual-server/node_modules/node-gyp/gyp/gyp_main.py',
gyp info spawn args 'binding.gyp',
gyp info spawn args '-f',
gyp info spawn args 'make',
gyp info spawn args '-I',
gyp info spawn args '/Users/akgerber/Code/github/actual-server/node_modules/better-sqlite3/build/config.gypi',
gyp info spawn args '-I',
gyp info spawn args '/Users/akgerber/Code/github/actual-server/node_modules/node-gyp/addon.gypi',
gyp info spawn args '-I',
gyp info spawn args '/Users/akgerber/Library/Caches/node-gyp/23.3.0/include/node/common.gypi',
gyp info spawn args '-Dlibrary=shared_library',
gyp info spawn args '-Dvisibility=default',
gyp info spawn args '-Dnode_root_dir=/Users/akgerber/Library/Caches/node-gyp/23.3.0',
gyp info spawn args '-Dnode_gyp_dir=/Users/akgerber/Code/github/actual-server/node_modules/node-gyp',
gyp info spawn args '-Dnode_lib_file=/Users/akgerber/Library/Caches/node-gyp/23.3.0/<(target_arch)/node.lib',
gyp info spawn args '-Dmodule_root_dir=/Users/akgerber/Code/github/actual-server/node_modules/better-sqlite3',
gyp info spawn args '-Dnode_engine=v8',
gyp info spawn args '--depth=.',
gyp info spawn args '--no-parallel',
gyp info spawn args '--generator-output',
gyp info spawn args 'build',
gyp info spawn args '-Goutput_dir=.'
gyp info spawn args ]
gyp info spawn make
gyp info spawn args [ 'BUILDTYPE=Release', '-C', 'build' ]
  TOUCH ba23eeee118cd63e16015df367567cb043fed872.intermediate
  ACTION deps_sqlite3_gyp_locate_sqlite3_target_copy_builtin_sqlite3 ba23eeee118cd63e16015df367567cb043fed872.intermediate
  TOUCH Release/obj.target/deps/locate_sqlite3.stamp
  CC(target) Release/obj.target/sqlite3/gen/sqlite3/sqlite3.o
  LIBTOOL-STATIC Release/sqlite3.a
  CXX(target) Release/obj.target/better_sqlite3/src/better_sqlite3.o
In file included from ../src/better_sqlite3.cpp:4:
In file included from ./src/better_sqlite3.lzz:11:
In file included from /Users/akgerber/Library/Caches/node-gyp/23.3.0/include/node/node.h:73:
In file included from /Users/akgerber/Library/Caches/node-gyp/23.3.0/include/node/v8.h:23:
In file included from /Users/akgerber/Library/Caches/node-gyp/23.3.0/include/node/cppgc/common.h:8:
/Users/akgerber/Library/Caches/node-gyp/23.3.0/include/node/v8config.h:13:2: error: "C++20 or later required."
   13 | #error "C++20 or later required."
      |  ^
In file included from ../src/better_sqlite3.cpp:4:
./src/util/macros.lzz:31:69: error: no template named 'CopyablePersistentTraits' in namespace 'v8'; did you mean 'NonCopyablePersistentTraits'?
   31 | template <class T> using CopyablePersistent = v8::Persistent<T, v8::CopyablePersistentTraits<T>>;
      |                                                                 ~~~~^~~~~~~~~~~~~~~~~~~~~~~~
      |                                                                     NonCopyablePersistentTraits
/Users/akgerber/Library/Caches/node-gyp/23.3.0/include/node/v8-persistent-handle.h:223:7: note: 'NonCopyablePersistentTraits' declared here
  223 | class NonCopyablePersistentTraits {
      |       ^
In file included from ../src/better_sqlite3.cpp:4:
./src/util/macros.lzz:149:6: error: no type named 'AccessorGetterCallback' in namespace 'v8'; did you mean 'AccessorNameGetterCallback'?
  149 |         v8::AccessorGetterCallback func
      |         ~~~~^~~~~~~~~~~~~~~~~~~~~~
      |             AccessorNameGetterCallback
/Users/akgerber/Library/Caches/node-gyp/23.3.0/include/node/v8-object.h:155:7: note: 'AccessorNameGetterCallback' declared here
  155 | using AccessorNameGetterCallback =
      |       ^
./src/util/macros.lzz:158:6: error: no type named 'AccessorGetterCallback' in namespace 'v8'; did you mean 'AccessorNameGetterCallback'?
  158 |         v8::AccessorGetterCallback func
      |         ~~~~^~~~~~~~~~~~~~~~~~~~~~
      |             AccessorNameGetterCallback
/Users/akgerber/Library/Caches/node-gyp/23.3.0/include/node/v8-object.h:155:7: note: 'AccessorNameGetterCallback' declared here
  155 | using AccessorNameGetterCallback =
      |       ^
./src/util/macros.lzz:172:28: error: no member named 'SetAccessor' in 'v8::ObjectTemplate'
  172 |         recv->InstanceTemplate()->SetAccessor(
      |         ~~~~~~~~~~~~~~~~~~~~~~~~~~^
./src/objects/database.lzz:17:17: error: no matching function for call to 'SetPrototypeGetter'
      |         ~~~~~~~~~~~~~~~~~~~~~~~~~~^
./src/objects/database.lzz:17:17: error: no matching function for call to 'SetPrototypeGetter'
   17 |                 SetPrototypeGetter(isolate, data, t, "open", JS_open);
      |                 ^~~~~~~~~~~~~~~~~~
./src/util/macros.lzz:153:6: note: candidate function not viable: no known conversion from 'void (v8::Local<v8::String>, const v8::PropertyCallbackInfo<v8::Value> &)' to 'v8::AccessorNameGetterCallback' (aka 'void (*)(Local<Name>, const PropertyCallbackInfo<Value> &)') for 5th argument
  153 | void SetPrototypeGetter(
      |      ^
  154 |         v8::Isolate* isolate,
  155 |         v8::Local<v8::External> data,
  156 |         v8::Local<v8::FunctionTemplate> recv,
  157 |         const char* name,
  158 |         v8::AccessorGetterCallback func
      |         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
./src/objects/database.lzz:18:17: error: no matching function for call to 'SetPrototypeGetter'
   18 |                 SetPrototypeGetter(isolate, data, t, "inTransaction", JS_inTransaction);
      |                 ^~~~~~~~~~~~~~~~~~
./src/util/macros.lzz:153:6: note: candidate function not viable: no known conversion from 'void (v8::Local<v8::String>, const v8::PropertyCallbackInfo<v8::Value> &)' to 'v8::AccessorNameGetterCallback' (aka 'void (*)(Local<Name>, const PropertyCallbackInfo<Value> &)') for 5th argument
  153 | void SetPrototypeGetter(
      |      ^
  154 |         v8::Isolate* isolate,
  155 |         v8::Local<v8::External> data,
  156 |         v8::Local<v8::FunctionTemplate> recv,
  157 |         const char* name,
  158 |         v8::AccessorGetterCallback func
      |         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
./src/objects/database.lzz:180:21: warning: variable 'status' set but not used [-Wunused-but-set-variable]
  180 |                 int status = sqlite3_db_config(db_handle, SQLITE_DBCONFIG_ENABLE_LOAD_EXTENSION, 1, NULL);
      |                     ^
./src/objects/statement.lzz:16:17: error: no matching function for call to 'SetPrototypeGetter'
   16 |                 SetPrototypeGetter(isolate, data, t, "busy", JS_busy);
      |                 ^~~~~~~~~~~~~~~~~~
./src/util/macros.lzz:153:6: note: candidate function not viable: no known conversion from 'void (v8::Local<v8::String>, const v8::PropertyCallbackInfo<v8::Value> &)' to 'v8::AccessorNameGetterCallback' (aka 'void (*)(Local<Name>, const PropertyCallbackInfo<Value> &)') for 5th argument
  153 | void SetPrototypeGetter(
      |      ^
  154 |         v8::Isolate* isolate,
  155 |         v8::Local<v8::External> data,
  156 |         v8::Local<v8::FunctionTemplate> recv,
  157 |         const char* name,
  158 |         v8::AccessorGetterCallback func
      |         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
./src/util/custom-table.lzz:45:9: warning: missing field 'xIntegrity' initializer [-Wmissing-field-initializers]
   45 |         };
      |         ^
./src/util/custom-table.lzz:72:9: warning: missing field 'xIntegrity' initializer [-Wmissing-field-initializers]
   72 |         };
      |         ^
3 warnings and 8 errors generated.
make: *** [Release/obj.target/better_sqlite3/src/better_sqlite3.o] Error 1
rm ba23eeee118cd63e16015df367567cb043fed872.intermediate
gyp ERR! build error
gyp ERR! stack Error: `make` failed with exit code: 2
gyp ERR! stack at ChildProcess.<anonymous> (/Users/akgerber/Code/github/actual-server/node_modules/node-gyp/lib/build.js:209:23)
gyp ERR! System Darwin 24.1.0
gyp ERR! command "/opt/homebrew/Cellar/node/23.3.0/bin/node" "/Users/akgerber/Code/github/actual-server/node_modules/node-gyp/bin/node-gyp.js" "rebuild" "--release"
gyp ERR! cwd /Users/akgerber/Code/github/actual-server/node_modules/better-sqlite3
gyp ERR! node -v v23.3.0
gyp ERR! node-gyp -v v10.1.0
gyp ERR! not ok

Some cursory Googling indicates that this may be related to recent distributions of C++ removing a long-deprecated function signature:
https://github.com/WiseLibs/better-sqlite3/issues/1225

I was able to resolve the issue locally by bumping the dependency to latest version:

➜  actual-server git:(master) ✗ yarn add better-sqlite3
➤ YN0000: · Yarn 4.3.1
➤ YN0000: ┌ Resolution step
➤ YN0085: │ + better-sqlite3@npm:11.7.0
➤ YN0085: │ - better-sqlite3@npm:9.6.0
➤ YN0000: └ Completed
➤ YN0000: ┌ Post-resolution validation
➤ YN0002: │ actual-sync@workspace:. doesn't provide @babel/core (p89c81), requested by @babel/preset-typescript.
➤ YN0086: │ Some peer dependencies are incorrectly met by your project; run yarn explain peer-requirements <hash> for details, where <hash> is the six-letter p-prefixed code.
➤ YN0086: │ Some peer dependencies are incorrectly met by dependencies; run yarn explain peer-requirements for details.
➤ YN0000: └ Completed
➤ YN0000: ┌ Fetch step
➤ YN0013: │ A package was added to the project (+ 9.64 MiB).
➤ YN0000: └ Completed in 0s 490ms
➤ YN0000: ┌ Link step
➤ YN0007: │ better-sqlite3@npm:11.7.0 must be built because it never has been before or the last one failed
➤ YN0000: └ Completed in 1s 326ms
➤ YN0000: · Done with warnings in 1s 959ms
➜  actual-server git:(master) ✗ yarn install
➤ YN0000: · Yarn 4.3.1
➤ YN0000: ┌ Resolution step
➤ YN0000: └ Completed
➤ YN0000: ┌ Post-resolution validation
➤ YN0002: │ actual-sync@workspace:. doesn't provide @babel/core (p89c81), requested by @babel/preset-typescript.
➤ YN0086: │ Some peer dependencies are incorrectly met by your project; run yarn explain peer-requirements <hash> for details, where <hash> is the six-letter p-prefixed code.
➤ YN0086: │ Some peer dependencies are incorrectly met by dependencies; run yarn explain peer-requirements for details.
➤ YN0000: └ Completed
➤ YN0000: ┌ Fetch step
➤ YN0000: └ Completed in 0s 249ms
➤ YN0000: ┌ Link step
➤ YN0000: └ Completed
➤ YN0000: · Done with warnings in 0s 469ms

actual-server seems to run without issue on this newer version.

Where are you hosting Actual?

Locally via Yarn

What browsers are you seeing the problem on?

Other

Operating System

Mac OSX

Originally created by @akgerber on GitHub (Dec 9, 2024). ### Verified issue does not already exist? - [X] I have searched and found no existing issue - [X] I will be providing steps how to reproduce the bug (in most cases this will also mean uploading a demo budget file) ### What happened? I have been unable to build the `better-sqlite3@npm:9.6.0` dependency as required by `yarn install`, I believe since I upgraded to MacOS Sequoia. The initial problem (a missing `climits` file) I had was resolved by reinstalling developer tools, but this revealed a new problem: `yarn install` log, truncated to the issue: ``` ➤ YN0007: │ better-sqlite3@npm:9.6.0 must be built because it never has been before or the last one failed ➤ YN0009: │ better-sqlite3@npm:9.6.0 couldn't be built successfully (exit code 1, logs can be found here: /private/var/folders/1g/qjgtwn9967j9t7fltdr29vbr0000gp/T/xfs-c2f6d1ae/build.log) ➤ YN0000: └ Completed in 13s 163ms ➤ YN0000: · Failed with errors in 13s 543ms ``` The contents of `/private/var/folders/1g/qjgtwn9967j9t7fltdr29vbr0000gp/T/xfs-c2f6d1ae/build.log` ``` # This file contains the result of Yarn building a package (better-sqlite3@npm:9.6.0) # Script name: install prebuild-install warn install No prebuilt binaries found (target=23.3.0 runtime=node arch=arm64 libc= platform=darwin) gyp info it worked if it ends with ok gyp info using node-gyp@10.1.0 gyp info using node@23.3.0 | darwin | arm64 gyp info find Python using Python version 3.13.0 found at "/opt/homebrew/opt/python@3.13/bin/python3.13" gyp info spawn /opt/homebrew/opt/python@3.13/bin/python3.13 gyp info spawn args [ gyp info spawn args '/Users/akgerber/Code/github/actual-server/node_modules/node-gyp/gyp/gyp_main.py', gyp info spawn args 'binding.gyp', gyp info spawn args '-f', gyp info spawn args 'make', gyp info spawn args '-I', gyp info spawn args '/Users/akgerber/Code/github/actual-server/node_modules/better-sqlite3/build/config.gypi', gyp info spawn args '-I', gyp info spawn args '/Users/akgerber/Code/github/actual-server/node_modules/node-gyp/addon.gypi', gyp info spawn args '-I', gyp info spawn args '/Users/akgerber/Library/Caches/node-gyp/23.3.0/include/node/common.gypi', gyp info spawn args '-Dlibrary=shared_library', gyp info spawn args '-Dvisibility=default', gyp info spawn args '-Dnode_root_dir=/Users/akgerber/Library/Caches/node-gyp/23.3.0', gyp info spawn args '-Dnode_gyp_dir=/Users/akgerber/Code/github/actual-server/node_modules/node-gyp', gyp info spawn args '-Dnode_lib_file=/Users/akgerber/Library/Caches/node-gyp/23.3.0/<(target_arch)/node.lib', gyp info spawn args '-Dmodule_root_dir=/Users/akgerber/Code/github/actual-server/node_modules/better-sqlite3', gyp info spawn args '-Dnode_engine=v8', gyp info spawn args '--depth=.', gyp info spawn args '--no-parallel', gyp info spawn args '--generator-output', gyp info spawn args 'build', gyp info spawn args '-Goutput_dir=.' gyp info spawn args ] gyp info spawn make gyp info spawn args [ 'BUILDTYPE=Release', '-C', 'build' ] TOUCH ba23eeee118cd63e16015df367567cb043fed872.intermediate ACTION deps_sqlite3_gyp_locate_sqlite3_target_copy_builtin_sqlite3 ba23eeee118cd63e16015df367567cb043fed872.intermediate TOUCH Release/obj.target/deps/locate_sqlite3.stamp CC(target) Release/obj.target/sqlite3/gen/sqlite3/sqlite3.o LIBTOOL-STATIC Release/sqlite3.a CXX(target) Release/obj.target/better_sqlite3/src/better_sqlite3.o In file included from ../src/better_sqlite3.cpp:4: In file included from ./src/better_sqlite3.lzz:11: In file included from /Users/akgerber/Library/Caches/node-gyp/23.3.0/include/node/node.h:73: In file included from /Users/akgerber/Library/Caches/node-gyp/23.3.0/include/node/v8.h:23: In file included from /Users/akgerber/Library/Caches/node-gyp/23.3.0/include/node/cppgc/common.h:8: /Users/akgerber/Library/Caches/node-gyp/23.3.0/include/node/v8config.h:13:2: error: "C++20 or later required." 13 | #error "C++20 or later required." | ^ In file included from ../src/better_sqlite3.cpp:4: ./src/util/macros.lzz:31:69: error: no template named 'CopyablePersistentTraits' in namespace 'v8'; did you mean 'NonCopyablePersistentTraits'? 31 | template <class T> using CopyablePersistent = v8::Persistent<T, v8::CopyablePersistentTraits<T>>; | ~~~~^~~~~~~~~~~~~~~~~~~~~~~~ | NonCopyablePersistentTraits /Users/akgerber/Library/Caches/node-gyp/23.3.0/include/node/v8-persistent-handle.h:223:7: note: 'NonCopyablePersistentTraits' declared here 223 | class NonCopyablePersistentTraits { | ^ In file included from ../src/better_sqlite3.cpp:4: ./src/util/macros.lzz:149:6: error: no type named 'AccessorGetterCallback' in namespace 'v8'; did you mean 'AccessorNameGetterCallback'? 149 | v8::AccessorGetterCallback func | ~~~~^~~~~~~~~~~~~~~~~~~~~~ | AccessorNameGetterCallback /Users/akgerber/Library/Caches/node-gyp/23.3.0/include/node/v8-object.h:155:7: note: 'AccessorNameGetterCallback' declared here 155 | using AccessorNameGetterCallback = | ^ ./src/util/macros.lzz:158:6: error: no type named 'AccessorGetterCallback' in namespace 'v8'; did you mean 'AccessorNameGetterCallback'? 158 | v8::AccessorGetterCallback func | ~~~~^~~~~~~~~~~~~~~~~~~~~~ | AccessorNameGetterCallback /Users/akgerber/Library/Caches/node-gyp/23.3.0/include/node/v8-object.h:155:7: note: 'AccessorNameGetterCallback' declared here 155 | using AccessorNameGetterCallback = | ^ ./src/util/macros.lzz:172:28: error: no member named 'SetAccessor' in 'v8::ObjectTemplate' 172 | recv->InstanceTemplate()->SetAccessor( | ~~~~~~~~~~~~~~~~~~~~~~~~~~^ ./src/objects/database.lzz:17:17: error: no matching function for call to 'SetPrototypeGetter' | ~~~~~~~~~~~~~~~~~~~~~~~~~~^ ./src/objects/database.lzz:17:17: error: no matching function for call to 'SetPrototypeGetter' 17 | SetPrototypeGetter(isolate, data, t, "open", JS_open); | ^~~~~~~~~~~~~~~~~~ ./src/util/macros.lzz:153:6: note: candidate function not viable: no known conversion from 'void (v8::Local<v8::String>, const v8::PropertyCallbackInfo<v8::Value> &)' to 'v8::AccessorNameGetterCallback' (aka 'void (*)(Local<Name>, const PropertyCallbackInfo<Value> &)') for 5th argument 153 | void SetPrototypeGetter( | ^ 154 | v8::Isolate* isolate, 155 | v8::Local<v8::External> data, 156 | v8::Local<v8::FunctionTemplate> recv, 157 | const char* name, 158 | v8::AccessorGetterCallback func | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ./src/objects/database.lzz:18:17: error: no matching function for call to 'SetPrototypeGetter' 18 | SetPrototypeGetter(isolate, data, t, "inTransaction", JS_inTransaction); | ^~~~~~~~~~~~~~~~~~ ./src/util/macros.lzz:153:6: note: candidate function not viable: no known conversion from 'void (v8::Local<v8::String>, const v8::PropertyCallbackInfo<v8::Value> &)' to 'v8::AccessorNameGetterCallback' (aka 'void (*)(Local<Name>, const PropertyCallbackInfo<Value> &)') for 5th argument 153 | void SetPrototypeGetter( | ^ 154 | v8::Isolate* isolate, 155 | v8::Local<v8::External> data, 156 | v8::Local<v8::FunctionTemplate> recv, 157 | const char* name, 158 | v8::AccessorGetterCallback func | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ./src/objects/database.lzz:180:21: warning: variable 'status' set but not used [-Wunused-but-set-variable] 180 | int status = sqlite3_db_config(db_handle, SQLITE_DBCONFIG_ENABLE_LOAD_EXTENSION, 1, NULL); | ^ ./src/objects/statement.lzz:16:17: error: no matching function for call to 'SetPrototypeGetter' 16 | SetPrototypeGetter(isolate, data, t, "busy", JS_busy); | ^~~~~~~~~~~~~~~~~~ ./src/util/macros.lzz:153:6: note: candidate function not viable: no known conversion from 'void (v8::Local<v8::String>, const v8::PropertyCallbackInfo<v8::Value> &)' to 'v8::AccessorNameGetterCallback' (aka 'void (*)(Local<Name>, const PropertyCallbackInfo<Value> &)') for 5th argument 153 | void SetPrototypeGetter( | ^ 154 | v8::Isolate* isolate, 155 | v8::Local<v8::External> data, 156 | v8::Local<v8::FunctionTemplate> recv, 157 | const char* name, 158 | v8::AccessorGetterCallback func | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ./src/util/custom-table.lzz:45:9: warning: missing field 'xIntegrity' initializer [-Wmissing-field-initializers] 45 | }; | ^ ./src/util/custom-table.lzz:72:9: warning: missing field 'xIntegrity' initializer [-Wmissing-field-initializers] 72 | }; | ^ 3 warnings and 8 errors generated. make: *** [Release/obj.target/better_sqlite3/src/better_sqlite3.o] Error 1 rm ba23eeee118cd63e16015df367567cb043fed872.intermediate gyp ERR! build error gyp ERR! stack Error: `make` failed with exit code: 2 gyp ERR! stack at ChildProcess.<anonymous> (/Users/akgerber/Code/github/actual-server/node_modules/node-gyp/lib/build.js:209:23) gyp ERR! System Darwin 24.1.0 gyp ERR! command "/opt/homebrew/Cellar/node/23.3.0/bin/node" "/Users/akgerber/Code/github/actual-server/node_modules/node-gyp/bin/node-gyp.js" "rebuild" "--release" gyp ERR! cwd /Users/akgerber/Code/github/actual-server/node_modules/better-sqlite3 gyp ERR! node -v v23.3.0 gyp ERR! node-gyp -v v10.1.0 gyp ERR! not ok ``` Some cursory Googling indicates that this may be related to recent distributions of C++ removing a long-deprecated function signature: https://github.com/WiseLibs/better-sqlite3/issues/1225 I was able to resolve the issue locally by bumping the dependency to latest version: ``` ➜ actual-server git:(master) ✗ yarn add better-sqlite3 ➤ YN0000: · Yarn 4.3.1 ➤ YN0000: ┌ Resolution step ➤ YN0085: │ + better-sqlite3@npm:11.7.0 ➤ YN0085: │ - better-sqlite3@npm:9.6.0 ➤ YN0000: └ Completed ➤ YN0000: ┌ Post-resolution validation ➤ YN0002: │ actual-sync@workspace:. doesn't provide @babel/core (p89c81), requested by @babel/preset-typescript. ➤ YN0086: │ Some peer dependencies are incorrectly met by your project; run yarn explain peer-requirements <hash> for details, where <hash> is the six-letter p-prefixed code. ➤ YN0086: │ Some peer dependencies are incorrectly met by dependencies; run yarn explain peer-requirements for details. ➤ YN0000: └ Completed ➤ YN0000: ┌ Fetch step ➤ YN0013: │ A package was added to the project (+ 9.64 MiB). ➤ YN0000: └ Completed in 0s 490ms ➤ YN0000: ┌ Link step ➤ YN0007: │ better-sqlite3@npm:11.7.0 must be built because it never has been before or the last one failed ➤ YN0000: └ Completed in 1s 326ms ➤ YN0000: · Done with warnings in 1s 959ms ➜ actual-server git:(master) ✗ yarn install ➤ YN0000: · Yarn 4.3.1 ➤ YN0000: ┌ Resolution step ➤ YN0000: └ Completed ➤ YN0000: ┌ Post-resolution validation ➤ YN0002: │ actual-sync@workspace:. doesn't provide @babel/core (p89c81), requested by @babel/preset-typescript. ➤ YN0086: │ Some peer dependencies are incorrectly met by your project; run yarn explain peer-requirements <hash> for details, where <hash> is the six-letter p-prefixed code. ➤ YN0086: │ Some peer dependencies are incorrectly met by dependencies; run yarn explain peer-requirements for details. ➤ YN0000: └ Completed ➤ YN0000: ┌ Fetch step ➤ YN0000: └ Completed in 0s 249ms ➤ YN0000: ┌ Link step ➤ YN0000: └ Completed ➤ YN0000: · Done with warnings in 0s 469ms ``` `actual-server` seems to run without issue on this newer version. ### Where are you hosting Actual? Locally via Yarn ### What browsers are you seeing the problem on? Other ### Operating System Mac OSX

GiteaMirror added the bug label 2026-02-28 19:49:39 -06:00

GiteaMirror closed this issue 2026-02-28 19:49:41 -06:00

GiteaMirror commented 2026-02-28 19:49:41 -06:00

Author

Owner

Copy Link

@psybers commented on GitHub (Dec 13, 2024):

I can confirm this build problem on Sonoma. I was trying to update my helper scripts and hit this same issue.

@psybers commented on GitHub (Dec 13, 2024): I can confirm this build problem on Sonoma. I was trying to update my helper scripts and hit this same issue.

GiteaMirror commented 2026-02-28 19:49:42 -06:00

Author

Owner

Copy Link

@benricok commented on GitHub (Dec 14, 2024):

I can confirm the same problem building on arch linux

@benricok commented on GitHub (Dec 14, 2024): I can confirm the same problem building on arch linux

GiteaMirror commented 2026-02-28 19:49:42 -06:00

Author

Owner

Copy Link

@ru44 commented on GitHub (Dec 20, 2024):

I can confirm the same problem building on MacOS sequoia

@ru44 commented on GitHub (Dec 20, 2024): I can confirm the same problem building on MacOS sequoia

GiteaMirror commented 2026-02-28 19:49:42 -06:00

Author

Owner

Copy Link

@lelemm commented on GitHub (Dec 20, 2024):

try

yarn rebuild

I have had several problems with better-sqlite3 last month on another project that was solved by rebuilding it

@lelemm commented on GitHub (Dec 20, 2024): try ```bash yarn rebuild ``` I have had several problems with better-sqlite3 last month on another project that was solved by rebuilding it

GiteaMirror commented 2026-02-28 19:49:43 -06:00

Author

Owner

Copy Link

@svitiashchuk commented on GitHub (Jan 6, 2025):

From the log mentioned in issue, I can see that node@23 is being used.

gyp info using node@23.3.0 | darwin | arm64

The actual Budget is built using Node@18, if I’m not mistaken. If you are using Homebrew, try downgrading your Node version:

In my case, I tried with Node 20, and it seems to be working well:

brew unlink node@23
brew install node@20
brew link --overwrite --force node@20

@svitiashchuk commented on GitHub (Jan 6, 2025): From the log mentioned in issue, I can see that node@23 is being used. ``` gyp info using node@23.3.0 | darwin | arm64 ``` The actual Budget is built using Node@18, if I’m not mistaken. If you are using Homebrew, try downgrading your Node version: In my case, I tried with Node 20, and it seems to be working well: ``` brew unlink node@23 brew install node@20 brew link --overwrite --force node@20 ```

GiteaMirror commented 2026-02-28 19:49:43 -06:00

Author

Owner

Copy Link

@NikxDa commented on GitHub (Jan 16, 2025):

This issue is due to the version of better-sqlite3 being used, which is major version 9. Support for Node 22 (and in my testing, also 23) was only added in version 10 (see here: https://github.com/WiseLibs/better-sqlite3/releases?page=2).

This means the API can't currently be used in Node 22 and beyond. If you're using the API in your project, you can override the dependency manually in package.json:

"overrides": {
    "@actual-app/api": {
        "better-sqlite3": "^11"
    }
}

Edit: It looks like version 25.1.0 fixed this issue.

@NikxDa commented on GitHub (Jan 16, 2025): This issue is due to the version of `better-sqlite3` being used, which is major version 9. Support for Node 22 (and in my testing, also 23) was only added in version 10 (see here: https://github.com/WiseLibs/better-sqlite3/releases?page=2). ~This means the API can't currently be used in Node 22 and beyond.~ If you're using the API in your project, you can override the dependency manually in `package.json`: ``` "overrides": { "@actual-app/api": { "better-sqlite3": "^11" } } ``` Edit: It looks like version 25.1.0 fixed this issue.

GiteaMirror commented 2026-02-28 19:49:44 -06:00

Author

Owner

Copy Link

@matt-fidd commented on GitHub (Jan 17, 2025):

better-sqlite3 has been bumped, node 22 and 23 should now build.

@matt-fidd commented on GitHub (Jan 17, 2025): `better-sqlite3` has been bumped, node 22 and 23 should now build.

GiteaMirror referenced this issue 2026-02-28 20:48:04 -06:00

[PR #1650] [MERGED] Webpack + SWC Loader #3870

GiteaMirror referenced this issue 2026-04-10 20:47:46 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #10925

GiteaMirror referenced this issue 2026-04-14 20:38:55 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #18233

GiteaMirror referenced this issue 2026-04-16 16:48:19 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #22480

GiteaMirror referenced this issue 2026-04-18 06:17:23 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #29795

GiteaMirror referenced this issue 2026-04-20 21:16:34 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #34065

GiteaMirror referenced this issue 2026-04-23 11:25:53 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #38301

GiteaMirror referenced this issue 2026-04-26 07:49:18 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #45690

GiteaMirror referenced this issue 2026-04-30 21:39:22 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #53174

GiteaMirror referenced this issue 2026-05-06 21:43:05 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #57524

GiteaMirror referenced this issue 2026-05-11 18:55:21 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #61856

GiteaMirror referenced this issue 2026-05-14 00:29:39 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #66237

GiteaMirror referenced this issue 2026-05-16 15:03:55 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #73855

GiteaMirror referenced this issue 2026-05-19 05:45:25 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #81551

GiteaMirror referenced this issue 2026-05-22 06:14:01 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #86054

GiteaMirror referenced this issue 2026-05-26 06:36:14 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #93768

GiteaMirror referenced this issue 2026-05-29 23:12:42 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #101566

GiteaMirror referenced this issue 2026-06-02 10:52:00 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #106136

GiteaMirror referenced this issue 2026-06-05 14:26:51 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #110687

GiteaMirror referenced this issue 2026-06-11 14:39:54 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #118587

GiteaMirror referenced this issue 2026-06-14 00:51:44 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #123299

GiteaMirror referenced this issue 2026-06-15 18:29:11 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #127977

GiteaMirror referenced this issue 2026-06-17 14:50:17 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #132665

GiteaMirror referenced this issue 2026-06-19 02:36:02 -05:00

[PR #1650] [MERGED] Webpack + SWC Loader #137367

Sign in to join this conversation.

No Branch/Tag Specified

Branches Tags

master

dependabot/npm_and_yarn/npm_and_yarn-cd62b4b37a

enforce-append-only-migrations-ci

claude/error-codes-worker-boundary-26i5uu

api-browser-custom-data-dir

tabedzki/feat/replacing-month-picker-with-day-picker

delay-initial-sync-until-loaded

jfdoming/mobile-app-build

cross-version-sync-compat

jfdoming/api-tokens-part-1

jfdoming/api-tokens-part-2

jfdoming/api-tokens-part-3

jfdoming/mobile-app-updates

claude/budget-version-migration-compat-151jlr

claude/worker-error-serialization-9iqtl7

claude/react-table-library-research-afx83z

claude/issue-8401-regression-test-9nw9l3

jfdoming/mobile-app-foundation-part-1

jfdoming/mobile-app-scaffold

release

ai-fix-cleanup-def-8290

claude/relaxed-shannon-jusywa

claude/fervent-keller-s6f2fq

claude/determined-feynman-st1y9z

claude/wizardly-einstein-vi2wce

claude/sweet-albattani-7nseio

feat/bank-sync-per-budget-file

claude/affectionate-cannon-y0kc82

claude/dependabot-findings-m9pgmb

claude/mac-app-ios-publish-zjs1lz

claude/vigilant-tesla-aiiyos

depot-migrate-secrets-1781296330308

claude/quirky-cerf-v5qck7

claude/animation-removal-alternative-2etfh1

claude/netlify-preview-comments-consolidate-9XPYa

osc/7391-error-boundaries-reports

claude/pensive-dijkstra-7DYui

claude/server-app-version-mismatch-HTCGv

claude/pr-8027-review-feedback-mELuO

claude/zealous-wozniak-e5pO0

claude/intelligent-heisenberg-BSHJq

claude/translation-download-refactor-jFRsO

claude/mobile-performance-ideas-G9PAO

claude/github-issue-7988-5A5ly

blacksmith-migration-ff70d2d

claude/great-mayer-KRvOk

claude/react-native-ios-compilation-fcJh5

claude/serene-goldberg-58xv0

claude/kind-euler-LVG3K

release-automation/edge-nightly

7710-bundle-migrations

claude/fix-docker-build-error-WMfed

claude/llm-compatible-release-notes-t20Nr

7710-tests-tdd

cursor/transaction-table-rewrite-f077

claude/plan-ci-secure-context-OtEe1

claude/fix-issue-7667-DPXi3

cursor/resolve-pr-7449-ee11

claude/fix-typescript-build-error-JPtZ5

copilot/add-repository-configs-to-packages

worktree-compressed-drifting-ritchie

claude/api-consumer-verification-kfz1K

pr-7454

claude/fix-issue-7410-LLLQ4

revert-7281-generate-icons

react-query-useSchedules

copilot/sub-pr-6140

package-upgrades

v26.7.0

v26.6.0

v26.5.2

v26.5.1

v26.5.0

v26.4.0

v26.3.0

v26.2.1

v26.2.0

v26.1.0

v25.12.0

v25.11.0

v25.10.0

v25.9.0

v25.8.0

v25.7.1

v25.7.0

v25.6.1

v25.6.0

v25.5.0

v25.4.0

v25.3.1

v25.3.0

v25.2.1

v25.2.0

v25.1.0

v24.12.0

v24.11.0

v24.10.1

v24.10.0

v24.9.0

v24.8.0

v24.7.0

v24.6.0

v24.5.0

v24.4.0

v24.3.0

v24.2.0

v24.1.0

v23.12.0

v23.11.0

v23.10.0

v23.9.0

v23.8.1

v23.8.0

v23.7.2

v23.7.1

v23.7.0

v23.6.0

v23.5.0

v23.4.2

v23.4.1

v23.4.0

v23.3.2

v23.3.0

v23.2.9

v23.2.5

v23.1.12

v22.12.9

Labels

Clear labels

AI generated

API

bank sync

budgeting

bug

can’t replicate

dependencies

docker

documentation

electron

experimental feature

feature

feedback

goal templates

good first issue

help wanted

importers

maintenance

needs info

needs testing

needs triage

needs votes

openid

payees

pull-request

Mirrored from GitHub Pull Request

regression

reports

responsive

rules

schedules

server

✨ merged

split transactions

tech debt

tech-support

theme

transaction import

transaction reconciliation

transactions

translations

upstream

user interface

✅ approved

wontfix

No Label bug

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

GiteaMirror ninjasurge

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: github-starred/actual#1650