@lunora/client 1.0.0-alpha.232 → 1.0.0-alpha.234

package/dist/auth/index.d.mts

@@ -1,4 +1,4 @@
-import { U as User, L as LunoraClient } from "../packem_shared/lunora-client.d-dOEEoF4x.mjs";
+import { U as User, L as LunoraClient } from "../packem_shared/lunora-client.d-DZ9gzk9p.mjs";
 import '@lunora/errors';
 import "../packem_shared/function-reference.d-Br_hsKje.mjs";
 import '@lunora/runtime';

package/dist/auth/index.d.ts

@@ -1,4 +1,4 @@
-import { U as User, L as LunoraClient } from "../packem_shared/lunora-client.d-DpmxnYmL.js";
+import { U as User, L as LunoraClient } from "../packem_shared/lunora-client.d-CZ9TlyaL.js";
 import '@lunora/errors';
 import "../packem_shared/function-reference.d-Br_hsKje.js";
 import '@lunora/runtime';

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-import { R as ReconnectOptions, c as PersistenceAdapter, Q as QueryCacheAdapter, B as BookmarkStorage, C as ConnectionStatus, S as SubscriptionError, H as HttpStreamRef, d as HttpStreamArgsOf, e as HttpStreamChunkOf, f as StreamIterable, O as OfflineQueueOptions, L as LunoraClient } from "./packem_shared/lunora-client.d-dOEEoF4x.mjs";
-export { type A as ActionCallOptions, type g as BatchSlot, type h as CachedQuery, type i as ClientDebugShard, type j as ClientDebugSnapshot, type k as ClientDebugSubscription, type l as ClientMessage, type m as ClientQueryRef, type n as ClientShapeSubscribeMessage, type o as ClientShapeUnsubscribeMessage, D as DEFAULT_MAX_BUFFER, type F as FunctionArgumentDescriptor, type p as FunctionDescriptor, type G as GlobalFacetResult, type q as GlobalFacetValue, type r as GlobalFilterClause, type s as GlobalTableInfo, type t as GlobalTablePage, type u as HttpStreamCallArgs, type v as LunoraClientError, type w as LunoraClientOptions, type M as MutationCallOptions, type x as MutationSettledEvent, type y as OptimisticLocalStore, type z as OptimisticUpdate, type E as OutboxMutation, type I as OutboxSink, type J as PersistedMutation, type P as Preloaded, type K as ReplayCredential, type N as ReplayIdentityVerdict, type T as RoomRef, type V as RowOp, type W as RpcEnvelope, type X as RpcResponseBody, type Y as ScheduleRecord, type Z as ScheduleRetryPolicy, type _ as SchedulerPoolStatus, type $ as SchedulerStatus, type a0 as ServerMessage, type a1 as ServerPokeEndMessage, type a2 as ServerPokePartMessage, type a3 as ServerPokeStartMessage, type a4 as ShardTrafficEntry, type a5 as ShardTrafficResult, type a6 as StorageListPage, type a7 as StorageObject, type a8 as StoredQuery, type a9 as StreamHandle, type aa as SubscriptionCallback, type b as SubscriptionErrorCallback, ab as SubscriptionRegistry, type ac as SubscriptionState, type ad as SyncWatermark, type a as Unsubscribe, type U as User, type ae as WorkflowInstanceAction, type af as WorkflowInstanceDetail, type ag as WorkflowInstancePage, type ah as WorkflowInstanceStatus, type ai as WorkflowInstanceSummary, type aj as WorkflowStepDetail, type ak as WsTokenProvider, al as createClientQuery, am as createLocalStore, an as createStream } from "./packem_shared/lunora-client.d-dOEEoF4x.mjs";
+import { R as ReconnectOptions, c as PersistenceAdapter, Q as QueryCacheAdapter, B as BookmarkStorage, C as ConnectionStatus, S as SubscriptionError, H as HttpStreamRef, d as HttpStreamArgsOf, e as HttpStreamChunkOf, f as StreamIterable, O as OfflineQueueOptions, L as LunoraClient } from "./packem_shared/lunora-client.d-DZ9gzk9p.mjs";
+export { type A as ActionCallOptions, type g as BatchSlot, type h as CachedQuery, type i as ClientDebugShard, type j as ClientDebugSnapshot, type k as ClientDebugSubscription, type l as ClientMessage, type m as ClientQueryRef, type n as ClientShapeSubscribeMessage, type o as ClientShapeUnsubscribeMessage, D as DEFAULT_MAX_BUFFER, type F as FunctionArgumentDescriptor, type p as FunctionDescriptor, type G as GlobalFacetResult, type q as GlobalFacetValue, type r as GlobalFilterClause, type s as GlobalTableInfo, type t as GlobalTablePage, type u as HttpStreamCallArgs, type v as LunoraClientError, type w as LunoraClientOptions, type M as MutationCallOptions, type x as MutationSettledEvent, type y as OnlineOnlyOption, type z as OptimisticLocalStore, type E as OptimisticUpdate, type I as OutboxMutation, type J as OutboxSink, type K as PersistedMutation, type P as Preloaded, type N as ReplayCredential, type T as ReplayIdentityVerdict, type V as RoomRef, type W as RowOp, type X as RpcEnvelope, type Y as RpcResponseBody, type Z as ScheduleRecord, type _ as ScheduleRetryPolicy, type $ as SchedulerPoolStatus, type a0 as SchedulerStatus, type a1 as ServerMessage, type a2 as ServerPokeEndMessage, type a3 as ServerPokePartMessage, type a4 as ServerPokeStartMessage, type a5 as ShardTrafficEntry, type a6 as ShardTrafficResult, type a7 as StorageListPage, type a8 as StorageObject, type a9 as StoredQuery, type aa as StreamHandle, type ab as SubscriptionCallback, type b as SubscriptionErrorCallback, ac as SubscriptionRegistry, type ad as SubscriptionState, type ae as SyncStatus, type af as SyncWatermark, type a as Unsubscribe, type U as User, type ag as WorkflowInstanceAction, type ah as WorkflowInstanceDetail, type ai as WorkflowInstancePage, type aj as WorkflowInstanceStatus, type ak as WorkflowInstanceSummary, type al as WorkflowStepDetail, type am as WsTokenProvider, an as createClientQuery, ao as createLocalStore, ap as createStream } from "./packem_shared/lunora-client.d-DZ9gzk9p.mjs";
 import { LunoraError, LunoraErrorCode } from '@lunora/errors';
 export type { LunoraErrorCode } from '@lunora/errors';
