@loro-dev/streams-crdt 0.15.1 → 0.16.1

package/dist/{stream-id-CVCOLgSp.d.ts → stream-id-DEOH5LmQ.d.ts}

@@ -470,7 +470,7 @@ interface StreamsCrdtShardUrlsOptions {
    * Origin URLs used for `GET <stream>/bootstrap`.
    *
    * Each entry should be an origin URL such as
-   * `https://control-a.api.streams-api-x.loro.dev`. The transport keeps the
+   * `https://control-a.streams.example.com`. The transport keeps the
    * stream path and query from `streamUrl` and only replaces the request origin.
    * If omitted, `other` is used as the fallback pool for bootstrap requests.
    */
@@ -532,6 +532,13 @@ interface PayloadProtectionContext {
   readonly protocol: "loro-streams-crdt-payload-protection";
   readonly version: 2;
   readonly kind: PayloadProtectionKind;
+  /**
+   * Opaque Durable Streams continuation offset for `kind: "snapshot"`.
+   * Absent for `update_batch`. streams-crdt does not parse the token, bind
+   * bucket/Org/role, or treat it as a timestamp. Providers that authenticate
+   * snapshot position MUST bind this exact string.
+   */
+  readonly continuationOffset?: string;
 }
 interface PayloadProtectionSealInput {
   readonly plaintext: Uint8Array;
@@ -719,6 +726,15 @@ interface EphemeralStreamAdaptor {
   applyRemoteUpdates(updates: readonly Uint8Array[]): MaybePromise<void>;
   /** Subscribes to local ephemeral updates. Returns an unsubscribe function. */
   subscribeLocalUpdates(listener: (update: Uint8Array) => void): () => void;
+  /**
+   * Optional. Returns the single key a local update writes (set or delete),
+   * or `undefined` when it writes several keys or the key is unknown. The
+   * write queue then drops a queued, not yet sent update once a newer update
+   * for the same key is queued, so a burst on one key cannot delay others.
+   * Only return a key when a newer update for it fully replaces the older
+   * one for every receiver. Bodies are still sent exactly as emitted.
+   */
+  localUpdateKey?(update: Uint8Array): string | undefined;
 }
 interface EphemeralStreamJoinParams {
   /** Called when the live ephemeral subscription status changes. */
@@ -1129,7 +1145,10 @@ declare class StreamsCrdt<TVersion extends JsonObject> implements StreamsCrdtLik
    */
   private salvageLocalBacklogOnIncompleteInitialSync;
   private syncOnce;
+  /** Caller owns opQueue; never wait for the background flush from here. */
+  private syncOnceExclusive;
   private performInitialJoinSync;
+  private performInitialJoinSyncExclusive;
   private createInitialCursor;
   private resolveInitialRemoteState;
   private resolvePullOnlyRemoteState;
@@ -1229,6 +1248,12 @@ declare class StreamsCrdt<TVersion extends JsonObject> implements StreamsCrdtLik
   private drainQueuedBatch;
   private drainPendingBatch;
   private drainPendingWriteOnlyBatch;
+  /**
+   * One FIFO transaction, called only while holding opQueue. Selecting the
+   * head and committing its ACK/count must share the lock: sync may drain
+   * the queue while a background writer is queued or sleeping between retries.
+   */
+  private flushPendingLocalBatchExclusive;
   /**
    * Drains `pendingLocal` to the server in strict FIFO order.
    *
@@ -1331,7 +1356,21 @@ declare class EphemeralStreamCrdt {
   private runReadLoop;
   private enqueueLocal;
   private flushPendingLocal;
-  private notifySyncWaiters;
+  private localUpdateKey;
+  /**
+   * Pops superseded entries off the head and returns the next entry to send,
+   * marking it in-flight so later same-key updates queue behind it.
+   */
+  private nextPendingLocal;
+  /** Drops superseded markers once they dominate the queue (amortized O(1)). */
+  private maybeRebuildPendingLocal;
+  /**
+   * Completes waiters that tracked `chainId`. Each chain is acknowledged
+   * exactly once (its entry is never superseded after it goes in flight), so
+   * a waiter resolves only after every chain live at call time has had its
+   * latest value acknowledged.
+   */
+  private notifyChainAcknowledged;
   private rejectSyncWaiters;
   private setReadStatus;
   private setWriteStatus;
@@ -1365,4 +1404,4 @@ declare class PayloadProtectionError extends Error {
 declare function isValidRillId(id: string): boolean;
 //#endregion
 export { WriteOnlyAppendResult as $, PayloadProtectionProviderConfig as A, StreamsAuthProvider as B, LocalSyncStats as C, PayloadProtectionOpenInput as D, PayloadProtectionKind as E, Result as F, TransportCreateStreamSuccess as G, StreamsCrdtShardUrlsOptions as H, SnapshotCodec as I, TransportJoinParams as J, TransportDeleteStreamSuccess as K, SnapshotTransformHook as L, PayloadProtectionSealInput as M, PayloadProtectionSealResult as N, PayloadProtectionOptions as O, PayloadProtectionWritePolicy as P, TransportSyncSuccess as Q, SnapshotUploadOptions as R, JsonValue as S, PayloadProtectionFailureReason as T, TransportCatchupParams as U, StreamsCrdtOptions as V, TransportCatchupSuccess as W, TransportSnapshotUploadSuccess as X, TransportRoomStatus as Y, TransportSubscription as Z, EphemeralStreamCrdtOptions as _, StreamsCrdt as a, RemoteCursor as at, IsolatedCrdtAdapter as b, CrdtApplyReturn as c, createInitialRemoteCursor as ct, E2eeOptions as d, BeforeRemoteCursorSaveContext as et, E2eeProvider as f, EphemeralStreamAdaptor as g, E2eeWritePolicy as h, EphemeralStreamCrdt as i, IndexedDbRemoteCursorStoreOptions as it, PayloadProtectionReadPolicy as j, PayloadProtectionProvider as k, CrdtUnresolvedSpan as l, E2eeReadPolicy as m, PayloadProtectionError as n, InMemoryRemoteCursorStore as nt, CrdtAdapter as o, RemoteCursorSaveSource as ot, E2eeProviderConfig as p, TransportError as q, LocalAppendFailedError as r, IndexedDbRemoteCursorStore as rt, CrdtApplyOutcome as s, RemoteCursorStore as st, isValidRillId as t, BeforeRemoteCursorSaveHook as tt, CrdtUpdateBatch as u, EphemeralStreamJoinParams as v, PayloadProtectionContext as w, JsonObject as x, EphemeralStreamSubscription as y, StreamsAuthContext as z };
-//# sourceMappingURL=stream-id-CVCOLgSp.d.ts.map
+//# sourceMappingURL=stream-id-DEOH5LmQ.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@loro-dev/streams-crdt",
   "description": "Transport/runtime layer for synchronizing CRDT state over Durable Streams.",
-  "version": "0.15.1",
+  "version": "0.16.1",
   "license": "MIT",
   "author": "Loro Team",
   "homepage": "https://streams.loro.dev",
@@ -50,7 +50,7 @@
     }
   },
   "dependencies": {
-    "@loro-dev/streams-client": "0.7.0"
+    "@loro-dev/streams-client": "0.8.0"
   },
   "peerDependencies": {
     "@loro-dev/flock-wasm": "^0.4.0",