@lunora/client 1.0.0-alpha.8 → 1.0.0-alpha.80

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

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

package/dist/packem_shared/preload.d-BWPg1lFK.d.ts

@@ -0,0 +1,21 @@
+import { L as LunoraClient, P as Preloaded } from "./lunora-client.d-DiKeST-Z.js";
+import { F as FunctionReference, A as ArgsOf, R as ReturnOf } from "./function-reference.d-Br_hsKje.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
+ * pass it to `usePreloadedQuery` on the client: the first client render shows
+ * the server value with no loading flash, then a live subscription takes over.
+ *
+ * The query is executed through the supplied {@link LunoraClient} over the same
+ * HTTP RPC path the browser uses, so the SSR client only needs a `fetch`
+ * implementation that can reach the worker — no in-process Durable Object access.
+ */
+declare const preloadQuery: <F extends FunctionReference>(client: LunoraClient, function_: F, args: ArgsOf<F>, options?: {
+  shardKey?: string;
+}) => Promise<Preloaded<ReturnOf<F>>>;
+/**
+ * Read the captured value out of a {@link Preloaded} token without subscribing.
+ * Useful on the server (or in tests) when you only need the data, not a live feed.
+ */
+declare const preloadedQueryResult: <T>(preloaded: Preloaded<T>) => T;
+export { preloadedQueryResult as a, preloadQuery as p };

package/dist/packem_shared/preload.d-BfLwnKiD.d.mts

@@ -0,0 +1,21 @@
+import { L as LunoraClient, P as Preloaded } from "./lunora-client.d-D6g91j8X.mjs";
+import { F as FunctionReference, A as ArgsOf, R as ReturnOf } from "./function-reference.d-Br_hsKje.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
+ * pass it to `usePreloadedQuery` on the client: the first client render shows
+ * the server value with no loading flash, then a live subscription takes over.
+ *
+ * The query is executed through the supplied {@link LunoraClient} over the same
+ * HTTP RPC path the browser uses, so the SSR client only needs a `fetch`
+ * implementation that can reach the worker — no in-process Durable Object access.
+ */
+declare const preloadQuery: <F extends FunctionReference>(client: LunoraClient, function_: F, args: ArgsOf<F>, options?: {
+  shardKey?: string;
+}) => Promise<Preloaded<ReturnOf<F>>>;
+/**
+ * Read the captured value out of a {@link Preloaded} token without subscribing.
+ * Useful on the server (or in tests) when you only need the data, not a live feed.
+ */
+declare const preloadedQueryResult: <T>(preloaded: Preloaded<T>) => T;
+export { preloadedQueryResult as a, preloadQuery as p };

package/dist/packem_shared/preloadQuery-uFy24PCR.mjs

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

package/dist/packem_shared/single-blob-store-DrhzObic.mjs

@@ -0,0 +1 @@
+const s=(t,r)=>{let n=Promise.resolve();const i=e=>{const o=n.then(e,e);return n=o.then(()=>{},()=>{}),o};return{clear:()=>i(()=>t.removeItem(r)),read:async()=>{const e=await t.getItem(r);if(e!==null)try{return JSON.parse(e)}catch{return}},serialize:i,write:e=>t.setItem(r,JSON.stringify(e))}};export{s};

package/dist/packem_shared/wire-codec-BiYbPSuZ.mjs

