@lunora/client 1.0.0-alpha.28 → 1.0.0-alpha.29

package/dist/packem_shared/{lunora-client.d-B1iZb2Ph.d.ts → lunora-client.d-Bt65hm_E.d.ts}

@@ -1234,6 +1234,7 @@ declare const createStream: <T>(options: {
   handle: StreamHandle<T>;
   iterable: StreamIterable<T>;
 };
+type WSState = "idle" | "connecting" | "open" | "closed";
 /**
  * Aggregate live-socket health across every shard connection, for a UI status
  * indicator. `idle` = no socket opened yet; `connecting` = at least one socket
@@ -1241,6 +1242,56 @@ declare const createStream: <T>(options: {
  * `offline` = sockets exist but all are down (between reconnect attempts).
  */
 type ConnectionStatus = "connected" | "connecting" | "idle" | "offline";
+/** One shard's socket + watermark state in a {@link LunoraClient.debug} snapshot. */
+interface ClientDebugShard {
+  /**
+   * Highest custom-mutator watermark the server has echoed for this client on this
+   * shard. A write whose `clientSeq` is above this has been sent but not confirmed
+   * — the first thing to check when an optimistic overlay won't clear.
+   */
+  confirmedMutationWatermark: number;
+  /** Whether a `WebSocket` object currently exists (distinct from it being open). */
+  hasSocket: boolean;
+  /** `undefined` for the default (unsharded) connection. */
+  shardKey: string | undefined;
+  /** Whether this shard's socket has ever completed a handshake — gates offline queueing. */
+  wasEverConnected: boolean;
+  wsState: WSState;
+}
+/** One live query or shape subscription in a {@link LunoraClient.debug} snapshot. */
+interface ClientDebugSubscription {
+  /** Whether the server has acknowledged the subscription on the current socket. */
+  acked: boolean;
+  /** `namespace:fn` for a query, `shape:&lt;name>` for a replication shape. */
+  functionPath: string;
+  id: string;
+  kind: "query" | "shape";
+  /** Highest custom-mutator watermark echoed on THIS subscription (absent until a `settled`/poke frame arrives). */
+  lastMutationId?: number;
+  /** Per-call optimistic layers still folded onto this subscription's value — a non-zero count with no pending write is a leak. */
+  pendingOptimisticLayers: number;
+  /** Replicated rowset size (shapes only). */
+  rowCount?: number;
+  /** The `__cdc_log` cursor the current value reflects. */
+  serverCursor?: number;
+  shardKey: string | undefined;
+  /** How many callers share this subscription (subscriptions are deduped by `(fn, args, shard)`). */
+  subscriberCount: number;
+}
+/**
+ * Everything the sync engine believes at one instant — see
+ * {@link LunoraClient.debug} for why this exists.
+ */
+interface ClientDebugSnapshot {
+  /** The watermark key the server's custom-mutator protocol advances per `clientSeq`. */
+  clientId: string;
+  closed: boolean;
+  connectionStatus: ConnectionStatus;
+  /** Writes waiting in the built-in offline queue (not the `@lunora/db` outbox). */
+  pendingWrites: number;
+  shards: ClientDebugShard[];
+  subscriptions: ClientDebugSubscription[];
+}
 /**
  * Terminal verdict for a mutation that passed through the offline queue,
  * delivered to {@link LunoraClient.onMutationSettled}.
@@ -1703,6 +1754,28 @@ declare class LunoraClient {
    * `LunoraDb.pendingCount()` instead (this counts only the built-in queue).
    */
   pendingCount(): number;
+  /**
+   * A point-in-time snapshot of everything the sync engine believes right now:
+   * per-shard sockets and watermarks, every live query and shape subscription with
+   * its cursor and ack state, and the offline-queue depth.
+   *
+   * This exists because the alternative is `console.log`. When an optimistic
+   * overlay doesn't clear, the questions are always the same — *is the socket open?
+   * what watermark has the server confirmed for this shard? has this shape been
+   * poked since my write? is anything stuck in the queue?* — and none of them were
+   * answerable from outside the client, so every adopter ends up instrumenting the
+   * library by hand or building a bespoke policy layer around a symptom.
+   *
+   * Read it from a devtools console, log it next to a bug report, or render it in a
+   * debug panel. Pull-only and allocation-cheap; nothing here is reactive, so poll
+   * it or read it on demand.
+   *
+   * ```ts
+   * const { shards, subscriptions } = client.debug();
+   * // shards: [{ shardKey: "user-1", wsState: "open", confirmedMutationWatermark: 42, … }]
+   * ```
+   */
+  debug(): ClientDebugSnapshot;
   /**
    * Subscribe to changes in {@link pendingCount}. Invokes `listener` immediately
    * with the current count, then whenever the queue depth changes (a write is
@@ -1856,6 +1929,67 @@ declare class LunoraClient {
   action<F extends FunctionReference>(function_: F, args: ArgsOf<F>, options?: {
     shardKey?: string;
   }): Promise<ReturnOf<F>>;
+  /**
+   * Bulk-import `rows` through a mutation that accepts a batch, chunked so a large
+   * dataset lands in a bounded number of round-trips.
+   *
+   * **Offline caveat:** each chunk is sent with {@link LunoraClient.mutation}, which
+   * resolves once the write is durably queued rather than once the server has applied
+   * it. So an import run while offline resolves `{ chunks, imported }` with nothing
+   * committed yet — the counts describe what was *handed over*, and the outbox
+   * replays them on reconnect. Don't report "migration complete" on this alone.
+   *
+   * This is the one-shot migration / seed path: "I have 20k rows client-side and a
+   * server mutation that inserts many at once". Doing it by hand goes wrong in two
+   * predictable ways — a serial per-row loop pays one round-trip *and* one watermark
+   * wait per row (a 200-row import becomes 200 sequential hops), while a single
+   * giant call blows the DO's batch limit. So: chunk, send sequentially, and give
+   * each chunk a stable idempotency key derived from `importId` + its index, so a
+   * resumed or retried import doesn't double-insert the chunks that already landed.
+   *
+   * The server mutation is yours (Lunora can't guess the table or the row shape);
+   * back it with `ctx.db.insertMany(...)`, or `insertManyUnsafe(...)` for data you
+   * vouch for. `chunkSize` defaults to 500, matching the DO's default batch cap.
+   *
+   * ```ts
+   * await client.importRows(api.migrate.importNodes, nodes, {
+   *     importId: `migrate-${userId}`,
+   *     onProgress: ({ done, total }) => setProgress(done / total),
+   *     shardKey: userId,
+   *     toArgs: (chunk) => ({ nodes: chunk }),
+   * });
+   * ```
+   */
+  importRows(function_: FunctionReference, rows: ReadonlyArray<unknown>, options?: {
+    /** Rows per call. Defaults to 500 — the DO's default batch cap. */
+    chunkSize?: number;
+    /**
+     * Stable id for this import run. Each chunk is sent under
+     * `${importId}:${chunkIndex}` as its mutation id, so a retry or a resumed
+     * import is deduped server-side instead of inserting the chunk twice.
+     * Omit only for a throwaway import where double-insertion is acceptable.
+     */
+    importId?: string;
+    /**
+     * Called after each chunk is accepted — for a progress bar.
+     *
+     * "Accepted" is not always "committed": while offline (or mid-reconnect) a
+     * `mutation` resolves as soon as the write is durably **queued**, so a fully
+     * offline import reports completion with nothing yet applied server-side.
+     * Gate a migration's "done" state on connectivity, not just on this.
+     */
+    onProgress?: (progress: {
+      done: number;
+      total: number;
+    }) => void;
+    /** Routes every chunk to one shard's DO. */
+    shardKey?: string;
+    /** Build the mutation args for one chunk. Defaults to `{ rows: chunk }`. */
+    toArgs?: (chunk: ReadonlyArray<unknown>) => Record<string, unknown>;
+  }): Promise<{
+    chunks: number;
+    imported: number;
+  }>;
   /**
    * Read the cross-shard request distribution for a `.shardBy(...)` table —
    * the feed the studio's `hot_shard` advisor lint consumes. Hits the
@@ -2842,4 +2976,4 @@ declare class LunoraClient {
    */
   private settleReplayBatchSlots;
 }
