@loro-dev/streams-crdt 0.7.1 → 0.8.1

package/README.md

@@ -118,6 +118,103 @@ const sub = joined.value;
 checked out or detached, call `checkoutToLatest()` or `attach()` before passing
 it to `StreamsCrdt`.
 
+## 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 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
+subscribers instead of buffering every intermediate cursor or presence update.
+The client reconnects and receives a fresh bootstrap, so the local store
+converges to current state without requiring offset replay.
+
+```ts
+import { EphemeralStore } from "loro-crdt";
+import {
+  EphemeralStreamCrdt,
+  EphemeralStoreAdaptor,
+  createStreamUrl,
+} from "@loro-dev/streams-crdt/loro";
+
+const store = new EphemeralStore();
+const docStreamUrl = createStreamUrl({
+  bucketId: "my-bucket",
+  streamId: "doc-1",
+});
+
+const presence = new EphemeralStreamCrdt({
+  streamUrl: `${docStreamUrl}?ephemeral=presence`,
+  auth: async () => "<gateway-jwt>",
+  adaptor: EphemeralStoreAdaptor(store),
+});
+
+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

package/dist/flock.d.ts

@@ -1,4 +1,4 @@
-import { A as StreamsAuthProvider, B as WriteOnlyAppendResult, C as PayloadProtectionScope, D as SnapshotTransformHook, E as SnapshotCodec, F as TransportJoinParams, G as IndexedDbRemoteCursorStoreOptions, H as BeforeRemoteCursorSaveHook, I as TransportRoomStatus, J as RemoteCursorStore, K as RemoteCursor, L as TransportSnapshotUploadSuccess, M as TransportCreateStreamSuccess, N as TransportDeleteStreamSuccess, O as SnapshotUploadOptions, P as TransportError, R as TransportSubscription, S as PayloadProtectionReadPolicy, T as Result, U as InMemoryRemoteCursorStore, V as BeforeRemoteCursorSaveContext, W as IndexedDbRemoteCursorStore, Y as createInitialRemoteCursor, _ as JsonValue, a as StreamsCrdt, b as PayloadProtectionKeyProvider, c as E2eeEncryptionOptions, d as E2eeOptions, f as E2eeReadPolicy, g as JsonObject, h as IsolatedCrdtAdapter, i as PayloadProtectionError, j as StreamsCrdtOptions, k as StreamsAuthContext, l as E2eeKey, m as E2eeWritePolicy, n as isValidBucketId, o as CrdtAdapter, p as E2eeScope, q as RemoteCursorSaveSource, r as isValidRillId, s as CrdtUpdateBatch, t as createStreamUrl, u as E2eeKeyProvider, v as PayloadProtectionEncryptionOptions, w as PayloadProtectionWritePolicy, x as PayloadProtectionOptions, y as PayloadProtectionKey, z as TransportSyncSuccess } from "./stream-id-CS7SzuLW.js";
+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-B6FzWgkM.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, 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, 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 PayloadProtectionError, c as createInitialRemoteCursor, i as StreamsCrdt, n as isValidBucketId, o as InMemoryRemoteCursorStore, r as isValidRillId, s as IndexedDbRemoteCursorStore, t as createStreamUrl } from "./stream-id-D0qcbI5c.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-CCPEBb6G.js";
 import { Flock } from "@loro-dev/flock-wasm";
 //#region src/flock.ts
 function isAfter(entry, current) {
@@ -149,6 +149,6 @@ function createFlockAdapter(flock) {
 	};
 }
 //#endregion
-export { PayloadProtectionError as E2eeError, PayloadProtectionError, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, StreamsCrdt, createFlockAdapter, createInitialRemoteCursor, createStreamUrl, isValidBucketId, isValidRillId };
+export { PayloadProtectionError as E2eeError, PayloadProtectionError, EphemeralStreamCrdt, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, StreamsCrdt, createFlockAdapter, createInitialRemoteCursor, createStreamUrl, isValidBucketId, isValidRillId };
 
 //# sourceMappingURL=flock.js.map

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,2 +1,2 @@
-import { a as PayloadProtectionError, c as createInitialRemoteCursor, i as StreamsCrdt, n as isValidBucketId, o as InMemoryRemoteCursorStore, r as isValidRillId, s as IndexedDbRemoteCursorStore, t as createStreamUrl } from "./stream-id-D0qcbI5c.js";
-export { PayloadProtectionError as E2eeError, PayloadProtectionError, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, StreamsCrdt, createInitialRemoteCursor, createStreamUrl, isValidBucketId, isValidRillId };
+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-CCPEBb6G.js";
+export { PayloadProtectionError as E2eeError, PayloadProtectionError, EphemeralStreamCrdt, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, StreamsCrdt, createInitialRemoteCursor, createStreamUrl, isValidBucketId, isValidRillId };

package/dist/loro.d.ts

@@ -1,4 +1,4 @@
-import { A as StreamsAuthProvider, B as WriteOnlyAppendResult, C as PayloadProtectionScope, D as SnapshotTransformHook, E as SnapshotCodec, F as TransportJoinParams, G as IndexedDbRemoteCursorStoreOptions, H as BeforeRemoteCursorSaveHook, I as TransportRoomStatus, J as RemoteCursorStore, K as RemoteCursor, L as TransportSnapshotUploadSuccess, M as TransportCreateStreamSuccess, N as TransportDeleteStreamSuccess, O as SnapshotUploadOptions, P as TransportError, R as TransportSubscription, S as PayloadProtectionReadPolicy, T as Result, U as InMemoryRemoteCursorStore, V as BeforeRemoteCursorSaveContext, W as IndexedDbRemoteCursorStore, Y as createInitialRemoteCursor, _ as JsonValue, a as StreamsCrdt, b as PayloadProtectionKeyProvider, c as E2eeEncryptionOptions, d as E2eeOptions, f as E2eeReadPolicy, g as JsonObject, h as IsolatedCrdtAdapter, i as PayloadProtectionError, j as StreamsCrdtOptions, k as StreamsAuthContext, l as E2eeKey, m as E2eeWritePolicy, n as isValidBucketId, o as CrdtAdapter, p as E2eeScope, q as RemoteCursorSaveSource, r as isValidRillId, s as CrdtUpdateBatch, t as createStreamUrl, u as E2eeKeyProvider, v as PayloadProtectionEncryptionOptions, w as PayloadProtectionWritePolicy, x as PayloadProtectionOptions, y as PayloadProtectionKey, z as TransportSyncSuccess } from "./stream-id-CS7SzuLW.js";
+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-B6FzWgkM.js";
 import { LoroDoc } from "loro-crdt";
 
 //#region src/loro.d.ts
@@ -17,6 +17,29 @@ import { LoroDoc } from "loro-crdt";
  * ```
  */
 declare function createLoroDocAdapter(doc: LoroDoc): CrdtAdapter<JsonObject>;
