@loro-dev/streams-crdt 0.15.0 → 0.15.1

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

@@ -1099,6 +1099,35 @@ declare class StreamsCrdt<TVersion extends JsonObject> implements StreamsCrdtLik
   private disposeJoinState;
   private runInitialSyncWithDeadline;
   private startJoin;
+  /**
+   * Join-time salvage for a stream whose head cannot be fully applied
+   * (apply_incomplete at `up_to_date`, even after bootstrap): before the
+   * join surfaces the error, durably append everything this replica holds
+   * that the server does not.
+   *
+   * Why this exists: the dual-author wedge is usually two-sided — the stream
+   * is missing some author's ops, and a replica that HOLDS those ops (e.g.
+   * received out-of-band over a local data plane) may itself be unable to
+   * complete the join because of a second gap. The regular join-time export
+   * runs only AFTER a successful initial sync, so without this salvage such
+   * a replica can never publish the healing ops, and its own backlog from a
+   * previous process run stays local for as long as the stream stays
+   * poisoned.
+   *
+   * `error.appliedVersion` advances only from success spans, so
+   * `exportUpdates(appliedVersion)` is exactly "ops this replica holds that
+   * the server does not" — the failed initial sync already imported
+   * everything the server DOES have, so the delta cannot re-append
+   * server-known data. Cursor safety is untouched: the append is write-only
+   * style (producer-acked, no read catch-up, no durable-cursor save), and
+   * the retried initial sync re-derives its cursor from the server.
+   *
+   * Returns `true` when anything was durably appended; the caller then
+   * retries the initial sync once. Best-effort: a salvage failure logs and
+   * returns `false` so the original apply-incomplete error is what callers
+   * observe.
+   */
+  private salvageLocalBacklogOnIncompleteInitialSync;
   private syncOnce;
   private performInitialJoinSync;
   private createInitialCursor;
@@ -1213,6 +1242,12 @@ declare class StreamsCrdt<TVersion extends JsonObject> implements StreamsCrdtLik
    * `"error"` write status (with `lastWriteError` set) and then retries via
    * this flush's own backoff timer (`maybeScheduleWriteRetry`) — it does not
    * depend on a future local op to re-trigger the flush.
+   *
+   * While the cursor is incomplete (unresolved remote spans), the flush
+   * degrades to an append-only mode instead of pausing: batches still reach
+   * the server, but read progress, durable-cursor saves, and snapshot
+   * scheduling stay untouched. See the inline comment in the incomplete
+   * branch and specs/loro-pending.md "Local Append Rules".
    */
   private flushPendingLocal;
   /**
@@ -1330,4 +1365,4 @@ declare class PayloadProtectionError extends Error {
 declare function isValidRillId(id: string): boolean;
 //#endregion
 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
+//# sourceMappingURL=stream-id-CVCOLgSp.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@loro-dev/streams-crdt",
   "description": "Transport/runtime layer for synchronizing CRDT state over Durable Streams.",
-  "version": "0.15.0",
+  "version": "0.15.1",
   "license": "MIT",
   "author": "Loro Team",
   "homepage": "https://streams.loro.dev",