@lunora/client 1.0.0-alpha.231 → 1.0.0-alpha.233

package/dist/packem_shared/OfflineQueue-BLRESpAe.mjs

@@ -0,0 +1 @@
+import{O as s,n,r as o}from"./offline-queue-Dt_um8sR.mjs";export{s as OfflineQueue,n as nextId,o as reportPersistenceError};

package/dist/packem_shared/TabCoordinator-DBuR7Dwv.mjs

@@ -0,0 +1 @@
+let d=0;const s="lunora-bridge",o=1e3,h=3e3;class l{bc;tabId;heartbeatInterval;leaderTimeout;knownLeader=void 0;leader=!1;running=!1;promotionPending=!1;lastHeartbeat=0;pendingData=new Map;heartbeatTimer=void 0;leaderCheckTimer=void 0;onBecomeLeader;onStopBeingLeader;onConnectionStatus;onSubscriptionData;onLeaderClaimAnswered;onSubscriptionError;onSubscriptionSettled;constructor(t={}){if(d+=1,this.tabId=`tab_${String(d)}_${crypto.randomUUID()}`,this.heartbeatInterval=t.heartbeatInterval??o,this.leaderTimeout=t.leaderTimeout??h,this.onBecomeLeader=t.onBecomeLeader,this.onStopBeingLeader=t.onStopBeingLeader,this.onConnectionStatus=t.onConnectionStatus,this.onSubscriptionData=t.onSubscriptionData,this.onLeaderClaimAnswered=t.onLeaderClaimAnswered,this.onSubscriptionError=t.onSubscriptionError,this.onSubscriptionSettled=t.onSubscriptionSettled,typeof BroadcastChannel>"u"){this.bc=void 0;return}this.bc=new BroadcastChannel(t.channelName??s),this.bc.addEventListener("message",e=>{this.handleMessage(e.data)})}start(){if(!this.running){if(this.running=!0,this.bc===void 0){this.becomeLeader();return}this.broadcast({type:"claim-leadership",tabId:this.tabId,ts:Date.now()}),setTimeout(()=>{this.running&&this.knownLeader===void 0&&this.becomeLeader()},this.leaderTimeout),this.leaderCheckTimer=setInterval(()=>{this.checkLeaderHealth()},this.leaderTimeout),this.heartbeatTimer=setInterval(()=>{this.sendHeartbeat()},this.heartbeatInterval)}}stop(){this.running=!1,this.leader&&(this.broadcast({type:"yield-leadership",tabId:this.tabId}),this.leader=!1,this.knownLeader=void 0,this.onStopBeingLeader?.()),this.heartbeatTimer!==void 0&&(clearInterval(this.heartbeatTimer),this.heartbeatTimer=void 0),this.leaderCheckTimer!==void 0&&(clearInterval(this.leaderCheckTimer),this.leaderCheckTimer=void 0),this.bc?.close()}isLeader(){return this.leader}promoteImmediately(){this.running&&this.becomeLeader()}get leaderTabId(){return this.knownLeader}get id(){return this.tabId}get isRunning(){return this.running}broadcastSubscriptionData(t,e,i,a,r){this.leader&&(this.pendingData.size===0&&queueMicrotask(()=>{this.flushPendingData()}),this.pendingData.set(t,{type:"subscription-data",tabId:this.tabId,key:t,data:e,...i===void 0?{}:{cursor:i},...a===void 0?{}:{epoch:a},...r===void 0?{}:{identity:r}}))}broadcastSubscriptionError(t,e,i){this.leader&&this.broadcast({type:"subscription-error",tabId:this.tabId,key:t,error:e,...i===void 0?{}:{identity:i}})}broadcastSubscriptionSettled(t,e,i,a,r,n){this.leader&&this.broadcast({type:"subscription-settled",tabId:this.tabId,key:t,...e===void 0?{}:{cursor:e},...i===void 0?{}:{epoch:i},...a===void 0?{}:{lastMutationId:a},...r===void 0?{}:{clientId:r},...n===void 0?{}:{identity:n}})}broadcastConnectionStatus(t,e){this.leader&&this.broadcast({type:"connection-status",tabId:this.tabId,status:t,...e===void 0?{}:{identity:e}})}broadcast(t){this.flushPendingData(),this.bc?.postMessage(t)}flushPendingData(){if(this.pendingData.size===0)return;const t=[...this.pendingData.values()];if(this.pendingData.clear(),!!this.leader)for(const e of t)this.bc?.postMessage(e)}handleMessage(t){switch(t.type){case"claim-leadership":{this.handleClaimLeadership(t);break}case"connection-status":{if(this.leader||t.tabId===this.tabId)break;this.onConnectionStatus?.(t.status,t.identity);break}case"heartbeat":{this.handleHeartbeat(t);break}case"subscription-data":{if(this.leader||t.tabId===this.tabId)break;this.onSubscriptionData?.(t.key,t.data,t.cursor,t.epoch,t.identity);break}case"subscription-error":{if(this.leader||t.tabId===this.tabId)break;this.onSubscriptionError?.(t.key,t.error,t.identity);break}case"subscription-settled":{if(this.leader||t.tabId===this.tabId)break;this.onSubscriptionSettled?.(t.key,t.cursor,t.epoch,t.lastMutationId,t.clientId,t.identity);break}case"yield-leadership":{this.knownLeader===t.tabId&&(this.knownLeader=void 0,this.running&&!this.leader&&this.claimAndPromote());break}}}handleClaimLeadership(t){if(t.tabId!==this.tabId){if(this.leader){this.broadcast({type:"heartbeat",tabId:this.tabId,ts:Date.now()}),this.onLeaderClaimAnswered?.();return}this.knownLeader===void 0&&t.tabId<this.tabId&&(this.knownLeader=t.tabId,this.lastHeartbeat=t.ts)}}handleHeartbeat(t){if(t.tabId!==this.tabId){if(this.leader){this.resolveLeaderVsLeaderTieBreak(t);return}this.lastHeartbeat=t.ts,this.knownLeader=t.tabId}}resolveLeaderVsLeaderTieBreak(t){t.tabId<this.tabId?(this.leader=!1,this.knownLeader=t.tabId,this.lastHeartbeat=t.ts,this.onStopBeingLeader?.()):this.broadcast({type:"heartbeat",tabId:this.tabId,ts:Date.now()})}becomeLeader(){this.leader||(this.leader=!0,this.knownLeader=this.tabId,this.lastHeartbeat=Date.now(),this.onBecomeLeader?.(),this.broadcast({type:"heartbeat",tabId:this.tabId,ts:Date.now()}))}sendHeartbeat(){this.leader&&this.broadcast({type:"heartbeat",tabId:this.tabId,ts:Date.now()})}checkLeaderHealth(){if(!this.running||this.leader)return;if(this.knownLeader===void 0){this.claimAndPromote();return}Date.now()-this.lastHeartbeat>this.leaderTimeout&&(this.knownLeader=void 0,this.claimAndPromote())}claimAndPromote(){this.promotionPending||(this.promotionPending=!0,this.broadcast({type:"claim-leadership",tabId:this.tabId,ts:Date.now()}),setTimeout(()=>{this.promotionPending=!1,this.running&&this.knownLeader===void 0&&this.becomeLeader()},this.leaderTimeout))}}export{l as TabCoordinator};

package/dist/packem_shared/client-tuning-C10B2KCO.mjs

