@loro-dev/streams-crdt 0.1.2 → 0.2.1

package/README.md

@@ -184,8 +184,31 @@ the transport also clears the stored replay cursor for that stream.
 - a sync callback returning a string
 - an async callback returning a string
 
-This is intended for refresh-token flows. `StreamsCrdt` asks for a token before
-requests; token refresh itself remains caller-owned.
+`StreamsCrdt` asks for a token before each request. If a request comes back
+with `401` or `403`, it calls `auth` one more time with
+`{ reason: "unauthorized", status, previousToken }` and retries that request
+once.
+
+This lets the caller keep a cached token in the normal path, and only refresh
+after the server rejects it:
+
+```ts
+let token = readCachedGatewayJwt();
+
+const transport = new StreamsCrdt({
+  streamUrl,
+  adapter,
+  auth: async (context) => {
+    if (context?.reason === "unauthorized") {
+      token = await refreshGatewayJwt();
+    }
+    return token;
+  },
+});
+```
+
+If your callback already returns a fresh token every time, you can ignore the
+`context` argument.
 
 ## Remote Cursor Store
 
@@ -491,7 +514,7 @@ const transport = new StreamsCrdt({
 - `createStreamIfMissing` defaults to `false` and only affects the initial sync/join bootstrap
 - `deleteStream()` returns `{ deleted: false }` when the target stream is already missing
 - `sync()` and `join()` return `Result` objects instead of implicitly creating missing streams
-- `join()` resolves only after the initial replay has succeeded; without a stored remote cursor it prefers bootstrap-live SSE and falls back sticky to long-poll
+- `join()` resolves only after the initial replay has succeeded; without a stored remote cursor it bootstraps once, then prefers ordinary live SSE and falls back sticky to long-poll
 - One transport instance maps to one DS stream
 - One adapter instance maps to one local CRDT instance
 - Built-in remote cursor stores implement `delete(streamUrl)` so `deleteStream()` can reset replay state cleanly

package/dist/flock.d.ts

@@ -1,4 +1,4 @@
-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-BfuQIfcB.js";
+import { A as RemoteCursorStore, C as BeforeRemoteCursorSaveContext, D as IndexedDbRemoteCursorStoreOptions, E as IndexedDbRemoteCursorStore, O as RemoteCursor, S as TransportSyncSuccess, T as InMemoryRemoteCursorStore, _ as TransportDeleteStreamSuccess, a as CrdtAdapter, b as TransportRoomStatus, c as JsonValue, d as SnapshotTransformHook, f as SnapshotUploadOptions, g as TransportCreateStreamSuccess, h as StreamsCrdtOptions, i as StreamsCrdt, j as createInitialRemoteCursor, k as RemoteCursorSaveSource, l as Result, m as StreamsAuthProvider, n as isValidBucketId, o as CrdtUpdateBatch, p as StreamsAuthContext, r as isValidRillId, s as JsonObject, t as createStreamUrl, u as SnapshotCodec, v as TransportError, w as BeforeRemoteCursorSaveHook, x as TransportSubscription, y as TransportJoinParams } from "./stream-id-BxGVitUa.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, type ExportBundle, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, IndexedDbRemoteCursorStoreOptions, JsonObject, JsonValue, RemoteCursor, RemoteCursorSaveSource, RemoteCursorStore, Result, SnapshotCodec, SnapshotTransformHook, SnapshotUploadOptions, StreamsAuthProvider, StreamsCrdt, StreamsCrdtOptions, TransportCreateStreamSuccess, TransportDeleteStreamSuccess, TransportError, TransportJoinParams, TransportRoomStatus, TransportSubscription, TransportSyncSuccess, type VersionVector, createFlockAdapter, createInitialRemoteCursor, createStreamUrl, isValidBucketId, isValidRillId };
+export { BeforeRemoteCursorSaveContext, BeforeRemoteCursorSaveHook, CrdtAdapter, CrdtUpdateBatch, type ExportBundle, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, IndexedDbRemoteCursorStoreOptions, JsonObject, JsonValue, RemoteCursor, RemoteCursorSaveSource, RemoteCursorStore, Result, SnapshotCodec, SnapshotTransformHook, SnapshotUploadOptions, StreamsAuthContext, StreamsAuthProvider, StreamsCrdt, StreamsCrdtOptions, TransportCreateStreamSuccess, TransportDeleteStreamSuccess, TransportError, TransportJoinParams, TransportRoomStatus, TransportSubscription, TransportSyncSuccess, type VersionVector, 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-YOFZ4I6Y.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-kM9JM1F7.js";
 //#region src/flock.ts
 function isAfter(entry, current) {
 	return entry.physicalTime > current.physicalTime || entry.physicalTime === current.physicalTime && entry.logicalCounter > current.logicalCounter;
@@ -87,10 +87,11 @@ function createFlockAdapter(flock) {
 						peerId: flock.peerId()
 					});
 					if (!hasEntries(batchPayload)) return;
-					recordExportFrontier(flock.version());
+					const exportedVersion = extractVersionFromBundle(batchPayload);
+					recordExportFrontier(exportedVersion);
 					listener({
 						updates: [new TextEncoder().encode(JSON.stringify(batchPayload))],
-						version: extractVersionFromBundle(batchPayload)
+						version: exportedVersion
 					});
 				};
 				localExportQueue = localExportQueue.then(drain).catch(() => {});

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\";\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 * 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    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      let merged = remoterVersion;\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        flock.importJson(bundle);\n        merged = mergeVersions(merged, extractVersionFromBundle(bundle));\n      }\n      return merged;\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          recordExportFrontier(flock.version());\n          listener({\n            updates: [new TextEncoder().encode(JSON.stringify(batchPayload))],\n            version: extractVersionFromBundle(batchPayload),\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\";\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 * 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    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      let merged = remoterVersion;\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        flock.importJson(bundle);\n        merged = mergeVersions(merged, extractVersionFromBundle(bundle));\n      }\n      return merged;\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 { 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-BfuQIfcB.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 };
+import { A as RemoteCursorStore, C as BeforeRemoteCursorSaveContext, D as IndexedDbRemoteCursorStoreOptions, E as IndexedDbRemoteCursorStore, O as RemoteCursor, S as TransportSyncSuccess, T as InMemoryRemoteCursorStore, _ as TransportDeleteStreamSuccess, a as CrdtAdapter, b as TransportRoomStatus, c as JsonValue, d as SnapshotTransformHook, f as SnapshotUploadOptions, g as TransportCreateStreamSuccess, h as StreamsCrdtOptions, i as StreamsCrdt, j as createInitialRemoteCursor, k as RemoteCursorSaveSource, l as Result, m as StreamsAuthProvider, n as isValidBucketId, o as CrdtUpdateBatch, p as StreamsAuthContext, r as isValidRillId, s as JsonObject, t as createStreamUrl, u as SnapshotCodec, v as TransportError, w as BeforeRemoteCursorSaveHook, x as TransportSubscription, y as TransportJoinParams } from "./stream-id-BxGVitUa.js";
+export { BeforeRemoteCursorSaveContext, BeforeRemoteCursorSaveHook, CrdtAdapter, CrdtUpdateBatch, InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, IndexedDbRemoteCursorStoreOptions, JsonObject, JsonValue, RemoteCursor, RemoteCursorSaveSource, RemoteCursorStore, Result, SnapshotCodec, SnapshotTransformHook, SnapshotUploadOptions, StreamsAuthContext, 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-YOFZ4I6Y.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-kM9JM1F7.js";
 export { InMemoryRemoteCursorStore, IndexedDbRemoteCursorStore, StreamsCrdt, createInitialRemoteCursor, createStreamUrl, isValidBucketId, isValidRillId };

package/dist/loro.d.ts

@@ -1,4 +1,4 @@
-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-BfuQIfcB.js";
+import { A as RemoteCursorStore, C as BeforeRemoteCursorSaveContext, D as IndexedDbRemoteCursorStoreOptions, E as IndexedDbRemoteCursorStore, O as RemoteCursor, S as TransportSyncSuccess, T as InMemoryRemoteCursorStore, _ as TransportDeleteStreamSuccess, a as CrdtAdapter, b as TransportRoomStatus, c as JsonValue, d as SnapshotTransformHook, f as SnapshotUploadOptions, g as TransportCreateStreamSuccess, h as StreamsCrdtOptions, i as StreamsCrdt, j as createInitialRemoteCursor, k as RemoteCursorSaveSource, l as Result, m as StreamsAuthProvider, n as isValidBucketId, o as CrdtUpdateBatch, p as StreamsAuthContext, r as isValidRillId, s as JsonObject, t as createStreamUrl, u as SnapshotCodec, v as TransportError, w as BeforeRemoteCursorSaveHook, x as TransportSubscription, y as TransportJoinParams } from "./stream-id-BxGVitUa.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, SnapshotCodec, SnapshotTransformHook, 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, StreamsAuthContext, 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-YOFZ4I6Y.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-kM9JM1F7.js";
 import { VersionVector, decodeImportBlobMeta } from "loro-crdt";
 //#region src/loro.ts
 function toDocVersionRecord(version) {

package/dist/{stream-id-BfuQIfcB.d.ts → stream-id-BxGVitUa.d.ts}

@@ -130,7 +130,27 @@ type JsonObject = {
 /**
  * Authorization source for gateway requests.
  */
-type StreamsAuthProvider = string | (() => MaybePromise<string | null | undefined>);
+type StreamsAuthContext = {
+  /** Default path before sending a request. */readonly reason: "request";
+} | {
+  /**
+   * The previous request was rejected by the server with 401/403.
+   *
+   * Return a freshly refreshed token here when the caller keeps its own
+   * token cache.
+   */
+  readonly reason: "unauthorized";
+  readonly status: 401 | 403;
+  readonly previousToken?: string;
+};
+/**
+ * Authorization source for gateway requests.
+ *
+ * The callback is invoked before each request. When a request comes back with
+ * 401/403, transport invokes it one more time with `reason: "unauthorized"`
+ * and retries that request once.
+ */
+type StreamsAuthProvider = string | ((context?: StreamsAuthContext) => MaybePromise<string | null | undefined>);
 /**
  * Rust-style result for transport operations that may fail for expected reasons.
  */
@@ -333,6 +353,13 @@ interface StreamsCrdtOptions<TVersion extends JsonObject> {
    * Defaults to false so missing streams are surfaced explicitly.
    */
   readonly createStreamIfMissing?: boolean;
+  /**
+   * Auth token source.
+   *
+   * String and zero-arg callback forms keep the old behavior. Callbacks may
+   * also inspect `context.reason` to refresh a cached token only after the
+   * server rejects the current one.
+   */
   readonly auth?: StreamsAuthProvider;
   readonly fetch?: (input: string, init?: RequestInit) => Promise<Response>;
   /**
@@ -436,10 +463,6 @@ declare class StreamsCrdt<TVersion extends JsonObject> implements StreamsCrdtLik
   private syncOnce;
   private performInitialJoinSync;
   private bootstrapIntoState;
-  private bootstrapIntoJoinedState;
-  private bootstrapIntoJoinedStateViaSse;
-  private continueJoinedSseSessionUntilCaughtUp;
-  private bootstrapIntoJoinedStateViaLongPoll;
   private catchup;
   private appendLocalBatch;
   private exportUpdates;
@@ -461,8 +484,6 @@ declare class StreamsCrdt<TVersion extends JsonObject> implements StreamsCrdtLik
   private createStreamRequest;
   private deleteStreamRequest;
   private readFromOffsetSseItems;
-  private openBootstrapSseSession;
-  private readBootstrapLongPoll;
   private readFromOffset;
   private bootstrap;
   private readSnapshotOffsetValue;
@@ -491,5 +512,5 @@ declare function createStreamUrl(input: {
   baseUrl?: string;
 }): string;
 //#endregion
-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-BfuQIfcB.d.ts.map
+export { RemoteCursorStore as A, BeforeRemoteCursorSaveContext as C, IndexedDbRemoteCursorStoreOptions as D, IndexedDbRemoteCursorStore as E, RemoteCursor as O, TransportSyncSuccess as S, InMemoryRemoteCursorStore as T, TransportDeleteStreamSuccess as _, CrdtAdapter as a, TransportRoomStatus as b, JsonValue as c, SnapshotTransformHook as d, SnapshotUploadOptions as f, TransportCreateStreamSuccess as g, StreamsCrdtOptions as h, StreamsCrdt as i, createInitialRemoteCursor as j, RemoteCursorSaveSource as k, Result as l, StreamsAuthProvider as m, isValidBucketId as n, CrdtUpdateBatch as o, StreamsAuthContext as p, isValidRillId as r, JsonObject as s, createStreamUrl as t, SnapshotCodec as u, TransportError as v, BeforeRemoteCursorSaveHook as w, TransportSubscription as x, TransportJoinParams as y };
+//# sourceMappingURL=stream-id-BxGVitUa.d.ts.map