Add Node.js integration: package, tests, and CI

.github/workflows/node-tests.yaml

@@ -0,0 +1,31 @@
+on:
+  pull_request:
+  push:
+    branches: [pure-c-port]
+name: "node-integration-tests"
+jobs:
+  test:
+    name: Node.js on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        include:
+          - os: ubuntu-latest
+          - os: macos-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+
+      - name: Build extension
+        run: |
+          cd core
+          cmake -B build -DCMAKE_BUILD_TYPE=Release
+          cmake --build build
+
+      - name: Run Node.js integration tests
+        run: |
+          cd core
+          node --test test/integration.test.mjs

core/nodejs-helper.cjs

@@ -0,0 +1,4 @@
+// CJS entry point — see nodejs-helper.js for usage examples.
+const { join } = require("node:path");
+const extensionPath = join(__dirname, "dist", "crsqlite");
+module.exports = { extensionPath };

core/nodejs-helper.d.ts

@@ -1 +1,2 @@
+/** Absolute path to the cr-sqlite loadable extension (without file extension). */
 export declare const extensionPath: string;

core/nodejs-helper.js

@@ -1,7 +1,20 @@
-// Exports the path to the extension for those using
-// crsqlite in a Node.js environment.
-import * as url from "url";
-import { join } from "path";
-const __dirname = url.fileURLToPath(new URL(".", import.meta.url));
+// Exports the path to the cr-sqlite loadable extension.
+// Usage with node:sqlite (Node >= 22.5):
+//
+//   import { extensionPath } from '@anthropic/crsqlite';
+//   import { DatabaseSync } from 'node:sqlite';
+//   const db = new DatabaseSync(':memory:', { allowExtension: true });
+//   db.loadExtension(extensionPath);
+//
+// Usage with better-sqlite3:
+//
+//   import { extensionPath } from '@anthropic/crsqlite';
+//   import Database from 'better-sqlite3';
+//   const db = new Database(':memory:');
+//   db.loadExtension(extensionPath);
 
+import { fileURLToPath } from "node:url";
+import { join, dirname } from "node:path";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
 export const extensionPath = join(__dirname, "dist", "crsqlite");

core/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@anthropic/crsqlite",
+  "version": "0.1.0",
+  "description": "cr-sqlite loadable extension for Node.js — CRDT-based multi-master replication for SQLite",
+  "type": "module",
+  "main": "nodejs-helper.cjs",
+  "module": "nodejs-helper.js",
+  "exports": {
+    ".": {
+      "import": "./nodejs-helper.js",
+      "require": "./nodejs-helper.cjs"
+    }
+  },
+  "types": "nodejs-helper.d.ts",
+  "files": [
+    "nodejs-helper.js",
+    "nodejs-helper.cjs",
+    "nodejs-helper.d.ts",
+    "dist/"
+  ],
+  "scripts": {
+    "build": "cmake -B build -DCMAKE_BUILD_TYPE=Release && cmake --build build && mkdir -p dist && cp build/crsqlite.* dist/",
+    "test": "node --test test/integration.test.mjs",
+    "test:c": "cd build && ctest --output-on-failure"
+  },
+  "engines": {
+    "node": ">=22.5.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/shards-lang/cr-sqlite.git",
+    "directory": "core"
+  },
+  "keywords": [
+    "sqlite",
+    "crdt",
+    "replication",
+    "sync",
+    "multi-master",
+    "extension"
+  ]
+}