@lunora/client 1.0.0-alpha.193 → 1.0.0-alpha.195

package/dist/packem_shared/{lunora-client.d-DDVPWV7D.d.mts → lunora-client.d-SHCNd1Cn.d.mts}

@@ -1,41 +1,6 @@
 import { LunoraErrorCodeInput, LunoraErrorCode } from '@lunora/errors';
 import { F as FunctionReference, A as ArgsOf, R as ReturnOf } from "./function-reference.d-Br_hsKje.mjs";
 import { CronJobInfo, VectorIndexSummary, VectorQueryMatch, PipelineLogQuery, PipelineLogPage, KvNamespaceSummary, KvKeyListResult, KvValueResult, AuthUser, AuthPage, AuthImpersonation, AuthCapabilities, AuthConfigInfo, AuthSession } from '@lunora/runtime';
-/**
- * Reactive key-value store for local-only client state.
- *
- * Unlike a server {@link SubscriptionState} (which tracks a live WS connection,
- * an `acked` flag, `serverBase`, optimistic layers, and the full subscription
- * machinery), a `ClientQueryRef` is purely local — no server round-trip, no
- * WebSocket, no persistence. It exists so framework adapters can offer a
- * `useClientQuery` hook whose values survive component remounts and are shared
- * across every consumer of the same ref, with none of the ceremony or coupling
- * of a dedicated context provider.
- *
- * The store lives inside `LunoraClient` (a private field) and is surfaced through
- * `client.getClientQuery(ref)` / `setClientQuery(ref, value)` /
- * `subscribeClientQuery(ref, callback)`.
- */
-/** Opaque handle for a typed client-local query slot. */
-interface ClientQueryRef<T = unknown> {
-  /** Default value when no value has been set explicitly. */
-  readonly defaultValue: T;
-  /** Stable identity for the slot. Must be unique within a client instance. */
-  readonly key: string;
-}
-/**
- * Create a typed {@link ClientQueryRef}. Call once per slot at module scope
- * (or inside a component module) — the ref object is the stable identity.
- * @example
- * ```ts
- * // lunora/client-queries.ts
- * import { createClientQuery } from "@lunora/client";
- *
- * export const sidebarOpen = createClientQuery("sidebarOpen", true);
- * export const selectedMessageId = createClientQuery("selectedMessageId", undefined as string | undefined);
- * ```
- */
-declare const createClientQuery: <T>(key: string, defaultValue: T) => ClientQueryRef<T>;
 /**
  * Typed reference to an HTTP-SSE stream route (`httpRoute.<verb>(path).stream()`)
  * emitted by `@lunora/codegen` as `httpStreams.<namespace>.<name>`.
@@ -1397,6 +1362,80 @@ declare class SubscriptionRegistry {
    */
   clear(): void;
 }
