@lunora/client 1.0.0-alpha.25 → 1.0.0-alpha.250

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

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

package/dist/packem_shared/{preload.d-B6-lqUf2.d.ts → preload.d-B26QlpOB.d.ts}

@@ -1,4 +1,5 @@
-import { F as FunctionReference, L as LunoraClient, A as ArgsOf, R as ReturnOf, P as Preloaded } from "./lunora-client.d-C4ud8bej.js";
+import { L as LunoraClient, P as Preloaded } from "./lunora-client.d-7WaMRZUK.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

package/dist/packem_shared/{preload.d-Dvk8zg6m.d.mts → preload.d-CT_9YaL9.d.mts}

@@ -1,4 +1,5 @@
-import { F as FunctionReference, L as LunoraClient, A as ArgsOf, R as ReturnOf, P as Preloaded } from "./lunora-client.d-C4ud8bej.mjs";
+import { L as LunoraClient, P as Preloaded } from "./lunora-client.d-DtTKDhtw.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

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-DpqSxsgi.mjs

@@ -0,0 +1 @@
+import{encodeWire as s,decodeWire as a}from"@lunora/wire";const c=Symbol("lunora.corrupt-blob"),m=(r,t)=>{let n=Promise.resolve();const o=e=>{const i=n.then(e,e);return n=i.then(()=>{},()=>{}),i};return{clear:()=>o(()=>r.removeItem(t)),read:async()=>{const e=await r.getItem(t);if(e!==null)try{return a(JSON.parse(e))}catch{return c}},serialize:o,write:async e=>{await r.setItem(t,JSON.stringify(s(e)))}}};export{c as C,m as s};

package/dist/packem_shared/snapshot-precondition-BEtcSbWr.mjs

@@ -0,0 +1 @@
+import{stableWireKey as p}from"@lunora/wire";const u=new WeakMap,i=(e,t)=>{u.set(e,t)},d=e=>e===void 0?void 0:u.get(e),h=(e,t,s,n)=>{const o=e.peekActiveQuerySnapshot(t.__lunoraRef,s,n),a=o.present&&o.answered?p(o.value):void 0,c=()=>{const r=e.peekActiveQuerySnapshot(t.__lunoraRef,s,n);return!o.present||!o.answered||!r.present||!r.answered?!0:p(r.value)===a};return a!==void 0&&i(c,{args:s,functionPath:t.__lunoraRef,shardKey:n}),c};export{h as c,i as r,d as s};

package/dist/packem_shared/stream-idle-C7CsIT_m.mjs

@@ -0,0 +1 @@
+import{LunoraError as v}from"@lunora/errors";import{TransportError as f}from"./CONFLICT_ERROR_CODE-B7qNZMMk.mjs";const c=t=>t.reason??Object.assign(new Error("The operation was aborted"),{name:"AbortError"}),m=async(t,r,o,i=()=>new f(`LunoraClient: request timed out after ${t.toString()}ms`))=>{if(r?.aborted)throw c(r);const n=new AbortController,e=[],u=new Promise((b,d)=>{if(t>0){const a=setTimeout(()=>{d(i()),n.abort()},t);e.push(()=>{clearTimeout(a)})}if(r){const a=()=>{n.abort(),d(c(r))};r.addEventListener("abort",a,{once:!0}),e.push(()=>{r.removeEventListener("abort",a)})}}),s=o(n.signal);s.catch(()=>{});try{return await Promise.race([s,u])}finally{for(const b of e)b()}},E=async(t,r)=>{if(r===void 0)return t;if(r.aborted)throw t.catch(()=>{}),c(r);let o=()=>{};const i=new Promise((n,e)=>{o=()=>{e(c(r))},r.addEventListener("abort",o,{once:!0})});t.catch(()=>{});try{return await Promise.race([t,i])}finally{r.removeEventListener("abort",o)}},y=async(t,r)=>!Number.isFinite(r)||r<=0?t.read():m(r,void 0,async()=>t.read(),()=>new v("STREAM_IDLE",`stream received nothing for ${r.toString()}ms`));export{E as a,c as b,y as r,m as w};

package/dist/packem_shared/wire-errors-BgFi7ONA.mjs

