@loro-dev/streams-crdt 0.11.1 → 0.12.1

package/dist/{stream-id-DAAMJlvT.d.ts → stream-id-DJYQlTE2.d.ts}

@@ -104,10 +104,29 @@ declare function createInitialRemoteCursor<TVersion extends JsonObject = JsonObj
  * Retry and timeout settings used by `StreamsCrdt`.
  */
 interface ReconnectConfig {
+  /** Retry delay schedule in milliseconds, indexed by retry attempt and clamped at the last entry. */
   readonly delays: readonly number[];
+  /** Fractional +/- jitter applied to scheduled retry delays. */
   readonly jitterFraction: number;
+  /** Maximum retry attempts for background live loops. Use `Infinity` to retry forever. */
   readonly maxAttempts: number;
+  /** Connect deadline for ordinary transport requests. */
   readonly connectTimeoutMs: number;
+  /**
+   * Soft diagnostic threshold for initial bootstrap/catch-up.
+   *
+   * Crossing this threshold does not abort or reject the in-flight request.
+   * Set to 0 or `Infinity` to disable it.
+   */
+  readonly initialSyncSlowAfterMs?: number;
+  /**
+   * Hard cap for initial bootstrap/catch-up before aborting with
+   * `initial_sync_timeout`.
+   *
+   * Set to 0 or `Infinity` to disable it.
+   */
+  readonly initialSyncHardTimeoutMs?: number;
+  /** Poll deadline for ordinary long-poll/read requests. */
   readonly pollTimeoutMs: number;
   /** SSE inactivity timeout. Aborts and reconnects if no event arrives within this period. */
   readonly liveInactivityTimeoutMs?: number;
@@ -186,6 +205,7 @@ type TransportRoomStatus = "joined" | "reconnecting" | "disconnected" | "error";
  * - `protocol_error` — 400/405/409 or malformed response; treat as a bug.
  * - `network_error` — fetch-level failure (DNS, connection refused). Retry.
  * - `timeout` — connect or poll deadline exceeded. Retry.
+ * - `initial_sync_timeout` — initial bootstrap/catch-up exceeded its hard cap.
  * - `gone` — 410; persisted cursor is no longer valid. Bootstrap from scratch.
  * - `apply_incomplete` — a CRDT adapter could not fully apply remote data.
  * - `server_error` — 5xx; transient backend failure, retry with backoff.
@@ -272,6 +292,18 @@ type TransportError =
   readonly phase: "connect" | "poll";
   readonly message: string;
 }
+/**
+ * Initial bootstrap/catch-up exceeded its hard timeout. The request was allowed
+ * past the slow diagnostic threshold first; this only fires at the hard cap.
+ */
+| {
+  readonly code: "initial_sync_timeout";
+  readonly retryable: true;
+  readonly operation: string;
+  readonly timeoutMs: number;
+  readonly elapsedMs: number;
+  readonly message: string;
+}
 /**
  * The server indicated the persisted cursor is no longer valid (410). The
  * runtime will bootstrap from scratch on the next `join()`/`sync()` —
@@ -418,19 +450,32 @@ interface StreamsCrdtShardUrlsOptions {
    * Origin URLs used for `GET <stream>/bootstrap`.
    *
    * Each entry should be an origin URL such as
-   * `https://control-a.streams-api-proxy.loro.dev`. The transport keeps the
+   * `https://control-a.api.streams-api-x.loro.dev`. The transport keeps the
    * stream path and query from `streamUrl` and only replaces the request origin.
+   * If omitted, `other` is used as the fallback pool for bootstrap requests.
    */
   readonly bootstrap?: readonly string[];
   /**
    * Origin URLs used for non-SSE catch-up reads:
    * `GET <stream>?offset=...` and long-poll fallback reads.
+   *
+   * If omitted, `other` is used as the fallback pool for catch-up requests.
    */
   readonly catchup?: readonly string[];
   /**
    * Origin URLs used for large `POST <stream>` append requests.
+   *
+   * If omitted, `other` is used as the fallback pool for large append requests.
    */
   readonly largePost?: readonly string[];
+  /**
+   * Origin URLs used when no operation-specific shard pool routes the request.
+   *
+   * This covers live SSE reads, create/delete/head requests, snapshot uploads,
+   * append POSTs not routed by `largePost`, and any future request shape not
+   * listed above.
+   */
+  readonly other?: readonly string[];
   /**
    * Minimum request body size before `largePost` routing applies.
    *
@@ -670,6 +715,8 @@ interface EphemeralStreamCrdtOptions {
   readonly auth?: StreamsAuthProvider;
   /** Optional fetch implementation for tests, workers, or custom runtimes. */
   readonly fetch?: (input: string, init?: RequestInit) => Promise<Response>;
