@milaboratories/pl-client 2.16.11 → 2.16.13

package/dist/core/websocket_stream.js

@@ -0,0 +1,328 @@
+import { WebSocket, ErrorEvent } from 'undici';
+import Denque from 'denque';
+import { RetryStrategy } from '../helpers/retry_strategy.js';
+
+var ConnectionState;
+(function (ConnectionState) {
+    ConnectionState[ConnectionState["NEW"] = 0] = "NEW";
+    ConnectionState[ConnectionState["CONNECTING"] = 1] = "CONNECTING";
+    ConnectionState[ConnectionState["CONNECTED"] = 2] = "CONNECTED";
+    ConnectionState[ConnectionState["CLOSING"] = 3] = "CLOSING";
+    ConnectionState[ConnectionState["CLOSED"] = 4] = "CLOSED";
+})(ConnectionState || (ConnectionState = {}));
+/**
+ * WebSocket-based bidirectional stream implementation for LLTransaction.
+ * Implements BiDiStream interface which is compatible with DuplexStreamingCall.
+ */
+class WebSocketBiDiStream {
+    url;
+    serializeClientMessage;
+    parseServerMessage;
+    options;
+    // Connection
+    ws = null;
+    connectionState = ConnectionState.NEW;
+    reconnection;
+    // Send management
+    sendQueue = new Denque();
+    sendCompleted = false;
+    onComplete;
+    // Response management
+    responseQueue = new Denque();
+    responseResolvers = [];
+    // Error tracking
+    lastError;
+    // === Public API ===
+    requests = {
+        send: async (message) => {
+            return await this.enqueueSend(message);
+        },
+        complete: async () => {
+            if (this.sendCompleted)
+                return;
+            await this.drainSendQueue(); // ensure we sent all already queued messages before closing the stream
+            try {
+                await this.onComplete(this); // custom onComplete may send additional messages
+            }
+            catch (_) {
+                // When 'complete' gets called concurrently with connection break or over a broken
+                // transaction stream (server decided it should drop transaction), server would close
+                // connection anyway on its end. We can safely ignore error here and just continue working.
+            }
+            this.sendCompleted = true;
+        },
+    };
+    responses = {
+        [Symbol.asyncIterator]: () => this.createResponseIterator(),
+    };
+    close() {
+        this.reconnection.cancel();
+        if (this.connectionState < ConnectionState.CONNECTED) {
+            // Never reached CONNECTED state. ws.close() will never trigger 'close' event.
+            this.ws?.close();
+            this.onClose();
+            return;
+        }
+        if (!this.progressConnectionState(ConnectionState.CLOSING))
+            return;
+        this.ws.close();
+    }
+    constructor(url, serializeClientMessage, parseServerMessage, options = {}) {
+        this.url = url;
+        this.serializeClientMessage = serializeClientMessage;
+        this.parseServerMessage = parseServerMessage;
+        this.options = options;
+        this.onComplete = this.options.onComplete ?? ((stream) => stream.close());
+        const retryConfig = this.options.retryConfig ?? {};
+        this.reconnection = new RetryStrategy(retryConfig, {
+            onRetry: () => { void this.connect(); },
+            onMaxAttemptsReached: (error) => this.handleError(error),
+        });
+        if (this.options.abortSignal?.aborted) {
+            this.progressConnectionState(ConnectionState.CLOSED);
+            return;
+        }
+        this.options.abortSignal?.addEventListener('abort', () => this.close());
+        this.connect();
+    }
+    // === Connection Lifecycle ===
+    connect() {
+        if (this.options.abortSignal?.aborted)
+            return;
+        // Prevent reconnecting after first successful connection.
+        if (!this.progressConnectionState(ConnectionState.CONNECTING))
+            return;
+        try {
+            this.ws = this.createWebSocket();
+            this.ws.addEventListener('open', () => this.onOpen());
+            this.ws.addEventListener('message', (event) => this.onMessage(event.data));
+            this.ws.addEventListener('error', (error) => this.onError(error));
+            this.ws.addEventListener('close', () => this.onClose());
+        }
+        catch (error) {
+            this.lastError = this.toError(error);
+            this.reconnection.schedule();
+        }
+    }
+    createWebSocket() {
+        const options = {};
+        if (this.options.jwtToken)
+            options.headers = { authorization: `Bearer ${this.options.jwtToken}` };
+        if (this.options.dispatcher)
+            options.dispatcher = this.options.dispatcher;
+        const ws = new WebSocket(this.url, options);
+        ws.binaryType = 'arraybuffer';
+        return ws;
+    }
+    onOpen() {
+        this.progressConnectionState(ConnectionState.CONNECTED);
+        this.processSendQueue();
+    }
+    onMessage(data) {
+        if (!(data instanceof ArrayBuffer)) {
+            this.handleError(new Error(`Unexpected WS message format: ${typeof data}`));
+            return;
+        }
+        try {
+            const message = this.parseServerMessage(new Uint8Array(data));
+            this.deliverResponse(message);
+        }
+        catch (error) {
+            this.handleError(this.toError(error));
+        }
+    }
+    onError(error) {
+        if (this.connectionState < ConnectionState.CONNECTED) {
+            // Try to connect several times until we succeed or run out of attempts.
+            this.lastError = this.toError(error);
+            this.reconnection.schedule();
+            return;
+        }
+        this.handleError(this.toError(error));
+    }
+    onClose() {
+        this.progressConnectionState(ConnectionState.CLOSED);
+        if (!this.lastError) {
+            this.rejectAllSendOperations(this.createStreamClosedError());
+            this.resolveAllPendingResponses(); // unblock active async iterator
+        }
+        else {
+            this.rejectAllPendingOperations(this.lastError);
+        }
+    }
+    // === Send Queue Management ===
+    enqueueSend(message) {
+        if (this.sendCompleted) {
+            throw new Error('Cannot send: stream already completed');
+        }
+        if (this.options.abortSignal?.aborted) {
+            throw new Error('Cannot send: stream aborted');
+        }
+        return new Promise((resolve, reject) => {
+            this.sendQueue.push({ message, resolve, reject });
+            this.processSendQueue();
+        });
+    }
+    processSendQueue() {
+        if (!this.canSendMessages())
+            return;
+        while (this.sendQueue.length > 0) {
+            const queued = this.sendQueue.shift();
+            this.sendQueuedMessage(queued);
+        }
+    }
+    canSendMessages() {
+        return this.connectionState === ConnectionState.CONNECTED;
+    }
+    sendQueuedMessage(queued) {
+        try {
+            const ws = this.ws;
+            if (!ws) {
+                throw new Error('WebSocket is not connected');
+            }
+            // Check if WebSocket is in a valid state for sending
+            if (ws.readyState !== WebSocket.OPEN) {
+                throw new Error(`WebSocket is not open (readyState: ${ws.readyState})`);
+            }
+            const binary = this.serializeClientMessage(queued.message);
+            ws.send(binary);
+            queued.resolve();
+        }
+        catch (error) {
+            queued.reject(this.toError(error));
+        }
+    }
+    async drainSendQueue() {
+        const POLL_INTERVAL_MS = 5;
+        while (this.sendQueue.length > 0) {
+            await this.waitForCondition(() => this.sendQueue.length === 0, POLL_INTERVAL_MS);
+        }
+    }
+    waitForCondition(condition, intervalMs) {
+        return new Promise((resolve, reject) => {
+            if (this.options.abortSignal?.aborted) {
+                return reject(this.toError(this.options.abortSignal.reason) ?? new Error('Stream aborted'));
+            }
+            let timeoutId;
+            const onAbort = () => {
+                clearTimeout(timeoutId);
+                reject(this.toError(this.options.abortSignal?.reason) ?? new Error('Stream aborted'));
+            };
+            this.options.abortSignal?.addEventListener('abort', onAbort, { once: true });
+            const check = () => {
+                if (condition() || this.isStreamEnded()) {
+                    this.options.abortSignal?.removeEventListener('abort', onAbort);
+                    resolve();
+                }
+                else {
+                    timeoutId = setTimeout(check, intervalMs);
+                }
+            };
+            check();
+        });
+    }
+    // === Response Delivery ===
+    deliverResponse(message) {
+        if (this.responseResolvers.length > 0) {
+            const resolver = this.responseResolvers.shift();
+            resolver.resolve({ value: message, done: false });
+        }
+        else {
+            this.responseQueue.push(message);
+        }
+    }
+    async *createResponseIterator() {
+        while (true) {
+            const result = await this.nextResponse();
+            if (result.done)
+                break;
+            yield result.value;
+        }
+    }
+    nextResponse() {
+        return new Promise((resolve, reject) => {
+            // Fast path: message already available
+            if (this.responseQueue.length > 0) {
+                const message = this.responseQueue.shift();
+                resolve({ value: message, done: false });
+                return;
+            }
+            // Stream ended
+            if (this.isStreamEnded()) {
+                if (this.lastError) {
+                    reject(this.lastError);
+                }
+                else {
+                    resolve({ value: undefined, done: true });
+                }
+                return;
+            }
+            // Wait for next message
+            this.responseResolvers.push({ resolve, reject });
+        });
+    }
+    resolveAllPendingResponses() {
+        while (this.responseResolvers.length > 0) {
+            const resolver = this.responseResolvers.shift();
+            resolver.resolve({ value: undefined, done: true });
+        }
+    }
+    // === Error Handling ===
+    handleError(error) {
+        this.lastError = error;
+        this.close();
+    }
+    rejectAllPendingOperations(error) {
+        this.rejectAllSendOperations(error);
+        this.rejectAllResponseResolvers(error);
+    }
+    rejectAllSendOperations(error) {
+        while (this.sendQueue.length > 0) {
+            const queued = this.sendQueue.shift();
+            queued.reject(error);
+        }
+    }
+    rejectAllResponseResolvers(error) {
+        while (this.responseResolvers.length > 0) {
+            const resolver = this.responseResolvers.shift();
+            resolver.reject(error);
+        }
+    }
+    createStreamClosedError() {
+        if (this.options.abortSignal?.aborted) {
+            const reason = this.options.abortSignal.reason;
+            if (reason instanceof Error) {
+                return reason;
+            }
+            return new Error('Stream aborted', { cause: reason });
+        }
+        return new Error('Stream closed');
+    }
+    // === Helpers ===
+    isStreamEnded() {
+        return this.connectionState === ConnectionState.CLOSED || this.options.abortSignal?.aborted || false;
+    }
+    toError(error) {
+        if (error instanceof Error)
+            return error;
+        if (error instanceof ErrorEvent)
+            return error.error;
+        return new Error(String(error));
+    }
+    /**
+     * Connection state progresses linearly from NEW to CLOSED and never goes back.
+     * This internal contract dramatically simplifies the internal stream state management.
+     *
+     * If you ever feel the need to make this contract less strict, think twice.
+     */
+    progressConnectionState(newState) {
+        if (newState < this.connectionState) {
+            return false;
+        }
+        this.connectionState = newState;
+        return true;
+    }
+}
+
+export { WebSocketBiDiStream };
+//# sourceMappingURL=websocket_stream.js.map

