@lunora/client 1.0.0-alpha.21 → 1.0.0-alpha.23

package/dist/auth/index.d.mts

@@ -1,4 +1,4 @@
-import { U as User, L as LunoraClient } from "../packem_shared/lunora-client.d-BYkEjCEJ.mjs";
+import { U as User, L as LunoraClient } from "../packem_shared/lunora-client.d-JvtVpf8A.mjs";
 import '@lunora/runtime';
 interface IdentityStore {
   /** Read the current resolved user, or `null` when signed out / not yet resolved. */

package/dist/auth/index.d.ts

@@ -1,4 +1,4 @@
-import { U as User, L as LunoraClient } from "../packem_shared/lunora-client.d-BYkEjCEJ.js";
+import { U as User, L as LunoraClient } from "../packem_shared/lunora-client.d-JvtVpf8A.js";
 import '@lunora/runtime';
 interface IdentityStore {
   /** Read the current resolved user, or `null` when signed out / not yet resolved. */

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { c as PersistenceAdapter, B as BookmarkStorage, F as FunctionReference, A as ArgsOf, M as MutationCallOptions, R as ReturnOf, O as OfflineQueueOptions, Q as QueryCacheAdapter, d as ReconnectOptions } from "./packem_shared/lunora-client.d-BYkEjCEJ.mjs";
-export { type e as BatchSlot, C as CONFLICT_ERROR_CODE, type f as CachedQuery, type g as ClientMessage, type h as ClientShapeSubscribeMessage, type i as ClientShapeUnsubscribeMessage, type j as ConnectionStatus, D as DEFAULT_MAX_BUFFER, type k as FunctionArgumentDescriptor, type l as FunctionDescriptor, type G as GlobalFacetResult, type m as GlobalFacetValue, type n as GlobalFilterClause, type o as GlobalTableInfo, type p as GlobalTablePage, L as LunoraClient, type q as LunoraClientError, type r as LunoraClientOptions, type s as LunoraErrorCode, type t as MutationSettledEvent, type u as OptimisticLocalStore, type v as OptimisticUpdate, type w as OutboxMutation, type x as OutboxSink, type y as PersistedMutation, type P as Preloaded, type z as RowOp, type E as RpcEnvelope, type H as RpcResponseBody, type I as ScheduleRecord, type J as SchedulerPoolStatus, type K as SchedulerStatus, type N as ServerMessage, type T as ServerPokeEndMessage, type V as ServerPokePartMessage, type W as ServerPokeStartMessage, type X as ShardTrafficEntry, type Y as ShardTrafficResult, type Z as StorageListPage, type _ as StorageObject, type $ as StreamHandle, type a0 as StreamIterable, type a1 as SubscriptionCallback, type S as SubscriptionError, type b as SubscriptionErrorCallback, a2 as SubscriptionRegistry, type a3 as SubscriptionState, type a4 as SyncWatermark, type a as Unsubscribe, type U as User, type a5 as WorkflowInstanceAction, type a6 as WorkflowInstanceDetail, type a7 as WorkflowInstancePage, type a8 as WorkflowInstanceStatus, type a9 as WorkflowInstanceSummary, type aa as WorkflowStepDetail, ab as createLocalStore, ac as createStream, ad as getErrorCode, ae as getRetryAfterMs, af as isConflictError, ag as isForbiddenError, ah as isRateLimitedError, ai as isUnauthorizedError } from "./packem_shared/lunora-client.d-BYkEjCEJ.mjs";
-export { p as preloadQuery, a as preloadedQueryResult } from "./packem_shared/preload.d-DrfuisCE.mjs";
+import { c as PersistenceAdapter, B as BookmarkStorage, S as SubscriptionError, H as HttpStreamRef, d as HttpStreamArgsOf, e as HttpStreamChunkOf, f as StreamIterable, F as FunctionReference, A as ArgsOf, M as MutationCallOptions, R as ReturnOf, O as OfflineQueueOptions, Q as QueryCacheAdapter, g as ReconnectOptions, L as LunoraClient } from "./packem_shared/lunora-client.d-JvtVpf8A.mjs";
+export { type h as BatchSlot, C as CONFLICT_ERROR_CODE, type i as CachedQuery, type j as ClientMessage, type k as ClientQueryRef, type l as ClientShapeSubscribeMessage, type m as ClientShapeUnsubscribeMessage, type n as ConnectionStatus, D as DEFAULT_MAX_BUFFER, type o 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 x as LunoraErrorCode, type y as MutationSettledEvent, 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 RowOp, type T as RpcEnvelope, type V as RpcResponseBody, type W as ScheduleRecord, type X as SchedulerPoolStatus, type Y as SchedulerStatus, type Z as ServerMessage, type _ as ServerPokeEndMessage, type $ as ServerPokePartMessage, type a0 as ServerPokeStartMessage, type a1 as ShardTrafficEntry, type a2 as ShardTrafficResult, type a3 as StorageListPage, type a4 as StorageObject, type a5 as StreamHandle, type a6 as SubscriptionCallback, type b as SubscriptionErrorCallback, a7 as SubscriptionRegistry, type a8 as SubscriptionState, type a9 as SyncWatermark, type a as Unsubscribe, type U as User, type aa as WorkflowInstanceAction, type ab as WorkflowInstanceDetail, type ac as WorkflowInstancePage, type ad as WorkflowInstanceStatus, type ae as WorkflowInstanceSummary, type af as WorkflowStepDetail, type ag as WsTokenProvider, ah as createClientQuery, ai as createLocalStore, aj as createStream, ak as getErrorCode, al as getRetryAfterMs, am as isConflictError, an as isForbiddenError, ao as isRateLimitedError, ap as isUnauthorizedError } from "./packem_shared/lunora-client.d-JvtVpf8A.mjs";
+export { p as preloadQuery, a as preloadedQueryResult } from "./packem_shared/preload.d-DKbjGN5O.mjs";
 export type { AuthCapabilities, AuthConfigInfo, AuthImpersonation, AuthPage, AuthSession, AuthUser, AuthUserFieldSpec, CronJobInfo, KvKeyEntry, KvKeyListResult, KvNamespaceSummary, KvValueResult, VectorIndexSummary, VectorQueryMatch } from '@lunora/runtime';
 /**
 * The slice of React Native's `AsyncStorage` (or any async key/value store —
@@ -33,6 +33,92 @@ interface AsyncStoragePersistenceOptions {
 declare const createAsyncStoragePersistence: (options: AsyncStoragePersistenceOptions) => PersistenceAdapter;
 /** Default in-memory bookmark store. Survives the lifetime of the client. */
 declare const createInMemoryBookmarkStorage: () => BookmarkStorage;
+interface TabCoordinatorOptions {
+  /**
+  * BroadcastChannel name. Defaults to `"lunora-bridge"`.
+  */
+  channelName?: string;
+  /**
+  * Interval (ms) between leader heartbeats. Defaults to 1000.
+  */
+  heartbeatInterval?: number;
+  /**
+  * Milliseconds without a heartbeat to consider the leader dead. Must be
+  * larger than `heartbeatInterval`. Defaults to 3000.
+  */
+  leaderTimeout?: number;
+  /**
+  * Called when this tab becomes the leader (should open WS connections).
+  */
+  onBecomeLeader?: () => void;
+  /**
+  * Called when this tab loses leadership (should close WS connections).
+  */
+  onStopBeingLeader?: () => void;
+  /**
+  * Called when the leader broadcasts subscription data.
+  */
+  onSubscriptionData?: (key: string, data: unknown) => void;
+  /**
+  * Called when the leader broadcasts a subscription error.
+  */
+  onSubscriptionError?: (key: string, error: SubscriptionError) => void;
+}
+declare class TabCoordinator {
+  private readonly bc;
+  private readonly tabId;
+  private readonly heartbeatInterval;
+  private readonly leaderTimeout;
+  /** The tab id of the current known leader, or `undefined` if no leader. */
+  private knownLeader;
+  /** `true` when this tab believes it is the leader. */
+  private leader;
+  /** `true` once `start()` has been called. */
+  private running;
+  /** Timestamp of the most recent leader heartbeat. */
+  private lastHeartbeat;
+  private heartbeatTimer;
+  private leaderCheckTimer;
+  /** Callbacks set via constructor options. */
+  private readonly onBecomeLeader;
+  private readonly onStopBeingLeader;
+  private readonly onSubscriptionData;
+  private readonly onSubscriptionError;
+  constructor(options?: TabCoordinatorOptions);
+  /**
+  * Start the coordinator: attempt to claim leadership and begin the
+  * heartbeat/leader-check cycle. Safe to call multiple times.
+  */
+  start(): void;
+  /**
+  * Stop the coordinator: yield leadership (if held), close the channel, and
+  * clear all timers. Safe to call multiple times.
+  */
+  stop(): void;
+  /** `true` when this tab is the current WebSocket leader. */
+  isLeader(): boolean;
+  /** The tab id of the current leader, or `undefined` if unknown / no leader. */
+  get leaderTabId(): string | undefined;
+  /** The id of this tab. */
+  get id(): string;
+  /** `true` when the coordinator has been started and is not yet stopped. */
+  get isRunning(): boolean;
+  /**
+  * Broadcast subscription data to all follower tabs. Only the leader should
+  * call this.
+  */
+  broadcastSubscriptionData(key: string, data: unknown): void;
+  /**
+  * Broadcast a subscription error to all follower tabs. Only the leader
+  * should call this.
+  */
+  broadcastSubscriptionError(key: string, error: SubscriptionError): void;
+  private broadcast;
+  private handleMessage;
+  private becomeLeader;
+  private sendHeartbeat;
+  private checkLeaderHealth;
+}
 /**
 * Client-side incremental merging of structured mutation deltas.
 *
@@ -95,6 +181,43 @@ declare const isMutationDelta: (value: unknown) => value is MutationDelta;
 * when an `insert`/`update` delta carries no `row` to splice in.
 */
 declare const applyDelta: (current: unknown, delta: MutationDelta) => undefined | unknown[];
+/**
+* Options accepted by {@link httpStream}.
+* @experimental Part of the HTTP-SSE stream surface.
+*/
+interface HttpStreamOptions {
+  /**
+  * Origin (or origin + prefix) the route path is appended to, e.g.
+  * `https://my-app.example.com`. Defaults to `""` — a relative URL, which
+  * resolves against the page origin in a browser.
+  */
+  baseUrl?: string;
+  /** `fetch` implementation override; defaults to the global `fetch`. */
+  fetch?: typeof fetch;
+  /** Extra request headers (e.g. `authorization`). `accept: text/event-stream` is always sent. */
+  headers?: Record<string, string>;
+  /** Caps the in-flight chunk buffer (see `createStream`); exceeding it fails the stream. */
+  maxBuffer?: number;
+  /** External abort signal — aborting it cancels the fetch (→ the server handler's `signal`). */
+  signal?: AbortSignal;
+}
+/**
+* Open a typed HTTP-SSE stream route and iterate its chunks:
+*
+* ```ts
+* const stream = httpStream(httpStreams.http.tokens, { searchParams: { prompt } }, { baseUrl });
+* for await (const token of stream) {
+*     render(token); // typed as the route handler's yielded chunk
+* }
+* ```
+*
+* The returned iterable terminates when the server writes `event: complete`;
+* an `event: error` frame (or a transport failure) surfaces as a coded
+* rejection on the next `next()`. `.cancel()` — or aborting `options.signal` —
+* aborts the underlying fetch, which the server observes via `request.signal`.
+* @experimental Reconnect/POST-body/wire-fidelity design questions are still open, so the shape may change.
+*/
+declare const httpStream: <Ref extends HttpStreamRef>(route: Ref, args?: HttpStreamArgsOf<Ref>, options?: HttpStreamOptions) => StreamIterable<HttpStreamChunkOf<Ref>>;
 /** The single transport method a mutation runner needs — narrowed so adapters can test against a stub. */
 interface MutationCapableClient<F extends FunctionReference> {
   mutation: (function_: F, args: ArgsOf<F>, options?: MutationCallOptions<unknown, unknown, ArgsOf<F>>) => Promise<ReturnOf<F>>;
@@ -202,6 +325,14 @@ interface QueuedMutation<T = unknown> {
   * Absent on hydrated records (the optimistic write lived in a prior session).
   */
   readonly onCommit?: (commitCursor: number | undefined) => void;
+  /**
+  * Optional sync predicate evaluated just before replay. When it returns
+  * `false` the write is dropped instead of replaying, handling the case
+  * where the mutation's preconditions are no longer valid (e.g. the
+  * document it referred to was deleted while offline). Absent or `true`
+  * means "ok to replay".
+  */
+  readonly precondition?: () => boolean;
   /** Rejects if the mutation can no longer be replayed. */
   readonly reject: (error: unknown) => void;
   /** Resolves once the mutation has been replayed against the server. */
@@ -288,6 +419,16 @@ declare class OfflineQueue {
   * transport failure: the unreplayed writes stay queued for the next reconnect.
   */
   requeue(items: QueuedMutation[]): void;
+  /**
+  * Remove mutations whose precondition evaluates to `false` (stale/dirty
+  * writes that should not replay) and reject each with an
+  * `OFFLINE_PRECONDITION_FAILED` error. The valid (admitted) mutations stay
+  * queued in FIFO order. Returns the drained stale entries.
+  *
+  * Called during reconnect before the flush cycle to weed out writes whose
+  * assumptions no longer hold (e.g. a document was deleted by another client).
+  */
+  drainConflict(): QueuedMutation[];
   clear(): void;
   /** Notify the size observer (the client's pending-sync count) after any change. */
   private notifySize;
@@ -398,4 +539,108 @@ interface ReconnectCalculator {
   reset: () => void;
 }
 declare const createReconnect: (options?: ReconnectOptions, random?: () => number) => ReconnectCalculator;
-export { type ArgsOf, type AsyncStorageLike, type AsyncStoragePersistenceOptions, type BookmarkStorage, type FunctionReference, type IndexedDbPersistenceOptions, type IndexedDbQueryCacheOptions, type MutationCallOptions, type MutationDelta, type MutationRunnerSinks, type MutatorHandle, type MutatorRunnerSinks, type MutatorTransaction, OfflineQueue, type OfflineQueueOptions, type PersistenceAdapter, type QueryCacheAdapter, type QueuedMutation, type ReconnectCalculator, type ReconnectOptions, type ReturnOf, applyDelta, createAsyncStoragePersistence, createInMemoryBookmarkStorage, createInMemoryPersistence, createInMemoryQueryCache, createIndexedDbPersistence, createIndexedDbQueryCache, createMutationRunner, createMutatorRunner, createReconnect, isMutationDelta, queryCacheKey };
+/**
+* Capture a snapshot of the current live query value at call time and produce a
+* `() => boolean` precondition that compares it against the value at replay time.
+*
+* When the precondition is checked (on queue drain / reconnect) it re-reads the
+* query's current value via {@link LunoraClient.peekActiveQueryValue}. If the
+* value differs from what was captured at call time the precondition returns
+* `false` and the offline mutation is dropped as stale.
+* @example
+* ```ts
+* client.mutation(api.todos.update, { id, text }, {
+*   precondition: createSnapshotPrecondition(client, api.todos.list, { userId }),
+* });
+* ```
+*/
+declare const createSnapshotPrecondition: (client: LunoraClient, functionRef: FunctionReference, args: Record<string, unknown>, shardKey?: string) => (() => boolean);
+/**
+* Client-side service-worker registration and lifecycle management.
+*
+* Usage:
+* ```ts
+* const sw = new ClientServiceWorker({ swUrl: "/sw.js" });
+* await sw.register();
+*
+* if (sw.active) {
+*   sw.postMessage({ type: "sync" });
+* }
+* ```
+*/
+type ServiceWorkerStatus = "unsupported" | "unregistered" | "registering" | "active" | "error";
+interface ClientSwOptions {
+  /** Called when the status changes. */
+  onStatusChange?: (status: ServiceWorkerStatus) => void;
+  /** Optional registration scope. Defaults to `/`. */
+  scope?: string;
+  /** URL of the service worker script (relative to origin). */
+  swUrl: string;
+}
+/**
+* Manages service-worker registration and provides a simple API for
+* sending messages and listening for responses.
+*/
+declare class ClientServiceWorker {
+  #private;
+  readonly swUrl: string;
+  readonly scope: string;
+  constructor(options: ClientSwOptions);
+  /** Current registration status. */
+  get status(): ServiceWorkerStatus;
+  /** The underlying `ServiceWorkerRegistration`, if registered. */
+  get registration(): ServiceWorkerRegistration | undefined;
+  /** Whether the SW is currently controlling this page. */
+  get active(): boolean;
+  /**
+  * Register the service worker.
+  *
+  * Returns `false` when the browser does not support service workers.
+  */
+  register(): Promise<boolean>;
+  /**
+  * Remove the active service worker registration and clear listeners.
+  *
+  * Returns `false` when no registration is currently held.
+  */
+  unregister(): Promise<boolean>;
+  /**
+  * Send a message to the active service worker.
+  */
+  postMessage(message: unknown): void;
+  /**
+  * Register a handler for messages **from** the service worker.
+  * @returns Unsubscribe function.
+  */
+  onMessage(handler: (event: MessageEvent) => void): () => void;
+}
+/**
+* Outbound message from the client to the SW.
+*/
+interface ClientToSwMessage {
+  /** Opaque correlation ID for request/response patterns. */
+  correlationId?: string;
+  payload?: unknown;
+  type: string;
+}
+/**
+* Inbound message from the SW to the client.
+*/
+interface SwToClientMessage {
+  /** Echoes the correlation ID from the client request, if any. */
+  correlationId?: string;
+  payload?: unknown;
+  type: string;
+}
+/**
+* Send a typed message to the service worker and optionally await a
+* matching response.
+* @returns A promise that resolves when the SW sends a reply with the
+* same `correlationId` (if `expectResponse` is true).
+*/
+declare const sendToSw: (sw: ServiceWorker | null, message: ClientToSwMessage, expectResponse?: boolean) => Promise<unknown>;
+/**
+* Create a reply for a client message (call from inside the SW).
+*/
+declare const createReply: (original: ClientToSwMessage, payload?: unknown) => SwToClientMessage;
+export { type ArgsOf, type AsyncStorageLike, type AsyncStoragePersistenceOptions, type BookmarkStorage, ClientServiceWorker, type ClientSwOptions, type ClientToSwMessage, type FunctionReference, type HttpStreamArgsOf, type HttpStreamChunkOf, type HttpStreamOptions, type HttpStreamRef, type IndexedDbPersistenceOptions, type IndexedDbQueryCacheOptions, LunoraClient, type MutationCallOptions, type MutationDelta, type MutationRunnerSinks, type MutatorHandle, type MutatorRunnerSinks, type MutatorTransaction, OfflineQueue, type OfflineQueueOptions, type PersistenceAdapter, type QueryCacheAdapter, type QueuedMutation, type ReconnectCalculator, type ReconnectOptions, type ReturnOf, type ServiceWorkerStatus, type StreamIterable, type SubscriptionError, type SwToClientMessage, TabCoordinator, applyDelta, createAsyncStoragePersistence, createInMemoryBookmarkStorage, createInMemoryPersistence, createInMemoryQueryCache, createIndexedDbPersistence, createIndexedDbQueryCache, createMutationRunner, createMutatorRunner, createReconnect, createReply, createSnapshotPrecondition, httpStream, isMutationDelta, queryCacheKey, sendToSw };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { c as PersistenceAdapter, B as BookmarkStorage, F as FunctionReference, A as ArgsOf, M as MutationCallOptions, R as ReturnOf, O as OfflineQueueOptions, Q as QueryCacheAdapter, d as ReconnectOptions } from "./packem_shared/lunora-client.d-BYkEjCEJ.js";
-export { type e as BatchSlot, C as CONFLICT_ERROR_CODE, type f as CachedQuery, type g as ClientMessage, type h as ClientShapeSubscribeMessage, type i as ClientShapeUnsubscribeMessage, type j as ConnectionStatus, D as DEFAULT_MAX_BUFFER, type k as FunctionArgumentDescriptor, type l as FunctionDescriptor, type G as GlobalFacetResult, type m as GlobalFacetValue, type n as GlobalFilterClause, type o as GlobalTableInfo, type p as GlobalTablePage, L as LunoraClient, type q as LunoraClientError, type r as LunoraClientOptions, type s as LunoraErrorCode, type t as MutationSettledEvent, type u as OptimisticLocalStore, type v as OptimisticUpdate, type w as OutboxMutation, type x as OutboxSink, type y as PersistedMutation, type P as Preloaded, type z as RowOp, type E as RpcEnvelope, type H as RpcResponseBody, type I as ScheduleRecord, type J as SchedulerPoolStatus, type K as SchedulerStatus, type N as ServerMessage, type T as ServerPokeEndMessage, type V as ServerPokePartMessage, type W as ServerPokeStartMessage, type X as ShardTrafficEntry, type Y as ShardTrafficResult, type Z as StorageListPage, type _ as StorageObject, type $ as StreamHandle, type a0 as StreamIterable, type a1 as SubscriptionCallback, type S as SubscriptionError, type b as SubscriptionErrorCallback, a2 as SubscriptionRegistry, type a3 as SubscriptionState, type a4 as SyncWatermark, type a as Unsubscribe, type U as User, type a5 as WorkflowInstanceAction, type a6 as WorkflowInstanceDetail, type a7 as WorkflowInstancePage, type a8 as WorkflowInstanceStatus, type a9 as WorkflowInstanceSummary, type aa as WorkflowStepDetail, ab as createLocalStore, ac as createStream, ad as getErrorCode, ae as getRetryAfterMs, af as isConflictError, ag as isForbiddenError, ah as isRateLimitedError, ai as isUnauthorizedError } from "./packem_shared/lunora-client.d-BYkEjCEJ.js";
-export { p as preloadQuery, a as preloadedQueryResult } from "./packem_shared/preload.d-B-vyHnml.js";
+import { c as PersistenceAdapter, B as BookmarkStorage, S as SubscriptionError, H as HttpStreamRef, d as HttpStreamArgsOf, e as HttpStreamChunkOf, f as StreamIterable, F as FunctionReference, A as ArgsOf, M as MutationCallOptions, R as ReturnOf, O as OfflineQueueOptions, Q as QueryCacheAdapter, g as ReconnectOptions, L as LunoraClient } from "./packem_shared/lunora-client.d-JvtVpf8A.js";
+export { type h as BatchSlot, C as CONFLICT_ERROR_CODE, type i as CachedQuery, type j as ClientMessage, type k as ClientQueryRef, type l as ClientShapeSubscribeMessage, type m as ClientShapeUnsubscribeMessage, type n as ConnectionStatus, D as DEFAULT_MAX_BUFFER, type o 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 x as LunoraErrorCode, type y as MutationSettledEvent, 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 RowOp, type T as RpcEnvelope, type V as RpcResponseBody, type W as ScheduleRecord, type X as SchedulerPoolStatus, type Y as SchedulerStatus, type Z as ServerMessage, type _ as ServerPokeEndMessage, type $ as ServerPokePartMessage, type a0 as ServerPokeStartMessage, type a1 as ShardTrafficEntry, type a2 as ShardTrafficResult, type a3 as StorageListPage, type a4 as StorageObject, type a5 as StreamHandle, type a6 as SubscriptionCallback, type b as SubscriptionErrorCallback, a7 as SubscriptionRegistry, type a8 as SubscriptionState, type a9 as SyncWatermark, type a as Unsubscribe, type U as User, type aa as WorkflowInstanceAction, type ab as WorkflowInstanceDetail, type ac as WorkflowInstancePage, type ad as WorkflowInstanceStatus, type ae as WorkflowInstanceSummary, type af as WorkflowStepDetail, type ag as WsTokenProvider, ah as createClientQuery, ai as createLocalStore, aj as createStream, ak as getErrorCode, al as getRetryAfterMs, am as isConflictError, an as isForbiddenError, ao as isRateLimitedError, ap as isUnauthorizedError } from "./packem_shared/lunora-client.d-JvtVpf8A.js";
+export { p as preloadQuery, a as preloadedQueryResult } from "./packem_shared/preload.d-C4_d_l5v.js";
 export type { AuthCapabilities, AuthConfigInfo, AuthImpersonation, AuthPage, AuthSession, AuthUser, AuthUserFieldSpec, CronJobInfo, KvKeyEntry, KvKeyListResult, KvNamespaceSummary, KvValueResult, VectorIndexSummary, VectorQueryMatch } from '@lunora/runtime';
 /**
 * The slice of React Native's `AsyncStorage` (or any async key/value store —
@@ -33,6 +33,92 @@ interface AsyncStoragePersistenceOptions {
 declare const createAsyncStoragePersistence: (options: AsyncStoragePersistenceOptions) => PersistenceAdapter;
 /** Default in-memory bookmark store. Survives the lifetime of the client. */
 declare const createInMemoryBookmarkStorage: () => BookmarkStorage;
+interface TabCoordinatorOptions {
+  /**
+  * BroadcastChannel name. Defaults to `"lunora-bridge"`.
+  */
+  channelName?: string;
+  /**
+  * Interval (ms) between leader heartbeats. Defaults to 1000.
+  */
+  heartbeatInterval?: number;
+  /**
+  * Milliseconds without a heartbeat to consider the leader dead. Must be
+  * larger than `heartbeatInterval`. Defaults to 3000.
+  */
+  leaderTimeout?: number;
+  /**
+  * Called when this tab becomes the leader (should open WS connections).
+  */
+  onBecomeLeader?: () => void;
+  /**
+  * Called when this tab loses leadership (should close WS connections).
+  */
+  onStopBeingLeader?: () => void;
+  /**
+  * Called when the leader broadcasts subscription data.
+  */
+  onSubscriptionData?: (key: string, data: unknown) => void;
+  /**
+  * Called when the leader broadcasts a subscription error.
+  */
+  onSubscriptionError?: (key: string, error: SubscriptionError) => void;
+}
+declare class TabCoordinator {
+  private readonly bc;
+  private readonly tabId;
+  private readonly heartbeatInterval;
+  private readonly leaderTimeout;
+  /** The tab id of the current known leader, or `undefined` if no leader. */
+  private knownLeader;
+  /** `true` when this tab believes it is the leader. */
+  private leader;
+  /** `true` once `start()` has been called. */
+  private running;
+  /** Timestamp of the most recent leader heartbeat. */
+  private lastHeartbeat;
+  private heartbeatTimer;
+  private leaderCheckTimer;
+  /** Callbacks set via constructor options. */
+  private readonly onBecomeLeader;
+  private readonly onStopBeingLeader;
+  private readonly onSubscriptionData;
+  private readonly onSubscriptionError;
+  constructor(options?: TabCoordinatorOptions);
+  /**
+  * Start the coordinator: attempt to claim leadership and begin the
+  * heartbeat/leader-check cycle. Safe to call multiple times.
+  */
+  start(): void;
+  /**
+  * Stop the coordinator: yield leadership (if held), close the channel, and
+  * clear all timers. Safe to call multiple times.
+  */
+  stop(): void;
+  /** `true` when this tab is the current WebSocket leader. */
+  isLeader(): boolean;
+  /** The tab id of the current leader, or `undefined` if unknown / no leader. */
+  get leaderTabId(): string | undefined;
+  /** The id of this tab. */
+  get id(): string;
+  /** `true` when the coordinator has been started and is not yet stopped. */
+  get isRunning(): boolean;
+  /**
+  * Broadcast subscription data to all follower tabs. Only the leader should
+  * call this.
+  */
+  broadcastSubscriptionData(key: string, data: unknown): void;
+  /**
+  * Broadcast a subscription error to all follower tabs. Only the leader
+  * should call this.
+  */
+  broadcastSubscriptionError(key: string, error: SubscriptionError): void;
+  private broadcast;
+  private handleMessage;
+  private becomeLeader;
+  private sendHeartbeat;
+  private checkLeaderHealth;
+}
 /**
 * Client-side incremental merging of structured mutation deltas.
 *
@@ -95,6 +181,43 @@ declare const isMutationDelta: (value: unknown) => value is MutationDelta;
 * when an `insert`/`update` delta carries no `row` to splice in.
 */
 declare const applyDelta: (current: unknown, delta: MutationDelta) => undefined | unknown[];
+/**
+* Options accepted by {@link httpStream}.
+* @experimental Part of the HTTP-SSE stream surface.
+*/
+interface HttpStreamOptions {
+  /**
+  * Origin (or origin + prefix) the route path is appended to, e.g.
+  * `https://my-app.example.com`. Defaults to `""` — a relative URL, which
+  * resolves against the page origin in a browser.
+  */
+  baseUrl?: string;
+  /** `fetch` implementation override; defaults to the global `fetch`. */
+  fetch?: typeof fetch;
+  /** Extra request headers (e.g. `authorization`). `accept: text/event-stream` is always sent. */
+  headers?: Record<string, string>;
+  /** Caps the in-flight chunk buffer (see `createStream`); exceeding it fails the stream. */
+  maxBuffer?: number;
+  /** External abort signal — aborting it cancels the fetch (→ the server handler's `signal`). */
+  signal?: AbortSignal;
+}
+/**
+* Open a typed HTTP-SSE stream route and iterate its chunks:
+*
+* ```ts
+* const stream = httpStream(httpStreams.http.tokens, { searchParams: { prompt } }, { baseUrl });
+* for await (const token of stream) {
+*     render(token); // typed as the route handler's yielded chunk
+* }
+* ```
+*
+* The returned iterable terminates when the server writes `event: complete`;
+* an `event: error` frame (or a transport failure) surfaces as a coded
+* rejection on the next `next()`. `.cancel()` — or aborting `options.signal` —
+* aborts the underlying fetch, which the server observes via `request.signal`.
+* @experimental Reconnect/POST-body/wire-fidelity design questions are still open, so the shape may change.
+*/
+declare const httpStream: <Ref extends HttpStreamRef>(route: Ref, args?: HttpStreamArgsOf<Ref>, options?: HttpStreamOptions) => StreamIterable<HttpStreamChunkOf<Ref>>;
 /** The single transport method a mutation runner needs — narrowed so adapters can test against a stub. */
 interface MutationCapableClient<F extends FunctionReference> {
   mutation: (function_: F, args: ArgsOf<F>, options?: MutationCallOptions<unknown, unknown, ArgsOf<F>>) => Promise<ReturnOf<F>>;
@@ -202,6 +325,14 @@ interface QueuedMutation<T = unknown> {
   * Absent on hydrated records (the optimistic write lived in a prior session).
   */
   readonly onCommit?: (commitCursor: number | undefined) => void;
+  /**
+  * Optional sync predicate evaluated just before replay. When it returns
+  * `false` the write is dropped instead of replaying, handling the case
+  * where the mutation's preconditions are no longer valid (e.g. the
+  * document it referred to was deleted while offline). Absent or `true`
+  * means "ok to replay".
+  */
+  readonly precondition?: () => boolean;
   /** Rejects if the mutation can no longer be replayed. */
   readonly reject: (error: unknown) => void;
   /** Resolves once the mutation has been replayed against the server. */
@@ -288,6 +419,16 @@ declare class OfflineQueue {
   * transport failure: the unreplayed writes stay queued for the next reconnect.
   */
   requeue(items: QueuedMutation[]): void;
+  /**
+  * Remove mutations whose precondition evaluates to `false` (stale/dirty
+  * writes that should not replay) and reject each with an
+  * `OFFLINE_PRECONDITION_FAILED` error. The valid (admitted) mutations stay
+  * queued in FIFO order. Returns the drained stale entries.
+  *
+  * Called during reconnect before the flush cycle to weed out writes whose
+  * assumptions no longer hold (e.g. a document was deleted by another client).
+  */
+  drainConflict(): QueuedMutation[];
   clear(): void;
   /** Notify the size observer (the client's pending-sync count) after any change. */
   private notifySize;
@@ -398,4 +539,108 @@ interface ReconnectCalculator {
   reset: () => void;
 }
 declare const createReconnect: (options?: ReconnectOptions, random?: () => number) => ReconnectCalculator;
-export { type ArgsOf, type AsyncStorageLike, type AsyncStoragePersistenceOptions, type BookmarkStorage, type FunctionReference, type IndexedDbPersistenceOptions, type IndexedDbQueryCacheOptions, type MutationCallOptions, type MutationDelta, type MutationRunnerSinks, type MutatorHandle, type MutatorRunnerSinks, type MutatorTransaction, OfflineQueue, type OfflineQueueOptions, type PersistenceAdapter, type QueryCacheAdapter, type QueuedMutation, type ReconnectCalculator, type ReconnectOptions, type ReturnOf, applyDelta, createAsyncStoragePersistence, createInMemoryBookmarkStorage, createInMemoryPersistence, createInMemoryQueryCache, createIndexedDbPersistence, createIndexedDbQueryCache, createMutationRunner, createMutatorRunner, createReconnect, isMutationDelta, queryCacheKey };
+/**
+* Capture a snapshot of the current live query value at call time and produce a
+* `() => boolean` precondition that compares it against the value at replay time.
+*
+* When the precondition is checked (on queue drain / reconnect) it re-reads the
+* query's current value via {@link LunoraClient.peekActiveQueryValue}. If the
+* value differs from what was captured at call time the precondition returns
+* `false` and the offline mutation is dropped as stale.
+* @example
+* ```ts
+* client.mutation(api.todos.update, { id, text }, {
+*   precondition: createSnapshotPrecondition(client, api.todos.list, { userId }),
+* });
+* ```
+*/
+declare const createSnapshotPrecondition: (client: LunoraClient, functionRef: FunctionReference, args: Record<string, unknown>, shardKey?: string) => (() => boolean);
+/**
+* Client-side service-worker registration and lifecycle management.
+*
+* Usage:
+* ```ts
+* const sw = new ClientServiceWorker({ swUrl: "/sw.js" });
+* await sw.register();
+*
+* if (sw.active) {
+*   sw.postMessage({ type: "sync" });
+* }
+* ```
+*/
+type ServiceWorkerStatus = "unsupported" | "unregistered" | "registering" | "active" | "error";
+interface ClientSwOptions {
+  /** Called when the status changes. */
+  onStatusChange?: (status: ServiceWorkerStatus) => void;
+  /** Optional registration scope. Defaults to `/`. */
+  scope?: string;
+  /** URL of the service worker script (relative to origin). */
+  swUrl: string;
+}
+/**
+* Manages service-worker registration and provides a simple API for
+* sending messages and listening for responses.
+*/
+declare class ClientServiceWorker {
+  #private;
+  readonly swUrl: string;
+  readonly scope: string;
+  constructor(options: ClientSwOptions);
+  /** Current registration status. */
+  get status(): ServiceWorkerStatus;
+  /** The underlying `ServiceWorkerRegistration`, if registered. */
+  get registration(): ServiceWorkerRegistration | undefined;
+  /** Whether the SW is currently controlling this page. */
+  get active(): boolean;
+  /**
+  * Register the service worker.
+  *
+  * Returns `false` when the browser does not support service workers.
+  */
+  register(): Promise<boolean>;
+  /**
+  * Remove the active service worker registration and clear listeners.
+  *
+  * Returns `false` when no registration is currently held.
+  */
+  unregister(): Promise<boolean>;
+  /**
+  * Send a message to the active service worker.
+  */
+  postMessage(message: unknown): void;
+  /**
+  * Register a handler for messages **from** the service worker.
+  * @returns Unsubscribe function.
+  */
+  onMessage(handler: (event: MessageEvent) => void): () => void;
+}
+/**
+* Outbound message from the client to the SW.
+*/
+interface ClientToSwMessage {
+  /** Opaque correlation ID for request/response patterns. */
+  correlationId?: string;
+  payload?: unknown;
+  type: string;
+}
+/**
+* Inbound message from the SW to the client.
+*/
+interface SwToClientMessage {
+  /** Echoes the correlation ID from the client request, if any. */
+  correlationId?: string;
+  payload?: unknown;
+  type: string;
+}
+/**
+* Send a typed message to the service worker and optionally await a
+* matching response.
+* @returns A promise that resolves when the SW sends a reply with the
+* same `correlationId` (if `expectResponse` is true).
+*/
+declare const sendToSw: (sw: ServiceWorker | null, message: ClientToSwMessage, expectResponse?: boolean) => Promise<unknown>;
+/**
+* Create a reply for a client message (call from inside the SW).
+*/
+declare const createReply: (original: ClientToSwMessage, payload?: unknown) => SwToClientMessage;
+export { type ArgsOf, type AsyncStorageLike, type AsyncStoragePersistenceOptions, type BookmarkStorage, ClientServiceWorker, type ClientSwOptions, type ClientToSwMessage, type FunctionReference, type HttpStreamArgsOf, type HttpStreamChunkOf, type HttpStreamOptions, type HttpStreamRef, type IndexedDbPersistenceOptions, type IndexedDbQueryCacheOptions, LunoraClient, type MutationCallOptions, type MutationDelta, type MutationRunnerSinks, type MutatorHandle, type MutatorRunnerSinks, type MutatorTransaction, OfflineQueue, type OfflineQueueOptions, type PersistenceAdapter, type QueryCacheAdapter, type QueuedMutation, type ReconnectCalculator, type ReconnectOptions, type ReturnOf, type ServiceWorkerStatus, type StreamIterable, type SubscriptionError, type SwToClientMessage, TabCoordinator, applyDelta, createAsyncStoragePersistence, createInMemoryBookmarkStorage, createInMemoryPersistence, createInMemoryQueryCache, createIndexedDbPersistence, createIndexedDbQueryCache, createMutationRunner, createMutatorRunner, createReconnect, createReply, createSnapshotPrecondition, httpStream, isMutationDelta, queryCacheKey, sendToSw };

package/dist/index.mjs

@@ -1,15 +1,21 @@
 export { createAsyncStoragePersistence } from './packem_shared/createAsyncStoragePersistence-1Z5BZ8RC.mjs';
 export { default as createInMemoryBookmarkStorage } from './packem_shared/createInMemoryBookmarkStorage-BoN7a7TH.mjs';
+export { createClientQuery } from './packem_shared/createClientQuery-CQ51bWAE.mjs';
+export { TabCoordinator } from './packem_shared/TabCoordinator-BwRR8H06.mjs';
 export { applyDelta, isMutationDelta } from './packem_shared/applyDelta-CRKZ1PBt.mjs';
 export { CONFLICT_ERROR_CODE, getErrorCode, getRetryAfterMs, isConflictError, isForbiddenError, isRateLimitedError, isUnauthorizedError } from './packem_shared/CONFLICT_ERROR_CODE-B8gQ8tyU.mjs';
-export { c as createLocalStore } from './packem_shared/local-store-BveBeFEo.mjs';
-export { LunoraClient } from './packem_shared/LunoraClient-kXpHNyaE.mjs';
+export { httpStream } from './packem_shared/httpStream-BJU-aflc.mjs';
+export { c as createLocalStore } from './packem_shared/local-store-DIq-UWfD.mjs';
+export { LunoraClient } from './packem_shared/LunoraClient-BBCQjjbl.mjs';
 export { createMutationRunner } from './packem_shared/createMutationRunner-BqsavzvG.mjs';
 export { createMutatorRunner } from './packem_shared/createMutatorRunner-BETvCd0p.mjs';
-export { O as OfflineQueue } from './packem_shared/offline-queue-B9vfdSqp.mjs';
+export { O as OfflineQueue } from './packem_shared/offline-queue-CF4_Co5k.mjs';
 export { createInMemoryPersistence, createIndexedDbPersistence } from './packem_shared/createInMemoryPersistence-DZ2VHWgm.mjs';
 export { preloadQuery, preloadedQueryResult } from './packem_shared/preloadQuery-lobFkD2Z.mjs';
 export { createInMemoryQueryCache, createIndexedDbQueryCache, queryCacheKey } from './packem_shared/createInMemoryQueryCache-DiaGZkA2.mjs';
 export { createReconnect } from './packem_shared/createReconnect-Di_-oHH7.mjs';
+export { default as createSnapshotPrecondition } from './packem_shared/createSnapshotPrecondition-CxQ1T4ZP.mjs';
 export { DEFAULT_MAX_BUFFER, createStream } from './packem_shared/DEFAULT_MAX_BUFFER-7hFnzNk9.mjs';
-export { S as SubscriptionRegistry } from './packem_shared/subscription-BjynOXCU.mjs';
+export { SubscriptionRegistry } from './packem_shared/SubscriptionRegistry-CxS_Inha.mjs';
+export { ClientServiceWorker } from './packem_shared/ClientServiceWorker-C3PAFwy0.mjs';
+export { createReply, sendToSw } from './packem_shared/createReply-lI4tVS2w.mjs';