louislam · louislam · May 29, 2023 · May 14, 2023 · May 29, 2023 · Sep 4, 2023
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -20,43 +20,54 @@ jobs:
       matrix:
         os:
           - macos-latest
-          - ubuntu-20.04
+          - ubuntu-24.04
           - windows-latest
         host:
           - x64
         target:
           - x64
         node:
-          - 10
-          - 11
-          - 12
-          - 13
-          - 14
-          - 15
-          - 16
-          - 17
-          - 18
+          - 20
+          - 22
+          - 24
+        exclude:
+          # Node 20 x64 crashes under Rosetta 2 on ARM64 macOS runners
+          - os: macos-latest
+            node: 20
+            host: x64
         include:
-          - os: windows-latest
-            node: 16
-            host: x86
-            target: x86
-          - os: macos-m1
-            node: 16
+          - os: macos-latest
+            node: 20
+            host: arm64
+            target: arm64
+          - os: macos-latest
+            node: 22
+            host: arm64
+            target: arm64
+          - os: macos-latest
+            node: 24
+            host: arm64
+            target: arm64
+          - os: ubuntu-24.04-arm
+            node: 20
+            host: arm64
+            target: arm64
+          - os: ubuntu-24.04-arm
+            node: 22
+            host: arm64
+            target: arm64
+          - os: ubuntu-24.04-arm
+            node: 24
             host: arm64
             target: arm64
     name: ${{ matrix.os }} (node=${{ matrix.node }}, host=${{ matrix.host }}, target=${{ matrix.target }})
     steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
         with:
           node-version: ${{ matrix.node }}
           architecture: ${{ matrix.host }}
 
-      - name: Add yarn (self-hosted)
-        if: matrix.os == 'macos-m1'
-        run: npm install -g yarn
-
       - name: Add msbuild to PATH
         uses: microsoft/setup-msbuild@v1.3
         if: contains(matrix.os, 'windows')
@@ -66,6 +77,9 @@ jobs:
       - name: Install dependencies
         run: yarn install --ignore-scripts
 
+      - name: Check Node compatibility
+        run: node tools/semver-check.js
+
       - name: Add env vars
         shell: bash
         run: |
@@ -83,92 +97,69 @@ jobs:
           echo "CFLAGS=${CFLAGS:-} -include ../src/gcc-preinclude.h" >> $GITHUB_ENV
           echo "CXXFLAGS=${CXXFLAGS:-} -include ../src/gcc-preinclude.h" >> $GITHUB_ENV
 
-      - name: Configure build
-        run: yarn node-pre-gyp configure --target_arch=${{ env.TARGET }}
-
       - name: Build binaries
-        run: yarn node-pre-gyp build --target_arch=${{ env.TARGET }}
+        run: yarn prebuild -a ${{ env.TARGET }}
 
       - name: Print binary info
         if: contains(matrix.os, 'ubuntu')
         run: |
-          ldd lib/binding/*/node_sqlite3.node
+          ldd build/**/node_sqlite3.node
           echo "---"
-          nm lib/binding/*/node_sqlite3.node | grep "GLIBC_" | c++filt || true
+          nm build/**/node_sqlite3.node | grep "GLIBC_" | c++filt || true
           echo "---"
-          file lib/binding/napi-v*/*
+          file build/**/node_sqlite3.node
 
       - name: Run tests
         run: yarn test
 
-      - name: Package prebuilt binaries
-        run: yarn node-pre-gyp package --target_arch=${{ env.TARGET }}
-
       - name: Upload binaries to commit artifacts
-        uses: actions/upload-artifact@v3
-        if: matrix.node == 16
+        uses: actions/upload-artifact@v7
+        if: matrix.node == 24
         with:
-          name: prebuilt-binaries
-          path: build/stage/*/*
+          name: prebuilt-binaries-${{ matrix.os }}-${{ matrix.host }}
+          path: prebuilds/*
           retention-days: 7
 
       - name: Upload binaries to GitHub Release
-        run: yarn node-pre-gyp-github publish
-        if: matrix.node == 16 && startsWith(github.ref, 'refs/tags/')
-        env:
-          NODE_PRE_GYP_GITHUB_TOKEN: ${{ github.token }}
-  build-qemu:
-    runs-on: ubuntu-latest
+        run: yarn upload --upload-all ${{ github.token }}
+        if: matrix.node == 24 && startsWith(github.ref, 'refs/tags/')
+
+  build-musl:
     if: github.event_name == 'workflow_dispatch' || startsWith(github.ref, 'refs/tags/')
     strategy:
       fail-fast: false
       matrix:
-        node:
-          - 16
-        target:
-          - linux/arm64
-        variant:
-          - bullseye
-          - alpine3.15
         include:
-          # musl x64 builds
-          - target: linux/amd64
-            variant: alpine3.15
-            node: 16
-    name: ${{ matrix.variant }} (node=${{ matrix.node }}, target=${{ matrix.target }})
+          - runner: ubuntu-24.04-arm
+            platform: linux/arm64
+            arch: arm64
+          - runner: ubuntu-24.04
+            platform: linux/amd64
+            arch: amd64
+    runs-on: ${{ matrix.runner }}
+    name: musl ${{ matrix.arch }}
     steps:
-      - uses: actions/checkout@v3
-
-      - name: Set up QEMU
-        uses: docker/setup-qemu-action@v2
-
-      - name: Setup Docker Buildx
-        uses: docker/setup-buildx-action@v2
+      - uses: actions/checkout@v6
 
       - name: Build binaries and test
         run: |
-          docker buildx build \
+          docker build \
             --file ./tools/BinaryBuilder.Dockerfile \
-            --load \
             --tag sqlite-builder \
-            --platform ${{ matrix.target }} \
             --no-cache \
-            --build-arg VARIANT=${{ matrix.variant }} \
-            --build-arg NODE_VERSION=${{ matrix.node }} \
+            --build-arg VARIANT=alpine3.20 \
+            --build-arg NODE_VERSION=24 \
             .
           CONTAINER_ID=$(docker create -it sqlite-builder)
-          docker cp $CONTAINER_ID:/usr/src/build/build/ ./build
+          docker cp $CONTAINER_ID:/usr/src/build/prebuilds/ ./prebuilds
 
       - name: Upload binaries to commit artifacts
-        uses: actions/upload-artifact@v3
-        if: matrix.node == 16
+        uses: actions/upload-artifact@v7
         with:
-          name: prebuilt-binaries
-          path: build/stage/*/*
+          name: prebuilt-binaries-musl-${{ matrix.arch }}
+          path: prebuilds/*
           retention-days: 7
 
       - name: Upload binaries to GitHub Release
-        run: yarn install --ignore-scripts && yarn node-pre-gyp-github publish
-        if: matrix.node == 16 && startsWith(github.ref, 'refs/tags/')
-        env:
-          NODE_PRE_GYP_GITHUB_TOKEN: ${{ github.token }}
+        run: yarn install --ignore-scripts && yarn upload --upload-all ${{ github.token }}
+        if: startsWith(github.ref, 'refs/tags/')
diff --git a/.gitignore b/.gitignore
@@ -28,4 +28,4 @@ setup.sh
 /build-tmp-napi-v6
 *.tgz
 package-lock.json
-yarn.lock
+prebuilds
diff --git a/LICENSE b/LICENSE
@@ -1,4 +1,4 @@
-Copyright (c) MapBox
+Copyright (c) 2013-2026 Mapbox & Ghost Foundation
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without modification,

diff --git a/README.md b/README.md
@@ -1,5 +1,8 @@
-# ⚙️ node-sqlite3
+# :no_entry: [DEPRECATED] node-sqlite3
 
+**Note:** This repository is currently unmaintained. We will not update any of its issues or pull requests. 
+
+---
 Asynchronous, non-blocking [SQLite3](https://sqlite.org/) bindings for [Node.js](http://nodejs.org/).
 
 [![Latest release](https://img.shields.io/github/release/TryGhost/node-sqlite3.svg)](https://www.npmjs.com/package/sqlite3)
@@ -17,7 +20,7 @@ Asynchronous, non-blocking [SQLite3](https://sqlite.org/) bindings for [Node.js]
  - [Extension support](https://github.com/TryGhost/node-sqlite3/wiki/API#databaseloadextensionpath-callback), including bundled support for the [json1 extension](https://www.sqlite.org/json1.html)
  - Big test suite
  - Written in modern C++ and tested for memory leaks
- - Bundles SQLite v3.41.1, or you can build using a local SQLite
+ - Bundles SQLite v3.52.0, or you can build using a local SQLite
 
 # Installing
 
@@ -33,34 +36,23 @@ yarn add sqlite3
 
 ### Prebuilt binaries
 
-`sqlite3` v5+ was rewritten to use [Node-API](https://nodejs.org/api/n-api.html) so prebuilt binaries do not need to be built for specific Node versions. `sqlite3` currently builds for both Node-API v3 and v6. Check the [Node-API version matrix](https://nodejs.org/api/n-api.html#node-api-version-matrix) to ensure your Node version supports one of these. The prebuilt binaries should be supported on Node v10+.
-
-The module uses [node-pre-gyp](https://github.com/mapbox/node-pre-gyp) to download the prebuilt binary for your platform, if it exists. These binaries are hosted on GitHub Releases for `sqlite3` versions above 5.0.2, and they are hosted on S3 otherwise. The following targets are currently provided:
+`sqlite3` v5+ was rewritten to use [Node-API](https://nodejs.org/api/n-api.html) so prebuilt binaries do not need to be built for specific Node versions. `sqlite3` currently builds for both Node-API v3 and v6. Check the [Node-API version matrix](https://nodejs.org/api/n-api.html#node-api-version-matrix) to ensure your Node version supports one of these. The prebuilt binaries should be supported on Node v20.17.0+.
 
-Format: `napi-v{napi_build_version}-{platform}-{libc}-{arch}`
+The module uses [`prebuild-install`](https://github.com/prebuild/prebuild-install) to download the prebuilt binary for your platform, if it exists. These binaries are hosted on GitHub Releases for `sqlite3` versions above 5.0.2, and they are hosted on S3 otherwise. The following targets are currently provided:
 
-* `napi-v3-darwin-unknown-arm64`
-* `napi-v3-darwin-unknown-x64`
-* `napi-v3-linux-glibc-arm64`
-* `napi-v3-linux-glibc-x64`
-* `napi-v3-linux-musl-arm64`
-* `napi-v3-linux-musl-x64`
-* `napi-v3-win32-unknown-ia32`
-* `napi-v3-win32-unknown-x64`
-* `napi-v6-darwin-unknown-arm64`
-* `napi-v6-darwin-unknown-x64`
-* `napi-v6-linux-glibc-arm64`
-* `napi-v6-linux-glibc-x64`
-* `napi-v6-linux-musl-arm64`
-* `napi-v6-linux-musl-x64`
-* `napi-v6-win32-unknown-ia32`
-* `napi-v6-win32-unknown-x64`
+* `darwin-arm64`
+* `darwin-x64`
+* `linux-arm64`
+* `linux-x64`
+* `linuxmusl-arm64`
+* `linuxmusl-x64`
+* `win32-x64`
 
-Unfortunately, [node-pre-gyp](https://github.com/mapbox/node-pre-gyp) cannot differentiate between `armv6` and `armv7`, and instead uses `arm` as the `{arch}`. Until that is fixed, you will still need to install `sqlite3` from [source](#source-install).
+Unfortunately, [prebuild](https://github.com/prebuild/prebuild/issues/174) cannot differentiate between `armv6` and `armv7`, and instead uses `arm` as the `{arch}`. Until that is fixed, you will still need to install `sqlite3` from [source](#source-install).
 
 Support for other platforms and architectures may be added in the future if CI supports building on them.
 
-If your environment isn't supported, it'll use `node-gyp` to build SQLite but you will need to install a C++ compiler and linker.
+If your environment isn't supported, it'll use `node-gyp` to build SQLite, but you will need to install a C++ compiler and linker.
 
 ### Other ways to install
 
@@ -148,8 +140,6 @@ NODE_WEBKIT_VERSION="0.8.6" # see latest version at https://github.com/rogerwang
 npm install sqlite3 --build-from-source --runtime=node-webkit --target_arch=ia32 --target=$(NODE_WEBKIT_VERSION)
 ```
 
-This command internally calls out to [`node-pre-gyp`](https://github.com/mapbox/node-pre-gyp) which itself calls out to [`nw-gyp`](https://github.com/rogerwang/nw-gyp) when the `--runtime=node-webkit` option is passed.
-
 You can also run this command from within a `sqlite3` checkout:
 
 ```bash
@@ -254,7 +244,9 @@ This module was originally created by [Mapbox](https://mapbox.com/) & is now mai
 
 We use [GitHub releases](https://github.com/TryGhost/node-sqlite3/releases) for notes on the latest versions. See [CHANGELOG.md](https://github.com/TryGhost/node-sqlite3/blob/b05f4594cf8b0de64743561fcd2cfe6f4571754d/CHANGELOG.md) in git history for details on older versions.
 
-# License
+# Copyright & license
+
+Copyright (c) 2013-2026 Mapbox & Ghost Foundation
 
 `node-sqlite3` is [BSD licensed](https://github.com/tryghost/node-sqlite3/raw/master/LICENSE).
 

diff --git a/binding.gyp b/binding.gyp
@@ -2,7 +2,8 @@
   "includes": [ "deps/common-sqlite.gypi" ],
   "variables": {
       "sqlite%":"internal",
-      "sqlite_libname%":"sqlite3"
+      "sqlite_libname%":"sqlite3",
+      "module_name": "node_sqlite3",
   },
   "targets": [
     {
@@ -52,17 +53,6 @@
         "src/statement.cc"
       ],
       "defines": [ "NAPI_VERSION=<(napi_build_version)", "NAPI_DISABLE_CPP_EXCEPTIONS=1" ]
-    },
-    {
-      "target_name": "action_after_build",
-      "type": "none",
-      "dependencies": [ "<(module_name)" ],
-      "copies": [
-          {
-            "files": [ "<(PRODUCT_DIR)/<(module_name).node" ],
-            "destination": "<(module_path)"
-          }
-      ]
     }
   ]
 }
diff --git a/deps/common-sqlite.gypi b/deps/common-sqlite.gypi
@@ -1,6 +1,6 @@
 {
   'variables': {
-      'sqlite_version%':'3410100',
+      'sqlite_version%':'3520000',
       "toolset%":'',
   },
   'target_defaults': {

diff --git a/deps/extract.js b/deps/extract.js
@@ -1,4 +1,5 @@
 const tar = require("tar");
+const fs = require("fs");
 const path = require("path");
 const tarball = path.resolve(process.argv[2]);
 const dirname = path.resolve(process.argv[3]);
@@ -8,3 +9,11 @@ tar.extract({
     file: tarball,
     cwd: dirname,
 });
+
+// SQLite >= 3.49 ships a VERSION file that conflicts with the C++20 <version>
+// header on case-insensitive filesystems (macOS/Windows).
+const base = path.basename(tarball, ".tar.gz");
+const versionFile = path.join(dirname, base, "VERSION");
+if (fs.existsSync(versionFile)) {
+    fs.unlinkSync(versionFile);
+}
diff --git a/deps/sqlite-autoconf-3410100.tar.gz b/deps/sqlite-autoconf-3410100.tar.gz
diff --git a/deps/sqlite-autoconf-3520000.tar.gz b/deps/sqlite-autoconf-3520000.tar.gz
diff --git a/lib/sqlite3-binding.js b/lib/sqlite3-binding.js
@@ -1,5 +1 @@
-const binary = require('@mapbox/node-pre-gyp');
-const path = require('path');
-const binding_path = binary.find(path.resolve(path.join(__dirname,'../package.json')));
-const binding = require(binding_path);
-module.exports = exports = binding;
+module.exports = require('bindings')('node_sqlite3.node');