package/dist/core/websocket_stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket_stream.js","sources":["../../src/core/websocket_stream.ts"],"sourcesContent":["import { WebSocket, type WebSocketInit, type Dispatcher, ErrorEvent } from 'undici';\nimport type { BiDiStream } from './abstract_stream';\nimport Denque from 'denque';\nimport type { RetryConfig } from '../helpers/retry_strategy';\nimport { RetryStrategy } from '../helpers/retry_strategy';\n\ninterface QueuedMessage<InType extends object> {\n  message: InType;\n  resolve: () => void;\n  reject: (error: Error) => void;\n}\n\ninterface ResponseResolver<OutType extends object> {\n  resolve: (value: IteratorResult<OutType>) => void;\n  reject: (error: Error) => void;\n}\n\nenum ConnectionState {\n  NEW = 0,\n  CONNECTING = 1,\n  CONNECTED = 2,\n  CLOSING = 3,\n  CLOSED = 4,\n}\n\nexport type WSStreamOptions<ClientMsg extends object, ServerMsg extends object> = {\n  abortSignal?: AbortSignal;\n\n  dispatcher?: Dispatcher;\n  jwtToken?: string;\n  retryConfig?: Partial<RetryConfig>;\n\n  onComplete?: (stream: WebSocketBiDiStream<ClientMsg, ServerMsg>) => void | Promise<void>;\n};\n\n/**\n * WebSocket-based bidirectional stream implementation for LLTransaction.\n * Implements BiDiStream interface which is compatible with DuplexStreamingCall.\n */\nexport class WebSocketBiDiStream<ClientMsg extends object, ServerMsg extends object> implements BiDiStream<ClientMsg, ServerMsg> {\n  // Connection\n  private ws: WebSocket | null = null;\n  private connectionState: ConnectionState = ConnectionState.NEW;\n  private readonly reconnection: RetryStrategy;\n\n  // Send management\n  private readonly sendQueue = new Denque<QueuedMessage<ClientMsg>>();\n  private sendCompleted = false;\n  private readonly onComplete: (stream: WebSocketBiDiStream<ClientMsg, ServerMsg>) => void | Promise<void>;\n\n  // Response management\n  private readonly responseQueue = new Denque<ServerMsg>();\n  private responseResolvers: ResponseResolver<ServerMsg>[] = [];\n\n  // Error tracking\n  private lastError?: Error;\n\n  // === Public API ===\n\n  public readonly requests = {\n    send: async (message: ClientMsg): Promise<void> => {\n      return await this.enqueueSend(message);\n    },\n\n    complete: async (): Promise<void> => {\n      if (this.sendCompleted) return;\n\n      await this.drainSendQueue(); // ensure we sent all already queued messages before closing the stream\n      try {\n        await this.onComplete(this); // custom onComplete may send additional messages\n      } catch (_: unknown) {\n        // When 'complete' gets called concurrently with connection break or over a broken\n        // transaction stream (server decided it should drop transaction), server would close\n        // connection anyway on its end. We can safely ignore error here and just continue working.\n      }\n      this.sendCompleted = true;\n    },\n  };\n\n  public readonly responses: AsyncIterable<ServerMsg> = {\n    [Symbol.asyncIterator]: () => this.createResponseIterator(),\n  };\n\n  public close(): void {\n    this.reconnection.cancel();\n\n    if (this.connectionState < ConnectionState.CONNECTED) {\n      // Never reached CONNECTED state. ws.close() will never trigger 'close' event.\n      this.ws?.close();\n      this.onClose();\n      return;\n    }\n\n    if (!this.progressConnectionState(ConnectionState.CLOSING)) return;\n    this.ws!.close();\n  }\n\n  constructor(\n    private readonly url: string,\n    private readonly serializeClientMessage: (message: ClientMsg) => Uint8Array,\n    private readonly parseServerMessage: (data: Uint8Array) => ServerMsg,\n    private readonly options: WSStreamOptions<ClientMsg, ServerMsg> = {},\n  ) {\n    this.onComplete = this.options.onComplete ?? ((stream) => stream.close());\n\n    const retryConfig = this.options.retryConfig ?? {};\n    this.reconnection = new RetryStrategy(retryConfig, {\n      onRetry: () => { void this.connect(); },\n      onMaxAttemptsReached: (error) => this.handleError(error),\n    });\n\n    if (this.options.abortSignal?.aborted) {\n      this.progressConnectionState(ConnectionState.CLOSED);\n      return;\n    }\n\n    this.options.abortSignal?.addEventListener('abort', () => this.close());\n    this.connect();\n  }\n\n  // === Connection Lifecycle ===\n\n  private connect(): void {\n    if (this.options.abortSignal?.aborted) return;\n\n    // Prevent reconnecting after first successful connection.\n    if (!this.progressConnectionState(ConnectionState.CONNECTING)) return;\n\n    try {\n      this.ws = this.createWebSocket();\n\n      this.ws.addEventListener('open', () => this.onOpen());\n      this.ws.addEventListener('message', (event) => this.onMessage(event.data));\n      this.ws.addEventListener('error', (error) => this.onError(error));\n      this.ws.addEventListener('close', () => this.onClose());\n    } catch (error) {\n      this.lastError = this.toError(error);\n      this.reconnection.schedule();\n    }\n  }\n\n  private createWebSocket(): WebSocket {\n    const options: WebSocketInit = {};\n\n    if (this.options.jwtToken) options.headers = { authorization: `Bearer ${this.options.jwtToken}` };\n    if (this.options.dispatcher) options.dispatcher = this.options.dispatcher;\n\n    const ws = new WebSocket(this.url, options);\n    ws.binaryType = 'arraybuffer';\n    return ws;\n  }\n\n  private onOpen(): void {\n    this.progressConnectionState(ConnectionState.CONNECTED);\n    this.processSendQueue();\n  }\n\n  private onMessage(data: unknown): void {\n    if (!(data instanceof ArrayBuffer)) {\n      this.handleError(new Error(`Unexpected WS message format: ${typeof data}`));\n      return;\n    }\n\n    try {\n      const message = this.parseServerMessage(new Uint8Array(data));\n      this.deliverResponse(message);\n    } catch (error) {\n      this.handleError(this.toError(error));\n    }\n  }\n\n  private onError(error: unknown): void {\n    if (this.connectionState < ConnectionState.CONNECTED) {\n      // Try to connect several times until we succeed or run out of attempts.\n      this.lastError = this.toError(error);\n      this.reconnection.schedule();\n      return;\n    }\n\n    this.handleError(this.toError(error));\n  }\n\n  private onClose(): void {\n    this.progressConnectionState(ConnectionState.CLOSED);\n\n    if (!this.lastError) {\n      this.rejectAllSendOperations(this.createStreamClosedError());\n      this.resolveAllPendingResponses(); // unblock active async iterator\n    } else {\n      this.rejectAllPendingOperations(this.lastError);\n    }\n  }\n\n  // === Send Queue Management ===\n\n  private enqueueSend(message: ClientMsg): Promise<void> {\n    if (this.sendCompleted) {\n      throw new Error('Cannot send: stream already completed');\n    }\n\n    if (this.options.abortSignal?.aborted) {\n      throw new Error('Cannot send: stream aborted');\n    }\n\n    return new Promise<void>((resolve, reject) => {\n      this.sendQueue.push({ message, resolve, reject });\n      this.processSendQueue();\n    });\n  }\n\n  private processSendQueue(): void {\n    if (!this.canSendMessages()) return;\n\n    while (this.sendQueue.length > 0) {\n      const queued = this.sendQueue.shift()!;\n      this.sendQueuedMessage(queued);\n    }\n  }\n\n  private canSendMessages(): boolean {\n    return this.connectionState === ConnectionState.CONNECTED;\n  }\n\n  private sendQueuedMessage(queued: QueuedMessage<ClientMsg>): void {\n    try {\n      const ws = this.ws;\n      if (!ws) {\n        throw new Error('WebSocket is not connected');\n      }\n\n      // Check if WebSocket is in a valid state for sending\n      if (ws.readyState !== WebSocket.OPEN) {\n        throw new Error(`WebSocket is not open (readyState: ${ws.readyState})`);\n      }\n\n      const binary = this.serializeClientMessage(queued.message);\n      ws.send(binary);\n      queued.resolve();\n    } catch (error) {\n      queued.reject(this.toError(error));\n    }\n  }\n\n  private async drainSendQueue(): Promise<void> {\n    const POLL_INTERVAL_MS = 5;\n\n    while (this.sendQueue.length > 0) {\n      await this.waitForCondition(\n        () => this.sendQueue.length === 0,\n        POLL_INTERVAL_MS,\n      );\n    }\n  }\n\n  private waitForCondition(\n    condition: () => boolean,\n    intervalMs: number,\n  ): Promise<void> {\n    return new Promise<void>((resolve, reject) => {\n      if (this.options.abortSignal?.aborted) {\n        return reject(this.toError(this.options.abortSignal.reason) ?? new Error('Stream aborted'));\n      }\n\n      let timeoutId: ReturnType<typeof setTimeout>;\n      const onAbort = () => {\n        clearTimeout(timeoutId);\n        reject(this.toError(this.options.abortSignal?.reason) ?? new Error('Stream aborted'));\n      };\n\n      this.options.abortSignal?.addEventListener('abort', onAbort, { once: true });\n\n      const check = () => {\n        if (condition() || this.isStreamEnded()) {\n          this.options.abortSignal?.removeEventListener('abort', onAbort);\n          resolve();\n        } else {\n          timeoutId = setTimeout(check, intervalMs);\n        }\n      };\n\n      check();\n    });\n  }\n\n  // === Response Delivery ===\n\n  private deliverResponse(message: ServerMsg): void {\n    if (this.responseResolvers.length > 0) {\n      const resolver = this.responseResolvers.shift()!;\n      resolver.resolve({ value: message, done: false });\n    } else {\n      this.responseQueue.push(message);\n    }\n  }\n\n  private async *createResponseIterator(): AsyncIterator<ServerMsg> {\n    while (true) {\n      const result = await this.nextResponse();\n\n      if (result.done) break;\n\n      yield result.value;\n    }\n  }\n\n  private nextResponse(): Promise<IteratorResult<ServerMsg>> {\n    return new Promise<IteratorResult<ServerMsg>>((resolve, reject) => {\n      // Fast path: message already available\n      if (this.responseQueue.length > 0) {\n        const message = this.responseQueue.shift()!;\n        resolve({ value: message, done: false });\n        return;\n      }\n\n      // Stream ended\n      if (this.isStreamEnded()) {\n        if (this.lastError) {\n          reject(this.lastError);\n        } else {\n          resolve({ value: undefined as any, done: true });\n        }\n        return;\n      }\n\n      // Wait for next message\n      this.responseResolvers.push({ resolve, reject });\n    });\n  }\n\n  private resolveAllPendingResponses(): void {\n    while (this.responseResolvers.length > 0) {\n      const resolver = this.responseResolvers.shift()!;\n      resolver.resolve({ value: undefined as any, done: true });\n    }\n  }\n\n  // === Error Handling ===\n\n  private handleError(error: Error): void {\n    this.lastError = error;\n    this.close();\n  }\n\n  private rejectAllPendingOperations(error: Error): void {\n    this.rejectAllSendOperations(error);\n    this.rejectAllResponseResolvers(error);\n  }\n\n  private rejectAllSendOperations(error: Error): void {\n    while (this.sendQueue.length > 0) {\n      const queued = this.sendQueue.shift()!;\n      queued.reject(error);\n    }\n  }\n\n  private rejectAllResponseResolvers(error: Error): void {\n    while (this.responseResolvers.length > 0) {\n      const resolver = this.responseResolvers.shift()!;\n      resolver.reject(error);\n    }\n  }\n\n  private createStreamClosedError(): Error {\n    if (this.options.abortSignal?.aborted) {\n      const reason = this.options.abortSignal.reason;\n      if (reason instanceof Error) {\n        return reason;\n      }\n      return new Error('Stream aborted', { cause: reason });\n    }\n\n    return new Error('Stream closed');\n  }\n\n  // === Helpers ===\n\n  private isStreamEnded(): boolean {\n    return this.connectionState === ConnectionState.CLOSED || this.options.abortSignal?.aborted || false;\n  }\n\n  private toError(error: unknown): Error {\n    if (error instanceof Error) return error;\n    if (error instanceof ErrorEvent) return error.error;\n    return new Error(String(error));\n  }\n\n  /**\n   * Connection state progresses linearly from NEW to CLOSED and never goes back.\n   * This internal contract dramatically simplifies the internal stream state management.\n   *\n   * If you ever feel the need to make this contract less strict, think twice.\n   */\n  private progressConnectionState(newState: ConnectionState): boolean {\n    if (newState < this.connectionState) {\n      return false;\n    }\n    this.connectionState = newState;\n    return true;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/helpers/retry_strategy.cjs

@@ -0,0 +1,92 @@
+'use strict';
+
+const DEFAULT_RETRY_CONFIG = {
+    maxAttempts: 10,
+    initialDelay: 100,
+    maxDelay: 30000,
+};
+class RetryStrategy {
+    attempts = 0;
+    timer = null;
+    config;
+    callbacks;
+    backoff;
+    constructor(config, callbacks) {
+        this.config = { ...DEFAULT_RETRY_CONFIG, ...config };
+        this.callbacks = callbacks;
+        this.backoff = new ExponentialBackoff({
+            initialDelay: this.config.initialDelay,
+            maxDelay: this.config.maxDelay,
+            factor: 2,
+            jitter: 0.1,
+        });
+    }
+    schedule() {
+        if (this.timer)
+            return;
+        if (this.hasExceededLimit()) {
+            this.notifyMaxAttemptsReached();
+            return;
+        }
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            this.attempts++;
+            this.callbacks.onRetry();
+        }, this.backoff.delay());
+    }
+    cancel() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+    reset() {
+        this.attempts = 0;
+        this.backoff.reset();
+    }
+    hasExceededLimit() {
+        return this.attempts >= this.config.maxAttempts;
+    }
+    notifyMaxAttemptsReached() {
+        const error = new Error(`Max retry attempts (${this.config.maxAttempts}) reached`);
+        this.callbacks.onMaxAttemptsReached(error);
+    }
+}
+class ExponentialBackoff {
+    initialDelay;
+    maxDelay;
+    currentDelay;
+    factor;
+    jitter;
+    constructor(config) {
+        this.initialDelay = config.initialDelay;
+        this.maxDelay = config.maxDelay;
+        this.factor = config.factor;
+        this.jitter = config.jitter;
+        this.currentDelay = config.initialDelay;
+    }
+    delay() {
+        if (this.currentDelay >= this.maxDelay) {
+            return this.applyJitter(this.maxDelay);
+        }
+        this.currentDelay = this.currentDelay * this.factor;
+        if (this.currentDelay > this.maxDelay) {
+            this.currentDelay = this.maxDelay;
+        }
+        return this.applyJitter(this.currentDelay);
+    }
+    reset() {
+        this.currentDelay = this.initialDelay;
+    }
+    applyJitter(delay) {
+        if (delay === 0 || this.jitter === 0) {
+            return delay;
+        }
+        const delayFactor = 1 - (this.jitter / 2) + Math.random() * this.jitter;
+        return delay * delayFactor;
+    }
+}
+
+exports.DEFAULT_RETRY_CONFIG = DEFAULT_RETRY_CONFIG;
+exports.RetryStrategy = RetryStrategy;
+//# sourceMappingURL=retry_strategy.cjs.map

