@loro-dev/streams-crdt 0.7.1 → 0.8.0

package/README.md

@@ -118,6 +118,43 @@ 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 periodically re-announces `store.encodeAll()` so reconnecting peers can
+recover the current live state without replaying old presence history.
+
+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;
+```
+
 ## 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-BXJvwX_O.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-CF1egQDz.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-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 };

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-CF1egQDz.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-BXJvwX_O.js";
 import { LoroDoc } from "loro-crdt";
 
 //#region src/loro.d.ts
@@ -17,6 +17,31 @@ import { LoroDoc } from "loro-crdt";
  * ```
  */
 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. */
+  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-CF1egQDz.js";
 import { LoroDoc, VersionVector, decodeImportBlobMeta } from "loro-crdt";
 //#region src/loro.ts
 function batchImportUpdates(doc, updates) {
@@ -125,7 +125,29 @@ 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) {
+	return {
+		encodeAll: () => store.encodeAll(),
+		applyRemoteUpdates: (updates) => {
+			for (const update of updates) store.apply(update);
+		},
+		subscribeLocalUpdates: (listener) => store.subscribeLocalUpdates(listener)
+	};
+}
+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  /** 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":"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"}

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

@@ -392,6 +392,27 @@ 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. `encodeAll()` is sent on join/reconnect/heartbeat
+ * so peers can converge on the caller's current presence state.
+ */
+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. */
+  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 +483,34 @@ 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>;
+  /**
+   * 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;
+}
 /**
  * Construction options for one `StreamsCrdt` instance.
  *
@@ -585,6 +634,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 +714,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 +772,61 @@ 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;
+  /** 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. */
+  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 startHeartbeat;
+  private enqueueFullState;
+  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 +856,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-BXJvwX_O.d.ts.map