@loro-dev/streams-crdt 0.14.0 → 0.15.0

package/dist/flock.d.ts

@@ -1,4 +1,4 @@
-import { $ as WriteOnlyAppendResult, A as PayloadProtectionKeyProvider, B as StreamsAuthProvider, C as EphemeralStreamSubscription, D as LocalSyncStats, E as JsonValue, F as Result, G as TransportCreateStreamSuccess, H as StreamsCrdtShardUrlsOptions, I as SnapshotCodec, J as TransportJoinParams, K as TransportDeleteStreamSuccess, L as SnapshotTransformHook, M as PayloadProtectionReadPolicy, N as PayloadProtectionScope, O as PayloadProtectionEncryptionOptions, P as PayloadProtectionWritePolicy, Q as TransportSyncSuccess, R as SnapshotUploadOptions, S as EphemeralStreamJoinParams, T as JsonObject, U as TransportCatchupParams, V as StreamsCrdtOptions, W as TransportCatchupSuccess, X as TransportSnapshotUploadSuccess, Y as TransportRoomStatus, Z as TransportSubscription, _ as E2eeReadPolicy, a as LocalAppendFailedError, at as RemoteCursor, b as EphemeralStreamAdaptor, c as CrdtAdapter, ct as createInitialRemoteCursor, d as CrdtUnresolvedSpan, et as BeforeRemoteCursorSaveContext, f as CrdtUpdateBatch, g as E2eeOptions, h as E2eeKeyProvider, i as PayloadProtectionError, it as IndexedDbRemoteCursorStoreOptions, j as PayloadProtectionOptions, k as PayloadProtectionKey, l as CrdtApplyOutcome, m as E2eeKey, n as isValidBucketId, nt as InMemoryRemoteCursorStore, o as EphemeralStreamCrdt, ot as RemoteCursorSaveSource, p as E2eeEncryptionOptions, q as TransportError, r as isValidRillId, rt as IndexedDbRemoteCursorStore, s as StreamsCrdt, st as RemoteCursorStore, t as createStreamUrl, tt as BeforeRemoteCursorSaveHook, u as CrdtApplyReturn, v as E2eeScope, w as IsolatedCrdtAdapter, x as EphemeralStreamCrdtOptions, y as E2eeWritePolicy, z as StreamsAuthContext } from "./stream-id-BuXMoCvo.js";
+import { $ as WriteOnlyAppendResult, A as PayloadProtectionProviderConfig, B as StreamsAuthProvider, C as LocalSyncStats, D as PayloadProtectionOpenInput, E as PayloadProtectionKind, F as Result, G as TransportCreateStreamSuccess, H as StreamsCrdtShardUrlsOptions, I as SnapshotCodec, J as TransportJoinParams, K as TransportDeleteStreamSuccess, L as SnapshotTransformHook, M as PayloadProtectionSealInput, N as PayloadProtectionSealResult, O as PayloadProtectionOptions, P as PayloadProtectionWritePolicy, Q as TransportSyncSuccess, R as SnapshotUploadOptions, S as JsonValue, T as PayloadProtectionFailureReason, U as TransportCatchupParams, V as StreamsCrdtOptions, W as TransportCatchupSuccess, X as TransportSnapshotUploadSuccess, Y as TransportRoomStatus, Z as TransportSubscription, _ as EphemeralStreamCrdtOptions, a as StreamsCrdt, at as RemoteCursor, b as IsolatedCrdtAdapter, c as CrdtApplyReturn, ct as createInitialRemoteCursor, d as E2eeOptions, et as BeforeRemoteCursorSaveContext, f as E2eeProvider, g as EphemeralStreamAdaptor, h as E2eeWritePolicy, i as EphemeralStreamCrdt, it as IndexedDbRemoteCursorStoreOptions, j as PayloadProtectionReadPolicy, k as PayloadProtectionProvider, l as CrdtUnresolvedSpan, m as E2eeReadPolicy, n as PayloadProtectionError, nt as InMemoryRemoteCursorStore, o as CrdtAdapter, ot as RemoteCursorSaveSource, p as E2eeProviderConfig, q as TransportError, r as LocalAppendFailedError, rt as IndexedDbRemoteCursorStore, s as CrdtApplyOutcome, st as RemoteCursorStore, t as isValidRillId, tt as BeforeRemoteCursorSaveHook, u as CrdtUpdateBatch, v as EphemeralStreamJoinParams, w as PayloadProtectionContext, x as JsonObject, y as EphemeralStreamSubscription, z as StreamsAuthContext } from "./stream-id-CO65-58E.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, CrdtApplyOutcome, CrdtApplyReturn, CrdtUnresolvedSpan, CrdtUpdateBatch, E2eeEncryptionOptions, PayloadProtectionError as E2eeError, PayloadProtectionError, E2eeKey, E2eeKeyProvider, E2eeOptions, E2eeReadPolicy, E2eeScope, E2eeWritePolicy, EphemeralStreamAdaptor, EphemeralStreamCrdt, EphemeralStreamCrdtOptions, EphemeralStreamJoinParams, EphemeralStreamSubscription, type ExportBundle, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, IndexedDbRemoteCursorStoreOptions, IsolatedCrdtAdapter, JsonObject, JsonValue, LocalAppendFailedError, LocalSyncStats, PayloadProtectionEncryptionOptions, PayloadProtectionKey, PayloadProtectionKeyProvider, PayloadProtectionOptions, PayloadProtectionReadPolicy, PayloadProtectionScope, PayloadProtectionWritePolicy, RemoteCursor, RemoteCursorSaveSource, RemoteCursorStore, Result, SnapshotCodec, SnapshotTransformHook, SnapshotUploadOptions, StreamsAuthContext, StreamsAuthProvider, StreamsCrdt, StreamsCrdtOptions, StreamsCrdtShardUrlsOptions, TransportCatchupParams, TransportCatchupSuccess, TransportCreateStreamSuccess, TransportDeleteStreamSuccess, TransportError, TransportJoinParams, TransportRoomStatus, TransportSnapshotUploadSuccess, TransportSubscription, TransportSyncSuccess, type VersionVector, WriteOnlyAppendResult, createFlockAdapter, createInitialRemoteCursor, createStreamUrl, isValidBucketId, isValidRillId };
+export { BeforeRemoteCursorSaveContext, BeforeRemoteCursorSaveHook, CrdtAdapter, CrdtApplyOutcome, CrdtApplyReturn, CrdtUnresolvedSpan, CrdtUpdateBatch, PayloadProtectionError as E2eeError, PayloadProtectionError, E2eeOptions, E2eeProvider, E2eeProviderConfig, E2eeReadPolicy, E2eeWritePolicy, EphemeralStreamAdaptor, EphemeralStreamCrdt, EphemeralStreamCrdtOptions, EphemeralStreamJoinParams, EphemeralStreamSubscription, type ExportBundle, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, IndexedDbRemoteCursorStoreOptions, IsolatedCrdtAdapter, JsonObject, JsonValue, LocalAppendFailedError, LocalSyncStats, PayloadProtectionContext, PayloadProtectionFailureReason, PayloadProtectionKind, PayloadProtectionOpenInput, PayloadProtectionOptions, PayloadProtectionProvider, PayloadProtectionProviderConfig, PayloadProtectionReadPolicy, PayloadProtectionSealInput, PayloadProtectionSealResult, PayloadProtectionWritePolicy, RemoteCursor, RemoteCursorSaveSource, RemoteCursorStore, Result, SnapshotCodec, SnapshotTransformHook, SnapshotUploadOptions, StreamsAuthContext, StreamsAuthProvider, StreamsCrdt, StreamsCrdtOptions, StreamsCrdtShardUrlsOptions, TransportCatchupParams, TransportCatchupSuccess, TransportCreateStreamSuccess, TransportDeleteStreamSuccess, TransportError, TransportJoinParams, TransportRoomStatus, TransportSnapshotUploadSuccess, TransportSubscription, TransportSyncSuccess, type VersionVector, WriteOnlyAppendResult, createFlockAdapter, createInitialRemoteCursor, isValidRillId };
 //# sourceMappingURL=flock.d.ts.map