+/**
+ * An `Error` carrying the server's machine-readable `code` and (for a
+ * `LunoraError`) structured `data`, plus an optional actionable `hint` (Markdown)
+ * and `docsUrl` resolved from the central error catalog. The client's public
+ * error contract for RPC/batch failures — a UI can render `hint`/`docsUrl` to
+ * tell the user how to fix the error. The `(string & {})` arm keeps
+ * forward-compat/unknown server codes assignable without losing autocomplete on
+ * the known `LunoraErrorCode` union.
+ */
+type LunoraClientError = Error & {
+  code?: LunoraErrorCode | (string & {});
+  data?: unknown;
+  docsUrl?: string;
+  hint?: string | string[];
+};
+/** One demuxed result slot of a `LunoraClient.batch` call. */
+type BatchSlot = {
+  error: LunoraClientError;
+  ok: false;
+} | {
+  ok: true;
+  value: unknown;
+};
+/**
+ * Reactive key-value store for local-only client state.
+ *
+ * Unlike a server {@link SubscriptionState} (which tracks a live WS connection,
+ * an `acked` flag, `serverBase`, optimistic layers, and the full subscription
+ * machinery), a `ClientQueryRef` is purely local — no server round-trip, no
+ * WebSocket, no persistence. It exists so framework adapters can offer a
+ * `useClientQuery` hook whose values survive component remounts and are shared
+ * across every consumer of the same ref, with none of the ceremony or coupling
+ * of a dedicated context provider.
+ *
+ * The store lives inside `LunoraClient` (a private field) and is surfaced through
+ * `client.getClientQuery(ref)` / `setClientQuery(ref, value)` /
+ * `subscribeClientQuery(ref, callback)`.
+ */
+/** Opaque handle for a typed client-local query slot. */
+interface ClientQueryRef<T = unknown> {
+  /** Default value when no value has been set explicitly. */
+  readonly defaultValue: T;
+  /** Stable identity for the slot. Must be unique within a client instance. */
+  readonly key: string;
+}
+/**
+ * Create a typed {@link ClientQueryRef}. Call once per slot at module scope
+ * (or inside a component module) — the ref object is the stable identity.
+ * @example
+ * ```ts
+ * // lunora/client-queries.ts
+ * import { createClientQuery } from "@lunora/client";
+ *
+ * export const sidebarOpen = createClientQuery("sidebarOpen", true);
+ * export const selectedMessageId = createClientQuery("selectedMessageId", undefined as string | undefined);
+ * ```
+ */
+declare const createClientQuery: <T>(key: string, defaultValue: T) => ClientQueryRef<T>;
+type WSState = "idle" | "connecting" | "open" | "closed";
+/**
+ * Aggregate live-socket health across every shard connection, for a UI status
+ * indicator. `idle` = no socket opened yet; `connecting` = at least one socket
+ * is (re)connecting and none is open; `connected` = at least one socket is open;
+ * `polling` = no socket would open, so live queries are being refreshed over HTTP
+ * instead (see `polling-fallback.ts` — live but slower, and shapes
+ * / streams / whispers are dark; mutations go over HTTP as they do while
+ * connected); `offline` = sockets exist but all are down (between reconnect
+ * attempts), and a poll could not reach the origin either.
+ *
+ * `polling` outranks `connecting`: while the fallback is running a reconnect is
+ * still armed in the background, and reporting that attempt would flicker the
+ * indicator between two states while data is in fact arriving on the slow path.
+ */
+type ConnectionStatus = "connected" | "connecting" | "idle" | "offline" | "polling";
 /**
  * Read/write handle over the client's live query cache, handed to a mutation's
  * `withOptimisticUpdate` callback so a single mutation can optimistically patch
@@ -1450,6 +1489,8 @@ declare const createLocalStore: (subscriptions: SubscriptionRegistry, shardKey:
   rollbacks: (() => void)[];
   store: OptimisticLocalStore;
 };
+/** Callback a shape subscription invokes with its materialized rowset on every applied poke. */
+type ShapeCallback = (rows: Record<string, unknown>[]) => void;
 declare const DEFAULT_MAX_BUFFER = 1024;
 interface StreamHandle<T = unknown> {
   /** Mark the stream complete (no more chunks); resolves any pending consumer to `done:true`. */
@@ -1482,22 +1523,6 @@ declare const createStream: <T>(options: {
   handle: StreamHandle<T>;
   iterable: StreamIterable<T>;
 };
-type WSState = "idle" | "connecting" | "open" | "closed";
-/**
- * Aggregate live-socket health across every shard connection, for a UI status
- * indicator. `idle` = no socket opened yet; `connecting` = at least one socket
- * is (re)connecting and none is open; `connected` = at least one socket is open;
- * `polling` = no socket would open, so live queries are being refreshed over HTTP
- * instead (see {@link file://./polling-fallback.ts} — live but slower, and shapes
- * / streams / whispers are dark; mutations go over HTTP as they do while
- * connected); `offline` = sockets exist but all are down (between reconnect
- * attempts), and a poll could not reach the origin either.
- *
- * `polling` outranks `connecting`: while the fallback is running a reconnect is
- * still armed in the background, and reporting that attempt would flicker the
- * indicator between two states while data is in fact arriving on the slow path.
- */
-type ConnectionStatus = "connected" | "connecting" | "idle" | "offline" | "polling";
 /** One shard's socket + watermark state in a {@link LunoraClient.debug} snapshot. */
 interface ClientDebugShard {
   /**
@@ -1702,31 +1727,6 @@ type ReplayIdentityVerdict = {
 } | {
   verdict: "unknown";
 };
-/** Callback a shape subscription invokes with its materialized rowset on every applied poke. */
-type ShapeCallback = (rows: Record<string, unknown>[]) => void;
-/**
- * An `Error` carrying the server's machine-readable `code` and (for a
- * `LunoraError`) structured `data`, plus an optional actionable `hint` (Markdown)
- * and `docsUrl` resolved from the central error catalog. The client's public
- * error contract for RPC/batch failures — a UI can render `hint`/`docsUrl` to
- * tell the user how to fix the error. The `(string & {})` arm keeps
- * forward-compat/unknown server codes assignable without losing autocomplete on
- * the known {@link LunoraErrorCode} union.
- */
-type LunoraClientError = Error & {
-  code?: LunoraErrorCode | (string & {});
-  data?: unknown;
-  docsUrl?: string;
-  hint?: string | string[];
-};
-/** One demuxed result slot of a {@link LunoraClient.batch} call (plan 088). */
-type BatchSlot = {
-  error: LunoraClientError;
-  ok: false;
-} | {
-  ok: true;
-  value: unknown;
-};
 /**
  * Lunora browser/edge client. Talks RPC over HTTP and real-time deltas over
  * a single multiplexed WebSocket.
@@ -1761,6 +1761,8 @@ declare class LunoraClient {
   private readonly connectTimeoutMs;
   /** Keepalive cadence (ms); `0` disables the heartbeat. See {@link LunoraClientOptions.heartbeatIntervalMs}. */
   private readonly heartbeatIntervalMs;
+  /** 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. */
   private readonly pollingFallbackAfterFailedAttempts;
   /** Polling-fallback cadence (ms); `0` disables it. See {@link LunoraClientOptions.pollingFallback}. */
@@ -3921,26 +3923,6 @@ declare class LunoraClient {
    * a silent tokenless socket the admin gate would reject.
    */
   private openSocketWithProvidedToken;
-  /**
-   * Construct one WebSocket connection attempt and wire the shared
-   * lifecycle guarantees around it — the fail-fast connect-timeout, the
-   * identity guard that stops a superseded attempt's late `open`/`message`/
-   * `close`/`error` from touching a connection a newer attempt already
-   * owns, and (once open) the keepalive heartbeat with its half-open
-   * watchdog (plan 217). One call opens ONE attempt; the caller owns
-   * reconnect scheduling from `onClose` — mirrors the shard's existing
-   * `ensureSocket` / `handleDisconnect` split, now shared with
-   * `subscribeScheduledJobs` so it stops re-living the bug that split
-   * already fixed once (CLIENT-05).
-   *
-   * The identity guard is `conn.socket !== socket`, re-checked before every
-   * action below. `conn.socket` is reassigned to a new attempt's socket
-   * synchronously — right here, before `open` ever fires — so an older
-   * attempt's guard trips the instant it's superseded, even if its
-   * underlying socket only fires its real `close`/`error` much later. This
-   * ordering is load-bearing: preserve it exactly.
-   */
-  private openManagedSocket;
   /** Construct the shard socket and wire its lifecycle handlers. The connection must already be in the `connecting` state. */
   private openSocket;
   /**
@@ -3949,27 +3931,6 @@ declare class LunoraClient {
    */
   private cancelStream;
   private handleDisconnect;
-  /**
-   * Begin the keepalive heartbeat on an open connection attempt — the only
-   * caller is {@link openManagedSocket}'s own `open` handler, so both the
-   * shard socket and `subscribeScheduledJobs` share this one implementation
-   * instead of each hand-rolling their own (plan 217, generalized).
-   *
-   * Each tick first checks the half-open watchdog (see
-   * {@link ManagedSocketState.lastFrameAt}): if no frame at all has arrived
-   * within `heartbeatIntervalMs * 2.5`, the far end has gone quiet without
-   * the socket ever firing `close` — force it closed and report it through
-   * `onWatchdogTrip` (the caller's `onClose`) so the normal reconnect/backoff
-   * takes over instead of every live query on it silently staling forever.
-   * Otherwise it sends a {@link WS_KEEPALIVE_PING} text frame the server
-   * answers from its hibernation auto-response without waking the DO. A
-   * no-op when the heartbeat is disabled (an interval of zero or less);
-   * idempotent — any existing timer is cleared first so a reconnect can't
-   * leak intervals.
-   */
-  private startHeartbeat;
-  /** Clear a connection's keepalive timer, if any. Safe to call repeatedly. */
-  private stopHeartbeat;
   /** Mark every subscription bound to `shardKey` as needing a fresh ack. */
   private markShardPendingAck;
   /**

package/dist/packem_shared/{lunora-client.d-C6lZEDyl.d.ts → lunora-client.d-YjgrrB49.d.ts}

@@ -1,41 +1,6 @@
 import { LunoraErrorCodeInput, LunoraErrorCode } from '@lunora/errors';
 import { F as FunctionReference, A as ArgsOf, R as ReturnOf } from "./function-reference.d-Br_hsKje.js";
 import { CronJobInfo, VectorIndexSummary, VectorQueryMatch, PipelineLogQuery, PipelineLogPage, KvNamespaceSummary, KvKeyListResult, KvValueResult, AuthUser, AuthPage, AuthImpersonation, AuthCapabilities, AuthConfigInfo, AuthSession } from '@lunora/runtime';
-/**
- * Reactive key-value store for local-only client state.
- *
- * Unlike a server {@link SubscriptionState} (which tracks a live WS connection,
- * an `acked` flag, `serverBase`, optimistic layers, and the full subscription
- * machinery), a `ClientQueryRef` is purely local — no server round-trip, no
- * WebSocket, no persistence. It exists so framework adapters can offer a
- * `useClientQuery` hook whose values survive component remounts and are shared
- * across every consumer of the same ref, with none of the ceremony or coupling
- * of a dedicated context provider.
- *
- * The store lives inside `LunoraClient` (a private field) and is surfaced through
- * `client.getClientQuery(ref)` / `setClientQuery(ref, value)` /
- * `subscribeClientQuery(ref, callback)`.
- */
-/** Opaque handle for a typed client-local query slot. */
-interface ClientQueryRef<T = unknown> {
-  /** Default value when no value has been set explicitly. */
-  readonly defaultValue: T;
-  /** Stable identity for the slot. Must be unique within a client instance. */
-  readonly key: string;
-}
-/**
- * Create a typed {@link ClientQueryRef}. Call once per slot at module scope
- * (or inside a component module) — the ref object is the stable identity.
- * @example
- * ```ts
- * // lunora/client-queries.ts
- * import { createClientQuery } from "@lunora/client";
- *
- * export const sidebarOpen = createClientQuery("sidebarOpen", true);
- * export const selectedMessageId = createClientQuery("selectedMessageId", undefined as string | undefined);
- * ```
- */
-declare const createClientQuery: <T>(key: string, defaultValue: T) => ClientQueryRef<T>;
 /**
  * Typed reference to an HTTP-SSE stream route (`httpRoute.<verb>(path).stream()`)
  * emitted by `@lunora/codegen` as `httpStreams.<namespace>.<name>`.
@@ -1397,6 +1362,80 @@ declare class SubscriptionRegistry {
    */
   clear(): void;
 }
+/**
+ * An `Error` carrying the server's machine-readable `code` and (for a
+ * `LunoraError`) structured `data`, plus an optional actionable `hint` (Markdown)
+ * and `docsUrl` resolved from the central error catalog. The client's public
+ * error contract for RPC/batch failures — a UI can render `hint`/`docsUrl` to
+ * tell the user how to fix the error. The `(string & {})` arm keeps
+ * forward-compat/unknown server codes assignable without losing autocomplete on
+ * the known `LunoraErrorCode` union.
+ */
+type LunoraClientError = Error & {
+  code?: LunoraErrorCode | (string & {});
+  data?: unknown;
+  docsUrl?: string;
+  hint?: string | string[];
+};
+/** One demuxed result slot of a `LunoraClient.batch` call. */
+type BatchSlot = {
+  error: LunoraClientError;
+  ok: false;
+} | {
+  ok: true;
+  value: unknown;
+};
+/**
+ * Reactive key-value store for local-only client state.
+ *
+ * Unlike a server {@link SubscriptionState} (which tracks a live WS connection,
+ * an `acked` flag, `serverBase`, optimistic layers, and the full subscription
+ * machinery), a `ClientQueryRef` is purely local — no server round-trip, no
+ * WebSocket, no persistence. It exists so framework adapters can offer a
+ * `useClientQuery` hook whose values survive component remounts and are shared
+ * across every consumer of the same ref, with none of the ceremony or coupling
+ * of a dedicated context provider.
+ *
+ * The store lives inside `LunoraClient` (a private field) and is surfaced through
+ * `client.getClientQuery(ref)` / `setClientQuery(ref, value)` /
+ * `subscribeClientQuery(ref, callback)`.
+ */
+/** Opaque handle for a typed client-local query slot. */
+interface ClientQueryRef<T = unknown> {
+  /** Default value when no value has been set explicitly. */
+  readonly defaultValue: T;
+  /** Stable identity for the slot. Must be unique within a client instance. */
+  readonly key: string;
+}
+/**
+ * Create a typed {@link ClientQueryRef}. Call once per slot at module scope
+ * (or inside a component module) — the ref object is the stable identity.
+ * @example
+ * ```ts
+ * // lunora/client-queries.ts
+ * import { createClientQuery } from "@lunora/client";
+ *
+ * export const sidebarOpen = createClientQuery("sidebarOpen", true);
+ * export const selectedMessageId = createClientQuery("selectedMessageId", undefined as string | undefined);
+ * ```
+ */
+declare const createClientQuery: <T>(key: string, defaultValue: T) => ClientQueryRef<T>;
+type WSState = "idle" | "connecting" | "open" | "closed";
+/**
+ * Aggregate live-socket health across every shard connection, for a UI status
+ * indicator. `idle` = no socket opened yet; `connecting` = at least one socket
+ * is (re)connecting and none is open; `connected` = at least one socket is open;
+ * `polling` = no socket would open, so live queries are being refreshed over HTTP
+ * instead (see `polling-fallback.ts` — live but slower, and shapes
+ * / streams / whispers are dark; mutations go over HTTP as they do while
+ * connected); `offline` = sockets exist but all are down (between reconnect
+ * attempts), and a poll could not reach the origin either.
+ *
+ * `polling` outranks `connecting`: while the fallback is running a reconnect is
+ * still armed in the background, and reporting that attempt would flicker the
+ * indicator between two states while data is in fact arriving on the slow path.
+ */
+type ConnectionStatus = "connected" | "connecting" | "idle" | "offline" | "polling";
 /**
  * Read/write handle over the client's live query cache, handed to a mutation's
  * `withOptimisticUpdate` callback so a single mutation can optimistically patch
@@ -1450,6 +1489,8 @@ declare const createLocalStore: (subscriptions: SubscriptionRegistry, shardKey:
   rollbacks: (() => void)[];
   store: OptimisticLocalStore;
 };
+/** Callback a shape subscription invokes with its materialized rowset on every applied poke. */
+type ShapeCallback = (rows: Record<string, unknown>[]) => void;
 declare const DEFAULT_MAX_BUFFER = 1024;
 interface StreamHandle<T = unknown> {
   /** Mark the stream complete (no more chunks); resolves any pending consumer to `done:true`. */
@@ -1482,22 +1523,6 @@ declare const createStream: <T>(options: {
   handle: StreamHandle<T>;
   iterable: StreamIterable<T>;
 };
-type WSState = "idle" | "connecting" | "open" | "closed";
-/**
- * Aggregate live-socket health across every shard connection, for a UI status
- * indicator. `idle` = no socket opened yet; `connecting` = at least one socket
- * is (re)connecting and none is open; `connected` = at least one socket is open;
- * `polling` = no socket would open, so live queries are being refreshed over HTTP
- * instead (see {@link file://./polling-fallback.ts} — live but slower, and shapes
- * / streams / whispers are dark; mutations go over HTTP as they do while
- * connected); `offline` = sockets exist but all are down (between reconnect
- * attempts), and a poll could not reach the origin either.
- *
- * `polling` outranks `connecting`: while the fallback is running a reconnect is
- * still armed in the background, and reporting that attempt would flicker the
- * indicator between two states while data is in fact arriving on the slow path.
- */
-type ConnectionStatus = "connected" | "connecting" | "idle" | "offline" | "polling";
 /** One shard's socket + watermark state in a {@link LunoraClient.debug} snapshot. */
 interface ClientDebugShard {
   /**
@@ -1702,31 +1727,6 @@ type ReplayIdentityVerdict = {
 } | {
   verdict: "unknown";
 };
-/** Callback a shape subscription invokes with its materialized rowset on every applied poke. */
-type ShapeCallback = (rows: Record<string, unknown>[]) => void;
-/**
- * An `Error` carrying the server's machine-readable `code` and (for a
- * `LunoraError`) structured `data`, plus an optional actionable `hint` (Markdown)
- * and `docsUrl` resolved from the central error catalog. The client's public
- * error contract for RPC/batch failures — a UI can render `hint`/`docsUrl` to
- * tell the user how to fix the error. The `(string & {})` arm keeps
- * forward-compat/unknown server codes assignable without losing autocomplete on
- * the known {@link LunoraErrorCode} union.
- */
-type LunoraClientError = Error & {
-  code?: LunoraErrorCode | (string & {});
-  data?: unknown;
-  docsUrl?: string;
-  hint?: string | string[];
-};
-/** One demuxed result slot of a {@link LunoraClient.batch} call (plan 088). */
-type BatchSlot = {
-  error: LunoraClientError;
-  ok: false;
-} | {
-  ok: true;
-  value: unknown;
-};
 /**
  * Lunora browser/edge client. Talks RPC over HTTP and real-time deltas over
  * a single multiplexed WebSocket.
@@ -1761,6 +1761,8 @@ declare class LunoraClient {
   private readonly connectTimeoutMs;
   /** Keepalive cadence (ms); `0` disables the heartbeat. See {@link LunoraClientOptions.heartbeatIntervalMs}. */
   private readonly heartbeatIntervalMs;
+  /** 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. */
   private readonly pollingFallbackAfterFailedAttempts;
   /** Polling-fallback cadence (ms); `0` disables it. See {@link LunoraClientOptions.pollingFallback}. */
@@ -3921,26 +3923,6 @@ declare class LunoraClient {
    * a silent tokenless socket the admin gate would reject.
    */
   private openSocketWithProvidedToken;
-  /**
-   * Construct one WebSocket connection attempt and wire the shared
-   * lifecycle guarantees around it — the fail-fast connect-timeout, the
-   * identity guard that stops a superseded attempt's late `open`/`message`/
-   * `close`/`error` from touching a connection a newer attempt already
-   * owns, and (once open) the keepalive heartbeat with its half-open
-   * watchdog (plan 217). One call opens ONE attempt; the caller owns
-   * reconnect scheduling from `onClose` — mirrors the shard's existing
-   * `ensureSocket` / `handleDisconnect` split, now shared with
-   * `subscribeScheduledJobs` so it stops re-living the bug that split
-   * already fixed once (CLIENT-05).
-   *
-   * The identity guard is `conn.socket !== socket`, re-checked before every
-   * action below. `conn.socket` is reassigned to a new attempt's socket
-   * synchronously — right here, before `open` ever fires — so an older
-   * attempt's guard trips the instant it's superseded, even if its
-   * underlying socket only fires its real `close`/`error` much later. This
-   * ordering is load-bearing: preserve it exactly.
-   */
-  private openManagedSocket;
   /** Construct the shard socket and wire its lifecycle handlers. The connection must already be in the `connecting` state. */
   private openSocket;
   /**
@@ -3949,27 +3931,6 @@ declare class LunoraClient {
    */
   private cancelStream;
   private handleDisconnect;
-  /**
-   * Begin the keepalive heartbeat on an open connection attempt — the only
-   * caller is {@link openManagedSocket}'s own `open` handler, so both the
-   * shard socket and `subscribeScheduledJobs` share this one implementation
-   * instead of each hand-rolling their own (plan 217, generalized).
-   *
-   * Each tick first checks the half-open watchdog (see
-   * {@link ManagedSocketState.lastFrameAt}): if no frame at all has arrived
-   * within `heartbeatIntervalMs * 2.5`, the far end has gone quiet without
-   * the socket ever firing `close` — force it closed and report it through
-   * `onWatchdogTrip` (the caller's `onClose`) so the normal reconnect/backoff
-   * takes over instead of every live query on it silently staling forever.
-   * Otherwise it sends a {@link WS_KEEPALIVE_PING} text frame the server
-   * answers from its hibernation auto-response without waking the DO. A
-   * no-op when the heartbeat is disabled (an interval of zero or less);
-   * idempotent — any existing timer is cleared first so a reconnect can't
-   * leak intervals.
-   */
-  private startHeartbeat;
-  /** Clear a connection's keepalive timer, if any. Safe to call repeatedly. */
-  private stopHeartbeat;
   /** Mark every subscription bound to `shardKey` as needing a fresh ack. */
   private markShardPendingAck;
   /**

package/dist/packem_shared/{preload.d-CdYylQeH.d.ts → preload.d-BTB4TAd_.d.ts}

@@ -1,4 +1,4 @@
-import { L as LunoraClient, P as Preloaded } from "./lunora-client.d-C6lZEDyl.js";
+import { L as LunoraClient, P as Preloaded } from "./lunora-client.d-YjgrrB49.js";
 import { F as FunctionReference, A as ArgsOf, R as ReturnOf } from "./function-reference.d-Br_hsKje.js";
 /**
  * Run a query once on the server (during SSR) and capture its result in a

package/dist/packem_shared/{preload.d-Cf8tiYKi.d.mts → preload.d-Cenry5u_.d.mts}

@@ -1,4 +1,4 @@
-import { L as LunoraClient, P as Preloaded } from "./lunora-client.d-DDVPWV7D.mjs";
+import { L as LunoraClient, P as Preloaded } from "./lunora-client.d-SHCNd1Cn.mjs";
 import { F as FunctionReference, A as ArgsOf, R as ReturnOf } from "./function-reference.d-Br_hsKje.mjs";
 /**
  * Run a query once on the server (during SSR) and capture its result in a

package/dist/packem_shared/wire-errors-8iZTTKRN.mjs

@@ -0,0 +1 @@
+import{LunoraError as i}from"@lunora/errors";import{d as c}from"./wire-codec-3Mj5UgNj.mjs";import{getRetryAfterMs as d,TransportError as u}from"./CONFLICT_ERROR_CODE-B7qNZMMk.mjs";const f=r=>{if(r===null)return;const t=Number(r);if(Number.isFinite(t))return t>0?t*1e3:void 0;const e=Date.parse(r);if(Number.isNaN(e))return;const o=e-Date.now();return o>0?o:void 0},v=(r,t)=>{const e=f(t);if(!(e===void 0||d(r)!==void 0))return r.data===void 0?{retryAfterMs:e}:typeof r.data=="object"&&r.data!==null&&!Array.isArray(r.data)?{...r.data,retryAfterMs:e}:void 0},l=r=>{const t=r?.error;return typeof t=="object"&&t!==null&&!Array.isArray(t)?t:void 0},m=()=>new u("LunoraClient: batch slot carried no error envelope"),s=(r,t)=>{const e=r.error,o=typeof e?.code=="string"?e.code:void 0,a=typeof e?.message=="string"?e.message:void 0;return{code:o,messageText:(typeof r.message=="string"?r.message:void 0)??a??t}},g=r=>{const{code:t,messageText:e}=s(r,"stream error");return t===void 0?new Error(e):new i(t,e)},A=r=>{const{code:t,messageText:e}=s(r,"subscription error");return{message:e,...t===void 0?{}:{code:t}}},n=r=>{const t=new Error(r.message??"request failed");if(t.code=r.code,r.data!==void 0)try{t.data=c(r.data)}catch{}return r.hint!==void 0&&(t.hint=r.hint),r.docsUrl!==void 0&&(t.docsUrl=r.docsUrl),t},y=(r,t)=>{const e=n(r),o=v(e,t);return o!==void 0&&(e.data=o),e},h=r=>{const t=l(r);return t===void 0?m():n(t)};export{n as a,y as b,g as c,A as d,l as e,f as r,h as s};

package/dist/query/index.d.mts

@@ -1,4 +1,4 @@
-import { S as SubscriptionError, L as LunoraClient, a as Unsubscribe } from "../packem_shared/lunora-client.d-DDVPWV7D.mjs";
+import { S as SubscriptionError, L as LunoraClient, a as Unsubscribe } from "../packem_shared/lunora-client.d-SHCNd1Cn.mjs";
 export type {
 /**
  * `@lunora/client/query` — the framework-neutral live-query state machine shared
@@ -10,7 +10,7 @@ export type {
  * framework — each adapter supplies thin sinks that write into its own ref /
  * store / signal / cache.
  */
-b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-DDVPWV7D.mjs";
+b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-SHCNd1Cn.mjs";
 import { F as FunctionReference, A as ArgsOf, R as ReturnOf } from "../packem_shared/function-reference.d-Br_hsKje.mjs";
 import '@lunora/errors';
 import '@lunora/runtime';

package/dist/query/index.d.ts

@@ -1,4 +1,4 @@
-import { S as SubscriptionError, L as LunoraClient, a as Unsubscribe } from "../packem_shared/lunora-client.d-C6lZEDyl.js";
+import { S as SubscriptionError, L as LunoraClient, a as Unsubscribe } from "../packem_shared/lunora-client.d-YjgrrB49.js";
 export type {
 /**
  * `@lunora/client/query` — the framework-neutral live-query state machine shared
@@ -10,7 +10,7 @@ export type {
  * framework — each adapter supplies thin sinks that write into its own ref /
  * store / signal / cache.
  */
-b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-C6lZEDyl.js";
+b as SubscriptionErrorCallback } from "../packem_shared/lunora-client.d-YjgrrB49.js";
 import { F as FunctionReference, A as ArgsOf, R as ReturnOf } from "../packem_shared/function-reference.d-Br_hsKje.js";
 import '@lunora/errors';
 import '@lunora/runtime';

package/dist/service.mjs

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

package/dist/ssr/index.d.mts

@@ -1,4 +1,4 @@
-import { P as Preloaded, L as LunoraClient } from "../packem_shared/lunora-client.d-DDVPWV7D.mjs";
+import { P as Preloaded, L as LunoraClient } from "../packem_shared/lunora-client.d-SHCNd1Cn.mjs";
 export type { A as ArgsOf, F as FunctionReference, R as ReturnOf } from "../packem_shared/function-reference.d-Br_hsKje.mjs";
 export {
 /**
@@ -20,7 +20,7 @@ p as preloadQuery,
  * WebSocket or touches a UI framework, so it is safe to import from any SSR
  * loader.
  */
-a as preloadedQueryResult } from "../packem_shared/preload.d-Cf8tiYKi.mjs";
+a as preloadedQueryResult } from "../packem_shared/preload.d-Cenry5u_.mjs";
 import '@lunora/errors';
 import '@lunora/runtime';
 /**

package/dist/ssr/index.d.ts

@@ -1,4 +1,4 @@
-import { P as Preloaded, L as LunoraClient } from "../packem_shared/lunora-client.d-C6lZEDyl.js";
+import { P as Preloaded, L as LunoraClient } from "../packem_shared/lunora-client.d-YjgrrB49.js";
 export type { A as ArgsOf, F as FunctionReference, R as ReturnOf } from "../packem_shared/function-reference.d-Br_hsKje.js";
 export {
 /**
@@ -20,7 +20,7 @@ p as preloadQuery,
  * WebSocket or touches a UI framework, so it is safe to import from any SSR
  * loader.
  */
-a as preloadedQueryResult } from "../packem_shared/preload.d-CdYylQeH.js";
+a as preloadedQueryResult } from "../packem_shared/preload.d-BTB4TAd_.js";
 import '@lunora/errors';
 import '@lunora/runtime';
 /**

package/dist/ssr/index.mjs

@@ -1 +1 @@
-import{getServerSession as o}from"../packem_shared/getServerSession-BaOoo1p6.mjs";import{deserializePreloaded as l,serializePreloaded as t}from"../packem_shared/deserializePreloaded-CEQci6cB.mjs";import{createServerClient as i}from"../packem_shared/createServerClient-HdISrPXa.mjs";import{preloadQuery as s,preloadedQueryResult as f}from"../packem_shared/preloadQuery-uFy24PCR.mjs";export{i as createServerClient,l as deserializePreloaded,o as getServerSession,s as preloadQuery,f as preloadedQueryResult,t as serializePreloaded};
+import{getServerSession as o}from"../packem_shared/getServerSession-BaOoo1p6.mjs";import{deserializePreloaded as l,serializePreloaded as t}from"../packem_shared/deserializePreloaded-CEQci6cB.mjs";import{createServerClient as i}from"../packem_shared/createServerClient-D7zkixlG.mjs";import{preloadQuery as s,preloadedQueryResult as f}from"../packem_shared/preloadQuery-uFy24PCR.mjs";export{i as createServerClient,l as deserializePreloaded,o as getServerSession,s as preloadQuery,f as preloadedQueryResult,t as serializePreloaded};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/client",
-  "version": "1.0.0-alpha.193",
+  "version": "1.0.0-alpha.195",
   "description": "Lunora browser SDK: WebSocket transport, optimistic updates, and an offline mutation queue",
   "keywords": [
     "cloudflare",