@@ -0,0 +1 @@
+const _=3e4,E=1e4,T=3e4,A=5e3,s=3,S=250,M=5e3,L=5e3,I=64,R=3,C=1e4,U=5,a=8;export{_ as D,L as I,I as M,S as Q,R,M as S,E as a,T as b,A as c,s as d,C as e,U as f,a as g};

package/dist/packem_shared/connectLiveStream-CXD8k-Sp.mjs

@@ -0,0 +1 @@
+import{c as i}from"./live-stream-Dil9byXF.mjs";import"./client-tuning-C10B2KCO.mjs";import"./createReconnect-CjTmjJDH.mjs";import"./stream-idle-C7CsIT_m.mjs";export{i as connectLiveStream};

package/dist/packem_shared/{createAsyncStorageQueryCache-f5023fdB.mjs → createAsyncStorageQueryCache-COqH5_SV.mjs}

@@ -1 +1 @@
-import{assertMaxEntries as y}from"./createInMemoryQueryCache-D2uNHLfM.mjs";import{s as u}from"./single-blob-store-DpqSxsgi.mjs";const w="lunora:query-cache",d=50,E=s=>{const n=y(s.maxEntries??d,"createAsyncStorageQueryCache"),r=u(s.storage,s.key??w),c=async()=>{const e=await r.read();return typeof e=="object"&&e!==null&&!Array.isArray(e)?new Map(Object.entries(e)):new Map},o=e=>r.write(Object.fromEntries(e)),i=e=>{if(e.size<=n)return;const a=[...e.values()].toSorted((t,l)=>t.ts-l.ts);for(const t of a){if(e.size<=n)break;e.delete(t.key)}};return{clear:r.clear,load:()=>r.serialize(async()=>[...(await c()).values()]),put:(e,a)=>r.serialize(async()=>{const t=await c();t.set(e,{...a,key:e}),i(t),await o(t)}),remove:e=>r.serialize(async()=>{const a=await c();a.delete(e)&&await o(a)})}};export{E as createAsyncStorageQueryCache};
+import{assertMaxEntries as y}from"./createInMemoryQueryCache-B5wX-gTy.mjs";import{s as u}from"./single-blob-store-DpqSxsgi.mjs";const w="lunora:query-cache",d=50,E=s=>{const n=y(s.maxEntries??d,"createAsyncStorageQueryCache"),r=u(s.storage,s.key??w),c=async()=>{const e=await r.read();return typeof e=="object"&&e!==null&&!Array.isArray(e)?new Map(Object.entries(e)):new Map},o=e=>r.write(Object.fromEntries(e)),i=e=>{if(e.size<=n)return;const a=[...e.values()].toSorted((t,l)=>t.ts-l.ts);for(const t of a){if(e.size<=n)break;e.delete(t.key)}};return{clear:r.clear,load:()=>r.serialize(async()=>[...(await c()).values()]),put:(e,a)=>r.serialize(async()=>{const t=await c();t.set(e,{...a,key:e}),i(t),await o(t)}),remove:e=>r.serialize(async()=>{const a=await c();a.delete(e)&&await o(a)})}};export{E as createAsyncStorageQueryCache};

package/dist/packem_shared/{createInMemoryPersistence-Cz2W6XVj.mjs → createInMemoryPersistence-BfgXApi_.mjs}

@@ -1 +1 @@
-import{LunoraError as u}from"@lunora/errors";import{p as s,c as f,a as y}from"./idb-utility-C8WS390w.mjs";const x=()=>{const r=new Map,t=e=>({...e,args:{...e.args}});return{append:e=>(r.set(e.id,t(e)),Promise.resolve()),clear:()=>(r.clear(),Promise.resolve()),load:()=>Promise.resolve([...r.values()].map(e=>t(e))),remove:e=>(r.delete(e),Promise.resolve()),replace:e=>(r.has(e.id)&&r.set(e.id,t(e)),Promise.resolve())}},m="lunora-outbox",p="offline-mutations",d="by_id",w=(r={})=>{const t=r.indexedDB??(typeof indexedDB>"u"?void 0:indexedDB);if(!t)throw new u("INTERNAL","createIndexedDbPersistence: no IndexedDB available — pass `indexedDB` or use createInMemoryPersistence()");const e=r.databaseName??m,c=r.storeName??p,l=y(t,e,1,a=>{a.objectStoreNames.contains(c)||a.createObjectStore(c,{autoIncrement:!0}).createIndex(d,"id",{unique:!0})}),o=f(l,c);return{append:async a=>{await o("readwrite",n=>s(n.add(a)))},clear:async()=>{await o("readwrite",a=>s(a.clear()))},load:async()=>o("readonly",a=>s(a.getAll())),remove:async a=>{await o("readwrite",async n=>{const i=await s(n.index(d).getKey(a));i!==void 0&&await s(n.delete(i))})},replace:async a=>{await o("readwrite",async n=>{const i=await s(n.index(d).getKey(a.id));i!==void 0&&await s(n.put(a,i))})}}},b=(r,t=!0)=>{if(r!==!1){if(r)return r;if(!(!t||typeof indexedDB>"u"))return w()}};export{x as createInMemoryPersistence,w as createIndexedDbPersistence,b as resolvePersistenceAdapter};
+import{LunoraError as u}from"@lunora/errors";import{p as s,c as f,a as y}from"./idb-utility-BS7xvou1.mjs";const x=()=>{const r=new Map,t=e=>({...e,args:{...e.args}});return{append:e=>(r.set(e.id,t(e)),Promise.resolve()),clear:()=>(r.clear(),Promise.resolve()),load:()=>Promise.resolve([...r.values()].map(e=>t(e))),remove:e=>(r.delete(e),Promise.resolve()),replace:e=>(r.has(e.id)&&r.set(e.id,t(e)),Promise.resolve())}},m="lunora-outbox",p="offline-mutations",d="by_id",w=(r={})=>{const t=r.indexedDB??(typeof indexedDB>"u"?void 0:indexedDB);if(!t)throw new u("INTERNAL","createIndexedDbPersistence: no IndexedDB available — pass `indexedDB` or use createInMemoryPersistence()");const e=r.databaseName??m,c=r.storeName??p,l=y(t,e,1,a=>{a.objectStoreNames.contains(c)||a.createObjectStore(c,{autoIncrement:!0}).createIndex(d,"id",{unique:!0})}),o=f(l,c);return{append:async a=>{await o("readwrite",n=>s(n.add(a)))},clear:async()=>{await o("readwrite",a=>s(a.clear()))},load:async()=>o("readonly",a=>s(a.getAll())),remove:async a=>{await o("readwrite",async n=>{const i=await s(n.index(d).getKey(a));i!==void 0&&await s(n.delete(i))})},replace:async a=>{await o("readwrite",async n=>{const i=await s(n.index(d).getKey(a.id));i!==void 0&&await s(n.put(a,i))})}}},b=(r,t=!0)=>{if(r!==!1){if(r)return r;if(!(!t||typeof indexedDB>"u"))return w()}};export{x as createInMemoryPersistence,w as createIndexedDbPersistence,b as resolvePersistenceAdapter};

package/dist/packem_shared/{createInMemoryQueryCache-D2uNHLfM.mjs → createInMemoryQueryCache-B5wX-gTy.mjs}