-export { ServerPokePartMessage as $, ArgsOf as A, BookmarkStorage as B, CONFLICT_ERROR_CODE as C, DEFAULT_MAX_BUFFER as D, OptimisticUpdate as E, FunctionReference as F, GlobalFacetResult as G, HttpStreamRef as H, OutboxMutation as I, OutboxSink as J, PersistedMutation as K, LunoraClient as L, MutationCallOptions as M, RowOp as N, OfflineQueueOptions as O, Preloaded as P, QueryCacheAdapter as Q, ReturnOf as R, SubscriptionError as S, RpcEnvelope as T, User as U, RpcResponseBody as V, ScheduleRecord as W, SchedulerPoolStatus as X, SchedulerStatus as Y, ServerMessage as Z, ServerPokeEndMessage as _, Unsubscribe as a, ServerPokeStartMessage as a0, ShardTrafficEntry as a1, ShardTrafficResult as a2, StorageListPage as a3, StorageObject as a4, StreamHandle as a5, SubscriptionCallback as a6, SubscriptionRegistry as a7, SubscriptionState as a8, SyncWatermark as a9, WorkflowInstanceAction as aa, WorkflowInstanceDetail as ab, WorkflowInstancePage as ac, WorkflowInstanceStatus as ad, WorkflowInstanceSummary as ae, WorkflowStepDetail as af, WsTokenProvider as ag, createClientQuery as ah, createLocalStore as ai, createStream as aj, getErrorCode as ak, getRetryAfterMs as al, isConflictError as am, isForbiddenError as an, isRateLimitedError as ao, isUnauthorizedError as ap, SubscriptionErrorCallback as b, PersistenceAdapter as c, HttpStreamArgsOf as d, HttpStreamChunkOf as e, StreamIterable as f, ReconnectOptions as g, BatchSlot as h, CachedQuery as i, ClientMessage as j, ClientQueryRef as k, ClientShapeSubscribeMessage as l, ClientShapeUnsubscribeMessage as m, ConnectionStatus as n, FunctionArgumentDescriptor as o, FunctionDescriptor as p, GlobalFacetValue as q, GlobalFilterClause as r, GlobalTableInfo as s, GlobalTablePage as t, HttpStreamCallArgs as u, LunoraClientError as v, LunoraClientOptions as w, LunoraErrorCode as x, MutationSettledEvent as y, OptimisticLocalStore as z };
+export { SchedulerStatus as $, ArgsOf as A, BookmarkStorage as B, CONFLICT_ERROR_CODE as C, DEFAULT_MAX_BUFFER as D, LunoraErrorCode as E, FunctionReference as F, GlobalFacetResult as G, HttpStreamRef as H, MutationSettledEvent as I, OptimisticLocalStore as J, OptimisticUpdate as K, LunoraClient as L, MutationCallOptions as M, OutboxMutation as N, OfflineQueueOptions as O, Preloaded as P, QueryCacheAdapter as Q, ReturnOf as R, SubscriptionError as S, OutboxSink as T, User as U, PersistedMutation as V, RowOp as W, RpcEnvelope as X, RpcResponseBody as Y, ScheduleRecord as Z, SchedulerPoolStatus as _, Unsubscribe as a, ServerMessage as a0, ServerPokeEndMessage as a1, ServerPokePartMessage as a2, ServerPokeStartMessage as a3, ShardTrafficEntry as a4, ShardTrafficResult as a5, StorageListPage as a6, StorageObject as a7, StreamHandle as a8, SubscriptionCallback as a9, SubscriptionRegistry as aa, SubscriptionState as ab, SyncWatermark as ac, WorkflowInstanceAction as ad, WorkflowInstanceDetail as ae, WorkflowInstancePage as af, WorkflowInstanceStatus as ag, WorkflowInstanceSummary as ah, WorkflowStepDetail as ai, WsTokenProvider as aj, createClientQuery as ak, createLocalStore as al, createStream as am, getErrorCode as an, getRetryAfterMs as ao, isConflictError as ap, isForbiddenError as aq, isRateLimitedError as ar, isUnauthorizedError as as, SubscriptionErrorCallback as b, PersistenceAdapter as c, HttpStreamArgsOf as d, HttpStreamChunkOf as e, StreamIterable as f, ReconnectOptions as g, BatchSlot as h, CachedQuery as i, ClientDebugShard as j, ClientDebugSnapshot as k, ClientDebugSubscription as l, ClientMessage as m, ClientQueryRef as n, ClientShapeSubscribeMessage as o, ClientShapeUnsubscribeMessage as p, ConnectionStatus as q, FunctionArgumentDescriptor as r, FunctionDescriptor as s, GlobalFacetValue as t, GlobalFilterClause as u, GlobalTableInfo as v, GlobalTablePage as w, HttpStreamCallArgs as x, LunoraClientError as y, LunoraClientOptions as z };