package/dist/flock.js

@@ -1,4 +1,4 @@
-import { a as InMemoryRemoteCursorStore, c as EphemeralStreamCrdt, i as StreamsCrdt, l as LocalAppendFailedError, n as isValidBucketId, o as IndexedDbRemoteCursorStore, r as isValidRillId, s as createInitialRemoteCursor, t as createStreamUrl, u as PayloadProtectionError } from "./stream-id-CEp4zEQJ.js";
+import { a as createInitialRemoteCursor, c as PayloadProtectionError, i as IndexedDbRemoteCursorStore, n as StreamsCrdt, o as EphemeralStreamCrdt, r as InMemoryRemoteCursorStore, s as LocalAppendFailedError, t as isValidRillId } from "./stream-id-CggbAC6b.js";
 import { Flock } from "@loro-dev/flock-wasm";
 //#region src/flock.ts
 function isAfter(entry, current) {
@@ -103,7 +103,8 @@ function createFlockAdapter(flock) {
 		exportSnapshot: () => flock.exportFile(),
 		applySnapshot: (snapshot) => {
 			flock.importFile(snapshot);
-			return flock.version();
+			if (snapshot.byteLength === 0) return {};
+			return Flock.fromFile(snapshot, "streams-crdt-snapshot-version").version();
 		},
 		exportUpdates: (fromVersion) => {
 			const bundle = flock.exportJson(fromVersion);
@@ -149,6 +150,6 @@ function createFlockAdapter(flock) {
 	};
 }
 //#endregion
-export { PayloadProtectionError as E2eeError, PayloadProtectionError, EphemeralStreamCrdt, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, LocalAppendFailedError, StreamsCrdt, createFlockAdapter, createInitialRemoteCursor, createStreamUrl, isValidBucketId, isValidRillId };
+export { PayloadProtectionError as E2eeError, PayloadProtectionError, EphemeralStreamCrdt, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, LocalAppendFailedError, StreamsCrdt, createFlockAdapter, createInitialRemoteCursor, isValidRillId };
 
 //# sourceMappingURL=flock.js.map

package/dist/flock.js.map

@@ -1 +1 @@
-{"version":3,"file":"flock.js","names":[],"sources":["../src/flock.ts"],"sourcesContent":["import { Flock } from \"@loro-dev/flock-wasm\";\nimport type {\n  EventBatch,\n  ExportBundle,\n  ExportRecord,\n  VersionVector,\n  VersionVectorEntry,\n} from \"@loro-dev/flock-wasm\";\nimport type { CrdtAdapter } from \"./types\";\n\nexport { StreamsCrdt } from \"./transport-runtime\";\nexport * from \"./shared\";\nexport type { ExportBundle, VersionVector } from \"@loro-dev/flock-wasm\";\n\nfunction isAfter(\n  entry: VersionVectorEntry,\n  current: VersionVectorEntry,\n): boolean {\n  return (\n    entry.physicalTime > current.physicalTime ||\n    (entry.physicalTime === current.physicalTime &&\n      entry.logicalCounter > current.logicalCounter)\n  );\n}\n\nfunction mergeVersions(\n  base: VersionVector,\n  incoming: VersionVector,\n): VersionVector {\n  const merged: VersionVector = { ...base };\n  for (const [peer, entry] of Object.entries(incoming)) {\n    if (entry == null) {\n      continue;\n    }\n    const current = merged[peer];\n    if (current == null || isAfter(entry, current)) {\n      merged[peer] = { ...entry };\n    }\n  }\n  return merged;\n}\n\nfunction parseClock(\n  record: ExportRecord,\n): { peerId: string; entry: VersionVectorEntry } | null {\n  const firstComma = record.c.indexOf(\",\");\n  const secondComma = record.c.indexOf(\",\", firstComma + 1);\n  if (firstComma < 0 || secondComma < 0) {\n    return null;\n  }\n\n  const physicalTime = Number(record.c.slice(0, firstComma));\n  const logicalCounter = Number(record.c.slice(firstComma + 1, secondComma));\n  if (!Number.isFinite(physicalTime) || !Number.isFinite(logicalCounter)) {\n    return null;\n  }\n\n  return {\n    peerId: record.c.slice(secondComma + 1),\n    entry: { physicalTime, logicalCounter },\n  };\n}\n\nfunction extractVersionFromBundle(bundle: ExportBundle): VersionVector {\n  const out: VersionVector = {};\n  for (const record of Object.values(bundle.entries)) {\n    const parsed = parseClock(record);\n    if (parsed == null) {\n      continue;\n    }\n    const current = out[parsed.peerId];\n    if (current == null || isAfter(parsed.entry, current)) {\n      out[parsed.peerId] = parsed.entry;\n    }\n  }\n  return out;\n}\n\nfunction hasEntries(bundle: ExportBundle): boolean {\n  return Object.keys(bundle.entries).length > 0;\n}\n\n/**\n * Try to merge parsed bundles into a single combined bundle.\n * Falls back to per-bundle import when any key appears in more than one\n * bundle, so Flock's LWW conflict resolution sees every entry.\n */\nfunction batchImportBundles(\n  importFn: (bundle: ExportBundle) => void,\n  bundles: ExportBundle[],\n): void {\n  if (bundles.length === 0) {\n    return;\n  }\n  if (bundles.length === 1) {\n    importFn(bundles[0]!);\n    return;\n  }\n\n  // Detect key collisions across bundles.\n  const seenKeys = new Set<string>();\n  let hasCollision = false;\n  for (const bundle of bundles) {\n    for (const key of Object.keys(bundle.entries)) {\n      if (seenKeys.has(key)) {\n        hasCollision = true;\n        break;\n      }\n      seenKeys.add(key);\n    }\n    if (hasCollision) {\n      break;\n    }\n  }\n\n  if (hasCollision) {\n    for (const bundle of bundles) {\n      importFn(bundle);\n    }\n    return;\n  }\n\n  // No collisions — merge entries into the first bundle and import once.\n  const combined: ExportBundle = {\n    ...bundles[0]!,\n    entries: { ...bundles[0]!.entries },\n  };\n  for (let i = 1; i < bundles.length; i++) {\n    Object.assign(combined.entries, bundles[i]!.entries);\n  }\n  importFn(combined);\n}\n\nfunction applyBundleUpdates(\n  importFn: (bundle: ExportBundle) => void,\n  updates: Uint8Array[],\n  remoterVersion: VersionVector,\n): VersionVector {\n  let merged = remoterVersion;\n  const bundles: ExportBundle[] = [];\n  for (const update of updates) {\n    const bundle = JSON.parse(\n      new TextDecoder().decode(update),\n    ) as ExportBundle;\n    if (!hasEntries(bundle)) {\n      continue;\n    }\n    bundles.push(bundle);\n    merged = mergeVersions(merged, extractVersionFromBundle(bundle));\n  }\n  batchImportBundles(importFn, bundles);\n  return merged;\n}\n\n/**\n * Creates a `CrdtAdapter` for one Flock replica.\n */\nexport function createFlockAdapter(flock: Flock): CrdtAdapter<VersionVector> {\n  let lastExportedVersion: VersionVector = {};\n  let localExportQueue = Promise.resolve();\n\n  const recordExportFrontier = (version: VersionVector): void => {\n    lastExportedVersion = mergeVersions(lastExportedVersion, version);\n  };\n\n  return {\n    emptyVersion: () => ({}),\n    mergeVersions,\n    flushLocalExports: () => localExportQueue,\n    exportSnapshot: () => flock.exportFile(),\n    applySnapshot: (snapshot) => {\n      flock.importFile(snapshot);\n      return flock.version();\n    },\n    exportUpdates: (fromVersion) => {\n      const bundle = flock.exportJson(fromVersion);\n      recordExportFrontier(fromVersion);\n      if (!hasEntries(bundle)) {\n        return undefined;\n      }\n      const exportedVersion = extractVersionFromBundle(bundle);\n      recordExportFrontier(exportedVersion);\n      return {\n        updates: [new TextEncoder().encode(JSON.stringify(bundle))],\n        version: exportedVersion,\n      };\n    },\n    applyRemoteUpdates: (updates, remoterVersion) =>\n      applyBundleUpdates((b) => flock.importJson(b), updates, remoterVersion),\n    createIsolatedAdapter: () => {\n      let isolated = new Flock(\"streams-crdt-isolated\");\n      return {\n        applySnapshot: (snapshot) => {\n          isolated =\n            snapshot.byteLength === 0\n              ? new Flock(\"streams-crdt-isolated\")\n              : Flock.fromFile(snapshot, \"streams-crdt-isolated\");\n          return isolated.version();\n        },\n        applyRemoteUpdates: (updates, remoterVersion) =>\n          applyBundleUpdates((b) => isolated.importJson(b), updates, remoterVersion),\n      };\n    },\n    subscribeLocalUpdates: (listener) => {\n      const unsubscribe = flock.subscribe((batch) => {\n        if (batch.source !== \"local\") {\n          return;\n        }\n        const drain = async () => {\n          const batchPayload = await flock.exportJson({\n            from: lastExportedVersion,\n            peerId: flock.peerId(),\n          });\n          if (!hasEntries(batchPayload)) {\n            return;\n          }\n          const exportedVersion = extractVersionFromBundle(batchPayload);\n          recordExportFrontier(exportedVersion);\n          listener({\n            updates: [new TextEncoder().encode(JSON.stringify(batchPayload))],\n            version: exportedVersion,\n          });\n        };\n\n        localExportQueue = localExportQueue.then(drain).catch(() => {\n          /* swallow to keep queue alive */\n        });\n      });\n      return unsubscribe;\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"flock.js","names":[],"sources":["../src/flock.ts"],"sourcesContent":["import { Flock } from \"@loro-dev/flock-wasm\";\nimport type {\n  EventBatch,\n  ExportBundle,\n  ExportRecord,\n  VersionVector,\n  VersionVectorEntry,\n} from \"@loro-dev/flock-wasm\";\nimport type { CrdtAdapter } from \"./types\";\n\nexport { StreamsCrdt } from \"./transport-runtime\";\nexport * from \"./shared\";\nexport type { ExportBundle, VersionVector } from \"@loro-dev/flock-wasm\";\n\nfunction isAfter(\n  entry: VersionVectorEntry,\n  current: VersionVectorEntry,\n): boolean {\n  return (\n    entry.physicalTime > current.physicalTime ||\n    (entry.physicalTime === current.physicalTime &&\n      entry.logicalCounter > current.logicalCounter)\n  );\n}\n\nfunction mergeVersions(\n  base: VersionVector,\n  incoming: VersionVector,\n): VersionVector {\n  const merged: VersionVector = { ...base };\n  for (const [peer, entry] of Object.entries(incoming)) {\n    if (entry == null) {\n      continue;\n    }\n    const current = merged[peer];\n    if (current == null || isAfter(entry, current)) {\n      merged[peer] = { ...entry };\n    }\n  }\n  return merged;\n}\n\nfunction parseClock(\n  record: ExportRecord,\n): { peerId: string; entry: VersionVectorEntry } | null {\n  const firstComma = record.c.indexOf(\",\");\n  const secondComma = record.c.indexOf(\",\", firstComma + 1);\n  if (firstComma < 0 || secondComma < 0) {\n    return null;\n  }\n\n  const physicalTime = Number(record.c.slice(0, firstComma));\n  const logicalCounter = Number(record.c.slice(firstComma + 1, secondComma));\n  if (!Number.isFinite(physicalTime) || !Number.isFinite(logicalCounter)) {\n    return null;\n  }\n\n  return {\n    peerId: record.c.slice(secondComma + 1),\n    entry: { physicalTime, logicalCounter },\n  };\n}\n\nfunction extractVersionFromBundle(bundle: ExportBundle): VersionVector {\n  const out: VersionVector = {};\n  for (const record of Object.values(bundle.entries)) {\n    const parsed = parseClock(record);\n    if (parsed == null) {\n      continue;\n    }\n    const current = out[parsed.peerId];\n    if (current == null || isAfter(parsed.entry, current)) {\n      out[parsed.peerId] = parsed.entry;\n    }\n  }\n  return out;\n}\n\nfunction hasEntries(bundle: ExportBundle): boolean {\n  return Object.keys(bundle.entries).length > 0;\n}\n\n/**\n * Try to merge parsed bundles into a single combined bundle.\n * Falls back to per-bundle import when any key appears in more than one\n * bundle, so Flock's LWW conflict resolution sees every entry.\n */\nfunction batchImportBundles(\n  importFn: (bundle: ExportBundle) => void,\n  bundles: ExportBundle[],\n): void {\n  if (bundles.length === 0) {\n    return;\n  }\n  if (bundles.length === 1) {\n    importFn(bundles[0]!);\n    return;\n  }\n\n  // Detect key collisions across bundles.\n  const seenKeys = new Set<string>();\n  let hasCollision = false;\n  for (const bundle of bundles) {\n    for (const key of Object.keys(bundle.entries)) {\n      if (seenKeys.has(key)) {\n        hasCollision = true;\n        break;\n      }\n      seenKeys.add(key);\n    }\n    if (hasCollision) {\n      break;\n    }\n  }\n\n  if (hasCollision) {\n    for (const bundle of bundles) {\n      importFn(bundle);\n    }\n    return;\n  }\n\n  // No collisions — merge entries into the first bundle and import once.\n  const combined: ExportBundle = {\n    ...bundles[0]!,\n    entries: { ...bundles[0]!.entries },\n  };\n  for (let i = 1; i < bundles.length; i++) {\n    Object.assign(combined.entries, bundles[i]!.entries);\n  }\n  importFn(combined);\n}\n\nfunction applyBundleUpdates(\n  importFn: (bundle: ExportBundle) => void,\n  updates: Uint8Array[],\n  remoterVersion: VersionVector,\n): VersionVector {\n  let merged = remoterVersion;\n  const bundles: ExportBundle[] = [];\n  for (const update of updates) {\n    const bundle = JSON.parse(\n      new TextDecoder().decode(update),\n    ) as ExportBundle;\n    if (!hasEntries(bundle)) {\n      continue;\n    }\n    bundles.push(bundle);\n    merged = mergeVersions(merged, extractVersionFromBundle(bundle));\n  }\n  batchImportBundles(importFn, bundles);\n  return merged;\n}\n\n/**\n * Creates a `CrdtAdapter` for one Flock replica.\n */\nexport function createFlockAdapter(flock: Flock): CrdtAdapter<VersionVector> {\n  let lastExportedVersion: VersionVector = {};\n  let localExportQueue = Promise.resolve();\n\n  const recordExportFrontier = (version: VersionVector): void => {\n    lastExportedVersion = mergeVersions(lastExportedVersion, version);\n  };\n\n  return {\n    emptyVersion: () => ({}),\n    mergeVersions,\n    flushLocalExports: () => localExportQueue,\n    exportSnapshot: () => flock.exportFile(),\n    applySnapshot: (snapshot) => {\n      flock.importFile(snapshot);\n      if (snapshot.byteLength === 0) {\n        return {};\n      }\n      // Return only the version carried by the snapshot itself. Returning\n      // `flock.version()` here would fold the local peer's pre-join clocks\n      // into `serverLowerBoundVersion`, so entries committed before joining\n      // would never be exported (they'd read as already server-known).\n      return Flock.fromFile(snapshot, \"streams-crdt-snapshot-version\").version();\n    },\n    exportUpdates: (fromVersion) => {\n      const bundle = flock.exportJson(fromVersion);\n      recordExportFrontier(fromVersion);\n      if (!hasEntries(bundle)) {\n        return undefined;\n      }\n      const exportedVersion = extractVersionFromBundle(bundle);\n      recordExportFrontier(exportedVersion);\n      return {\n        updates: [new TextEncoder().encode(JSON.stringify(bundle))],\n        version: exportedVersion,\n      };\n    },\n    applyRemoteUpdates: (updates, remoterVersion) =>\n      applyBundleUpdates((b) => flock.importJson(b), updates, remoterVersion),\n    createIsolatedAdapter: () => {\n      let isolated = new Flock(\"streams-crdt-isolated\");\n      return {\n        applySnapshot: (snapshot) => {\n          isolated =\n            snapshot.byteLength === 0\n              ? new Flock(\"streams-crdt-isolated\")\n              : Flock.fromFile(snapshot, \"streams-crdt-isolated\");\n          return isolated.version();\n        },\n        applyRemoteUpdates: (updates, remoterVersion) =>\n          applyBundleUpdates((b) => isolated.importJson(b), updates, remoterVersion),\n      };\n    },\n    subscribeLocalUpdates: (listener) => {\n      const unsubscribe = flock.subscribe((batch) => {\n        if (batch.source !== \"local\") {\n          return;\n        }\n        const drain = async () => {\n          const batchPayload = await flock.exportJson({\n            from: lastExportedVersion,\n            peerId: flock.peerId(),\n          });\n          if (!hasEntries(batchPayload)) {\n            return;\n          }\n          const exportedVersion = extractVersionFromBundle(batchPayload);\n          recordExportFrontier(exportedVersion);\n          listener({\n            updates: [new TextEncoder().encode(JSON.stringify(batchPayload))],\n            version: exportedVersion,\n          });\n        };\n\n        localExportQueue = localExportQueue.then(drain).catch(() => {\n          /* swallow to keep queue alive */\n        });\n      });\n      return unsubscribe;\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/index.d.ts

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

package/dist/index.js

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

package/dist/loro.d.ts

@@ -1,4 +1,4 @@
-import { $ as WriteOnlyAppendResult, A as PayloadProtectionKeyProvider, B as StreamsAuthProvider, C as EphemeralStreamSubscription, D as LocalSyncStats, E as JsonValue, F as Result, G as TransportCreateStreamSuccess, H as StreamsCrdtShardUrlsOptions, I as SnapshotCodec, J as TransportJoinParams, K as TransportDeleteStreamSuccess, L as SnapshotTransformHook, M as PayloadProtectionReadPolicy, N as PayloadProtectionScope, O as PayloadProtectionEncryptionOptions, P as PayloadProtectionWritePolicy, Q as TransportSyncSuccess, R as SnapshotUploadOptions, S as EphemeralStreamJoinParams, T as JsonObject, U as TransportCatchupParams, V as StreamsCrdtOptions, W as TransportCatchupSuccess, X as TransportSnapshotUploadSuccess, Y as TransportRoomStatus, Z as TransportSubscription, _ as E2eeReadPolicy, a as LocalAppendFailedError, at as RemoteCursor, b as EphemeralStreamAdaptor, c as CrdtAdapter, ct as createInitialRemoteCursor, d as CrdtUnresolvedSpan, et as BeforeRemoteCursorSaveContext, f as CrdtUpdateBatch, g as E2eeOptions, h as E2eeKeyProvider, i as PayloadProtectionError, it as IndexedDbRemoteCursorStoreOptions, j as PayloadProtectionOptions, k as PayloadProtectionKey, l as CrdtApplyOutcome, m as E2eeKey, n as isValidBucketId, nt as InMemoryRemoteCursorStore, o as EphemeralStreamCrdt, ot as RemoteCursorSaveSource, p as E2eeEncryptionOptions, q as TransportError, r as isValidRillId, rt as IndexedDbRemoteCursorStore, s as StreamsCrdt, st as RemoteCursorStore, t as createStreamUrl, tt as BeforeRemoteCursorSaveHook, u as CrdtApplyReturn, v as E2eeScope, w as IsolatedCrdtAdapter, x as EphemeralStreamCrdtOptions, y as E2eeWritePolicy, z as StreamsAuthContext } from "./stream-id-BuXMoCvo.js";
+import { $ as WriteOnlyAppendResult, A as PayloadProtectionProviderConfig, B as StreamsAuthProvider, C as LocalSyncStats, D as PayloadProtectionOpenInput, E as PayloadProtectionKind, F as Result, G as TransportCreateStreamSuccess, H as StreamsCrdtShardUrlsOptions, I as SnapshotCodec, J as TransportJoinParams, K as TransportDeleteStreamSuccess, L as SnapshotTransformHook, M as PayloadProtectionSealInput, N as PayloadProtectionSealResult, O as PayloadProtectionOptions, P as PayloadProtectionWritePolicy, Q as TransportSyncSuccess, R as SnapshotUploadOptions, S as JsonValue, T as PayloadProtectionFailureReason, U as TransportCatchupParams, V as StreamsCrdtOptions, W as TransportCatchupSuccess, X as TransportSnapshotUploadSuccess, Y as TransportRoomStatus, Z as TransportSubscription, _ as EphemeralStreamCrdtOptions, a as StreamsCrdt, at as RemoteCursor, b as IsolatedCrdtAdapter, c as CrdtApplyReturn, ct as createInitialRemoteCursor, d as E2eeOptions, et as BeforeRemoteCursorSaveContext, f as E2eeProvider, g as EphemeralStreamAdaptor, h as E2eeWritePolicy, i as EphemeralStreamCrdt, it as IndexedDbRemoteCursorStoreOptions, j as PayloadProtectionReadPolicy, k as PayloadProtectionProvider, l as CrdtUnresolvedSpan, m as E2eeReadPolicy, n as PayloadProtectionError, nt as InMemoryRemoteCursorStore, o as CrdtAdapter, ot as RemoteCursorSaveSource, p as E2eeProviderConfig, q as TransportError, r as LocalAppendFailedError, rt as IndexedDbRemoteCursorStore, s as CrdtApplyOutcome, st as RemoteCursorStore, t as isValidRillId, tt as BeforeRemoteCursorSaveHook, u as CrdtUpdateBatch, v as EphemeralStreamJoinParams, w as PayloadProtectionContext, x as JsonObject, y as EphemeralStreamSubscription, z as StreamsAuthContext } from "./stream-id-CO65-58E.js";
 import { LoroDoc } from "loro-crdt";
 
 //#region src/loro.d.ts
@@ -41,5 +41,5 @@ interface LoroEphemeralStoreLike {
 declare function EphemeralStoreAdaptor(store: LoroEphemeralStoreLike): EphemeralStreamAdaptor;
 declare const createLoroEphemeralStoreAdaptor: typeof EphemeralStoreAdaptor;
 //#endregion
-export { BeforeRemoteCursorSaveContext, BeforeRemoteCursorSaveHook, CrdtAdapter, CrdtApplyOutcome, CrdtApplyReturn, CrdtUnresolvedSpan, CrdtUpdateBatch, E2eeEncryptionOptions, PayloadProtectionError as E2eeError, PayloadProtectionError, E2eeKey, E2eeKeyProvider, E2eeOptions, E2eeReadPolicy, E2eeScope, E2eeWritePolicy, EphemeralStoreAdaptor, EphemeralStreamAdaptor, EphemeralStreamCrdt, EphemeralStreamCrdtOptions, EphemeralStreamJoinParams, EphemeralStreamSubscription, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, IndexedDbRemoteCursorStoreOptions, IsolatedCrdtAdapter, JsonObject, JsonValue, LocalAppendFailedError, LocalSyncStats, LoroEphemeralStoreLike, PayloadProtectionEncryptionOptions, PayloadProtectionKey, PayloadProtectionKeyProvider, PayloadProtectionOptions, PayloadProtectionReadPolicy, PayloadProtectionScope, PayloadProtectionWritePolicy, RemoteCursor, RemoteCursorSaveSource, RemoteCursorStore, Result, SnapshotCodec, SnapshotTransformHook, SnapshotUploadOptions, StreamsAuthContext, StreamsAuthProvider, StreamsCrdt, StreamsCrdtOptions, StreamsCrdtShardUrlsOptions, TransportCatchupParams, TransportCatchupSuccess, TransportCreateStreamSuccess, TransportDeleteStreamSuccess, TransportError, TransportJoinParams, TransportRoomStatus, TransportSnapshotUploadSuccess, TransportSubscription, TransportSyncSuccess, WriteOnlyAppendResult, createInitialRemoteCursor, createLoroDocAdapter, createLoroEphemeralStoreAdaptor, createStreamUrl, isValidBucketId, isValidRillId };
+export { BeforeRemoteCursorSaveContext, BeforeRemoteCursorSaveHook, CrdtAdapter, CrdtApplyOutcome, CrdtApplyReturn, CrdtUnresolvedSpan, CrdtUpdateBatch, PayloadProtectionError as E2eeError, PayloadProtectionError, E2eeOptions, E2eeProvider, E2eeProviderConfig, E2eeReadPolicy, E2eeWritePolicy, EphemeralStoreAdaptor, EphemeralStreamAdaptor, EphemeralStreamCrdt, EphemeralStreamCrdtOptions, EphemeralStreamJoinParams, EphemeralStreamSubscription, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, IndexedDbRemoteCursorStoreOptions, IsolatedCrdtAdapter, JsonObject, JsonValue, LocalAppendFailedError, LocalSyncStats, LoroEphemeralStoreLike, PayloadProtectionContext, PayloadProtectionFailureReason, PayloadProtectionKind, PayloadProtectionOpenInput, PayloadProtectionOptions, PayloadProtectionProvider, PayloadProtectionProviderConfig, PayloadProtectionReadPolicy, PayloadProtectionSealInput, PayloadProtectionSealResult, PayloadProtectionWritePolicy, RemoteCursor, RemoteCursorSaveSource, RemoteCursorStore, Result, SnapshotCodec, SnapshotTransformHook, SnapshotUploadOptions, StreamsAuthContext, StreamsAuthProvider, StreamsCrdt, StreamsCrdtOptions, StreamsCrdtShardUrlsOptions, TransportCatchupParams, TransportCatchupSuccess, TransportCreateStreamSuccess, TransportDeleteStreamSuccess, TransportError, TransportJoinParams, TransportRoomStatus, TransportSnapshotUploadSuccess, TransportSubscription, TransportSyncSuccess, WriteOnlyAppendResult, createInitialRemoteCursor, createLoroDocAdapter, createLoroEphemeralStoreAdaptor, isValidRillId };
 //# sourceMappingURL=loro.d.ts.map

package/dist/loro.js

@@ -1,4 +1,4 @@
-import { a as InMemoryRemoteCursorStore, c as EphemeralStreamCrdt, i as StreamsCrdt, l as LocalAppendFailedError, n as isValidBucketId, o as IndexedDbRemoteCursorStore, r as isValidRillId, s as createInitialRemoteCursor, t as createStreamUrl, u as PayloadProtectionError } from "./stream-id-CEp4zEQJ.js";
+import { a as createInitialRemoteCursor, c as PayloadProtectionError, i as IndexedDbRemoteCursorStore, n as StreamsCrdt, o as EphemeralStreamCrdt, r as InMemoryRemoteCursorStore, s as LocalAppendFailedError, t as isValidRillId } from "./stream-id-CggbAC6b.js";
 import { LoroDoc, VersionVector, decodeImportBlobMeta } from "loro-crdt";
 //#region src/loro.ts
 function batchImportUpdates(doc, updates) {
@@ -268,6 +268,6 @@ function EphemeralStoreAdaptor(store) {
 }
 const createLoroEphemeralStoreAdaptor = EphemeralStoreAdaptor;
 //#endregion
-export { PayloadProtectionError as E2eeError, PayloadProtectionError, EphemeralStoreAdaptor, EphemeralStreamCrdt, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, LocalAppendFailedError, StreamsCrdt, createInitialRemoteCursor, createLoroDocAdapter, createLoroEphemeralStoreAdaptor, createStreamUrl, isValidBucketId, isValidRillId };
+export { PayloadProtectionError as E2eeError, PayloadProtectionError, EphemeralStoreAdaptor, EphemeralStreamCrdt, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, LocalAppendFailedError, StreamsCrdt, createInitialRemoteCursor, createLoroDocAdapter, createLoroEphemeralStoreAdaptor, isValidRillId };
 
 //# sourceMappingURL=loro.js.map

package/dist/{stream-id-BuXMoCvo.d.ts → stream-id-CO65-58E.d.ts}

@@ -379,8 +379,7 @@ type TransportError =
 } | {
   readonly code: "payload_protection_error";
   readonly retryable: false;
-  readonly reason: "plaintext_forbidden" | "missing_read_key" | "decrypt_failed" | "invalid_envelope" | "wrong_payload_kind" | "encrypt_failed";
-  readonly keyId?: string;
+  readonly reason: PayloadProtectionFailureReason;
   readonly message: string;
 };
 interface WriteOnlyAppendResult<TVersion extends JsonObject> {
@@ -523,34 +522,74 @@ interface SnapshotCodec {
   readonly compress: SnapshotTransformHook;
   readonly decompress: SnapshotTransformHook;
 }
+type PayloadProtectionFailureReason = "plaintext_forbidden" | "missing_read_key" | "decrypt_failed" | "invalid_envelope" | "wrong_payload_kind" | "encrypt_failed";
 type PayloadProtectionReadPolicy = "encrypted-only" | "allow-plaintext";
 type PayloadProtectionWritePolicy = "encrypt" | "plaintext";
-type PayloadProtectionScope = string | {
-  readonly bucketId: string;
-  readonly streamId: string;
-};
-interface PayloadProtectionKey {
-  readonly id: string;
-  readonly key: CryptoKey | Uint8Array;
+/** Durable CRDT payload class authenticated by the protection boundary. */
+type PayloadProtectionKind = "update_batch" | "snapshot";
+/** Stable envelope context shared by provider-backed seal/open calls. */
+interface PayloadProtectionContext {
+  readonly protocol: "loro-streams-crdt-payload-protection";
+  readonly version: 2;
+  readonly kind: PayloadProtectionKind;
 }
-type PayloadProtectionKeyProvider = () => MaybePromise<readonly PayloadProtectionKey[]>;
-interface PayloadProtectionEncryptionOptions {
+interface PayloadProtectionSealInput {
+  readonly plaintext: Uint8Array;
+  readonly context: PayloadProtectionContext;
   /**
-   * Stable encryption context authenticated with every encrypted payload.
+   * Returns the exact AAD for the opaque authenticated header the provider
+   * will return.
    *
-   * Prefer bucket/stream identity or an application-stable string. Do not use
-   * a full gateway URL unless old encrypted bytes should become unreadable
-   * after host/proxy migration.
+   * Providers MUST pass their final header to this function exactly once
+   * before sealing and MUST authenticate the returned bytes. A provider may
+   * frame and append caller-owned room/application AAD before passing the
+   * combined value to its AEAD. streams-crdt deliberately does not know or
+   * derive that application identity.
    */
-  readonly scope: PayloadProtectionScope;
-  /** Key used for new encrypted writes. Required when writePolicy is "encrypt". */
-  readonly writeKey?: PayloadProtectionKey;
+  readonly additionalData: (header: Uint8Array) => Uint8Array;
+}
+interface PayloadProtectionSealResult {
+  /** Opaque authenticated provider header; limited to 512 bytes. */
+  readonly header: Uint8Array;
   /**
-   * Keys accepted for remote encrypted reads.
-   *
-   * When omitted, `writeKey` is also used as the only read key.
+   * Provider-defined sealed bytes. Nonces and authentication tags stay opaque
+   * to streams-crdt, so providers may use formats such as
+   * `nonce[24] || XChaCha20-Poly1305 ciphertext+tag`.
    */
-  readonly readKeys?: readonly PayloadProtectionKey[] | PayloadProtectionKeyProvider;
+  readonly sealed: Uint8Array;
+}
+interface PayloadProtectionOpenInput {
+  readonly sealed: Uint8Array;
+  /** Opaque authenticated provider header returned by the writer. */
+  readonly header: Uint8Array;
+  readonly context: PayloadProtectionContext;
+  /** Exact envelope AAD that the provider must authenticate. */
+  readonly additionalData: Uint8Array;
+}
+/**
+ * Caller-owned authenticated payload codec.
+ *
+ * streams-crdt owns only the versioned envelope, its fixed envelope AAD,
+ * placement at the framing boundary, and fail-closed policies. The provider
+ * owns the audited AEAD primitive, nonce generation, application/room AAD,
+ * current write-key selection, and historical key lookup.
+ */
+interface PayloadProtectionProvider {
+  /**
+   * Maximum `header.byteLength + sealed.byteLength - plaintext.byteLength`
+   * this provider can return. This lets streams-crdt batch without performing
+   * a speculative seal or consuming a nonce. The runtime rejects a seal that
+   * exceeds the declared bound.
+   */
+  readonly maxSealOverheadBytes: number;
+  seal(input: PayloadProtectionSealInput): MaybePromise<PayloadProtectionSealResult>;
+  open(input: PayloadProtectionOpenInput): MaybePromise<Uint8Array>;
+}
+/** Scope-free provider config suitable for direct repo/room forwarding. */
+interface PayloadProtectionProviderConfig {
+  readonly provider: PayloadProtectionProvider;
+  readonly readPolicy?: PayloadProtectionReadPolicy;
+  readonly writePolicy?: PayloadProtectionWritePolicy;
 }
 interface PayloadProtectionOptions {
   /**
@@ -562,14 +601,20 @@ interface PayloadProtectionOptions {
    * Local write policy. Defaults to "encrypt" when E2EE is provided.
    */
   readonly writePolicy?: PayloadProtectionWritePolicy;
-  readonly encryption?: PayloadProtectionEncryptionOptions;
+  /**
+   * Provider for protected writes and reads.
+   *
+   * The provider owns the opaque header used to resolve historical keys. A
+   * write-key transition is an application session boundary: drain pending
+   * appends, close this transport, then construct a replacement with the new
+   * finalized write epoch. streams-crdt does not invent that rekey barrier.
+   */
+  readonly provider?: PayloadProtectionProvider;
 }
 type E2eeReadPolicy = PayloadProtectionReadPolicy;
 type E2eeWritePolicy = PayloadProtectionWritePolicy;
-type E2eeScope = PayloadProtectionScope;
-type E2eeKey = PayloadProtectionKey;
-type E2eeKeyProvider = PayloadProtectionKeyProvider;
-type E2eeEncryptionOptions = PayloadProtectionEncryptionOptions;
+type E2eeProvider = PayloadProtectionProvider;
+type E2eeProviderConfig = PayloadProtectionProviderConfig;
 type E2eeOptions = PayloadProtectionOptions;
 /**
  * Active live subscription returned by `join()`.
@@ -798,7 +843,11 @@ interface EphemeralStreamCrdtOptions {
  * Each instance is bound to exactly one stream URL and one local CRDT adapter.
  */
 interface StreamsCrdtOptions<TVersion extends JsonObject> {
-  /** Full stream URL, typically built with `createStreamUrl()`. */
+  /**
+   * Full, opaque Durable Streams URL used for HTTP requests and cursor keys.
+   * Payload-protection providers own any separate application/room identity
+   * they authenticate; streams-crdt never parses this URL to derive AAD.
+   */
   readonly streamUrl: string;
   /** CRDT adapter for the local document or replica. */
   readonly adapter: CrdtAdapter<TVersion>;
@@ -861,11 +910,15 @@ interface StreamsCrdtOptions<TVersion extends JsonObject> {
    */
   readonly e2ee?: E2eeOptions;
   /**
-   * Deprecated alias for `e2ee`.
+   * Fail construction when `e2ee` is absent.
+   * Repo integrations can set this after enabling protection globally so a
+   * missing per-room config never becomes an implicit plaintext room.
    *
-   * Prefer `e2ee`. Passing both `e2ee` and `payloadProtection` is an error.
+   * This is a missing-config guard, not a policy override. An explicitly
+   * supplied config may still opt into `allow-plaintext` / `plaintext`, for
+   * example for the public write-only mode.
    */
-  readonly payloadProtection?: PayloadProtectionOptions;
+  readonly payloadProtectionRequired?: boolean;
   readonly snapshotUpload?: SnapshotUploadOptions;
   /** Optional origin pools for routing transport requests. */
   readonly shardUrls?: StreamsCrdtShardUrlsOptions;
@@ -1265,33 +1318,16 @@ declare class LocalAppendFailedError extends Error {
 }
 //#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 {
   readonly reason: PayloadProtectionFailureReason;
-  readonly keyId?: string;
-  constructor(reason: PayloadProtectionFailureReason, message: string, options?: {
-    readonly keyId?: string;
-    readonly cause?: unknown;
-  });
+  constructor(reason: PayloadProtectionFailureReason, message?: string);
 }
 //#endregion
 //#region src/stream-id.d.ts
 /**
- * Validates a stream id accepted by `createStreamUrl()`.
+ * Validates a Durable Streams stream id.
  */
 declare function isValidRillId(id: string): boolean;
-/**
- * Validates a bucket id accepted by `createStreamUrl()`.
- */
-declare function isValidBucketId(id: string): boolean;
-/**
- * Builds a Durable Streams HTTP URL for one `(bucketId, streamId)` pair.
- */
-declare function createStreamUrl(input: {
-  bucketId: string;
-  streamId: string;
-  baseUrl?: string;
-}): string;
 //#endregion
-export { WriteOnlyAppendResult as $, PayloadProtectionKeyProvider as A, StreamsAuthProvider as B, EphemeralStreamSubscription as C, LocalSyncStats as D, JsonValue as E, Result as F, TransportCreateStreamSuccess as G, StreamsCrdtShardUrlsOptions as H, SnapshotCodec as I, TransportJoinParams as J, TransportDeleteStreamSuccess as K, SnapshotTransformHook as L, PayloadProtectionReadPolicy as M, PayloadProtectionScope as N, PayloadProtectionEncryptionOptions as O, PayloadProtectionWritePolicy as P, TransportSyncSuccess as Q, SnapshotUploadOptions as R, EphemeralStreamJoinParams as S, JsonObject as T, TransportCatchupParams as U, StreamsCrdtOptions as V, TransportCatchupSuccess as W, TransportSnapshotUploadSuccess as X, TransportRoomStatus as Y, TransportSubscription as Z, E2eeReadPolicy as _, LocalAppendFailedError as a, RemoteCursor as at, EphemeralStreamAdaptor as b, CrdtAdapter as c, createInitialRemoteCursor as ct, CrdtUnresolvedSpan as d, BeforeRemoteCursorSaveContext as et, CrdtUpdateBatch as f, E2eeOptions as g, E2eeKeyProvider as h, PayloadProtectionError as i, IndexedDbRemoteCursorStoreOptions as it, PayloadProtectionOptions as j, PayloadProtectionKey as k, CrdtApplyOutcome as l, E2eeKey as m, isValidBucketId as n, InMemoryRemoteCursorStore as nt, EphemeralStreamCrdt as o, RemoteCursorSaveSource as ot, E2eeEncryptionOptions as p, TransportError as q, isValidRillId as r, IndexedDbRemoteCursorStore as rt, StreamsCrdt as s, RemoteCursorStore as st, createStreamUrl as t, BeforeRemoteCursorSaveHook as tt, CrdtApplyReturn as u, E2eeScope as v, IsolatedCrdtAdapter as w, EphemeralStreamCrdtOptions as x, E2eeWritePolicy as y, StreamsAuthContext as z };
-//# sourceMappingURL=stream-id-BuXMoCvo.d.ts.map
+export { WriteOnlyAppendResult as $, PayloadProtectionProviderConfig as A, StreamsAuthProvider as B, LocalSyncStats as C, PayloadProtectionOpenInput as D, PayloadProtectionKind as E, Result as F, TransportCreateStreamSuccess as G, StreamsCrdtShardUrlsOptions as H, SnapshotCodec as I, TransportJoinParams as J, TransportDeleteStreamSuccess as K, SnapshotTransformHook as L, PayloadProtectionSealInput as M, PayloadProtectionSealResult as N, PayloadProtectionOptions as O, PayloadProtectionWritePolicy as P, TransportSyncSuccess as Q, SnapshotUploadOptions as R, JsonValue as S, PayloadProtectionFailureReason as T, TransportCatchupParams as U, StreamsCrdtOptions as V, TransportCatchupSuccess as W, TransportSnapshotUploadSuccess as X, TransportRoomStatus as Y, TransportSubscription as Z, EphemeralStreamCrdtOptions as _, StreamsCrdt as a, RemoteCursor as at, IsolatedCrdtAdapter as b, CrdtApplyReturn as c, createInitialRemoteCursor as ct, E2eeOptions as d, BeforeRemoteCursorSaveContext as et, E2eeProvider as f, EphemeralStreamAdaptor as g, E2eeWritePolicy as h, EphemeralStreamCrdt as i, IndexedDbRemoteCursorStoreOptions as it, PayloadProtectionReadPolicy as j, PayloadProtectionProvider as k, CrdtUnresolvedSpan as l, E2eeReadPolicy as m, PayloadProtectionError as n, InMemoryRemoteCursorStore as nt, CrdtAdapter as o, RemoteCursorSaveSource as ot, E2eeProviderConfig as p, TransportError as q, LocalAppendFailedError as r, IndexedDbRemoteCursorStore as rt, CrdtApplyOutcome as s, RemoteCursorStore as st, isValidRillId as t, BeforeRemoteCursorSaveHook as tt, CrdtUpdateBatch as u, EphemeralStreamJoinParams as v, PayloadProtectionContext as w, JsonObject as x, EphemeralStreamSubscription as y, StreamsAuthContext as z };
+//# sourceMappingURL=stream-id-CO65-58E.d.ts.map