+  /** Optional origin pools for routing ephemeral POST/SSE requests. */
+  readonly shardUrls?: StreamsCrdtShardUrlsOptions;
   /** Reconnect policy for the SSE read loop and local POST retry loop. */
   readonly reconnectConfig?: Partial<ReconnectConfig>;
   /** Enables diagnostic console logging for terminal read/write failures. */
@@ -690,6 +737,15 @@ interface StreamsCrdtOptions<TVersion extends JsonObject> {
    * Defaults to false so missing streams are surfaced explicitly.
    */
   readonly createStreamIfMissing?: boolean;
+  /**
+   * Optional stream time-to-live in seconds used when creating the stream.
+   *
+   * Applies to both explicit `createStream()` calls and automatic stream
+   * creation through `createStreamIfMissing`. The value must be a non-negative
+   * safe integer. Updating this option on an existing stream has no effect
+   * until the transport creates that stream again.
+   */
+  readonly streamTtlSeconds?: number;
   /**
    * Auth token source.
    *
@@ -741,8 +797,16 @@ interface StreamsCrdtOptions<TVersion extends JsonObject> {
    */
   readonly payloadProtection?: PayloadProtectionOptions;
   readonly snapshotUpload?: SnapshotUploadOptions;
-  /** Optional origin pools for routing bootstrap/catch-up and large append requests. */
+  /** Optional origin pools for routing transport requests. */
   readonly shardUrls?: StreamsCrdtShardUrlsOptions;
+  /**
+   * Partial override for retry, ordinary request timeout, live SSE inactivity,
+   * and initial bootstrap/catch-up deadline behavior.
+   *
+   * The runtime merges this with its defaults. `initialSyncSlowAfterMs` is only
+   * a diagnostic threshold; it does not abort the request. `initialSyncHardTimeoutMs`
+   * aborts initial bootstrap/catch-up and returns `initial_sync_timeout`.
+   */
   readonly reconnectConfig?: Partial<ReconnectConfig>;
   readonly debug?: boolean;
 }
@@ -897,6 +961,7 @@ declare class StreamsCrdt<TVersion extends JsonObject> implements StreamsCrdtLik
   join(params?: TransportJoinParams): Promise<Result<TransportSubscription, TransportError>>;
   private createSubscription;
   private disposeJoinState;
+  private runInitialSyncWithDeadline;
   private startJoin;
   private syncOnce;
   private performInitialJoinSync;
@@ -1051,4 +1116,4 @@ declare function createStreamUrl(input: {
 }): string;
 //#endregion
 export { BeforeRemoteCursorSaveHook as $, PayloadProtectionReadPolicy as A, StreamsCrdtShardUrlsOptions as B, IsolatedCrdtAdapter as C, PayloadProtectionKey as D, PayloadProtectionEncryptionOptions as E, SnapshotTransformHook as F, TransportError as G, TransportCatchupSuccess as H, SnapshotUploadOptions as I, TransportSnapshotUploadSuccess as J, TransportJoinParams as K, StreamsAuthContext as L, PayloadProtectionWritePolicy as M, Result as N, PayloadProtectionKeyProvider as O, SnapshotCodec as P, BeforeRemoteCursorSaveContext as Q, StreamsAuthProvider as R, EphemeralStreamSubscription as S, JsonValue as T, TransportCreateStreamSuccess as U, TransportCatchupParams as V, TransportDeleteStreamSuccess as W, TransportSyncSuccess as X, TransportSubscription as Y, WriteOnlyAppendResult as Z, E2eeScope as _, EphemeralStreamCrdt as a, RemoteCursorStore as at, EphemeralStreamCrdtOptions as b, CrdtApplyOutcome as c, CrdtUpdateBatch as d, InMemoryRemoteCursorStore as et, E2eeEncryptionOptions as f, E2eeReadPolicy as g, E2eeOptions as h, PayloadProtectionError as i, RemoteCursorSaveSource as it, PayloadProtectionScope as j, PayloadProtectionOptions as k, CrdtApplyReturn as l, E2eeKeyProvider as m, isValidBucketId as n, IndexedDbRemoteCursorStoreOptions as nt, StreamsCrdt as o, createInitialRemoteCursor as ot, E2eeKey as p, TransportRoomStatus as q, isValidRillId as r, RemoteCursor as rt, CrdtAdapter as s, createStreamUrl as t, IndexedDbRemoteCursorStore as tt, CrdtUnresolvedSpan as u, E2eeWritePolicy as v, JsonObject as w, EphemeralStreamJoinParams as x, EphemeralStreamAdaptor as y, StreamsCrdtOptions as z };
-//# sourceMappingURL=stream-id-DAAMJlvT.d.ts.map
+//# sourceMappingURL=stream-id-DJYQlTE2.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.11.1",
+  "version": "0.12.1",
   "license": "MIT",
   "author": "Loro Team",
   "homepage": "https://streams.loro.dev",