package/dist/packem_shared/offline-queue-D73Dq95V.mjs

@@ -0,0 +1 @@
+const c=(n,e)=>n!==void 0&&e!==n;let h=0;const a=()=>{if(typeof crypto<"u"&&typeof crypto.randomUUID=="function")return crypto.randomUUID();h+=1;const n=typeof crypto<"u"&&typeof crypto.getRandomValues=="function"?[...crypto.getRandomValues(new Uint8Array(8))].map(e=>e.toString(16).padStart(2,"0")).join(""):Math.random().toString(16).slice(2,12);return`m_${Date.now().toString(36)}_${h.toString(36)}_${n}`},r=(n,e,t,s)=>{if(n){n({error:t,mutationId:s,operation:e});return}console.warn(`[lunora] offline-queue persistence ${e} failed`,t)};class d{queueBeforeFirstConnect;maxItems;onPersistenceError;persistence;onEvict;onSizeChange;version;items=[];constructor(e={},t={}){this.maxItems=e.maxItems??1e3,this.queueBeforeFirstConnect=e.queueBeforeFirstConnect??!1,this.onPersistenceError=e.onPersistenceError,this.persistence=t.persistence,this.onEvict=t.onEvict,this.onSizeChange=t.onSizeChange,this.version=t.version}get size(){return this.items.length}enqueue(e){const t=e;for(t.id??=a(),this.items.push(t),this.persistence?.append({args:t.args,functionPath:t.functionPath,id:t.id,identity:t.identity,shardKey:t.shardKey,...this.version===void 0?{}:{version:this.version}}).catch(s=>{r(this.onPersistenceError,"append",s,t.id)});this.items.length>this.maxItems;){const s=this.items.shift();if(s){s.id&&this.persistence?.remove(s.id).catch(o=>{r(this.onPersistenceError,"remove",o,s.id)});const i=new Error("offline queue overflow");i.code="OFFLINE_QUEUE_OVERFLOW",s.reject(i),this.onEvict?.(s,i)}}this.notifySize()}async hydrate(){if(!this.persistence)return[];let e;try{e=await this.persistence.load()}catch(i){throw r(this.onPersistenceError,"load",i),i}const t=new Set,s=[];for(const i of e)if(!(this.items.some(o=>o.id===i.id)||s.some(o=>o.id===i.id))){if(c(this.version,i.version)){this.persistence.remove(i.id).catch(o=>{r(this.onPersistenceError,"remove",o,i.id)});continue}s.push({args:i.args,functionPath:i.functionPath,id:i.id,identity:i.identity,reject:()=>{},resolve:()=>{},shardKey:i.shardKey}),t.add(i.shardKey)}return this.items.unshift(...s),this.notifySize(),[...t]}drain(e){if(!e){const i=[...this.items];return this.items.length=0,this.notifySize(),i}const t=[],s=[];for(const i of this.items)(e(i)?t:s).push(i);return this.items.length=0,this.items.push(...s),this.notifySize(),t}requeue(e){e.length!==0&&(this.items.unshift(...e),this.notifySize())}drainConflict(){const e=[],t=[];for(const s of this.items)if(s.precondition!==void 0&&!s.precondition()){const i=new Error("offline mutation skipped: precondition failed before replay");i.code="OFFLINE_PRECONDITION_FAILED",s.reject(i),e.push(s)}else t.push(s);return e.length>0&&(this.items.length=0,this.items.push(...t),this.notifySize()),e}clear(){for(const e of this.items){const t=new Error("CLIENT_CLOSED");t.code="CLIENT_CLOSED",e.reject(t)}this.items.length=0,this.notifySize()}notifySize(){this.onSizeChange?.(this.items.length)}}export{d as c,c as d,r as s,a as u};

