@hardlydifficult/throttle 3.0.4 → 3.0.6

package/dist/index.d.ts

@@ -3,4 +3,5 @@ export { getBackoffDelay, sleep, getRandomDelay, type BackoffOptions, } from "./
 export { isConnectionError } from "./isConnectionError";
 export { createThrottledUpdater, type ThrottledUpdater, } from "./ThrottledUpdater";
 export { eventRequest, type EventSubscriber, type EventRequestOptions, } from "./eventRequest";
+export { retry, type RetryOptions } from "./retry";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,KAAK,EACL,cAAc,EACd,KAAK,cAAc,GACpB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EACL,sBAAsB,EACtB,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,YAAY,EACZ,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,KAAK,EACL,cAAc,EACd,KAAK,cAAc,GACpB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EACL,sBAAsB,EACtB,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,YAAY,EACZ,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.eventRequest = exports.createThrottledUpdater = exports.isConnectionError = exports.getRandomDelay = exports.sleep = exports.getBackoffDelay = exports.Throttle = void 0;
+exports.retry = exports.eventRequest = exports.createThrottledUpdater = exports.isConnectionError = exports.getRandomDelay = exports.sleep = exports.getBackoffDelay = exports.Throttle = void 0;
 var Throttle_1 = require("./Throttle");
 Object.defineProperty(exports, "Throttle", { enumerable: true, get: function () { return Throttle_1.Throttle; } });
 var backoff_1 = require("./backoff");
@@ -13,4 +13,6 @@ var ThrottledUpdater_1 = require("./ThrottledUpdater");
 Object.defineProperty(exports, "createThrottledUpdater", { enumerable: true, get: function () { return ThrottledUpdater_1.createThrottledUpdater; } });
 var eventRequest_1 = require("./eventRequest");
 Object.defineProperty(exports, "eventRequest", { enumerable: true, get: function () { return eventRequest_1.eventRequest; } });
+var retry_1 = require("./retry");
+Object.defineProperty(exports, "retry", { enumerable: true, get: function () { return retry_1.retry; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uCAIoB;AAHlB,oGAAA,QAAQ,OAAA;AAKV,qCAKmB;AAJjB,0GAAA,eAAe,OAAA;AACf,gGAAA,KAAK,OAAA;AACL,yGAAA,cAAc,OAAA;AAIhB,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAE1B,uDAG4B;AAF1B,0HAAA,sBAAsB,OAAA;AAIxB,+CAIwB;AAHtB,4GAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uCAIoB;AAHlB,oGAAA,QAAQ,OAAA;AAKV,qCAKmB;AAJjB,0GAAA,eAAe,OAAA;AACf,gGAAA,KAAK,OAAA;AACL,yGAAA,cAAc,OAAA;AAIhB,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAE1B,uDAG4B;AAF1B,0HAAA,sBAAsB,OAAA;AAIxB,+CAIwB;AAHtB,4GAAA,YAAY,OAAA;AAKd,iCAAmD;AAA1C,8FAAA,KAAK,OAAA"}

package/dist/retry.d.ts

@@ -0,0 +1,14 @@
+export interface RetryOptions {
+    /** Maximum number of attempts (must be >= 1) */
+    maxAttempts: number;
+    /** Called before each retry with the error and 1-based attempt number that failed */
+    onRetry?: (error: Error, attempt: number) => void;
+}
+/**
+ * Retry an async function up to `maxAttempts` times.
+ * Returns the first successful result or throws the last error.
+ *
+ * No built-in delay — callers can `await sleep()` inside `onRetry` for backoff.
+ */
+export declare function retry<T>(fn: () => Promise<T>, options: RetryOptions): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD;AAED;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,CAAC,CAAC,CAaZ"}

package/dist/retry.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retry = retry;
+/**
+ * Retry an async function up to `maxAttempts` times.
+ * Returns the first successful result or throws the last error.
+ *
+ * No built-in delay — callers can `await sleep()` inside `onRetry` for backoff.
+ */
+async function retry(fn, options) {
+    let lastError;
+    for (let attempt = 1; attempt <= options.maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (attempt < options.maxAttempts) {
+                options.onRetry?.(lastError, attempt);
+            }
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":";;AAaA,sBAgBC;AAtBD;;;;;GAKG;AACI,KAAK,UAAU,KAAK,CACzB,EAAoB,EACpB,OAAqB;IAErB,IAAI,SAAiB,CAAC;IACtB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QAChE,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACtE,IAAI,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;gBAClC,OAAO,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;IACH,CAAC;IACD,MAAM,SAAS,CAAC;AAClB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hardlydifficult/throttle",
-  "version": "3.0.4",
+  "version": "3.0.6",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [