@korajs/sync 1.0.0-beta.4 → 1.0.0-beta.5

package/dist/internal.d.cts

@@ -1,4 +1,4 @@
-import { c as SyncTransport, T as TransportOptions, a as SyncMessage, d as TransportMessageHandler, e as TransportCloseHandler, f as TransportErrorHandler, Q as QueueStorage } from './transport-BGr-_eH8.cjs';
+import { c as SyncTransport, T as TransportOptions, a as SyncMessage, d as TransportMessageHandler, e as TransportCloseHandler, f as TransportErrorHandler, Q as QueueStorage } from './transport-DXmZ8kyI.cjs';
 import { Operation } from '@korajs/core';
 
 /**

package/dist/internal.d.ts

@@ -1,4 +1,4 @@
-import { c as SyncTransport, T as TransportOptions, a as SyncMessage, d as TransportMessageHandler, e as TransportCloseHandler, f as TransportErrorHandler, Q as QueueStorage } from './transport-BGr-_eH8.js';
+import { c as SyncTransport, T as TransportOptions, a as SyncMessage, d as TransportMessageHandler, e as TransportCloseHandler, f as TransportErrorHandler, Q as QueueStorage } from './transport-DXmZ8kyI.js';
 import { Operation } from '@korajs/core';
 
 /**

package/dist/{transport-BGr-_eH8.d.cts → transport-DXmZ8kyI.d.cts}

@@ -193,6 +193,23 @@ interface SyncStatePersistence {
     /** Resume position for paginated initial sync (optional). */
     loadDeltaCursor?(): Promise<DeltaCursor | null>;
     saveDeltaCursor?(cursor: DeltaCursor | null): Promise<void>;
+    /**
+     * The delivery watermark for a sync view, keyed by an opaque view signature (the auth
+     * scope plus active query subscriptions). Persisted per view so a restarted client
+     * resumes each view's gap-free stream from the right point, and switching views does not
+     * re-sync a view already synced. The empty-string signature is the default, unfiltered
+     * view. Optional: a persistence layer that omits these falls back to re-sync on restart.
+     */
+    loadDeliveryWatermark?(signature: string): Promise<number>;
+    saveDeliveryWatermark?(signature: string, watermark: number): Promise<void>;
+    /** Load every persisted view watermark, keyed by signature. */
+    loadAllDeliveryWatermarks?(): Promise<Record<string, number>>;
+    /**
+     * Delete a persisted view watermark. Used to bound the number of stored view watermarks
+     * (a cold view is evicted from the client's cache and its persisted row removed). Safe:
+     * an evicted view back-fills from 0 (deduplicated) when next visited.
+     */
+    deleteDeliveryWatermark?(signature: string): Promise<void>;
 }
 /**
  * Interface for persisting the outbound operation queue.
@@ -328,6 +345,14 @@ interface HandshakeMessage {
     deltaCursor?: string;
     /** Live query filters that further narrow synced data within auth/schema scope */
     syncQueries?: SyncQuerySubset[];
+    /**
+     * The client's persisted delivery watermark: the highest server delivery sequence
+     * up to which it has contiguously applied every in-scope operation. Omitted (or 0)
+     * on first sync. When present, the server resumes the gap-free server->client
+     * stream from just after it, superseding the version-vector delta and the resume
+     * cursor for the server->client direction. Optional, so old servers ignore it.
+     */
+    lastDeliverySequence?: number;
 }
 /**
  * Server response to a handshake.
@@ -355,6 +380,13 @@ interface HandshakeResponseMessage {
      * available to other devices even after the authoring device goes offline.
      */
     blobStorageEnabled?: boolean;
+    /**
+     * The server's highest delivery sequence at handshake time. A client whose
+     * persisted delivery watermark exceeds this (the server's operation log was rolled
+     * back, for example by a backup restore) resets its watermark to 0 so it resyncs
+     * from the beginning instead of sitting above a frontier that no longer exists.
+     */
+    serverMaxDeliverySequence?: number;
 }
 /**
  * Batch of operations sent during delta exchange or streaming.
@@ -371,6 +403,20 @@ interface OperationBatchMessage {
     cursor?: string;
     /** Total batches in this delta exchange (for progress reporting) */
     totalBatches?: number;
+    /**
+     * Delivery-watermark chaining (server->client). `baseDeliverySequence` is the
+     * delivery sequence the client must already hold for this batch to apply in order
+     * (it equals the previous batch's `maxDeliverySequence`, or the client's reported
+     * watermark for the first batch after a handshake). `maxDeliverySequence` is the
+     * highest delivery sequence carried by this batch. The client applies the batch
+     * only when its watermark equals `baseDeliverySequence`, then advances the
+     * watermark to `maxDeliverySequence`. A dropped batch breaks the chain and stalls
+     * the watermark, so the reconnect resend recovers it. Present only on batches the
+     * server sends as part of the delivery stream; absent on legacy version-vector
+     * batches.
+     */
+    baseDeliverySequence?: number;
+    maxDeliverySequence?: number;
 }
 /**
  * Acknowledgment of a received message.
@@ -380,6 +426,12 @@ interface AcknowledgmentMessage {
     messageId: string;
     acknowledgedMessageId: string;
     lastSequenceNumber: number;
+    /**
+     * The acknowledged batch's `maxDeliverySequence`, echoed so the server can advance
+     * this client's durable delivery watermark. Present only when acking a delivery-
+     * stream batch. `lastSequenceNumber` stays for existing per-node behavior.
+     */
+    deliverySequence?: number;
 }
 /**
  * Error message from the server or client.

package/dist/{transport-BGr-_eH8.d.ts → transport-DXmZ8kyI.d.ts}

@@ -193,6 +193,23 @@ interface SyncStatePersistence {
     /** Resume position for paginated initial sync (optional). */
     loadDeltaCursor?(): Promise<DeltaCursor | null>;
     saveDeltaCursor?(cursor: DeltaCursor | null): Promise<void>;