+/**
+ * Structural subset of Loro's `EphemeralStore`.
+ */
+interface LoroEphemeralStoreLike {
+  /** Applies one opaque Loro ephemeral update. */
+  apply(update: Uint8Array): void;
+  /** Subscribes to locally produced ephemeral updates. */
+  subscribeLocalUpdates(listener: (update: Uint8Array) => void): () => void;
+}
+/**
+ * Creates an ephemeral stream adaptor for a Loro `EphemeralStore`.
+ *
+ * @example
+ * ```ts
+ * const room = new EphemeralStreamCrdt({
+ *   streamUrl,
+ *   auth,
+ *   adaptor: EphemeralStoreAdaptor(store),
+ * });
+ * ```
+ */
+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, 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, createLoroDocAdapter, createStreamUrl, isValidBucketId, isValidRillId };
+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 };
 //# sourceMappingURL=loro.d.ts.map

package/dist/loro.js

@@ -1,4 +1,4 @@
-import { a as PayloadProtectionError, c as createInitialRemoteCursor, i as StreamsCrdt, n as isValidBucketId, o as InMemoryRemoteCursorStore, r as isValidRillId, s as IndexedDbRemoteCursorStore, t as createStreamUrl } from "./stream-id-D0qcbI5c.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-CCPEBb6G.js";
 import { LoroDoc, VersionVector, decodeImportBlobMeta } from "loro-crdt";
 //#region src/loro.ts
 function batchImportUpdates(doc, updates) {
@@ -125,7 +125,42 @@ function createLoroDocAdapter(doc) {
 		}
 	};
 }
+/**
+* Creates an ephemeral stream adaptor for a Loro `EphemeralStore`.
+*
+* @example
+* ```ts
+* const room = new EphemeralStreamCrdt({
+*   streamUrl,
+*   auth,
+*   adaptor: EphemeralStoreAdaptor(store),
+* });
+* ```
+*/
+function EphemeralStoreAdaptor(store) {
+	let applyingRemoteDepth = 0;
+	return {
+		applyRemoteUpdates: (updates) => {
+			applyingRemoteDepth += 1;
+			try {
+				for (const update of updates) store.apply(update);
+			} finally {
+				applyingRemoteDepth -= 1;
+			}
+		},
+		subscribeLocalUpdates: (listener) => {
+			const unsubscribeLocalUpdates = store.subscribeLocalUpdates((update) => {
+				if (applyingRemoteDepth > 0) return;
+				listener(update);
+			});
+			return () => {
+				unsubscribeLocalUpdates();
+			};
+		}
+	};
+}
+const createLoroEphemeralStoreAdaptor = EphemeralStoreAdaptor;
 //#endregion
