@thru/replay 0.2.32 → 0.2.33

package/dist/index.d.cts

@@ -205,6 +205,47 @@ interface EventReplayOptions {
 }
 declare function createEventReplay(options: EventReplayOptions): ReplayStream<Event, string>;
 
+/**
+ * Retry utilities for stream reconnection with exponential backoff.
+ */
+interface RetryConfig {
+    /** Initial delay before first retry (default: 1000ms) */
+    initialDelayMs: number;
+    /** Maximum delay between retries (default: 30000ms) */
+    maxDelayMs: number;
+    /** Timeout for connection/read operations (default: 30000ms) */
+    connectionTimeoutMs: number;
+}
+declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+/**
+ * Calculate exponential backoff delay for a given attempt number.
+ * Starts at initialDelayMs and doubles each attempt, capped at maxDelayMs.
+ *
+ * @param attempt - Zero-based attempt number (0 = first retry)
+ * @param config - Retry configuration
+ * @returns Delay in milliseconds
+ */
+declare function calculateBackoff(attempt: number, config: RetryConfig): number;
+/**
+ * Wrap a promise with a timeout. Rejects with TimeoutError if the promise
+ * doesn't resolve within the specified time.
+ *
+ * @param promise - Promise to wrap
+ * @param timeoutMs - Timeout in milliseconds
+ * @returns Promise that resolves with the original value or rejects on timeout
+ */
+declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number): Promise<T>;
+/**
+ * Error thrown when an operation times out.
+ */
+declare class TimeoutError extends Error {
+    constructor(message: string);
+}
+/**
+ * Delay execution for a specified number of milliseconds.
+ */
+declare function delay(ms: number): Promise<void>;
+
 /**
  * Account Replay - streaming account state with backfill reconciliation.
  *
@@ -310,6 +351,10 @@ interface AccountsByOwnerReplayOptions {
     };
     /** Cleanup interval for page assembler (default: 10000ms) */
     cleanupInterval?: number;
+    /** Maximum time to wait for stale reconnect cleanup before creating a fresh stream. */
+    reconnectCleanupTimeoutMs?: number;
+    /** Retry timings for live stream reconnects (default: DEFAULT_RETRY_CONFIG). */
+    retryConfig?: RetryConfig;
     /** Called when backfill queue is drained. Returns the highest slot seen during backfill. */
     onBackfillComplete?: (highestSlot: bigint) => void;
     /** Logger for debug/info/warn/error messages (default: NOOP_LOGGER) */
