@delali/sirannon-db 0.1.3 → 0.1.5

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@delali/sirannon-db",
   "type": "module",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "A production-grade library that turns SQLite databases into a networked data layer with real-time subscriptions.",
   "author": "Delali (https://sondelali.com)",
   "license": "Apache-2.0",
@@ -22,13 +22,42 @@
     "subscriptions",
     "websocket",
     "embedded",
-    "better-sqlite3"
+    "better-sqlite3",
+    "wa-sqlite",
+    "expo-sqlite",
+    "pluggable"
   ],
   "exports": {
     ".": {
       "types": "./dist/core/index.d.ts",
       "import": "./dist/core/index.mjs"
     },
+    "./driver/better-sqlite3": {
+      "types": "./dist/driver/better-sqlite3.d.ts",
+      "import": "./dist/driver/better-sqlite3.mjs"
+    },
+    "./driver/node": {
+      "types": "./dist/driver/node.d.ts",
+      "import": "./dist/driver/node.mjs"
+    },
+    "./driver/bun": {
+      "import": "./dist/driver/bun.mjs"
+    },
+    "./driver/wa-sqlite": {
+      "types": "./dist/driver/wa-sqlite.d.ts",
+      "import": "./dist/driver/wa-sqlite.mjs"
+    },
+    "./driver/expo": {
+      "import": "./dist/driver/expo.mjs"
+    },
+    "./file-migrations": {
+      "types": "./dist/file-migrations/index.d.ts",
+      "import": "./dist/file-migrations/index.mjs"
+    },
+    "./backup-scheduler": {
+      "types": "./dist/backup-scheduler/index.d.ts",
+      "import": "./dist/backup-scheduler/index.mjs"
+    },
     "./server": {
       "types": "./dist/server/index.d.ts",
       "import": "./dist/server/index.mjs"
@@ -36,6 +65,22 @@
     "./client": {
       "types": "./dist/client/index.d.ts",
       "import": "./dist/client/index.mjs"
+    },
+    "./replication": {
+      "types": "./dist/replication/index.d.ts",
+      "import": "./dist/replication/index.mjs"
+    },
+    "./replication/coordinator/etcd": {
+      "types": "./dist/replication/coordinator/etcd.d.ts",
+      "import": "./dist/replication/coordinator/etcd.mjs"
+    },
+    "./transport/memory": {
+      "types": "./dist/transport/memory.d.ts",
+      "import": "./dist/transport/memory.mjs"
+    },
+    "./transport/grpc": {
+      "types": "./dist/transport/grpc.d.ts",
+      "import": "./dist/transport/grpc.mjs"
     }
   },
   "files": [
@@ -46,29 +91,77 @@
   "engines": {
     "node": ">=22"
   },
-  "dependencies": {
-    "better-sqlite3": "12.6.2",
-    "croner": "10.0.1",
-    "uWebSockets.js": "github:uNetworking/uWebSockets.js#v20.58.0"
+  "peerDependencies": {
+    "@bufbuild/protobuf": ">=2.0.0",
+    "@grpc/grpc-js": ">=1.10.0",
+    "better-sqlite3": ">=12.0.0",
+    "croner": ">=10.0.0",
+    "expo-sqlite": ">=14.0.0",
+    "etcd3": ">=1.1.2",
+    "grpc-health-check": ">=2.0.0",
+    "uWebSockets.js": ">=20.0.0",
+    "wa-sqlite": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@bufbuild/protobuf": {
+      "optional": true
+    },
+    "@grpc/grpc-js": {
+      "optional": true
+    },
+    "better-sqlite3": {
+      "optional": true
+    },
+    "croner": {
+      "optional": true
+    },
+    "expo-sqlite": {
+      "optional": true
+    },
+    "etcd3": {
+      "optional": true
+    },
+    "grpc-health-check": {
+      "optional": true
+    },
+    "uWebSockets.js": {
+      "optional": true
+    },
+    "wa-sqlite": {
+      "optional": true
+    }
   },
   "devDependencies": {
+    "@bufbuild/protobuf": "2.11.0",
+    "@grpc/grpc-js": "1.14.3",
     "@types/better-sqlite3": "7.6.13",
     "@types/node": "25.3.3",
-    "@types/pg": "8.11.10",
+    "@types/pg": "8.20.0",
     "@vitest/coverage-v8": "4.0.18",
-    "pg": "8.19.0",
+    "better-sqlite3": "12.6.2",
+    "croner": "10.0.1",
+    "etcd3": "1.1.2",
+    "grpc-health-check": "2.1.0",
+    "grpc-tools": "1.13.1",
+    "pg": "8.20.0",
+    "selfsigned": "5.5.0",
     "simple-statistics": "7.8.7",
     "tinybench": "6.0.0",
+    "ts-proto": "2.11.6",
     "tsup": "8.5.1",
     "tsx": "4.21.0",
     "typescript": "5.9.3",
+    "uWebSockets.js": "github:uNetworking/uWebSockets.js#v20.58.0",
     "vitest": "4.0.18"
   },
   "scripts": {
-    "build": "tsup",
+    "build": "rm -rf dist && tsup",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
-    "typecheck": "tsc --noEmit",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "test:failover": "vitest run --config vitest.failover.config.ts",
+    "test:soak": "vitest run --config vitest.soak.config.ts",
+    "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test.json",
     "lint": "biome check .",
     "lint:fix": "biome check --write .",
     "format": "biome format --write .",
@@ -77,11 +170,13 @@
     "bench:ycsb": "node --expose-gc --import tsx benchmarks/ycsb/workload-a.ts",
     "bench:oltp": "node --expose-gc --import tsx benchmarks/oltp/tpc-c-lite.ts",
     "bench:scaling": "node --expose-gc --import tsx benchmarks/scaling/concurrency.ts",
+    "bench:pool": "node --expose-gc --import tsx benchmarks/scaling/pool-sweep.ts",
     "bench:cdc": "node --expose-gc --import tsx benchmarks/sirannon/cdc-latency.ts",
     "bench:docker": "node --import tsx benchmarks/run-docker.ts",
     "bench:docker:e2e": "node --import tsx benchmarks/run-e2e.ts",
     "bench:docker:engine": "node --expose-gc --import tsx benchmarks/run-engine.ts",
     "bench:statistical": "node --expose-gc --import tsx benchmarks/run-statistical.ts",
-    "bench:charts": "python3 benchmarks/scripts/generate-charts.py benchmarks/results/"
+    "bench:charts": "python3 benchmarks/scripts/generate-charts.py benchmarks/results/",
+    "proto:gen": "grpc_tools_node_protoc --plugin=protoc-gen-ts_proto=./node_modules/.bin/protoc-gen-ts_proto --ts_proto_out=src/transport/grpc/generated --ts_proto_opt=forceLong=bigint --ts_proto_opt=esModuleInterop=true --ts_proto_opt=outputServices=grpc-js --ts_proto_opt=env=node -I src/transport/grpc/proto src/transport/grpc/proto/replication.proto"
   }
 }

package/dist/chunk-VI4UP4RR.mjs

@@ -1,417 +0,0 @@
-// src/core/errors.ts
-var SirannonError = class extends Error {
-  constructor(message, code) {
-    super(message);
-    this.code = code;
-    this.name = "SirannonError";
-  }
-};
-var DatabaseNotFoundError = class extends SirannonError {
-  constructor(id) {
-    super(`Database '${id}' not found`, "DATABASE_NOT_FOUND");
-    this.name = "DatabaseNotFoundError";
-  }
-};
-var DatabaseAlreadyExistsError = class extends SirannonError {
-  constructor(id) {
-    super(`Database '${id}' already exists`, "DATABASE_ALREADY_EXISTS");
-    this.name = "DatabaseAlreadyExistsError";
-  }
-};
-var ReadOnlyError = class extends SirannonError {
-  constructor(id) {
-    super(`Database '${id}' is read-only`, "READ_ONLY");
-    this.name = "ReadOnlyError";
-  }
-};
-var QueryError = class extends SirannonError {
-  constructor(message, sql) {
-    super(message, "QUERY_ERROR");
-    this.sql = sql;
-    this.name = "QueryError";
-  }
-};
-var TransactionError = class extends SirannonError {
-  constructor(message) {
-    super(message, "TRANSACTION_ERROR");
-    this.name = "TransactionError";
-  }
-};
-var MigrationError = class extends SirannonError {
-  constructor(message, version, code = "MIGRATION_ERROR") {
-    super(message, code);
-    this.version = version;
-    this.name = "MigrationError";
-  }
-};
-var HookDeniedError = class extends SirannonError {
-  constructor(hookName, reason) {
-    super(
-      reason ? `Hook '${hookName}' denied the operation: ${reason}` : `Hook '${hookName}' denied the operation`,
-      "HOOK_DENIED"
-    );
-    this.name = "HookDeniedError";
-  }
-};
-var CDCError = class extends SirannonError {
-  constructor(message) {
-    super(message, "CDC_ERROR");
-    this.name = "CDCError";
-  }
-};
-var BackupError = class extends SirannonError {
-  constructor(message) {
-    super(message, "BACKUP_ERROR");
-    this.name = "BackupError";
-  }
-};
-var ConnectionPoolError = class extends SirannonError {
-  constructor(message) {
-    super(message, "CONNECTION_POOL_ERROR");
-    this.name = "ConnectionPoolError";
-  }
-};
-var MaxDatabasesError = class extends SirannonError {
-  constructor(max) {
-    super(`Maximum number of open databases (${max}) reached`, "MAX_DATABASES");
-    this.name = "MaxDatabasesError";
-  }
-};
-var ExtensionError = class extends SirannonError {
-  constructor(path, cause) {
-    super(
-      cause ? `Failed to load extension '${path}': ${cause}` : `Failed to load extension '${path}'`,
-      "EXTENSION_ERROR"
-    );
-    this.name = "ExtensionError";
-  }
-};
-
-// src/core/cdc/change-tracker.ts
-var DEFAULT_RETENTION_MS = 36e5;
-var DEFAULT_CHANGES_TABLE = "_sirannon_changes";
-var DEFAULT_POLL_BATCH_SIZE = 1e3;
-var IDENTIFIER_RE = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
-var ChangeTracker = class {
-  watched = /* @__PURE__ */ new Map();
-  lastSeq = 0;
-  retentionMs;
-  changesTable;
-  pollBatchSize;
-  changesTableReady = false;
-  watchedTablesCache = null;
-  stmtCache = /* @__PURE__ */ new WeakMap();
-  constructor(options) {
-    this.retentionMs = options?.retention ?? DEFAULT_RETENTION_MS;
-    this.changesTable = options?.changesTable ?? DEFAULT_CHANGES_TABLE;
-    this.pollBatchSize = options?.pollBatchSize ?? DEFAULT_POLL_BATCH_SIZE;
-    this.assertIdentifier(this.changesTable, "changes table name");
-  }
-  watch(db, table) {
-    this.assertIdentifier(table, "table name");
-    this.ensureChangesTable(db);
-    const columns = this.getColumns(db, table);
-    if (columns.length === 0) {
-      throw new CDCError(`Table '${table}' does not exist or has no columns`);
-    }
-    for (const col of columns) {
-      this.assertIdentifier(col, `column name in table '${table}'`);
-    }
-    const pkColumns = this.getPkColumns(db, table);
-    const existing = this.watched.get(table);
-    if (existing) {
-      const same = existing.columns.length === columns.length && existing.columns.every((col, i) => col === columns[i]);
-      if (same) {
-        return;
-      }
-      this.dropTriggers(db, table);
-    }
-    this.installTriggers(db, table, columns, pkColumns);
-    this.watched.set(table, { table, columns, pkColumns });
-    this.watchedTablesCache = null;
-  }
-  unwatch(db, table) {
-    if (!this.watched.has(table)) {
-      return;
-    }
-    this.dropTriggers(db, table);
-    this.watched.delete(table);
-    this.watchedTablesCache = null;
-  }
-  poll(db) {
-    if (!this.changesTableReady) {
-      this.detectChangesTable(db);
-      if (!this.changesTableReady) {
-        return [];
-      }
-    }
-    const stmt = this.getStmt(
-      db,
-      "poll",
-      `SELECT seq, table_name, operation, row_id, changed_at, old_data, new_data
-			 FROM "${this.changesTable}"
-			 WHERE seq > ?
-			 ORDER BY seq ASC
-			 LIMIT ?`
-    );
-    const rows = stmt.all(this.lastSeq, this.pollBatchSize);
-    if (rows.length === 0) {
-      return [];
-    }
-    const events = [];
-    for (const row of rows) {
-      events.push({
-        type: row.operation.toLowerCase(),
-        table: row.table_name,
-        row: row.new_data ? JSON.parse(row.new_data) : {},
-        oldRow: row.old_data ? JSON.parse(row.old_data) : void 0,
-        seq: BigInt(row.seq),
-        timestamp: row.changed_at
-      });
-    }
-    this.lastSeq = rows[rows.length - 1].seq;
-    return events;
-  }
-  cleanup(db) {
-    if (!this.changesTableReady) {
-      this.detectChangesTable(db);
-      if (!this.changesTableReady) {
-        return 0;
-      }
-    }
-    const cutoff = Date.now() / 1e3 - this.retentionMs / 1e3;
-    if (this.lastSeq > 0) {
-      const stmt2 = this.getStmt(
-        db,
-        "cleanup_coordinated",
-        `DELETE FROM "${this.changesTable}" WHERE changed_at < ? AND seq <= ?`
-      );
-      return stmt2.run(cutoff, this.lastSeq).changes;
-    }
-    const stmt = this.getStmt(db, "cleanup", `DELETE FROM "${this.changesTable}" WHERE changed_at < ?`);
-    return stmt.run(cutoff).changes;
-  }
-  get watchedTables() {
-    if (!this.watchedTablesCache) {
-      this.watchedTablesCache = new Set(this.watched.keys());
-    }
-    return this.watchedTablesCache;
-  }
-  assertIdentifier(name, label) {
-    if (!IDENTIFIER_RE.test(name)) {
-      throw new CDCError(
-        `Invalid ${label} '${name}': must contain only letters, digits, and underscores, and start with a letter or underscore`
-      );
-    }
-  }
-  detectChangesTable(db) {
-    const row = db.prepare("SELECT 1 FROM sqlite_master WHERE type='table' AND name=?").get(this.changesTable);
-    if (row) {
-      this.changesTableReady = true;
-    }
-  }
-  ensureChangesTable(db) {
-    if (this.changesTableReady) {
-      return;
-    }
-    db.exec(`
-CREATE TABLE IF NOT EXISTS "${this.changesTable}" (
-  seq INTEGER PRIMARY KEY AUTOINCREMENT,
-  table_name TEXT NOT NULL,
-  operation TEXT NOT NULL,
-  row_id TEXT NOT NULL,
-  changed_at REAL NOT NULL DEFAULT (unixepoch('subsec')),
-  old_data TEXT,
-  new_data TEXT
-)`);
-    db.exec(`CREATE INDEX IF NOT EXISTS "idx_${this.changesTable}_changed_at" ON "${this.changesTable}" (changed_at)`);
-    this.changesTableReady = true;
-  }
-  getColumns(db, table) {
-    const info = db.prepare(`PRAGMA table_info("${table}")`).all();
-    return info.map((col) => col.name);
-  }
-  getPkColumns(db, table) {
-    const info = db.prepare(`PRAGMA table_info("${table}")`).all();
-    return info.filter((col) => col.pk > 0).sort((a, b) => a.pk - b.pk).map((col) => col.name);
-  }
-  dropTriggers(db, table) {
-    db.exec(`DROP TRIGGER IF EXISTS "_sirannon_trg_${table}_insert"`);
-    db.exec(`DROP TRIGGER IF EXISTS "_sirannon_trg_${table}_update"`);
-    db.exec(`DROP TRIGGER IF EXISTS "_sirannon_trg_${table}_delete"`);
-  }
-  getStmt(db, key, sql) {
-    let stmts = this.stmtCache.get(db);
-    if (!stmts) {
-      stmts = /* @__PURE__ */ new Map();
-      this.stmtCache.set(db, stmts);
-    }
-    let stmt = stmts.get(key);
-    if (!stmt) {
-      stmt = db.prepare(sql);
-      stmts.set(key, stmt);
-    }
-    return stmt;
-  }
-  buildPkRef(pkColumns, ref) {
-    if (pkColumns.length === 0) {
-      return `${ref}.rowid`;
-    }
-    if (pkColumns.length === 1) {
-      return `${ref}."${this.escId(pkColumns[0])}"`;
-    }
-    return pkColumns.map((col) => `${ref}."${this.escId(col)}"`).join(" || '-' || ");
-  }
-  installTriggers(db, table, columns, pkColumns) {
-    const newJson = this.buildJsonObject(columns, "NEW");
-    const oldJson = this.buildJsonObject(columns, "OLD");
-    const newPk = this.buildPkRef(pkColumns, "NEW");
-    const oldPk = this.buildPkRef(pkColumns, "OLD");
-    db.exec(`
-			CREATE TRIGGER IF NOT EXISTS "_sirannon_trg_${table}_insert"
-			AFTER INSERT ON "${table}"
-			BEGIN
-				INSERT INTO "${this.changesTable}" (table_name, operation, row_id, new_data)
-				VALUES ('${table}', 'INSERT', ${newPk}, ${newJson});
-			END
-		`);
-    db.exec(`
-			CREATE TRIGGER IF NOT EXISTS "_sirannon_trg_${table}_update"
-			AFTER UPDATE ON "${table}"
-			BEGIN
-				INSERT INTO "${this.changesTable}" (table_name, operation, row_id, old_data, new_data)
-				VALUES ('${table}', 'UPDATE', ${newPk}, ${oldJson}, ${newJson});
-			END
-		`);
-    db.exec(`
-			CREATE TRIGGER IF NOT EXISTS "_sirannon_trg_${table}_delete"
-			AFTER DELETE ON "${table}"
-			BEGIN
-				INSERT INTO "${this.changesTable}" (table_name, operation, row_id, old_data)
-				VALUES ('${table}', 'DELETE', ${oldPk}, ${oldJson});
-			END
-		`);
-  }
-  buildJsonObject(columns, ref) {
-    const pairs = columns.map((col) => `'${this.escStr(col)}', ${ref}."${this.escId(col)}"`).join(", ");
-    return `json_object(${pairs})`;
-  }
-  escId(name) {
-    return name.replace(/"/g, '""');
-  }
-  escStr(name) {
-    return name.replace(/'/g, "''");
-  }
-};
-
-// src/core/cdc/subscription.ts
-var SubscriptionManager = class {
-  nextId = 1;
-  subscriptions = /* @__PURE__ */ new Map();
-  byTable = /* @__PURE__ */ new Map();
-  subscribe(table, filter, callback) {
-    const id = this.nextId++;
-    this.subscriptions.set(id, { id, table, filter, callback });
-    let tableSet = this.byTable.get(table);
-    if (!tableSet) {
-      tableSet = /* @__PURE__ */ new Set();
-      this.byTable.set(table, tableSet);
-    }
-    tableSet.add(id);
-    return {
-      unsubscribe: () => {
-        this.subscriptions.delete(id);
-        const set = this.byTable.get(table);
-        if (set) {
-          set.delete(id);
-          if (set.size === 0) {
-            this.byTable.delete(table);
-          }
-        }
-      }
-    };
-  }
-  dispatch(events) {
-    for (const event of events) {
-      const ids = this.byTable.get(event.table);
-      if (!ids) continue;
-      for (const id of ids) {
-        const sub = this.subscriptions.get(id);
-        if (!sub) continue;
-        if (sub.filter && !matchesFilter(event, sub.filter)) {
-          continue;
-        }
-        try {
-          sub.callback(event);
-        } catch {
-        }
-      }
-    }
-  }
-  get size() {
-    return this.subscriptions.size;
-  }
-  subscriberCount(table) {
-    return this.byTable.get(table)?.size ?? 0;
-  }
-};
-var SubscriptionBuilderImpl = class {
-  constructor(table, manager) {
-    this.table = table;
-    this.manager = manager;
-  }
-  conditions;
-  filter(conditions) {
-    this.conditions = { ...this.conditions, ...conditions };
-    return this;
-  }
-  subscribe(callback) {
-    return this.manager.subscribe(this.table, this.conditions, callback);
-  }
-};
-function startPolling(db, tracker, manager, intervalMs, onError) {
-  let consecutiveErrors = 0;
-  let tickCount = 0;
-  const MAX_CONSECUTIVE_ERRORS = 10;
-  const CLEANUP_INTERVAL_TICKS = 100;
-  const tick = () => {
-    if (manager.size === 0) return;
-    try {
-      const events = tracker.poll(db);
-      if (events.length > 0) {
-        manager.dispatch(events);
-      }
-      consecutiveErrors = 0;
-      tickCount++;
-      if (tickCount >= CLEANUP_INTERVAL_TICKS) {
-        tickCount = 0;
-        tracker.cleanup(db);
-      }
-    } catch (err) {
-      consecutiveErrors++;
-      if (onError) {
-        onError(err instanceof Error ? err : new Error(String(err)));
-      }
-      if (consecutiveErrors >= MAX_CONSECUTIVE_ERRORS) {
-        stop();
-      }
-    }
-  };
-  const interval = setInterval(tick, intervalMs);
-  interval.unref();
-  const stop = () => {
-    clearInterval(interval);
-  };
-  return stop;
-}
-function matchesFilter(event, filter) {
-  const target = event.type === "delete" ? event.oldRow ?? {} : event.row;
-  for (const [key, value] of Object.entries(filter)) {
-    if (target[key] !== value) {
-      return false;
-    }
-  }
-  return true;
-}
-
-export { BackupError, CDCError, ChangeTracker, ConnectionPoolError, DatabaseAlreadyExistsError, DatabaseNotFoundError, ExtensionError, HookDeniedError, MaxDatabasesError, MigrationError, QueryError, ReadOnlyError, SirannonError, SubscriptionBuilderImpl, SubscriptionManager, TransactionError, startPolling };

package/dist/protocol-BX1H-_Mz.d.ts

@@ -1,104 +0,0 @@
-import { E as ExecuteResult } from './types-DArCObcu.js';
-
-/** Body for POST /db/:id/query */
-interface QueryRequest {
-    sql: string;
-    params?: Record<string, unknown> | unknown[];
-}
-/** Body for POST /db/:id/execute */
-interface ExecuteRequest {
-    sql: string;
-    params?: Record<string, unknown> | unknown[];
-}
-/** A single statement within a transaction batch. */
-interface TransactionStatement {
-    sql: string;
-    params?: Record<string, unknown> | unknown[];
-}
-/** Body for POST /db/:id/transaction */
-interface TransactionRequest {
-    statements: TransactionStatement[];
-}
-/** Response for a successful query. */
-interface QueryResponse {
-    rows: Record<string, unknown>[];
-}
-/** Response for a successful execute. */
-interface ExecuteResponse {
-    changes: number;
-    lastInsertRowId: number | string;
-}
-/** Response for a successful transaction. */
-interface TransactionResponse {
-    results: ExecuteResponse[];
-}
-/** Standard error response envelope. */
-interface ErrorResponse {
-    error: {
-        code: string;
-        message: string;
-    };
-}
-/** Inbound WS message types. */
-type WSClientMessage = WSSubscribeMessage | WSUnsubscribeMessage | WSQueryMessage | WSExecuteMessage;
-interface WSSubscribeMessage {
-    type: 'subscribe';
-    id: string;
-    table: string;
-    filter?: Record<string, unknown>;
-}
-interface WSUnsubscribeMessage {
-    type: 'unsubscribe';
-    id: string;
-}
-interface WSQueryMessage {
-    type: 'query';
-    id: string;
-    sql: string;
-    params?: Record<string, unknown> | unknown[];
-}
-interface WSExecuteMessage {
-    type: 'execute';
-    id: string;
-    sql: string;
-    params?: Record<string, unknown> | unknown[];
-}
-/** Outbound WS message types. */
-type WSServerMessage = WSSubscribedMessage | WSUnsubscribedMessage | WSChangeMessage | WSResultMessage | WSErrorMessage;
-interface WSSubscribedMessage {
-    type: 'subscribed';
-    id: string;
-}
-interface WSUnsubscribedMessage {
-    type: 'unsubscribed';
-    id: string;
-}
-interface WSChangeMessage {
-    type: 'change';
-    id: string;
-    event: {
-        type: 'insert' | 'update' | 'delete';
-        table: string;
-        row: Record<string, unknown>;
-        oldRow?: Record<string, unknown>;
-        seq: string;
-        timestamp: number;
-    };
-}
-interface WSResultMessage {
-    type: 'result';
-    id: string;
-    data: QueryResponse | ExecuteResponse;
-}
-interface WSErrorMessage {
-    type: 'error';
-    id: string;
-    error: {
-        code: string;
-        message: string;
-    };
-}
-/** Convert an ExecuteResult (with possible bigint) to a JSON-safe response. */
-declare function toExecuteResponse(result: ExecuteResult): ExecuteResponse;
-
-export { type ErrorResponse as E, type QueryRequest as Q, type TransactionRequest as T, type WSChangeMessage as W, type ExecuteRequest as a, type ExecuteResponse as b, type QueryResponse as c, type TransactionResponse as d, type TransactionStatement as e, type WSClientMessage as f, type WSErrorMessage as g, type WSExecuteMessage as h, type WSQueryMessage as i, type WSResultMessage as j, type WSServerMessage as k, type WSSubscribeMessage as l, type WSSubscribedMessage as m, type WSUnsubscribeMessage as n, type WSUnsubscribedMessage as o, toExecuteResponse as t };