package/dist/helpers/retry_strategy.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry_strategy.cjs","sources":["../../src/helpers/retry_strategy.ts"],"sourcesContent":["export interface RetryConfig {\n  maxAttempts: number;\n  initialDelay: number;\n  maxDelay: number;\n}\n\nexport const DEFAULT_RETRY_CONFIG: RetryConfig = {\n  maxAttempts: 10,\n  initialDelay: 100,\n  maxDelay: 30000,\n};\n\nexport interface RetryCallbacks {\n  onRetry: () => void;\n  onMaxAttemptsReached: (error: Error) => void;\n}\n\nexport class RetryStrategy {\n  private attempts = 0;\n  private timer: ReturnType<typeof setTimeout> | null = null;\n  private readonly config: RetryConfig;\n  private readonly callbacks: RetryCallbacks;\n  private readonly backoff: ExponentialBackoff;\n\n  constructor(config: Partial<RetryConfig>, callbacks: RetryCallbacks) {\n    this.config = { ...DEFAULT_RETRY_CONFIG, ...config };\n    this.callbacks = callbacks;\n    this.backoff = new ExponentialBackoff({\n      initialDelay: this.config.initialDelay,\n      maxDelay: this.config.maxDelay,\n      factor: 2,\n      jitter: 0.1,\n    });\n  }\n\n  schedule(): void {\n    if (this.timer) return;\n    if (this.hasExceededLimit()) {\n      this.notifyMaxAttemptsReached();\n      return;\n    }\n\n    this.timer = setTimeout(() => {\n      this.timer = null;\n      this.attempts++;\n      this.callbacks.onRetry();\n    }, this.backoff.delay());\n  }\n\n  cancel(): void {\n    if (this.timer) {\n      clearTimeout(this.timer);\n      this.timer = null;\n    }\n  }\n\n  reset(): void {\n    this.attempts = 0;\n    this.backoff.reset();\n  }\n\n  private hasExceededLimit(): boolean {\n    return this.attempts >= this.config.maxAttempts;\n  }\n\n  private notifyMaxAttemptsReached(): void {\n    const error = new Error(\n      `Max retry attempts (${this.config.maxAttempts}) reached`,\n    );\n    this.callbacks.onMaxAttemptsReached(error);\n  }\n}\n\ninterface ExponentialBackoffConfig {\n  initialDelay: number;\n  maxDelay: number;\n  factor: number;\n  jitter: number;\n}\n\nclass ExponentialBackoff {\n  private readonly initialDelay: number;\n  private readonly maxDelay: number;\n\n  private currentDelay: number;\n\n  private readonly factor: number;\n  private readonly jitter: number;\n\n  constructor(config: ExponentialBackoffConfig) {\n    this.initialDelay = config.initialDelay;\n    this.maxDelay = config.maxDelay;\n    this.factor = config.factor;\n    this.jitter = config.jitter;\n    this.currentDelay = config.initialDelay;\n  }\n\n  delay(): number {\n    if (this.currentDelay >= this.maxDelay) {\n      return this.applyJitter(this.maxDelay);\n    }\n\n    this.currentDelay = this.currentDelay * this.factor;\n\n    if (this.currentDelay > this.maxDelay) {\n      this.currentDelay = this.maxDelay;\n    }\n\n    return this.applyJitter(this.currentDelay);\n  }\n\n  reset(): void {\n    this.currentDelay = this.initialDelay;\n  }\n\n  private applyJitter(delay: number): number {\n    if (delay === 0 || this.jitter === 0) {\n      return delay;\n    }\n    const delayFactor = 1 - (this.jitter / 2) + Math.random() * this.jitter;\n    return delay * delayFactor;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/helpers/retry_strategy.d.ts

@@ -0,0 +1,24 @@
+export interface RetryConfig {
+    maxAttempts: number;
+    initialDelay: number;
+    maxDelay: number;
+}
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+export interface RetryCallbacks {
+    onRetry: () => void;
+    onMaxAttemptsReached: (error: Error) => void;
+}
+export declare class RetryStrategy {
+    private attempts;
+    private timer;
+    private readonly config;
+    private readonly callbacks;
+    private readonly backoff;
+    constructor(config: Partial<RetryConfig>, callbacks: RetryCallbacks);
+    schedule(): void;
+    cancel(): void;
+    reset(): void;
+    private hasExceededLimit;
+    private notifyMaxAttemptsReached;
+}
+//# sourceMappingURL=retry_strategy.d.ts.map

package/dist/helpers/retry_strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry_strategy.d.ts","sourceRoot":"","sources":["../../src/helpers/retry_strategy.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,oBAAoB,EAAE,WAIlC,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,oBAAoB,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAC9C;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,cAAc;IAWnE,QAAQ,IAAI,IAAI;IAchB,MAAM,IAAI,IAAI;IAOd,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,wBAAwB;CAMjC"}

package/dist/helpers/retry_strategy.js

@@ -0,0 +1,89 @@
+const DEFAULT_RETRY_CONFIG = {
+    maxAttempts: 10,
+    initialDelay: 100,
+    maxDelay: 30000,
+};
+class RetryStrategy {
+    attempts = 0;
+    timer = null;
+    config;
+    callbacks;
+    backoff;
+    constructor(config, callbacks) {
+        this.config = { ...DEFAULT_RETRY_CONFIG, ...config };
+        this.callbacks = callbacks;
+        this.backoff = new ExponentialBackoff({
+            initialDelay: this.config.initialDelay,
+            maxDelay: this.config.maxDelay,
+            factor: 2,
+            jitter: 0.1,
+        });
+    }
+    schedule() {
+        if (this.timer)
+            return;
+        if (this.hasExceededLimit()) {
+            this.notifyMaxAttemptsReached();
+            return;
+        }
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            this.attempts++;
+            this.callbacks.onRetry();
+        }, this.backoff.delay());
+    }
+    cancel() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+    reset() {
+        this.attempts = 0;
+        this.backoff.reset();
+    }
+    hasExceededLimit() {
+        return this.attempts >= this.config.maxAttempts;
+    }
+    notifyMaxAttemptsReached() {
+        const error = new Error(`Max retry attempts (${this.config.maxAttempts}) reached`);
+        this.callbacks.onMaxAttemptsReached(error);
+    }
+}
+class ExponentialBackoff {
+    initialDelay;
+    maxDelay;
+    currentDelay;
+    factor;
+    jitter;
+    constructor(config) {
+        this.initialDelay = config.initialDelay;
+        this.maxDelay = config.maxDelay;
+        this.factor = config.factor;
+        this.jitter = config.jitter;
+        this.currentDelay = config.initialDelay;
+    }
+    delay() {
+        if (this.currentDelay >= this.maxDelay) {
+            return this.applyJitter(this.maxDelay);
+        }
+        this.currentDelay = this.currentDelay * this.factor;
+        if (this.currentDelay > this.maxDelay) {
+            this.currentDelay = this.maxDelay;
+        }
+        return this.applyJitter(this.currentDelay);
+    }
+    reset() {
+        this.currentDelay = this.initialDelay;
+    }
+    applyJitter(delay) {
+        if (delay === 0 || this.jitter === 0) {
+            return delay;
+        }
+        const delayFactor = 1 - (this.jitter / 2) + Math.random() * this.jitter;
+        return delay * delayFactor;
+    }
+}
+
+export { DEFAULT_RETRY_CONFIG, RetryStrategy };
+//# sourceMappingURL=retry_strategy.js.map