package/dist/packem_shared/{preload.d-CLwoXl3R.d.mts → preload.d-BmztUzzG.d.mts}

@@ -1,4 +1,4 @@
-import { F as FunctionReference, L as LunoraClient, A as ArgsOf, R as ReturnOf, P as Preloaded } from "./lunora-client.d-B1iZb2Ph.mjs";
+import { F as FunctionReference, L as LunoraClient, A as ArgsOf, R as ReturnOf, P as Preloaded } from "./lunora-client.d-Bt65hm_E.mjs";
 /**
  * Run a query once on the server (during SSR) and capture its result in a
  * serializable {@link Preloaded} token. Embed the token in the rendered HTML and

package/dist/packem_shared/{preload.d-Cqb4Kh2I.d.ts → preload.d-DGGRMWB5.d.ts}

@@ -1,4 +1,4 @@
-import { F as FunctionReference, L as LunoraClient, A as ArgsOf, R as ReturnOf, P as Preloaded } from "./lunora-client.d-B1iZb2Ph.js";
+import { F as FunctionReference, L as LunoraClient, A as ArgsOf, R as ReturnOf, P as Preloaded } from "./lunora-client.d-Bt65hm_E.js";
 /**
  * Run a query once on the server (during SSR) and capture its result in a
  * serializable {@link Preloaded} token. Embed the token in the rendered HTML and

package/dist/packem_shared/preloadQuery-DjwSjFwt.mjs

@@ -0,0 +1 @@
+const l=async(e,a,r,u={})=>{const o=await e.query(a,r,u);return{__lunoraPreloaded:!0,args:r??{},functionPath:a.__lunoraRef,shardKey:u.shardKey,value:o}},t=e=>e.value;export{l as preloadQuery,t as preloadedQueryResult};

package/dist/packem_shared/wire-key-D_zOxXK4.mjs

@@ -0,0 +1 @@
+const m=(e,t)=>e<t?-1:e>t?1:0,p=e=>{if(e===void 0)return"null";if(typeof e=="bigint")throw new TypeError("stableStringify: cannot use a bigint in a stable JSON cache key — pass it as a string, or use stableWireKey");if(e===null||typeof e!="object")return JSON.stringify(e);if(Array.isArray(e))return`[${e.map(o=>p(o)).join(",")}]`;const t=Object.getPrototypeOf(e);if(t!==null&&t!==Object.prototype){const o=e.constructor?.name??"value";throw new TypeError(`stableStringify: cannot use a ${o} in a stable JSON cache key — only plain objects, arrays, and JSON primitives are supported (wire-typed values key via stableWireKey)`)}const i=e,c=Object.keys(i).toSorted(m),n=[];for(const o of c){const r=i[o];r!==void 0&&n.push(`${JSON.stringify(o)}:${p(r)}`)}return`{${n.join(",")}}`},b=e=>{let t="";for(let i=0;i<e.length;i+=32768)t+=String.fromCharCode(...e.subarray(i,i+32768));return btoa(t)},A=e=>{const t=atob(e),i=new Uint8Array(t.length);for(let c=0;c<t.length;c+=1)i[c]=t.codePointAt(c)??0;return i},s="$lunora.wire$";const g="__proto__",d={BigInt64Array,BigUint64Array,Float32Array,Float64Array,Int8Array,Int16Array,Int32Array,Uint8Array,Uint8ClampedArray,Uint16Array,Uint32Array},w={Error,EvalError,RangeError,ReferenceError,SyntaxError,TypeError,URIError},l=(e,t=0)=>{if(t>64)throw new RangeError("wire-codec: value nesting exceeds the 64-level limit");if(e===void 0)return[s,"undefined"];if(e===null)return null;const i=typeof e;if(i==="bigint")return[s,"bigint",e.toString()];if(i==="number"){const r=e;return Number.isNaN(r)?[s,"nan"]:r===1/0?[s,"inf"]:r===-1/0?[s,"-inf"]:r}if(i!=="object")return e;if(e instanceof Date)return[s,"date",l(e.getTime(),t+1)];if(e instanceof Error){const r=e,a={};for(const y of Object.keys(r))r[y]!==void 0&&(a[y]=l(r[y],t+1));const f=[s,"error",r.name,r.message,a];return r.cause!==void 0&&f.push(l(r.cause,t+1)),f}if(e instanceof URL)return[s,"url",e.href];if(e instanceof Map)return[s,"map",[...e.entries()].map(([r,a])=>[l(r,t+1),l(a,t+1)])];if(e instanceof Set)return[s,"set",[...e].map(r=>l(r,t+1))];if(e instanceof ArrayBuffer)return[s,"bytes",b(new Uint8Array(e)),"ArrayBuffer"];if(ArrayBuffer.isView(e)){const r=e,a=r.constructor.name,f=new Uint8Array(r.buffer,r.byteOffset,r.byteLength);return a==="Uint8Array"?[s,"bytes",b(f)]:[s,"bytes",b(f),a]}if(Array.isArray(e)){const r=e.map(a=>l(a,t+1));return r.length>0&&r[0]===s?[s,"arr",r]:r}const c=Object.getPrototypeOf(e);if(c!==null&&c!==Object.prototype){const r=e.constructor?.name??"value";throw new TypeError(`wire-codec: cannot encode a ${r} over the Lunora wire — only plain objects, arrays, and the supported built-ins (Date, Error, URL, Map, Set, ArrayBuffer/typed arrays, bigint) round-trip`)}const n=e,o={};for(const r of Object.keys(n)){const a=n[r];a!==void 0&&(o[r]=l(a,t+1))}return o},u=(e,t=0)=>{if(t>64)throw new RangeError("wire-codec: value nesting exceeds the 64-level limit");if(e===null||typeof e!="object")return e;if(Array.isArray(e)){if(e[0]===s)switch(e[1]){case"-inf":return-1/0;case"arr":return e[2].map(n=>u(n,t+1));case"bigint":{const n=e[2];if(typeof n!="string"||n.length>1024||!/^-?\d+$/.test(n))throw new RangeError("wire-codec: invalid or over-long bigint (max 1024 digits)");return BigInt(n)}case"date":return new Date(u(e[2],t+1));case"map":return new Map(e[2].map(([n,o])=>[u(n,t+1),u(o,t+1)]));case"set":return new Set(e[2].map(n=>u(n,t+1)));case"url":return new URL(e[2]);case"error":{const n=e[2],o=e[3],r=(Object.hasOwn(w,n)?w[n]:void 0)??Error,a=new r(o);a.name!==n&&Object.defineProperty(a,"name",{configurable:!0,value:n,writable:!0});const f=u(e[4],t+1);for(const y of Object.keys(f))y===g?Object.defineProperty(a,y,{configurable:!0,enumerable:!0,value:f[y],writable:!0}):a[y]=f[y];return e.length>5&&Object.defineProperty(a,"cause",{configurable:!0,value:u(e[5],t+1),writable:!0}),a}case"bytes":{const n=A(e[2]),o=e[3]??"Uint8Array";if(o==="ArrayBuffer")return n.buffer.byteLength===n.byteLength?n.buffer:n.slice().buffer;const r=Object.hasOwn(d,o)?d[o]:void 0;return r?new r(n.slice().buffer):n}case"inf":return 1/0;case"nan":return Number.NaN;case"undefined":return;default:return e.map(n=>u(n,t+1))}return e.map(n=>u(n,t+1))}const i=e,c={};for(const n of Object.keys(i)){const o=u(i[n],t+1);n===g?Object.defineProperty(c,n,{configurable:!0,enumerable:!0,value:o,writable:!0}):c[n]=o}return c},h=e=>p(l(e));export{u as c,l as f,h as t};

package/dist/pagination/index.mjs

@@ -1,61 +1 @@
-const SPLIT_FACTOR = 2;
-const JOIN_FACTOR = 0.5;
-const initialPages = (numberItems) => [
-  // eslint-disable-next-line unicorn/no-null -- `lower: null` is the feed head, `upper: null` the open-ended tail — both are wire-shape cursors.
-  { lower: null, numItems: numberItems, upper: null }
-];
-const rebalance = (pages, results) => {
-  for (const [index, page] of pages.entries()) {
-    if (page.upper === null) {
-      continue;
-    }
-    const result = results[index];
-    if (!result) {
-      continue;
-    }
-    const size = result.page.length;
-    if (size > SPLIT_FACTOR * page.numItems && result.splitCursor) {
-      const split = result.splitCursor;
-      const next = [...pages];
-      next.splice(index, 1, { lower: page.lower, numItems: page.numItems, upper: split }, { lower: split, numItems: page.numItems, upper: page.upper });
-      return next;
-    }
-    if (size < JOIN_FACTOR * page.numItems && index + 1 < pages.length) {
-      const neighbour = pages[index + 1];
-      if (!neighbour) {
-        continue;
-      }
-      const next = [...pages];
-      next.splice(index, 2, { lower: page.lower, numItems: page.numItems, upper: neighbour.upper });
-      return next;
-    }
-  }
-  return void 0;
-};
-const derivePaginationStatus = (skipped, pageResults) => {
-  if (skipped || !pageResults[0]) {
-    return { nextCursor: void 0, status: "LoadingFirstPage" };
-  }
-  const tail = pageResults.at(-1);
-  if (!tail) {
-    return { nextCursor: void 0, status: "LoadingMore" };
-  }
-  if (tail.isDone || tail.continueCursor === null) {
-    return { nextCursor: void 0, status: "Exhausted" };
-  }
-  return { nextCursor: tail.continueCursor, status: "CanLoadMore" };
-};
-const applyLoadMore = (pages, cursor, numberItems) => {
-  if (cursor === void 0 || cursor === null) {
-    return void 0;
-  }
-  const next = [...pages];
-  const tail = next.at(-1);
-  if (tail) {
-    next[next.length - 1] = { lower: tail.lower, numItems: tail.numItems, upper: cursor };
-  }
-  next.push({ lower: cursor, numItems: numberItems, upper: null });
-  return next;
-};
-
-export { JOIN_FACTOR, SPLIT_FACTOR, applyLoadMore, derivePaginationStatus, initialPages, rebalance };
+const l=2,a=.5,p=r=>[{lower:null,numItems:r,upper:null}],m=(r,s)=>{for(const[n,e]of r.entries()){if(e.upper===null)continue;const t=s[n];if(!t)continue;const i=t.page.length;if(i>2*e.numItems&&t.splitCursor){const u=t.splitCursor,o=[...r];return o.splice(n,1,{lower:e.lower,numItems:e.numItems,upper:u},{lower:u,numItems:e.numItems,upper:e.upper}),o}if(i<.5*e.numItems&&n+1<r.length){const u=r[n+1];if(!u)continue;const o=[...r];return o.splice(n,2,{lower:e.lower,numItems:e.numItems,upper:u.upper}),o}}},c=(r,s)=>{if(r||!s[0])return{nextCursor:void 0,status:"LoadingFirstPage"};const n=s.at(-1);return n?n.isDone||n.continueCursor===null?{nextCursor:void 0,status:"Exhausted"}:{nextCursor:n.continueCursor,status:"CanLoadMore"}:{nextCursor:void 0,status:"LoadingMore"}},I=(r,s,n)=>{if(s==null)return;const e=[...r],t=e.at(-1);return t&&(e[e.length-1]={lower:t.lower,numItems:t.numItems,upper:s}),e.push({lower:s,numItems:n,upper:null}),e};export{a as JOIN_FACTOR,l as SPLIT_FACTOR,I as applyLoadMore,c as derivePaginationStatus,p as initialPages,m as rebalance};

package/dist/query/index.d.mts

@@ -1,5 +1,5 @@
-import { S as SubscriptionError, F as FunctionReference, A as ArgsOf, R as ReturnOf, L as LunoraClient, a as Unsubscribe } from "../packem_shared/lunora-client.d-B1iZb2Ph.mjs";
-export type { b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-B1iZb2Ph.mjs";
+import { S as SubscriptionError, F as FunctionReference, A as ArgsOf, R as ReturnOf, L as LunoraClient, a as Unsubscribe } from "../packem_shared/lunora-client.d-Bt65hm_E.mjs";
+export type { b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-Bt65hm_E.mjs";
 import '@lunora/runtime';
 /**
  * The sentinel a framework adapter resolves its reactive args to when it wants

package/dist/query/index.d.ts

@@ -1,5 +1,5 @@
-import { S as SubscriptionError, F as FunctionReference, A as ArgsOf, R as ReturnOf, L as LunoraClient, a as Unsubscribe } from "../packem_shared/lunora-client.d-B1iZb2Ph.js";
-export type { b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-B1iZb2Ph.js";
+import { S as SubscriptionError, F as FunctionReference, A as ArgsOf, R as ReturnOf, L as LunoraClient, a as Unsubscribe } from "../packem_shared/lunora-client.d-Bt65hm_E.js";
+export type { b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-Bt65hm_E.js";
 import '@lunora/runtime';
 /**
  * The sentinel a framework adapter resolves its reactive args to when it wants

package/dist/query/index.mjs

@@ -1 +1 @@
-export { SKIP, createQuerySubscription, toSubscriptionError } from '../packem_shared/SKIP-vItZChkw.mjs';
+import{SKIP as t,createQuerySubscription as e,toSubscriptionError as i}from"../packem_shared/SKIP-CArzT3Vl.mjs";export{t as SKIP,e as createQuerySubscription,i as toSubscriptionError};

package/dist/ssr/index.d.mts

@@ -1,6 +1,6 @@
-import { P as Preloaded, L as LunoraClient } from "../packem_shared/lunora-client.d-B1iZb2Ph.mjs";
-export type { A as ArgsOf, F as FunctionReference, R as ReturnOf } from "../packem_shared/lunora-client.d-B1iZb2Ph.mjs";
-export { p as preloadQuery, a as preloadedQueryResult } from "../packem_shared/preload.d-CLwoXl3R.mjs";
+import { P as Preloaded, L as LunoraClient } from "../packem_shared/lunora-client.d-Bt65hm_E.mjs";
+export type { A as ArgsOf, F as FunctionReference, R as ReturnOf } from "../packem_shared/lunora-client.d-Bt65hm_E.mjs";
+export { p as preloadQuery, a as preloadedQueryResult } from "../packem_shared/preload.d-BmztUzzG.mjs";
 import '@lunora/runtime';
 /**
  * Structural shape of a better-auth `getSession` call's resolved value.

package/dist/ssr/index.d.ts

@@ -1,6 +1,6 @@
-import { P as Preloaded, L as LunoraClient } from "../packem_shared/lunora-client.d-B1iZb2Ph.js";
-export type { A as ArgsOf, F as FunctionReference, R as ReturnOf } from "../packem_shared/lunora-client.d-B1iZb2Ph.js";
-export { p as preloadQuery, a as preloadedQueryResult } from "../packem_shared/preload.d-Cqb4Kh2I.js";
+import { P as Preloaded, L as LunoraClient } from "../packem_shared/lunora-client.d-Bt65hm_E.js";
+export type { A as ArgsOf, F as FunctionReference, R as ReturnOf } from "../packem_shared/lunora-client.d-Bt65hm_E.js";
+export { p as preloadQuery, a as preloadedQueryResult } from "../packem_shared/preload.d-DGGRMWB5.js";
 import '@lunora/runtime';
 /**
  * Structural shape of a better-auth `getSession` call's resolved value.

package/dist/ssr/index.mjs

@@ -1,4 +1 @@
-export { getServerSession } from '../packem_shared/getServerSession-8jXewqxd.mjs';
-export { deserializePreloaded, serializePreloaded } from '../packem_shared/deserializePreloaded-C0eJTY_W.mjs';
-export { createServerClient } from '../packem_shared/createServerClient-Bp2r9tcB.mjs';
-export { preloadQuery, preloadedQueryResult } from '../packem_shared/preloadQuery-lobFkD2Z.mjs';
+import{getServerSession as o}from"../packem_shared/getServerSession-CGjgRBAE.mjs";import{deserializePreloaded as l,serializePreloaded as t}from"../packem_shared/deserializePreloaded-CHfOFpka.mjs";import{createServerClient as i}from"../packem_shared/createServerClient-B7KqO8tv.mjs";import{preloadQuery as s,preloadedQueryResult as f}from"../packem_shared/preloadQuery-DjwSjFwt.mjs";export{i as createServerClient,l as deserializePreloaded,o as getServerSession,s as preloadQuery,f as preloadedQueryResult,t as serializePreloaded};

package/dist/upload.mjs

@@ -1,24 +1 @@
-import { createMultipartAdapter, createChunkedRestAdapter, createTusAdapter } from '@visulima/storage-client';
-export { LocalStorageUrlStorage, MemoryUrlStorage, RestrictionError, UploadControl, UploadError, createChunkedRestAdapter, createMultipartAdapter, createTusAdapter, putFile, validateFile, validateFiles } from '@visulima/storage-client';
-
-const createUpload = (options) => {
-  const protocol = options.protocol ?? "tus";
-  const { chunkSize, control, endpoint, headers, maxRetries, metadata, restrictions, retry } = options;
-  if (protocol === "multipart") {
-    const multipartOptions = { endpoint, headers, maxRetries, metadata, restrictions, retry };
-    return createMultipartAdapter(multipartOptions);
-  }
-  const resumableOptions = {
-    chunkSize,
-    control,
-    endpoint,
-    headers,
-    maxRetries,
-    metadata,
-    restrictions,
-    retry
-  };
-  return protocol === "chunked-rest" ? createChunkedRestAdapter(resumableOptions) : createTusAdapter(resumableOptions);
-};
-
-export { createUpload };
+import{createMultipartAdapter as l,createChunkedRestAdapter as u,createTusAdapter as m}from"@visulima/storage-client";import{LocalStorageUrlStorage as x,MemoryUrlStorage as S,RestrictionError as U,UploadControl as y,UploadError as f,createChunkedRestAdapter as g,createMultipartAdapter as C,createTusAdapter as F,putFile as M,validateFile as v,validateFiles as z}from"@visulima/storage-client";const A=e=>{const t=e.protocol??"tus",{chunkSize:c,control:p,endpoint:r,headers:a,maxRetries:o,metadata:i,restrictions:d,retry:n}=e;if(t==="multipart")return l({endpoint:r,headers:a,maxRetries:o,metadata:i,restrictions:d,retry:n});const s={chunkSize:c,control:p,endpoint:r,headers:a,maxRetries:o,metadata:i,restrictions:d,retry:n};return t==="chunked-rest"?u(s):m(s)};export{x as LocalStorageUrlStorage,S as MemoryUrlStorage,U as RestrictionError,y as UploadControl,f as UploadError,g as createChunkedRestAdapter,C as createMultipartAdapter,F as createTusAdapter,A as createUpload,M as putFile,v as validateFile,z as validateFiles};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/client",
-  "version": "1.0.0-alpha.28",
+  "version": "1.0.0-alpha.29",
   "description": "Lunora browser SDK: WebSocket transport, optimistic updates, and an offline mutation queue",
   "keywords": [
     "cloudflare",

package/dist/packem_shared/CONFLICT_ERROR_CODE-B8gQ8tyU.mjs

@@ -1,33 +0,0 @@
-const LUNORA_ERROR_CODES = [
-  "BAD_REQUEST",
-  "CONFLICT",
-  "COUNT_RLS_UNSUPPORTED",
-  "FORBIDDEN",
-  "INTERNAL_SERVER_ERROR",
-  "MASK_UNSUPPORTED",
-  "NOT_FOUND",
-  "NOT_IMPLEMENTED",
-  "RELATION_PREDICATE_UNSUPPORTED",
-  "TOO_MANY_REQUESTS",
-  "UNAUTHORIZED",
-  "UNPROCESSABLE"
-];
-const KNOWN_ERROR_CODES = new Set(LUNORA_ERROR_CODES);
-const CONFLICT_ERROR_CODE = "CONFLICT";
-const isConflictError = (error) => error instanceof Error && error.code === CONFLICT_ERROR_CODE;
-const isForbiddenError = (error) => error instanceof Error && error.code === "FORBIDDEN";
-const isUnauthorizedError = (error) => error instanceof Error && error.code === "UNAUTHORIZED";
-const isRateLimitedError = (error) => error instanceof Error && error.code === "TOO_MANY_REQUESTS";
-const getErrorCode = (error) => {
-  if (!(error instanceof Error)) {
-    return void 0;
-  }
-  const { code } = error;
-  return typeof code === "string" && KNOWN_ERROR_CODES.has(code) ? code : void 0;
-};
-const getRetryAfterMs = (error) => {
-  const value = error?.data?.retryAfterMs;
-  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
-};
-
-export { CONFLICT_ERROR_CODE, getErrorCode, getRetryAfterMs, isConflictError, isForbiddenError, isRateLimitedError, isUnauthorizedError };

package/dist/packem_shared/ClientServiceWorker-C3PAFwy0.mjs

@@ -1,100 +0,0 @@
-class ClientServiceWorker {
-  swUrl;
-  scope;
-  #registration = void 0;
-  #status = "unregistered";
-  #onStatusChange;
-  #messageHandlers = /* @__PURE__ */ new Set();
-  constructor(options) {
-    this.swUrl = options.swUrl;
-    this.scope = options.scope ?? "/";
-    this.#onStatusChange = options.onStatusChange;
-  }
-  // ── Status ──────────────────────────────────────────────────────────
-  /** Current registration status. */
-  get status() {
-    return this.#status;
-  }
-  /** The underlying `ServiceWorkerRegistration`, if registered. */
-  get registration() {
-    return this.#registration;
-  }
-  /** Whether the SW is currently controlling this page. */
-  get active() {
-    return this.#registration?.active !== null && this.#registration?.active !== void 0;
-  }
-  // ── Registration ────────────────────────────────────────────────────
-  /**
-   * Register the service worker.
-   *
-   * Returns `false` when the browser does not support service workers.
-   */
-  async register() {
-    if (!("serviceWorker" in navigator)) {
-      this.#setStatus("unsupported");
-      return false;
-    }
-    this.#setStatus("registering");
-    try {
-      this.#registration = await navigator.serviceWorker.register(this.swUrl, {
-        scope: this.scope
-      });
-      this.#setStatus("active");
-      navigator.serviceWorker.addEventListener("message", this.#onMessage);
-    } catch {
-      this.#setStatus("error");
-      return false;
-    }
-    return true;
-  }
-  /**
-   * Remove the active service worker registration and clear listeners.
-   *
-   * Returns `false` when no registration is currently held.
-   */
-  async unregister() {
-    if (!this.#registration) {
-      return false;
-    }
-    navigator.serviceWorker.removeEventListener("message", this.#onMessage);
-    const ok = await this.#registration.unregister();
-    this.#registration = void 0;
-    this.#setStatus("unregistered");
-    return ok;
-  }
-  // ── Messaging ───────────────────────────────────────────────────────
-  /**
-   * Send a message to the active service worker.
-   */
-  postMessage(message) {
-    const active = this.#registration?.active;
-    if (active) {
-      active.postMessage(message);
-    }
-  }
-  /**
-   * Register a handler for messages **from** the service worker.
-   * @returns Unsubscribe function.
-   */
-  onMessage(handler) {
-    this.#messageHandlers.add(handler);
-    return () => {
-      this.#messageHandlers.delete(handler);
-    };
-  }
-  // ── Internals ───────────────────────────────────────────────────────
-  #setStatus(status) {
-    this.#status = status;
-    this.#onStatusChange?.(status);
-  }
-  #onMessage = (event) => {
-    for (const handler of this.#messageHandlers) {
-      try {
-        handler(event);
-      } catch {
-      }
-    }
-  };
-}
-
-export { ClientServiceWorker };

