@photostructure/sqlite 0.0.1

package/package.json

@@ -0,0 +1,144 @@
+{
+  "name": "@photostructure/sqlite",
+  "version": "0.0.1",
+  "description": "Drop-in replacement for node:sqlite",
+  "homepage": "https://photostructure.github.io/node-sqlite/",
+  "types": "./dist/index.d.ts",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      },
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.mjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/photostructure/node-sqlite.git"
+  },
+  "license": "MIT",
+  "private": false,
+  "scripts": {
+    "install": "node-gyp-build",
+    "clean": "run-p clean:*",
+    "clean:dist": "del-cli dist \"*.tsbuildinfo\"",
+    "clean:native": "node-gyp clean",
+    "sync:node": "tsx scripts/sync-from-node.ts",
+    "sync:sqlite": "tsx scripts/sync-from-sqlite.ts",
+    "node-gyp-rebuild": "node-gyp rebuild",
+    "build": "run-p build:native build:dist",
+    "build:native": "prebuildify --napi --tag-libc --strip",
+    "build:linux-glibc": "bash scripts/prebuild-linux-glibc.sh",
+    "build:dist": "tsup && node scripts/post-build.mjs",
+    "tests": "run-s tests:*",
+    "tests:cjs": "jest",
+    "tests:esm": "cross-env TEST_ESM=1 node --experimental-vm-modules --no-warnings node_modules/jest/bin/jest.js",
+    "// test": "support `npm t name_of_file` (and don't fail due to missing coverage)",
+    "test": "npm run tests:cjs -- --no-coverage",
+    "test:serial": "npm run tests:cjs -- --runInBand --no-coverage",
+    "test:all": "run-s \"tests:cjs -- {@}\" \"tests:esm -- {@}\" --",
+    "// test:api-compat": "run by the api compability CI workflow",
+    "test:api-compat": "jest --config jest.config.api-compat.cjs",
+    "test:node-compat": "cross-env NODE_OPTIONS=\"--experimental-sqlite --no-warnings\" npm run tests:cjs -- --no-coverage test/node-compatibility.test.ts",
+    "test:build-extension": "cd test/fixtures/test-extension && node build.js",
+    "memory:test": "cross-env TEST_MEMORY=1 node --expose-gc node_modules/jest/bin/jest.js --no-coverage test/memory.test.ts",
+    "memory:valgrind": "bash scripts/valgrind-test.sh",
+    "memory:asan": "bash scripts/sanitizers-test.sh",
+    "check:memory": "node scripts/check-memory.mjs",
+    "benchmark": "cd benchmark && npm install && npm run bench",
+    "benchmark:memory": "cd benchmark && npm install && npm run bench:memory",
+    "benchmark:full": "cd benchmark && npm install && npm run bench && npm run bench:memory",
+    "lint": "run-p lint:*",
+    "lint:ts": "tsc --noEmit",
+    "lint:ts-build": "tsc -p tsconfig.build.json --noEmit",
+    "lint:ts-scripts": "tsc --noEmit --module esnext --target es2022 --moduleResolution node --project scripts/tsconfig.json",
+    "lint:eslint": "eslint src/ test/",
+    "// lint:api-compat": "run by the api compability CI workflow",
+    "lint:api-compat": "tsx scripts/check-api-compat.ts",
+    "lint:native": "tsx scripts/clang-tidy.ts",
+    "fmt": "run-p fmt:*",
+    "fmt:ts": "prettier --write \"**/*.{ts,js,mjs,json,md}\"",
+    "// fmt:native": "on ubuntu: `sudo apt install clang-format`. NOTE: we don't reformat src/upstream!",
+    "fmt:native": "clang-format --style=LLVM -i src/shims/*.h src/*.cpp src/*.h test/fixtures/test-extension/*.c || true",
+    "docs": "typedoc",
+    "// precommit": "should be manually run by developers before they run `git commit`",
+    "precommit": "tsx scripts/precommit.ts",
+    "prepare-release": "npm run build:dist",
+    "release": "release-it",
+    "security": "run-s security:*",
+    "security:audit": "npm audit --production",
+    "security:audit-fix": "npm audit fix --force",
+    "security:osv": "if command -v osv-scanner >/dev/null 2>&1; then osv-scanner scan source --recursive .; else echo 'OSV Scanner not installed. Install with: go install github.com/google/osv-scanner/cmd/osv-scanner@latest'; fi",
+    "xsecurity:snyk": "snyk test"
+  },
+  "gypfile": true,
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "keywords": [
+    "sqlite",
+    "node:sqlite",
+    "drop-in-replacement",
+    "database",
+    "sql",
+    "native",
+    "node-addon",
+    "DatabaseSync",
+    "StatementSync",
+    "sync",
+    "performance"
+  ],
+  "dependencies": {
+    "node-addon-api": "^8.3.1",
+    "node-gyp-build": "^4.8.4"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.28.0",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^24.0.1",
+    "@typescript-eslint/eslint-plugin": "^8.34.0",
+    "@typescript-eslint/parser": "^8.34.0",
+    "cross-env": "^7.0.3",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.28.0",
+    "eslint-plugin-regexp": "^2.9.0",
+    "globals": "^16.2.0",
+    "jest": "^29.7.0",
+    "node-gyp": "^11.2.0",
+    "npm-run-all": "4.1.5",
+    "prebuildify": "^6.0.1",
+    "prettier": "^3.5.3",
+    "prettier-plugin-organize-imports": "^4.1.0",
+    "release-it": "^19.0.3",
+    "snyk": "^1.1297.1",
+    "ts-jest": "^29.3.4",
+    "tsup": "^8.5.0",
+    "tsx": "^4.20.1",
+    "typedoc": "^0.28.5",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.34.0"
+  },
+  "versions": {
+    "nodejs": "v24.2.1@b854f4d",
+    "sqlite": "3.50.1"
+  }
+}