@@ -546,47 +591,6 @@ declare class PageAssembler {
 declare const NOOP_LOGGER: ReplayLogger;
 declare function createConsoleLogger(prefix?: string): ReplayLogger;
 
-/**
- * Retry utilities for stream reconnection with exponential backoff.
- */
-interface RetryConfig {
-    /** Initial delay before first retry (default: 1000ms) */
-    initialDelayMs: number;
-    /** Maximum delay between retries (default: 30000ms) */
-    maxDelayMs: number;
-    /** Timeout for connection/read operations (default: 30000ms) */
-    connectionTimeoutMs: number;
-}
-declare const DEFAULT_RETRY_CONFIG: RetryConfig;
-/**
- * Calculate exponential backoff delay for a given attempt number.
- * Starts at initialDelayMs and doubles each attempt, capped at maxDelayMs.
- *
- * @param attempt - Zero-based attempt number (0 = first retry)
- * @param config - Retry configuration
- * @returns Delay in milliseconds
- */
-declare function calculateBackoff(attempt: number, config: RetryConfig): number;
-/**
- * Wrap a promise with a timeout. Rejects with TimeoutError if the promise
- * doesn't resolve within the specified time.
- *
- * @param promise - Promise to wrap
- * @param timeoutMs - Timeout in milliseconds
- * @returns Promise that resolves with the original value or rejects on timeout
- */
-declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number): Promise<T>;
-/**
- * Error thrown when an operation times out.
- */
-declare class TimeoutError extends Error {
-    constructor(message: string);
-}
-/**
- * Delay execution for a specified number of milliseconds.
- */
-declare function delay(ms: number): Promise<void>;
-
 interface ReplaySinkContext {
     slot: Slot;
     phase: "backfill" | "live";

package/dist/index.d.ts

@@ -205,6 +205,47 @@ interface EventReplayOptions {
 }
 declare function createEventReplay(options: EventReplayOptions): ReplayStream<Event, string>;
 
+/**
+ * Retry utilities for stream reconnection with exponential backoff.
+ */
+interface RetryConfig {
+    /** Initial delay before first retry (default: 1000ms) */
+    initialDelayMs: number;
+    /** Maximum delay between retries (default: 30000ms) */
+    maxDelayMs: number;
+    /** Timeout for connection/read operations (default: 30000ms) */
+    connectionTimeoutMs: number;
+}
+declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+/**
+ * Calculate exponential backoff delay for a given attempt number.
+ * Starts at initialDelayMs and doubles each attempt, capped at maxDelayMs.
+ *
+ * @param attempt - Zero-based attempt number (0 = first retry)
+ * @param config - Retry configuration
+ * @returns Delay in milliseconds
+ */
+declare function calculateBackoff(attempt: number, config: RetryConfig): number;
+/**
+ * Wrap a promise with a timeout. Rejects with TimeoutError if the promise
+ * doesn't resolve within the specified time.
+ *
+ * @param promise - Promise to wrap
+ * @param timeoutMs - Timeout in milliseconds
+ * @returns Promise that resolves with the original value or rejects on timeout
+ */
+declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number): Promise<T>;
+/**
+ * Error thrown when an operation times out.
+ */
+declare class TimeoutError extends Error {
+    constructor(message: string);
+}
+/**
+ * Delay execution for a specified number of milliseconds.
+ */
+declare function delay(ms: number): Promise<void>;
+
 /**
  * Account Replay - streaming account state with backfill reconciliation.
  *
@@ -310,6 +351,10 @@ interface AccountsByOwnerReplayOptions {
     };
     /** Cleanup interval for page assembler (default: 10000ms) */
     cleanupInterval?: number;
+    /** Maximum time to wait for stale reconnect cleanup before creating a fresh stream. */
+    reconnectCleanupTimeoutMs?: number;
+    /** Retry timings for live stream reconnects (default: DEFAULT_RETRY_CONFIG). */
+    retryConfig?: RetryConfig;
     /** Called when backfill queue is drained. Returns the highest slot seen during backfill. */
     onBackfillComplete?: (highestSlot: bigint) => void;
     /** Logger for debug/info/warn/error messages (default: NOOP_LOGGER) */
@@ -546,47 +591,6 @@ declare class PageAssembler {
 declare const NOOP_LOGGER: ReplayLogger;
 declare function createConsoleLogger(prefix?: string): ReplayLogger;
 
-/**
- * Retry utilities for stream reconnection with exponential backoff.
- */
-interface RetryConfig {
-    /** Initial delay before first retry (default: 1000ms) */
-    initialDelayMs: number;
-    /** Maximum delay between retries (default: 30000ms) */
-    maxDelayMs: number;
-    /** Timeout for connection/read operations (default: 30000ms) */
-    connectionTimeoutMs: number;
-}
-declare const DEFAULT_RETRY_CONFIG: RetryConfig;
-/**
- * Calculate exponential backoff delay for a given attempt number.
- * Starts at initialDelayMs and doubles each attempt, capped at maxDelayMs.
- *
- * @param attempt - Zero-based attempt number (0 = first retry)
- * @param config - Retry configuration
- * @returns Delay in milliseconds
- */
-declare function calculateBackoff(attempt: number, config: RetryConfig): number;
-/**
- * Wrap a promise with a timeout. Rejects with TimeoutError if the promise
- * doesn't resolve within the specified time.
- *
- * @param promise - Promise to wrap
- * @param timeoutMs - Timeout in milliseconds
- * @returns Promise that resolves with the original value or rejects on timeout
- */
-declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number): Promise<T>;
-/**
- * Error thrown when an operation times out.
- */
-declare class TimeoutError extends Error {
-    constructor(message: string);
-}
-/**
- * Delay execution for a specified number of milliseconds.
- */
-declare function delay(ms: number): Promise<void>;
-
 interface ReplaySinkContext {
     slot: Slot;
     phase: "backfill" | "live";