package/dist/packem_shared/DEFAULT_MAX_BUFFER-7hFnzNk9.mjs

@@ -1,110 +0,0 @@
-import { LunoraError } from '@lunora/errors';
-
-const DEFAULT_MAX_BUFFER = 1024;
-const createStream = (options) => {
-  const maxBuffer = options.maxBuffer ?? DEFAULT_MAX_BUFFER;
-  const buffer = [];
-  const pending = [];
-  let done = false;
-  let failure;
-  let cancelled = false;
-  const flushOne = () => {
-    const waiter = pending.shift();
-    if (!waiter) {
-      return false;
-    }
-    if (failure) {
-      waiter.reject(failure);
-      return true;
-    }
-    if (buffer.length > 0) {
-      const value = buffer.shift();
-      waiter.resolve({ done: false, value });
-      return true;
-    }
-    if (done) {
-      waiter.resolve({ done: true, value: void 0 });
-      return true;
-    }
-    pending.unshift(waiter);
-    return false;
-  };
-  const handle = {
-    complete() {
-      if (done || failure) {
-        return;
-      }
-      done = true;
-      while (flushOne()) {
-      }
-    },
-    fail(error) {
-      if (done || failure) {
-        return;
-      }
-      failure = error;
-      buffer.length = 0;
-      while (flushOne()) {
-      }
-    },
-    push(value) {
-      if (done || failure || cancelled) {
-        return;
-      }
-      if (buffer.length >= maxBuffer) {
-        handle.fail(
-          new LunoraError(
-            "STREAM_BACKPRESSURE",
-            `stream buffer overflow (max=${maxBuffer.toString()}); the consumer cannot keep up with the producer`
-          )
-        );
-        return;
-      }
-      buffer.push(value);
-      flushOne();
-    }
-  };
-  const cancel = () => {
-    if (cancelled) {
-      return;
-    }
-    cancelled = true;
-    done = true;
-    buffer.length = 0;
-    try {
-      options.onCancel();
-    } catch {
-    }
-    while (flushOne()) {
-    }
-  };
-  const iterable = {
-    cancel,
-    [Symbol.asyncIterator]() {
-      return {
-        next() {
-          if (failure) {
-            return Promise.reject(failure);
-          }
-          if (buffer.length > 0) {
-            const value = buffer.shift();
-            return Promise.resolve({ done: false, value });
-          }
-          if (done) {
-            return Promise.resolve({ done: true, value: void 0 });
-          }
-          return new Promise((resolve, reject) => {
-            pending.push({ reject, resolve });
-          });
-        },
-        return() {
-          cancel();
-          return Promise.resolve({ done: true, value: void 0 });
-        }
-      };
-    }
-  };
-  return { handle, iterable };
-};
-
-export { DEFAULT_MAX_BUFFER, createStream };