feat: add retry function and @retry decorator #73

Activity

1. tabkram commented on Aug 12, 2026

   

   tabkram

   on Aug 12, 2026 – with ChatGPT Codex Connector

   OwnerAuthor

   More actions

   Proposed TypeScript configuration

   export interface RetryOptions<Result = unknown> {
     /** Total number of executions, including the first one. Defaults to 3. */
     attempts?: number;
     /** Delay strategy between attempts. Defaults to exponential backoff. */
     backoff?: RetryBackoff;
     /** Cap for an exponential or custom backoff, in milliseconds. */
     maxDelay?: number;
     /** Randomise delays to avoid retry storms. Defaults to false. */
     jitter?: boolean;
     /** Return true when the error or result should be retried. */
     shouldRetry?: (context: RetryContext<Result>) => boolean | Promise<boolean>;
     /** Runs before the delay preceding a new attempt. */
     onRetry?: (context: RetryContext<Result>) => void | Promise<void>;
   }
   
   export type RetryBackoff =
     | number
     | 'fixed'
     | 'exponential'
     | ((context: RetryContext) => number);
   
   export interface RetryContext<Result = unknown> {
     attempt: number;
     error?: unknown;
     result?: Result;
     delay: number;
   }

   Cancellation should be supplied per call through an AbortSignal, so one caller can cancel without changing a shared retry policy.