@@ -0,0 +1 @@
+import{LunoraError as n}from"@lunora/errors";import{decodeWire as d}from"@lunora/wire";import{TransportError as u,getRetryAfterMs as f}from"./CONFLICT_ERROR_CODE-B7qNZMMk.mjs";const l=t=>{if(t===null)return;const e=Number(t);if(Number.isFinite(e))return e>0?e*1e3:void 0;const r=Date.parse(t);if(Number.isNaN(r))return;const o=r-Date.now();return o>0?o:void 0},v=(t,e)=>{const r=l(e);if(!(r===void 0||f(t)!==void 0))return t.data===void 0?{retryAfterMs:r}:typeof t.data=="object"&&t.data!==null&&!Array.isArray(t.data)?{...t.data,retryAfterMs:r}:void 0},p=t=>{const e=t?.error;if(typeof e!="object"||e===null||Array.isArray(e))return;const{why:r,...o}=e;return typeof r=="string"?{...o,why:r}:o},E=()=>new u("LunoraClient: batch slot carried no error envelope"),i=(t,e)=>{const r=t.error,o=typeof r?.code=="string"?r.code:void 0,s=typeof r?.message=="string"?r.message:void 0;return{code:o,messageText:(typeof t.message=="string"?t.message:void 0)??s??e}},A=t=>{const{code:e,messageText:r}=i(t,"stream error"),o=t.error?.why,s=e===void 0?new Error(r):new n(e,r);return typeof o=="string"&&(s.why=o),s},R=t=>{const{code:e,messageText:r}=i(t,"subscription error"),o=t.error?.why;return{message:r,...e===void 0?{}:{code:e},...typeof o=="string"?{why:o}:{}}},y=Symbol.for("lunora.serverVerdict"),a=t=>{const e=new Error(t.message??"request failed");if(e.code=t.code,e[y]=!0,t.data!==void 0)try{e.data=d(t.data)}catch{}return t.hint!==void 0&&(e.hint=t.hint),t.docsUrl!==void 0&&(e.docsUrl=t.docsUrl),typeof t.why=="string"&&(e.why=t.why),e},m=t=>Object.freeze(Object.fromEntries([...t].filter(([e])=>e!=="set-cookie"))),b=(t,e)=>Object.defineProperty(t,"headers",{value:m(e)}),S=(t,e)=>{const r=a(t),o=v(r,e.get("retry-after"));return o!==void 0&&(r.data=o),b(r,e)},D=t=>{const e=p(t);return e===void 0?E():a(e)},c=new WeakSet,j=t=>{const e=new n("WIRE_DECODE_FAILED",`LunoraClient: the call succeeded but its result could not be decoded (a mutation has still committed) — ${t instanceof Error?t.message:String(t)}`,{cause:t});return c.add(e),e},M=t=>t instanceof Error&&c.has(t);export{l as a,S as b,A as c,R as d,p as e,E as f,M as i,a as r,D as s,j as u,b as w};

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,5 +1,18 @@
-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-C4ud8bej.mjs";
-export type { b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-C4ud8bej.mjs";
+import { S as SubscriptionError, L as LunoraClient, a as Unsubscribe } from "../packem_shared/lunora-client.d-DtTKDhtw.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-DtTKDhtw.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
@@ -59,4 +72,59 @@ declare const toSubscriptionError: (error: unknown) => SubscriptionError;
  * 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 };

package/dist/query/index.d.ts