+    /**
+     * The delivery watermark for a sync view, keyed by an opaque view signature (the auth
+     * scope plus active query subscriptions). Persisted per view so a restarted client
+     * resumes each view's gap-free stream from the right point, and switching views does not
+     * re-sync a view already synced. The empty-string signature is the default, unfiltered
+     * view. Optional: a persistence layer that omits these falls back to re-sync on restart.
+     */
+    loadDeliveryWatermark?(signature: string): Promise<number>;
+    saveDeliveryWatermark?(signature: string, watermark: number): Promise<void>;
+    /** Load every persisted view watermark, keyed by signature. */
+    loadAllDeliveryWatermarks?(): Promise<Record<string, number>>;
+    /**
+     * Delete a persisted view watermark. Used to bound the number of stored view watermarks
+     * (a cold view is evicted from the client's cache and its persisted row removed). Safe:
+     * an evicted view back-fills from 0 (deduplicated) when next visited.
+     */
+    deleteDeliveryWatermark?(signature: string): Promise<void>;
 }
 /**
  * Interface for persisting the outbound operation queue.
@@ -328,6 +345,14 @@ interface HandshakeMessage {
     deltaCursor?: string;
     /** Live query filters that further narrow synced data within auth/schema scope */
     syncQueries?: SyncQuerySubset[];
+    /**
+     * The client's persisted delivery watermark: the highest server delivery sequence
+     * up to which it has contiguously applied every in-scope operation. Omitted (or 0)
+     * on first sync. When present, the server resumes the gap-free server->client
+     * stream from just after it, superseding the version-vector delta and the resume
+     * cursor for the server->client direction. Optional, so old servers ignore it.
+     */
+    lastDeliverySequence?: number;
 }
 /**
  * Server response to a handshake.
@@ -355,6 +380,13 @@ interface HandshakeResponseMessage {
      * available to other devices even after the authoring device goes offline.
      */
     blobStorageEnabled?: boolean;
+    /**
+     * The server's highest delivery sequence at handshake time. A client whose
+     * persisted delivery watermark exceeds this (the server's operation log was rolled
+     * back, for example by a backup restore) resets its watermark to 0 so it resyncs
+     * from the beginning instead of sitting above a frontier that no longer exists.
+     */
+    serverMaxDeliverySequence?: number;
 }
 /**
  * Batch of operations sent during delta exchange or streaming.
@@ -371,6 +403,20 @@ interface OperationBatchMessage {
     cursor?: string;
     /** Total batches in this delta exchange (for progress reporting) */
     totalBatches?: number;
+    /**
+     * Delivery-watermark chaining (server->client). `baseDeliverySequence` is the
+     * delivery sequence the client must already hold for this batch to apply in order
+     * (it equals the previous batch's `maxDeliverySequence`, or the client's reported
+     * watermark for the first batch after a handshake). `maxDeliverySequence` is the
+     * highest delivery sequence carried by this batch. The client applies the batch
+     * only when its watermark equals `baseDeliverySequence`, then advances the
+     * watermark to `maxDeliverySequence`. A dropped batch breaks the chain and stalls
+     * the watermark, so the reconnect resend recovers it. Present only on batches the
+     * server sends as part of the delivery stream; absent on legacy version-vector
+     * batches.
+     */
+    baseDeliverySequence?: number;
+    maxDeliverySequence?: number;
 }
 /**
  * Acknowledgment of a received message.
@@ -380,6 +426,12 @@ interface AcknowledgmentMessage {
     messageId: string;
     acknowledgedMessageId: string;
     lastSequenceNumber: number;
+    /**
+     * The acknowledged batch's `maxDeliverySequence`, echoed so the server can advance
+     * this client's durable delivery watermark. Present only when acking a delivery-
+     * stream batch. `lastSequenceNumber` stays for existing per-node behavior.
+     */
+    deliverySequence?: number;
 }
 /**
  * Error message from the server or client.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@korajs/sync",
-  "version": "1.0.0-beta.4",
+  "version": "1.0.0-beta.5",
   "description": "Sync protocol and transports for Kora.js with delta sync, causal ordering, and automatic reconnection",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -34,8 +34,8 @@
   ],
   "dependencies": {
     "protobufjs": "^8.0.1",
-    "@korajs/core": "1.0.0-beta.4",
-    "@korajs/merge": "1.0.0-beta.4"
+    "@korajs/merge": "1.0.0-beta.5",
+    "@korajs/core": "1.0.0-beta.5"
   },
   "devDependencies": {
     "@fast-check/vitest": "0.2.0",