@@ -1 +1 @@
-import{LunoraError as v}from"@lunora/errors";import{p as u,c as h,a as I}from"./idb-utility-C8WS390w.mjs";const T=(e,o,a)=>`${e}::${o}::${a??""}`,w=500,E=(e,o)=>{if(!Number.isInteger(e)||e<1)throw new v("INTERNAL",`${o}: maxEntries must be a positive integer, got ${String(e)}`);return e},B=(e={})=>{const o=E(e.maxEntries??w,"createInMemoryQueryCache"),a=new Map,s=r=>({...r,value:structuredClone(r.value)}),l=()=>{if(a.size<=o)return;const r=[...a.values()].toSorted((n,y)=>n.ts-y.ts);for(const n of r){if(a.size<=o)break;a.delete(n.key)}};return{clear:()=>(a.clear(),Promise.resolve()),load:()=>Promise.resolve([...a.values()].map(r=>s(r))),put:(r,n)=>(a.set(r,s({...n,key:r})),l(),Promise.resolve()),remove:r=>(a.delete(r),Promise.resolve())}},A="lunora-query-cache",b="query-cache",f="by_ts",p=1,N=(e={})=>{const o=e.indexedDB??(typeof indexedDB>"u"?void 0:indexedDB);if(!o)throw new v("INTERNAL","createIndexedDbQueryCache: no IndexedDB available — pass `indexedDB` or use createInMemoryQueryCache()");const a=e.databaseName??A,s=e.storeName??b,l=E(e.maxEntries??w,"createIndexedDbQueryCache"),r=I(o,a,p,t=>{t.objectStoreNames.contains(s)||t.createObjectStore(s,{keyPath:"key"}).createIndex(f,"ts",{unique:!1})}),n=h(r,s),y=async t=>{let c=await u(t.count())-l;c<=0||await new Promise((D,x)=>{const d=t.index(f).openCursor();d.addEventListener("success",()=>{const m=d.result;if(!m||c<=0){D();return}m.delete(),c-=1,m.continue()}),d.addEventListener("error",()=>{x(d.error??new Error("IndexedDB eviction failed"))})})};return{clear:async()=>{await n("readwrite",t=>u(t.clear()))},load:async()=>n("readonly",t=>u(t.getAll())),put:async(t,i)=>{await n("readwrite",async c=>{await u(c.put({...i,key:t})),await y(c)})},remove:async t=>{await n("readwrite",i=>u(i.delete(t)))}}},L=e=>{if(e!==!1){if(e)return e;if(!(typeof indexedDB>"u"))return N()}};export{E as assertMaxEntries,B as createInMemoryQueryCache,N as createIndexedDbQueryCache,T as queryCacheKey,L as resolveQueryCacheAdapter};
+import{LunoraError as v}from"@lunora/errors";import{p as u,c as h,a as I}from"./idb-utility-BS7xvou1.mjs";const T=(e,o,a)=>`${e}::${o}::${a??""}`,w=500,E=(e,o)=>{if(!Number.isInteger(e)||e<1)throw new v("INTERNAL",`${o}: maxEntries must be a positive integer, got ${String(e)}`);return e},B=(e={})=>{const o=E(e.maxEntries??w,"createInMemoryQueryCache"),a=new Map,s=r=>({...r,value:structuredClone(r.value)}),l=()=>{if(a.size<=o)return;const r=[...a.values()].toSorted((n,y)=>n.ts-y.ts);for(const n of r){if(a.size<=o)break;a.delete(n.key)}};return{clear:()=>(a.clear(),Promise.resolve()),load:()=>Promise.resolve([...a.values()].map(r=>s(r))),put:(r,n)=>(a.set(r,s({...n,key:r})),l(),Promise.resolve()),remove:r=>(a.delete(r),Promise.resolve())}},A="lunora-query-cache",b="query-cache",f="by_ts",p=1,N=(e={})=>{const o=e.indexedDB??(typeof indexedDB>"u"?void 0:indexedDB);if(!o)throw new v("INTERNAL","createIndexedDbQueryCache: no IndexedDB available — pass `indexedDB` or use createInMemoryQueryCache()");const a=e.databaseName??A,s=e.storeName??b,l=E(e.maxEntries??w,"createIndexedDbQueryCache"),r=I(o,a,p,t=>{t.objectStoreNames.contains(s)||t.createObjectStore(s,{keyPath:"key"}).createIndex(f,"ts",{unique:!1})}),n=h(r,s),y=async t=>{let c=await u(t.count())-l;c<=0||await new Promise((D,x)=>{const d=t.index(f).openCursor();d.addEventListener("success",()=>{const m=d.result;if(!m||c<=0){D();return}m.delete(),c-=1,m.continue()}),d.addEventListener("error",()=>{x(d.error??new Error("IndexedDB eviction failed"))})})};return{clear:async()=>{await n("readwrite",t=>u(t.clear()))},load:async()=>n("readonly",t=>u(t.getAll())),put:async(t,i)=>{await n("readwrite",async c=>{await u(c.put({...i,key:t})),await y(c)})},remove:async t=>{await n("readwrite",i=>u(i.delete(t)))}}},L=e=>{if(e!==!1){if(e)return e;if(!(typeof indexedDB>"u"))return N()}};export{E as assertMaxEntries,B as createInMemoryQueryCache,N as createIndexedDbQueryCache,T as queryCacheKey,L as resolveQueryCacheAdapter};

package/dist/packem_shared/{createServerClient-BqCdfoE1.mjs → createServerClient-CwEIYb-6.mjs}

@@ -1 +1 @@
-import{LunoraClient as r}from"./LunoraClient-D6MyuSWy.mjs";const c=e=>{const t=new r({fetch:e.fetch,url:e.url});return e.token!==void 0&&t.setAuthToken(e.token),t};export{c as createServerClient};
+import{LunoraClient as r}from"./LunoraClient-CN4shVl4.mjs";const c=e=>{const t=new r({fetch:e.fetch,url:e.url});return e.token!==void 0&&t.setAuthToken(e.token),t};export{c as createServerClient};

package/dist/packem_shared/httpStream-DceAMeMf.mjs

