@gonvex/client 0.5.2-staging.14 → 0.5.2-staging.15

package/README.md

@@ -259,6 +259,55 @@ Reducer also declares optimistic UI metadata. Actions are never queued.
 Deterministic server errors are never queued and always roll an optimistic
 entity overlay back when one exists.
 
+### Queued intent lifecycle
+
+Runtimes from 0.5.2-staging.15 classify every `reducer.error` as `rejected`,
+`transient`, `update_required` or `unauthenticated` (also exposed as
+`GonvexClientError.errorClass` / `retryable`). The outbox acts on it:
+
+| Class | Outbox behaviour |
+| --- | --- |
+| `transient` (and timeouts) | Retry with exponential backoff. After `outbox.retry.maxAttempts` (default 10, backoff capped at `maxBackoffMs`, default 60s) the intent is parked as `failed`: kept durably with its prediction, and no longer blocking later intents. |
+| `unauthenticated` | Keep the intent, re-authenticate, retry. Does not spend the retry budget. |
+| `update_required` | Keep the intent pending and call `onUpdateRequired`. |
+| `rejected` | Roll the prediction back, rebase later local intents, fire `onReducerRejection`, and keep the intent as a `rejected` record until the app discards or retries it. |
+
+Older runtimes send no class: their errors are treated as rejections, except
+the legacy stale-artifact and "authenticate with an active tenant" messages.
+
+```ts
+const intents = await client.listIntents();       // or subscribeIntents()/intentsSnapshot()
+client.entityIntentStatus("tasks", taskId);       // "syncing" | "failed" | "rejected" | undefined
+await client.retryIntent(intent.id);              // same idempotency key, fresh budget
+await client.discardIntent(intent.id);            // pending/failed/rejected only
+await client.listOutboxScopes();                  // includes identities that never returned
+await client.purgeForeignOutboxScopes();          // never automatic
+```
+
+`@gonvex/react` exposes the same list through `useOutboxIntents()` and a
+per-row `useEntityIntentStatus(entity, id)`.
+
+### Resetting the local cache
+
+`client.resetLocalReplica({ keepOutbox = true })` implements a "Clear cache"
+setting without the app touching replica storage. It deletes the active
+identity's persisted replica rows (IndexedDB, Expo SQLite, or the configured
+storage), keeps the saved offline session, closes and re-opens every active
+Replica Collection and Live Query without cursors, and re-applies the
+predictions of all live intents so they reappear on top of the fresh
+snapshots. Pending, failed and rejected intents are kept unless
+`keepOutbox: false` is passed explicitly (inflight intents are never dropped).
+
+It is **online only**: offline (or before the socket is authenticated) it
+rejects with `GonvexClientError` `code: "disconnected"` and changes nothing,
+so the user is never left with an empty cache that cannot be refilled. React
+apps can use `useResetLocalReplica()` for `{ reset, isResetting, error }`.
+
+A parked intent lets later intents proceed; the server validates each of them
+on its own, so an intent that depended on the parked one is rejected rather
+than applied out of order. Retrying a parked intent after later intents
+committed re-applies it on top of them.
+
 Live Queries persist their last verified window in the Local Replica and
 resubscribe after reconnect. Call `client.retryLiveQuery(ref, args)` to force a
 re-request after a server error. `useQueryResult` is for one-shot Queries.

package/dist/client-upgrades.js

@@ -32,7 +32,8 @@ export function migrateClientData(snapshots, entries, chain) {
             return { ...entry, path: intent.path, args: intent.args,
                 receiptPath: originalPath, patches: [],
                 // Committed responses awaiting a watermark must be reconciled by their original receipt too.
-                state: "pending", nextAttemptAt: 0 };
+                // Parked and rejected records wait for the user; an upgrade must not resend them.
+                state: entry.state === "failed" || entry.state === "rejected" ? entry.state : "pending", nextAttemptAt: 0 };
         });
     }
     return { snapshots: nextSnapshots, entries: nextEntries };

package/dist/client-upgrades.js.map