package/dist/helpers/retry_strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry_strategy.js","sources":["../../src/helpers/retry_strategy.ts"],"sourcesContent":["export interface RetryConfig {\n  maxAttempts: number;\n  initialDelay: number;\n  maxDelay: number;\n}\n\nexport const DEFAULT_RETRY_CONFIG: RetryConfig = {\n  maxAttempts: 10,\n  initialDelay: 100,\n  maxDelay: 30000,\n};\n\nexport interface RetryCallbacks {\n  onRetry: () => void;\n  onMaxAttemptsReached: (error: Error) => void;\n}\n\nexport class RetryStrategy {\n  private attempts = 0;\n  private timer: ReturnType<typeof setTimeout> | null = null;\n  private readonly config: RetryConfig;\n  private readonly callbacks: RetryCallbacks;\n  private readonly backoff: ExponentialBackoff;\n\n  constructor(config: Partial<RetryConfig>, callbacks: RetryCallbacks) {\n    this.config = { ...DEFAULT_RETRY_CONFIG, ...config };\n    this.callbacks = callbacks;\n    this.backoff = new ExponentialBackoff({\n      initialDelay: this.config.initialDelay,\n      maxDelay: this.config.maxDelay,\n      factor: 2,\n      jitter: 0.1,\n    });\n  }\n\n  schedule(): void {\n    if (this.timer) return;\n    if (this.hasExceededLimit()) {\n      this.notifyMaxAttemptsReached();\n      return;\n    }\n\n    this.timer = setTimeout(() => {\n      this.timer = null;\n      this.attempts++;\n      this.callbacks.onRetry();\n    }, this.backoff.delay());\n  }\n\n  cancel(): void {\n    if (this.timer) {\n      clearTimeout(this.timer);\n      this.timer = null;\n    }\n  }\n\n  reset(): void {\n    this.attempts = 0;\n    this.backoff.reset();\n  }\n\n  private hasExceededLimit(): boolean {\n    return this.attempts >= this.config.maxAttempts;\n  }\n\n  private notifyMaxAttemptsReached(): void {\n    const error = new Error(\n      `Max retry attempts (${this.config.maxAttempts}) reached`,\n    );\n    this.callbacks.onMaxAttemptsReached(error);\n  }\n}\n\ninterface ExponentialBackoffConfig {\n  initialDelay: number;\n  maxDelay: number;\n  factor: number;\n  jitter: number;\n}\n\nclass ExponentialBackoff {\n  private readonly initialDelay: number;\n  private readonly maxDelay: number;\n\n  private currentDelay: number;\n\n  private readonly factor: number;\n  private readonly jitter: number;\n\n  constructor(config: ExponentialBackoffConfig) {\n    this.initialDelay = config.initialDelay;\n    this.maxDelay = config.maxDelay;\n    this.factor = config.factor;\n    this.jitter = config.jitter;\n    this.currentDelay = config.initialDelay;\n  }\n\n  delay(): number {\n    if (this.currentDelay >= this.maxDelay) {\n      return this.applyJitter(this.maxDelay);\n    }\n\n    this.currentDelay = this.currentDelay * this.factor;\n\n    if (this.currentDelay > this.maxDelay) {\n      this.currentDelay = this.maxDelay;\n    }\n\n    return this.applyJitter(this.currentDelay);\n  }\n\n  reset(): void {\n    this.currentDelay = this.initialDelay;\n  }\n\n  private applyJitter(delay: number): number {\n    if (delay === 0 || this.jitter === 0) {\n      return delay;\n    }\n    const delayFactor = 1 - (this.jitter / 2) + Math.random() * this.jitter;\n    return delay * delayFactor;\n  }\n}\n"],"names":[],"mappings":"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"}