@@ -0,0 +1,9 @@
+import{LunoraError as u}from"@lunora/errors";import{decodeWire as L}from"@lunora/wire";import{createReconnect as I}from"./createReconnect-CjTmjJDH.mjs";import{createStream as C}from"./DEFAULT_MAX_BUFFER-Bd-_iyiV.mjs";import{r as H}from"./stream-idle-C7CsIT_m.mjs";const y=/^ /u,$=/^\d+$/u,x=2147483647,B=10,k=1e3,_=t=>typeof t=="object"&&t!==null?JSON.stringify(t):String(t),F=t=>{let n="",e,a;const s=[];for(const r of t.split(`
+`))if(r.startsWith("event:"))n=r.slice(6).replace(y,"");else if(r.startsWith("data:"))s.push(r.slice(5).replace(y,""));else if(r.startsWith("id:")){const c=r.slice(3).replace(y,"");c.includes("\0")||(e=c)}else if(r.startsWith("retry:")){const c=r.slice(6).replace(y,"");$.test(c)&&Number.isSafeInteger(Number(c))&&(a=Math.min(Number(c),x))}return{data:s.join(`
+`),event:n,id:e,retry:a}},W=(t,n,e)=>{const a=n.params??{},s=t.path.split("/").map(o=>{if(!o.startsWith(":"))return o;const f=o.slice(1),p=a[f];if(p===void 0)throw new u("HTTP_STREAM_MISSING_PARAM",`httpStream: missing path param ":${f}" for route ${t.path}`);return encodeURIComponent(_(p))}).join("/"),r=new URLSearchParams;for(const[o,f]of Object.entries(n.searchParams??{}))f!==void 0&&r.set(o,_(f));const c=r.toString();return`${e.endsWith("/")?e.slice(0,-1):e}${s}${c===""?"":`?${c}`}`},j=(t,n)=>{if(t.event==="complete")return n.complete(),!0;if(t.event==="error"){let e={};try{e=JSON.parse(t.data)}catch{}const a=typeof e.message=="string"?e.message:"stream error",s=typeof e.code=="string"?e.code:"HTTP_STREAM_ERROR",r=new u(s,a);return typeof e.why=="string"&&(r.why=e.why),n.fail(r),!0}if((t.event===""||t.event==="message")&&t.data!=="")try{n.push(L(JSON.parse(t.data)))}catch{return n.fail(new u("HTTP_STREAM_BAD_CHUNK","httpStream: malformed SSE chunk (invalid JSON)")),!0}return!1},D=async(t,n,e,a,s=0)=>{const r=t.getReader(),c=new TextDecoder;let m="",o=!1;const f=d=>{let l=o?`\r${d}`:d;o=l.endsWith("\r"),o&&(l=l.slice(0,-1)),m+=l.replaceAll(`\r
+`,`
+`)},p=()=>{let d=m.indexOf(`
+
+`);for(;d!==-1;){const l=F(m.slice(0,d));if(m=m.slice(d+2),e.onFrame?.(),l.id!==void 0&&e.onId?.(l.id),l.retry!==void 0&&e.onRetry?.(l.retry),j(l,n))return!0;d=m.indexOf(`
+
+`)}return!1},T=()=>r.cancel().then(()=>{},()=>{});try{for(;;){const{done:d,value:l}=await H(r,s);if(d)break;if(f(c.decode(l,{stream:!0})),p())return await T(),!0}return f(c.decode()),p()}catch(d){throw a.abort(),T().catch(()=>{}),d}},U=async(t,n)=>{n.aborted||await new Promise(e=>{let a;const s=()=>{clearTimeout(a),e()};a=setTimeout(()=>{n.removeEventListener("abort",s),e()},t),n.addEventListener("abort",s,{once:!0})})},J=(t,n)=>{if(typeof t!="object"||t===null)return;const{code:e,error:a,why:s}=t;if(!(typeof e!="string"||typeof a!="string"))return new u("HTTP_STREAM_STATUS",`httpStream: request failed (status ${n.toString()}, ${e}): ${a}`,{status:n,why:typeof s=="string"?s:void 0})},Y=async(t,n)=>{let e;const a=new Promise(r=>{e=setTimeout(()=>{r(void 0)},k)}),s=t.json().catch(r=>{if(n.aborted)throw r});try{return await Promise.race([s,a])}finally{clearTimeout(e),await t.body?.cancel().catch(()=>{})}},q=(t,n)=>{const e=Object.entries(t??{}).filter(([a])=>n===void 0||a.toLowerCase()!=="last-event-id");return{accept:"text/event-stream",...Object.fromEntries(e),...n===void 0?{}:{"last-event-id":n}}},A=t=>t instanceof Error&&"code"in t?t:new u("HTTP_STREAM_TRANSPORT",t instanceof Error?t.message:String(t),{cause:t}),V=(t,n,e={})=>{const a=e.fetch??(typeof fetch=="function"?fetch.bind(globalThis):void 0);if(!a)throw new u("INTERNAL","httpStream: no `fetch` implementation available");const s=W(t,n??{},e.baseUrl??""),r=new AbortController;let c;e.signal&&(e.signal.aborted?r.abort():(c=()=>{r.abort()},e.signal.addEventListener("abort",c,{once:!0})));const m=()=>{c&&e.signal?.removeEventListener("abort",c)},{handle:o,iterable:f}=C({maxBuffer:e.maxBuffer,onCancel:()=>{r.abort()},onFail:()=>{r.abort()}}),p=e.reconnect??!1,T=I();let{lastEventId:d}=e,l,v=0;const M=()=>{T.reset(),v=0},E={},R=i=>{try{i()}catch(S){throw E.value={error:S},S}},P={onFrame:M,onId:i=>{R(()=>e.onEventId?.(i)),d=i},onRetry:i=>{R(()=>e.onRetry?.(i)),l=i}},O=async()=>{const i=q(e.headers,d),S=new u("HTTP_STREAM_INTERRUPTED","httpStream: stream ended without a complete frame"),b=new AbortController,g=()=>{b.abort()};r.signal.addEventListener("abort",g,{once:!0});try{const h=await a(s,{headers:i,method:t.method,signal:b.signal});if(!h.ok){const N=await Y(h,r.signal);o.fail(J(N,h.status)??new u("HTTP_STREAM_STATUS",`httpStream: request failed (status ${h.status.toString()})`,{status:h.status}));return}if(!h.body){o.fail(new u("HTTP_STREAM_NO_BODY","httpStream: response has no body"));return}return{completed:await D(h.body,o,P,b,e.idleTimeoutMs),error:S}}catch(h){if(r.signal.aborted){o.complete();return}if(E.value){const{error:w}=E.value;o.fail(w instanceof Error?w:new u("HTTP_STREAM_CALLBACK","httpStream: an onEventId/onRetry callback threw"));return}return{completed:!1,error:A(h)}}finally{r.signal.removeEventListener("abort",g)}};return(async()=>{try{for(;;){if(r.signal.aborted){o.complete();return}const i=await O();if(!i)return;if(i.completed||!p||v>=B){i.completed||o.fail(i.error);return}v+=1,await U(l??T.next(),r.signal)}}finally{m()}})().catch(i=>{if(r.signal.aborted){o.complete();return}o.fail(A(i))}),f};export{V as httpStream};

package/dist/packem_shared/idb-utility-BS7xvou1.mjs

@@ -0,0 +1 @@
+const c=t=>new Promise((n,s)=>{t.addEventListener("success",()=>{n(t.result)}),t.addEventListener("error",()=>{s(t.error??new Error("IndexedDB request failed"))})}),E=(t,n,s,o)=>{let a;return()=>{if(a)return a;const e=new Promise((d,i)=>{const r=t.open(n,s);r.addEventListener("upgradeneeded",()=>{o(r.result)}),r.addEventListener("success",()=>{d(r.result)}),r.addEventListener("error",()=>{i(r.error??new Error("IndexedDB open failed"))})});return a=e,e.catch(()=>{a===e&&(a=void 0)}),e}},u=(t,n)=>async(s,o)=>{const e=(await t()).transaction(n,s),d=await o(e.objectStore(n));return await new Promise((i,r)=>{e.addEventListener("complete",()=>{i()}),e.addEventListener("error",()=>{r(e.error??new Error("IndexedDB transaction failed"))}),e.addEventListener("abort",()=>{r(e.error??new Error("IndexedDB transaction aborted"))})}),d};export{E as a,u as c,c as p};

package/dist/packem_shared/live-stream-Dil9byXF.mjs