@@ -1 +1 @@
-{"version":3,"file":"client-upgrades.js","sourceRoot":"","sources":["../src/client-upgrades.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client-upgrades.js","sourceRoot":"","sources":["../src/client-upgrades.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import type { BrowserTelemetryInfo, ExecutionScope, JsonValue, MessageTrace, ServerCapabilities, ServerMessage } from "@gonvex/protocol";
+import type { BrowserTelemetryInfo, ExecutionScope, JsonValue, MessageTrace, ServerCapabilities, ServerMessage, ReducerErrorClass } from "@gonvex/protocol";
 import type { LocalRuntimeBinding } from "@gonvex/local-runtime/worker-client";
 import { type ErrorReporterOptions } from "./error-reporter.js";
 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 OutboxErrorClass, type ReducerOutboxScopeSummary, type ReducerOutboxState, type OutboxStore } from "./outbox.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";
@@ -95,12 +95,86 @@ export declare class GonvexClientError extends Error {
     readonly code: GonvexClientErrorCode;
     readonly path?: string;
     readonly operation?: "query" | "reducer" | "action";
+    /**
+     * For `server` Reducer errors: the runtime's classification, or a legacy
+     * inference when an older runtime sent none. Undefined means a legacy
+     * runtime's unclassified error, which is handled as a rejection.
+     */
+    readonly errorClass?: ReducerErrorClass;
+    /** True when the same call (same idempotency key) may succeed later. */
+    readonly retryable?: boolean;
     constructor(message: string, options: {
         code: GonvexClientErrorCode;
         path?: string;
         operation?: "query" | "reducer" | "action";
+        errorClass?: ReducerErrorClass;
+        retryable?: boolean;
     });
 }
+/** One durable reducer intent, as exposed to application UI. */
+export type OutboxIntent = {
+    /** The reducer id / idempotency key. Stable across retries, reloads and tabs. */
+    id: string;
+    /** Local queue sequence number. Lower numbers were issued first. */
+    entryId: number;
+    reducer: string;
+    state: ReducerOutboxState;
+    /** Failed deliveries counted toward the retry budget. */
+    attempts: number;
+    lastError?: string;
+    errorClass?: OutboxErrorClass;
+    createdAt: number;
+    nextAttemptAt: number;
+    /** When the intent became `failed` or `rejected`. */
+    settledAt?: number;
+    args: unknown;
+    /** Short, display-safe JSON preview of the arguments. */
+    argsSummary: string;
+    /** Rows this intent's optimistic prediction touched (best effort). */
+    entities: Array<{
+        entity: string;
+        id: string;
+    }>;
+};
+/** Per-row delivery status derived from the outbox. */
+export type EntityIntentStatus = "syncing" | "failed" | "rejected";
+export type ReducerRejectionEvent = {
+    reducerId: string;
+    path: string;
+    error: string;
+    errorClass?: OutboxErrorClass;
+};
+export type OutboxScope = ReducerOutboxScopeSummary & {
+    /** True for the identity this client is currently signed in as. */
+    current: boolean;
+};
+export type OutboxRetryOptions = {
+    /**
+     * Counted delivery failures (transient server errors and timeouts) before an
+     * intent is parked as `failed`. Default 10. `Infinity` retries forever.
+     */
+    maxAttempts?: number;
+    /** Cap for the exponential backoff between attempts. Default 60s. */
+    maxBackoffMs?: number;
+};
+export type ResetLocalReplicaOptions = {
+    /**
+     * Keep the durable outbox (default true). Pending, failed and rejected
+     * intents survive the reset and their predictions are re-applied on top of
+     * the rehydrated data. `false` also deletes every intent of the active
+     * identity that is not already inflight or committed; use it only for an
+     * explicit "discard unsynced changes" action.
+     */
+    keepOutbox?: boolean;
+};
+export type ResetLocalReplicaResult = {
+    /** Intents deleted because `keepOutbox: false` was requested. */
+    discardedIntents: number;
+    /** Replica Collections and Live Queries re-requested from the server. */
+    resubscribed: number;
+};
+export declare const DEFAULT_OUTBOX_MAX_ATTEMPTS = 10;
+export declare const DEFAULT_OUTBOX_RETRY_MAX_BACKOFF_MS = 60000;
 export type ConnectionState = {
     isWebSocketConnected: boolean;
     hasEverConnected: boolean;
@@ -191,6 +265,7 @@ export type GonvexClientOptions = GonvexClientAuth & {
         databaseName?: string;
         enabled?: boolean;
         store?: OutboxStore;
+        retry?: OutboxRetryOptions;
     };
     /** Transactional normalized store used by Replica Collections and Live Queries. */
     localReplica?: {
@@ -231,6 +306,12 @@ export declare class GonvexClient {
     private readonly localCollectionKeys;
     private readonly localExecutionTables;
     private readonly reducerRejectionHandlers;
+    private readonly outboxRetry;
+    private unauthenticatedRetries;
+    private intentsSnapshotValue;
+    private readonly intentListeners;
+    private intentsRefreshRunning;
+    private intentsRefreshDirty;
     private socket;
     private readonly handlers;
     private readonly querySubscriptions;
@@ -283,6 +364,8 @@ export declare class GonvexClient {
     private peerRefreshDirty;
     private readonly unsubscribeBrowserOnline;
     private drainingOutbox;
+    /** A wake-up (timer, enqueue, reconnect) that arrived while a drain was running. */
+    private outboxDrainRequested;
     private outboxDrainTimer;
     private readonly sessionScopeHandlers;
     private readonly errorReporter;
@@ -304,12 +387,68 @@ export declare class GonvexClient {
     private updateRequired;
     private lastOnlineAtMs;
     constructor(url: string, options?: GonvexClientOptions);
-    /** Authoritative sync failures arrive after an offline call returned locally. */
-    onReducerRejection(listener: (event: {
-        reducerId: string;
-        path: string;
-        error: string;
-    }) => void): () => void;
+    /**
+     * Authoritative sync failures arrive after an offline call returned locally.
+     * The intent also stays in the outbox as `rejected` until it is discarded
+     * or retried, so a UI that mounts later can still show it.
+     */
+    onReducerRejection(listener: (event: ReducerRejectionEvent) => void): () => void;
+    /** Every durable intent of the current identity, oldest first. */
+    listIntents(): Promise<OutboxIntent[]>;
+    /**
+     * Synchronous snapshot for external stores (React `useSyncExternalStore`).
+     * Kept current while at least one {@link subscribeIntents} listener exists.
+     */
+    intentsSnapshot(): readonly OutboxIntent[];
+    /** Observe intent changes; call {@link intentsSnapshot} for the new value. */
+    subscribeIntents(listener: () => void): () => void;
+    /**
+     * Delivery status for one row from the current snapshot: `failed` or
+     * `rejected` when an intent touching it needs attention, `syncing` while one
+     * is still queued, otherwise undefined.
+     */
+    entityIntentStatus(entity: string, id: string): EntityIntentStatus | undefined;
+    /**
+     * Re-arm a `failed` or `rejected` intent with a fresh retry budget. The
+     * original idempotency key is reused, so an attempt that had actually
+     * committed is replayed by the server rather than applied twice.
+     */
+    retryIntent(id: string): Promise<boolean>;
+    /**
+     * Drop a `pending`, `failed` or `rejected` intent: it will never be sent,
+     * its optimistic prediction is removed and later local intents are rebased.
+     * Inflight and committed intents cannot be discarded. Discarding an intent
+     * whose earlier attempt timed out does not undo a commit that the server
+     * may already have applied; the replica then shows the server's truth.
+     */
+    discardIntent(id: string): Promise<boolean>;
+    /**
+     * Discard the persisted Local Replica of the active identity (IndexedDB,
+     * Expo SQLite or any configured storage) and rehydrate it from the server.
+     *
+     * Online only: without an authenticated connection the call rejects with a
+     * `GonvexClientError` (`code: "disconnected"`) and changes nothing, so the
+     * user is never left with an empty cache that cannot be refilled. The saved
+     * offline session (identity and replica directive) is kept.
+     *
+     * By default the outbox is untouched: pending, failed and rejected intents
+     * stay durable, and the predictions of every live intent are re-applied
+     * immediately and recomputed as server data arrives. Active Replica
+     * Collections and Live Queries are re-requested without their old cursors,
+     * so the server sends full snapshots.
+     */
+    resetLocalReplica(options?: ResetLocalReplicaOptions): Promise<ResetLocalReplicaResult>;
+    /** Outbox owners with durable entries, including identities that never returned. */
+    listOutboxScopes(): Promise<OutboxScope[]>;
+    /**
+     * Permanently delete another identity's durable intents. The active scope
+     * cannot be purged this way; use {@link discardIntent} for its entries.
+     */
+    purgeOutboxScope(scope: string): Promise<number>;
+    /** Purge every outbox scope except the current identity's. Never runs automatically. */
+    purgeForeignOutboxScopes(): Promise<number>;
+    private refreshIntents;
+    private publishIntents;
     private restoreLocalSession;
     private ensureLocalCollections;
     private hydrateMissingLocalTable;
@@ -344,7 +483,7 @@ export declare class GonvexClient {
     offlineLiveQuery<T extends ReplicaRow = ReplicaRow>(ref: FunctionReference, args?: JsonValue, options?: {
         window?: boolean;
     }): OfflineLiveQueryResult<T>;
-    /** Number of reducers waiting for a definitive server result. */
+    /** Number of reducers still queued for delivery (excludes failed and rejected intents). */
     outboxCount(): Promise<number>;
     connectionState(): ConnectionState;
     /** Metadata advertised by the runtime in its latest session.ready frame. */
@@ -443,6 +582,25 @@ export declare class GonvexClient {
     private rejectOptimisticReducer;
     private ackOptimisticReducer;
     private drainOutbox;
+    /**
+     * Record a non-rejection delivery failure and arm the next attempt.
+     * - update_required: keep the intent pending and stop for an app update.
+     * - unauthenticated: keep the intent, re-authenticate, retry with backoff
+     *   that never spends the retry budget.
+     * - network: connectivity loss; retried on reconnect without spending budget.
+     * - transient (and timeouts): exponential backoff, parked as `failed` once
+     *   the retry budget is spent.
+     */
+    private recordDeliveryFailure;
+    /**
+     * Arm a timer for the earliest backed-off entry. Timer clocks and
+     * `Date.now()` can disagree by a millisecond, so a wake-up may find its
+     * entry not quite due; without this the queue would wait for an unrelated
+     * event to resume.
+     */
+    private scheduleNextOutboxAttempt;
+    /** Re-send auth on the open socket so a lost tenant session is restored. */
+    private requestReauthentication;
     private scheduleOutboxDrain;
     reducer<T extends JsonValue = JsonValue, Args extends JsonValue = JsonValue>(ref: FunctionReference<Args, T>, args: Args, options: CallOptions & {
         offline: "queue";
@@ -521,3 +679,5 @@ export declare class GonvexClient {
     private sendNow;
     private flushPendingMessages;
 }
+/** Row status from a list of intents: failed > rejected > syncing. */
+export declare function entityStatusFromIntents(intents: readonly OutboxIntent[], entity: string, id: string): EntityIntentStatus | undefined;