-export { p as preloadQuery, a as preloadedQueryResult } from "./packem_shared/preload.d-XVLTUaah.mjs";
+export { p as preloadQuery, a as preloadedQueryResult } from "./packem_shared/preload.d-BOpEnFP8.mjs";
 import { F as FunctionReference } from "./packem_shared/function-reference.d-Br_hsKje.mjs";
 export type { A as ArgsOf, R as ReturnOf } from "./packem_shared/function-reference.d-Br_hsKje.mjs";
 export type { AuthCapabilities, AuthConfigInfo, AuthImpersonation, AuthPage, AuthSession, AuthUser, AuthUserFieldSpec, CronJobInfo, KvKeyEntry, KvKeyListResult, KvNamespaceSummary, KvValueResult, PipelineLogColumnMap, PipelineLogCursor, PipelineLogField, PipelineLogPage, PipelineLogQuery, PipelineLogRow, VectorIndexSummary, VectorQueryMatch } from '@lunora/runtime';
@@ -395,6 +395,13 @@ declare class TabCoordinator {
   private promotionPending;
   /** Timestamp of the most recent leader heartbeat. */
   private lastHeartbeat;
+  /**
+   * Snapshots waiting for the end of the current tick, latest per key. A
+   * `subscription-data` frame is a full snapshot, so a burst for one key within
+   * a tick only needs its last frame posted — each post structured-clones the
+   * whole value for every tab on the channel.
+   */
+  private readonly pendingData;
   private heartbeatTimer;
   private leaderCheckTimer;
   /** Callbacks set via constructor options. */
@@ -488,6 +495,8 @@ declare class TabCoordinator {
    */
   broadcastConnectionStatus(status: ConnectionStatus, identity?: string | null): void;
   private broadcast;
+  /** Post the snapshots queued this tick — unless leadership was lost meanwhile, when the new leader's own snapshots supersede them. */
+  private flushPendingData;
   private handleMessage;
   private handleClaimLeadership;
   private handleHeartbeat;
@@ -565,6 +574,15 @@ interface HttpStreamOptions {
   fetch?: typeof fetch;
   /** Extra request headers (e.g. `authorization`). `accept: text/event-stream` is always sent. */
   headers?: Record<string, string>;
+  /**
+   * Treat a connection that delivers nothing — no chunk, no keepalive comment —
+   * for this many milliseconds as dead: it is cancelled, then reconnected with
+   * {@link HttpStreamOptions.reconnect} or failed with `STREAM_IDLE`. Off by
+   * default, because a route may be silent for as long as its handler works
+   * (a model thinking); set it to a few multiples of the route's keepalive
+   * interval when the route sends one.
+   */
+  idleTimeoutMs?: number;
   /**
    * Seed the first request's `Last-Event-ID` header, resuming a stream from a
    * position a previous consumer persisted. Once frames arrive this is
@@ -611,6 +629,14 @@ interface ConnectLiveStreamOptions {
   fetch?: typeof fetch;
   /** Extra headers sent on both the stream and the control requests. */
   headers?: Record<string, string>;
+  /**
+   * Treat a connection that delivers nothing — not even a keepalive — for this many milliseconds as
+   * dead, and reconnect. Every target that serves live streams (Cloudflare Workers, the Node host
+   * and celld) runs the same `ShardDO` live handlers, and they write a `:ka` comment every 25s
+   * while a stream is open, so the default is `75000`. Set `0` to disable the bound when a proxy
+   * or a server of your own in front of the shard does not forward comment frames.
+   */
+  idleTimeoutMs?: number;
   /** Ceiling for the reconnect backoff, in ms. Defaults to `30000`. */
   maxDelayMs?: number;
   /** Base reconnect delay in ms. Defaults to `1000`. */
@@ -775,6 +801,13 @@ declare const createMutatorRunner: <TArgs>(handle: MutatorHandle<TArgs>, sinks:
   reset: () => void;
 };
 interface QueuedMutation<T = unknown> {
+  /**
+   * Set on a write that was queued because its direct send failed in a way that
+   * says nothing about its fate (see `LunoraClient.mutation`). Its caller is still
+   * waiting and was never told it failed, so the replay counts its transient
+   * failures and rejects it after a few, rather than retrying for ever.
+   */
+  readonly ambiguousSend?: boolean;
   readonly args: Record<string, unknown>;
   /**
    * CDC cursor this write was composed against (see
@@ -803,6 +836,13 @@ interface QueuedMutation<T = unknown> {
    * a reload and a requeue.
    */
   identity?: string | null;
+  /**
+   * Position in the order this session ISSUED its writes, taken before the first send. A write whose
+   * direct send failed ambiguously is queued only once that send gives up, behind writes issued (and
+   * queued) while it was in flight; this puts it back ahead of them. Absent on hydrated records,
+   * which are older than anything issued this session.
+   */
+  readonly issueSeq?: number;
   /**
    * `true` when a live caller is still awaiting this write's `mutation()`
    * Promise; `false`/absent for a write restored from durable storage after a
@@ -852,6 +892,8 @@ type EvictHandler = (entry: QueuedMutation, error: Error & {
 interface OfflineQueueDeps {
   /** Invoked when an entry is discarded on capacity overflow (carries `OFFLINE_QUEUE_OVERFLOW`). */
   onEvict?: EvictHandler;
+  /** Invoked when a write that was out for replay settles, which `onSizeChange` does not cover: the queue was already shorter. */
+  onReplayingChange?: () => void;
   /** Invoked with the new depth after any size change (drives the client's pending-sync count). */
   onSizeChange?: (size: number) => void;
   /** Durable store; when present, writes are mirrored and restored across reloads. */
@@ -879,12 +921,44 @@ declare class OfflineQueue {
   private readonly persistence;
   private readonly onEvict;
   private readonly onSizeChange;
+  private readonly onReplayingChange;
   /** App/schema version stamped on persisted writes; mismatched records are purged on hydrate. */
   private readonly version;
   private readonly items;
+  /** Ids of writes a flush has {@link OfflineQueue.drain}ed and neither requeued nor discarded yet, which are on the wire or about to be. */
+  private readonly replayingIds;
+  /** Appends still in flight, by write id, each resolving to whether the record landed. Anything that touches a record durably waits on its append first. */
+  private readonly appending;
+  /**
+   * Writes enqueued this session and not yet settled (see {@link OfflineQueue.discard}). Unlike `items`
+   * this survives a replay temporarily draining the queue, so a failed append is tracked for as long as
+   * the write is unsettled, and a retry derives its record from the entry as it is NOW.
+   */
+  private readonly unsettled;
+  /** Ids whose append was rejected (a quota error, a closed connection), kept to be tried again — see {@link OfflineQueue.flushUnpersisted}. */
+  private readonly unpersisted;
   constructor(options?: OfflineQueueOptions, deps?: OfflineQueueDeps);
   get size(): number;
+  /** Writes drained for replay and not yet settled or requeued: out of {@link OfflineQueue.size}, but still unsettled. */
+  get replaying(): number;
   enqueue<T>(entry: QueuedMutation<T>): void;
+  /**
+   * Remove a settled write's durable record — after its append, if that is
+   * still in flight. A write that replays quickly can settle before its append
+   * has landed; a `remove` that overtook it found nothing, and the record then
+   * landed behind it and replayed in the next session.
+   */
+  discard(id: string): void;
+  /**
+   * Try again to persist every write whose append was rejected. Called when the
+   * page is being hidden: the last chance to get a still-queued write into
+   * durable storage before a reload or a discard of the tab loses it.
+   *
+   * A write whose append is still in flight is skipped: `visibilitychange` and `pagehide` fire
+   * back to back, and a second append for the same id would hit a unique-id constraint (or store
+   * the record twice) and leave the write wrongly tracked as unpersisted.
+   */
+  flushUnpersisted(): void;
   /**
    * Restore mutations persisted in a prior session and re-queue them in FIFO
    * order. Restored entries already live in durable storage, so they are not
@@ -956,6 +1030,10 @@ declare class OfflineQueue {
    */
   drainConflict(): QueuedMutation[];
   clear(): void;
+  /** The durable form of a queued write. */
+  private recordOf;
+  /** Append `record`, remembering it as unpersisted if the append is rejected. */
+  private persist;
   /**
    * The durable half of {@link OfflineQueue.restampIdentity}: rewrite the
    * persisted record under the new identity stamp.
@@ -986,6 +1064,7 @@ declare class OfflineQueue {
    * always drops the same way regardless of which caller triggered it.
    */
   private evictOverflow;
+  private markReplaying;
   /** Notify the size observer (the client's pending-sync count) after any change. */
   private notifySize;
 }

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { R as ReconnectOptions, c as PersistenceAdapter, Q as QueryCacheAdapter, B as BookmarkStorage, C as ConnectionStatus, S as SubscriptionError, H as HttpStreamRef, d as HttpStreamArgsOf, e as HttpStreamChunkOf, f as StreamIterable, O as OfflineQueueOptions, L as LunoraClient } from "./packem_shared/lunora-client.d-DpmxnYmL.js";
-export { type A as ActionCallOptions, type g as BatchSlot, type h as CachedQuery, type i as ClientDebugShard, type j as ClientDebugSnapshot, type k as ClientDebugSubscription, type l as ClientMessage, type m as ClientQueryRef, type n as ClientShapeSubscribeMessage, type o as ClientShapeUnsubscribeMessage, D as DEFAULT_MAX_BUFFER, type F as FunctionArgumentDescriptor, type p as FunctionDescriptor, type G as GlobalFacetResult, type q as GlobalFacetValue, type r as GlobalFilterClause, type s as GlobalTableInfo, type t as GlobalTablePage, type u as HttpStreamCallArgs, type v as LunoraClientError, type w as LunoraClientOptions, type M as MutationCallOptions, type x as MutationSettledEvent, type y as OptimisticLocalStore, type z as OptimisticUpdate, type E as OutboxMutation, type I as OutboxSink, type J as PersistedMutation, type P as Preloaded, type K as ReplayCredential, type N as ReplayIdentityVerdict, type T as RoomRef, type V as RowOp, type W as RpcEnvelope, type X as RpcResponseBody, type Y as ScheduleRecord, type Z as ScheduleRetryPolicy, type _ as SchedulerPoolStatus, type $ as SchedulerStatus, type a0 as ServerMessage, type a1 as ServerPokeEndMessage, type a2 as ServerPokePartMessage, type a3 as ServerPokeStartMessage, type a4 as ShardTrafficEntry, type a5 as ShardTrafficResult, type a6 as StorageListPage, type a7 as StorageObject, type a8 as StoredQuery, type a9 as StreamHandle, type aa as SubscriptionCallback, type b as SubscriptionErrorCallback, ab as SubscriptionRegistry, type ac as SubscriptionState, type ad as SyncWatermark, type a as Unsubscribe, type U as User, type ae as WorkflowInstanceAction, type af as WorkflowInstanceDetail, type ag as WorkflowInstancePage, type ah as WorkflowInstanceStatus, type ai as WorkflowInstanceSummary, type aj as WorkflowStepDetail, type ak as WsTokenProvider, al as createClientQuery, am as createLocalStore, an as createStream } from "./packem_shared/lunora-client.d-DpmxnYmL.js";
+import { R as ReconnectOptions, c as PersistenceAdapter, Q as QueryCacheAdapter, B as BookmarkStorage, C as ConnectionStatus, S as SubscriptionError, H as HttpStreamRef, d as HttpStreamArgsOf, e as HttpStreamChunkOf, f as StreamIterable, O as OfflineQueueOptions, L as LunoraClient } from "./packem_shared/lunora-client.d-CZ9TlyaL.js";
+export { type A as ActionCallOptions, type g as BatchSlot, type h as CachedQuery, type i as ClientDebugShard, type j as ClientDebugSnapshot, type k as ClientDebugSubscription, type l as ClientMessage, type m as ClientQueryRef, type n as ClientShapeSubscribeMessage, type o as ClientShapeUnsubscribeMessage, D as DEFAULT_MAX_BUFFER, type F as FunctionArgumentDescriptor, type p as FunctionDescriptor, type G as GlobalFacetResult, type q as GlobalFacetValue, type r as GlobalFilterClause, type s as GlobalTableInfo, type t as GlobalTablePage, type u as HttpStreamCallArgs, type v as LunoraClientError, type w as LunoraClientOptions, type M as MutationCallOptions, type x as MutationSettledEvent, type y as OnlineOnlyOption, type z as OptimisticLocalStore, type E as OptimisticUpdate, type I as OutboxMutation, type J as OutboxSink, type K as PersistedMutation, type P as Preloaded, type N as ReplayCredential, type T as ReplayIdentityVerdict, type V as RoomRef, type W as RowOp, type X as RpcEnvelope, type Y as RpcResponseBody, type Z as ScheduleRecord, type _ as ScheduleRetryPolicy, type $ as SchedulerPoolStatus, type a0 as SchedulerStatus, type a1 as ServerMessage, type a2 as ServerPokeEndMessage, type a3 as ServerPokePartMessage, type a4 as ServerPokeStartMessage, type a5 as ShardTrafficEntry, type a6 as ShardTrafficResult, type a7 as StorageListPage, type a8 as StorageObject, type a9 as StoredQuery, type aa as StreamHandle, type ab as SubscriptionCallback, type b as SubscriptionErrorCallback, ac as SubscriptionRegistry, type ad as SubscriptionState, type ae as SyncStatus, type af as SyncWatermark, type a as Unsubscribe, type U as User, type ag as WorkflowInstanceAction, type ah as WorkflowInstanceDetail, type ai as WorkflowInstancePage, type aj as WorkflowInstanceStatus, type ak as WorkflowInstanceSummary, type al as WorkflowStepDetail, type am as WsTokenProvider, an as createClientQuery, ao as createLocalStore, ap as createStream } from "./packem_shared/lunora-client.d-CZ9TlyaL.js";
 import { LunoraError, LunoraErrorCode } from '@lunora/errors';
 export type { LunoraErrorCode } from '@lunora/errors';
-export { p as preloadQuery, a as preloadedQueryResult } from "./packem_shared/preload.d-BkXsKMmU.js";
+export { p as preloadQuery, a as preloadedQueryResult } from "./packem_shared/preload.d-CXUIU6pE.js";
 import { F as FunctionReference } from "./packem_shared/function-reference.d-Br_hsKje.js";
 export type { A as ArgsOf, R as ReturnOf } from "./packem_shared/function-reference.d-Br_hsKje.js";
 export type { AuthCapabilities, AuthConfigInfo, AuthImpersonation, AuthPage, AuthSession, AuthUser, AuthUserFieldSpec, CronJobInfo, KvKeyEntry, KvKeyListResult, KvNamespaceSummary, KvValueResult, PipelineLogColumnMap, PipelineLogCursor, PipelineLogField, PipelineLogPage, PipelineLogQuery, PipelineLogRow, VectorIndexSummary, VectorQueryMatch } from '@lunora/runtime';
@@ -395,6 +395,13 @@ declare class TabCoordinator {
   private promotionPending;
   /** Timestamp of the most recent leader heartbeat. */
   private lastHeartbeat;
+  /**
+   * Snapshots waiting for the end of the current tick, latest per key. A
+   * `subscription-data` frame is a full snapshot, so a burst for one key within
+   * a tick only needs its last frame posted — each post structured-clones the
+   * whole value for every tab on the channel.
+   */
+  private readonly pendingData;
   private heartbeatTimer;
   private leaderCheckTimer;
   /** Callbacks set via constructor options. */
@@ -488,6 +495,8 @@ declare class TabCoordinator {
    */
   broadcastConnectionStatus(status: ConnectionStatus, identity?: string | null): void;
   private broadcast;
+  /** Post the snapshots queued this tick — unless leadership was lost meanwhile, when the new leader's own snapshots supersede them. */
+  private flushPendingData;
   private handleMessage;
   private handleClaimLeadership;
   private handleHeartbeat;
@@ -565,6 +574,15 @@ interface HttpStreamOptions {
   fetch?: typeof fetch;
   /** Extra request headers (e.g. `authorization`). `accept: text/event-stream` is always sent. */
   headers?: Record<string, string>;
+  /**
+   * Treat a connection that delivers nothing — no chunk, no keepalive comment —
+   * for this many milliseconds as dead: it is cancelled, then reconnected with
+   * {@link HttpStreamOptions.reconnect} or failed with `STREAM_IDLE`. Off by
+   * default, because a route may be silent for as long as its handler works
+   * (a model thinking); set it to a few multiples of the route's keepalive
+   * interval when the route sends one.
+   */
+  idleTimeoutMs?: number;
   /**
    * Seed the first request's `Last-Event-ID` header, resuming a stream from a
    * position a previous consumer persisted. Once frames arrive this is
@@ -611,6 +629,14 @@ interface ConnectLiveStreamOptions {
   fetch?: typeof fetch;
   /** Extra headers sent on both the stream and the control requests. */
   headers?: Record<string, string>;
+  /**
+   * Treat a connection that delivers nothing — not even a keepalive — for this many milliseconds as
+   * dead, and reconnect. Every target that serves live streams (Cloudflare Workers, the Node host
+   * and celld) runs the same `ShardDO` live handlers, and they write a `:ka` comment every 25s
+   * while a stream is open, so the default is `75000`. Set `0` to disable the bound when a proxy
+   * or a server of your own in front of the shard does not forward comment frames.
+   */
+  idleTimeoutMs?: number;
   /** Ceiling for the reconnect backoff, in ms. Defaults to `30000`. */
   maxDelayMs?: number;
   /** Base reconnect delay in ms. Defaults to `1000`. */
@@ -775,6 +801,13 @@ declare const createMutatorRunner: <TArgs>(handle: MutatorHandle<TArgs>, sinks:
   reset: () => void;
 };
 interface QueuedMutation<T = unknown> {
+  /**
+   * Set on a write that was queued because its direct send failed in a way that
+   * says nothing about its fate (see `LunoraClient.mutation`). Its caller is still
+   * waiting and was never told it failed, so the replay counts its transient
+   * failures and rejects it after a few, rather than retrying for ever.
+   */
+  readonly ambiguousSend?: boolean;
   readonly args: Record<string, unknown>;
   /**
    * CDC cursor this write was composed against (see
@@ -803,6 +836,13 @@ interface QueuedMutation<T = unknown> {
    * a reload and a requeue.
    */
   identity?: string | null;
+  /**
+   * Position in the order this session ISSUED its writes, taken before the first send. A write whose
+   * direct send failed ambiguously is queued only once that send gives up, behind writes issued (and
+   * queued) while it was in flight; this puts it back ahead of them. Absent on hydrated records,
+   * which are older than anything issued this session.
+   */
+  readonly issueSeq?: number;
   /**
    * `true` when a live caller is still awaiting this write's `mutation()`
    * Promise; `false`/absent for a write restored from durable storage after a
@@ -852,6 +892,8 @@ type EvictHandler = (entry: QueuedMutation, error: Error & {
 interface OfflineQueueDeps {
   /** Invoked when an entry is discarded on capacity overflow (carries `OFFLINE_QUEUE_OVERFLOW`). */
   onEvict?: EvictHandler;
+  /** Invoked when a write that was out for replay settles, which `onSizeChange` does not cover: the queue was already shorter. */
+  onReplayingChange?: () => void;
   /** Invoked with the new depth after any size change (drives the client's pending-sync count). */
   onSizeChange?: (size: number) => void;
   /** Durable store; when present, writes are mirrored and restored across reloads. */
@@ -879,12 +921,44 @@ declare class OfflineQueue {
   private readonly persistence;
   private readonly onEvict;
   private readonly onSizeChange;
+  private readonly onReplayingChange;
   /** App/schema version stamped on persisted writes; mismatched records are purged on hydrate. */
   private readonly version;
   private readonly items;
+  /** Ids of writes a flush has {@link OfflineQueue.drain}ed and neither requeued nor discarded yet, which are on the wire or about to be. */
+  private readonly replayingIds;
+  /** Appends still in flight, by write id, each resolving to whether the record landed. Anything that touches a record durably waits on its append first. */
+  private readonly appending;
+  /**
+   * Writes enqueued this session and not yet settled (see {@link OfflineQueue.discard}). Unlike `items`
+   * this survives a replay temporarily draining the queue, so a failed append is tracked for as long as
+   * the write is unsettled, and a retry derives its record from the entry as it is NOW.
+   */
+  private readonly unsettled;
+  /** Ids whose append was rejected (a quota error, a closed connection), kept to be tried again — see {@link OfflineQueue.flushUnpersisted}. */
+  private readonly unpersisted;
   constructor(options?: OfflineQueueOptions, deps?: OfflineQueueDeps);
   get size(): number;
+  /** Writes drained for replay and not yet settled or requeued: out of {@link OfflineQueue.size}, but still unsettled. */
+  get replaying(): number;
   enqueue<T>(entry: QueuedMutation<T>): void;
+  /**
+   * Remove a settled write's durable record — after its append, if that is
+   * still in flight. A write that replays quickly can settle before its append
+   * has landed; a `remove` that overtook it found nothing, and the record then
+   * landed behind it and replayed in the next session.
+   */
+  discard(id: string): void;
+  /**
+   * Try again to persist every write whose append was rejected. Called when the
+   * page is being hidden: the last chance to get a still-queued write into
+   * durable storage before a reload or a discard of the tab loses it.
+   *
+   * A write whose append is still in flight is skipped: `visibilitychange` and `pagehide` fire
+   * back to back, and a second append for the same id would hit a unique-id constraint (or store
+   * the record twice) and leave the write wrongly tracked as unpersisted.
+   */
+  flushUnpersisted(): void;
   /**
    * Restore mutations persisted in a prior session and re-queue them in FIFO
    * order. Restored entries already live in durable storage, so they are not
@@ -956,6 +1030,10 @@ declare class OfflineQueue {
    */
   drainConflict(): QueuedMutation[];
   clear(): void;
+  /** The durable form of a queued write. */
+  private recordOf;
+  /** Append `record`, remembering it as unpersisted if the append is rejected. */
+  private persist;
   /**
    * The durable half of {@link OfflineQueue.restampIdentity}: rewrite the
    * persisted record under the new identity stamp.
@@ -986,6 +1064,7 @@ declare class OfflineQueue {
    * always drops the same way regardless of which caller triggered it.
    */
   private evictOverflow;
+  private markReplaying;
   /** Notify the size observer (the client's pending-sync count) after any change. */
   private notifySize;
 }

package/dist/index.mjs

@@ -1 +1 @@
-import{RETIRE_AFTER_DURABLE_SEQ_ADVANCE as o,maxSeq as t,reconcileOptimistic as a}from"./packem_shared/RETIRE_AFTER_DURABLE_SEQ_ADVANCE-DoEHtuR8.mjs";import{createAsyncStoragePersistence as i}from"./packem_shared/createAsyncStoragePersistence-6FCvqc6C.mjs";import{createAsyncStorageQueryCache as n}from"./packem_shared/createAsyncStorageQueryCache-f5023fdB.mjs";import{default as s}from"./packem_shared/createInMemoryBookmarkStorage-BooZhW0n.mjs";import{createCallRunner as x}from"./packem_shared/createCallRunner-Bwcrfh76.mjs";import{createClientQuery as l}from"./packem_shared/createClientQuery-B8Nfj-7o.mjs";import{TabCoordinator as d}from"./packem_shared/TabCoordinator-CXD7vulJ.mjs";import{a as R,i as C}from"./packem_shared/delta-merge-Ls3DED4g.mjs";import{CONFLICT_ERROR_CODE as A,TransportError as b,getErrorCode as h,getRetryAfterMs as D,isAuthReplayFailure as L,isConflictError as Q,isForbiddenError as T,isRateLimitedError as _,isUnauthorizedError as F}from"./packem_shared/CONFLICT_ERROR_CODE-B7qNZMMk.mjs";import{httpStream as M}from"./packem_shared/httpStream-DaqP70Ne.mjs";import{c as O}from"./packem_shared/live-stream-ct8j7T75.mjs";import{liveTopicSubscription as U,subscribeLiveTopic as v}from"./packem_shared/liveTopicSubscription-Bs-ULKfs.mjs";import{c as k}from"./packem_shared/local-store-fqWV2n_Z.mjs";import{LunoraClient as N}from"./packem_shared/LunoraClient-D6MyuSWy.mjs";import{createMutatorRunner as K}from"./packem_shared/createMutatorRunner-CuMRJpUx.mjs";import{O as X}from"./packem_shared/offline-queue-D_fr-uQ3.mjs";import{createInMemoryPersistence as w,createIndexedDbPersistence as G}from"./packem_shared/createInMemoryPersistence-Cz2W6XVj.mjs";import{preloadQuery as J,preloadedQueryResult as W}from"./packem_shared/preloadQuery-uFy24PCR.mjs";import{createInMemoryQueryCache as Z,createIndexedDbQueryCache as $,queryCacheKey as ee}from"./packem_shared/createInMemoryQueryCache-D2uNHLfM.mjs";import{createReconnect as oe}from"./packem_shared/createReconnect-CjTmjJDH.mjs";import{default as ae}from"./packem_shared/createSnapshotPrecondition-CLkxVeN1.mjs";import{DEFAULT_MAX_BUFFER as ie,createStream as pe}from"./packem_shared/DEFAULT_MAX_BUFFER-Bd-_iyiV.mjs";import{SubscriptionRegistry as me}from"./packem_shared/SubscriptionRegistry-DKIXE7M7.mjs";export{A as CONFLICT_ERROR_CODE,ie as DEFAULT_MAX_BUFFER,N as LunoraClient,X as OfflineQueue,o as RETIRE_AFTER_DURABLE_SEQ_ADVANCE,me as SubscriptionRegistry,d as TabCoordinator,b as TransportError,R as applyDelta,O as connectLiveStream,i as createAsyncStoragePersistence,n as createAsyncStorageQueryCache,x as createCallRunner,l as createClientQuery,s as createInMemoryBookmarkStorage,w as createInMemoryPersistence,Z as createInMemoryQueryCache,G as createIndexedDbPersistence,$ as createIndexedDbQueryCache,k as createLocalStore,K as createMutatorRunner,oe as createReconnect,ae as createSnapshotPrecondition,pe as createStream,h as getErrorCode,D as getRetryAfterMs,M as httpStream,L as isAuthReplayFailure,Q as isConflictError,T as isForbiddenError,C as isMutationDelta,_ as isRateLimitedError,F as isUnauthorizedError,U as liveTopicSubscription,t as maxSeq,J as preloadQuery,W as preloadedQueryResult,ee as queryCacheKey,a as reconcileOptimistic,v as subscribeLiveTopic};
+import{RETIRE_AFTER_DURABLE_SEQ_ADVANCE as o,maxSeq as t,reconcileOptimistic as a}from"./packem_shared/RETIRE_AFTER_DURABLE_SEQ_ADVANCE-DoEHtuR8.mjs";import{createAsyncStoragePersistence as i}from"./packem_shared/createAsyncStoragePersistence-6FCvqc6C.mjs";import{createAsyncStorageQueryCache as n}from"./packem_shared/createAsyncStorageQueryCache-COqH5_SV.mjs";import{default as s}from"./packem_shared/createInMemoryBookmarkStorage-BooZhW0n.mjs";import{createCallRunner as x}from"./packem_shared/createCallRunner-Bwcrfh76.mjs";import{createClientQuery as l}from"./packem_shared/createClientQuery-B8Nfj-7o.mjs";import{TabCoordinator as d}from"./packem_shared/TabCoordinator-DBuR7Dwv.mjs";import{a as R,i as C}from"./packem_shared/delta-merge-Ls3DED4g.mjs";import{CONFLICT_ERROR_CODE as A,TransportError as b,getErrorCode as h,getRetryAfterMs as D,isAuthReplayFailure as L,isConflictError as Q,isForbiddenError as T,isRateLimitedError as _,isUnauthorizedError as F}from"./packem_shared/CONFLICT_ERROR_CODE-B7qNZMMk.mjs";import{httpStream as M}from"./packem_shared/httpStream-DceAMeMf.mjs";import{c as O}from"./packem_shared/live-stream-Dil9byXF.mjs";import{liveTopicSubscription as U,subscribeLiveTopic as v}from"./packem_shared/liveTopicSubscription-gOmRbuhH.mjs";import{c as k}from"./packem_shared/local-store-fqWV2n_Z.mjs";import{LunoraClient as N}from"./packem_shared/LunoraClient-D6Mn3qEX.mjs";import{createMutatorRunner as K}from"./packem_shared/createMutatorRunner-CuMRJpUx.mjs";import{O as X}from"./packem_shared/offline-queue-Dt_um8sR.mjs";import{createInMemoryPersistence as w,createIndexedDbPersistence as G}from"./packem_shared/createInMemoryPersistence-BfgXApi_.mjs";import{preloadQuery as J,preloadedQueryResult as W}from"./packem_shared/preloadQuery-uFy24PCR.mjs";import{createInMemoryQueryCache as Z,createIndexedDbQueryCache as $,queryCacheKey as ee}from"./packem_shared/createInMemoryQueryCache-B5wX-gTy.mjs";import{createReconnect as oe}from"./packem_shared/createReconnect-CjTmjJDH.mjs";import{default as ae}from"./packem_shared/createSnapshotPrecondition-CLkxVeN1.mjs";import{DEFAULT_MAX_BUFFER as ie,createStream as pe}from"./packem_shared/DEFAULT_MAX_BUFFER-Bd-_iyiV.mjs";import{SubscriptionRegistry as me}from"./packem_shared/SubscriptionRegistry-DKIXE7M7.mjs";export{A as CONFLICT_ERROR_CODE,ie as DEFAULT_MAX_BUFFER,N as LunoraClient,X as OfflineQueue,o as RETIRE_AFTER_DURABLE_SEQ_ADVANCE,me as SubscriptionRegistry,d as TabCoordinator,b as TransportError,R as applyDelta,O as connectLiveStream,i as createAsyncStoragePersistence,n as createAsyncStorageQueryCache,x as createCallRunner,l as createClientQuery,s as createInMemoryBookmarkStorage,w as createInMemoryPersistence,Z as createInMemoryQueryCache,G as createIndexedDbPersistence,$ as createIndexedDbQueryCache,k as createLocalStore,K as createMutatorRunner,oe as createReconnect,ae as createSnapshotPrecondition,pe as createStream,h as getErrorCode,D as getRetryAfterMs,M as httpStream,L as isAuthReplayFailure,Q as isConflictError,T as isForbiddenError,C as isMutationDelta,_ as isRateLimitedError,F as isUnauthorizedError,U as liveTopicSubscription,t as maxSeq,J as preloadQuery,W as preloadedQueryResult,ee as queryCacheKey,a as reconcileOptimistic,v as subscribeLiveTopic};