@@ -0,0 +1 @@
+const w=e=>{let t="";for(let o=0;o<e.length;o+=32768)t+=String.fromCharCode(...e.subarray(o,o+32768));return btoa(t)},p=e=>{const t=atob(e),a=new Uint8Array(t.length);for(let o=0;o<t.length;o+=1)a[o]=t.codePointAt(o)??0;return a},i="$lunora.wire$";const m="__proto__",g={BigInt64Array,BigUint64Array,Float32Array,Float64Array,Int8Array,Int16Array,Int32Array,Uint8Array,Uint8ClampedArray,Uint16Array,Uint32Array},A={Error,EvalError,RangeError,ReferenceError,SyntaxError,TypeError,URIError},l=e=>{if(e===null||typeof e!="object")return!1;const t=Object.getPrototypeOf(e);return t===null||t===Object.prototype},b=(e,t=0)=>{if(t>64)throw new RangeError("wire-codec: value nesting exceeds the 64-level limit");if(e===void 0)return[i,"undefined"];if(e===null)return null;const a=typeof e;if(a==="bigint")return[i,"bigint",e.toString()];if(a==="number"){const r=e;return Number.isNaN(r)?[i,"nan"]:r===1/0?[i,"inf"]:r===-1/0?[i,"-inf"]:r}if(a!=="object")return e;if(e instanceof Date)return[i,"date",b(e.getTime(),t+1)];if(e instanceof Error){const r=e,n={};for(const c of Object.keys(r)){if(r[c]===void 0)continue;const u=b(r[c],t+1);c===m?Object.defineProperty(n,c,{configurable:!0,enumerable:!0,value:u,writable:!0}):n[c]=u}const s=[i,"error",r.name,r.message,n];return r.cause!==void 0&&s.push(b(r.cause,t+1)),s}if(e instanceof URL)return[i,"url",e.href];if(e instanceof Map)return[i,"map",[...e.entries()].map(([r,n])=>[b(r,t+1),b(n,t+1)])];if(e instanceof Set)return[i,"set",[...e].map(r=>b(r,t+1))];if(e instanceof ArrayBuffer)return[i,"bytes",w(new Uint8Array(e)),"ArrayBuffer"];if(ArrayBuffer.isView(e)){const r=e,n=r.constructor.name,s=new Uint8Array(r.buffer,r.byteOffset,r.byteLength);return n==="Uint8Array"?[i,"bytes",w(s)]:[i,"bytes",w(s),n]}if(Array.isArray(e)){const r=e.map(n=>b(n,t+1));return r.length>0&&r[0]===i?[i,"arr",r]:r}if(!l(e)){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 o=e,f={};for(const r of Object.keys(o)){const n=o[r];if(n===void 0)continue;const s=b(n,t+1);r===m?Object.defineProperty(f,r,{configurable:!0,enumerable:!0,value:s,writable:!0}):f[r]=s}return f},y=(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]===i)switch(e[1]){case"-inf":return-1/0;case"arr":return e[2].map(r=>y(r,t+1));case"bigint":{const r=e[2];if(typeof r!="string"||r.length>1024||!/^-?\d+$/.test(r))throw new RangeError("wire-codec: invalid or over-long bigint (max 1024 digits)");return BigInt(r)}case"date":{const r=y(e[2],t+1);if(typeof r!="number")throw new TypeError("wire-codec: malformed date — epoch must be a number");return new Date(r)}case"map":{const r=e[2];return new Map(r.map(n=>{if(!Array.isArray(n)||n.length!==2)throw new TypeError("wire-codec: malformed map entry — expected a [key, value] pair");return[y(n[0],t+1),y(n[1],t+1)]}))}case"set":return new Set(e[2].map(r=>y(r,t+1)));case"url":{const r=e[2];if(typeof r!="string")throw new TypeError("wire-codec: malformed url — href must be a string");return new URL(r)}case"error":{const r=e[2],n=e[3],s=(Object.hasOwn(A,r)?A[r]:void 0)??Error,c=new s(n);c.name!==r&&Object.defineProperty(c,"name",{configurable:!0,value:r,writable:!0});const u=y(e[4],t+1);if(u===null||typeof u!="object"||Array.isArray(u))throw new TypeError("wire-codec: malformed error — props must be an object");for(const d of Object.keys(u))d===m?Object.defineProperty(c,d,{configurable:!0,enumerable:!0,value:u[d],writable:!0}):c[d]=u[d];return e.length>5&&Object.defineProperty(c,"cause",{configurable:!0,value:y(e[5],t+1),writable:!0}),c}case"bytes":{const r=e[2];if(typeof r!="string")throw new TypeError("wire-codec: malformed bytes — payload must be a base64 string");const n=p(r),s=e[3]??"Uint8Array";if(s==="ArrayBuffer")return n.buffer.byteLength===n.byteLength?n.buffer:n.slice().buffer;const c=Object.hasOwn(g,s)?g[s]:void 0;return c?new c(n.slice().buffer):n}case"inf":return 1/0;case"nan":return Number.NaN;case"undefined":return;default:return e.map(r=>y(r,t+1))}return e.map(f=>y(f,t+1))}const a=e,o={};for(const f of Object.keys(a)){const r=y(a[f],t+1);f===m?Object.defineProperty(o,f,{configurable:!0,enumerable:!0,value:r,writable:!0}):o[f]=r}return o};export{y as d,b as e,l as i};

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