package/scripts/post-build.mjs

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+
+import { copyFile } from "fs/promises";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const distDir = join(__dirname, "..", "dist");
+
+// Copy .d.ts to .d.cts for CommonJS type safety
+async function createCjsTypes() {
+  try {
+    await copyFile(join(distDir, "index.d.ts"), join(distDir, "index.d.cts"));
+    console.log("Created index.d.cts for CommonJS type safety");
+  } catch (error) {
+    console.error("Error creating .d.cts file:", error);
+    process.exit(1);
+  }
+}
+
+createCjsTypes();

package/scripts/prebuild-linux-glibc.sh

@@ -0,0 +1,108 @@
+#!/bin/bash
+# Build native module with portable GLIBC compatibility
+# Uses Debian 11 Bullseye (GLIBC 2.31) to balance compatibility and modern toolchain
+#
+# GLIBC versions in official Node.js Docker images:
+# - node:*-buster:   GLIBC 2.28 (Debian 10) - Python 3.7, GCC 8.3 (too old)
+# - node:*-bullseye: GLIBC 2.31 (Debian 11) - Python 3.9, GCC 10.2 (good balance)
+# - node:*-bookworm: GLIBC 2.36 (Debian 12) - Python 3.11, GCC 12.2
+# - node:* (default): GLIBC 2.36 (Debian 12 Bookworm)
+# - node:*-alpine:   musl libc (not GLIBC)
+#
+# Other common environments:
+# - Ubuntu 20.04 LTS: GLIBC 2.31 (matches our target)
+# - Ubuntu 22.04 LTS: GLIBC 2.35
+# - CentOS 7:         GLIBC 2.17 (EOL, not supported)
+# - Amazon Linux 2:   GLIBC 2.26 (older, but should work)
+#
+# By targeting GLIBC 2.31, we support Ubuntu 20.04 LTS and newer,
+# while having a modern enough toolchain for Node.js requirements.
+
+set -euo pipefail
+
+# Allow architecture override (for CI cross-compilation)
+TARGET_ARCH="${TARGET_ARCH:-}"
+
+# If no target architecture specified, detect from host
+if [ -z "$TARGET_ARCH" ]; then
+  ARCH=$(uname -m)
+  if [ "$ARCH" = "x86_64" ]; then
+    TARGET_ARCH="x64"
+  elif [ "$ARCH" = "aarch64" ]; then
+    TARGET_ARCH="arm64"
+  else
+    echo "Unsupported architecture: $ARCH"
+    exit 1
+  fi
+fi
+
+# Map to Docker platform architecture
+if [ "$TARGET_ARCH" = "x64" ]; then
+  DOCKER_ARCH="amd64"
+elif [ "$TARGET_ARCH" = "arm64" ]; then
+  DOCKER_ARCH="arm64"
+else
+  echo "Unsupported target architecture: $TARGET_ARCH"
+  exit 1
+fi
+
+# Determine which build command to use
+BUILD_CMD="${BUILD_CMD:-npm run build:native}"
+
+# Check if we're already in a compatible environment
+if [ -f /etc/os-release ]; then
+  . /etc/os-release
+  if [[ "${ID:-}" == "debian" && "${VERSION_ID:-}" == "11" ]]; then
+    echo "Already in Debian 11 Bullseye, building directly..."
+    $BUILD_CMD
+    exit 0
+  fi
+fi
+
+# Check if Docker is available
+if ! command -v docker &> /dev/null; then
+  echo "Docker not found, falling back to local build"
+  echo "Warning: Binary may not be portable due to GLIBC version"
+  $BUILD_CMD
+  exit 0
+fi
+
+echo "Building native module in Debian 11 Bullseye container for GLIBC 2.31 compatibility..."
+echo "Target architecture: $TARGET_ARCH (Docker platform: linux/$DOCKER_ARCH)"
+
+# Create a container, build inside it, then copy artifacts out
+CONTAINER_NAME="node-sqlite-build-$$"
+
+# Start container in background
+docker run -d \
+  --name "$CONTAINER_NAME" \
+  --platform "linux/$DOCKER_ARCH" \
+  node:20-bullseye \
+  sleep 3600
+
+# Copy project files into container
+docker cp . "$CONTAINER_NAME:/tmp/project"
+
+# Run build inside container
+# Debian 11 has Python 3.9 and GCC 10.2 which support our requirements
+docker exec "$CONTAINER_NAME" sh -c "
+  cd /tmp/project && \
+  apt-get update -qq && \
+  apt-get install -y -qq build-essential python3 && \
+  # Verify versions
+  echo 'Python version:' && python3 --version && \
+  echo 'GCC version:' && gcc --version | head -1 && \
+  # Build the project
+  npm ci --ignore-scripts && \
+  $BUILD_CMD
+"
+
+# Copy artifacts back with proper ownership
+docker cp "$CONTAINER_NAME:/tmp/project/prebuilds" . 2>/dev/null || true
+docker cp "$CONTAINER_NAME:/tmp/project/build" . 2>/dev/null || true
+docker cp "$CONTAINER_NAME:/tmp/project/config.gypi" . 2>/dev/null || true
+
+# Clean up container
+docker rm -f "$CONTAINER_NAME" >/dev/null
+
+echo "Portable build complete!"