@loro-dev/streams-crdt 0.1.0 → 0.1.1

package/README.md

@@ -295,6 +295,91 @@ The required ordering is:
 If you cannot provide steps 1 and 3, do not use a persisted remote cursor
 store.
 
+## Snapshot Codec Hooks
+
+Use `snapshotCodec` when you want transport to transform full snapshots during
+upload and bootstrap:
+
+```ts
+const transport = new StreamsCrdt({
+  streamUrl,
+  adapter: createLoroDocAdapter(doc),
+  snapshotCodec: {
+    // Sync or async are both allowed.
+    compress: async (snapshot) => snapshot,
+    decompress: (snapshot) => snapshot,
+  },
+});
+```
+
+### Behavior
+
+- `snapshotCodec.compress(snapshot)` runs right before a snapshot is uploaded to
+  Loro Streams
+- `snapshotCodec.decompress(snapshot)` runs right after a non-empty snapshot is
+  downloaded from Loro Streams and right before `adapter.applySnapshot(...)`
+- Both hooks must be provided together
+- Both hooks may return either `Uint8Array` or `Promise<Uint8Array>`
+- These hooks affect **full snapshots only**. Incremental update batches are
+  unchanged
+
+### Compatibility
+
+Transport does not version or negotiate snapshot codecs for you.
+
+If you enable `snapshotCodec`, you must make sure `decompress` can still read
+any older snapshots that are already stored for that stream. This is especially
+important when:
+
+- existing snapshots were uploaded without compression
+- you change the compression format later
+- you roll out the codec gradually across clients
+
+### `@loro-dev/streams-crdt/zstd`
+
+`@loro-dev/streams-crdt/zstd` is an optional helper entry point built on top of
+[`@bokuweb/zstd-wasm`](https://www.npmjs.com/package/@bokuweb/zstd-wasm).
+
+Install the optional peer dependency first:
+
+```bash
+pnpm add @loro-dev/streams-crdt @bokuweb/zstd-wasm
+```
+
+Then wire the exported hooks directly into `snapshotCodec`:
+
+```ts
+import { LoroDoc } from "loro-crdt";
+import {
+  createLoroDocAdapter,
+  createStreamUrl,
+  StreamsCrdt,
+} from "@loro-dev/streams-crdt/loro";
+import {
+  compress,
+  decompress,
+} from "@loro-dev/streams-crdt/zstd";
+
+const doc = new LoroDoc();
+const transport = new StreamsCrdt({
+  streamUrl: createStreamUrl({
+    bucketId: "my-bucket",
+    streamId: "doc-1",
+  }),
+  adapter: createLoroDocAdapter(doc),
+  snapshotCodec: { compress, decompress },
+});
+```
+
+`@loro-dev/streams-crdt/zstd` exports:
+
+- `compress(snapshot)` — async; uses an extra Worker when available and falls
+  back to the current thread otherwise
+- `compressInWorker(snapshot)` — async; worker-only compression helper
+- `compressOnCurrentThread(snapshot)` — async; current-thread compression
+  helper
+- `decompress(snapshot)` — async; current-thread decompression helper
+
 ## Automatic Snapshot Upload
 
 The transport can upload snapshots automatically during `join()` when callers
@@ -348,6 +433,7 @@ const transport = new StreamsCrdt({
 | `@loro-dev/streams-crdt` | Transport core, cursor stores, ID helpers, all shared types |
 | `@loro-dev/streams-crdt/loro` | Everything above + `createLoroDocAdapter(doc)` |
 | `@loro-dev/streams-crdt/flock` | Everything above + `createFlockAdapter(flock)` |
+| `@loro-dev/streams-crdt/zstd` | Snapshot `compress` / `decompress` hooks backed by `@bokuweb/zstd-wasm` |
 
 ## Public API Reference
 
@@ -364,6 +450,7 @@ const transport = new StreamsCrdt({
 - `TransportJoinParams` — `join()` options
 - `TransportSubscription` — active live subscription handle
 - `TransportRoomStatus` — `"joined" | "reconnecting" | "disconnected" | "error"`
+- `SnapshotCodec`, `SnapshotTransformHook` — full snapshot encode/decode hooks
 - `SnapshotUploadOptions` — snapshot upload configuration
 - `RemoteCursor` — replay progress metadata
 - `RemoteCursorStore` — abstract cursor storage interface
@@ -389,6 +476,16 @@ const transport = new StreamsCrdt({
 - `createFlockAdapter(flock)` — creates a `CrdtAdapter` for one `Flock` replica
 - `FlockVersionVector` — Flock-specific version vector type
 
+### Zstd Entry Point
+
+`@loro-dev/streams-crdt/zstd` exports:
+
+- `compress(snapshot)` — async snapshot compression helper
+- `compressInWorker(snapshot)` — async worker-only snapshot compression helper
+- `compressOnCurrentThread(snapshot)` — async current-thread snapshot
+  compression helper
+- `decompress(snapshot)` — async snapshot decompression helper
+
 ## Notes
 
 - `createStreamIfMissing` defaults to `false` and only affects the initial sync/join bootstrap

package/dist/flock.d.ts

@@ -1,4 +1,4 @@
-import { C as IndexedDbRemoteCursorStore, D as RemoteCursorStore, E as RemoteCursorSaveSource, O as createInitialRemoteCursor, S as InMemoryRemoteCursorStore, T as RemoteCursor, _ as TransportRoomStatus, a as CrdtAdapter, b as BeforeRemoteCursorSaveContext, c as JsonValue, d as StreamsAuthProvider, f as StreamsCrdtOptions, g as TransportJoinParams, h as TransportError, i as StreamsCrdt, l as Result, m as TransportDeleteStreamSuccess, n as isValidBucketId, o as CrdtUpdateBatch, p as TransportCreateStreamSuccess, r as isValidRillId, s as JsonObject, t as createStreamUrl, u as SnapshotUploadOptions, v as TransportSubscription, w as IndexedDbRemoteCursorStoreOptions, x as BeforeRemoteCursorSaveHook, y as TransportSyncSuccess } from "./stream-id-1f2mhtmk.js";
+import { A as createInitialRemoteCursor, C as BeforeRemoteCursorSaveHook, D as RemoteCursor, E as IndexedDbRemoteCursorStoreOptions, O as RemoteCursorSaveSource, S as BeforeRemoteCursorSaveContext, T as IndexedDbRemoteCursorStore, _ as TransportError, a as CrdtAdapter, b as TransportSubscription, c as JsonValue, d as SnapshotTransformHook, f as SnapshotUploadOptions, g as TransportDeleteStreamSuccess, h as TransportCreateStreamSuccess, i as StreamsCrdt, k as RemoteCursorStore, l as Result, m as StreamsCrdtOptions, n as isValidBucketId, o as CrdtUpdateBatch, p as StreamsAuthProvider, r as isValidRillId, s as JsonObject, t as createStreamUrl, u as SnapshotCodec, v as TransportJoinParams, w as InMemoryRemoteCursorStore, x as TransportSyncSuccess, y as TransportRoomStatus } from "./stream-id-B9n-uFFB.js";
 
 //#region src/flock.d.ts
 type FlockVersionEntry = {
@@ -32,5 +32,5 @@ type FlockLike = {
  */
 declare function createFlockAdapter(flock: FlockLike): CrdtAdapter<JsonObject>;
 //#endregion
-export { BeforeRemoteCursorSaveContext, BeforeRemoteCursorSaveHook, CrdtAdapter, CrdtUpdateBatch, FlockVersionVector, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, IndexedDbRemoteCursorStoreOptions, JsonObject, JsonValue, RemoteCursor, RemoteCursorSaveSource, RemoteCursorStore, Result, SnapshotUploadOptions, StreamsAuthProvider, StreamsCrdt, StreamsCrdtOptions, TransportCreateStreamSuccess, TransportDeleteStreamSuccess, TransportError, TransportJoinParams, TransportRoomStatus, TransportSubscription, TransportSyncSuccess, createFlockAdapter, createInitialRemoteCursor, createStreamUrl, isValidBucketId, isValidRillId };
+export { BeforeRemoteCursorSaveContext, BeforeRemoteCursorSaveHook, CrdtAdapter, CrdtUpdateBatch, FlockVersionVector, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, IndexedDbRemoteCursorStoreOptions, JsonObject, JsonValue, RemoteCursor, RemoteCursorSaveSource, RemoteCursorStore, Result, SnapshotCodec, SnapshotTransformHook, SnapshotUploadOptions, StreamsAuthProvider, StreamsCrdt, StreamsCrdtOptions, TransportCreateStreamSuccess, TransportDeleteStreamSuccess, TransportError, TransportJoinParams, TransportRoomStatus, TransportSubscription, TransportSyncSuccess, createFlockAdapter, createInitialRemoteCursor, createStreamUrl, isValidBucketId, isValidRillId };
 //# sourceMappingURL=flock.d.ts.map

package/dist/flock.js

@@ -1,4 +1,4 @@
-import { a as InMemoryRemoteCursorStore, i as StreamsCrdt, n as isValidBucketId, o as IndexedDbRemoteCursorStore, r as isValidRillId, s as createInitialRemoteCursor, t as createStreamUrl } from "./stream-id-CIhmveJD.js";
+import { a as InMemoryRemoteCursorStore, i as StreamsCrdt, n as isValidBucketId, o as IndexedDbRemoteCursorStore, r as isValidRillId, s as createInitialRemoteCursor, t as createStreamUrl } from "./stream-id-YOFZ4I6Y.js";
 //#region src/flock.ts
 function toVersionVector(version) {
 	const out = {};

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { C as IndexedDbRemoteCursorStore, D as RemoteCursorStore, E as RemoteCursorSaveSource, O as createInitialRemoteCursor, S as InMemoryRemoteCursorStore, T as RemoteCursor, _ as TransportRoomStatus, a as CrdtAdapter, b as BeforeRemoteCursorSaveContext, c as JsonValue, d as StreamsAuthProvider, f as StreamsCrdtOptions, g as TransportJoinParams, h as TransportError, i as StreamsCrdt, l as Result, m as TransportDeleteStreamSuccess, n as isValidBucketId, o as CrdtUpdateBatch, p as TransportCreateStreamSuccess, r as isValidRillId, s as JsonObject, t as createStreamUrl, u as SnapshotUploadOptions, v as TransportSubscription, w as IndexedDbRemoteCursorStoreOptions, x as BeforeRemoteCursorSaveHook, y as TransportSyncSuccess } from "./stream-id-1f2mhtmk.js";
-export { BeforeRemoteCursorSaveContext, BeforeRemoteCursorSaveHook, CrdtAdapter, CrdtUpdateBatch, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, IndexedDbRemoteCursorStoreOptions, JsonObject, JsonValue, RemoteCursor, RemoteCursorSaveSource, RemoteCursorStore, Result, SnapshotUploadOptions, StreamsAuthProvider, StreamsCrdt, StreamsCrdtOptions, TransportCreateStreamSuccess, TransportDeleteStreamSuccess, TransportError, TransportJoinParams, TransportRoomStatus, TransportSubscription, TransportSyncSuccess, createInitialRemoteCursor, createStreamUrl, isValidBucketId, isValidRillId };
+import { A as createInitialRemoteCursor, C as BeforeRemoteCursorSaveHook, D as RemoteCursor, E as IndexedDbRemoteCursorStoreOptions, O as RemoteCursorSaveSource, S as BeforeRemoteCursorSaveContext, T as IndexedDbRemoteCursorStore, _ as TransportError, a as CrdtAdapter, b as TransportSubscription, c as JsonValue, d as SnapshotTransformHook, f as SnapshotUploadOptions, g as TransportDeleteStreamSuccess, h as TransportCreateStreamSuccess, i as StreamsCrdt, k as RemoteCursorStore, l as Result, m as StreamsCrdtOptions, n as isValidBucketId, o as CrdtUpdateBatch, p as StreamsAuthProvider, r as isValidRillId, s as JsonObject, t as createStreamUrl, u as SnapshotCodec, v as TransportJoinParams, w as InMemoryRemoteCursorStore, x as TransportSyncSuccess, y as TransportRoomStatus } from "./stream-id-B9n-uFFB.js";
+export { BeforeRemoteCursorSaveContext, BeforeRemoteCursorSaveHook, CrdtAdapter, CrdtUpdateBatch, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, IndexedDbRemoteCursorStoreOptions, JsonObject, JsonValue, RemoteCursor, RemoteCursorSaveSource, RemoteCursorStore, Result, SnapshotCodec, SnapshotTransformHook, SnapshotUploadOptions, StreamsAuthProvider, StreamsCrdt, StreamsCrdtOptions, TransportCreateStreamSuccess, TransportDeleteStreamSuccess, TransportError, TransportJoinParams, TransportRoomStatus, TransportSubscription, TransportSyncSuccess, createInitialRemoteCursor, createStreamUrl, isValidBucketId, isValidRillId };

package/dist/index.js

@@ -1,2 +1,2 @@
-import { a as InMemoryRemoteCursorStore, i as StreamsCrdt, n as isValidBucketId, o as IndexedDbRemoteCursorStore, r as isValidRillId, s as createInitialRemoteCursor, t as createStreamUrl } from "./stream-id-CIhmveJD.js";
+import { a as InMemoryRemoteCursorStore, i as StreamsCrdt, n as isValidBucketId, o as IndexedDbRemoteCursorStore, r as isValidRillId, s as createInitialRemoteCursor, t as createStreamUrl } from "./stream-id-YOFZ4I6Y.js";
 export { InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, StreamsCrdt, createInitialRemoteCursor, createStreamUrl, isValidBucketId, isValidRillId };

package/dist/loro.d.ts

@@ -1,4 +1,4 @@
-import { C as IndexedDbRemoteCursorStore, D as RemoteCursorStore, E as RemoteCursorSaveSource, O as createInitialRemoteCursor, S as InMemoryRemoteCursorStore, T as RemoteCursor, _ as TransportRoomStatus, a as CrdtAdapter, b as BeforeRemoteCursorSaveContext, c as JsonValue, d as StreamsAuthProvider, f as StreamsCrdtOptions, g as TransportJoinParams, h as TransportError, i as StreamsCrdt, l as Result, m as TransportDeleteStreamSuccess, n as isValidBucketId, o as CrdtUpdateBatch, p as TransportCreateStreamSuccess, r as isValidRillId, s as JsonObject, t as createStreamUrl, u as SnapshotUploadOptions, v as TransportSubscription, w as IndexedDbRemoteCursorStoreOptions, x as BeforeRemoteCursorSaveHook, y as TransportSyncSuccess } from "./stream-id-1f2mhtmk.js";
+import { A as createInitialRemoteCursor, C as BeforeRemoteCursorSaveHook, D as RemoteCursor, E as IndexedDbRemoteCursorStoreOptions, O as RemoteCursorSaveSource, S as BeforeRemoteCursorSaveContext, T as IndexedDbRemoteCursorStore, _ as TransportError, a as CrdtAdapter, b as TransportSubscription, c as JsonValue, d as SnapshotTransformHook, f as SnapshotUploadOptions, g as TransportDeleteStreamSuccess, h as TransportCreateStreamSuccess, i as StreamsCrdt, k as RemoteCursorStore, l as Result, m as StreamsCrdtOptions, n as isValidBucketId, o as CrdtUpdateBatch, p as StreamsAuthProvider, r as isValidRillId, s as JsonObject, t as createStreamUrl, u as SnapshotCodec, v as TransportJoinParams, w as InMemoryRemoteCursorStore, x as TransportSyncSuccess, y as TransportRoomStatus } from "./stream-id-B9n-uFFB.js";
 import { LoroDoc } from "loro-crdt";
 
 //#region src/loro.d.ts
@@ -18,5 +18,5 @@ import { LoroDoc } from "loro-crdt";
  */
 declare function createLoroDocAdapter(doc: LoroDoc): CrdtAdapter<JsonObject>;
 //#endregion
-export { BeforeRemoteCursorSaveContext, BeforeRemoteCursorSaveHook, CrdtAdapter, CrdtUpdateBatch, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, IndexedDbRemoteCursorStoreOptions, JsonObject, JsonValue, RemoteCursor, RemoteCursorSaveSource, RemoteCursorStore, Result, SnapshotUploadOptions, StreamsAuthProvider, StreamsCrdt, StreamsCrdtOptions, TransportCreateStreamSuccess, TransportDeleteStreamSuccess, TransportError, TransportJoinParams, TransportRoomStatus, TransportSubscription, TransportSyncSuccess, createInitialRemoteCursor, createLoroDocAdapter, createStreamUrl, isValidBucketId, isValidRillId };
+export { BeforeRemoteCursorSaveContext, BeforeRemoteCursorSaveHook, CrdtAdapter, CrdtUpdateBatch, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, IndexedDbRemoteCursorStoreOptions, JsonObject, JsonValue, RemoteCursor, RemoteCursorSaveSource, RemoteCursorStore, Result, SnapshotCodec, SnapshotTransformHook, SnapshotUploadOptions, StreamsAuthProvider, StreamsCrdt, StreamsCrdtOptions, TransportCreateStreamSuccess, TransportDeleteStreamSuccess, TransportError, TransportJoinParams, TransportRoomStatus, TransportSubscription, TransportSyncSuccess, createInitialRemoteCursor, createLoroDocAdapter, createStreamUrl, isValidBucketId, isValidRillId };
 //# sourceMappingURL=loro.d.ts.map

package/dist/loro.js

@@ -1,4 +1,4 @@
-import { a as InMemoryRemoteCursorStore, i as StreamsCrdt, n as isValidBucketId, o as IndexedDbRemoteCursorStore, r as isValidRillId, s as createInitialRemoteCursor, t as createStreamUrl } from "./stream-id-CIhmveJD.js";
+import { a as InMemoryRemoteCursorStore, i as StreamsCrdt, n as isValidBucketId, o as IndexedDbRemoteCursorStore, r as isValidRillId, s as createInitialRemoteCursor, t as createStreamUrl } from "./stream-id-YOFZ4I6Y.js";
 import { VersionVector, decodeImportBlobMeta } from "loro-crdt";
 //#region src/loro.ts
 function toDocVersionRecord(version) {

package/dist/{stream-id-1f2mhtmk.d.ts → stream-id-B9n-uFFB.d.ts}

@@ -239,6 +239,24 @@ interface SnapshotUploadOptions {
   /** Minimum byte delta since the last remote snapshot before uploading. */
   readonly minBytesSinceRemoteSnapshot?: number;
 }
+/**
+ * Transforms a remote snapshot payload during upload or bootstrap.
+ */
+type SnapshotTransformHook = (snapshot: Uint8Array) => MaybePromise<Uint8Array>;
+/**
+ * Optional snapshot codec hooks used only for full snapshot upload/bootstrap.
+ *
+ * `compress` runs before transport uploads a snapshot to Loro Streams.
+ * `decompress` runs after transport downloads a non-empty snapshot and before
+ * the adapter imports it.
+ *
+ * Callers own compatibility with any snapshots that were already uploaded
+ * without this codec or with an older codec revision.
+ */
+interface SnapshotCodec {
+  readonly compress: SnapshotTransformHook;
+  readonly decompress: SnapshotTransformHook;
+}
 /**
  * Active live subscription returned by `join()`.
  *
@@ -334,6 +352,17 @@ interface StreamsCrdtOptions<TVersion extends JsonObject> {
    * hooks.
    */
   readonly beforeRemoteCursorSaveHooks?: ReadonlyArray<BeforeRemoteCursorSaveHook<TVersion>>;
+  /**
+   * Optional codec hooks for full snapshots only.
+   *
+   * Both hooks must be provided together. If set, transport compresses the
+   * adapter snapshot before upload and decompresses downloaded snapshots before
+   * `applySnapshot()`.
+   *
+   * Callers must keep compatibility with any older snapshots already stored on
+   * the server.
+   */
+  readonly snapshotCodec?: SnapshotCodec;
   readonly snapshotUpload?: SnapshotUploadOptions;
   readonly reconnectConfig?: Partial<ReconnectConfig>;
   readonly debug?: boolean;
@@ -459,5 +488,5 @@ declare function createStreamUrl(input: {
   baseUrl?: string;
 }): string;
 //#endregion
-export { IndexedDbRemoteCursorStore as C, RemoteCursorStore as D, RemoteCursorSaveSource as E, createInitialRemoteCursor as O, InMemoryRemoteCursorStore as S, RemoteCursor as T, TransportRoomStatus as _, CrdtAdapter as a, BeforeRemoteCursorSaveContext as b, JsonValue as c, StreamsAuthProvider as d, StreamsCrdtOptions as f, TransportJoinParams as g, TransportError as h, StreamsCrdt as i, Result as l, TransportDeleteStreamSuccess as m, isValidBucketId as n, CrdtUpdateBatch as o, TransportCreateStreamSuccess as p, isValidRillId as r, JsonObject as s, createStreamUrl as t, SnapshotUploadOptions as u, TransportSubscription as v, IndexedDbRemoteCursorStoreOptions as w, BeforeRemoteCursorSaveHook as x, TransportSyncSuccess as y };
-//# sourceMappingURL=stream-id-1f2mhtmk.d.ts.map
+export { createInitialRemoteCursor as A, BeforeRemoteCursorSaveHook as C, RemoteCursor as D, IndexedDbRemoteCursorStoreOptions as E, RemoteCursorSaveSource as O, BeforeRemoteCursorSaveContext as S, IndexedDbRemoteCursorStore as T, TransportError as _, CrdtAdapter as a, TransportSubscription as b, JsonValue as c, SnapshotTransformHook as d, SnapshotUploadOptions as f, TransportDeleteStreamSuccess as g, TransportCreateStreamSuccess as h, StreamsCrdt as i, RemoteCursorStore as k, Result as l, StreamsCrdtOptions as m, isValidBucketId as n, CrdtUpdateBatch as o, StreamsAuthProvider as p, isValidRillId as r, JsonObject as s, createStreamUrl as t, SnapshotCodec as u, TransportJoinParams as v, InMemoryRemoteCursorStore as w, TransportSyncSuccess as x, TransportRoomStatus as y };
+//# sourceMappingURL=stream-id-B9n-uFFB.d.ts.map

package/dist/{stream-id-CIhmveJD.js → stream-id-YOFZ4I6Y.js}

@@ -589,6 +589,18 @@ function normalizeSnapshotUploadConfig(config) {
 		minBytesSinceRemoteSnapshot: BigInt(Math.floor(minBytes))
 	};
 }
+function assertSnapshotBytes(value, label) {
+	if (value instanceof Uint8Array) return value;
+	throw new Error(`${label} must return Uint8Array`);
+}
+function normalizeSnapshotCodec(codec) {
+	if (codec == null) return;
+	if (typeof codec.compress !== "function" || typeof codec.decompress !== "function") throw new Error("snapshotCodec.compress and snapshotCodec.decompress must be provided together");
+	return {
+		compress: async (snapshot) => assertSnapshotBytes(await codec.compress(snapshot), "snapshotCodec.compress"),
+		decompress: async (snapshot) => assertSnapshotBytes(await codec.decompress(snapshot), "snapshotCodec.decompress")
+	};
+}
 function jsonValueEquals(a, b) {
 	if (a === b) return true;
 	if (typeof a !== typeof b || a == null || b == null) return false;
@@ -1003,14 +1015,16 @@ var StreamsTransportClient = class {
 //#region src/transport-cursor.ts
 var TransportCursorManager = class {
 	adapter;
+	decodeSnapshot;
 	saveRemoteCursor;
 	constructor(options) {
 		this.adapter = options.adapter;
+		this.decodeSnapshot = options.decodeSnapshot;
 		this.saveRemoteCursor = options.saveRemoteCursor;
 	}
 	async applyBootstrapPayload(cursor, snapshot, updates, nextOffset) {
 		let nextVersion = cursor.serverLowerBoundVersion;
-		if (snapshot.byteLength > 0) nextVersion = await this.adapter.applySnapshot(snapshot);
+		if (snapshot.byteLength > 0) nextVersion = await this.adapter.applySnapshot(this.decodeSnapshot == null ? snapshot : await this.decodeSnapshot(snapshot));
 		if (updates.length > 0) nextVersion = await this.adapter.applyRemoteUpdates([...updates], nextVersion);
 		return await this.saveRemoteCursor({
 			...cursor,
@@ -1194,6 +1208,7 @@ function createTransportSnapshotState() {
 var TransportSnapshotManager = class {
 	adapter;
 	config;
+	encodeSnapshot;
 	readSnapshotOffsetValue;
 	putSnapshotAt;
 	enqueueExclusive;
@@ -1203,6 +1218,7 @@ var TransportSnapshotManager = class {
 	constructor(options) {
 		this.adapter = options.adapter;
 		this.config = options.config;
+		this.encodeSnapshot = options.encodeSnapshot;
 		this.readSnapshotOffsetValue = options.readSnapshotOffsetValue;
 		this.putSnapshotAt = options.putSnapshotAt;
 		this.enqueueExclusive = options.enqueueExclusive;
@@ -1273,7 +1289,7 @@ var TransportSnapshotManager = class {
 			if (tailBytes <= snapshotBytes) return;
 			if (tailBytes - snapshotBytes < config.minBytesSinceRemoteSnapshot) return;
 			const snapshot = this.adapter.exportSnapshot();
-			await this.putSnapshotAt(state.cursor.nextOffset, snapshot);
+			await this.putSnapshotAt(state.cursor.nextOffset, this.encodeSnapshot == null ? snapshot : await this.encodeSnapshot(snapshot));
 		} catch (error) {
 			this.logError("snapshot upload failed", error);
 		}
@@ -1367,6 +1383,7 @@ var StreamsCrdt = class StreamsCrdt {
 		};
 		this.debug = options.debug ?? false;
 		this.beforeRemoteCursorSave = composeBeforeRemoteCursorSaveHooks(options.beforeRemoteCursorSave, ...options.beforeRemoteCursorSaveHooks ?? []);
+		const snapshotCodec = normalizeSnapshotCodec(options.snapshotCodec);
 		const snapshotUploadConfig = normalizeSnapshotUploadConfig(options.snapshotUpload);
 		this.client = new StreamsTransportClient({
 			streamUrl: this.streamUrl,
@@ -1377,11 +1394,13 @@ var StreamsCrdt = class StreamsCrdt {
 		});
 		this.cursorManager = new TransportCursorManager({
 			adapter: this.adapter,
+			decodeSnapshot: snapshotCodec?.decompress,
 			saveRemoteCursor: (cursor, source) => this.saveRemoteCursor(cursor, source)
 		});
 		this.snapshotManager = new TransportSnapshotManager({
 			adapter: this.adapter,
 			config: snapshotUploadConfig,
+			encodeSnapshot: snapshotCodec?.compress,
 			readSnapshotOffsetValue: () => this.readSnapshotOffsetValue(),
 			putSnapshotAt: (snapshotOffset, snapshot) => this.putSnapshotAt(snapshotOffset, snapshot),
 			enqueueExclusive: (task) => this.enqueueExclusive(task),
@@ -2148,4 +2167,4 @@ function createStreamUrl(input) {
 //#endregion
 export { InMemoryRemoteCursorStore as a, StreamsCrdt as i, isValidBucketId as n, IndexedDbRemoteCursorStore as o, isValidRillId as r, createInitialRemoteCursor as s, createStreamUrl as t };
 
-//# sourceMappingURL=stream-id-CIhmveJD.js.map
+//# sourceMappingURL=stream-id-YOFZ4I6Y.js.map