chore(release): 1.5.0

# [1.5.0](v1.4.1...v1.5.0) (2022-04-28)

### Features

* add retryWithBackoff utility ([#22](#22)) ([82c596a](82c596a))

CHANGELOG.md

@@ -1,3 +1,10 @@
+# [1.5.0](https://github.com/jaredLunde/exploration/compare/v1.4.1...v1.5.0) (2022-04-28)
+
+
+### Features
+
+* add retryWithBackoff utility ([#22](https://github.com/jaredLunde/exploration/issues/22)) ([82c596a](https://github.com/jaredLunde/exploration/commit/82c596a83678f708bdab86b89dff2ab84194661c))
+
 ## [1.4.1](https://github.com/jaredLunde/exploration/compare/v1.4.0...v1.4.1) (2022-04-26)
 
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "exploration",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "description": "",
   "license": "MIT",
   "author": "Jared Lunde <jared.lunde@gmail.com> (https://jaredlunde.com/)",

types/index.d.ts

@@ -23,4 +23,4 @@ export type { SelectionsProps, UseSelectionsPlugin } from "./use-selections";
 export { useVirtualize } from "./use-virtualize";
 export type { UseVirtualizeConfig, UseVirtualizeResult, } from "./use-virtualize";
 export { useVisibleNodes } from "./use-visible-nodes";
-export { mergeProps } from "./utils";
+export { mergeProps, retryWithBackoff } from "./utils";

types/utils.d.ts

@@ -15,6 +15,43 @@ export declare function mergeProps<T extends Props[]>(args: T): UnionToIntersect
 export declare function chain<Args extends any[]>(...callbacks: Args): (...args: Args) => void;
 export declare function throttle<CallbackArguments extends any[]>(callback: (...args: CallbackArguments) => void, fps?: number, leading?: boolean): (...args: CallbackArguments) => void;
 export declare function shallowEqual<A extends Record<string | number | symbol, unknown> | null, B extends Record<string | number | symbol, unknown> | null>(objA: A, objB: B | A): boolean;
+/**
+ * Retry a promise until it resolves or the max number of retries is reached.
+ *
+ * @param promiseFn - A function that returns a promise to retry
+ * @param config - Options
+ * @param config.maxRetries - Max number of retries
+ * @param config.initialDelay - Initial delay before first retry
+ * @param config.delayMultiple - Multiplier for each subsequent retry
+ * @param config.shouldRetry - A function that should return `false` to stop retrying
+ */
+export declare function retryWithBackoff<T>(promiseFn: () => Promise<T>, config?: RetryWithBackoffConfig): Promise<T>;
+export interface RetryWithBackoffConfig {
+    /**
+     * Max number of retries
+     *
+     * @default 4
+     */
+    maxRetries?: number;
+    /**
+     * Initial delay before first retry
+     *
+     * @default 100
+     */
+    initialDelay?: number;
+    /**
+     * Multiplier for each subsequent retry
+     *
+     * @default 2
+     */
+    delayMultiple?: number;
+    /**
+     * A function that should return `false` to stop retrying
+     *
+     * @param error - The error that caused the retry
+     */
+    shouldRetry?: (error: unknown) => boolean;
+}
 interface Props {
     [key: string]: any;
 }