@@ -0,0 +1,10 @@
+import{decodeWire as K}from"@lunora/wire";import{S as q}from"./client-tuning-C10B2KCO.mjs";import{createReconnect as F}from"./createReconnect-CjTmjJDH.mjs";import{r as z}from"./stream-idle-C7CsIT_m.mjs";const Q="x-lunora-live-connection",X="live",ie=c=>`/live/${c}/connect`,D=c=>c===void 0?void 0:(...s)=>{c(...s)},Y=/^ /u,Z=1e4,ee=c=>{const s=c.indexOf("?"),f=s===-1?c:c.slice(0,s);if(!f.endsWith("/connect"))throw new Error(`connectLiveStream: expected a connect URL ending in "/connect", got "${c}"`);return`${f.slice(0,-8)}/control${s===-1?"":c.slice(s)}`},te=c=>{let s="message";const f=[];for(const m of c.split(`
+`))m.startsWith("event:")?s=m.slice(6).trim():m.startsWith("data:")&&f.push(m.slice(5).replace(Y,""));return f.length===0?void 0:{data:f.join(`
+`),event:s}},ae=(c,s={})=>{const f=s.fetch??fetch,m=ee(c),k=s.maxDelayMs??3e4,U=s.idleTimeoutMs??75e3,O=F({initialDelayMs:s.retryDelay??1e3,maxDelayMs:k}),M=s.withCredentials===!0?"include":"same-origin",_=new URL(c,"https://lunora.invalid").searchParams.get("shard")??void 0,l=new Map,y=new Set;let h,v,I,C=!1,N=0;const W=()=>{let e;do N+=1,e=`live-${String(N)}`;while(l.has(e));return e},L=()=>C;let g,E;const P=new Promise((e,t)=>{g=e,E=t});P.catch(()=>{});const R={...s.headers},S=new Map,T=new Set,j=async e=>{const t=new AbortController,r=setTimeout(()=>{t.abort()},Z);T.add(t);try{const n=await f(m,{body:JSON.stringify(_===void 0?e:{...e,shardKey:_}),credentials:M,headers:{"content-type":"application/json",...R},method:"POST",signal:t.signal});return await n.text(),n.status}catch{return}finally{clearTimeout(r),T.delete(t)}},A=(e,t)=>{const n=(S.get(e)??Promise.resolve()).then(()=>L()?void 0:j(t)),o=n.then(()=>{},()=>{});return S.set(e,o),o.then(()=>{S.get(e)===o&&S.delete(e)}).catch(()=>{}),n},V=(e,t)=>{for(const r of l.values())if(r.topic===e)for(const n of r.handlers)try{n(t)}catch{}for(const r of y)try{r({payload:t,topic:e})}catch{}},B=e=>{const t=te(e);if(t?.event===X)try{const r=JSON.parse(t.data);V(r.topic,K(r.data))}catch{}},$=(e,t,r)=>{if(l.get(e)===t){l.delete(e);for(const n of t.errors)try{n({status:r,subscriptionId:e,topic:t.topic})}catch{}}},H=async()=>{const e=await Promise.all([...l].map(async([t,r])=>{const n=await A(t,{action:"subscribe",connectionId:h,subscriptionId:t,topic:r.topic});return{entry:r,id:t,status:n}}));for(const{entry:t,id:r,status:n}of e){if(n===void 0||n>=500||n===404||n===401){v?.abort();return}n>=400&&$(r,t,n)}},G=async e=>{h=e.headers.get(Q)??void 0,I=setTimeout(()=>{O.reset()},q);const r=(async()=>{try{await H()}catch{v?.abort();return}g?.(),g=void 0,E=void 0})(),n=e.body?.getReader();if(n===void 0){await r;return}const o=new TextDecoder;let a="",i=!1;for(;;){let u;try{u=await z(n,U)}catch(J){throw n.cancel().catch(()=>{}),v?.abort(),J}const{done:w,value:x}=u;if(w)break;const b=o.decode(x,{stream:!0}),p=i?`\r${b}`:b;i=p.endsWith("\r"),a+=(i?p.slice(0,-1):p).replaceAll(`\r
+`,`
+`).replaceAll("\r",`
+`);let d=a.indexOf(`
+
+`);for(;d!==-1;)B(a.slice(0,d)),a=a.slice(d+2),d=a.indexOf(`
+
+`)}await r};return(async()=>{for(;!L();){v=new AbortController;try{const t=await f(c,{credentials:M,headers:{accept:"text/event-stream",...R},signal:v.signal});if(!t.ok)throw new Error(`live stream connect failed: HTTP ${String(t.status)}`);await G(t)}catch{}if(clearTimeout(I),h=void 0,L())return;const e=O.next();await new Promise(t=>{setTimeout(t,e)})}})().catch(()=>{}),{close:()=>{C=!0,v?.abort();for(const e of T)e.abort();T.clear(),l.clear(),y.clear(),E?.(new Error("connectLiveStream: closed before the first connection")),g=void 0,E=void 0},get connectionId(){return h},onEvent:e=>(y.add(e),()=>y.delete(e)),ready:P,subscribe:({id:e,onError:t,onEvent:r,topic:n})=>{if(C)throw new Error("connectLiveStream: subscribe on a closed stream");const o=e??W(),a=l.get(o);if(a!==void 0&&a.topic!==n)throw new Error(`connectLiveStream: subscription id "${o}" already follows "${a.topic}"; unsubscribe it first`);const i=a??{errors:new Set,handlers:new Set,refs:0,topic:n},u=D(r),w=D(t);if(i.refs+=1,u!==void 0&&i.handlers.add(u),w!==void 0&&i.errors.add(w),a===void 0&&(l.set(o,i),h!==void 0)){const b=h,p=v;A(o,{action:"subscribe",connectionId:b,subscriptionId:o,topic:n}).then(d=>{if(d===void 0||d===401||d===404||d>=500){b===h&&l.get(o)===i&&p?.abort();return}d>=400&&$(o,i,d)}).catch(()=>{})}let x=!1;return()=>{x||(x=!0,u!==void 0&&i.handlers.delete(u),w!==void 0&&i.errors.delete(w),i.refs-=1,!(i.refs>0||l.get(o)!==i)&&(l.delete(o),A(o,{action:"unsubscribe",connectionId:h,subscriptionId:o,topic:n}).catch(()=>{})))}}}};export{ae as c,ie as l};

package/dist/packem_shared/{liveTopicSubscription-Bs-ULKfs.mjs → liveTopicSubscription-gOmRbuhH.mjs}

@@ -1 +1 @@
-import{c as u,l as d}from"./live-stream-ct8j7T75.mjs";import{j as y,w as f}from"./client-urls-BHLUjjcG.mjs";const o=new Map,v=e=>JSON.stringify([e.url,e.sessionKey,e.withCredentials===!0,e.retryDelay,e.maxDelayMs,Object.entries(e.headers??{}).toSorted(([t],[r])=>t.localeCompare(r))]),T=e=>{const t=v(e);let r=o.get(t);if(r===void 0){const{headers:i,maxDelayMs:l,retryDelay:n,withCredentials:m}=e;r={closeTimer:void 0,refs:0,stream:u(e.url,{headers:i,maxDelayMs:l,retryDelay:n,withCredentials:m})},o.set(t,r)}clearTimeout(r.closeTimer),r.closeTimer=void 0,r.refs+=1;const s=r,a=s.stream.subscribe({id:e.topic,onError:e.onError,onEvent:e.onEvent,topic:e.topic});let c=!1;return()=>{c||(c=!0,a(),s.refs-=1,s.refs===0&&(s.closeTimer=setTimeout(()=>{o.delete(t),s.stream.close()},0)))}},w=(e,t,r={})=>{const{onEvent:s,shardKey:a,...c}=r,{__lunoraLive:i,topic:l}=t;return{...c,onEvent:s,topic:l,url:y(e.url,f(d(i),{shard:a}))}};export{w as liveTopicSubscription,T as subscribeLiveTopic};
+import{c as u,l as d}from"./live-stream-Dil9byXF.mjs";import{j as y,w as f}from"./client-urls-BHLUjjcG.mjs";const o=new Map,v=e=>JSON.stringify([e.url,e.sessionKey,e.withCredentials===!0,e.retryDelay,e.maxDelayMs,Object.entries(e.headers??{}).toSorted(([t],[r])=>t.localeCompare(r))]),T=e=>{const t=v(e);let r=o.get(t);if(r===void 0){const{headers:i,maxDelayMs:l,retryDelay:n,withCredentials:m}=e;r={closeTimer:void 0,refs:0,stream:u(e.url,{headers:i,maxDelayMs:l,retryDelay:n,withCredentials:m})},o.set(t,r)}clearTimeout(r.closeTimer),r.closeTimer=void 0,r.refs+=1;const s=r,a=s.stream.subscribe({id:e.topic,onError:e.onError,onEvent:e.onEvent,topic:e.topic});let c=!1;return()=>{c||(c=!0,a(),s.refs-=1,s.refs===0&&(s.closeTimer=setTimeout(()=>{o.delete(t),s.stream.close()},0)))}},w=(e,t,r={})=>{const{onEvent:s,shardKey:a,...c}=r,{__lunoraLive:i,topic:l}=t;return{...c,onEvent:s,topic:l,url:y(e.url,f(d(i),{shard:a}))}};export{w as liveTopicSubscription,T as subscribeLiveTopic};

