@xavierchow/retry 1.0.4

package/README.md

@@ -0,0 +1,33 @@
+# Retry
+
+This is a tiny library to handle the retry mechanism, it provides
+
+- max attempts, setting to 1 means `do it once and retry it once`
+- criteria control for retry or not
+- back off for a certain delay
+
+
+# Install
+
+T.B.D
+
+
+
+# Development
+
+## Install Dependence
+``` sh
+pnpm install
+```
+
+## Build
+
+``` sh
+pnpm build
+```
+
+## Test
+
+``` sh
+pnpm test
+```

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+type RetryConfig = {
+    maxAttempts: number;
+    delayInMs?: number;
+    shouldRetry?: (err: unknown) => boolean;
+    mode?: "linear" | "exp";
+};
+export declare function withRetry(config: RetryConfig, fn: () => Promise<unknown> | unknown): Promise<unknown>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,KAAK,WAAW,GAAG;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;IACxC,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;CACzB,CAAC;AACF,wBAAsB,SAAS,CAC7B,MAAM,EAAE,WAAW,EACnB,EAAE,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,oBAsBrC"}

package/dist/index.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withRetry = withRetry;
+async function withRetry(config, fn) {
+    const shouldRetry = config.shouldRetry || (() => true);
+    let attempts = 0;
+    const exec = async () => {
+        try {
+            attempts++;
+            const r = await fn();
+            return r;
+        }
+        catch (err) {
+            const toBeRetried = shouldRetry(err);
+            if (toBeRetried && attempts <= config.maxAttempts) {
+                const timeout = computeTimeout(config, attempts);
+                await new Promise((resolve) => setTimeout(resolve, timeout));
+                return exec();
+            }
+            else {
+                throw err;
+            }
+        }
+    };
+    return exec();
+}
+function computeTimeout(config, attempts) {
+    config.delayInMs = config.delayInMs || 1000;
+    const factor = 2;
+    if (config.mode && config.mode === "exp") {
+        const timeout = config.delayInMs * Math.pow(factor, attempts);
+        return timeout;
+    }
+    else {
+        return config.delayInMs;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAMA,8BAwBC;AAxBM,KAAK,UAAU,SAAS,CAC7B,MAAmB,EACnB,EAAoC;IAEpC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;QACtB,IAAI,CAAC;YACH,QAAQ,EAAE,CAAC;YACX,MAAM,CAAC,GAAG,MAAM,EAAE,EAAE,CAAC;YACrB,OAAO,CAAC,CAAC;QACX,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,WAAW,IAAI,QAAQ,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBAClD,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACjD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC7D,OAAO,IAAI,EAAE,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,OAAO,IAAI,EAAE,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,MAAmB,EAAE,QAAgB;IAC3D,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC;IAC5C,MAAM,MAAM,GAAG,CAAC,CAAC;IACjB,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC9D,OAAO,OAAO,CAAC;IACjB,CAAC;SAAM,CAAC;QACN,OAAO,MAAM,CAAC,SAAS,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@xavierchow/retry",
+  "version": "1.0.4",
+  "description": "",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "prebuild": "rimraf dist",
+    "build": "tsc",
+    "test": "jest",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\""
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.0.3",
+    "jest": "^30.2.0",
+    "prettier": "3.7.4",
+    "rimraf": "^6.1.2",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.9.3"
+  }
+}