@unicitylabs/sphere-sdk 0.10.6 → 0.10.7

package/dist/impl/nodejs/index.d.cts

@@ -2143,9 +2143,17 @@ declare class WalletApiClient {
     private rawFetch;
     private readJson;
     private toError;
+    /**
+     * GET-only retry on a transient NETWORK failure (a dropped/reset connection — e.g. a backend under
+     * load resetting mid-read). GETs are idempotent, so re-issuing is safe; non-GET methods are NEVER
+     * retried here because a lost-response retry could double-apply a write. Non-NETWORK outcomes (any
+     * HTTP status) come back as a response and are handled by the caller. Bounded exponential backoff.
+     */
+    private rawFetchWithReadRetry;
     /**
      * Authenticated JSON request. A 401 triggers one silent re-auth
-     * (refresh → challenge fallback) and one retry.
+     * (refresh → challenge fallback) and one retry; idempotent GETs additionally retry a transient
+     * NETWORK failure (rawFetchWithReadRetry) so a single dropped connection doesn't fail the call.
      */
     private requestJson;
     /** `GET /v1/inventory?since=` — one page; the caller loops while `more`. */

package/dist/impl/nodejs/index.d.ts

@@ -2143,9 +2143,17 @@ declare class WalletApiClient {
     private rawFetch;
     private readJson;
     private toError;
+    /**
+     * GET-only retry on a transient NETWORK failure (a dropped/reset connection — e.g. a backend under
+     * load resetting mid-read). GETs are idempotent, so re-issuing is safe; non-GET methods are NEVER
+     * retried here because a lost-response retry could double-apply a write. Non-NETWORK outcomes (any
+     * HTTP status) come back as a response and are handled by the caller. Bounded exponential backoff.
+     */
+    private rawFetchWithReadRetry;
     /**
      * Authenticated JSON request. A 401 triggers one silent re-auth
-     * (refresh → challenge fallback) and one retry.
+     * (refresh → challenge fallback) and one retry; idempotent GETs additionally retry a transient
+     * NETWORK failure (rawFetchWithReadRetry) so a single dropped connection doesn't fail the call.
      */
     private requestJson;
     /** `GET /v1/inventory?since=` — one page; the caller loops while `more`. */

package/dist/impl/nodejs/index.js

@@ -27683,6 +27683,8 @@ function defaultWebSocketFactory(url) {
   }
   return new Ctor(url);
 }
+var GET_RETRY_ATTEMPTS = 3;
+var GET_RETRY_BASE_MS = 200;
 var WalletApiClient = class _WalletApiClient {
   /** Network name (also the blob-key prefix `<network>/t/<sha256>` — §5.2). */
   network;
@@ -27876,17 +27878,36 @@ var WalletApiClient = class _WalletApiClient {
     }
     return WalletApiError.fromStatus(res.status, message);
   }
+  /**
+   * GET-only retry on a transient NETWORK failure (a dropped/reset connection — e.g. a backend under
+   * load resetting mid-read). GETs are idempotent, so re-issuing is safe; non-GET methods are NEVER
+   * retried here because a lost-response retry could double-apply a write. Non-NETWORK outcomes (any
+   * HTTP status) come back as a response and are handled by the caller. Bounded exponential backoff.
+   */
+  async rawFetchWithReadRetry(method, path3, body, jwt) {
+    const attempts = method === "GET" ? GET_RETRY_ATTEMPTS : 1;
+    for (let attempt = 1; ; attempt += 1) {
+      try {
+        return await this.rawFetch(method, path3, body, jwt);
+      } catch (err) {
+        const transient = err instanceof WalletApiError && err.code === "NETWORK";
+        if (!transient || attempt >= attempts) throw err;
+        await new Promise((resolve) => setTimeout(resolve, GET_RETRY_BASE_MS * 2 ** (attempt - 1)));
+      }
+    }
+  }
   /**
    * Authenticated JSON request. A 401 triggers one silent re-auth
-   * (refresh → challenge fallback) and one retry.
+   * (refresh → challenge fallback) and one retry; idempotent GETs additionally retry a transient
+   * NETWORK failure (rawFetchWithReadRetry) so a single dropped connection doesn't fail the call.
    */
   async requestJson(method, path3, body) {
     if (!this.jwt) await this.signIn();
-    let res = await this.rawFetch(method, path3, body, this.jwt);
+    let res = await this.rawFetchWithReadRetry(method, path3, body, this.jwt);
     if (res.status === 401) {
       this.jwt = null;
       await this.signIn();
-      res = await this.rawFetch(method, path3, body, this.jwt);
+      res = await this.rawFetchWithReadRetry(method, path3, body, this.jwt);
     }
     if (res.status === 204) return null;
     if (!res.ok) throw await this.toError(res, `${method} ${path3}`);