package/dist/packem_shared/{lunora-client.d-dOEEoF4x.d.mts → lunora-client.d-D7gNlYT7.d.mts}

@@ -530,6 +530,15 @@ interface LunoraClientOptions {
    */
   queryCache?: QueryCacheAdapter | false;
   reconnect?: ReconnectOptions;
+  /**
+   * Deadline (ms) for one HTTP RPC round trip (`query`, `mutation`, a replayed
+   * write), covering the response body as well as the connection. A request
+   * that stalls past it fails with a retryable `TransportError` — and a durable
+   * write is re-queued under the same `mutationId` — instead of freezing every
+   * write queued behind it on the shard. `action` is exempt: it may legitimately
+   * run for longer. Defaults to 30000 (30s); set to `0` (or negative) to disable.
+   */
+  rpcTimeoutMs?: number;
   url: string;
   WebSocket?: typeof WebSocket;
   /**
@@ -1355,6 +1364,14 @@ interface SubscriptionState {
    */
   serverEpoch?: string;
   readonly shardKey?: string;
+  /**
+   * Whether a poll or the leader tab has delivered a value for this subscription on the
+   * CURRENT connection. A polling connection and a follower tab see no server `ack`, so this
+   * is their only evidence of an answer, and `serverBase` cannot stand in for it: a hydrated
+   * cache sets that before anything has arrived. A WebSocket never sets it, `acked` is its
+   * evidence.
+   */
+  valueReceived: boolean;
   /**
    * The wire-encoded form of `args`, computed once at `subscribe` time (so an
    * unsupported value fails loud at the call site, not inside a reconnect's
@@ -1619,6 +1636,22 @@ interface ClientDebugSnapshot {
   shards: ClientDebugShard[];
   subscriptions: ClientDebugSubscription[];
 }
+/**
+ * Whether the client is actually caught up, which `connectionStatus()` alone cannot
+ * say: it reads `"connected"` as soon as any socket is open, though a subscription
+ * on it may not have been acknowledged yet (it has no data) and writes may still be
+ * waiting in the offline queue. See {@link LunoraClient.syncStatus}.
+ */
+interface SyncStatus {
+  /** The aggregate socket status, as {@link LunoraClient.connectionStatus} reports it. */
+  connection: ConnectionStatus;
+  /** Live queries and shapes the server has not answered yet on the current connection. */
+  pendingSubscriptions: number;
+  /** Writes queued or being replayed from the built-in offline queue (not the `@lunora/db` outbox). */
+  pendingWrites: number;
+  /** `true` only on a live connection with every subscription answered and no write queued. */
+  synced: boolean;
+}
 /**
  * Terminal verdict for a mutation that passed through the offline queue,
  * delivered to {@link LunoraClient.onMutationSettled}.
@@ -1670,6 +1703,13 @@ interface MutationSettledEvent {
 interface ActionCallOptions {
   /** Route the call to a specific shard. */
   shardKey?: string;
+  /**
+   * Abort the call. The request is cancelled and the promise rejects with the
+   * signal's reason (an `AbortError` by default). The server may already have
+   * started — or finished — the action, which is not transactional, so an abort
+   * releases the caller; it does not undo the work.
+   */
+  signal?: AbortSignal;
 }
 /**
  * Per-call options for {@link LunoraClient.mutation} — the optimistic-update
@@ -1753,6 +1793,14 @@ interface MutationCallOptions<TCurrent = unknown, TValue = unknown, TArgs = unkn
    */
   replayCredential?: ReplayCredential;
   shardKey?: string;
+  /**
+   * Stop waiting for the mutation. The promise rejects with the signal's reason
+   * (an `AbortError` by default), and nothing is sent when the signal is already
+   * aborted. A write already on the wire or in the offline queue is NOT
+   * retracted: it still commits or replays on its own, and its optimistic patch
+   * is settled by that outcome — an abort releases the caller, not the write.
+   */
+  signal?: AbortSignal;
 }
 declare const replayCredentialBrand: unique symbol;
 /**
@@ -1811,6 +1859,8 @@ declare class LunoraClient {
   private readonly connectTimeoutMs;
   /** Keepalive cadence (ms); `0` disables the heartbeat. See {@link LunoraClientOptions.heartbeatIntervalMs}. */
   private readonly heartbeatIntervalMs;
+  /** Deadline (ms) for one HTTP RPC round trip; `0` disables it. See {@link LunoraClientOptions.rpcTimeoutMs}. */
+  private readonly rpcTimeoutMs;
   /** The socket-lifecycle inputs, built once after the constructor assigns them (none is reassigned later). */
   private readonly managedSocketOptions;
   /** Failed-open run that engages the HTTP polling fallback; `0` disables it. */
