@delali/sirannon-db 0.1.7 → 0.2.0

package/dist/{types-BsjobKbl.d.ts → types-B7gmEsZW.d.ts}

@@ -1,6 +1,7 @@
-import { C as ChangeTracker } from './change-tracker-CbmaMO-N.js';
-import { e as SQLiteConnection } from './types-D_hQW1hr.js';
-import { C as ClusterCoordinator, j as CoordinatorCompatibilityMetadata, c as ReplicationGroupState } from './types-BEu1I_9_.js';
+import { C as ChangeTracker } from './change-tracker-DKRVUC3l.js';
+import { e as SQLiteConnection, N as NodeHealth } from './types-zhnRXrsb.js';
+import { R as ReplicationBatch, S as SyncTableManifest, C as ConflictResolver } from './types-C_D8IhpO.js';
+import { C as ClusterCoordinator, a as CoordinatorCompatibilityMetadata, R as ReplicationGroupState } from './types-BsVabqSI.js';
 
 interface NodeInfo {
     id: string;
@@ -13,37 +14,6 @@ interface NodeInfo {
     lastAckedSeq: bigint;
     metadata?: Record<string, unknown>;
 }
-interface HLCTimestamp {
-    wallMs: number;
-    logical: number;
-    nodeId: string;
-}
-interface ReplicationChange {
-    table: string;
-    operation: 'insert' | 'update' | 'delete' | 'ddl';
-    rowId: string;
-    primaryKey: Record<string, unknown>;
-    hlc: string;
-    txId: string;
-    nodeId: string;
-    newData: Record<string, unknown> | null;
-    oldData: Record<string, unknown> | null;
-    ddlStatement?: string;
-}
-interface ReplicationBatch {
-    sourceNodeId: string;
-    batchId: string;
-    fromSeq: bigint;
-    toSeq: bigint;
-    hlcRange: {
-        min: string;
-        max: string;
-    };
-    changes: ReplicationChange[];
-    checksum: string;
-    groupId?: string;
-    primaryTerm?: bigint;
-}
 interface ReplicationAck {
     batchId: string;
     ackedSeq: bigint;
@@ -69,21 +39,6 @@ interface ForwardedTransactionResult {
     groupId?: string;
     primaryTerm?: bigint;
 }
-interface ConflictContext {
-    table: string;
-    rowId: string;
-    localChange: ReplicationChange | null;
-    remoteChange: ReplicationChange;
-    localHlc: string | null;
-    remoteHlc: string;
-}
-interface ConflictResolution {
-    action: 'accept_remote' | 'keep_local' | 'merge';
-    mergedData?: Record<string, unknown>;
-}
-interface ConflictResolver {
-    resolve(ctx: ConflictContext): ConflictResolution | Promise<ConflictResolution>;
-}
 type TopologyRole = 'primary' | 'replica';
 interface Topology {
     role: TopologyRole;
@@ -191,6 +146,7 @@ interface ReplicationStatus {
     peers: PeerState[];
     localSeq: bigint;
     replicating: boolean;
+    health: NodeHealth;
     syncState?: SyncState;
     coordinator?: CoordinatorRuntimeStatus;
 }
@@ -205,14 +161,9 @@ interface CoordinatorRuntimeStatus {
     faultedNodeIds: string[];
     votingDataBearingNodeIds: string[];
     authority: boolean;
+    connected: boolean;
     controllerState: 'disabled' | 'standby' | 'active' | 'lost';
 }
-interface ApplyResult {
-    applied: number;
-    skipped: number;
-    conflicts: number;
-    droppedTables: string[];
-}
 type SyncPhase = 'pending' | 'syncing' | 'catching-up' | 'ready';
 interface SyncState {
     phase: SyncPhase;
@@ -227,6 +178,7 @@ interface SyncRequest {
     requestId: string;
     joinerNodeId: string;
     completedTables: string[];
+    supportsStreamVerification?: boolean;
     groupId?: string;
     primaryTerm?: bigint;
 }
@@ -242,11 +194,6 @@ interface SyncBatch {
     groupId?: string;
     primaryTerm?: bigint;
 }
-interface SyncTableManifest {
-    table: string;
-    rowCount: number;
-    pkHash: string;
-}
 interface SyncComplete {
     requestId: string;
     snapshotSeq: bigint;
@@ -271,4 +218,4 @@ interface ReplicationErrorEvent {
     recoverable: boolean;
 }
 
-export type { ApplyResult as A, ConflictResolver as C, ForwardedTransaction as F, HLCTimestamp as H, InFlightBatch as I, NodeInfo as N, PeerState as P, ReplicationBatch as R, SyncRequest as S, TopologyRole as T, ReplicationAck as a, ForwardedTransactionResult as b, SyncBatch as c, SyncComplete as d, SyncAck as e, ReplicationTransport as f, TransportConfig as g, ConflictContext as h, ConflictResolution as i, SyncPhase as j, SyncTableManifest as k, ReplicationConfig as l, SyncState as m, ReplicationStatus as n, ReplicationErrorEvent as o, Topology as p, ReplicationChange as q };
+export type { ForwardedTransaction as F, InFlightBatch as I, NodeInfo as N, PeerState as P, ReplicationAck as R, SyncRequest as S, TransportConfig as T, ForwardedTransactionResult as a, SyncBatch as b, SyncComplete as c, SyncAck as d, ReplicationTransport as e, TopologyRole as f, SyncPhase as g, ReplicationConfig as h, SyncState as i, ReplicationStatus as j, ReplicationErrorEvent as k, Topology as l };

package/dist/{types-BEu1I_9_.d.ts → types-BsVabqSI.d.ts}

@@ -136,4 +136,4 @@ interface ClusterCoordinator {
     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 };
+export type { AcquireControllerLeaseInput as A, ClusterCoordinator as C, PromoteEligibleReplicaInput as P, ReplicationGroupState as R, SetReplicationGroupStateInput as S, UpdateInSyncSetInput as U, CoordinatorCompatibilityMetadata as a, AcquireControllerLeaseResult as b, RegisterNodeSessionInput as c, CoordinatorNodeSession as d, ReplicationGroupWatcher as e, CoordinatorWatchDisposer as f, CompareAndAdvancePrimaryTermInput as g, CompareAndAdvancePrimaryTermResult as h, AdmitNodeToInSyncSetInput as i, UpdateNodeMaintenanceInput as j, CoordinatorLease as k, CoordinatorPrimary as l };

package/dist/types-CL6piSnD.d.ts

@@ -0,0 +1,43 @@
+type LiveQueryState<T> = {
+    status: 'pending';
+} | {
+    status: 'ready';
+    rows: readonly T[];
+    revalidating: boolean;
+} | {
+    status: 'error';
+    error: Error;
+};
+type ResultOp<T> = {
+    op: 'insert';
+    index: number;
+    row: T;
+} | {
+    op: 'update';
+    index: number;
+    row: T;
+} | {
+    op: 'delete';
+    index: number;
+};
+type LiveUpdate<T> = {
+    kind: 'rows';
+} | {
+    kind: 'ops';
+    ops: readonly ResultOp<T>[];
+} | {
+    kind: 'revalidating';
+} | {
+    kind: 'error';
+};
+interface LiveQuery<T = Record<string, unknown>> {
+    getState(): LiveQueryState<T>;
+    subscribe(listener: (update: LiveUpdate<T>) => void): () => void;
+    close(): Promise<void>;
+}
+interface LiveQueryOptions {
+    rereadJitterMs?: number;
+    maxTransactionChanges?: number;
+}
+
+export type { LiveQueryOptions as L, ResultOp as R, LiveQuery as a, LiveQueryState as b, LiveUpdate as c };

package/dist/types-C_D8IhpO.d.ts

@@ -0,0 +1,60 @@
+interface HLCTimestamp {
+    wallMs: number;
+    logical: number;
+    nodeId: string;
+}
+interface ReplicationChange {
+    table: string;
+    operation: 'insert' | 'update' | 'delete' | 'ddl';
+    rowId: string;
+    primaryKey: Record<string, unknown>;
+    hlc: string;
+    txId: string;
+    nodeId: string;
+    newData: Record<string, unknown> | null;
+    oldData: Record<string, unknown> | null;
+    ddlStatement?: string;
+}
+interface ReplicationBatch {
+    sourceNodeId: string;
+    batchId: string;
+    fromSeq: bigint;
+    toSeq: bigint;
+    hlcRange: {
+        min: string;
+        max: string;
+    };
+    changes: ReplicationChange[];
+    checksum: string;
+    groupId?: string;
+    primaryTerm?: bigint;
+}
+interface ConflictContext {
+    table: string;
+    rowId: string;
+    localChange: ReplicationChange | null;
+    remoteChange: ReplicationChange;
+    localHlc: string | null;
+    remoteHlc: string;
+}
+interface ConflictResolution {
+    action: 'accept_remote' | 'keep_local' | 'merge';
+    mergedData?: Record<string, unknown>;
+}
+interface ConflictResolver {
+    resolve(ctx: ConflictContext): ConflictResolution | Promise<ConflictResolution>;
+}
+interface ApplyResult {
+    applied: number;
+    skipped: number;
+    conflicts: number;
+    droppedTables: string[];
+}
+interface SyncTableManifest {
+    table: string;
+    rowCount: number;
+    pkHash?: string;
+    batchDigest?: string;
+}
+
+export type { ApplyResult as A, ConflictResolver as C, HLCTimestamp as H, ReplicationBatch as R, SyncTableManifest as S, ConflictContext as a, ConflictResolution as b, ReplicationChange as c };

package/dist/{types-D_hQW1hr.d.ts → types-zhnRXrsb.d.ts}

@@ -9,6 +9,35 @@ declare class Transaction {
     static run<T>(conn: SQLiteConnection, fn: (tx: Transaction) => Promise<T>): Promise<T>;
 }
 
+declare const MIGRATION_NAME_RE: RegExp;
+interface AppliedMigration {
+    version: number;
+    name: string;
+    applied_at: number;
+}
+interface MigrationBaseline {
+    through: number;
+}
+interface Migration {
+    version: number;
+    name: string;
+    up: string | ((tx: Transaction) => void | Promise<void>);
+    down?: string | ((tx: Transaction) => void | Promise<void>);
+    baseline?: MigrationBaseline;
+}
+type MigrationSource = Migration[] | (() => Migration[] | Promise<Migration[]>);
+interface AppliedMigrationEntry {
+    version: number;
+    name: string;
+}
+interface MigrationResult {
+    applied: AppliedMigrationEntry[];
+    skipped: number;
+}
+interface RollbackResult {
+    rolledBack: AppliedMigrationEntry[];
+}
+
 /** Query parameter types: named (object) or positional (array). */
 type Params = Record<string, unknown> | unknown[];
 type WriteConcernLevel = 'local' | 'majority' | 'all';
@@ -29,6 +58,22 @@ interface ClusterReadEndpointInfo {
     endpoint: string;
     readConcerns: ReadConcernLevel[];
 }
+/** The single word describing what a node can do right now. */
+type NodeHealthState = 'healthy' | 'degraded' | 'failing_over' | 'repairing' | 'syncing' | 'unavailable';
+/** The condition that produced a {@link NodeHealthState}. */
+type NodeHealthReason = 'in-sync' | 'lagging' | 'coordinator-unreachable' | 'draining' | 'repairing' | 'faulted' | 'sync-pending' | 'no-group-state';
+/**
+ * The health of one node, covering only the node that reports it.
+ *
+ * `canRead` and `canWrite` are what that node will accept at this moment;
+ * `state` and `reason` name the condition behind them.
+ */
+interface NodeHealth {
+    state: NodeHealthState;
+    reason: NodeHealthReason;
+    canRead: boolean;
+    canWrite: boolean;
+}
 interface ClusterStatusInfo {
     databaseId: string;
     replicationGroupId?: string;
@@ -39,7 +84,8 @@ interface ClusterStatusInfo {
     } | null;
     primaryTerm?: bigint;
     readEndpoints?: ClusterReadEndpointInfo[];
-    health: 'healthy' | 'degraded' | 'failing_over' | 'unavailable' | 'repairing' | 'syncing';
+    health: NodeHealthState;
+    healthReason: NodeHealthReason;
 }
 /** Result returned by mutation statements (INSERT, UPDATE, DELETE). */
 interface ExecuteResult {
@@ -56,6 +102,11 @@ interface ChangeEvent<T = Record<string, unknown>> {
     oldRow?: T;
     seq: bigint;
     timestamp: number;
+    hlc?: string;
+    origin?: string;
+    rowId?: string;
+    txId?: string;
+    txEnd?: boolean;
 }
 /** Context passed to query hooks. */
 interface QueryHookContext {
@@ -180,6 +231,7 @@ interface SirannonOptions {
     hooks?: HookConfig;
     metrics?: MetricsConfig;
     lifecycle?: LifecycleConfig;
+    migrations?: MigrationSource;
     writerWorker?: boolean | WriterWorkerOptions;
 }
 /** Options for scheduled backups. */
@@ -207,169 +259,6 @@ interface SubscriptionBuilder {
 interface Subscription {
     unsubscribe(): void;
 }
-/** Context passed to the onRequest middleware hook. */
-interface RequestContext {
-    headers: Record<string, string>;
-    method: string;
-    path: string;
-    databaseId?: string;
-    remoteAddress: string;
-}
-/** Return this from an onRequest hook to deny the request with a custom response. */
-interface RequestDenial {
-    status: number;
-    code: string;
-    message: string;
-}
-/** Middleware hook for auth, rate limiting, and request validation. */
-type OnRequestHook = (ctx: RequestContext) => undefined | RequestDenial | Promise<undefined | RequestDenial>;
-/**
- * Durability level in force while a bulk load runs. SQLite sanctions 'off' for
- * a from-scratch load that the operator can re-run after a power loss; 'off'
- * gives up corruption safety, so it fits only a load that starts from nothing.
- * 'normal' keeps WAL-mode corruption safety and suits loads into a database
- * that already holds data the operator cannot afford to lose.
- */
-type BulkLoadDurability = 'off' | 'normal';
-interface BulkLoadOptions {
-    /** Durability during the load. Default: 'off'. */
-    durability?: BulkLoadDurability;
-    /**
-     * Whether this load ends with a WAL checkpoint. Default: true. Set it false
-     * on every load but the last of a multi-batch import so the one fsyncing
-     * checkpoint is paid once at the end instead of once per batch; the
-     * configured durability is still restored after each batch regardless, so an
-     * abandoned import never leaves the writer at the relaxed level.
-     */
-    checkpoint?: boolean;
-}
-/** Aggregate outcome of a bulk load. Summed rather than per-row so a
- * million-row load never holds a million result objects in memory. */
-interface BulkLoadResult {
-    rowsLoaded: number;
-    changes: number;
-}
-interface ServerExecutionTarget {
-    query<T = Record<string, unknown>>(sql: string, params?: Params, options?: QueryOptions): Promise<T[]>;
-    /**
-     * Optional single-pass read that returns rows already encoded for the wire
-     * (safe-range integers as plain numbers, larger integers and BLOBs as tagged
-     * envelopes). When present the server uses it instead of {@link query}
-     * followed by a separate tag-encoding walk. A target that omits it stays
-     * correct: the server falls back to encoding {@link query} rows itself.
-     */
-    queryForWire?(sql: string, params?: Params, options?: QueryOptions): Promise<unknown[]>;
-    execute(sql: string, params?: Params, options?: QueryOptions): Promise<ExecuteResult>;
-    transaction<T>(fn: (tx: Transaction) => Promise<T>, options?: QueryOptions): Promise<T>;
-    /**
-     * Optional entry point for a transaction whose statements are all known
-     * before it starts, which lets concurrent transactions share one commit. A
-     * target that omits it stays correct: the server falls back to
-     * {@link transaction} and runs the statements one at a time.
-     */
-    executeTransaction?(statements: readonly {
-        sql: string;
-        params?: Params;
-    }[], options?: QueryOptions): Promise<ExecuteResult[]>;
-    /**
-     * Optional bulk-load entry point. Targets that proxy to a remote primary
-     * may omit it; the server rejects load requests for such targets instead
-     * of silently degrading to per-statement writes.
-     */
-    bulkLoad?(sql: string, paramsBatch: Params[], options?: BulkLoadOptions): Promise<BulkLoadResult>;
-}
-type ServerExecutionTargetResolver = (databaseId: string) => ServerExecutionTarget | null | undefined | Promise<ServerExecutionTarget | null | undefined>;
-/** Options for the standalone HTTP + WS server. */
-interface ServerOptions {
-    host?: string;
-    port?: number;
-    cors?: boolean | CorsOptions;
-    /**
-     * Maximum HTTP request body and WebSocket message size in bytes. Applied
-     * identically to both transports. Must be a positive, finite integer no
-     * larger than 4_294_967_295 (the unsigned 32-bit ceiling uWebSockets.js can
-     * store; larger values would silently wrap modulo 2^32).
-     * Default: 1_048_576 (1 MB), matching the general web default and acting as
-     * a denial-of-service guard on a memory-limited server.
-     */
-    maxBodyBytes?: number;
-    /**
-     * Maximum bytes buffered per WebSocket connection before the server stops
-     * absorbing backpressure. A single frame can be as large as `maxBodyBytes`,
-     * so this must hold several of them; the resolved value is raised to at
-     * least `maxBodyBytes` and, like `maxBodyBytes`, must not exceed
-     * 4_294_967_295. When the buffer is exceeded the server closes the
-     * connection so the client reconnects rather than losing a frame silently.
-     * Default: the larger of 16 MB and `maxBodyBytes`.
-     */
-    maxWebSocketBackpressureBytes?: number;
-    /**
-     * How long, in milliseconds, change events are retained for WebSocket CDC
-     * subscriptions. Retention bounds both on-disk growth of the change log and
-     * how far back a reconnecting subscriber can resume. Default: 3_600_000
-     * (one hour).
-     */
-    cdcRetentionMs?: number;
-    onRequest?: OnRequestHook;
-    resolveExecutionTarget?: ServerExecutionTargetResolver;
-    getReplicationStatus?: () => ReplicationStatusInfo | null;
-    getClusterStatus?: (databaseId: string) => ClusterStatusInfo | null;
-}
-interface ReplicationStatusInfo {
-    role: string;
-    writeForwarding: boolean;
-    peers: number;
-    localSeq: bigint;
-    replicationGroupId?: string;
-    primaryTerm?: bigint;
-    currentPrimary?: string;
-    coordinator?: {
-        connected: boolean;
-        authority: boolean;
-    };
-    controller?: {
-        state: 'disabled' | 'standby' | 'active' | 'lost';
-    };
-    inSyncReplicas?: string[];
-    laggingReplicas?: string[];
-    syncState?: string;
-    readAvailability?: 'available' | 'unavailable';
-    writeAvailability?: 'available' | 'unavailable';
-}
-/** CORS configuration. */
-interface CorsOptions {
-    origin?: string | string[];
-    methods?: string[];
-    headers?: string[];
-}
-/** Options for the mountable WebSocket handler. */
-interface WSHandlerOptions {
-    /** Maximum message size in bytes. Default: 1_048_576 (1 MB). */
-    maxPayloadLength?: number;
-    /** Change-log retention for CDC subscriptions in milliseconds. Default: 3_600_000. */
-    cdcRetentionMs?: number;
-    resolveExecutionTarget?: ServerExecutionTargetResolver;
-}
-/** Options for the client SDK. */
-interface ClientOptions {
-    /** Transport to use. Default: 'websocket'. */
-    transport?: 'websocket' | 'http';
-    /** Custom headers for HTTP requests. */
-    headers?: Record<string, string>;
-    /** WebSocket subprotocols sent during the browser-compatible handshake. */
-    webSocketProtocols?: string | string[];
-    /** Reconnect on WebSocket disconnect. Default: true. */
-    autoReconnect?: boolean;
-    /** Reconnect interval in ms. Default: 1000. */
-    reconnectInterval?: number;
-    /**
-     * Per-request timeout in milliseconds for the WebSocket transport. A bulk
-     * load or batch of tens of millions of rows can legitimately run longer than
-     * the default, so raise this for large writes. Set to 0 to wait indefinitely.
-     * Default: 30000.
-     */
-    requestTimeout?: number;
-}
 
 interface WorkerHostOptions {
     writeTimeoutMs?: number;
@@ -439,6 +328,7 @@ interface SQLiteConnection {
         statements: readonly {
             sql: string;
             params?: readonly unknown[];
+            trusted?: boolean;
         }[];
     }[]): Promise<GroupRunOutcome[]>;
 }
@@ -491,4 +381,4 @@ interface SQLiteDriver {
     resolveExtensionPath?(extensionPath: string): string;
 }
 
-export { type WriteConcernLevel as $, type AfterQueryHook as A, type BeforeQueryHook as B, type ChangeEvent as C, type DatabaseOptions as D, type ExecuteResult as E, type DriverCapabilities as F, type DriverWorkerEntry as G, type HookConfig as H, type OpenOptions as I, type ReadConcernLevel as J, type ReplicationStatusInfo as K, type LifecycleConfig as L, type MetricsConfig as M, type RequestContext as N, type OnRequestHook as O, type Params as P, type QueryHookContext as Q, type ReadConcern as R, type SirannonOptions as S, Transaction as T, type RequestDenial as U, type RunResult as V, type WriteConcern as W, type SQLiteStatement as X, type ServerExecutionTarget as Y, type ServerExecutionTargetResolver as Z, type Subscription as _, type SQLiteDriver as a, type WriterWorkerOptions as a0, type BeforeConnectHook as b, type DatabaseOpenHook as c, type DatabaseCloseHook as d, type SQLiteConnection as e, type BackupScheduleOptions as f, type BulkLoadDurability as g, type BulkLoadResult as h, type ServerOptions as i, type WSHandlerOptions as j, type ConnectionHookContext as k, type BeforeSubscribeHook as l, type QueryMetrics as m, type ConnectionMetrics as n, type CDCMetrics as o, type QueryOptions as p, type BulkLoadOptions as q, type SubscriptionBuilder as r, type SynchronousLevel as s, type WorkerHostOptions as t, type BatchSummary as u, type ChangeOperation as v, type ClientOptions as w, type ClusterReadEndpointInfo as x, type ClusterStatusInfo as y, type CorsOptions as z };
+export { type AfterQueryHook as A, type BeforeQueryHook as B, type ClusterStatusInfo as C, type DatabaseOptions as D, type ExecuteResult as E, type DriverWorkerEntry as F, MIGRATION_NAME_RE as G, type HookConfig as H, type MigrationBaseline as I, type MigrationSource as J, type NodeHealthReason as K, type LifecycleConfig as L, type Migration as M, type NodeHealth as N, type NodeHealthState as O, type Params as P, type QueryOptions as Q, type ReadConcern as R, type SirannonOptions as S, Transaction as T, type OpenOptions as U, type RunResult as V, type WriteConcern as W, type SQLiteStatement as X, type Subscription as Y, type WriteConcernLevel as Z, type WriterWorkerOptions as _, type SQLiteDriver as a, type BeforeConnectHook as b, type DatabaseOpenHook as c, type DatabaseCloseHook as d, type SQLiteConnection as e, type BackupScheduleOptions as f, type ReadConcernLevel as g, type ChangeEvent as h, type QueryHookContext as i, type ConnectionHookContext as j, type BeforeSubscribeHook as k, type MetricsConfig as l, type QueryMetrics as m, type ConnectionMetrics as n, type CDCMetrics as o, type SubscriptionBuilder as p, type MigrationResult as q, type RollbackResult as r, type SynchronousLevel as s, type WorkerHostOptions as t, type AppliedMigration as u, type AppliedMigrationEntry as v, type BatchSummary as w, type ChangeOperation as x, type ClusterReadEndpointInfo as y, type DriverCapabilities as z };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@delali/sirannon-db",
   "type": "module",
-  "version": "0.1.7",
+  "version": "0.2.0",
   "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",
@@ -66,6 +66,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 +95,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 +123,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,29 +154,38 @@
     },
     "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",
     "@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",
     "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",
+    "check:types": "node scripts/assert-consumer-types.mjs",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
     "test:e2e": "vitest run --config vitest.e2e.config.ts",

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/types-D4p4UyDK.d.ts

@@ -1,26 +0,0 @@
-import { T as Transaction } from './types-D_hQW1hr.js';
-
-interface AppliedMigration {
-    version: number;
-    name: string;
-    applied_at: number;
-}
-interface Migration {
-    version: number;
-    name: string;
-    up: string | ((tx: Transaction) => void | Promise<void>);
-    down?: string | ((tx: Transaction) => void | Promise<void>);
-}
-interface AppliedMigrationEntry {
-    version: number;
-    name: string;
-}
-interface MigrationResult {
-    applied: AppliedMigrationEntry[];
-    skipped: number;
-}
-interface RollbackResult {
-    rolledBack: AppliedMigrationEntry[];
-}
-
-export type { AppliedMigration as A, Migration as M, RollbackResult as R, MigrationResult as a, AppliedMigrationEntry as b };