@loro-dev/streams-crdt 0.8.0 → 0.8.2

package/README.md

@@ -118,12 +118,30 @@ const sub = joined.value;
 checked out or detached, call `checkoutToLatest()` or `attach()` before passing
 it to `StreamsCrdt`.
 
+### Loro pending imports and cursor safety
+
+Loro can accept an update whose dependencies are missing and keep it as a
+pending import. Pending imports are not represented in `doc.version()` and are
+not included in snapshots exported from that document. For that reason, the Loro
+adapter must not persist a `RemoteCursor` until all pending imports are resolved
+and the local document is complete at the cursor offset.
+
+The transport may continue reading with an in-memory volatile cursor to find the
+missing dependencies. If the server reports up-to-date while Loro still has
+unresolved imports, the client must bootstrap again and only save the bootstrap
+cursor after the batch import is clean. Snapshot upload is skipped while Loro has
+unresolved imports.
+
+See [`specs/loro-pending.md`](../../specs/loro-pending.md) for the full behavior
+and implementation checklist.
+
 ## Quick Start (Loro EphemeralStore)
 
 Use a separate `EphemeralStreamCrdt` for presence-like Loro `EphemeralStore`
 data. It bootstraps through the first SSE event, posts local ephemeral updates,
-and periodically re-announces `store.encodeAll()` so reconnecting peers can
-recover the current live state without replaying old presence history.
+and never republishes state imported from other peers. If a client needs to keep
+its own presence alive, update that client's own keys with `store.set()` so the
+store emits a fresh local update.
 
 Ephemeral live delivery is latest-state oriented. The server may keep only a
 tiny live fanout queue for current SSE subscribers and may disconnect slow
@@ -155,6 +173,65 @@ const joinedPresence = await presence.join();
 if (!joinedPresence.ok) throw joinedPresence.error;
 ```
 
+### Ephemeral stream URL format
+
+An ephemeral stream URL is the durable stream URL for the same document plus a
+channel query parameter:
+
+```txt
+{baseUrl}/ds/{bucketId}/{streamId}?ephemeral={channel}
+```
+
+For example, if the durable Flock document stream is:
+
+```txt
+https://streams-api.loro.dev/ds/my-bucket/flock-cm9vbS0x
+```
+
+then the matching presence stream is:
+
+```txt
+https://streams-api.loro.dev/ds/my-bucket/flock-cm9vbS0x?ephemeral=presence
+```
+
+Use the same `bucketId` and `streamId` as the durable `StreamsCrdt` room. The
+`ephemeral` value names a side-channel for that room, such as `presence`,
+`cursor`, or `selection`. Different channels under the same durable stream are
+separate in-memory rooms. The compatibility spelling `?awareness=presence` is
+also accepted, but new code should use `?ephemeral=presence`.
+
+When an app exposes a room link such as `/rooms/design-review-42`, the link
+normally maps to one durable stream id first, and both durable and ephemeral
+sync derive from that same id:
+
+```ts
+const roomId = "design-review-42";
+const durableStreamUrl = createStreamUrl({
+  bucketId: "my-bucket",
+  streamId: `flock-${roomId}`,
+});
+
+const presenceStreamUrl = new URL(durableStreamUrl);
+presenceStreamUrl.searchParams.set("ephemeral", "presence");
+
+const flockTransport = new StreamsCrdt({
+  streamUrl: durableStreamUrl,
+  auth,
+  adapter: createFlockAdapter(flock),
+});
+
+const presenceTransport = new EphemeralStreamCrdt({
+  streamUrl: presenceStreamUrl.toString(),
+  auth,
+  adaptor: EphemeralStoreAdaptor(store),
+});
+```
+
+`EphemeralStreamCrdt` does not create or delete the durable stream. It posts
+updates to the ephemeral URL and opens SSE on the same URL with `live=sse`.
+Ephemeral state is not persisted with the Flock document stream; it is scoped by
+the URL path plus channel and is meant for current live state only.
+
 ## Quick Start (Flock)
 
 ```ts
