@powersync/node 0.11.1 → 0.13.0

package/lib/db/options.d.ts

@@ -1,11 +1,27 @@
 import { type Worker } from 'node:worker_threads';
-import { SQLOpenOptions } from '@powersync/common';
+import { LockContext, SQLOpenOptions } from '@powersync/common';
 export type WorkerOpener = (...args: ConstructorParameters<typeof Worker>) => InstanceType<typeof Worker>;
+/**
+ * Use the [better-sqlite3](https://github.com/WiseLibs/better-sqlite3) package as a SQLite driver for PowerSync.
+ */
+export interface BetterSqlite3Options {
+    type: 'better-sqlite3';
+}
+/**
+ * Use the experimental `node:sqlite` interface as a SQLite driver for PowerSync.
+ *
+ * Note that this option is not currently tested and highly unstable.
+ */
+export interface NodeSqliteOptions {
+    type: 'node:sqlite';
+}
+export type NodeDatabaseImplementation = BetterSqlite3Options | NodeSqliteOptions;
 /**
  * The {@link SQLOpenOptions} available across all PowerSync SDKs for JavaScript extended with
  * Node.JS-specific options.
  */
 export interface NodeSQLOpenOptions extends SQLOpenOptions {
+    implementation?: NodeDatabaseImplementation;
     /**
      * The Node.JS SDK will use one worker to run writing queries and additional workers to run reads.
      * This option controls how many workers to use for reads.
@@ -19,4 +35,10 @@ export interface NodeSQLOpenOptions extends SQLOpenOptions {
      * @returns the resolved worker.
      */
     openWorker?: WorkerOpener;
+    /**
+     * Initializes a created database connection.
+     *
+     * This can be used to e.g. set encryption keys, if an encrypted database should be used.
+     */
+    initializeConnection?: (db: LockContext, isWriter: boolean) => Promise<void>;
 }

package/lib/utils/modules.d.ts

@@ -0,0 +1,2 @@
+export declare const isBundledToCommonJs: boolean;
+export declare function dynamicImport(path: string): Promise<any>;

package/lib/utils/modules.js

@@ -0,0 +1,5 @@
+// Note: When updating this file, always update module_commonjs.ts as well.
+export const isBundledToCommonJs = false;
+export async function dynamicImport(path) {
+    return await import(path);
+}

package/lib/utils/modules_commonjs.d.ts

@@ -0,0 +1,2 @@
+export declare const isBundledToCommonJs: boolean;
+export declare function dynamicImport(path: string): Promise<any>;

package/lib/utils/modules_commonjs.js

@@ -0,0 +1,6 @@
+// NOTE! Do not import this file directly! We have a rollup plugin that rewrites imports to modules.js to this file when
+// bundling to CommonJS.
+export const isBundledToCommonJs = true;
+export async function dynamicImport(path) {
+    return require(path);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powersync/node",
-  "version": "0.11.1",
+  "version": "0.13.0",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -47,18 +47,25 @@
   },
   "homepage": "https://docs.powersync.com/",
   "peerDependencies": {
-    "@powersync/common": "^1.40.0"
+    "@powersync/common": "^1.41.0",
+    "better-sqlite3": "12.x"
+  },
+  "peerDependenciesMeta": {
+    "better-sqlite3": {
+      "optional": true
+    }
   },
   "dependencies": {
-    "@powersync/better-sqlite3": "^0.2.0",
     "async-lock": "^1.4.0",
     "bson": "^6.6.0",
     "comlink": "^4.4.2",
     "undici": "^7.11.0",
-    "@powersync/common": "1.40.0"
+    "@powersync/common": "1.41.0"
   },
   "devDependencies": {
     "@types/async-lock": "^1.4.0",
+    "@types/node": "^24.2.0",
+    "better-sqlite3": "^12.2.0",
     "drizzle-orm": "^0.35.2",
     "rollup": "4.14.3",
     "typescript": "^5.5.3",
@@ -73,12 +80,12 @@
     "live data"
   ],
   "scripts": {
-    "install": "node download_core.js",
-    "build": "tsc -b && rollup --config",
-    "build:prod": "tsc -b --sourceMap false && rollup --config",
+    "prepare:core": "node download_core.js",
+    "build": " pnpm prepare:core && tsc -b && rollup --config",
+    "build:prod": "pnpm prepare:core && tsc -b --sourceMap false && rollup --config",
     "clean": "rm -rf lib dist tsconfig.tsbuildinfo",
     "watch": "tsc -b -w",
-    "test": "vitest",
+    "test": " pnpm prepare:core && vitest",
     "test:exports": "attw --pack . --ignore-rules no-resolution"
   }
 }