-export { PayloadProtectionError as E2eeError, PayloadProtectionError, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, StreamsCrdt, createInitialRemoteCursor, createLoroDocAdapter, createStreamUrl, isValidBucketId, isValidRillId };
+export { PayloadProtectionError as E2eeError, PayloadProtectionError, EphemeralStoreAdaptor, EphemeralStreamCrdt, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, StreamsCrdt, createInitialRemoteCursor, createLoroDocAdapter, createLoroEphemeralStoreAdaptor, createStreamUrl, isValidBucketId, isValidRillId };
 
 //# sourceMappingURL=loro.js.map

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\";\n\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"],"mappings":"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"}
+{"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  /** 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-CS7SzuLW.d.ts → stream-id-B6FzWgkM.d.ts}

@@ -392,6 +392,25 @@ interface TransportSubscription {
    */
   readonly waitUntilSynced: () => Promise<void>;
 }
+/**
+ * Adapter contract for CRDT-like ephemeral stores.
+ *
+ * Ephemeral transports bootstrap through the first SSE event, then continue
+ * with live deltas only. They do not expose checkpoints, snapshots, or
+ * replayable offset history. Outbound data is limited to updates emitted by
+ * `subscribeLocalUpdates()` so imported remote presence is never republished.
+ */
+interface EphemeralStreamAdaptor {
+  /** Applies updates received from the remote ephemeral stream. */
+  applyRemoteUpdates(updates: readonly Uint8Array[]): MaybePromise<void>;
+  /** Subscribes to local ephemeral updates. Returns an unsubscribe function. */
+  subscribeLocalUpdates(listener: (update: Uint8Array) => void): () => void;
+}
+interface EphemeralStreamJoinParams {
+  /** Called when the live ephemeral subscription status changes. */
+  readonly onStatusChange?: (status: "connecting" | TransportRoomStatus) => void;
+}
+interface EphemeralStreamSubscription extends TransportSubscription {}
 /**
  * Local CRDT updates ready to append to Durable Streams.
  */
@@ -462,6 +481,29 @@ interface CrdtAdapter<TVersion extends JsonObject> {
   /** Optional headers to include when creating the stream (e.g. retention config). */
   getCreateStreamHeaders?(): MaybePromise<Record<string, string>>;
 }
+interface EphemeralStreamCrdtOptions {
+  /**
+   * Full ephemeral stream URL.
+   *
+   * The URL must include the channel query, usually
+   * `?ephemeral=presence` or the compatibility alias `?awareness=presence`.
+   */
+  readonly streamUrl: string;
+  /**
+   * Ephemeral store adaptor.
+   *
+   * The public spelling intentionally matches Loro's "adaptor" examples.
+   */
+  readonly adaptor: EphemeralStreamAdaptor;
+  /** Auth token source used for ephemeral POST and SSE requests. */
+  readonly auth?: StreamsAuthProvider;
+  /** Optional fetch implementation for tests, workers, or custom runtimes. */
+  readonly fetch?: (input: string, init?: RequestInit) => Promise<Response>;
+  /** Reconnect policy for the SSE read loop and local POST retry loop. */
+  readonly reconnectConfig?: Partial<ReconnectConfig>;
+  /** Enables diagnostic console logging for terminal read/write failures. */
+  readonly debug?: boolean;
+}
 /**
  * Construction options for one `StreamsCrdt` instance.
  *
@@ -585,6 +627,8 @@ declare class StreamsCrdt<TVersion extends JsonObject> implements StreamsCrdtLik
   private readonly producerId;
   private producerEpoch;
   private nextProducerSeq;
+  private frozenLocalAppend?;
+  private committedPendingCount?;
   private readonly pendingWriteOnly;
   private writeOnlyCursor;
   private unsubscribeWriteOnlyLocal?;
@@ -663,6 +707,15 @@ declare class StreamsCrdt<TVersion extends JsonObject> implements StreamsCrdtLik
   private catchup;
   private catchupOrGone;
   private appendLocalBatch;
+  private appendLocalBatchDurably;
+  private appendLocalBatchRemote;
+  private getOrCreateFrozenLocalAppend;
+  private appendFrozenLocalBatchRemote;
+  private finalizeDirectLocalAppendIfNeeded;
+  private createCurrentProducerSession;
+  private commitProducerAck;
+  private abandonFrozenLocalAppend;
+  private consumeCommittedPendingCount;
   /**
    * Ensures the target stream exists, creating it if necessary.
    * Tolerates 409 Conflict (stream already created concurrently).
@@ -712,6 +765,57 @@ declare class StreamsCrdt<TVersion extends JsonObject> implements StreamsCrdtLik
   private logError;
 }
 //#endregion
+//#region src/ephemeral-runtime.d.ts
+/**
+ * Realtime transport for one ephemeral CRDT stream.
+ *
+ * This is intentionally separate from `StreamsCrdt`: it bootstraps through
+ * the first SSE event, then tails live deltas, and never stores a replay
+ * offset, snapshot checkpoint, or remote cursor.
+ */
+declare class EphemeralStreamCrdt {
+  /** Full ephemeral stream URL, including `?ephemeral=` or `?awareness=`. */
+  readonly streamUrl: string;
+  /** Store-specific adapter used to encode local state and apply remote bytes. */
+  readonly adaptor: EphemeralStreamAdaptor;
+  /** Low-level HTTP/SSE transport. It is reused only for auth, fetch, and parsing helpers. */
+  private readonly client;
+  /** Retry policy shared by the read loop and local write queue. */
+  private readonly reconnectConfig;
+  /** Enables diagnostic console errors for failed read/write loops. */
+  private readonly debug;
+  /** Current shared subscription state, if the stream is joined. */
+  private joinState?;
+  constructor(options: EphemeralStreamCrdtOptions);
+  join(params?: EphemeralStreamJoinParams): Promise<{
+    readonly ok: true;
+    readonly value: EphemeralStreamSubscription;
+  } | {
+    readonly ok: false;
+    readonly error: TransportError;
+  }>;
+  rejoin(): void;
+  close(): Promise<void>;
+  private createJoinState;
+  private startJoin;
+  private waitForFirstOpen;
+  private createSubscription;
+  private onStatusChange;
+  private disposeJoinState;
+  private resolveFirstOpen;
+  private rejectFirstOpen;
+  private runReadLoop;
+  private enqueueLocal;
+  private flushPendingLocal;
+  private notifySyncWaiters;
+  private rejectSyncWaiters;
+  private setReadStatus;
+  private setWriteStatus;
+  private recomputeStatus;
+  private computeStatus;
+  private logError;
+}
+//#endregion
 //#region src/payload-protection.d.ts
 type PayloadProtectionFailureReason = "plaintext_forbidden" | "missing_read_key" | "decrypt_failed" | "invalid_envelope" | "wrong_payload_kind" | "encrypt_failed";
 declare class PayloadProtectionError extends Error {
@@ -741,5 +845,5 @@ declare function createStreamUrl(input: {
   baseUrl?: string;
 }): string;
 //#endregion
-export { StreamsAuthProvider as A, WriteOnlyAppendResult as B, PayloadProtectionScope as C, SnapshotTransformHook as D, SnapshotCodec as E, TransportJoinParams as F, IndexedDbRemoteCursorStoreOptions as G, BeforeRemoteCursorSaveHook as H, TransportRoomStatus as I, RemoteCursorStore as J, RemoteCursor as K, TransportSnapshotUploadSuccess as L, TransportCreateStreamSuccess as M, TransportDeleteStreamSuccess as N, SnapshotUploadOptions as O, TransportError as P, TransportSubscription as R, PayloadProtectionReadPolicy as S, Result as T, InMemoryRemoteCursorStore as U, BeforeRemoteCursorSaveContext as V, IndexedDbRemoteCursorStore as W, createInitialRemoteCursor as Y, JsonValue as _, StreamsCrdt as a, PayloadProtectionKeyProvider as b, E2eeEncryptionOptions as c, E2eeOptions as d, E2eeReadPolicy as f, JsonObject as g, IsolatedCrdtAdapter as h, PayloadProtectionError as i, StreamsCrdtOptions as j, StreamsAuthContext as k, E2eeKey as l, E2eeWritePolicy as m, isValidBucketId as n, CrdtAdapter as o, E2eeScope as p, RemoteCursorSaveSource as q, isValidRillId as r, CrdtUpdateBatch as s, createStreamUrl as t, E2eeKeyProvider as u, PayloadProtectionEncryptionOptions as v, PayloadProtectionWritePolicy as w, PayloadProtectionOptions as x, PayloadProtectionKey as y, TransportSyncSuccess as z };
-//# sourceMappingURL=stream-id-CS7SzuLW.d.ts.map
+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-B6FzWgkM.d.ts.map