@lunora/replica 1.0.0-alpha.72 → 1.0.0-alpha.74

package/README.md

@@ -160,15 +160,23 @@ See the [EventsSync JSDoc](src/sync-events.ts) for full API details.
 
 ### useLocalQuery (React)
 
-Live-updating hook that re-queries the mirror whenever a diff is applied.
-Returns `undefined` when the query fails (e.g. table doesn't exist yet),
-and the result rows otherwise.
+Live-updating hook that re-queries the mirror whenever a diff is applied. It
+returns a discriminated union — `{ data }` on success, `{ error }` when the
+query fails (malformed SQL, or the table doesn't exist yet because no matching
+diff has been applied). A failure is never collapsed to `undefined`, so check
+`error` explicitly rather than reading a missing `data` as "still loading".
 
 ```tsx
 import { useLocalQuery } from "@lunora/replica/react";
 
 function TodoList() {
-    const todos = useLocalQuery<{ id: string; title: string; done: boolean }>(mirror, "SELECT id, title, done FROM todos WHERE done = ?", [false]);
+    const { data: todos, error } = useLocalQuery<{ id: string; title: string; done: boolean }>(mirror, "SELECT id, title, done FROM todos WHERE done = ?", [
+        false,
+    ]);
+
+    if (error) {
+        return <p>Query failed: {error.message}</p>;
+    }
 
     if (todos === undefined) {
         return <p>Waiting for data…</p>;
@@ -189,14 +197,46 @@ React 18+ concurrent features and Suspense-based frameworks (Next.js, Remix).
 
 ## EventLogDO
 
-A Durable Object that persists the event log to DO SQLite storage:
+A Durable Object that persists the event log to DO SQLite storage.
+
+Re-export the class from your worker entry so Wrangler can find it:
 
 ```ts
+// src/worker.ts
 export { EventLogDO } from "@lunora/replica";
+```
+
+Then declare the binding in `wrangler.jsonc`. The DO uses `state.storage.sql`,
+so its migration **must** use `new_sqlite_classes` — `new_classes` gives the
+instance a key-value store with no `.sql`, and every request fails at the first
+statement:
+
+```jsonc
+{
+    "durable_objects": {
+        "bindings": [{ "name": "EVENT_LOG_DO", "class_name": "EventLogDO" }],
+    },
+    "migrations": [{ "tag": "v1", "new_sqlite_classes": ["EventLogDO"] }],
+}
+```
+
+`EventLogDOClient` wraps the DO's `fetch()` RPC surface. Its only option is
+`fetch` — a function that dispatches a request to the instance you want, which
+is where the namespace and instance id are chosen:
+
+```ts
+const client = new EventLogDOClient({
+    fetch: (request) => env.EVENT_LOG_DO.get(env.EVENT_LOG_DO.idFromName("my-app")).fetch(request),
+});
+
+// Append takes an ARRAY of events and returns them with their assigned `seq`s.
+const [entry] = await client.append([{ type: "order:placed", payload: { orderId: "123" } }]);
 
-const client = new EventLogDOClient({ namespace: "my-app" });
-await client.append({ type: "order:placed", payload: { orderId: "123" } });
-const events = await client.query({ type: "order:placed", limit: 10 });
+// Read back by sequence number — the log is append-only and ordered, so
+// there is no filter-by-type query. `getSince(0)` is the whole log.
+const events = await client.getSince(entry.seq);
+const { entries, hasMore } = await client.getRange(0, 50);
+const size = await client.getSize();
 ```
 
 ## Custom adapters

package/dist/adapters/better-sqlite3.d.mts

@@ -1,4 +1,4 @@
-import { S as SqliteAdapter } from "../packem_shared/types.d-CkMkSwLJ.mjs";
+import { S as SqliteAdapter } from "../packem_shared/types.d-BuLTPLaQ.mjs";
 /**
  * Create a {@link SqliteAdapter} backed by [better-sqlite3](https://github.com/WiseLibs/better-sqlite3)
  * (a synchronous SQLite3 binding for Node.js).

package/dist/adapters/better-sqlite3.d.ts

@@ -1,4 +1,4 @@
-import { S as SqliteAdapter } from "../packem_shared/types.d-CkMkSwLJ.js";
+import { S as SqliteAdapter } from "../packem_shared/types.d-BuLTPLaQ.js";
 /**
  * Create a {@link SqliteAdapter} backed by [better-sqlite3](https://github.com/WiseLibs/better-sqlite3)
  * (a synchronous SQLite3 binding for Node.js).

package/dist/adapters/better-sqlite3.mjs

@@ -1 +1 @@
-const c=t=>({exec(e,r){r&&r.length>0?t.prepare(e).run([...r]):t.exec(e)},query(e,r){const n=t.prepare(e);return r&&r.length>0?n.all([...r]):n.all()},transaction(e){t.transaction(e)()},lastInsertRowId(){const e=t.prepare("SELECT last_insert_rowid() AS id").get();return Number(e?.id??-1)},close(){t.close()}});export{c as createBetterSqlite3Adapter};
+const o=t=>({exec(r,e){e&&e.length>0?t.prepare(r).run([...e]):t.exec(r)},query(r,e){const n=t.prepare(r);return e&&e.length>0?n.all([...e]):n.all()},transaction(r){t.transaction(r)()},close(){t.close()}});export{o as createBetterSqlite3Adapter};

package/dist/adapters/sqlite-wasm.d.mts

@@ -1,4 +1,4 @@
-import { S as SqliteAdapter } from "../packem_shared/types.d-CkMkSwLJ.mjs";
+import { S as SqliteAdapter } from "../packem_shared/types.d-BuLTPLaQ.mjs";
 /**
  * Create a {@link SqliteAdapter} backed by the [official SQLite Wasm](https://www.npmjs.com/package/@sqlite.org/sqlite-wasm)
  * (a WebAssembly build of SQLite that runs in browsers and Node.js).
@@ -10,18 +10,13 @@ import { S as SqliteAdapter } from "../packem_shared/types.d-CkMkSwLJ.mjs";
  * IMPORTANT (REPLICA-01): the real `oo1.DB.exec()` does NOT return sql.js's
  * `{ columns, values }[]` result shape — with `rowMode: "object"` and
  * `returnValue: "resultRows"` it returns the rows directly, as
- * `Record<string, unknown>[]`. This adapter is written against that real
- * shape; `lastInsertRowId` uses the driver's `selectValue()` convenience
- * method (a single-scalar query helper) rather than parsing a result-row
- * array.
+ * `Record<string, unknown>[]`. This adapter is written against that real shape.
  * @param database An already-initialised `sqlite3.oo1.DB` instance.
  * @param database.close Tear down the database connection.
  * @param database.exec Execute SQL with optional bind params. With
  * `{ returnValue: "resultRows", rowMode: "object" }` it returns the matched
  * rows directly (`Record<string, unknown>[]`); otherwise (DDL/DML/BEGIN/
  * COMMIT/ROLLBACK) its return value is unused here.
- * @param database.selectValue Run a query and return the first column of the
- * first row as a single scalar — used for `SELECT last_insert_rowid()`.
  * @experimental
  */
 declare const createSqliteWasmAdapter: (database: {
@@ -31,6 +26,5 @@ declare const createSqliteWasmAdapter: (database: {
     returnValue?: "resultRows";
     rowMode?: "object";
   }) => Record<string, unknown>[] | undefined;
-  selectValue: (sql: string, bind?: unknown[]) => unknown;
 }) => SqliteAdapter;
 export { createSqliteWasmAdapter };

package/dist/adapters/sqlite-wasm.d.ts

@@ -1,4 +1,4 @@
-import { S as SqliteAdapter } from "../packem_shared/types.d-CkMkSwLJ.js";
+import { S as SqliteAdapter } from "../packem_shared/types.d-BuLTPLaQ.js";
 /**
  * Create a {@link SqliteAdapter} backed by the [official SQLite Wasm](https://www.npmjs.com/package/@sqlite.org/sqlite-wasm)
  * (a WebAssembly build of SQLite that runs in browsers and Node.js).
@@ -10,18 +10,13 @@ import { S as SqliteAdapter } from "../packem_shared/types.d-CkMkSwLJ.js";
  * IMPORTANT (REPLICA-01): the real `oo1.DB.exec()` does NOT return sql.js's
  * `{ columns, values }[]` result shape — with `rowMode: "object"` and
  * `returnValue: "resultRows"` it returns the rows directly, as
- * `Record<string, unknown>[]`. This adapter is written against that real
- * shape; `lastInsertRowId` uses the driver's `selectValue()` convenience
- * method (a single-scalar query helper) rather than parsing a result-row
- * array.
+ * `Record<string, unknown>[]`. This adapter is written against that real shape.
  * @param database An already-initialised `sqlite3.oo1.DB` instance.
  * @param database.close Tear down the database connection.
  * @param database.exec Execute SQL with optional bind params. With
  * `{ returnValue: "resultRows", rowMode: "object" }` it returns the matched
  * rows directly (`Record<string, unknown>[]`); otherwise (DDL/DML/BEGIN/
  * COMMIT/ROLLBACK) its return value is unused here.
- * @param database.selectValue Run a query and return the first column of the
- * first row as a single scalar — used for `SELECT last_insert_rowid()`.
  * @experimental
  */
 declare const createSqliteWasmAdapter: (database: {
@@ -31,6 +26,5 @@ declare const createSqliteWasmAdapter: (database: {
     returnValue?: "resultRows";
     rowMode?: "object";
   }) => Record<string, unknown>[] | undefined;
-  selectValue: (sql: string, bind?: unknown[]) => unknown;
 }) => SqliteAdapter;
 export { createSqliteWasmAdapter };

package/dist/adapters/sqlite-wasm.mjs

@@ -1 +1 @@
-const n=t=>({exec(e,r){r&&r.length>0?t.exec(e,{bind:[...r]}):t.exec(e)},query(e,r){return t.exec(e,{bind:r&&r.length>0?[...r]:void 0,returnValue:"resultRows",rowMode:"object"})??[]},transaction(e){t.exec("BEGIN");try{e(),t.exec("COMMIT")}catch(r){throw t.exec("ROLLBACK"),r}},lastInsertRowId(){const e=t.selectValue("SELECT last_insert_rowid()");return typeof e=="number"?e:typeof e=="bigint"?Number(e):-1},close(){t.close()}});export{n as createSqliteWasmAdapter};
+const t=c=>({exec(r,e){e&&e.length>0?c.exec(r,{bind:[...e]}):c.exec(r)},query(r,e){return c.exec(r,{bind:e&&e.length>0?[...e]:void 0,returnValue:"resultRows",rowMode:"object"})??[]},transaction(r){c.exec("BEGIN");try{r(),c.exec("COMMIT")}catch(e){throw c.exec("ROLLBACK"),e}},close(){c.close()}});export{t as createSqliteWasmAdapter};

package/dist/adapters/sqljs.d.mts

@@ -1,4 +1,4 @@
-import { S as SqliteAdapter } from "../packem_shared/types.d-CkMkSwLJ.mjs";
+import { S as SqliteAdapter } from "../packem_shared/types.d-BuLTPLaQ.mjs";
 /**
  * Create a {@link SqliteAdapter} backed by [sql.js](https://sql.js.org)
  * (a WebAssembly build of SQLite that runs in browsers, Node, and

package/dist/adapters/sqljs.d.ts

@@ -1,4 +1,4 @@
-import { S as SqliteAdapter } from "../packem_shared/types.d-CkMkSwLJ.js";
+import { S as SqliteAdapter } from "../packem_shared/types.d-BuLTPLaQ.js";
 /**
  * Create a {@link SqliteAdapter} backed by [sql.js](https://sql.js.org)
  * (a WebAssembly build of SQLite that runs in browsers, Node, and

package/dist/adapters/sqljs.mjs

@@ -1 +1 @@
-const h=n=>({exec(r,e){e&&e.length>0?n.run(r,[...e]):n.exec(r)},query(r,e){const o=(e&&e.length>0?n.exec(r,[...e]):n.exec(r))[0];if(!o)return[];const l=o.columns,c=[];for(const s of o.values){const u={};for(const[i,f]of l.entries())u[f]=s[i];c.push(u)}return c},transaction(r){n.run("BEGIN");try{r(),n.run("COMMIT")}catch(e){throw n.run("ROLLBACK"),e}},lastInsertRowId(){const r=n.exec("SELECT last_insert_rowid() AS id"),e=r[0];if(r.length===0||!e||e.values.length===0)return-1;const t=e.values[0];return!t||t.length===0?-1:Number(t[0])},close(){n.close()}});export{h as createSqlJsAdapter};
+const h=r=>({exec(e,o){o&&o.length>0?r.run(e,[...o]):r.exec(e)},query(e,o){const c=(o&&o.length>0?r.exec(e,[...o]):r.exec(e))[0];if(!c)return[];const u=c.columns,n=[];for(const l of c.values){const t={};for(const[s,f]of u.entries())t[f]=l[s];n.push(t)}return n},transaction(e){r.run("BEGIN");try{e(),r.run("COMMIT")}catch(o){throw r.run("ROLLBACK"),o}},close(){r.close()}});export{h as createSqlJsAdapter};

package/dist/index.d.mts

@@ -16,9 +16,9 @@ export {
 createBetterSqlite3Adapter } from "./adapters/better-sqlite3.mjs";
 export { createSqliteWasmAdapter } from "./adapters/sqlite-wasm.mjs";
 export { createSqlJsAdapter } from "./adapters/sqljs.mjs";
-import { S as SqliteAdapter } from "./packem_shared/types.d-CkMkSwLJ.mjs";
-import { T as TableDiff, I as InputEvent, S as Seq, E as EventLogEntry, a as EventLog, A as AppendOptions, L as LocalMirror } from "./packem_shared/local-mirror.d-Cip3QuMf.mjs";
-export { type C as ClientSeq, type b as EventLogOptions, type c as EventLogSnapshot, type G as GlobalSeq, type d as LocalMirrorOptions, type M as MirrorTableDef, type R as RowChange, e as classifyChanges, f as createTableDiff, g as diffSize, i as isClientSeq, h as isDiffEmpty, j as isGlobalSeq, k as isInputEvent, m as mergeDiffs } from "./packem_shared/local-mirror.d-Cip3QuMf.mjs";
+import { S as SqliteAdapter } from "./packem_shared/types.d-BuLTPLaQ.mjs";
+import { T as TableDiff, I as InputEvent, S as Seq, E as EventLogEntry, a as EventLog, A as AppendOptions, L as LocalMirror } from "./packem_shared/local-mirror.d-N1dkxd9A.mjs";
+export { type C as ClientSeq, type b as EventLogOptions, type c as EventLogSnapshot, type G as GlobalSeq, type d as LocalMirrorOptions, type M as MirrorTableDef, type R as RowChange, e as classifyChanges, f as createTableDiff, g as diffSize, i as isClientSeq, h as isDiffEmpty, j as isGlobalSeq, k as isInputEvent, m as mergeDiffs } from "./packem_shared/local-mirror.d-N1dkxd9A.mjs";
 /**
  * Apply a single {@link TableDiff} to an in-memory row map and return
  * the updated map.

package/dist/index.d.ts

@@ -16,9 +16,9 @@ export {
 createBetterSqlite3Adapter } from "./adapters/better-sqlite3.js";
 export { createSqliteWasmAdapter } from "./adapters/sqlite-wasm.js";
 export { createSqlJsAdapter } from "./adapters/sqljs.js";
-import { S as SqliteAdapter } from "./packem_shared/types.d-CkMkSwLJ.js";
-import { T as TableDiff, I as InputEvent, S as Seq, E as EventLogEntry, a as EventLog, A as AppendOptions, L as LocalMirror } from "./packem_shared/local-mirror.d-ByrYTq4z.js";
-export { type C as ClientSeq, type b as EventLogOptions, type c as EventLogSnapshot, type G as GlobalSeq, type d as LocalMirrorOptions, type M as MirrorTableDef, type R as RowChange, e as classifyChanges, f as createTableDiff, g as diffSize, i as isClientSeq, h as isDiffEmpty, j as isGlobalSeq, k as isInputEvent, m as mergeDiffs } from "./packem_shared/local-mirror.d-ByrYTq4z.js";
+import { S as SqliteAdapter } from "./packem_shared/types.d-BuLTPLaQ.js";
+import { T as TableDiff, I as InputEvent, S as Seq, E as EventLogEntry, a as EventLog, A as AppendOptions, L as LocalMirror } from "./packem_shared/local-mirror.d-C1pwwvwS.js";
+export { type C as ClientSeq, type b as EventLogOptions, type c as EventLogSnapshot, type G as GlobalSeq, type d as LocalMirrorOptions, type M as MirrorTableDef, type R as RowChange, e as classifyChanges, f as createTableDiff, g as diffSize, i as isClientSeq, h as isDiffEmpty, j as isGlobalSeq, k as isInputEvent, m as mergeDiffs } from "./packem_shared/local-mirror.d-C1pwwvwS.js";
 /**
  * Apply a single {@link TableDiff} to an in-memory row map and return
  * the updated map.

package/dist/index.mjs

@@ -1 +1 @@
-import{createBetterSqlite3Adapter as o}from"./adapters/better-sqlite3.mjs";import{createSqliteWasmAdapter as f}from"./adapters/sqlite-wasm.mjs";import{createSqlJsAdapter as i}from"./adapters/sqljs.mjs";import{applyDiff as m,applyDiffToSnapshot as n,applyDiffs as x}from"./packem_shared/applyDiff-Da160K7_.mjs";import{defineEvents as l}from"./packem_shared/defineEvents-DHo-VK7G.mjs";import{MaterializerRuntime as S,defineMaterializer as E}from"./packem_shared/MaterializerRuntime-D0HOAe24.mjs";import{applyDiffToDb as v,applyDiffsToDb as y}from"./packem_shared/applyDiffToDb-C6ek5Elp.mjs";import{EventEmitter as d}from"./packem_shared/EventEmitter-uo75adUL.mjs";import{EventLog as M}from"./packem_shared/EventLog-B1-yhArT.mjs";import{EventLogDO as u}from"./packem_shared/EventLogDO-CaZvpgJN.mjs";import{EventLogDOClient as T}from"./packem_shared/EventLogDOClient-DGDMj5L5.mjs";import{EventSource as C,UNHANDLED as h}from"./packem_shared/EventSource-BC0hKJSA.mjs";import{eventsContext as I}from"./packem_shared/eventsContext-Dxow9Y7S.mjs";import{LocalMirror as O}from"./packem_shared/LocalMirror-BIURA-He.mjs";import{isClientSeq as G,isGlobalSeq as H,isInputEvent as J}from"./packem_shared/isClientSeq-D2Xm0_lj.mjs";import{InMemorySnapshotStore as U}from"./packem_shared/InMemorySnapshotStore-C4taIG5K.mjs";import{subscribeToMirror as j}from"./packem_shared/subscribeToMirror-CX10AaP3.mjs";import{SubscriptionManager as w}from"./packem_shared/SubscriptionManager-AhPw3lFc.mjs";import{EventsSync as K}from"./packem_shared/EventsSync-DWyGGZQZ.mjs";import{classifyChanges as Q,createTableDiff as V,diffSize as X,isDiffEmpty as Y,mergeDiffs as Z}from"./packem_shared/classifyChanges-ioMfjjbU.mjs";export{d as EventEmitter,M as EventLog,u as EventLogDO,T as EventLogDOClient,C as EventSource,K as EventsSync,U as InMemorySnapshotStore,O as LocalMirror,S as MaterializerRuntime,w as SubscriptionManager,h as UNHANDLED,m as applyDiff,v as applyDiffToDb,n as applyDiffToSnapshot,x as applyDiffs,y as applyDiffsToDb,Q as classifyChanges,o as createBetterSqlite3Adapter,i as createSqlJsAdapter,f as createSqliteWasmAdapter,V as createTableDiff,l as defineEvents,E as defineMaterializer,X as diffSize,I as eventsContext,G as isClientSeq,Y as isDiffEmpty,H as isGlobalSeq,J as isInputEvent,Z as mergeDiffs,j as subscribeToMirror};
+import{createBetterSqlite3Adapter as o}from"./adapters/better-sqlite3.mjs";import{createSqliteWasmAdapter as f}from"./adapters/sqlite-wasm.mjs";import{createSqlJsAdapter as i}from"./adapters/sqljs.mjs";import{applyDiff as m,applyDiffToSnapshot as n,applyDiffs as x}from"./packem_shared/applyDiff-Da160K7_.mjs";import{defineEvents as l}from"./packem_shared/defineEvents-DHo-VK7G.mjs";import{MaterializerRuntime as S,defineMaterializer as E}from"./packem_shared/MaterializerRuntime-D0HOAe24.mjs";import{applyDiffToDb as v,applyDiffsToDb as y}from"./packem_shared/applyDiffToDb-C6ek5Elp.mjs";import{EventEmitter as d}from"./packem_shared/EventEmitter-uo75adUL.mjs";import{EventLog as M}from"./packem_shared/EventLog-B1-yhArT.mjs";import{EventLogDO as u}from"./packem_shared/EventLogDO-CaZvpgJN.mjs";import{EventLogDOClient as T}from"./packem_shared/EventLogDOClient-DGDMj5L5.mjs";import{EventSource as C,UNHANDLED as h}from"./packem_shared/EventSource-BC0hKJSA.mjs";import{eventsContext as I}from"./packem_shared/eventsContext-Dxow9Y7S.mjs";import{LocalMirror as O}from"./packem_shared/LocalMirror-BIURA-He.mjs";import{isClientSeq as G,isGlobalSeq as H,isInputEvent as J}from"./packem_shared/isClientSeq-D2Xm0_lj.mjs";import{InMemorySnapshotStore as U}from"./packem_shared/InMemorySnapshotStore-C4taIG5K.mjs";import{subscribeToMirror as j}from"./packem_shared/subscribeToMirror-Rq100MXf.mjs";import{SubscriptionManager as w}from"./packem_shared/SubscriptionManager-AhPw3lFc.mjs";import{EventsSync as K}from"./packem_shared/EventsSync-DWyGGZQZ.mjs";import{classifyChanges as Q,createTableDiff as V,diffSize as X,isDiffEmpty as Y,mergeDiffs as Z}from"./packem_shared/classifyChanges-ioMfjjbU.mjs";export{d as EventEmitter,M as EventLog,u as EventLogDO,T as EventLogDOClient,C as EventSource,K as EventsSync,U as InMemorySnapshotStore,O as LocalMirror,S as MaterializerRuntime,w as SubscriptionManager,h as UNHANDLED,m as applyDiff,v as applyDiffToDb,n as applyDiffToSnapshot,x as applyDiffs,y as applyDiffsToDb,Q as classifyChanges,o as createBetterSqlite3Adapter,i as createSqlJsAdapter,f as createSqliteWasmAdapter,V as createTableDiff,l as defineEvents,E as defineMaterializer,X as diffSize,I as eventsContext,G as isClientSeq,Y as isDiffEmpty,H as isGlobalSeq,J as isInputEvent,Z as mergeDiffs,j as subscribeToMirror};

package/dist/packem_shared/{local-mirror.d-ByrYTq4z.d.ts → local-mirror.d-C1pwwvwS.d.ts}

@@ -1,4 +1,4 @@
-import { S as SqliteAdapter } from "./types.d-CkMkSwLJ.js";
+import { S as SqliteAdapter } from "./types.d-BuLTPLaQ.js";
 /**
  * Row-level change kind within a TableDiff.
  *

package/dist/packem_shared/{local-mirror.d-Cip3QuMf.d.mts → local-mirror.d-N1dkxd9A.d.mts}

@@ -1,4 +1,4 @@
-import { S as SqliteAdapter } from "./types.d-CkMkSwLJ.mjs";
+import { S as SqliteAdapter } from "./types.d-BuLTPLaQ.mjs";
 /**
  * Row-level change kind within a TableDiff.
  *

package/dist/packem_shared/subscribeToMirror-Rq100MXf.mjs

@@ -0,0 +1 @@
+const y=e=>`fn_${e.replaceAll(/[/:.]/g,"_")}`,w=e=>Array.isArray(e)?e:e!==null&&typeof e=="object"?[e]:[],d=(e,c,i,a,p)=>{const f=y(i.__lunoraRef);c.registerTable(f,{});let s=new Set;return e.subscribe(i,a,u=>{const b=w(u),r=new Set,t=[];for(const n of b){const l=n,o=l.id;(typeof o=="string"||typeof o=="number")&&r.add(String(o)),t.push({type:"insert",data:l})}for(const n of s)r.has(n)||t.push({type:"delete",id:n});if(t.length===0){s=r;return}c.applyDiff({table:f,changes:t,timestamp:Date.now()}),s=r},{shardKey:p})};export{d as subscribeToMirror};

package/dist/packem_shared/{types.d-CkMkSwLJ.d.ts → types.d-BuLTPLaQ.d.mts}

@@ -11,8 +11,6 @@ interface SqliteAdapter {
   close: () => void;
   /** Execute a SQL statement (with optional bound params). */
   exec: (sql: string, params?: ReadonlyArray<unknown>) => void;
-  /** Return the id of the last inserted row. */
-  lastInsertRowId: () => number;
   /**
    * Execute a SQL statement and return the result rows.
    * Columns can be accessed by index or by name.

package/dist/packem_shared/{types.d-CkMkSwLJ.d.mts → types.d-BuLTPLaQ.d.ts}

@@ -11,8 +11,6 @@ interface SqliteAdapter {
   close: () => void;
   /** Execute a SQL statement (with optional bound params). */
   exec: (sql: string, params?: ReadonlyArray<unknown>) => void;
-  /** Return the id of the last inserted row. */
-  lastInsertRowId: () => number;
   /**
    * Execute a SQL statement and return the result rows.
    * Columns can be accessed by index or by name.

package/dist/react.d.mts

@@ -1,5 +1,5 @@
-import { L as LocalMirror } from "./packem_shared/local-mirror.d-Cip3QuMf.mjs";
-import "./packem_shared/types.d-CkMkSwLJ.mjs";
+import { L as LocalMirror } from "./packem_shared/local-mirror.d-N1dkxd9A.mjs";
+import "./packem_shared/types.d-BuLTPLaQ.mjs";
 /**
  * Result of {@link useLocalQuery} — a discriminated union so callers get a
  * typed error instead of a swallowed `undefined`.
@@ -12,21 +12,6 @@ type LocalQueryResult<T> = {
   readonly data?: undefined;
   readonly error: Error;
 };
-/**
- * Options for the {@link useLocalQuery} hook.
- * @experimental
- */
-interface UseLocalQueryOptions {
-  /**
-   * Optional shard key (reserved for future use; currently unused).
-   *
-   * Intended for multi-mirror setups where a single app maintains multiple
-   * SQLite databases sharded by a key (e.g. user id, tenant id). Currently
-   * has no effect — the hook always queries the mirror passed as the first
-   * argument.
-   */
-  shardKey?: string;
-}
 /**
  * React hook that subscribes to a local SQLite query and returns
  * live-updating results whenever the mirror applies a diff.
@@ -57,8 +42,6 @@ interface UseLocalQueryOptions {
  * engine without rewriting).
  * @param params Optional positional bound parameters matching `?`
  * placeholders in `sql`.
- * @param _options Optional configuration (currently unused; reserved for
- * future features like shard key routing).
  * @returns `{ data }` with the result rows typed via the generic parameter
  * `T`, or `{ error }` when the query fails (e.g. malformed SQL, or the
  * target table doesn't exist yet because no matching diff has been applied
@@ -90,5 +73,5 @@ interface UseLocalQueryOptions {
  * ```
  * @experimental
  */
-declare const useLocalQuery: <T = Record<string, unknown>>(mirror: LocalMirror, sql: string, params?: ReadonlyArray<unknown>, _options?: UseLocalQueryOptions) => LocalQueryResult<T>;
-export { type LocalQueryResult, type UseLocalQueryOptions, useLocalQuery };
+declare const useLocalQuery: <T = Record<string, unknown>>(mirror: LocalMirror, sql: string, params?: ReadonlyArray<unknown>) => LocalQueryResult<T>;
+export { type LocalQueryResult, useLocalQuery };

package/dist/react.d.ts

@@ -1,5 +1,5 @@
-import { L as LocalMirror } from "./packem_shared/local-mirror.d-ByrYTq4z.js";
-import "./packem_shared/types.d-CkMkSwLJ.js";
+import { L as LocalMirror } from "./packem_shared/local-mirror.d-C1pwwvwS.js";
+import "./packem_shared/types.d-BuLTPLaQ.js";
 /**
  * Result of {@link useLocalQuery} — a discriminated union so callers get a
  * typed error instead of a swallowed `undefined`.
@@ -12,21 +12,6 @@ type LocalQueryResult<T> = {
   readonly data?: undefined;
   readonly error: Error;
 };
-/**
- * Options for the {@link useLocalQuery} hook.
- * @experimental
- */
-interface UseLocalQueryOptions {
-  /**
-   * Optional shard key (reserved for future use; currently unused).
-   *
-   * Intended for multi-mirror setups where a single app maintains multiple
-   * SQLite databases sharded by a key (e.g. user id, tenant id). Currently
-   * has no effect — the hook always queries the mirror passed as the first
-   * argument.
-   */
-  shardKey?: string;
-}
 /**
  * React hook that subscribes to a local SQLite query and returns
  * live-updating results whenever the mirror applies a diff.
@@ -57,8 +42,6 @@ interface UseLocalQueryOptions {
  * engine without rewriting).
  * @param params Optional positional bound parameters matching `?`
  * placeholders in `sql`.
- * @param _options Optional configuration (currently unused; reserved for
- * future features like shard key routing).
  * @returns `{ data }` with the result rows typed via the generic parameter
  * `T`, or `{ error }` when the query fails (e.g. malformed SQL, or the
  * target table doesn't exist yet because no matching diff has been applied
@@ -90,5 +73,5 @@ interface UseLocalQueryOptions {
  * ```
  * @experimental
  */
-declare const useLocalQuery: <T = Record<string, unknown>>(mirror: LocalMirror, sql: string, params?: ReadonlyArray<unknown>, _options?: UseLocalQueryOptions) => LocalQueryResult<T>;
-export { type LocalQueryResult, type UseLocalQueryOptions, useLocalQuery };
+declare const useLocalQuery: <T = Record<string, unknown>>(mirror: LocalMirror, sql: string, params?: ReadonlyArray<unknown>) => LocalQueryResult<T>;
+export { type LocalQueryResult, useLocalQuery };

package/dist/react.mjs

@@ -1 +1 @@
-import{useSyncExternalStore as i,useMemo as y}from"react";const u=t=>JSON.stringify(t??[],(r,n)=>typeof n=="bigint"?`${n.toString()}n`:n),p=(t,r,n,g)=>{const s=e=>t.onChange(e),o=()=>t.version,c=i(s,o,o),a=u(n);return y(()=>{try{return{data:t.query(r,n)}}catch(e){return{error:e instanceof Error?e:new Error(String(e))}}},[t,c,r,a])};export{p as useLocalQuery};
+import{useSyncExternalStore as y,useMemo as i}from"react";const u=t=>JSON.stringify(t??[],(r,e)=>typeof e=="bigint"?`${e.toString()}n`:e),S=(t,r,e)=>{const s=n=>t.onChange(n),o=()=>t.version,c=y(s,o,o),a=u(e);return i(()=>{try{return{data:t.query(r,e)}}catch(n){return{error:n instanceof Error?n:new Error(String(n))}}},[t,c,r,a])};export{S as useLocalQuery};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/replica",
-  "version": "1.0.0-alpha.72",
+  "version": "1.0.0-alpha.74",
   "description": "Local-first replica runtime + local SQLite mirror for Lunora",
   "keywords": [
     "cloudflare",

package/dist/packem_shared/subscribeToMirror-CX10AaP3.mjs

@@ -1 +0,0 @@
-const y=e=>`fn_${e.replaceAll(/[/:.]/g,"_")}`,w=e=>Array.isArray(e)?e:e!==null&&typeof e=="object"?[e]:[],d=(e,o,c,a,p)=>{const i=y(c.__lunoraRef);o.registerTable(i,{});let f=new Set;return e.subscribe(c,a,u=>{const b=w(u),n=new Set,r=[];for(const t of b){const l=t,s=l.id;(typeof s=="string"||typeof s=="number")&&n.add(String(s)),r.push({type:"insert",data:l})}for(const t of f)n.has(t)||r.push({type:"delete",id:t});f=n,r.length!==0&&o.applyDiff({table:i,changes:r,timestamp:Date.now()})},{shardKey:p})};export{d as subscribeToMirror};