@loradb/lora-node 0.8.5 → 0.10.1

package/README.md

@@ -98,7 +98,7 @@ and batches fsyncs for write-heavy workloads. Call `await db.sync()` when you
 need an immediate durability boundary before copying the portable `.loradb`
 archive while the database is still open.
 
-Node also has an archive-backed convenience overload:
+Node also has a container-backed convenience overload:
 
 ```ts
 import { createDatabase } from "@loradb/lora-node";
@@ -257,7 +257,7 @@ See `ts/types.ts` (`LoraErrorCode`) for the full list.
   path would require extending the value serializer.
 - **Cancellation.** The napi `Task` abstraction does not support
   cancellation once dispatched; a runaway query runs to completion.
-- **WAL surface.** Node persistence exposes archive-backed initialization,
+- **WAL surface.** Node persistence exposes container-backed initialization,
   `syncMode: "groupSync"`, and `db.sync()`. Checkpoint, truncate,
   and status controls are not exposed yet.
 - **Archive ownership.** One archive can only be open by one writer process at a

package/dist/index.d.ts

@@ -8,7 +8,7 @@
  * shapes defined in the shared TS contract (`crates/bindings/shared-ts/types.ts`).
  *
  * **Initialization is async-only.** The canonical entry point is
- * `createDatabase(...)`, optionally with archive-backed persistence. There is no
+ * `createDatabase(...)`, optionally with container-backed persistence. There is no
  * synchronous constructor. See the docs at
  * https://loradb.com/docs/getting-started/node for the full rationale.
  */
@@ -79,7 +79,7 @@ export type NodeSnapshotSaveTarget = string | URL | NodeSnapshotSaveOptions | Sn
 export interface CreateDatabaseOptions {
     databaseDir?: string;
     /**
-     * Durability mode for archive-backed databases.
+     * Durability mode for container-backed databases.
      *
      * - `groupSync` writes WAL bytes before `execute()` resolves and batches
      *   fsyncs on a short background cadence. This is the default.
@@ -186,7 +186,7 @@ declare class DatabaseImpl {
      */
     transaction<T extends Record<string, LoraValue> = Record<string, LoraValue>>(statements: TransactionStatement[], mode?: TransactionMode): Promise<Array<QueryResult<T>>>;
     /**
-     * Force pending WAL bytes and archive updates to disk.
+     * Force pending WAL bytes and container updates to disk.
      *
      * The default `groupSync` mode writes WAL bytes before `execute()` resolves
      * and batches fsyncs for speed; call `sync()` when you need an immediate
@@ -203,7 +203,7 @@ declare class DatabaseImpl {
     /**
      * Release the native database handle. Idempotent.
      *
-     * Call this when an archive-backed database needs to be reopened in the same
+     * Call this when a container-backed database needs to be reopened in the same
      * process. New operations after disposal reject with `database is closed`.
      */
     dispose(): void;

package/dist/index.js

@@ -9,7 +9,7 @@
  * shapes defined in the shared TS contract (`crates/bindings/shared-ts/types.ts`).
  *
  * **Initialization is async-only.** The canonical entry point is
- * `createDatabase(...)`, optionally with archive-backed persistence. There is no
+ * `createDatabase(...)`, optionally with container-backed persistence. There is no
  * synchronous constructor. See the docs at
  * https://loradb.com/docs/getting-started/node for the full rationale.
  */
@@ -339,7 +339,7 @@ class DatabaseImpl {
         }
     }
     /**
-     * Force pending WAL bytes and archive updates to disk.
+     * Force pending WAL bytes and container updates to disk.
      *
      * The default `groupSync` mode writes WAL bytes before `execute()` resolves
      * and batches fsyncs for speed; call `sync()` when you need an immediate
@@ -384,7 +384,7 @@ class DatabaseImpl {
     /**
      * Release the native database handle. Idempotent.
      *
-     * Call this when an archive-backed database needs to be reopened in the same
+     * Call this when a container-backed database needs to be reopened in the same
      * process. New operations after disposal reject with `database is closed`.
      */
     dispose() {

package/dist/native.js

@@ -12,8 +12,12 @@
 // subpackage named `@loradb/lora-node-<triple>`; local dev builds drop the
 // `.node` at the crate root. We try both.
 "use strict";
+// Intentional CJS module: the file uses `require()` to dynamically
+// resolve `.node` binaries based on platform/arch, which is a CJS-only
+// pattern. ESM `import` can't load `.node` addons by path at runtime.
+/* eslint-disable @typescript-eslint/no-require-imports */
 const { platform, arch } = process;
-const { existsSync, readFileSync } = require("node:fs");
+const { existsSync } = require("node:fs");
 const { join } = require("node:path");
 const { execSync } = require("node:child_process");
 function isMuslLibc() {

package/dist/native.js.map

@@ -1 +1 @@
-{"version":3,"file":"native.js","sourceRoot":"","sources":["../ts/native.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../ts/native.js"],"names":[],"mappings":"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"}

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@loradb/lora-node",
-  "version": "0.8.5",
+  "version": "0.10.1",
   "description": "Node.js / TypeScript bindings for the Lora in-memory graph database",
   "license": "BUSL-1.1",
+  "packageManager": "yarn@4.5.1",
   "author": "LoraDB, Inc.",
   "homepage": "https://github.com/lora-db/lora#readme",
   "repository": {
@@ -65,35 +66,37 @@
   },
   "scripts": {
     "sync:types": "node -e \"const fs=require('fs'); for (const f of ['types.ts','decode.ts']) fs.copyFileSync('../shared-ts/' + f, 'ts/' + f);\"",
-    "verify:types": "node -e \"const fs=require('fs'); for (const f of ['types.ts','decode.ts']) { const a=fs.readFileSync('../shared-ts/' + f,'utf8'); const b=fs.readFileSync('ts/' + f,'utf8'); if (a!==b) { console.error('ts/' + f + ' is out of sync with shared-ts/' + f + ' — run npm run sync:types'); process.exit(1);} } \"",
-    "prebuild": "npm run sync:types",
-    "pretypecheck": "npm run sync:types",
-    "pretest": "npm run sync:types",
+    "verify:types": "node -e \"const fs=require('fs'); for (const f of ['types.ts','decode.ts']) { const a=fs.readFileSync('../shared-ts/' + f,'utf8'); const b=fs.readFileSync('ts/' + f,'utf8'); if (a!==b) { console.error('ts/' + f + ' is out of sync with shared-ts/' + f + ' — run yarn run sync:types'); process.exit(1);} } \"",
+    "prebuild": "yarn run sync:types",
+    "pretypecheck": "yarn run sync:types",
+    "pretest": "yarn run sync:types",
     "build:native": "napi build --platform --release --js false",
     "build:native:debug": "napi build --platform --js false",
     "build:ts": "tsc -p tsconfig.json",
-    "build": "npm run build:native && npm run build:ts",
+    "build": "yarn run build:native && yarn run build:ts",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",
+    "lint": "eslint ts test",
     "bench": "node bench/run.mjs",
     "artifacts": "napi artifacts",
     "create-npm-dirs": "napi create-npm-dir -t .",
     "copy-license": "node -e \"const fs=require('fs'); try { fs.copyFileSync('../../../LICENSE','LICENSE'); } catch (e) { if (e.code !== 'ENOENT') throw e; }\"",
-    "prepack": "npm run sync:types && npm run copy-license && npm run build",
+    "prepack": "yarn run sync:types && yarn run copy-license && yarn run build",
     "pack:dry": "npm pack --dry-run"
   },
   "devDependencies": {
     "@napi-rs/cli": "^2.18.4",
     "@types/node": "^22.7.4",
+    "eslint": "^9.15.0",
     "typescript": "^5.6.2",
     "vitest": "^2.1.1"
   },
   "optionalDependencies": {
-    "@loradb/lora-node-linux-x64-gnu": "0.8.5",
-    "@loradb/lora-node-linux-arm64-gnu": "0.8.5",
-    "@loradb/lora-node-darwin-x64": "0.8.5",
-    "@loradb/lora-node-darwin-arm64": "0.8.5",
-    "@loradb/lora-node-win32-x64-msvc": "0.8.5"
+    "@loradb/lora-node-linux-x64-gnu": "0.10.1",
+    "@loradb/lora-node-linux-arm64-gnu": "0.10.1",
+    "@loradb/lora-node-darwin-x64": "0.10.1",
+    "@loradb/lora-node-darwin-arm64": "0.10.1",
+    "@loradb/lora-node-win32-x64-msvc": "0.10.1"
   }
 }

package/ts/native.d.ts

@@ -62,7 +62,7 @@ export declare class Database {
     statements: Array<{ query: string; params?: Record<string, unknown> | null }>,
     mode?: "read_write" | "read_only" | "readwrite" | "readonly" | "rw" | "ro" | null,
   ): Promise<Buffer[]>;
-  /** Force pending WAL bytes and the portable archive mirror to disk. */
+  /** Force pending WAL bytes and the portable container mirror to disk. */
   sync(): Promise<void>;
   clear(): Promise<void>;
   nodeCount(): number;

package/ts/native.js

@@ -14,8 +14,13 @@
 
 "use strict";
 
+// Intentional CJS module: the file uses `require()` to dynamically
+// resolve `.node` binaries based on platform/arch, which is a CJS-only
+// pattern. ESM `import` can't load `.node` addons by path at runtime.
+/* eslint-disable @typescript-eslint/no-require-imports */
+
 const { platform, arch } = process;
-const { existsSync, readFileSync } = require("node:fs");
+const { existsSync } = require("node:fs");
 const { join } = require("node:path");
 const { execSync } = require("node:child_process");