@@ -1880,10 +1930,13 @@ declare class LunoraClient {
   private readonly clientWatermarks;
   /** Monotonic per-client mutation counter backing the server `__client_watermark`. */
   private outboxMutationCounter;
-  private readonly onPersistenceError;
+  /** Orders offline-queued writes by when they were issued; see {@link QueuedMutation.issueSeq}. */
+  private mutationIssueCounter;
   private readonly persistence;
   /** App/schema version stamped on persisted writes + cached reads; mismatches are purged. */
   private readonly persistenceVersion;
+  /** Removes the page-hide flush listeners on close (see `installPageHideFlush`). */
+  private releasePageHideFlush;
   /** Releases the multi-tab outbox-leader Web Lock on close (see `hydrateAsOutboxLeader`). */
   private outboxLeaderRelease;
   /** Durable read cache (Pillar 2); `undefined` when `queryCache` is omitted or `false`. */
@@ -2096,6 +2149,9 @@ declare class LunoraClient {
   private readonly mutationSettledListeners;
   /** Subscribers to the offline-queue pending-count (see `onPendingChange`). */
   private readonly pendingChangeListeners;
+  private readonly syncStatusListeners;
+  /** The last value `syncStatusListeners` was told, to emit only on a real change. */
+  private lastSyncStatus;
   /**
    * Whisper-topic handlers, keyed by `connectionKey(shardKey)` → topic → set
    * of callbacks. Membership doubles as the resubscribe set replayed on every
@@ -2173,6 +2229,8 @@ declare class LunoraClient {
    * entry per document it ever wrote.
    */
   private readonly replayRetryState;
+  /** Failed replay attempts collected so far, per ambiguous-send write id (see `spendsLastReplayAttempt`); cleared when the write settles. */
+  private readonly replayAttempts;
   /** Pending rate-limit retry flushes, keyed by {@link connectionKey}, so `close()` can cancel them. */
   private readonly replayRetryTimers;
   private readonly shapeSubscriptions;
@@ -2634,6 +2692,29 @@ declare class LunoraClient {
    * unsubscribe function.
    */
   onConnectionStatus(listener: (status: ConnectionStatus) => void): Unsubscribe;
+  /**
+   * Whether the client is caught up: a live connection, every subscription
+   * answered by the server, and no write waiting in the offline queue. Use this
+   * rather than `connectionStatus() === "connected"` for a "synced" indicator —
+   * that reads `"connected"` the moment a socket opens, while subscriptions still
+   * have no data and queued writes are still waiting to go out.
+   *
+   * Over the HTTP polling fallback (judged per shard, so one polling shard does
+   * not wait on an ack while another holds an open socket), and on a cross-tab
+   * follower (neither sees server acknowledgements), a subscription counts as
+   * answered once the current connection has delivered a value for it; a
+   * hydrated cache does not.
+   * A write counts as pending from the moment it is queued until the server
+   * settles it, including while its replay request is on the wire.
+   */
+  syncStatus(): SyncStatus;
+  /**
+   * Subscribe to {@link syncStatus} changes. Invokes `listener` immediately with
+   * the current value, then whenever the connection status, the number of
+   * unanswered subscriptions or the number of unsettled writes (queued, or
+   * being replayed) changes. Returns an unsubscribe function.
+   */
+  onSyncStatus(listener: (status: SyncStatus) => void): Unsubscribe;
   /**
    * Number of offline writes waiting in the built-in queue to be sent — the
    * depth for a "N changes waiting to sync" indicator. Counts writes that are
@@ -2743,7 +2824,9 @@ declare class LunoraClient {
    * (enabled) render of a live query behind hydration, so the user sees
    * cached data instead of an undefined flash before the socket round-trip.
    */
-  whenReady(): Promise<void>;
+  whenReady(options?: {
+    signal?: AbortSignal;
+  }): Promise<void>;
   /**
    * Synchronously reports whether {@link whenReady} has already resolved (the
    * durable read cache is loaded, or none is configured). Framework adapters
@@ -2792,6 +2875,7 @@ declare class LunoraClient {
   };
   query<F extends FunctionReference>(function_: F, args: ArgsOf<F>, options?: {
     shardKey?: string;
+    signal?: AbortSignal;
   }): Promise<ReturnOf<F>>;
   /**
    * Batch several independent calls into ONE round trip (plan 088). Each call is
@@ -2806,6 +2890,12 @@ declare class LunoraClient {
    * No promise pipelining and no capability passing — a call's args cannot
    * reference another call's result (see plan 088 §fence; capabilities are
    * incompatible with DO hibernation).
+   *
+   * The whole exchange, response body included, is bounded by
+   * {@link LunoraClientOptions.rpcTimeoutMs}, rejecting with a retryable
+   * {@link TransportError}. A function's kind is a type-level phantom with no
+   * runtime marker, so unlike {@link action} a batched call cannot be exempted:
+   * call a long-running action through `action()` instead.
    */
   batch(calls: ReadonlyArray<{
     args?: Record<string, unknown>;
@@ -3547,6 +3637,7 @@ declare class LunoraClient {
     onCheckpoint?: (watermark: SyncWatermark) => void;
     onError?: SubscriptionErrorCallback;
     shardKey?: string;
+    signal?: AbortSignal;
   }): Unsubscribe;
   /**
    * Subscribe to a declarative **shape** — server-side partial replication
@@ -3722,7 +3813,7 @@ declare class LunoraClient {
    * stamp elsewhere in this file) — moved verbatim, not reflowed.
    */
   private createTabCoordinator;
-  /** The body of {@link batch}, optionally abortable (the polling fallback's timeout). */
+  /** The body of {@link batch}, abortable by the caller's deadline (`batch`'s own, or the polling fallback's timeout). */
   private sendBatch;
   /**
    * The body of {@link mutation}, also saying whether the write committed. `committed` is
@@ -3893,6 +3984,14 @@ declare class LunoraClient {
   private persistQueryValue;
   /** Drain {@link pendingCacheWrites} to the durable store. */
   private flushQueryCacheWrites;
+  /**
+   * Flush what is buffered for durable storage when the page is hidden or going
+   * away: writes whose append was rejected get another try, and the debounced
+   * read-cache writes (which would otherwise wait out their timer on a page
+   * that never gets to run it) are written out. Browser lifecycle events only —
+   * a runtime without them (SSR, workers, React Native) installs nothing.
+   */
+  private installPageHideFlush;
   /** Derive the aggregate status from the per-shard socket states. */
   private computeStatus;
   /**
@@ -3957,6 +4056,8 @@ declare class LunoraClient {
    * (even a refusal) is the proof. `false` only when `fetch` itself rejects.
    */
   private probeOrigin;
+  /** Recompute {@link syncStatus} and notify its listeners if any field changed. */
+  private emitSyncStatus;
   /** Recompute the aggregate status and notify listeners if it changed. */
   private emitConnectionStatus;
   /**
@@ -4118,7 +4219,11 @@ declare class LunoraClient {
    */
   private cancelStream;
   private handleDisconnect;
-  /** Mark every subscription bound to `shardKey` as needing a fresh ack. */
+  /**
+   * Mark every subscription and shape bound to `shardKey` as needing a fresh answer from the server.
+   * `socketOpened` also forgets the values a poll delivered: the socket replaces that connection,
+   * whereas a socket that merely failed to open (or dropped) leaves polling, and its answers, in place.
+   */
   private markShardPendingAck;
   /**
    * Re-send `state`'s `subscribe` frame, but only once fewer than
@@ -4135,13 +4240,16 @@ declare class LunoraClient {
    * Cannot wedge: a queued subscription whose frame does not actually go out
    * (socket closed, already acked, unsubscribed while queued) takes no slot,
    * every sent frame is released by the first server frame carrying its id
-   * (see {@link handleServerMessage}) or by its own watchdog, and a disconnect
+   * (see {@link handleServerMessage}) or by its watchdog, and a disconnect
    * drops the queue wholesale — the next `open` re-queues every subscription
    * on the shard, because `markShardPendingAck` un-acked them all.
    */
   private drainResubscribeQueue;
-  /** Free the in-flight slot `id` holds on `conn` (if any) and let the next queued subscribe go out. */
-  private releaseResubscribeSlot;
+  /**
+   * Stand down `id`'s watchdog on `conn` — its `subscribe` frame was answered or the socket went
+   * away — and, if it held a pacing slot, free it so the next queued subscribe goes out.
+   */
+  private settleSubscribeWatchdog;
   /**
    * Abandon this connection's paced resubscribe: clear every watchdog and
    * forget both the in-flight and the waiting entries. Called wherever the
@@ -4151,9 +4259,20 @@ declare class LunoraClient {
   private clearResubscribeQueue;
   /** Send `state`'s `subscribe` frame when the shard's socket can carry it; `true` when a frame actually went out. */
   private sendSubscribeIfOpen;
+  /**
+   * Watch `state`'s `subscribe` frame: if no frame bearing its id arrives within
+   * {@link RESUBSCRIBE_ACK_TIMEOUT_MS}, free the pacing slot it holds (if any) and
+   * re-send the frame once. A server that drops the frame without replying (a
+   * shard still waking, a swallowed message) would otherwise leave the
+   * subscription un-acked on a perfectly live socket until the next reconnect.
+   * One retry, not a loop: a query that is merely slow must not be re-run repeatedly.
+   */
+  private armUnackedWatchdog;
   private sendShapeSubscribeIfOpen;
   private handleServerMessage;
   private handleErrorMessage;
+  /** Count a query the server refused as answered, by the evidence {@link syncStatus} asks of it, emitting only on a change. */
+  private markQueryRejected;
   private handlePokeEnd;
   /**
    * Commit one shape's slice of a poke. The decision and the state change live in
@@ -4198,8 +4317,10 @@ declare class LunoraClient {
   /**
    * Mark `state` acked and, when the frame carries a newer cursor/epoch than
    * the cached position, advance the resume watermark and re-persist. Shared by
-   * the `resume` and `settled` frame handlers — both acknowledge "nothing the
-   * client must re-render changed, but the resume position may have moved".
+   * the `ack`, `resume` and `settled` frame handlers — each acknowledges the
+   * subscription ("nothing the client must re-render changed, but the resume
+   * position may have moved"; an `ack` carries no position at all). The sync
+   * status is only recomputed when this is the acknowledgement that changes it.
    */
   private ackAndAdvanceCursor;
   /**
@@ -4701,13 +4822,12 @@ declare class LunoraClient {
    * Consume this shard's retry delay and re-flush it once the delay has
    * elapsed.
    *
-   * Two things record a delay for it to consume: a failure the server or an
-   * edge ANSWERED (see {@link replayRetryDelayMs}) and a flush that HELD every
-   * entry it drained (see {@link LunoraClient.noteHeldRetryDelay}). Both happen
-   * over a socket that stays open, so without this the writes sit queued
-   * indefinitely; a `fetch` that never landed records nothing, because the
-   * reconnect that follows flushes the queue anyway. One pending timer per
-   * shard; a second delay replaces it rather than stacking flushes.
+   * Two things record a delay for it to consume: a transient failure (a server
+   * or edge answer, or a `fetch` that rejected; see {@link replayRetryDelayMs})
+   * and a flush that HELD every entry it drained (see
+   * {@link LunoraClient.noteHeldRetryDelay}). Both happen over a socket that
+   * stays open, so without this the writes sit queued indefinitely. One pending
+   * timer per shard; a second delay replaces it rather than stacking flushes.
    *
    * Nothing left to retry on this key (drained, closed, or no delay) drops its
    * backoff state, which is both the reset after progress and what bounds the
@@ -4839,6 +4959,22 @@ declare class LunoraClient {
    * rejected with the decode error and the settled event carries it.
    */
   private settleReplayUndecodable;
+  /**
+   * Count a failed replay attempt against `item` and report whether it was the
+   * last attempt the write gets.
+   *
+   * Only a write queued after an ambiguous direct send is capped: its caller is
+   * still waiting, so every transient failure of it except a rate limit or a
+   * refused credential (a transport error, a timeout, `SHARD_UNAVAILABLE`, ...)
+   * counts against {@link MAX_AMBIGUOUS_SEND_ATTEMPTS}. Any other write is never
+   * capped here: a write the shard fails deterministically arrives with a coded
+   * verdict (the handler's own code, `RPC_FAILED`, `BATCH_ENTRY_FAILED`) that
+   * {@link isTransientReplayFailure} settles terminally on the first attempt, and
+   * a transient failure says nothing about the write itself.
+   */
+  private spendsLastReplayAttempt;
+  /** Settle, terminally, the ambiguous-send writes among `items` that `error` was the last attempt for; the rest stay queued. */
+  private keepUnexhaustedAmbiguousWrites;
   /** Settle a write the server reached a coded verdict on: replaying would re-trigger the same failure (a poison-message loop), so drop it. */
   private settleReplayTerminal;
   /**
@@ -4913,4 +5049,4 @@ declare class LunoraClient {
    */
   private settleReplayBatchSlots;
 }
-export { SchedulerStatus as $, ActionCallOptions as A, BookmarkStorage as B, ConnectionStatus as C, DEFAULT_MAX_BUFFER as D, OutboxMutation as E, FunctionArgumentDescriptor as F, GlobalFacetResult as G, HttpStreamRef as H, OutboxSink as I, PersistedMutation as J, ReplayCredential as K, LunoraClient as L, MutationCallOptions as M, ReplayIdentityVerdict as N, OfflineQueueOptions as O, Preloaded as P, QueryCacheAdapter as Q, ReconnectOptions as R, SubscriptionError as S, RoomRef as T, User as U, RowOp as V, RpcEnvelope as W, RpcResponseBody as X, ScheduleRecord as Y, ScheduleRetryPolicy 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, StoredQuery as a8, StreamHandle as a9, SubscriptionCallback as aa, SubscriptionRegistry as ab, SubscriptionState as ac, SyncWatermark as ad, WorkflowInstanceAction as ae, WorkflowInstanceDetail as af, WorkflowInstancePage as ag, WorkflowInstanceStatus as ah, WorkflowInstanceSummary as ai, WorkflowStepDetail as aj, WsTokenProvider as ak, createClientQuery as al, createLocalStore as am, createStream as an, SubscriptionErrorCallback as b, PersistenceAdapter as c, HttpStreamArgsOf as d, HttpStreamChunkOf as e, StreamIterable as f, BatchSlot as g, CachedQuery as h, ClientDebugShard as i, ClientDebugSnapshot as j, ClientDebugSubscription as k, ClientMessage as l, ClientQueryRef as m, ClientShapeSubscribeMessage as n, ClientShapeUnsubscribeMessage 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, MutationSettledEvent as x, OptimisticLocalStore as y, OptimisticUpdate as z };
+export { SchedulerStatus as $, ActionCallOptions as A, BookmarkStorage as B, ConnectionStatus as C, DEFAULT_MAX_BUFFER as D, OutboxMutation as E, FunctionArgumentDescriptor as F, GlobalFacetResult as G, HttpStreamRef as H, OutboxSink as I, PersistedMutation as J, ReplayCredential as K, LunoraClient as L, MutationCallOptions as M, ReplayIdentityVerdict as N, OfflineQueueOptions as O, Preloaded as P, QueryCacheAdapter as Q, ReconnectOptions as R, SubscriptionError as S, RoomRef as T, User as U, RowOp as V, RpcEnvelope as W, RpcResponseBody as X, ScheduleRecord as Y, ScheduleRetryPolicy 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, StoredQuery as a8, StreamHandle as a9, SubscriptionCallback as aa, SubscriptionRegistry as ab, SubscriptionState as ac, SyncStatus as ad, SyncWatermark as ae, WorkflowInstanceAction as af, WorkflowInstanceDetail as ag, WorkflowInstancePage as ah, WorkflowInstanceStatus as ai, WorkflowInstanceSummary as aj, WorkflowStepDetail as ak, WsTokenProvider as al, createClientQuery as am, createLocalStore as an, createStream as ao, SubscriptionErrorCallback as b, PersistenceAdapter as c, HttpStreamArgsOf as d, HttpStreamChunkOf as e, StreamIterable as f, BatchSlot as g, CachedQuery as h, ClientDebugShard as i, ClientDebugSnapshot as j, ClientDebugSubscription as k, ClientMessage as l, ClientQueryRef as m, ClientShapeSubscribeMessage as n, ClientShapeUnsubscribeMessage 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, MutationSettledEvent as x, OptimisticLocalStore as y, OptimisticUpdate as z };