@delali/sirannon-db 0.1.8 → 0.2.1-next.18

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@delali/sirannon-db",
   "type": "module",
-  "version": "0.1.8",
+  "version": "0.2.1-next.18",
   "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",
@@ -27,6 +27,23 @@
     "expo-sqlite",
     "pluggable"
   ],
+  "scripts": {
+    "build": "rm -rf dist && tsup",
+    "check:bundle": "node scripts/assert-browser-bundle.mjs",
+    "check:types": "node scripts/assert-consumer-types.mjs",
+    "check:api": "node scripts/assert-api-reports.mjs",
+    "api:update": "node scripts/assert-api-reports.mjs --update",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "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 --error-on-warnings .",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write .",
+    "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"
+  },
   "exports": {
     ".": {
       "types": "./dist/core/index.d.ts",
@@ -41,6 +58,7 @@
       "import": "./dist/driver/node.mjs"
     },
     "./driver/bun": {
+      "types": "./dist/driver/bun.d.ts",
       "import": "./dist/driver/bun.mjs"
     },
     "./driver/wa-sqlite": {
@@ -48,6 +66,7 @@
       "import": "./dist/driver/wa-sqlite.mjs"
     },
     "./driver/expo": {
+      "types": "./dist/driver/expo.d.ts",
       "import": "./dist/driver/expo.mjs"
     },
     "./file-migrations": {
@@ -66,6 +85,18 @@
       "types": "./dist/client/index.d.ts",
       "import": "./dist/client/index.mjs"
     },
+    "./client/topology": {
+      "types": "./dist/client/topology.d.ts",
+      "import": "./dist/client/topology.mjs"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.mjs"
+    },
+    "./codegen": {
+      "types": "./dist/codegen/index.d.ts",
+      "import": "./dist/codegen/index.mjs"
+    },
     "./replication": {
       "types": "./dist/replication/index.d.ts",
       "import": "./dist/replication/index.mjs"
@@ -83,6 +114,22 @@
       "import": "./dist/transport/grpc.mjs"
     }
   },
+  "typesVersions": {
+    "*": {
+      "react": [
+        "./dist/react/index.d.ts"
+      ],
+      "codegen": [
+        "./dist/codegen/index.d.ts"
+      ],
+      "client/topology": [
+        "./dist/client/topology.d.ts"
+      ]
+    }
+  },
+  "bin": {
+    "sirannon-codegen": "./dist/codegen/cli.mjs"
+  },
   "files": [
     "dist",
     "LICENSE",
@@ -95,9 +142,10 @@
     "@bufbuild/protobuf": ">=2.0.0",
     "@grpc/grpc-js": ">=1.10.0",
     "better-sqlite3": ">=12.0.0",
-    "expo-sqlite": ">=14.0.0",
     "etcd3": ">=1.1.2",
+    "expo-sqlite": ">=14.0.0",
     "grpc-health-check": ">=2.0.0",
+    "react": ">=19.0.0",
     "uWebSockets.js": ">=20.0.0",
     "wa-sqlite": ">=1.0.0"
   },
@@ -125,38 +173,34 @@
     },
     "wa-sqlite": {
       "optional": true
+    },
+    "react": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@bufbuild/protobuf": "2.11.0",
-    "@grpc/grpc-js": "1.14.3",
+    "@grpc/grpc-js": "1.14.4",
+    "@microsoft/api-extractor": "7.58.12",
     "@types/better-sqlite3": "7.6.13",
-    "@types/node": "25.3.3",
+    "@types/node": "26.1.2",
+    "@types/react": "19.2.15",
+    "@types/react-dom": "19.2.3",
     "@vitest/coverage-v8": "4.0.18",
-    "better-sqlite3": "12.6.2",
+    "better-sqlite3": "13.0.2",
     "etcd3": "1.1.2",
+    "expo-sqlite": "55.0.10",
     "grpc-health-check": "2.1.0",
     "grpc-tools": "1.13.1",
+    "jsdom": "29.1.1",
+    "react": "19.2.6",
+    "react-dom": "19.2.6",
     "selfsigned": "5.5.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",
