@idoa/utils 0.1.0

package/README.md

@@ -0,0 +1,9 @@
+# @idoa/utils
+
+Chain-agnostic helpers for retry/backoff, timeout boundaries, and small utility guards.
+
+## Usage
+
+```ts
+import { retryWithBackoff, withTimeout } from '@idoa/utils';
+```

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export interface RetryOptions {
+    retries: number;
+    retryDelayMs: number;
+    maxRetryDelayMs: number;
+    shouldRetry?: (error: unknown, attempt: number) => boolean;
+}
+export declare function retryWithBackoff<T>(operation: () => Promise<T>, options: RetryOptions): Promise<T>;
+export declare function withTimeout<T>(operation: Promise<T>, timeoutMs: number, label?: string): Promise<T>;
+export declare function toError(error: unknown): Error;
+export declare function sleep(ms: number): Promise<void>;
+//# 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,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5D;AAED,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,CAAC,CAAC,CAwBZ;AAED,wBAAsB,WAAW,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,SAAc,cAoBjG;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAM7C;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/index.js

@@ -0,0 +1,53 @@
+// src/index.ts
+async function retryWithBackoff(operation, options) {
+  let attempt = 0;
+  let lastError;
+  while (attempt <= options.retries) {
+    try {
+      return await operation();
+    } catch (error) {
+      lastError = error;
+      const canRetry = attempt < options.retries && (options.shouldRetry ? options.shouldRetry(error, attempt + 1) : true);
+      if (!canRetry) {
+        break;
+      }
+      const waitMs = Math.min(options.retryDelayMs * 2 ** attempt, options.maxRetryDelayMs);
+      await sleep(waitMs);
+      attempt += 1;
+    }
+  }
+  throw lastError instanceof Error ? lastError : new Error("Retry operation failed");
+}
+async function withTimeout(operation, timeoutMs, label = "operation") {
+  if (timeoutMs <= 0) {
+    throw new Error("timeoutMs must be greater than 0");
+  }
+  let timer;
+  const timeoutPromise = new Promise((_, reject) => {
+    timer = setTimeout(() => {
+      reject(new Error(`${label} timed out after ${timeoutMs}ms`));
+    }, timeoutMs);
+  });
+  try {
+    return await Promise.race([operation, timeoutPromise]);
+  } finally {
+    if (timer) {
+      clearTimeout(timer);
+    }
+  }
+}
+function toError(error) {
+  if (error instanceof Error) {
+    return error;
+  }
+  return new Error(typeof error === "string" ? error : "Unknown error");
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export {
+  retryWithBackoff,
+  sleep,
+  toError,
+  withTimeout
+};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@idoa/utils",
+  "version": "0.1.0",
+  "description": "Utility helpers for retry, timeout, and defensive runtime handling.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Mateja3m/chain-dev-doctor-core.git",
+    "directory": "packages/utils"
+  },
+  "bugs": {
+    "url": "https://github.com/Mateja3m/chain-dev-doctor-core/issues"
+  },
+  "homepage": "https://github.com/Mateja3m/chain-dev-doctor-core/tree/main/packages/utils#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "keywords": [
+    "idoa",
+    "utils",
+    "retry",
+    "timeout",
+    "web3"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --clean && tsc -p tsconfig.build.json",
+    "clean": "rm -rf dist",
+    "lint": "eslint src test --ext .ts",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}