@@ -799,9 +876,13 @@ const transport = new StreamsCrdt({
 - `CrdtAdapter` — adapter contract interface
 - `IsolatedCrdtAdapter` — optional apply-only adapter used for safe 410 recovery
 - `CrdtUpdateBatch` — local update batch type
+- `CrdtApplyOutcome`, `CrdtApplyReturn`, `CrdtUnresolvedSpan` — adapter apply
+  result types used to report incomplete imports such as Loro pending updates
 - `Result` — Rust-style `Ok | Err` result
 - `StreamsAuthProvider` — auth callback type
 - `TransportError` — discriminated error union
+  `apply_incomplete` is returned when remote data was read but the CRDT adapter
+  still has unresolved dependencies and the cursor cannot be saved.
 - `TransportCreateStreamSuccess`, `TransportDeleteStreamSuccess`, `TransportSyncSuccess` — result payloads
 - `TransportJoinParams` — `join()` options
 - `TransportSubscription` — active live subscription handle

package/dist/flock.d.ts

@@ -1,4 +1,4 @@
-import { $ as RemoteCursorStore, A as Result, B as TransportJoinParams, C as PayloadProtectionEncryptionOptions, D as PayloadProtectionReadPolicy, E as PayloadProtectionOptions, F as StreamsAuthProvider, G as WriteOnlyAppendResult, H as TransportSnapshotUploadSuccess, I as StreamsCrdtOptions, J as InMemoryRemoteCursorStore, K as BeforeRemoteCursorSaveContext, L as TransportCreateStreamSuccess, M as SnapshotTransformHook, N as SnapshotUploadOptions, O as PayloadProtectionScope, P as StreamsAuthContext, Q as RemoteCursorSaveSource, R as TransportDeleteStreamSuccess, S as JsonValue, T as PayloadProtectionKeyProvider, U as TransportSubscription, V as TransportRoomStatus, W as TransportSyncSuccess, X as IndexedDbRemoteCursorStoreOptions, Y as IndexedDbRemoteCursorStore, Z as RemoteCursor, _ as EphemeralStreamCrdtOptions, a as EphemeralStreamCrdt, b as IsolatedCrdtAdapter, c as CrdtUpdateBatch, d as E2eeKeyProvider, et as createInitialRemoteCursor, f as E2eeOptions, g as EphemeralStreamAdaptor, h as E2eeWritePolicy, i as PayloadProtectionError, j as SnapshotCodec, k as PayloadProtectionWritePolicy, l as E2eeEncryptionOptions, m as E2eeScope, n as isValidBucketId, o as StreamsCrdt, p as E2eeReadPolicy, q as BeforeRemoteCursorSaveHook, r as isValidRillId, s as CrdtAdapter, t as createStreamUrl, u as E2eeKey, v as EphemeralStreamJoinParams, w as PayloadProtectionKey, x as JsonObject, y as EphemeralStreamSubscription, z as TransportError } from "./stream-id-BXJvwX_O.js";
+import { $ as IndexedDbRemoteCursorStoreOptions, A as PayloadProtectionReadPolicy, B as TransportCreateStreamSuccess, C as IsolatedCrdtAdapter, D as PayloadProtectionKey, E as PayloadProtectionEncryptionOptions, F as SnapshotTransformHook, G as TransportSnapshotUploadSuccess, H as TransportError, I as SnapshotUploadOptions, J as WriteOnlyAppendResult, K as TransportSubscription, L as StreamsAuthContext, M as PayloadProtectionWritePolicy, N as Result, O as PayloadProtectionKeyProvider, P as SnapshotCodec, Q as IndexedDbRemoteCursorStore, R as StreamsAuthProvider, S as EphemeralStreamSubscription, T as JsonValue, U as TransportJoinParams, V as TransportDeleteStreamSuccess, W as TransportRoomStatus, X as BeforeRemoteCursorSaveHook, Y as BeforeRemoteCursorSaveContext, Z as InMemoryRemoteCursorStore, _ as E2eeScope, a as EphemeralStreamCrdt, b as EphemeralStreamCrdtOptions, c as CrdtApplyOutcome, d as CrdtUpdateBatch, et as RemoteCursor, f as E2eeEncryptionOptions, g as E2eeReadPolicy, h as E2eeOptions, i as PayloadProtectionError, j as PayloadProtectionScope, k as PayloadProtectionOptions, l as CrdtApplyReturn, m as E2eeKeyProvider, n as isValidBucketId, nt as RemoteCursorStore, o as StreamsCrdt, p as E2eeKey, q as TransportSyncSuccess, r as isValidRillId, rt as createInitialRemoteCursor, s as CrdtAdapter, t as createStreamUrl, tt as RemoteCursorSaveSource, u as CrdtUnresolvedSpan, v as E2eeWritePolicy, w as JsonObject, x as EphemeralStreamJoinParams, y as EphemeralStreamAdaptor, z as StreamsCrdtOptions } from "./stream-id-Bi5rAZfP.js";
 import { ExportBundle, Flock, VersionVector, VersionVector as VersionVector$1 } from "@loro-dev/flock-wasm";
 
 //#region src/flock.d.ts
@@ -7,5 +7,5 @@ import { ExportBundle, Flock, VersionVector, VersionVector as VersionVector$1 }
  */
 declare function createFlockAdapter(flock: Flock): CrdtAdapter<VersionVector$1>;
 //#endregion
-export { BeforeRemoteCursorSaveContext, BeforeRemoteCursorSaveHook, CrdtAdapter, CrdtUpdateBatch, E2eeEncryptionOptions, PayloadProtectionError as E2eeError, PayloadProtectionError, E2eeKey, E2eeKeyProvider, E2eeOptions, E2eeReadPolicy, E2eeScope, E2eeWritePolicy, EphemeralStreamAdaptor, EphemeralStreamCrdt, EphemeralStreamCrdtOptions, EphemeralStreamJoinParams, EphemeralStreamSubscription, type ExportBundle, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, IndexedDbRemoteCursorStoreOptions, IsolatedCrdtAdapter, JsonObject, JsonValue, PayloadProtectionEncryptionOptions, PayloadProtectionKey, PayloadProtectionKeyProvider, PayloadProtectionOptions, PayloadProtectionReadPolicy, PayloadProtectionScope, PayloadProtectionWritePolicy, RemoteCursor, RemoteCursorSaveSource, RemoteCursorStore, Result, SnapshotCodec, SnapshotTransformHook, SnapshotUploadOptions, StreamsAuthContext, StreamsAuthProvider, StreamsCrdt, StreamsCrdtOptions, TransportCreateStreamSuccess, TransportDeleteStreamSuccess, TransportError, TransportJoinParams, TransportRoomStatus, TransportSnapshotUploadSuccess, TransportSubscription, TransportSyncSuccess, type VersionVector, WriteOnlyAppendResult, createFlockAdapter, createInitialRemoteCursor, createStreamUrl, isValidBucketId, isValidRillId };
+export { BeforeRemoteCursorSaveContext, BeforeRemoteCursorSaveHook, CrdtAdapter, CrdtApplyOutcome, CrdtApplyReturn, CrdtUnresolvedSpan, CrdtUpdateBatch, E2eeEncryptionOptions, PayloadProtectionError as E2eeError, PayloadProtectionError, E2eeKey, E2eeKeyProvider, E2eeOptions, E2eeReadPolicy, E2eeScope, E2eeWritePolicy, EphemeralStreamAdaptor, EphemeralStreamCrdt, EphemeralStreamCrdtOptions, EphemeralStreamJoinParams, EphemeralStreamSubscription, type ExportBundle, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, IndexedDbRemoteCursorStoreOptions, IsolatedCrdtAdapter, JsonObject, JsonValue, PayloadProtectionEncryptionOptions, PayloadProtectionKey, PayloadProtectionKeyProvider, PayloadProtectionOptions, PayloadProtectionReadPolicy, PayloadProtectionScope, PayloadProtectionWritePolicy, RemoteCursor, RemoteCursorSaveSource, RemoteCursorStore, Result, SnapshotCodec, SnapshotTransformHook, SnapshotUploadOptions, StreamsAuthContext, StreamsAuthProvider, StreamsCrdt, StreamsCrdtOptions, TransportCreateStreamSuccess, TransportDeleteStreamSuccess, TransportError, TransportJoinParams, TransportRoomStatus, TransportSnapshotUploadSuccess, TransportSubscription, TransportSyncSuccess, type VersionVector, WriteOnlyAppendResult, createFlockAdapter, createInitialRemoteCursor, createStreamUrl, isValidBucketId, isValidRillId };
 //# sourceMappingURL=flock.d.ts.map

package/dist/flock.js

@@ -1,4 +1,4 @@
-import { a as InMemoryRemoteCursorStore, c as EphemeralStreamCrdt, i as StreamsCrdt, l as PayloadProtectionError, n as isValidBucketId, o as IndexedDbRemoteCursorStore, r as isValidRillId, s as createInitialRemoteCursor, t as createStreamUrl } from "./stream-id-CF1egQDz.js";
+import { a as InMemoryRemoteCursorStore, c as EphemeralStreamCrdt, i as StreamsCrdt, l as PayloadProtectionError, n as isValidBucketId, o as IndexedDbRemoteCursorStore, r as isValidRillId, s as createInitialRemoteCursor, t as createStreamUrl } from "./stream-id-BjmGvObf.js";
 import { Flock } from "@loro-dev/flock-wasm";
 //#region src/flock.ts
 function isAfter(entry, current) {

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { $ as RemoteCursorStore, A as Result, B as TransportJoinParams, C as PayloadProtectionEncryptionOptions, D as PayloadProtectionReadPolicy, E as PayloadProtectionOptions, F as StreamsAuthProvider, G as WriteOnlyAppendResult, H as TransportSnapshotUploadSuccess, I as StreamsCrdtOptions, J as InMemoryRemoteCursorStore, K as BeforeRemoteCursorSaveContext, L as TransportCreateStreamSuccess, M as SnapshotTransformHook, N as SnapshotUploadOptions, O as PayloadProtectionScope, P as StreamsAuthContext, Q as RemoteCursorSaveSource, R as TransportDeleteStreamSuccess, S as JsonValue, T as PayloadProtectionKeyProvider, U as TransportSubscription, V as TransportRoomStatus, W as TransportSyncSuccess, X as IndexedDbRemoteCursorStoreOptions, Y as IndexedDbRemoteCursorStore, Z as RemoteCursor, _ as EphemeralStreamCrdtOptions, a as EphemeralStreamCrdt, b as IsolatedCrdtAdapter, c as CrdtUpdateBatch, d as E2eeKeyProvider, et as createInitialRemoteCursor, f as E2eeOptions, g as EphemeralStreamAdaptor, h as E2eeWritePolicy, i as PayloadProtectionError, j as SnapshotCodec, k as PayloadProtectionWritePolicy, l as E2eeEncryptionOptions, m as E2eeScope, n as isValidBucketId, o as StreamsCrdt, p as E2eeReadPolicy, q as BeforeRemoteCursorSaveHook, r as isValidRillId, s as CrdtAdapter, t as createStreamUrl, u as E2eeKey, v as EphemeralStreamJoinParams, w as PayloadProtectionKey, x as JsonObject, y as EphemeralStreamSubscription, z as TransportError } from "./stream-id-BXJvwX_O.js";
-export { BeforeRemoteCursorSaveContext, BeforeRemoteCursorSaveHook, CrdtAdapter, CrdtUpdateBatch, E2eeEncryptionOptions, PayloadProtectionError as E2eeError, PayloadProtectionError, E2eeKey, E2eeKeyProvider, E2eeOptions, E2eeReadPolicy, E2eeScope, E2eeWritePolicy, EphemeralStreamAdaptor, EphemeralStreamCrdt, EphemeralStreamCrdtOptions, EphemeralStreamJoinParams, EphemeralStreamSubscription, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, IndexedDbRemoteCursorStoreOptions, IsolatedCrdtAdapter, JsonObject, JsonValue, PayloadProtectionEncryptionOptions, PayloadProtectionKey, PayloadProtectionKeyProvider, PayloadProtectionOptions, PayloadProtectionReadPolicy, PayloadProtectionScope, PayloadProtectionWritePolicy, RemoteCursor, RemoteCursorSaveSource, RemoteCursorStore, Result, SnapshotCodec, SnapshotTransformHook, SnapshotUploadOptions, StreamsAuthContext, StreamsAuthProvider, StreamsCrdt, StreamsCrdtOptions, TransportCreateStreamSuccess, TransportDeleteStreamSuccess, TransportError, TransportJoinParams, TransportRoomStatus, TransportSnapshotUploadSuccess, TransportSubscription, TransportSyncSuccess, WriteOnlyAppendResult, createInitialRemoteCursor, createStreamUrl, isValidBucketId, isValidRillId };
+import { $ as IndexedDbRemoteCursorStoreOptions, A as PayloadProtectionReadPolicy, B as TransportCreateStreamSuccess, C as IsolatedCrdtAdapter, D as PayloadProtectionKey, E as PayloadProtectionEncryptionOptions, F as SnapshotTransformHook, G as TransportSnapshotUploadSuccess, H as TransportError, I as SnapshotUploadOptions, J as WriteOnlyAppendResult, K as TransportSubscription, L as StreamsAuthContext, M as PayloadProtectionWritePolicy, N as Result, O as PayloadProtectionKeyProvider, P as SnapshotCodec, Q as IndexedDbRemoteCursorStore, R as StreamsAuthProvider, S as EphemeralStreamSubscription, T as JsonValue, U as TransportJoinParams, V as TransportDeleteStreamSuccess, W as TransportRoomStatus, X as BeforeRemoteCursorSaveHook, Y as BeforeRemoteCursorSaveContext, Z as InMemoryRemoteCursorStore, _ as E2eeScope, a as EphemeralStreamCrdt, b as EphemeralStreamCrdtOptions, c as CrdtApplyOutcome, d as CrdtUpdateBatch, et as RemoteCursor, f as E2eeEncryptionOptions, g as E2eeReadPolicy, h as E2eeOptions, i as PayloadProtectionError, j as PayloadProtectionScope, k as PayloadProtectionOptions, l as CrdtApplyReturn, m as E2eeKeyProvider, n as isValidBucketId, nt as RemoteCursorStore, o as StreamsCrdt, p as E2eeKey, q as TransportSyncSuccess, r as isValidRillId, rt as createInitialRemoteCursor, s as CrdtAdapter, t as createStreamUrl, tt as RemoteCursorSaveSource, u as CrdtUnresolvedSpan, v as E2eeWritePolicy, w as JsonObject, x as EphemeralStreamJoinParams, y as EphemeralStreamAdaptor, z as StreamsCrdtOptions } from "./stream-id-Bi5rAZfP.js";
+export { BeforeRemoteCursorSaveContext, BeforeRemoteCursorSaveHook, CrdtAdapter, CrdtApplyOutcome, CrdtApplyReturn, CrdtUnresolvedSpan, CrdtUpdateBatch, E2eeEncryptionOptions, PayloadProtectionError as E2eeError, PayloadProtectionError, E2eeKey, E2eeKeyProvider, E2eeOptions, E2eeReadPolicy, E2eeScope, E2eeWritePolicy, EphemeralStreamAdaptor, EphemeralStreamCrdt, EphemeralStreamCrdtOptions, EphemeralStreamJoinParams, EphemeralStreamSubscription, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, IndexedDbRemoteCursorStoreOptions, IsolatedCrdtAdapter, JsonObject, JsonValue, PayloadProtectionEncryptionOptions, PayloadProtectionKey, PayloadProtectionKeyProvider, PayloadProtectionOptions, PayloadProtectionReadPolicy, PayloadProtectionScope, PayloadProtectionWritePolicy, RemoteCursor, RemoteCursorSaveSource, RemoteCursorStore, Result, SnapshotCodec, SnapshotTransformHook, SnapshotUploadOptions, StreamsAuthContext, StreamsAuthProvider, StreamsCrdt, StreamsCrdtOptions, TransportCreateStreamSuccess, TransportDeleteStreamSuccess, TransportError, TransportJoinParams, TransportRoomStatus, TransportSnapshotUploadSuccess, TransportSubscription, TransportSyncSuccess, WriteOnlyAppendResult, createInitialRemoteCursor, createStreamUrl, isValidBucketId, isValidRillId };

package/dist/index.js

@@ -1,2 +1,2 @@
-import { a as InMemoryRemoteCursorStore, c as EphemeralStreamCrdt, i as StreamsCrdt, l as PayloadProtectionError, n as isValidBucketId, o as IndexedDbRemoteCursorStore, r as isValidRillId, s as createInitialRemoteCursor, t as createStreamUrl } from "./stream-id-CF1egQDz.js";
+import { a as InMemoryRemoteCursorStore, c as EphemeralStreamCrdt, i as StreamsCrdt, l as PayloadProtectionError, n as isValidBucketId, o as IndexedDbRemoteCursorStore, r as isValidRillId, s as createInitialRemoteCursor, t as createStreamUrl } from "./stream-id-BjmGvObf.js";
 export { PayloadProtectionError as E2eeError, PayloadProtectionError, EphemeralStreamCrdt, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, StreamsCrdt, createInitialRemoteCursor, createStreamUrl, isValidBucketId, isValidRillId };

package/dist/loro.d.ts

@@ -1,4 +1,4 @@
-import { $ as RemoteCursorStore, A as Result, B as TransportJoinParams, C as PayloadProtectionEncryptionOptions, D as PayloadProtectionReadPolicy, E as PayloadProtectionOptions, F as StreamsAuthProvider, G as WriteOnlyAppendResult, H as TransportSnapshotUploadSuccess, I as StreamsCrdtOptions, J as InMemoryRemoteCursorStore, K as BeforeRemoteCursorSaveContext, L as TransportCreateStreamSuccess, M as SnapshotTransformHook, N as SnapshotUploadOptions, O as PayloadProtectionScope, P as StreamsAuthContext, Q as RemoteCursorSaveSource, R as TransportDeleteStreamSuccess, S as JsonValue, T as PayloadProtectionKeyProvider, U as TransportSubscription, V as TransportRoomStatus, W as TransportSyncSuccess, X as IndexedDbRemoteCursorStoreOptions, Y as IndexedDbRemoteCursorStore, Z as RemoteCursor, _ as EphemeralStreamCrdtOptions, a as EphemeralStreamCrdt, b as IsolatedCrdtAdapter, c as CrdtUpdateBatch, d as E2eeKeyProvider, et as createInitialRemoteCursor, f as E2eeOptions, g as EphemeralStreamAdaptor, h as E2eeWritePolicy, i as PayloadProtectionError, j as SnapshotCodec, k as PayloadProtectionWritePolicy, l as E2eeEncryptionOptions, m as E2eeScope, n as isValidBucketId, o as StreamsCrdt, p as E2eeReadPolicy, q as BeforeRemoteCursorSaveHook, r as isValidRillId, s as CrdtAdapter, t as createStreamUrl, u as E2eeKey, v as EphemeralStreamJoinParams, w as PayloadProtectionKey, x as JsonObject, y as EphemeralStreamSubscription, z as TransportError } from "./stream-id-BXJvwX_O.js";
+import { $ as IndexedDbRemoteCursorStoreOptions, A as PayloadProtectionReadPolicy, B as TransportCreateStreamSuccess, C as IsolatedCrdtAdapter, D as PayloadProtectionKey, E as PayloadProtectionEncryptionOptions, F as SnapshotTransformHook, G as TransportSnapshotUploadSuccess, H as TransportError, I as SnapshotUploadOptions, J as WriteOnlyAppendResult, K as TransportSubscription, L as StreamsAuthContext, M as PayloadProtectionWritePolicy, N as Result, O as PayloadProtectionKeyProvider, P as SnapshotCodec, Q as IndexedDbRemoteCursorStore, R as StreamsAuthProvider, S as EphemeralStreamSubscription, T as JsonValue, U as TransportJoinParams, V as TransportDeleteStreamSuccess, W as TransportRoomStatus, X as BeforeRemoteCursorSaveHook, Y as BeforeRemoteCursorSaveContext, Z as InMemoryRemoteCursorStore, _ as E2eeScope, a as EphemeralStreamCrdt, b as EphemeralStreamCrdtOptions, c as CrdtApplyOutcome, d as CrdtUpdateBatch, et as RemoteCursor, f as E2eeEncryptionOptions, g as E2eeReadPolicy, h as E2eeOptions, i as PayloadProtectionError, j as PayloadProtectionScope, k as PayloadProtectionOptions, l as CrdtApplyReturn, m as E2eeKeyProvider, n as isValidBucketId, nt as RemoteCursorStore, o as StreamsCrdt, p as E2eeKey, q as TransportSyncSuccess, r as isValidRillId, rt as createInitialRemoteCursor, s as CrdtAdapter, t as createStreamUrl, tt as RemoteCursorSaveSource, u as CrdtUnresolvedSpan, v as E2eeWritePolicy, w as JsonObject, x as EphemeralStreamJoinParams, y as EphemeralStreamAdaptor, z as StreamsCrdtOptions } from "./stream-id-Bi5rAZfP.js";
 import { LoroDoc } from "loro-crdt";
 
 //#region src/loro.d.ts
@@ -21,8 +21,6 @@ declare function createLoroDocAdapter(doc: LoroDoc): CrdtAdapter<JsonObject>;
  * Structural subset of Loro's `EphemeralStore`.
  */
 interface LoroEphemeralStoreLike {
-  /** Encodes the current non-expired store state for bootstrap/lease publish. */
-  encodeAll(): Uint8Array;
   /** Applies one opaque Loro ephemeral update. */
   apply(update: Uint8Array): void;
   /** Subscribes to locally produced ephemeral updates. */
@@ -43,5 +41,5 @@ interface LoroEphemeralStoreLike {
 declare function EphemeralStoreAdaptor(store: LoroEphemeralStoreLike): EphemeralStreamAdaptor;
 declare const createLoroEphemeralStoreAdaptor: typeof EphemeralStoreAdaptor;
 //#endregion
-export { BeforeRemoteCursorSaveContext, BeforeRemoteCursorSaveHook, CrdtAdapter, CrdtUpdateBatch, E2eeEncryptionOptions, PayloadProtectionError as E2eeError, PayloadProtectionError, E2eeKey, E2eeKeyProvider, E2eeOptions, E2eeReadPolicy, E2eeScope, E2eeWritePolicy, EphemeralStoreAdaptor, EphemeralStreamAdaptor, EphemeralStreamCrdt, EphemeralStreamCrdtOptions, EphemeralStreamJoinParams, EphemeralStreamSubscription, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, IndexedDbRemoteCursorStoreOptions, IsolatedCrdtAdapter, JsonObject, JsonValue, LoroEphemeralStoreLike, PayloadProtectionEncryptionOptions, PayloadProtectionKey, PayloadProtectionKeyProvider, PayloadProtectionOptions, PayloadProtectionReadPolicy, PayloadProtectionScope, PayloadProtectionWritePolicy, RemoteCursor, RemoteCursorSaveSource, RemoteCursorStore, Result, SnapshotCodec, SnapshotTransformHook, SnapshotUploadOptions, StreamsAuthContext, StreamsAuthProvider, StreamsCrdt, StreamsCrdtOptions, TransportCreateStreamSuccess, TransportDeleteStreamSuccess, TransportError, TransportJoinParams, TransportRoomStatus, TransportSnapshotUploadSuccess, TransportSubscription, TransportSyncSuccess, WriteOnlyAppendResult, createInitialRemoteCursor, createLoroDocAdapter, createLoroEphemeralStoreAdaptor, createStreamUrl, isValidBucketId, isValidRillId };
+export { BeforeRemoteCursorSaveContext, BeforeRemoteCursorSaveHook, CrdtAdapter, CrdtApplyOutcome, CrdtApplyReturn, CrdtUnresolvedSpan, CrdtUpdateBatch, E2eeEncryptionOptions, PayloadProtectionError as E2eeError, PayloadProtectionError, E2eeKey, E2eeKeyProvider, E2eeOptions, E2eeReadPolicy, E2eeScope, E2eeWritePolicy, EphemeralStoreAdaptor, EphemeralStreamAdaptor, EphemeralStreamCrdt, EphemeralStreamCrdtOptions, EphemeralStreamJoinParams, EphemeralStreamSubscription, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, IndexedDbRemoteCursorStoreOptions, IsolatedCrdtAdapter, JsonObject, JsonValue, LoroEphemeralStoreLike, PayloadProtectionEncryptionOptions, PayloadProtectionKey, PayloadProtectionKeyProvider, PayloadProtectionOptions, PayloadProtectionReadPolicy, PayloadProtectionScope, PayloadProtectionWritePolicy, RemoteCursor, RemoteCursorSaveSource, RemoteCursorStore, Result, SnapshotCodec, SnapshotTransformHook, SnapshotUploadOptions, StreamsAuthContext, StreamsAuthProvider, StreamsCrdt, StreamsCrdtOptions, TransportCreateStreamSuccess, TransportDeleteStreamSuccess, TransportError, TransportJoinParams, TransportRoomStatus, TransportSnapshotUploadSuccess, TransportSubscription, TransportSyncSuccess, WriteOnlyAppendResult, createInitialRemoteCursor, createLoroDocAdapter, createLoroEphemeralStoreAdaptor, createStreamUrl, isValidBucketId, isValidRillId };
 //# sourceMappingURL=loro.d.ts.map

package/dist/loro.js

@@ -1,9 +1,9 @@
-import { a as InMemoryRemoteCursorStore, c as EphemeralStreamCrdt, i as StreamsCrdt, l as PayloadProtectionError, n as isValidBucketId, o as IndexedDbRemoteCursorStore, r as isValidRillId, s as createInitialRemoteCursor, t as createStreamUrl } from "./stream-id-CF1egQDz.js";
+import { a as InMemoryRemoteCursorStore, c as EphemeralStreamCrdt, i as StreamsCrdt, l as PayloadProtectionError, n as isValidBucketId, o as IndexedDbRemoteCursorStore, r as isValidRillId, s as createInitialRemoteCursor, t as createStreamUrl } from "./stream-id-BjmGvObf.js";
 import { LoroDoc, VersionVector, decodeImportBlobMeta } from "loro-crdt";
 //#region src/loro.ts
 function batchImportUpdates(doc, updates) {
-	if ("batchImport" in doc && typeof doc.batchImport === "function") doc.batchImport(updates);
-	else doc.importBatch(updates);
+	if ("batchImport" in doc && typeof doc.batchImport === "function") return doc.batchImport(updates);
+	return doc.importBatch(updates);
 }
 function toDocVersionRecord(version) {
 	const out = {};
@@ -39,6 +39,106 @@ function assertDocAttached(doc) {
 	if (!doc.isDetached()) return;
 	throw new Error("LoroDoc must be attached before using streams-crdt; call checkoutToLatest() or attach() first");
 }
+function normalizePeerId(peer) {
+	return `${peer}`;
+}
+function isValidSpan(span) {
+	return Number.isSafeInteger(span.start) && Number.isSafeInteger(span.end) && span.start < span.end;
+}
+var UnresolvedSpanTracker = class {
+	spans = /* @__PURE__ */ new Map();
+	addAll(pending) {
+		if (pending == null) return;
+		for (const [peer, span] of pending) this.add(normalizePeerId(peer), span);
+	}
+	resolveAll(success) {
+		for (const [peer, span] of success) this.resolve(normalizePeerId(peer), span);
+	}
+	isEmpty() {
+		return this.spans.size === 0;
+	}
+	toArray() {
+		const out = [];
+		for (const [peer, spans] of this.spans) for (const span of spans) out.push({
+			peer,
+			start: span.start,
+			end: span.end
+		});
+		return out;
+	}
+	reset() {
+		this.spans.clear();
+	}
+	add(peer, incoming) {
+		if (!isValidSpan(incoming)) return;
+		const existing = this.spans.get(peer) ?? [];
+		existing.push({
+			start: incoming.start,
+			end: incoming.end
+		});
+		existing.sort((a, b) => a.start - b.start || a.end - b.end);
+		const merged = [];
+		for (const span of existing) {
+			const last = merged[merged.length - 1];
+			if (last == null || span.start > last.end) merged.push({
+				start: span.start,
+				end: span.end
+			});
+			else merged[merged.length - 1] = {
+				start: last.start,
+				end: Math.max(last.end, span.end)
+			};
+		}
+		this.spans.set(peer, merged);
+	}
+	resolve(peer, applied) {
+		if (!isValidSpan(applied)) return;
+		const existing = this.spans.get(peer);
+		if (existing == null) return;
+		const remaining = [];
+		for (const span of existing) {
+			if (applied.end <= span.start || applied.start >= span.end) {
+				remaining.push(span);
+				continue;
+			}
+			if (span.start < applied.start) remaining.push({
+				start: span.start,
+				end: applied.start
+			});
+			if (applied.end < span.end) remaining.push({
+				start: applied.end,
+				end: span.end
+			});
+		}
+		if (remaining.length === 0) this.spans.delete(peer);
+		else this.spans.set(peer, remaining);
+	}
+};
+function trackImportStatus(tracker, status) {
+	tracker.addAll(status.pending);
+	tracker.resolveAll(status.success);
+}
+function versionFromImportSuccess(status) {
+	const version = {};
+	for (const [peer, span] of status.success) {
+		if (!isValidSpan(span)) continue;
+		const peerId = normalizePeerId(peer);
+		version[peerId] = Math.max(version[peerId] ?? 0, span.end);
+	}
+	return version;
+}
+function versionFromSnapshotImport(snapshot, status, tracker) {
+	if (!tracker.isEmpty()) return versionFromImportSuccess(status);
+	return extractVersionFromUpdate(snapshot) ?? versionFromImportSuccess(status);
+}
+function applyOutcome(version, tracker) {
+	const unresolved = tracker.toArray();
+	return {
+		version,
+		complete: unresolved.length === 0,
+		...unresolved.length === 0 ? {} : { unresolved }
+	};
+}
 /**
 * Creates a `CrdtAdapter` for one `LoroDoc`.
 *
@@ -54,6 +154,7 @@ function assertDocAttached(doc) {
 * ```
 */
 function createLoroDocAdapter(doc) {
+	const unresolved = new UnresolvedSpanTracker();
 	return {
 		emptyVersion: () => ({}),
 		mergeVersions: (base, incoming) => mergeDocVersions(base, incoming),
@@ -63,8 +164,10 @@ function createLoroDocAdapter(doc) {
 		},
 		applySnapshot: (snapshot) => {
 			assertDocAttached(doc);
-			doc.import(snapshot);
-			return toDocVersionRecord(doc.version());
+			const status = doc.import(snapshot);
+			unresolved.reset();
+			trackImportStatus(unresolved, status);
+			return applyOutcome(versionFromSnapshotImport(snapshot, status, unresolved), unresolved);
 		},
 		exportUpdates: (fromVersion) => {
 			assertDocAttached(doc);
@@ -86,30 +189,34 @@ function createLoroDocAdapter(doc) {
 		},
 		applyRemoteUpdates: (updates, remoterVersion) => {
 			assertDocAttached(doc);
-			if (updates.length > 0) batchImportUpdates(doc, updates);
-			let version = remoterVersion;
-			for (const update of updates) {
-				const next = extractVersionFromUpdate(update);
-				if (next != null) version = mergeDocVersions(version, next);
+			if (updates.length > 0) {
+				const status = batchImportUpdates(doc, updates);
+				trackImportStatus(unresolved, status);
+				return applyOutcome(mergeDocVersions(remoterVersion, versionFromImportSuccess(status)), unresolved);
 			}
-			return version;
+			return applyOutcome(remoterVersion, unresolved);
 		},
 		createIsolatedAdapter: () => {
 			let isolatedDoc = new LoroDoc();
+			const isolatedUnresolved = new UnresolvedSpanTracker();
 			return {
 				applySnapshot: (snapshot) => {
 					isolatedDoc = new LoroDoc();
-					if (snapshot.byteLength > 0) isolatedDoc.import(snapshot);
-					return toDocVersionRecord(isolatedDoc.version());
+					isolatedUnresolved.reset();
+					if (snapshot.byteLength > 0) {
+						const status = isolatedDoc.import(snapshot);
+						trackImportStatus(isolatedUnresolved, status);
+						return applyOutcome(versionFromSnapshotImport(snapshot, status, isolatedUnresolved), isolatedUnresolved);
+					}
+					return applyOutcome({}, isolatedUnresolved);
 				},
 				applyRemoteUpdates: (updates, remoterVersion) => {
-					if (updates.length > 0) batchImportUpdates(isolatedDoc, updates);
-					let version = remoterVersion;
-					for (const update of updates) {
-						const next = extractVersionFromUpdate(update);
-						if (next != null) version = mergeDocVersions(version, next);
+					if (updates.length > 0) {
+						const status = batchImportUpdates(isolatedDoc, updates);
+						trackImportStatus(isolatedUnresolved, status);
+						return applyOutcome(mergeDocVersions(remoterVersion, versionFromImportSuccess(status)), isolatedUnresolved);
 					}
-					return version;
+					return applyOutcome(remoterVersion, isolatedUnresolved);
 				}
 			};
 		},
@@ -138,12 +245,25 @@ function createLoroDocAdapter(doc) {
 * ```
 */
 function EphemeralStoreAdaptor(store) {
+	let applyingRemoteDepth = 0;
 	return {
-		encodeAll: () => store.encodeAll(),
 		applyRemoteUpdates: (updates) => {
-			for (const update of updates) store.apply(update);
+			applyingRemoteDepth += 1;
+			try {
+				for (const update of updates) store.apply(update);
+			} finally {
+				applyingRemoteDepth -= 1;
+			}
 		},
-		subscribeLocalUpdates: (listener) => store.subscribeLocalUpdates(listener)
+		subscribeLocalUpdates: (listener) => {
+			const unsubscribeLocalUpdates = store.subscribeLocalUpdates((update) => {
+				if (applyingRemoteDepth > 0) return;
+				listener(update);
+			});
+			return () => {
+				unsubscribeLocalUpdates();
+			};
+		}
 	};
 }
 const createLoroEphemeralStoreAdaptor = EphemeralStoreAdaptor;

package/dist/loro.js.map

@@ -1 +1 @@
-{"version":3,"file":"loro.js","names":[],"sources":["../src/loro.ts"],"sourcesContent":["import {\n  decodeImportBlobMeta,\n  LoroDoc,\n  VersionVector,\n} from \"loro-crdt\";\n\nimport type { CrdtAdapter, JsonObject } from \"./types\";\nimport type { EphemeralStreamAdaptor } from \"./types\";\n\nexport { EphemeralStreamCrdt } from \"./ephemeral-runtime\";\nexport { StreamsCrdt } from \"./transport-runtime\";\nexport * from \"./shared\";\n\nfunction batchImportUpdates(doc: LoroDoc, updates: Uint8Array[]): void {\n  if (\"batchImport\" in doc && typeof doc.batchImport === \"function\") {\n    doc.batchImport(updates);\n  } else {\n    doc.importBatch(updates);\n  }\n}\n\ntype PeerId = `${number}`;\ntype DocVersionRecord = Record<PeerId, number>;\n\nfunction toDocVersionRecord(version: VersionVector): DocVersionRecord {\n  const out = {} as DocVersionRecord;\n  for (const [peer, counter] of version.toJSON()) {\n    out[peer as PeerId] = counter;\n  }\n  return out;\n}\n\nfunction toDocVersionMap(version: JsonObject): Map<PeerId, number> {\n  const out = new Map<PeerId, number>();\n  for (const [peer, counter] of Object.entries(version)) {\n    if (typeof counter === \"number\" && Number.isFinite(counter)) {\n      out.set(peer as PeerId, counter);\n    }\n  }\n  return out;\n}\n\nfunction mergeDocVersions(\n  base: DocVersionRecord,\n  incoming: DocVersionRecord,\n): DocVersionRecord {\n  const merged = new Map<PeerId, number>();\n  for (const [peer, counter] of Object.entries(base)) {\n    merged.set(peer as PeerId, counter);\n  }\n  for (const [peer, counter] of Object.entries(incoming)) {\n    const peerId = peer as PeerId;\n    merged.set(peerId, Math.max(merged.get(peerId) ?? 0, counter));\n  }\n  return toDocVersionRecord(VersionVector.parseJSON(merged));\n}\n\nfunction hasUpdatesSince(\n  fromVersion: DocVersionRecord,\n  currentVersion: DocVersionRecord,\n): boolean {\n  for (const [peer, counter] of Object.entries(currentVersion)) {\n    if (counter > (fromVersion[peer as PeerId] ?? 0)) {\n      return true;\n    }\n  }\n  return false;\n}\n\nfunction extractVersionFromUpdate(update: Uint8Array): DocVersionRecord | null {\n  try {\n    const meta = decodeImportBlobMeta(update, false);\n    return toDocVersionRecord(meta.partialEndVersionVector);\n  } catch {\n    return null;\n  }\n}\n\nfunction assertDocAttached(doc: LoroDoc): void {\n  if (!doc.isDetached()) {\n    return;\n  }\n  throw new Error(\n    \"LoroDoc must be attached before using streams-crdt; \" +\n      \"call checkoutToLatest() or attach() first\",\n  );\n}\n\n/**\n * Creates a `CrdtAdapter` for one `LoroDoc`.\n *\n * The `LoroDoc` must be attached (not detached or checked out to a historical\n * version). If the document is detached, call `doc.checkoutToLatest()` or\n * `doc.attach()` before passing it here.\n *\n * @example\n * ```ts\n * const doc = new LoroDoc();\n * const adapter = createLoroDocAdapter(doc);\n * const transport = new StreamsCrdt({ streamUrl, adapter, auth });\n * ```\n */\nexport function createLoroDocAdapter(\n  doc: LoroDoc,\n): CrdtAdapter<JsonObject> {\n  return {\n    emptyVersion: () => ({}),\n    mergeVersions: (base, incoming) =>\n      mergeDocVersions(base as DocVersionRecord, incoming as DocVersionRecord),\n    exportSnapshot: () => {\n      assertDocAttached(doc);\n      return doc.export({ mode: \"snapshot\" });\n    },\n    applySnapshot: (snapshot) => {\n      assertDocAttached(doc);\n      doc.import(snapshot);\n      return toDocVersionRecord(doc.version());\n    },\n    exportUpdates: (fromVersion) => {\n      assertDocAttached(doc);\n      const currentVersion = toDocVersionRecord(doc.version());\n      if (\n        !hasUpdatesSince(\n          fromVersion as DocVersionRecord,\n          currentVersion,\n        )\n      ) {\n        return undefined;\n      }\n      const updates = [\n        doc.export({\n          mode: \"update\",\n          from: VersionVector.parseJSON(toDocVersionMap(fromVersion)),\n        }),\n      ].filter((update) => update.byteLength > 0);\n      if (updates.length === 0) {\n        return undefined;\n      }\n      let version: DocVersionRecord = {};\n      for (const update of updates) {\n        const next = extractVersionFromUpdate(update);\n        if (next != null) {\n          version = mergeDocVersions(version, next);\n        }\n      }\n      return {\n        updates,\n        version,\n      };\n    },\n    applyRemoteUpdates: (updates, remoterVersion) => {\n      assertDocAttached(doc);\n      if (updates.length > 0) {\n        batchImportUpdates(doc, updates);\n      }\n      let version = remoterVersion as DocVersionRecord;\n      for (const update of updates) {\n        const next = extractVersionFromUpdate(update);\n        if (next != null) {\n          version = mergeDocVersions(version, next);\n        }\n      }\n      return version;\n    },\n    createIsolatedAdapter: () => {\n      let isolatedDoc = new LoroDoc();\n      return {\n        applySnapshot: (snapshot) => {\n          isolatedDoc = new LoroDoc();\n          if (snapshot.byteLength > 0) {\n            isolatedDoc.import(snapshot);\n          }\n          return toDocVersionRecord(isolatedDoc.version());\n        },\n        applyRemoteUpdates: (updates, remoterVersion) => {\n          if (updates.length > 0) {\n            batchImportUpdates(isolatedDoc, updates);\n          }\n          let version = remoterVersion as DocVersionRecord;\n          for (const update of updates) {\n            const next = extractVersionFromUpdate(update);\n            if (next != null) {\n              version = mergeDocVersions(version, next);\n            }\n          }\n          return version;\n        },\n      };\n    },\n    subscribeLocalUpdates: (listener) => {\n      assertDocAttached(doc);\n      return doc.subscribeLocalUpdates((update) => {\n        const version = extractVersionFromUpdate(update) ?? {};\n        listener({ updates: [update], version });\n      });\n    },\n  };\n}\n\n/**\n * Structural subset of Loro's `EphemeralStore`.\n */\nexport interface LoroEphemeralStoreLike {\n  /** Encodes the current non-expired store state for bootstrap/lease publish. */\n  encodeAll(): Uint8Array;\n  /** Applies one opaque Loro ephemeral update. */\n  apply(update: Uint8Array): void;\n  /** Subscribes to locally produced ephemeral updates. */\n  subscribeLocalUpdates(listener: (update: Uint8Array) => void): () => void;\n}\n\n/**\n * Creates an ephemeral stream adaptor for a Loro `EphemeralStore`.\n *\n * @example\n * ```ts\n * const room = new EphemeralStreamCrdt({\n *   streamUrl,\n *   auth,\n *   adaptor: EphemeralStoreAdaptor(store),\n * });\n * ```\n */\nexport function EphemeralStoreAdaptor(\n  store: LoroEphemeralStoreLike,\n): EphemeralStreamAdaptor {\n  return {\n    encodeAll: () => store.encodeAll(),\n    applyRemoteUpdates: (updates) => {\n      for (const update of updates) {\n        store.apply(update);\n      }\n    },\n    subscribeLocalUpdates: (listener) =>\n      store.subscribeLocalUpdates(listener),\n  };\n}\n\nexport const createLoroEphemeralStoreAdaptor = EphemeralStoreAdaptor;\n"],"mappings":";;;AAaA,SAAS,mBAAmB,KAAc,SAA6B;AACrE,KAAI,iBAAiB,OAAO,OAAO,IAAI,gBAAgB,WACrD,KAAI,YAAY,QAAQ;KAExB,KAAI,YAAY,QAAQ;;AAO5B,SAAS,mBAAmB,SAA0C;CACpE,MAAM,MAAM,EAAE;AACd,MAAK,MAAM,CAAC,MAAM,YAAY,QAAQ,QAAQ,CAC5C,KAAI,QAAkB;AAExB,QAAO;;AAGT,SAAS,gBAAgB,SAA0C;CACjE,MAAM,sBAAM,IAAI,KAAqB;AACrC,MAAK,MAAM,CAAC,MAAM,YAAY,OAAO,QAAQ,QAAQ,CACnD,KAAI,OAAO,YAAY,YAAY,OAAO,SAAS,QAAQ,CACzD,KAAI,IAAI,MAAgB,QAAQ;AAGpC,QAAO;;AAGT,SAAS,iBACP,MACA,UACkB;CAClB,MAAM,yBAAS,IAAI,KAAqB;AACxC,MAAK,MAAM,CAAC,MAAM,YAAY,OAAO,QAAQ,KAAK,CAChD,QAAO,IAAI,MAAgB,QAAQ;AAErC,MAAK,MAAM,CAAC,MAAM,YAAY,OAAO,QAAQ,SAAS,EAAE;EACtD,MAAM,SAAS;AACf,SAAO,IAAI,QAAQ,KAAK,IAAI,OAAO,IAAI,OAAO,IAAI,GAAG,QAAQ,CAAC;;AAEhE,QAAO,mBAAmB,cAAc,UAAU,OAAO,CAAC;;AAG5D,SAAS,gBACP,aACA,gBACS;AACT,MAAK,MAAM,CAAC,MAAM,YAAY,OAAO,QAAQ,eAAe,CAC1D,KAAI,WAAW,YAAY,SAAmB,GAC5C,QAAO;AAGX,QAAO;;AAGT,SAAS,yBAAyB,QAA6C;AAC7E,KAAI;AAEF,SAAO,mBADM,qBAAqB,QAAQ,MAAM,CACjB,wBAAwB;SACjD;AACN,SAAO;;;AAIX,SAAS,kBAAkB,KAAoB;AAC7C,KAAI,CAAC,IAAI,YAAY,CACnB;AAEF,OAAM,IAAI,MACR,gGAED;;;;;;;;;;;;;;;;AAiBH,SAAgB,qBACd,KACyB;AACzB,QAAO;EACL,qBAAqB,EAAE;EACvB,gBAAgB,MAAM,aACpB,iBAAiB,MAA0B,SAA6B;EAC1E,sBAAsB;AACpB,qBAAkB,IAAI;AACtB,UAAO,IAAI,OAAO,EAAE,MAAM,YAAY,CAAC;;EAEzC,gBAAgB,aAAa;AAC3B,qBAAkB,IAAI;AACtB,OAAI,OAAO,SAAS;AACpB,UAAO,mBAAmB,IAAI,SAAS,CAAC;;EAE1C,gBAAgB,gBAAgB;AAC9B,qBAAkB,IAAI;AAEtB,OACE,CAAC,gBACC,aAHmB,mBAAmB,IAAI,SAAS,CAAC,CAKrD,CAED;GAEF,MAAM,UAAU,CACd,IAAI,OAAO;IACT,MAAM;IACN,MAAM,cAAc,UAAU,gBAAgB,YAAY,CAAC;IAC5D,CAAC,CACH,CAAC,QAAQ,WAAW,OAAO,aAAa,EAAE;AAC3C,OAAI,QAAQ,WAAW,EACrB;GAEF,IAAI,UAA4B,EAAE;AAClC,QAAK,MAAM,UAAU,SAAS;IAC5B,MAAM,OAAO,yBAAyB,OAAO;AAC7C,QAAI,QAAQ,KACV,WAAU,iBAAiB,SAAS,KAAK;;AAG7C,UAAO;IACL;IACA;IACD;;EAEH,qBAAqB,SAAS,mBAAmB;AAC/C,qBAAkB,IAAI;AACtB,OAAI,QAAQ,SAAS,EACnB,oBAAmB,KAAK,QAAQ;GAElC,IAAI,UAAU;AACd,QAAK,MAAM,UAAU,SAAS;IAC5B,MAAM,OAAO,yBAAyB,OAAO;AAC7C,QAAI,QAAQ,KACV,WAAU,iBAAiB,SAAS,KAAK;;AAG7C,UAAO;;EAET,6BAA6B;GAC3B,IAAI,cAAc,IAAI,SAAS;AAC/B,UAAO;IACL,gBAAgB,aAAa;AAC3B,mBAAc,IAAI,SAAS;AAC3B,SAAI,SAAS,aAAa,EACxB,aAAY,OAAO,SAAS;AAE9B,YAAO,mBAAmB,YAAY,SAAS,CAAC;;IAElD,qBAAqB,SAAS,mBAAmB;AAC/C,SAAI,QAAQ,SAAS,EACnB,oBAAmB,aAAa,QAAQ;KAE1C,IAAI,UAAU;AACd,UAAK,MAAM,UAAU,SAAS;MAC5B,MAAM,OAAO,yBAAyB,OAAO;AAC7C,UAAI,QAAQ,KACV,WAAU,iBAAiB,SAAS,KAAK;;AAG7C,YAAO;;IAEV;;EAEH,wBAAwB,aAAa;AACnC,qBAAkB,IAAI;AACtB,UAAO,IAAI,uBAAuB,WAAW;IAC3C,MAAM,UAAU,yBAAyB,OAAO,IAAI,EAAE;AACtD,aAAS;KAAE,SAAS,CAAC,OAAO;KAAE;KAAS,CAAC;KACxC;;EAEL;;;;;;;;;;;;;;AA2BH,SAAgB,sBACd,OACwB;AACxB,QAAO;EACL,iBAAiB,MAAM,WAAW;EAClC,qBAAqB,YAAY;AAC/B,QAAK,MAAM,UAAU,QACnB,OAAM,MAAM,OAAO;;EAGvB,wBAAwB,aACtB,MAAM,sBAAsB,SAAS;EACxC;;AAGH,MAAa,kCAAkC"}
+{"version":3,"file":"loro.js","names":[],"sources":["../src/loro.ts"],"sourcesContent":["import {\n  decodeImportBlobMeta,\n  LoroDoc,\n  VersionVector,\n} from \"loro-crdt\";\n\nimport type {\n  CrdtAdapter,\n  CrdtApplyOutcome,\n  CrdtUnresolvedSpan,\n  JsonObject,\n} from \"./types\";\nimport type { EphemeralStreamAdaptor } from \"./types\";\n\nexport { EphemeralStreamCrdt } from \"./ephemeral-runtime\";\nexport { StreamsCrdt } from \"./transport-runtime\";\nexport * from \"./shared\";\n\ntype CounterSpan = {\n  readonly start: number;\n  readonly end: number;\n};\n\ntype LoroImportStatus = {\n  readonly success: Map<string | number | bigint, CounterSpan>;\n  readonly pending: Map<string | number | bigint, CounterSpan> | null;\n};\n\nfunction batchImportUpdates(\n  doc: LoroDoc,\n  updates: Uint8Array[],\n): LoroImportStatus {\n  if (\"batchImport\" in doc && typeof doc.batchImport === \"function\") {\n    return doc.batchImport(updates) as LoroImportStatus;\n  }\n  return doc.importBatch(updates) as LoroImportStatus;\n}\n\ntype PeerId = `${number}`;\ntype DocVersionRecord = Record<PeerId, number>;\n\nfunction toDocVersionRecord(version: VersionVector): DocVersionRecord {\n  const out = {} as DocVersionRecord;\n  for (const [peer, counter] of version.toJSON()) {\n    out[peer as PeerId] = counter;\n  }\n  return out;\n}\n\nfunction toDocVersionMap(version: JsonObject): Map<PeerId, number> {\n  const out = new Map<PeerId, number>();\n  for (const [peer, counter] of Object.entries(version)) {\n    if (typeof counter === \"number\" && Number.isFinite(counter)) {\n      out.set(peer as PeerId, counter);\n    }\n  }\n  return out;\n}\n\nfunction mergeDocVersions(\n  base: DocVersionRecord,\n  incoming: DocVersionRecord,\n): DocVersionRecord {\n  const merged = new Map<PeerId, number>();\n  for (const [peer, counter] of Object.entries(base)) {\n    merged.set(peer as PeerId, counter);\n  }\n  for (const [peer, counter] of Object.entries(incoming)) {\n    const peerId = peer as PeerId;\n    merged.set(peerId, Math.max(merged.get(peerId) ?? 0, counter));\n  }\n  return toDocVersionRecord(VersionVector.parseJSON(merged));\n}\n\nfunction hasUpdatesSince(\n  fromVersion: DocVersionRecord,\n  currentVersion: DocVersionRecord,\n): boolean {\n  for (const [peer, counter] of Object.entries(currentVersion)) {\n    if (counter > (fromVersion[peer as PeerId] ?? 0)) {\n      return true;\n    }\n  }\n  return false;\n}\n\nfunction extractVersionFromUpdate(update: Uint8Array): DocVersionRecord | null {\n  try {\n    const meta = decodeImportBlobMeta(update, false);\n    return toDocVersionRecord(meta.partialEndVersionVector);\n  } catch {\n    return null;\n  }\n}\n\nfunction assertDocAttached(doc: LoroDoc): void {\n  if (!doc.isDetached()) {\n    return;\n  }\n  throw new Error(\n    \"LoroDoc must be attached before using streams-crdt; \" +\n      \"call checkoutToLatest() or attach() first\",\n  );\n}\n\nfunction normalizePeerId(peer: string | number | bigint): PeerId {\n  return `${peer}` as PeerId;\n}\n\nfunction isValidSpan(span: CounterSpan): boolean {\n  return (\n    Number.isSafeInteger(span.start) &&\n    Number.isSafeInteger(span.end) &&\n    span.start < span.end\n  );\n}\n\nclass UnresolvedSpanTracker {\n  private readonly spans = new Map<PeerId, CounterSpan[]>();\n\n  addAll(pending: LoroImportStatus[\"pending\"]): void {\n    if (pending == null) {\n      return;\n    }\n    for (const [peer, span] of pending) {\n      this.add(normalizePeerId(peer), span);\n    }\n  }\n\n  resolveAll(success: LoroImportStatus[\"success\"]): void {\n    for (const [peer, span] of success) {\n      this.resolve(normalizePeerId(peer), span);\n    }\n  }\n\n  isEmpty(): boolean {\n    return this.spans.size === 0;\n  }\n\n  toArray(): CrdtUnresolvedSpan[] {\n    const out: CrdtUnresolvedSpan[] = [];\n    for (const [peer, spans] of this.spans) {\n      for (const span of spans) {\n        out.push({ peer, start: span.start, end: span.end });\n      }\n    }\n    return out;\n  }\n\n  reset(): void {\n    this.spans.clear();\n  }\n\n  private add(peer: PeerId, incoming: CounterSpan): void {\n    if (!isValidSpan(incoming)) {\n      return;\n    }\n    const existing = this.spans.get(peer) ?? [];\n    existing.push({ start: incoming.start, end: incoming.end });\n    existing.sort((a, b) => a.start - b.start || a.end - b.end);\n    const merged: CounterSpan[] = [];\n    for (const span of existing) {\n      const last = merged[merged.length - 1];\n      if (last == null || span.start > last.end) {\n        merged.push({ start: span.start, end: span.end });\n      } else {\n        merged[merged.length - 1] = {\n          start: last.start,\n          end: Math.max(last.end, span.end),\n        };\n      }\n    }\n    this.spans.set(peer, merged);\n  }\n\n  private resolve(peer: PeerId, applied: CounterSpan): void {\n    if (!isValidSpan(applied)) {\n      return;\n    }\n    const existing = this.spans.get(peer);\n    if (existing == null) {\n      return;\n    }\n    const remaining: CounterSpan[] = [];\n    for (const span of existing) {\n      if (applied.end <= span.start || applied.start >= span.end) {\n        remaining.push(span);\n        continue;\n      }\n      if (span.start < applied.start) {\n        remaining.push({ start: span.start, end: applied.start });\n      }\n      if (applied.end < span.end) {\n        remaining.push({ start: applied.end, end: span.end });\n      }\n    }\n    if (remaining.length === 0) {\n      this.spans.delete(peer);\n    } else {\n      this.spans.set(peer, remaining);\n    }\n  }\n}\n\nfunction trackImportStatus(\n  tracker: UnresolvedSpanTracker,\n  status: LoroImportStatus,\n): void {\n  tracker.addAll(status.pending);\n  tracker.resolveAll(status.success);\n}\n\nfunction versionFromImportSuccess(status: LoroImportStatus): DocVersionRecord {\n  const version: DocVersionRecord = {};\n  for (const [peer, span] of status.success) {\n    if (!isValidSpan(span)) {\n      continue;\n    }\n    const peerId = normalizePeerId(peer);\n    version[peerId] = Math.max(version[peerId] ?? 0, span.end);\n  }\n  return version;\n}\n\nfunction versionFromSnapshotImport(\n  snapshot: Uint8Array,\n  status: LoroImportStatus,\n  tracker: UnresolvedSpanTracker,\n): DocVersionRecord {\n  if (!tracker.isEmpty()) {\n    return versionFromImportSuccess(status);\n  }\n  return extractVersionFromUpdate(snapshot) ?? versionFromImportSuccess(status);\n}\n\nfunction applyOutcome(\n  version: DocVersionRecord,\n  tracker: UnresolvedSpanTracker,\n): CrdtApplyOutcome<JsonObject> {\n  const unresolved = tracker.toArray();\n  return {\n    version,\n    complete: unresolved.length === 0,\n    ...(unresolved.length === 0 ? {} : { unresolved }),\n  };\n}\n\n/**\n * Creates a `CrdtAdapter` for one `LoroDoc`.\n *\n * The `LoroDoc` must be attached (not detached or checked out to a historical\n * version). If the document is detached, call `doc.checkoutToLatest()` or\n * `doc.attach()` before passing it here.\n *\n * @example\n * ```ts\n * const doc = new LoroDoc();\n * const adapter = createLoroDocAdapter(doc);\n * const transport = new StreamsCrdt({ streamUrl, adapter, auth });\n * ```\n */\nexport function createLoroDocAdapter(\n  doc: LoroDoc,\n): CrdtAdapter<JsonObject> {\n  const unresolved = new UnresolvedSpanTracker();\n  return {\n    emptyVersion: () => ({}),\n    mergeVersions: (base, incoming) =>\n      mergeDocVersions(base as DocVersionRecord, incoming as DocVersionRecord),\n    exportSnapshot: () => {\n      assertDocAttached(doc);\n      return doc.export({ mode: \"snapshot\" });\n    },\n    applySnapshot: (snapshot) => {\n      assertDocAttached(doc);\n      const status = doc.import(snapshot) as LoroImportStatus;\n      unresolved.reset();\n      trackImportStatus(unresolved, status);\n      return applyOutcome(\n        versionFromSnapshotImport(snapshot, status, unresolved),\n        unresolved,\n      );\n    },\n    exportUpdates: (fromVersion) => {\n      assertDocAttached(doc);\n      const currentVersion = toDocVersionRecord(doc.version());\n      if (\n        !hasUpdatesSince(\n          fromVersion as DocVersionRecord,\n          currentVersion,\n        )\n      ) {\n        return undefined;\n      }\n      const updates = [\n        doc.export({\n          mode: \"update\",\n          from: VersionVector.parseJSON(toDocVersionMap(fromVersion)),\n        }),\n      ].filter((update) => update.byteLength > 0);\n      if (updates.length === 0) {\n        return undefined;\n      }\n      let version: DocVersionRecord = {};\n      for (const update of updates) {\n        const next = extractVersionFromUpdate(update);\n        if (next != null) {\n          version = mergeDocVersions(version, next);\n        }\n      }\n      return {\n        updates,\n        version,\n      };\n    },\n    applyRemoteUpdates: (updates, remoterVersion) => {\n      assertDocAttached(doc);\n      if (updates.length > 0) {\n        const status = batchImportUpdates(doc, updates);\n        trackImportStatus(unresolved, status);\n        const version = mergeDocVersions(\n          remoterVersion as DocVersionRecord,\n          versionFromImportSuccess(status),\n        );\n        return applyOutcome(version, unresolved);\n      }\n      return applyOutcome(remoterVersion as DocVersionRecord, unresolved);\n    },\n    createIsolatedAdapter: () => {\n      let isolatedDoc = new LoroDoc();\n      const isolatedUnresolved = new UnresolvedSpanTracker();\n      return {\n        applySnapshot: (snapshot) => {\n          isolatedDoc = new LoroDoc();\n          isolatedUnresolved.reset();\n          if (snapshot.byteLength > 0) {\n            const status = isolatedDoc.import(snapshot) as LoroImportStatus;\n            trackImportStatus(isolatedUnresolved, status);\n            return applyOutcome(\n              versionFromSnapshotImport(snapshot, status, isolatedUnresolved),\n              isolatedUnresolved,\n            );\n          }\n          return applyOutcome({}, isolatedUnresolved);\n        },\n        applyRemoteUpdates: (updates, remoterVersion) => {\n          if (updates.length > 0) {\n            const status = batchImportUpdates(isolatedDoc, updates);\n            trackImportStatus(isolatedUnresolved, status);\n            const version = mergeDocVersions(\n              remoterVersion as DocVersionRecord,\n              versionFromImportSuccess(status),\n            );\n            return applyOutcome(version, isolatedUnresolved);\n          }\n          return applyOutcome(\n            remoterVersion as DocVersionRecord,\n            isolatedUnresolved,\n          );\n        },\n      };\n    },\n    subscribeLocalUpdates: (listener) => {\n      assertDocAttached(doc);\n      return doc.subscribeLocalUpdates((update) => {\n        const version = extractVersionFromUpdate(update) ?? {};\n        listener({ updates: [update], version });\n      });\n    },\n  };\n}\n\n/**\n * Structural subset of Loro's `EphemeralStore`.\n */\nexport interface LoroEphemeralStoreLike {\n  /** Applies one opaque Loro ephemeral update. */\n  apply(update: Uint8Array): void;\n  /** Subscribes to locally produced ephemeral updates. */\n  subscribeLocalUpdates(listener: (update: Uint8Array) => void): () => void;\n}\n\n/**\n * Creates an ephemeral stream adaptor for a Loro `EphemeralStore`.\n *\n * @example\n * ```ts\n * const room = new EphemeralStreamCrdt({\n *   streamUrl,\n *   auth,\n *   adaptor: EphemeralStoreAdaptor(store),\n * });\n * ```\n */\nexport function EphemeralStoreAdaptor(\n  store: LoroEphemeralStoreLike,\n): EphemeralStreamAdaptor {\n  let applyingRemoteDepth = 0;\n  return {\n    applyRemoteUpdates: (updates) => {\n      applyingRemoteDepth += 1;\n      try {\n        for (const update of updates) {\n          store.apply(update);\n        }\n      } finally {\n        applyingRemoteDepth -= 1;\n      }\n    },\n    subscribeLocalUpdates: (listener) => {\n      const unsubscribeLocalUpdates = store.subscribeLocalUpdates((update) => {\n        if (applyingRemoteDepth > 0) {\n          return;\n        }\n        listener(update);\n      });\n      return () => {\n        unsubscribeLocalUpdates();\n      };\n    },\n  };\n}\n\nexport const createLoroEphemeralStoreAdaptor = EphemeralStoreAdaptor;\n"],"mappings":"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"}

package/dist/{stream-id-BXJvwX_O.d.ts → stream-id-Bi5rAZfP.d.ts}

@@ -176,6 +176,7 @@ type TransportRoomStatus = "joined" | "reconnecting" | "disconnected" | "error";
  * - `network_error` — fetch-level failure (DNS, connection refused, etc.).
  * - `timeout` — connect or poll deadline exceeded.
  * - `gone` — the server indicated the stream was deleted or moved (410).
+ * - `apply_incomplete` — a CRDT adapter could not fully apply remote data.
  * - `internal_error` — adapter or runtime logic failed locally.
  * - `unknown` — catch-all for unexpected errors.
  */
@@ -205,6 +206,11 @@ type TransportError = {
   readonly code: "gone";
   readonly retryable: true;
   readonly message: string;
+} | {
+  readonly code: "apply_incomplete";
+  readonly retryable: true;
+  readonly reason: "loro_pending_updates";
+  readonly message: string;
 } | {
   readonly code: "internal_error";
   readonly retryable: false;
@@ -397,12 +403,10 @@ interface TransportSubscription {
  *
  * Ephemeral transports bootstrap through the first SSE event, then continue
  * with live deltas only. They do not expose checkpoints, snapshots, or
- * replayable offset history. `encodeAll()` is sent on join/reconnect/heartbeat
- * so peers can converge on the caller's current presence state.
+ * replayable offset history. Outbound data is limited to updates emitted by
+ * `subscribeLocalUpdates()` so imported remote presence is never republished.
  */
 interface EphemeralStreamAdaptor {
-  /** Encodes all currently live local ephemeral state. */
-  encodeAll(): MaybePromise<Uint8Array | null | undefined>;
   /** Applies updates received from the remote ephemeral stream. */
   applyRemoteUpdates(updates: readonly Uint8Array[]): MaybePromise<void>;
   /** Subscribes to local ephemeral updates. Returns an unsubscribe function. */
@@ -421,6 +425,23 @@ interface CrdtUpdateBatch<TVersion extends JsonObject> {
   readonly version: TVersion;
 }
 type ExportedCrdtUpdateBatch<TVersion extends JsonObject> = CrdtUpdateBatch<TVersion> | null | undefined;
+interface CrdtUnresolvedSpan {
+  /** CRDT peer/client id that still has an unresolved counter span. */
+  readonly peer: string;
+  /** Inclusive start counter. */
+  readonly start: number;
+  /** Exclusive end counter. */
+  readonly end: number;
+}
+interface CrdtApplyOutcome<TVersion extends JsonObject> {
+  /** Inferred remote version that is actually applied to local durable CRDT state. */
+  readonly version: TVersion;
+  /** `false` means remote bytes were seen but cannot yet be durably checkpointed. */
+  readonly complete: boolean;
+  /** Adapter-specific unresolved dependency spans, when known. */
+  readonly unresolved?: readonly CrdtUnresolvedSpan[];
+}
+type CrdtApplyReturn<TVersion extends JsonObject> = TVersion | CrdtApplyOutcome<TVersion>;
 /**
  * Isolated apply-only adapter used for 410/bootstrap recovery.
  *
@@ -428,9 +449,9 @@ type ExportedCrdtUpdateBatch<TVersion extends JsonObject> = CrdtUpdateBatch<TVer
  */
 interface IsolatedCrdtAdapter<TVersion extends JsonObject> {
   /** Imports a full snapshot into isolated state and returns its version. */
-  applySnapshot(snapshot: Uint8Array): MaybePromise<TVersion>;
+  applySnapshot(snapshot: Uint8Array): MaybePromise<CrdtApplyReturn<TVersion>>;
   /** Applies retained remote updates into isolated state and returns the new version. */
-  applyRemoteUpdates(updates: Uint8Array[], remoterVersion: TVersion): MaybePromise<TVersion>;
+  applyRemoteUpdates(updates: Uint8Array[], remoterVersion: TVersion): MaybePromise<CrdtApplyReturn<TVersion>>;
 }
 /**
  * Adapter contract between `StreamsCrdt` and a concrete CRDT runtime.
@@ -443,7 +464,7 @@ interface CrdtAdapter<TVersion extends JsonObject> {
   /** Exports a full snapshot of the current local CRDT state. */
   exportSnapshot(): Uint8Array;
   /** Imports a full snapshot, replacing local state. Returns the version after import. */
-  applySnapshot(snapshot: Uint8Array): MaybePromise<TVersion>;
+  applySnapshot(snapshot: Uint8Array): MaybePromise<CrdtApplyReturn<TVersion>>;
   /** Exports incremental updates since `fromVersion`. Returns `null`/`undefined` when there are no new updates. */
   exportUpdates(fromVersion: TVersion): ExportedCrdtUpdateBatch<TVersion>;
   /**
@@ -460,7 +481,7 @@ interface CrdtAdapter<TVersion extends JsonObject> {
    * invariant to distinguish self-replay from another writer advancing the
    * remote version.
    */
-  applyRemoteUpdates(updates: Uint8Array[], remoterVersion: TVersion): MaybePromise<TVersion>;
+  applyRemoteUpdates(updates: Uint8Array[], remoterVersion: TVersion): MaybePromise<CrdtApplyReturn<TVersion>>;
   /**
    * Creates an isolated apply-only adapter for 410 recovery.
    *
@@ -503,11 +524,6 @@ interface EphemeralStreamCrdtOptions {
   readonly fetch?: (input: string, init?: RequestInit) => Promise<Response>;
   /** Reconnect policy for the SSE read loop and local POST retry loop. */
   readonly reconnectConfig?: Partial<ReconnectConfig>;
-  /**
-   * Interval for resending `adaptor.encodeAll()`. Set to `false` to disable.
-   * Defaults to 15 seconds, matching presence-style leases.
-   */
-  readonly heartbeatMs?: number | false;
   /** Enables diagnostic console logging for terminal read/write failures. */
   readonly debug?: boolean;
 }
@@ -636,6 +652,7 @@ declare class StreamsCrdt<TVersion extends JsonObject> implements StreamsCrdtLik
   private nextProducerSeq;
   private frozenLocalAppend?;
   private committedPendingCount?;
+  private committedLocalStreamCursor?;
   private readonly pendingWriteOnly;
   private writeOnlyCursor;
   private unsubscribeWriteOnlyLocal?;
@@ -713,8 +730,11 @@ declare class StreamsCrdt<TVersion extends JsonObject> implements StreamsCrdtLik
   private bootstrapState;
   private catchup;
   private catchupOrGone;
+  private recoverLiveIncompleteRemoteApply;
   private appendLocalBatch;
   private appendLocalBatchDurably;
+  private localAppendReadCursor;
+  private catchupLocalAppend;
   private appendLocalBatchRemote;
   private getOrCreateFrozenLocalAppend;
   private appendFrozenLocalBatchRemote;
@@ -723,6 +743,7 @@ declare class StreamsCrdt<TVersion extends JsonObject> implements StreamsCrdtLik
   private commitProducerAck;
   private abandonFrozenLocalAppend;
   private consumeCommittedPendingCount;
+  private consumeCommittedLocalStreamCursor;
   /**
    * Ensures the target stream exists, creating it if necessary.
    * Tolerates 409 Conflict (stream already created concurrently).
@@ -789,8 +810,6 @@ declare class EphemeralStreamCrdt {
   private readonly client;
   /** Retry policy shared by the read loop and local write queue. */
   private readonly reconnectConfig;
-  /** Period for republishing full local ephemeral state, or `false` to disable it. */
-  private readonly heartbeatMs;
   /** Enables diagnostic console errors for failed read/write loops. */
   private readonly debug;
   /** Current shared subscription state, if the stream is joined. */
@@ -814,8 +833,6 @@ declare class EphemeralStreamCrdt {
   private resolveFirstOpen;
   private rejectFirstOpen;
   private runReadLoop;
-  private startHeartbeat;
-  private enqueueFullState;
   private enqueueLocal;
   private flushPendingLocal;
   private notifySyncWaiters;
@@ -856,5 +873,5 @@ declare function createStreamUrl(input: {
   baseUrl?: string;
 }): string;
 //#endregion
-export { RemoteCursorStore as $, Result as A, TransportJoinParams as B, PayloadProtectionEncryptionOptions as C, PayloadProtectionReadPolicy as D, PayloadProtectionOptions as E, StreamsAuthProvider as F, WriteOnlyAppendResult as G, TransportSnapshotUploadSuccess as H, StreamsCrdtOptions as I, InMemoryRemoteCursorStore as J, BeforeRemoteCursorSaveContext as K, TransportCreateStreamSuccess as L, SnapshotTransformHook as M, SnapshotUploadOptions as N, PayloadProtectionScope as O, StreamsAuthContext as P, RemoteCursorSaveSource as Q, TransportDeleteStreamSuccess as R, JsonValue as S, PayloadProtectionKeyProvider as T, TransportSubscription as U, TransportRoomStatus as V, TransportSyncSuccess as W, IndexedDbRemoteCursorStoreOptions as X, IndexedDbRemoteCursorStore as Y, RemoteCursor as Z, EphemeralStreamCrdtOptions as _, EphemeralStreamCrdt as a, IsolatedCrdtAdapter as b, CrdtUpdateBatch as c, E2eeKeyProvider as d, createInitialRemoteCursor as et, E2eeOptions as f, EphemeralStreamAdaptor as g, E2eeWritePolicy as h, PayloadProtectionError as i, SnapshotCodec as j, PayloadProtectionWritePolicy as k, E2eeEncryptionOptions as l, E2eeScope as m, isValidBucketId as n, StreamsCrdt as o, E2eeReadPolicy as p, BeforeRemoteCursorSaveHook as q, isValidRillId as r, CrdtAdapter as s, createStreamUrl as t, E2eeKey as u, EphemeralStreamJoinParams as v, PayloadProtectionKey as w, JsonObject as x, EphemeralStreamSubscription as y, TransportError as z };
-//# sourceMappingURL=stream-id-BXJvwX_O.d.ts.map
+export { IndexedDbRemoteCursorStoreOptions as $, PayloadProtectionReadPolicy as A, TransportCreateStreamSuccess as B, IsolatedCrdtAdapter as C, PayloadProtectionKey as D, PayloadProtectionEncryptionOptions as E, SnapshotTransformHook as F, TransportSnapshotUploadSuccess as G, TransportError as H, SnapshotUploadOptions as I, WriteOnlyAppendResult as J, TransportSubscription as K, StreamsAuthContext as L, PayloadProtectionWritePolicy as M, Result as N, PayloadProtectionKeyProvider as O, SnapshotCodec as P, IndexedDbRemoteCursorStore as Q, StreamsAuthProvider as R, EphemeralStreamSubscription as S, JsonValue as T, TransportJoinParams as U, TransportDeleteStreamSuccess as V, TransportRoomStatus as W, BeforeRemoteCursorSaveHook as X, BeforeRemoteCursorSaveContext as Y, InMemoryRemoteCursorStore as Z, E2eeScope as _, EphemeralStreamCrdt as a, EphemeralStreamCrdtOptions as b, CrdtApplyOutcome as c, CrdtUpdateBatch as d, RemoteCursor as et, E2eeEncryptionOptions as f, E2eeReadPolicy as g, E2eeOptions as h, PayloadProtectionError as i, PayloadProtectionScope as j, PayloadProtectionOptions as k, CrdtApplyReturn as l, E2eeKeyProvider as m, isValidBucketId as n, RemoteCursorStore as nt, StreamsCrdt as o, E2eeKey as p, TransportSyncSuccess as q, isValidRillId as r, createInitialRemoteCursor as rt, CrdtAdapter as s, createStreamUrl as t, RemoteCursorSaveSource as tt, CrdtUnresolvedSpan as u, E2eeWritePolicy as v, JsonObject as w, EphemeralStreamJoinParams as x, EphemeralStreamAdaptor as y, StreamsCrdtOptions as z };
+//# sourceMappingURL=stream-id-Bi5rAZfP.d.ts.map