+    "uWebSockets.js": "github:uNetworking/uWebSockets.js#v20.69.0",
     "vitest": "4.0.18"
-  },
-  "scripts": {
-    "build": "rm -rf dist && tsup",
-    "check:bundle": "node scripts/assert-browser-bundle.mjs",
-    "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
-    "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 --error-on-warnings .",
-    "lint:fix": "biome check --write .",
-    "format": "biome format --write .",
-    "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-TKGHYWQ6.mjs

@@ -1,35 +0,0 @@
-import { query, execute, executeBatch } from './chunk-CW6S3WL5.mjs';
-
-// src/core/transaction.ts
-var Transaction = class _Transaction {
-  constructor(conn) {
-    this.conn = conn;
-  }
-  _lastInsertRowId = 0;
-  async query(sql, params) {
-    return query(this.conn, sql, params);
-  }
-  async execute(sql, params) {
-    const result = await execute(this.conn, sql, params);
-    this._lastInsertRowId = result.lastInsertRowId;
-    return result;
-  }
-  async executeBatch(sql, paramsBatch) {
-    const results = await executeBatch(this.conn, sql, paramsBatch);
-    if (results.length > 0) {
-      this._lastInsertRowId = results[results.length - 1].lastInsertRowId;
-    }
-    return results;
-  }
-  get lastInsertRowId() {
-    return this._lastInsertRowId;
-  }
-  static async run(conn, fn) {
-    return conn.transaction(async (txConn) => {
-      const tx = new _Transaction(txConn);
-      return fn(tx);
-    });
-  }
-};
-
-export { Transaction };

package/dist/database-DuGp0Rtr.d.ts

@@ -1,127 +0,0 @@
-import { Q as QueryHookContext, k as ConnectionHookContext, l as BeforeSubscribeHook, H as HookConfig, M as MetricsConfig, m as QueryMetrics, n as ConnectionMetrics, o as CDCMetrics, a as SQLiteDriver, D as DatabaseOptions, P as Params, p as QueryOptions, E as ExecuteResult, q as BulkLoadOptions, h as BulkLoadResult, T as Transaction, e as SQLiteConnection, r as SubscriptionBuilder, f as BackupScheduleOptions, B as BeforeQueryHook, A as AfterQueryHook } from './types-D_hQW1hr.js';
-import { M as Migration, a as MigrationResult, R as RollbackResult } from './types-D4p4UyDK.js';
-
-type HookEvent = 'beforeQuery' | 'afterQuery' | 'beforeConnect' | 'databaseOpen' | 'databaseClose' | 'beforeSubscribe';
-type SubscribeHookContext = Parameters<BeforeSubscribeHook>[0];
-interface HookEventContextMap {
-    beforeQuery: QueryHookContext;
-    afterQuery: QueryHookContext & {
-        durationMs: number;
-    };
-    beforeConnect: ConnectionHookContext;
-    databaseOpen: ConnectionHookContext;
-    databaseClose: ConnectionHookContext;
-    beforeSubscribe: SubscribeHookContext;
-}
-type HookHandler<E extends HookEvent> = (ctx: HookEventContextMap[E]) => void | Promise<void>;
-type HookDispose = () => void;
-
-declare class HookRegistry {
-    private hooks;
-    constructor(config?: HookConfig);
-    register<E extends HookEvent>(event: E, hook: HookHandler<E>): HookDispose;
-    invoke<E extends HookEvent>(event: E, ctx: HookEventContextMap[E]): Promise<void>;
-    invokeSync<E extends HookEvent>(event: E, ctx: HookEventContextMap[E]): void;
-    has(event: HookEvent): boolean;
-    count(event: HookEvent): number;
-    clear(event?: HookEvent): void;
-    private addHook;
-    private loadConfig;
-}
-
-declare class MetricsCollector {
-    private config;
-    constructor(config?: MetricsConfig);
-    trackQuery<T>(fn: () => Promise<T>, context: Omit<QueryMetrics, 'durationMs' | 'error'>): Promise<T>;
-    trackConnection(metrics: ConnectionMetrics): void;
-    trackCDCEvent(metrics: CDCMetrics): void;
-    get active(): boolean;
-}
-
-interface DatabaseInternals {
-    parentHooks?: HookRegistry;
-    metrics?: MetricsCollector;
-}
-declare class Database {
-    readonly id: string;
-    readonly path: string;
-    readonly readOnly: boolean;
-    private readonly pool;
-    private readonly driver;
-    private readonly synchronous;
-    private readonly walMode;
-    private readonly writerLock;
-    private readonly writeGate;
-    private readonly groupCommitter;
-    private readonly closeListeners;
-    private _closed;
-    private readonly cdc;
-    private readonly hookRegistry;
-    private readonly observer;
-    private readonly backups;
-    private constructor();
-    static create(id: string, path: string, driver: SQLiteDriver, options?: DatabaseOptions, internals?: DatabaseInternals): Promise<Database>;
-    query<T = Record<string, unknown>>(sql: string, params?: Params, options?: QueryOptions): Promise<T[]>;
-    /**
-     * Returns query rows already encoded for the wire (safe-range integers as
-     * plain numbers, larger integers and BLOBs as tagged envelopes) in a single
-     * pass. The server response path uses this so a read walks its values once
-     * rather than narrowing on the driver and re-scanning to tag.
-     */
-    queryForWire(sql: string, params?: Params, options?: QueryOptions): Promise<unknown[]>;
-    queryOne<T = Record<string, unknown>>(sql: string, params?: Params, options?: QueryOptions): Promise<T | undefined>;
-    /**
-     * On a single-connection driver the reader is the writer, so serialise the
-     * read through the writer lock to avoid a bulk load's uncommitted rows.
-     */
-    private runRead;
-    execute(sql: string, params?: Params, options?: QueryOptions): Promise<ExecuteResult>;
-    executeBatch(sql: string, paramsBatch: Params[], options?: QueryOptions): Promise<ExecuteResult[]>;
-    private runInTransaction;
-    /**
-     * Load rows with relaxed writer durability. The load holds the writer lock
-     * for its whole duration, so no other write commits under the relaxed level
-     * and no two loads race on the shared `synchronous` setting; the configured
-     * level is restored before this resolves, whether the load succeeds or
-     * fails. The load runs in one transaction, so one commit and one durability
-     * barrier cover the whole batch. Rows are summed rather than returned
-     * per-row to bound memory on large loads. Like `execute` and `transaction`,
-     * this writes only to the local database; under replication the server routes
-     * loads through the engine, not through this method.
-     */
-    bulkLoad(sql: string, paramsBatch: Params[], options?: BulkLoadOptions): Promise<BulkLoadResult>;
-    /**
-     * Takes the statements up front rather than a callback, since a group cannot wait on an
-     * arbitrary caller-supplied callback without delaying every transaction beside it.
-     */
-    executeTransaction(statements: readonly {
-        sql: string;
-        params?: Params;
-    }[]): Promise<ExecuteResult[]>;
-    private runStatementsAlone;
-    transaction<T>(fn: (tx: Transaction) => Promise<T>): Promise<T>;
-    watch(table: string): Promise<void>;
-    /**
-     * Runs a CDC maintenance write (change-log pruning) on the shared writer
-     * under the writer lock. Serialising it with application writes keeps it
-     * from becoming a second writer that contends for SQLite's single write
-     * lock and stalls the event loop on `busy_timeout`.
-     */
-    runCdcMaintenance(op: (writer: SQLiteConnection) => Promise<unknown>): Promise<void>;
-    unwatch(table: string): Promise<void>;
-    on(table: string): SubscriptionBuilder;
-    migrate(migrations: Migration[]): Promise<MigrationResult>;
-    rollback(migrations: Migration[], version?: number): Promise<RollbackResult>;
-    backup(destPath: string): Promise<void>;
-    scheduleBackup(options: BackupScheduleOptions): void;
-    loadExtension(extensionPath: string): Promise<void>;
-    onBeforeQuery(hook: BeforeQueryHook): void;
-    onAfterQuery(hook: AfterQueryHook): void;
-    addCloseListener(fn: () => void | Promise<void>): void;
-    close(): Promise<void>;
-    get closed(): boolean;
-    get readerCount(): number;
-    private ensureOpen;
-}
-
-export { Database as D, type HookDispose as H, MetricsCollector as M, type SubscribeHookContext as S, type HookEvent as a, type HookEventContextMap as b, type HookHandler as c, HookRegistry as d };

package/dist/sirannon-4SspRvP5.d.ts

@@ -1,31 +0,0 @@
-import { D as Database } from './database-DuGp0Rtr.js';
-import { S as SirannonOptions, a as SQLiteDriver, D as DatabaseOptions, B as BeforeQueryHook, A as AfterQueryHook, b as BeforeConnectHook, c as DatabaseOpenHook, d as DatabaseCloseHook } from './types-D_hQW1hr.js';
-
-declare class Sirannon {
-    readonly options: SirannonOptions;
-    private readonly dbs;
-    private readonly opening;
-    private _shutdown;
-    private readonly _driver;
-    private readonly hookRegistry;
-    private readonly metricsCollector;
-    private readonly lifecycleManager;
-    constructor(options: SirannonOptions);
-    get driver(): SQLiteDriver;
-    open(id: string, path: string, options?: DatabaseOptions): Promise<Database>;
-    private withRegistryDefaults;
-    close(id: string): Promise<void>;
-    get(id: string): Database | undefined;
-    resolve(id: string): Promise<Database | undefined>;
-    has(id: string): boolean;
-    databases(): Map<string, Database>;
-    shutdown(): Promise<void>;
-    onBeforeQuery(hook: BeforeQueryHook): void;
-    onAfterQuery(hook: AfterQueryHook): void;
-    onBeforeConnect(hook: BeforeConnectHook): void;
-    onDatabaseOpen(hook: DatabaseOpenHook): void;
-    onDatabaseClose(hook: DatabaseCloseHook): void;
-    private ensureRunning;
-}
-
-export { Sirannon as S };

package/dist/types-BEu1I_9_.d.ts

@@ -1,139 +0,0 @@
-type CoordinatorLeaseKind = 'controller' | 'node-session';
-type CoordinatorWatchDisposer = () => void | Promise<void>;
-interface CoordinatorLease {
-    id: string;
-    kind: CoordinatorLeaseKind;
-    clusterId: string;
-    holderId: string;
-    ttlMs: number;
-    grantedAtMs: number;
-    expiresAtMs: number;
-    metadata?: Record<string, unknown>;
-}
-interface AcquireControllerLeaseInput {
-    clusterId: string;
-    holderId: string;
-    ttlMs: number;
-    metadata?: Record<string, unknown>;
-}
-type AcquireControllerLeaseResult = {
-    acquired: true;
-    lease: CoordinatorLease;
-} | {
-    acquired: false;
-    lease: CoordinatorLease | null;
-};
-interface CoordinatorCompatibilityMetadata {
-    packageVersion?: string;
-    specVersion?: string;
-    protocolVersion?: string;
-}
-interface RegisterNodeSessionInput {
-    clusterId: string;
-    nodeId: string;
-    ttlMs: number;
-    endpoint?: string;
-    groupIds?: string[];
-    dataBearing?: boolean;
-    voting?: boolean;
-    compatibility?: CoordinatorCompatibilityMetadata;
-    metadata?: Record<string, unknown>;
-}
-interface CoordinatorNodeSession {
-    clusterId: string;
-    nodeId: string;
-    lease: CoordinatorLease;
-    endpoint?: string;
-    groupIds: string[];
-    dataBearing: boolean;
-    voting: boolean;
-    compatibility?: CoordinatorCompatibilityMetadata;
-    metadata?: Record<string, unknown>;
-}
-interface CoordinatorPrimary {
-    nodeId: string;
-    endpoint?: string;
-}
-interface ReplicationGroupState {
-    clusterId: string;
-    groupId: string;
-    votingDataBearingNodeIds: string[];
-    currentPrimary: CoordinatorPrimary | null;
-    primaryTerm: bigint;
-    durabilityPointSeq: bigint;
-    inSyncNodeIds: string[];
-    drainingNodeIds: string[];
-    repairingNodeIds: string[];
-    faultedNodeIds: string[];
-    compatibility?: CoordinatorCompatibilityMetadata;
-    updatedAtMs: number;
-}
-interface SetReplicationGroupStateInput {
-    clusterId: string;
-    groupId: string;
-    votingDataBearingNodeIds: string[];
-    currentPrimary?: CoordinatorPrimary | null;
-    primaryTerm?: bigint;
-    durabilityPointSeq?: bigint;
-    inSyncNodeIds?: string[];
-    drainingNodeIds?: string[];
-    repairingNodeIds?: string[];
-    faultedNodeIds?: string[];
-    compatibility?: CoordinatorCompatibilityMetadata;
-}
-interface CompareAndAdvancePrimaryTermInput {
-    clusterId: string;
-    groupId: string;
-    expectedPrimaryTerm: bigint;
-    nextPrimary: CoordinatorPrimary;
-}
-interface CompareAndAdvancePrimaryTermResult {
-    advanced: boolean;
-    state: ReplicationGroupState | null;
-}
-interface UpdateInSyncSetInput {
-    clusterId: string;
-    groupId: string;
-    inSyncNodeIds: string[];
-    durabilityPointSeq?: bigint;
-}
-interface AdmitNodeToInSyncSetInput {
-    clusterId: string;
-    groupId: string;
-    nodeId: string;
-    sourceNodeId: string;
-    appliedSeq: bigint;
-}
-interface UpdateNodeMaintenanceInput {
-    clusterId: string;
-    groupId: string;
-    nodeId: string;
-    draining?: boolean;
-    repairing?: boolean;
-    faulted?: boolean;
-}
-interface PromoteEligibleReplicaInput {
-    clusterId: string;
-    groupId: string;
-    excludeNodeIds?: string[];
-}
-type ReplicationGroupWatcher = (state: ReplicationGroupState) => void;
-interface ClusterCoordinator {
-    tryAcquireControllerLease(input: AcquireControllerLeaseInput): Promise<AcquireControllerLeaseResult>;
-    renewLease(leaseId: string, ttlMs: number): Promise<boolean>;
-    releaseLease(leaseId: string): Promise<boolean>;
-    registerNodeSession(input: RegisterNodeSessionInput): Promise<CoordinatorNodeSession>;
-    getLiveNodeSession(clusterId: string, nodeId: string): Promise<CoordinatorNodeSession | null>;
-    deregisterNodeSession(clusterId: string, nodeId: string): Promise<void>;
-    setReplicationGroupState(input: SetReplicationGroupStateInput): Promise<ReplicationGroupState>;
-    getReplicationGroupState(clusterId: string, groupId: string): Promise<ReplicationGroupState | null>;
-    watchReplicationGroup(clusterId: string, groupId: string, watcher: ReplicationGroupWatcher): CoordinatorWatchDisposer | Promise<CoordinatorWatchDisposer>;
-    compareAndAdvancePrimaryTerm(input: CompareAndAdvancePrimaryTermInput): Promise<CompareAndAdvancePrimaryTermResult>;
-    updateInSyncSet(input: UpdateInSyncSetInput): Promise<ReplicationGroupState | null>;
-    admitNodeToInSyncSet(input: AdmitNodeToInSyncSetInput): Promise<ReplicationGroupState | null>;
-    updateNodeMaintenance(input: UpdateNodeMaintenanceInput): Promise<ReplicationGroupState | null>;
-    promoteEligibleReplica(input: PromoteEligibleReplicaInput): Promise<ReplicationGroupState>;
-    close?(): Promise<void>;
-}
-
-export type { AcquireControllerLeaseInput as A, ClusterCoordinator as C, PromoteEligibleReplicaInput as P, RegisterNodeSessionInput as R, SetReplicationGroupStateInput as S, UpdateInSyncSetInput as U, AcquireControllerLeaseResult as a, CoordinatorNodeSession as b, ReplicationGroupState as c, ReplicationGroupWatcher as d, CoordinatorWatchDisposer as e, CompareAndAdvancePrimaryTermInput as f, CompareAndAdvancePrimaryTermResult as g, AdmitNodeToInSyncSetInput as h, UpdateNodeMaintenanceInput as i, CoordinatorCompatibilityMetadata as j, CoordinatorLease as k, CoordinatorPrimary as l };