postchain-client 2.0.4 → 2.1.0

package/changelog.md

@@ -1,4 +1,4 @@
-Version 2.0.4
+Version 2.1.0
 
 # Changelog
 
@@ -11,11 +11,41 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Fixed
 
+- browser network errors now default to 502 status code for consistent timeout logic
+- failover loop logic by replacing 'continue' with 'break' to prevent infinite loops
+
+### Added
+
+- **Universal Node Recovery**: All failover strategies (AbortOnError, TryNextOnError, SingleEndpoint) now automatically recover when available nodes drop below threshold (previously only QueryMajority had recovery)
+- **Smart Error-Specific Timeouts**: Replaced fixed 5-second timeouts with intelligent, error-specific durations:
+  - DNS failures (ENOTFOUND): 5 minutes
+  - Connection refused (ECONNREFUSED): 5 minutes
+  - 500 errors: 10 seconds (server restart)
+  - 502 errors: 30 seconds (gateway issues)
+  - 503 errors: 2 seconds (load balancer)
+  - 504 errors: 60 seconds (upstream timeout)
+- **Enhanced Client Error Handling**: Added detection for non-retriable client errors (e.g., "Unknown query:") to prevent wasteful retries across nodes
+- Optional `recoveryThreshold` parameter in `ClientConfig` and `FailOverConfig` types to customize auto-recovery behavior
+- Network error detection utilities in `http-utils.ts` for better error classification
+- Comprehensive test coverage for universal recovery logic, smart timeouts, and network error scenarios
+
+### Changed
+
+- **Node Recovery Logic**: Universal auto-recovery using 2x BFT formula (nodes - floor(2*(nodes-1)/3)) as default threshold for all strategies with 3+ nodes
+- **Error Handling**: Centralized and simplified error classification logic across all failover strategies
+- **Sticky Node Behavior**: Enhanced sticky node preservation during recovery and improved error handling
+- **TryNextOnError Strategy**: Now avoids retrying non-retriable client errors for better efficiency
+- Node availability management with `NetworkNode` class providing better state management
+- Improved error propagation and handling in `retryRequest()` function
+
+### Fixed
+
 - importing Buffer to ensure seamless functionality in web browsers
 
 ### Added
 
 - possibility to work with postchain-client in web browsers through cdn
+- migrated npm to pnpm
 
 ### Changed
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postchain-client",
-  "version": "2.0.4",
+  "version": "2.1.0",
   "main": "built/cjs/index.js",
   "browser": "built/esm/index.js",
   "types": "built/index.d.ts",
@@ -35,10 +35,10 @@
     "test:integration:coverage": "jest test/integration/**/*.test.ts' --coverage",
     "test:chromiaNetwork:coverage": "jest test/integrationChromiaNetwork/**/*.test.ts --coverage",
     "setup:chromiaNetwork": "bash scripts/setup-chromia-network-and-deploy-dapps.sh",
-    "build": "npm run clean && tsc && rollup -c rollup.config.mjs && echo '{\"type\": \"module\"}' > built/esm/package.json",
+    "build": "pnpm run clean && tsc && rollup -c rollup.config.mjs && echo '{\"type\": \"module\"}' > built/esm/package.json",
     "clean": "rimraf built",
-    "prepack": "npm run build",
-    "publish": "npm run prepack && npm publish --access public",
+    "prepack": "pnpm run build",
+    "publish": "pnpm run prepack && pnpm publish --access public",
     "prepare": "husky install",
     "lint": "eslint . --ext .ts --fix",
     "format": "prettier --write ."
@@ -57,13 +57,15 @@
     "axios": "^1.9.0",
     "crypto-browserify": "^3.12.0",
     "lodash": "^4.17.21",
+    "merklehashts": "^1.0.5",
     "secp256k1": "^4.0.4",
     "stream-browserify": "^3.0.0",
     "uuid": "^11.1.0",
-    "zod": "^3.22.4",
-    "merklehashts": "^1.0.5"
+    "zod": "^3.22.4"
   },
   "devDependencies": {
+    "@babel/core": "^7.28.5",
+    "@babel/preset-env": "^7.28.5",
     "@rollup/plugin-alias": "^4.0.3",
     "@rollup/plugin-commonjs": "^24.0.1",
     "@rollup/plugin-inject": "^5.0.3",
@@ -79,7 +81,7 @@
     "@types/secp256k1": "^4.0.3",
     "@typescript-eslint/eslint-plugin": "^5.46.0",
     "@typescript-eslint/parser": "^5.46.0",
-    "babel-preset-es2015": "^6.24.1",
+    "babel-jest": "^30.2.0",
     "body-parser": "^1.17.1",
     "dotenv": "^16.4.7",
     "eslint": "^8.29.0",
@@ -100,5 +102,6 @@
   "peerDependencies": {
     "buffer": "^5.x || ^6.x",
     "events": "^3.3.0"
-  }
+  },
+  "packageManager": "pnpm@10.22.0+sha512.bf049efe995b28f527fd2b41ae0474ce29186f7edcb3bf545087bd61fbbebb2bf75362d1307fda09c2d288e1e499787ac12d4fcb617a974718a6051f2eee741c"
 }