@@ -1,5 +1,18 @@
-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-C4ud8bej.js";
-export type { b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-C4ud8bej.js";
+import { S as SubscriptionError, L as LunoraClient, a as Unsubscribe } from "../packem_shared/lunora-client.d-7WaMRZUK.js";
+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-7WaMRZUK.js";
+import { F as FunctionReference, A as ArgsOf, R as ReturnOf } from "../packem_shared/function-reference.d-Br_hsKje.js";
+import '@lunora/errors';
 import '@lunora/runtime';
 /**
  * The sentinel a framework adapter resolves its reactive args to when it wants
@@ -59,4 +72,59 @@ declare const toSubscriptionError: (error: unknown) => SubscriptionError;
  * 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 };

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-d7LeP-sY.mjs";export{t as SKIP,e as createQuerySubscription,i as toSubscriptionError};

package/dist/service.d.mts

@@ -0,0 +1,49 @@
+import { F as FunctionReference, A as ArgsOf, R as ReturnOf } from "./packem_shared/function-reference.d-Br_hsKje.mjs";
+/**
+ * The wire endpoint every Lunora Worker serves. Matches `createWorker`'s RPC
+ * route; the envelope shape below is that route's documented contract.
+ */
+declare const RPC_PATH = "/_lunora/rpc";
+/**
+ * The slice of a Cloudflare service binding this module uses.
+ *
+ * Structural on purpose: `env.BACKEND` satisfies it, and so does a one-method
+ * fake in a test. Declaring the full `Fetcher` would drag
+ * `@cloudflare/workers-types` into every consumer for a single method.
+ */
+interface ServiceBindingLike {
+  fetch: (request: Request) => Promise<Response>;
+}
+interface ServiceCallOptions {
+  /**
+   * Route to a specific shard. Omitted, the callee routes to its default shard
+   * — the same rule the HTTP path follows, so a sharded app must pass the key
+   * it would have passed there.
+   */
+  shardKey?: string;
+}
+/**
+ * A typed caller bound to one Lunora Worker.
+ *
+ * The three methods are separate rather than one `call` so a reader can tell a
+ * read from a write at the call site, and so the reference's `Kind` is checked:
+ * passing a mutation reference to `query` is a compile error, matching how
+ * `ctx.runQuery`/`ctx.runMutation` behave inside an app.
+ */
+interface LunoraServiceClient {
+  action: <F extends FunctionReference<"action">>(reference: F, args?: ArgsOf<F>, options?: ServiceCallOptions) => Promise<ReturnOf<F>>;
+  mutation: <F extends FunctionReference<"mutation">>(reference: F, args?: ArgsOf<F>, options?: ServiceCallOptions) => Promise<ReturnOf<F>>;
+  query: <F extends FunctionReference<"query">>(reference: F, args?: ArgsOf<F>, options?: ServiceCallOptions) => Promise<ReturnOf<F>>;
+}
+/**
+ * Build a typed caller for the Lunora Worker behind `binding`.
+ *
+ * Only PUBLIC functions are reachable. An `internal*` procedure is deliberately
+ * absent from the generated `api` object and rejected by the callee, because a
+ * service binding is a trust boundary between deployments, not the intra-app
+ * `ctx.run*` seam.
+ * @param binding The service binding, e.g. `env.BACKEND`.
+ * @returns a client whose methods type-check against the generated `api`.
+ */
+declare const createServiceClient: (binding: ServiceBindingLike) => LunoraServiceClient;
+export { type LunoraServiceClient, RPC_PATH, type ServiceBindingLike, type ServiceCallOptions, createServiceClient };

package/dist/service.d.ts

@@ -0,0 +1,49 @@
+import { F as FunctionReference, A as ArgsOf, R as ReturnOf } from "./packem_shared/function-reference.d-Br_hsKje.js";
+/**
+ * The wire endpoint every Lunora Worker serves. Matches `createWorker`'s RPC
+ * route; the envelope shape below is that route's documented contract.
+ */
+declare const RPC_PATH = "/_lunora/rpc";
+/**
+ * The slice of a Cloudflare service binding this module uses.
+ *
+ * Structural on purpose: `env.BACKEND` satisfies it, and so does a one-method
+ * fake in a test. Declaring the full `Fetcher` would drag
+ * `@cloudflare/workers-types` into every consumer for a single method.
+ */
+interface ServiceBindingLike {
+  fetch: (request: Request) => Promise<Response>;
+}
+interface ServiceCallOptions {
+  /**
+   * Route to a specific shard. Omitted, the callee routes to its default shard
+   * — the same rule the HTTP path follows, so a sharded app must pass the key
+   * it would have passed there.
+   */
+  shardKey?: string;
+}
+/**
+ * A typed caller bound to one Lunora Worker.
+ *
+ * The three methods are separate rather than one `call` so a reader can tell a
+ * read from a write at the call site, and so the reference's `Kind` is checked:
+ * passing a mutation reference to `query` is a compile error, matching how
+ * `ctx.runQuery`/`ctx.runMutation` behave inside an app.
+ */
+interface LunoraServiceClient {
+  action: <F extends FunctionReference<"action">>(reference: F, args?: ArgsOf<F>, options?: ServiceCallOptions) => Promise<ReturnOf<F>>;
+  mutation: <F extends FunctionReference<"mutation">>(reference: F, args?: ArgsOf<F>, options?: ServiceCallOptions) => Promise<ReturnOf<F>>;
+  query: <F extends FunctionReference<"query">>(reference: F, args?: ArgsOf<F>, options?: ServiceCallOptions) => Promise<ReturnOf<F>>;
+}
+/**
+ * Build a typed caller for the Lunora Worker behind `binding`.
+ *
+ * Only PUBLIC functions are reachable. An `internal*` procedure is deliberately
+ * absent from the generated `api` object and rejected by the callee, because a
+ * service binding is a trust boundary between deployments, not the intra-app
+ * `ctx.run*` seam.
+ * @param binding The service binding, e.g. `env.BACKEND`.
+ * @returns a client whose methods type-check against the generated `api`.
+ */
+declare const createServiceClient: (binding: ServiceBindingLike) => LunoraServiceClient;
+export { type LunoraServiceClient, RPC_PATH, type ServiceBindingLike, type ServiceCallOptions, createServiceClient };

package/dist/service.mjs

@@ -0,0 +1 @@
+import{LunoraError as c}from"@lunora/errors";import{encodeArgsOrThrow as d,decodeWire as y}from"@lunora/wire";import{e as f,r as w}from"./packem_shared/wire-errors-BgFi7ONA.mjs";const v="/_lunora/rpc",N="https://lunora.internal",i=async(n,t,r,o,u)=>{const a=r.__lunoraRef,p=JSON.stringify({args:d("@lunora/client/service",a,o??{}),functionPath:a,...u?.shardKey===void 0?{}:{shardKey:u.shardKey}}),e=await n.fetch(new Request(`${N}${v}`,{body:p,headers:{"content-type":"application/json"},method:"POST"}));let s;try{s=await e.json()}catch{throw new c("INTERNAL",`@lunora/client/service: ${t} "${a}" got a non-JSON response (status ${e.status.toString()}). Check the service binding points at the Lunora Worker that declares this function.`,{status:e.status})}if(s===null||typeof s!="object")throw new c("INTERNAL",`@lunora/client/service: ${t} "${a}" returned a JSON body that is not an object (status ${e.status.toString()}). Check the service binding points at the Lunora Worker that declares this function.`,{status:e.status});const h=s,l=f(h);if(l!==void 0)throw w(l);if(!e.ok)throw new c("INTERNAL",`@lunora/client/service: ${t} "${a}" failed with status ${e.status.toString()} and no error envelope.`,{status:e.status});return y(h.result)},R=n=>({action:async(t,r,o)=>await i(n,"action",t,r,o),mutation:async(t,r,o)=>await i(n,"mutation",t,r,o),query:async(t,r,o)=>await i(n,"query",t,r,o)});export{v as RPC_PATH,R as createServiceClient};

package/dist/ssr/index.d.mts

@@ -1,6 +1,27 @@
-import { P as Preloaded, L as LunoraClient } from "../packem_shared/lunora-client.d-C4ud8bej.mjs";
-export type { A as ArgsOf, F as FunctionReference, R as ReturnOf } from "../packem_shared/lunora-client.d-C4ud8bej.mjs";
-export { p as preloadQuery, a as preloadedQueryResult } from "../packem_shared/preload.d-Dvk8zg6m.mjs";
+import { P as Preloaded, L as LunoraClient } from "../packem_shared/lunora-client.d-DtTKDhtw.mjs";
+export type { A as ArgsOf, F as FunctionReference, R as ReturnOf } from "../packem_shared/function-reference.d-Br_hsKje.mjs";
+export {
+/**
+ * `@lunora/client/ssr` — the framework-neutral server contract that every Lunora
+ * meta-framework adapter (React, Solid, Svelte, Vue) depends on. It owns the
+ * server-side seam: a request-scoped HTTP RPC client, session resolution from
+ * the inbound request, query preloading, and the dehydrate/serialize helpers
+ * for handing a preloaded snapshot to the client. Nothing here opens a
+ * WebSocket or touches a UI framework, so it is safe to import from any SSR
+ * loader.
+ */
+p as preloadQuery,
+/**
+ * `@lunora/client/ssr` — the framework-neutral server contract that every Lunora
+ * meta-framework adapter (React, Solid, Svelte, Vue) depends on. It owns the
+ * server-side seam: a request-scoped HTTP RPC client, session resolution from
+ * the inbound request, query preloading, and the dehydrate/serialize helpers
+ * for handing a preloaded snapshot to the client. Nothing here opens a
+ * WebSocket or touches a UI framework, so it is safe to import from any SSR
+ * loader.
+ */
+a as preloadedQueryResult } from "../packem_shared/preload.d-CT_9YaL9.mjs";
+import '@lunora/errors';
 import '@lunora/runtime';
 /**
  * Structural shape of a better-auth `getSession` call's resolved value.
@@ -55,25 +76,34 @@ type HeadersSource = Headers | Request | {
 declare const getServerSession: <Result>(request: HeadersSource, auth: AuthLike<Result>) => Promise<NonNullable<Result> | null>;
 /**
  * Serialize a {@link Preloaded} token to a JSON string for embedding in the
- * rendered HTML (e.g. a `&lt;script>` payload the client
- * reads on hydration). Every field of `Preloaded` is JSON-serializable by
- * construction — `preloadQuery` only captures the query args, function path,
- * optional shard key, and the resolved value — so this is a thin, explicit
- * `JSON.stringify` that documents the dehydration seam and keeps callers from
- * accidentally stringifying a non-serializable wrapper.
+ * rendered HTML (e.g. a `<script>` payload the client
+ * reads on hydration).
+ *
+ * The payload is **wire-encoded** first, exactly as the RPC transport encodes
+ * its own bodies ({@link file://../service.ts}). `preloadQuery` captures
+ * `await client.query(...)`, whose RPC path ends at `decodeWire(body.result)` —
+ * so a `v.bigint()` column arrives here as a real `bigint` (which
+ * `JSON.stringify` **throws** on) and a `v.bytes()` column as a real
+ * `ArrayBuffer` (which `JSON.stringify` silently degrades to an index-keyed
+ * object). The query `args` are user-supplied and carry the same kinds.
+ * `encodeWire` is identity for JSON-safe data, so a pure-JSON snapshot
+ * serializes byte-for-byte as it did before.
  *
- * The `&lt;` is escaped to `&lt;` so the payload is safe to inline inside a
- * `&lt;script>` tag without a stray `&lt;/script>` (or `&lt;!--`) prematurely closing
+ * The `<` is escaped to `<` so the payload is safe to inline inside a
+ * `<script>` tag without a stray `<\/script>` (or `<!--`) prematurely closing
  * it — the standard XSS-safe script-embedding precaution. This escaping is NOT
- * sufficient for an HTML *attribute* sink (which also needs the quote and `&amp;`
+ * sufficient for an HTML *attribute* sink (which also needs the quote and `&`
  * characters escaped); embed the output in a raw-text script element, not a
  * data attribute.
  */
 declare const serializePreloaded: <T>(preloaded: Preloaded<T>) => string;
 /**
  * Inverse of {@link serializePreloaded}: parse a serialized token back into a
- * {@link Preloaded} value on the client. The `&lt;` escape from serialization
- * is transparent to `JSON.parse`, so no un-escaping step is needed.
+ * {@link Preloaded} value on the client, running the parsed payload back
+ * through {@link decodeWire} so `bigint` / `ArrayBuffer` / typed-array leaves
+ * are restored rather than left in their tagged form. The `<` escape from
+ * serialization is transparent to `JSON.parse`, so no un-escaping step is
+ * needed.
  */
 declare const deserializePreloaded: <T = unknown>(serialized: string) => Preloaded<T>;
 /** Options accepted by {@link createServerClient}. */
@@ -86,7 +116,7 @@ interface ServerClientOptions {
    */
   fetch?: typeof fetch;
   /**
-   * Bearer token sent as `Authorization: Bearer &lt;token>` on every RPC. In an
+   * Bearer token sent as `Authorization: Bearer <token>` on every RPC. In an
    * SSR loader you typically read this from the request (e.g. the session
    * resolved by `getServerSession`) and pass it here so the server-side
    * load runs as the signed-in user — and so the client subscription that

package/dist/ssr/index.d.ts

@@ -1,6 +1,27 @@
-import { P as Preloaded, L as LunoraClient } from "../packem_shared/lunora-client.d-C4ud8bej.js";
-export type { A as ArgsOf, F as FunctionReference, R as ReturnOf } from "../packem_shared/lunora-client.d-C4ud8bej.js";
-export { p as preloadQuery, a as preloadedQueryResult } from "../packem_shared/preload.d-B6-lqUf2.js";
+import { P as Preloaded, L as LunoraClient } from "../packem_shared/lunora-client.d-7WaMRZUK.js";
+export type { A as ArgsOf, F as FunctionReference, R as ReturnOf } from "../packem_shared/function-reference.d-Br_hsKje.js";
+export {
+/**
+ * `@lunora/client/ssr` — the framework-neutral server contract that every Lunora
+ * meta-framework adapter (React, Solid, Svelte, Vue) depends on. It owns the
+ * server-side seam: a request-scoped HTTP RPC client, session resolution from
+ * the inbound request, query preloading, and the dehydrate/serialize helpers
+ * for handing a preloaded snapshot to the client. Nothing here opens a
+ * WebSocket or touches a UI framework, so it is safe to import from any SSR
+ * loader.
+ */
+p as preloadQuery,
+/**
+ * `@lunora/client/ssr` — the framework-neutral server contract that every Lunora
+ * meta-framework adapter (React, Solid, Svelte, Vue) depends on. It owns the
+ * server-side seam: a request-scoped HTTP RPC client, session resolution from
+ * the inbound request, query preloading, and the dehydrate/serialize helpers
+ * for handing a preloaded snapshot to the client. Nothing here opens a
+ * WebSocket or touches a UI framework, so it is safe to import from any SSR
+ * loader.
+ */
+a as preloadedQueryResult } from "../packem_shared/preload.d-B26QlpOB.js";
+import '@lunora/errors';
 import '@lunora/runtime';
 /**
  * Structural shape of a better-auth `getSession` call's resolved value.
@@ -55,25 +76,34 @@ type HeadersSource = Headers | Request | {
 declare const getServerSession: <Result>(request: HeadersSource, auth: AuthLike<Result>) => Promise<NonNullable<Result> | null>;
 /**
  * Serialize a {@link Preloaded} token to a JSON string for embedding in the
- * rendered HTML (e.g. a `&lt;script>` payload the client
- * reads on hydration). Every field of `Preloaded` is JSON-serializable by
- * construction — `preloadQuery` only captures the query args, function path,
- * optional shard key, and the resolved value — so this is a thin, explicit
- * `JSON.stringify` that documents the dehydration seam and keeps callers from
- * accidentally stringifying a non-serializable wrapper.
+ * rendered HTML (e.g. a `<script>` payload the client
+ * reads on hydration).
+ *
+ * The payload is **wire-encoded** first, exactly as the RPC transport encodes
+ * its own bodies ({@link file://../service.ts}). `preloadQuery` captures
+ * `await client.query(...)`, whose RPC path ends at `decodeWire(body.result)` —
+ * so a `v.bigint()` column arrives here as a real `bigint` (which
+ * `JSON.stringify` **throws** on) and a `v.bytes()` column as a real
+ * `ArrayBuffer` (which `JSON.stringify` silently degrades to an index-keyed
+ * object). The query `args` are user-supplied and carry the same kinds.
+ * `encodeWire` is identity for JSON-safe data, so a pure-JSON snapshot
+ * serializes byte-for-byte as it did before.
  *
- * The `&lt;` is escaped to `&lt;` so the payload is safe to inline inside a
- * `&lt;script>` tag without a stray `&lt;/script>` (or `&lt;!--`) prematurely closing
+ * The `<` is escaped to `<` so the payload is safe to inline inside a
+ * `<script>` tag without a stray `<\/script>` (or `<!--`) prematurely closing
  * it — the standard XSS-safe script-embedding precaution. This escaping is NOT
- * sufficient for an HTML *attribute* sink (which also needs the quote and `&amp;`
+ * sufficient for an HTML *attribute* sink (which also needs the quote and `&`
  * characters escaped); embed the output in a raw-text script element, not a
  * data attribute.
  */
 declare const serializePreloaded: <T>(preloaded: Preloaded<T>) => string;
 /**
  * Inverse of {@link serializePreloaded}: parse a serialized token back into a
- * {@link Preloaded} value on the client. The `&lt;` escape from serialization
- * is transparent to `JSON.parse`, so no un-escaping step is needed.
+ * {@link Preloaded} value on the client, running the parsed payload back
+ * through {@link decodeWire} so `bigint` / `ArrayBuffer` / typed-array leaves
+ * are restored rather than left in their tagged form. The `<` escape from
+ * serialization is transparent to `JSON.parse`, so no un-escaping step is
+ * needed.
  */
 declare const deserializePreloaded: <T = unknown>(serialized: string) => Preloaded<T>;
 /** Options accepted by {@link createServerClient}. */
@@ -86,7 +116,7 @@ interface ServerClientOptions {
    */
   fetch?: typeof fetch;
   /**
-   * Bearer token sent as `Authorization: Bearer &lt;token>` on every RPC. In an
+   * Bearer token sent as `Authorization: Bearer <token>` on every RPC. In an
    * SSR loader you typically read this from the request (e.g. the session
    * resolved by `getServerSession`) and pass it here so the server-side
    * load runs as the signed-in user — and so the client subscription that

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-DzeC2J3A.mjs';
-export { preloadQuery, preloadedQueryResult } from '../packem_shared/preloadQuery-lobFkD2Z.mjs';
+import{getServerSession as o}from"../packem_shared/getServerSession-BaOoo1p6.mjs";import{deserializePreloaded as l,serializePreloaded as t}from"../packem_shared/deserializePreloaded-CyFK_cv6.mjs";import{createServerClient as i}from"../packem_shared/createServerClient-kd9cUs8g.mjs";import{preloadQuery as s,preloadedQueryResult as f}from"../packem_shared/preloadQuery-uFy24PCR.mjs";export{i as createServerClient,l as deserializePreloaded,o as getServerSession,s as preloadQuery,f as preloadedQueryResult,t as serializePreloaded};

package/dist/upload.d.mts

@@ -0,0 +1,35 @@
+import { UploadControl, HeadersResolver, UploadRestrictions, ChunkedRestAdapter, MultipartAdapter, TusAdapter } from '@visulima/storage-client';
+export { type ChunkedRestAdapter, type ChunkedRestAdapterOptions, type FingerprintFunction, type HeadersResolver, LocalStorageUrlStorage, MemoryUrlStorage, type MultipartAdapter, type MultipartAdapterOptions, type OnBeforeRequest, type RequestOptions, RestrictionError, type TusAdapter, type TusAdapterOptions, type UploadControl, UploadError, type UploadMethod, type UploadRestrictions, type UploadResult, type Uploader, type UrlStorage, createChunkedRestAdapter, createMultipartAdapter, createTusAdapter, putFile, validateFile, validateFiles } from '@visulima/storage-client';
+/** Resumable upload wire protocols {@link createUpload} can drive. */
+type UploadProtocol = "chunked-rest" | "multipart" | "tus";
+/** The adapter shape {@link createUpload} returns — a `.upload(file)` driver plus lifecycle callbacks. */
+type UploadAdapter = ChunkedRestAdapter | MultipartAdapter | TusAdapter;
+/** Options for {@link createUpload}. */
+interface CreateUploadOptions {
+  /** Chunk size in bytes (TUS / chunked-REST only). */
+  chunkSize?: number;
+  /** A shared {@link UploadControl} for pause/resume/cancel (TUS / chunked-REST). */
+  control?: UploadControl;
+  /** The upload endpoint — a route backed by `@lunora/storage/upload`'s handler. */
+  endpoint: string;
+  /** Static or dynamically-resolved request headers (e.g. an `Authorization` token). */
+  headers?: HeadersResolver;
+  /** Maximum retry attempts (TUS / chunked-REST, when `retry` is on). */
+  maxRetries?: number;
+  /** Extra metadata sent with the upload. */
+  metadata?: Record<string, string>;
+  /** Which protocol to speak. Default `"tus"` (resumable, pause/resume-capable). */
+  protocol?: UploadProtocol;
+  /** Client-side size/type restrictions, validated before any network request. */
+  restrictions?: UploadRestrictions;
+  /** Enable automatic retry on failure (TUS / chunked-REST). */
+  retry?: boolean;
+}
+/**
+ * Create a protocol-appropriate upload adapter against an RLS-gated endpoint.
+ * Defaults to TUS — the resumable path that survives pause/resume and a dropped
+ * connection. Call `.upload(file)` to start; use the shared {@link UploadControl}
+ * (or the adapter's `pause`/`resume`/`abort`) to steer it.
+ */
+declare const createUpload: (options: CreateUploadOptions) => UploadAdapter;
+export { CreateUploadOptions, UploadAdapter, UploadProtocol, createUpload };