@@ -0,0 +1 @@
+import{e as a}from"./wire-codec-BiYbPSuZ.mjs";const b=/["\\\u0000-\u001F\uD800-\uDFFF]/,y=t=>b.test(t)?JSON.stringify(t):`"${t}"`,i=t=>{if(t===void 0)return"null";if(typeof t=="bigint")throw new TypeError("stableStringify: cannot use a bigint in a stable JSON cache key — pass it as a string, or use stableWireKey");if(typeof t=="number"){if(Number.isNaN(t))return"nan";if(t===1/0)return"inf";if(t===-1/0)return"-inf";if(Object.is(t,-0))return"-0"}if(typeof t=="string")return y(t);if(t===null||typeof t!="object")return JSON.stringify(t);if(Array.isArray(t)){let r="[";for(let e=0;e<t.length;e++)e>0&&(r+=","),r+=i(t[e]);return r+"]"}const o=Object.getPrototypeOf(t);if(o!==null&&o!==Object.prototype){const r=t.constructor?.name??"value";throw new TypeError(`stableStringify: cannot use a ${r} in a stable JSON cache key — only plain objects, arrays, and JSON primitives are supported (wire-typed values key via stableWireKey)`)}const s=t,c=Object.keys(s).sort();let n="{",f=!0;for(const r of c){const e=s[r];e!==void 0&&(f?f=!1:n+=",",n+=y(r),n+=":",n+=i(e))}return n+"}"},u=t=>i(a(t));export{u as s};

package/dist/pagination/index.d.mts

@@ -1,13 +1,13 @@
 /**
-* `@lunora/client/pagination` — the framework-agnostic pagination state machine
-* shared by every Lunora UI adapter (React, Vue, Svelte, Solid).
-*
-* Owns cursor tracking, page-size rebalancing (split/join), `initialPages`,
-* `rebalance`, and the shared types (`Page`, `PaginationResult`,
-* `PaginationStatus`, `PaginatedCoreResult`). Nothing here imports a UI
-* framework — each adapter wires the pure functions into its own reactive
-* primitives.
-*/
+ * `@lunora/client/pagination` — the framework-agnostic pagination state machine
+ * shared by every Lunora UI adapter (React, Vue, Svelte, Solid).
+ *
+ * Owns cursor tracking, page-size rebalancing (split/join), `initialPages`,
+ * `rebalance`, and the shared types (`Page`, `PaginationResult`,
+ * `PaginationStatus`, `PaginatedCoreResult`). Nothing here imports a UI
+ * framework — each adapter wires the pure functions into its own reactive
+ * primitives.
+ */
 /** Grow factor: a bounded page is split when it exceeds this multiple of its target size. */
 declare const SPLIT_FACTOR = 2;
 /** Shrink factor: a bounded page with a neighbour is joined when it falls below this multiple of its target size. */
@@ -24,20 +24,20 @@ interface PaginationResult<T = unknown> {
   isDone: boolean;
   page: T[];
   /**
-  * Reactive-pagination only: the midpoint cursor of a bounded
-  * `(cursor, endCursor]` page, used to split an over-grown page into two
-  * adjacent ranges. Absent on legacy (open-ended) pages.
-  */
+   * Reactive-pagination only: the midpoint cursor of a bounded
+   * `(cursor, endCursor]` page, used to split an over-grown page into two
+   * adjacent ranges. Absent on legacy (open-ended) pages.
+   */
   splitCursor?: null | string;
 }
 /**
-* Lifecycle of a `usePaginatedQuery` feed.
-*
-* - `LoadingFirstPage` — the first page is in flight; `results` is empty.
-* - `CanLoadMore` — the loaded tail has a cursor; calling `loadMore` fetches the next page.
-* - `LoadingMore` — a `loadMore` page is in flight; earlier results stay visible.
-* - `Exhausted` — every page has loaded and the server reported `isDone`.
-*/
+ * Lifecycle of a `usePaginatedQuery` feed.
+ *
+ * - `LoadingFirstPage` — the first page is in flight; `results` is empty.
+ * - `CanLoadMore` — the loaded tail has a cursor; calling `loadMore` fetches the next page.
+ * - `LoadingMore` — a `loadMore` page is in flight; earlier results stay visible.
+ * - `Exhausted` — every page has loaded and the server reported `isDone`.
+ */
 type PaginationStatus = "CanLoadMore" | "Exhausted" | "LoadingFirstPage" | "LoadingMore";
 interface PaginatedCoreResult<T> {
   /** Request another page off the open-ended tail. A no-op unless `status === "CanLoadMore"`. */
@@ -49,34 +49,34 @@ interface PaginatedCoreResult<T> {
 /** First-page seed: a single open-ended range starting at the feed head. */
 declare const initialPages: (numberItems: number) => Page[];
 /**
-* Run the SPLIT/JOIN maintenance pass over the current page list given freshly
-* resolved results. Returns a new page list when a boundary changed, or
-* `undefined` when the layout is already balanced (so the caller can skip a
-* setState).
-*
-* Only ONE structural edit is applied per pass (the first split or join found),
-* letting the subsequent re-render's resolved results drive the next pass — this
-* keeps each transition observable and avoids reasoning about several
-* simultaneous boundary moves.
-*/
+ * Run the SPLIT/JOIN maintenance pass over the current page list given freshly
+ * resolved results. Returns a new page list when a boundary changed, or
+ * `undefined` when the layout is already balanced (so the caller can skip a
+ * setState).
+ *
+ * Only ONE structural edit is applied per pass (the first split or join found),
+ * letting the subsequent re-render's resolved results drive the next pass — this
+ * keeps each transition observable and avoids reasoning about several
+ * simultaneous boundary moves.
+ */
 declare const rebalance: (pages: Page[], results: (PaginationResult | undefined)[]) => Page[] | undefined;
 /**
-* Derive the feed `status` and the next-page cursor from the current page list
-* and resolved page results. Framework adapters call this each render/effect to
-* compute what to expose to callers.
-*/
+ * Derive the feed `status` and the next-page cursor from the current page list
+ * and resolved page results. Framework adapters call this each render/effect to
+ * compute what to expose to callers.
+ */
 declare const derivePaginationStatus: <T>(skipped: boolean, pageResults: (PaginationResult<T> | undefined)[]) => {
   nextCursor: null | string | undefined;
   status: PaginationStatus;
 };
 /**
-* Apply a `loadMore` to the current page list. Pins the open-ended tail at
-* `cursor` (making it a fixed bounded range) and appends a fresh open-ended
-* page starting at `cursor`. The shared boundary keeps the feed gap- and
-* dup-free.
-*
-* Returns the new page list, or `undefined` when the given `cursor` is not
-* valid (null or undefined — caller should no-op).
-*/
+ * Apply a `loadMore` to the current page list. Pins the open-ended tail at
+ * `cursor` (making it a fixed bounded range) and appends a fresh open-ended
+ * page starting at `cursor`. The shared boundary keeps the feed gap- and
+ * dup-free.
+ *
+ * Returns the new page list, or `undefined` when the given `cursor` is not
+ * valid (null or undefined — caller should no-op).
+ */
 declare const applyLoadMore: (pages: Page[], cursor: null | string | undefined, numberItems: number) => Page[] | undefined;
 export { JOIN_FACTOR, type Page, type PaginatedCoreResult, type PaginationResult, type PaginationStatus, SPLIT_FACTOR, applyLoadMore, derivePaginationStatus, initialPages, rebalance };

package/dist/pagination/index.d.ts

@@ -1,13 +1,13 @@
 /**
-* `@lunora/client/pagination` — the framework-agnostic pagination state machine
-* shared by every Lunora UI adapter (React, Vue, Svelte, Solid).
-*
-* Owns cursor tracking, page-size rebalancing (split/join), `initialPages`,
-* `rebalance`, and the shared types (`Page`, `PaginationResult`,
-* `PaginationStatus`, `PaginatedCoreResult`). Nothing here imports a UI
-* framework — each adapter wires the pure functions into its own reactive
-* primitives.
-*/
+ * `@lunora/client/pagination` — the framework-agnostic pagination state machine
+ * shared by every Lunora UI adapter (React, Vue, Svelte, Solid).
+ *
+ * Owns cursor tracking, page-size rebalancing (split/join), `initialPages`,
+ * `rebalance`, and the shared types (`Page`, `PaginationResult`,
+ * `PaginationStatus`, `PaginatedCoreResult`). Nothing here imports a UI
+ * framework — each adapter wires the pure functions into its own reactive
+ * primitives.
+ */
 /** Grow factor: a bounded page is split when it exceeds this multiple of its target size. */
 declare const SPLIT_FACTOR = 2;
 /** Shrink factor: a bounded page with a neighbour is joined when it falls below this multiple of its target size. */
@@ -24,20 +24,20 @@ interface PaginationResult<T = unknown> {
   isDone: boolean;
   page: T[];
   /**
-  * Reactive-pagination only: the midpoint cursor of a bounded
-  * `(cursor, endCursor]` page, used to split an over-grown page into two
-  * adjacent ranges. Absent on legacy (open-ended) pages.
-  */
+   * Reactive-pagination only: the midpoint cursor of a bounded
+   * `(cursor, endCursor]` page, used to split an over-grown page into two
+   * adjacent ranges. Absent on legacy (open-ended) pages.
+   */
   splitCursor?: null | string;
 }
 /**
-* Lifecycle of a `usePaginatedQuery` feed.
-*
-* - `LoadingFirstPage` — the first page is in flight; `results` is empty.
-* - `CanLoadMore` — the loaded tail has a cursor; calling `loadMore` fetches the next page.
-* - `LoadingMore` — a `loadMore` page is in flight; earlier results stay visible.
-* - `Exhausted` — every page has loaded and the server reported `isDone`.
-*/
+ * Lifecycle of a `usePaginatedQuery` feed.
+ *
+ * - `LoadingFirstPage` — the first page is in flight; `results` is empty.
+ * - `CanLoadMore` — the loaded tail has a cursor; calling `loadMore` fetches the next page.
+ * - `LoadingMore` — a `loadMore` page is in flight; earlier results stay visible.
+ * - `Exhausted` — every page has loaded and the server reported `isDone`.
+ */
 type PaginationStatus = "CanLoadMore" | "Exhausted" | "LoadingFirstPage" | "LoadingMore";
 interface PaginatedCoreResult<T> {
   /** Request another page off the open-ended tail. A no-op unless `status === "CanLoadMore"`. */
@@ -49,34 +49,34 @@ interface PaginatedCoreResult<T> {
 /** First-page seed: a single open-ended range starting at the feed head. */
 declare const initialPages: (numberItems: number) => Page[];
 /**
-* Run the SPLIT/JOIN maintenance pass over the current page list given freshly
-* resolved results. Returns a new page list when a boundary changed, or
-* `undefined` when the layout is already balanced (so the caller can skip a
-* setState).
-*
-* Only ONE structural edit is applied per pass (the first split or join found),
-* letting the subsequent re-render's resolved results drive the next pass — this
-* keeps each transition observable and avoids reasoning about several
-* simultaneous boundary moves.
-*/
+ * Run the SPLIT/JOIN maintenance pass over the current page list given freshly
+ * resolved results. Returns a new page list when a boundary changed, or
+ * `undefined` when the layout is already balanced (so the caller can skip a
+ * setState).
+ *
+ * Only ONE structural edit is applied per pass (the first split or join found),
+ * letting the subsequent re-render's resolved results drive the next pass — this
+ * keeps each transition observable and avoids reasoning about several
+ * simultaneous boundary moves.
+ */
 declare const rebalance: (pages: Page[], results: (PaginationResult | undefined)[]) => Page[] | undefined;
 /**
-* Derive the feed `status` and the next-page cursor from the current page list
-* and resolved page results. Framework adapters call this each render/effect to
-* compute what to expose to callers.
-*/
+ * Derive the feed `status` and the next-page cursor from the current page list
+ * and resolved page results. Framework adapters call this each render/effect to
+ * compute what to expose to callers.
+ */
 declare const derivePaginationStatus: <T>(skipped: boolean, pageResults: (PaginationResult<T> | undefined)[]) => {
   nextCursor: null | string | undefined;
   status: PaginationStatus;
 };
 /**
-* Apply a `loadMore` to the current page list. Pins the open-ended tail at
-* `cursor` (making it a fixed bounded range) and appends a fresh open-ended
-* page starting at `cursor`. The shared boundary keeps the feed gap- and
-* dup-free.
-*
-* Returns the new page list, or `undefined` when the given `cursor` is not
-* valid (null or undefined — caller should no-op).
-*/
+ * Apply a `loadMore` to the current page list. Pins the open-ended tail at
+ * `cursor` (making it a fixed bounded range) and appends a fresh open-ended
+ * page starting at `cursor`. The shared boundary keeps the feed gap- and
+ * dup-free.
+ *
+ * Returns the new page list, or `undefined` when the given `cursor` is not
+ * valid (null or undefined — caller should no-op).
+ */
 declare const applyLoadMore: (pages: Page[], cursor: null | string | undefined, numberItems: number) => Page[] | undefined;
 export { JOIN_FACTOR, type Page, type PaginatedCoreResult, type PaginationResult, type PaginationStatus, SPLIT_FACTOR, applyLoadMore, derivePaginationStatus, initialPages, rebalance };

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,m=.5,p=e=>[{lower:null,numItems:e,upper:null}],c=(e,r)=>{for(const[n,t]of e.entries()){if(t.upper===null)continue;const o=r[n];if(!o)continue;const i=o.page.length;if(i>2*t.numItems&&o.splitCursor){const u=o.splitCursor,s=[...e];return s.splice(n,1,{lower:t.lower,numItems:t.numItems,upper:u},{lower:u,numItems:t.numItems,upper:t.upper}),s}if(i<.5*t.numItems&&n+1<e.length){const u=e[n+1];if(!u)continue;const s=[...e];return s.splice(n,2,{lower:t.lower,numItems:t.numItems,upper:u.upper}),s}}},a=(e,r)=>{if(e||!r[0])return{nextCursor:void 0,status:"LoadingFirstPage"};const n=r.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=(e,r,n)=>{if(r==null)return;const t=[...e],o=t.at(-1);return o&&(t[t.length-1]={lower:o.lower,numItems:o.numItems,upper:r}),t.push({lower:r,numItems:n,upper:null}),t};export{m as JOIN_FACTOR,l as SPLIT_FACTOR,I as applyLoadMore,a as derivePaginationStatus,p as initialPages,c as rebalance};

package/dist/query/index.d.mts

@@ -1,26 +1,39 @@
-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-CeUZ8lE1.mjs";
-export type { b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-CeUZ8lE1.mjs";
+import { S as SubscriptionError, L as LunoraClient, a as Unsubscribe } from "../packem_shared/lunora-client.d-D6g91j8X.mjs";
+export type {
+/**
+ * `@lunora/client/query` — the framework-neutral live-query state machine shared
+ * by every Lunora UI adapter (React, Vue, Svelte, Solid). It owns the seam
+ * between a `LunoraClient` subscription and a framework's reactivity primitive:
+ * the subscribe → snapshot → error/reset → cleanup lifecycle, with the
+ * skip-handling, value/error fan-out, attach-throw normalisation, and
+ * cancellation-guarded teardown all in one place. Nothing here imports a UI
+ * framework — each adapter supplies thin sinks that write into its own ref /
+ * store / signal / cache.
+ */
+b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-D6g91j8X.mjs";
+import { F as FunctionReference, A as ArgsOf, R as ReturnOf } from "../packem_shared/function-reference.d-Br_hsKje.mjs";
+import '@lunora/errors';
 import '@lunora/runtime';
 /**
-* The sentinel a framework adapter resolves its reactive args to when it wants
-* to short-circuit a query — no network call, no socket.
-*/
+ * The sentinel a framework adapter resolves its reactive args to when it wants
+ * to short-circuit a query — no network call, no socket.
+ */
 declare const SKIP: "skip";
 /** Args after a framework has resolved its reactivity primitive, or the skip sentinel. */
 type ResolvedArgs<F extends FunctionReference> = ArgsOf<F> | typeof SKIP;
 /**
-* The framework-neutral sinks a {@link createQuerySubscription} call drives. A
-* framework adapter supplies these, wiring each into its own reactivity
-* primitive (a TanStack cache write, a Vue `ref`, a Svelte store `set`, a Solid
-* signal setter).
-*
-* `onData` fires when a fresh server value lands (the initial frame or a delta).
-* `onError` fires when the subscription attach threw, or the server pushed a
-* subscription-scoped error — it is optional, and when omitted an attach throw
-* propagates to the caller (preserving the "no error channel" behaviour of
-* adapters like Solid/Vue that never had one) rather than being swallowed.
-* `onReset` fires when the resolved args are `"skip"`: clear any prior value.
-*/
+ * The framework-neutral sinks a {@link createQuerySubscription} call drives. A
+ * framework adapter supplies these, wiring each into its own reactivity
+ * primitive (a TanStack cache write, a Vue `ref`, a Svelte store `set`, a Solid
+ * signal setter).
+ *
+ * `onData` fires when a fresh server value lands (the initial frame or a delta).
+ * `onError` fires when the subscription attach threw, or the server pushed a
+ * subscription-scoped error — it is optional, and when omitted an attach throw
+ * propagates to the caller (preserving the "no error channel" behaviour of
+ * adapters like Solid/Vue that never had one) rather than being swallowed.
+ * `onReset` fires when the resolved args are `"skip"`: clear any prior value.
+ */
 interface QuerySubscriptionSinks<T> {
   onData: (value: T) => void;
   onError?: (error: SubscriptionError) => void;
@@ -33,30 +46,85 @@ interface QuerySubscriptionOptions {
 /** Normalise an unknown thrown value into the client's {@link SubscriptionError} shape. */
 declare const toSubscriptionError: (error: unknown) => SubscriptionError;
 /**
-* The subscribe → snapshot → error/reset → cleanup state machine shared by
-* every Lunora framework adapter's live-query hook.
-*
-* Given a `client`, a function reference, the already-resolved `args` (a
-* framework reads its own reactive source first, then hands the plain value in),
-* and a set of {@link QuerySubscriptionSinks}, this opens one `client.subscribe`
-* registration and returns the {@link Unsubscribe} to tear it down. Each
-* framework owns *when* to call this (a React effect, a Vue `watch`, a Svelte
-* store start callback, a Solid `createEffect(on(...))`) and *where* to stash
-* the value — this owns the lifecycle in between, so the skip-handling, the
-* value/error fan-out, the attach-throw normalisation, and the
-* cancellation-guarded teardown live in exactly one place.
-*
-* Behaviour. When `args === "skip"` it calls `sinks.onReset?.()` and returns a
-* no-op teardown; no `client.subscribe` is issued. Otherwise it opens
-* `client.subscribe(fn, args, …, { shardKey, onError })`: server pushes route to
-* `sinks.onData`, and the client's own `onError` channel (a server-rejected
-* subscription) routes to `sinks.onError` when present. The attach is wrapped —
-* if `client.subscribe` itself throws, the error is normalised to a
-* {@link SubscriptionError} and delivered to `sinks.onError` when present; with
-* no `onError` sink the throw is rethrown so adapters without an error channel
-* behave exactly as before. The returned teardown is idempotent and
-* cancellation-guarded: once it runs, no further `onData`/`onError` from an
-* in-flight push reaches the sinks.
-*/
+ * The subscribe → snapshot → error/reset → cleanup state machine shared by
+ * every Lunora framework adapter's live-query hook.
+ *
+ * Given a `client`, a function reference, the already-resolved `args` (a
+ * framework reads its own reactive source first, then hands the plain value in),
+ * and a set of {@link QuerySubscriptionSinks}, this opens one `client.subscribe`
+ * registration and returns the {@link Unsubscribe} to tear it down. Each
+ * framework owns *when* to call this (a React effect, a Vue `watch`, a Svelte
+ * store start callback, a Solid `createEffect(on(...))`) and *where* to stash
+ * the value — this owns the lifecycle in between, so the skip-handling, the
+ * value/error fan-out, the attach-throw normalisation, and the
+ * cancellation-guarded teardown live in exactly one place.
+ *
+ * Behaviour. When `args === "skip"` it calls `sinks.onReset?.()` and returns a
+ * no-op teardown; no `client.subscribe` is issued. Otherwise it opens
+ * `client.subscribe(fn, args, …, { shardKey, onError })`: server pushes route to
+ * `sinks.onData`, and the client's own `onError` channel (a server-rejected
+ * subscription) routes to `sinks.onError` when present. The attach is wrapped —
+ * if `client.subscribe` itself throws, the error is normalised to a
+ * {@link SubscriptionError} and delivered to `sinks.onError` when present; with
+ * no `onError` sink the throw is rethrown so adapters without an error channel
+ * behave exactly as before. The returned teardown is idempotent and
+ * cancellation-guarded: once it runs, no further `onData`/`onError` from an
+ * in-flight push reaches the sinks.
+ */
 declare const createQuerySubscription: <F extends FunctionReference, T = ReturnOf<F>>(client: LunoraClient, function_: F, args: ResolvedArgs<F>, sinks: QuerySubscriptionSinks<T>, options?: QuerySubscriptionOptions) => Unsubscribe;
-export { type ArgsOf, type FunctionReference, type QuerySubscriptionOptions, type QuerySubscriptionSinks, type ResolvedArgs, type ReturnOf, SKIP, type SubscriptionError, type Unsubscribe, createQuerySubscription, toSubscriptionError };
+export {
+/**
+ * `@lunora/client/query` — the framework-neutral live-query state machine shared
+ * by every Lunora UI adapter (React, Vue, Svelte, Solid). It owns the seam
+ * between a `LunoraClient` subscription and a framework's reactivity primitive:
+ * the subscribe → snapshot → error/reset → cleanup lifecycle, with the
+ * skip-handling, value/error fan-out, attach-throw normalisation, and
+ * cancellation-guarded teardown all in one place. Nothing here imports a UI
+ * framework — each adapter supplies thin sinks that write into its own ref /
+ * store / signal / cache.
+ */
+type ArgsOf,
+/**
+ * `@lunora/client/query` — the framework-neutral live-query state machine shared
+ * by every Lunora UI adapter (React, Vue, Svelte, Solid). It owns the seam
+ * between a `LunoraClient` subscription and a framework's reactivity primitive:
+ * the subscribe → snapshot → error/reset → cleanup lifecycle, with the
+ * skip-handling, value/error fan-out, attach-throw normalisation, and
+ * cancellation-guarded teardown all in one place. Nothing here imports a UI
+ * framework — each adapter supplies thin sinks that write into its own ref /
+ * store / signal / cache.
+ */
+type FunctionReference, type QuerySubscriptionOptions, type QuerySubscriptionSinks, type ResolvedArgs,
+/**
+ * `@lunora/client/query` — the framework-neutral live-query state machine shared
+ * by every Lunora UI adapter (React, Vue, Svelte, Solid). It owns the seam
+ * between a `LunoraClient` subscription and a framework's reactivity primitive:
+ * the subscribe → snapshot → error/reset → cleanup lifecycle, with the
+ * skip-handling, value/error fan-out, attach-throw normalisation, and
+ * cancellation-guarded teardown all in one place. Nothing here imports a UI
+ * framework — each adapter supplies thin sinks that write into its own ref /
+ * store / signal / cache.
+ */
+type ReturnOf, SKIP,
+/**
+ * `@lunora/client/query` — the framework-neutral live-query state machine shared
+ * by every Lunora UI adapter (React, Vue, Svelte, Solid). It owns the seam
+ * between a `LunoraClient` subscription and a framework's reactivity primitive:
+ * the subscribe → snapshot → error/reset → cleanup lifecycle, with the
+ * skip-handling, value/error fan-out, attach-throw normalisation, and
+ * cancellation-guarded teardown all in one place. Nothing here imports a UI
+ * framework — each adapter supplies thin sinks that write into its own ref /
+ * store / signal / cache.
+ */
+type SubscriptionError,
+/**
+ * `@lunora/client/query` — the framework-neutral live-query state machine shared
+ * by every Lunora UI adapter (React, Vue, Svelte, Solid). It owns the seam
+ * between a `LunoraClient` subscription and a framework's reactivity primitive:
+ * the subscribe → snapshot → error/reset → cleanup lifecycle, with the
+ * skip-handling, value/error fan-out, attach-throw normalisation, and
+ * cancellation-guarded teardown all in one place. Nothing here imports a UI
+ * framework — each adapter supplies thin sinks that write into its own ref /
+ * store / signal / cache.
+ */
+type Unsubscribe, createQuerySubscription, toSubscriptionError };