@gonvex/client 0.5.1 → 0.5.2-staging.1

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { GonvexErrorReporter } from "./error-reporter.js";
 export type { ErrorReporterOptions, ErrorEventPayload, ErrorContext, ErrorAccount } from "./error-reporter.js";
 import { type OptimisticPatch, type OptimisticTransactionDefinition } from "./optimistic.js";
 import { type OutboxStore } from "./outbox.js";
-import { type LocalReplicaStorage, type LocalReplicaView, type ReplicaRow, type LiveQueryResult, type ReplicaCollectionState } from "./local-replica.js";
+import { type LocalReplicaStorage, type LocalReplicaView, type ReplicaRow, type LiveQueryResult, type ReplicaCollectionState, type ReplicaCollectionSubscriptionState, type ReplicaCollectionPlan } from "./local-replica.js";
 import { type LiveQueryPlan, type OfflineLiveQueryResult } from "./query-expression.js";
 export * from "./error-reporter.js";
 export * from "./optimistic.js";
@@ -12,7 +12,7 @@ export * from "./outbox.js";
 export * from "./kv-stores.js";
 export * from "./signals.js";
 export * from "./external-auth.js";
-export { MemoryLocalReplicaStorage, type LocalReplicaStorage, type LocalReplicaView, type ReplicaChange, type ReplicaFreshness, type ReplicaRow, type ReplicaScope, type ReplicaSnapshot, type ReplicaTransaction, type ReplicaWindow, type LiveQueryResult, type ReplicaCollectionState, } from "./local-replica.js";
+export { MemoryLocalReplicaStorage, type LocalReplicaStorage, type LocalReplicaView, type ReplicaChange, type ReplicaFreshness, type ReplicaRow, type ReplicaScope, type ReplicaSnapshot, type ReplicaTransaction, type ReplicaWindow, type LiveQueryResult, type ReplicaCollectionState, type ReplicaCollectionSubscriptionState, type ReplicaCollectionPlan, } from "./local-replica.js";
 export * from "./query-expression.js";
 export * from "./indexeddb-replica.js";
 export * from "./control.js";
@@ -55,11 +55,17 @@ export type FunctionReference<Args extends JsonValue = JsonValue, Result extends
         resultPath?: readonly string[];
         plan: LiveQueryPlan;
     };
+    replica?: ReplicaCollectionPlan & {
+        columns?: readonly string[];
+        mode?: "eager" | "progressive";
+        maxRows?: number;
+        maxBytes?: number;
+    };
     optimistic?: {
         transaction?: OptimisticTransactionDefinition;
     };
 };
-export type GonvexClientErrorCode = "server" | "timeout" | "disconnected" | "closed" | "auth";
+export type GonvexClientErrorCode = "server" | "timeout" | "disconnected" | "closed" | "auth" | "superseded";
 /**
  * Typed error for every rejected Gonvex operation. `code` distinguishes
  * server-side failures from transport-level ones so apps can decide whether
@@ -72,6 +78,8 @@ export type GonvexClientErrorCode = "server" | "timeout" | "disconnected" | "clo
  *   Reducers/actions fail closed unless a reducer opted into the outbox.
  * - `closed`: the client was explicitly closed.
  * - `auth`: authentication was rejected.
+ * - `superseded`: the operation belonged to an authentication scope that the
+ *   caller replaced before the operation completed.
  */
 export declare class GonvexClientError extends Error {
     readonly code: GonvexClientErrorCode;
@@ -204,6 +212,9 @@ export declare class GonvexClient {
     private activeArtifactHashValue;
     private auth;
     private authInFlight;
+    private latestAuthFrameId;
+    private activeAuthFrameId;
+    private authResendRequired;
     private authWatchdogTimer;
     private authFetchGeneration;
     private authRetriedAfterError;
@@ -216,6 +227,8 @@ export declare class GonvexClient {
     private readonly replica;
     private readonly replicaView;
     private readonly optimisticReducerIds;
+    /** Reducers currently owned by the foreground send path, never by recovery. */
+    private readonly directOutboxReducerIds;
     private readonly optimisticOutboxEntryIds;
     private outboxReady;
     private outboxScope;
@@ -224,7 +237,11 @@ export declare class GonvexClient {
     private replicaScope;
     private hasAuthoritativeReplicaScope;
     private replicaReady;
+    private replicaFrames;
+    private processedReplicaWatermarkRevision;
+    private readonly pendingReplicaTransactions;
     private readonly unsubscribeOutbox;
+    private readonly unsubscribeBrowserOnline;
     private drainingOutbox;
     private outboxDrainTimer;
     private readonly sessionScopeHandlers;
@@ -232,6 +249,7 @@ export declare class GonvexClient {
     private reconnectTimer;
     private reconnectAttempt;
     private socketGeneration;
+    private authenticatedSocketGeneration;
     private manuallyClosed;
     private readonly pendingCalls;
     private readonly connectionStateHandlers;
@@ -302,7 +320,7 @@ export declare class GonvexClient {
     /** Watch a bounded Replica Collection through the normalized Local Replica. */
     watchReplica<T extends JsonValue = JsonValue, Args extends JsonValue = JsonValue>(ref: FunctionReference<Args, T>, args?: Args): {
         localReplicaResult: () => T[] | undefined;
-        localReplicaState: () => ReplicaCollectionState | undefined;
+        localReplicaState: () => ReplicaCollectionSubscriptionState | undefined;
         status: () => {
             isLoading: boolean;
             isUpToDate: boolean;
@@ -319,6 +337,9 @@ export declare class GonvexClient {
         onUpdate(handler: WatchUpdateHandler): () => void;
     };
     private handleReplicaMessage;
+    private enqueueReplicaFrame;
+    private enqueueReplicaTransaction;
+    private drainPendingReplicaTransactions;
     private acceptReplicaReady;
     private handleReplicaWatermark;
     private emitReplicaMessage;
@@ -350,6 +371,7 @@ export declare class GonvexClient {
     }): Promise<T | QueuedReducerOutcome>;
     reducer<T extends JsonValue = JsonValue, Args extends JsonValue = JsonValue>(ref: FunctionReference<Args, T>, args?: Args, options?: CallOptions): Promise<T>;
     private runOptimisticReducer;
+    private canSendReducerNow;
     action<T extends JsonValue = JsonValue, Args extends JsonValue = JsonValue>(ref: FunctionReference<Args, T>, args?: Args, options?: CallOptions): Promise<T>;
     query<T extends JsonValue = JsonValue, Args extends JsonValue = JsonValue>(ref: FunctionReference<Args, T>, args?: Args, options?: CallOptions): Promise<T>;
     /**