@cimplify/sdk 0.3.1 → 0.3.2

package/dist/index.d.mts

@@ -2824,6 +2824,12 @@ declare class LiteService {
 interface CimplifyConfig {
     publicKey?: string;
     credentials?: RequestCredentials;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Maximum retry attempts for retryable errors (default: 3) */
+    maxRetries?: number;
+    /** Base delay between retries in milliseconds (default: 1000) */
+    retryDelay?: number;
 }
 declare class CimplifyClient {
     private baseUrl;
@@ -2831,6 +2837,9 @@ declare class CimplifyClient {
     private publicKey;
     private credentials;
     private sessionToken;
+    private timeout;
+    private maxRetries;
+    private retryDelay;
     private _catalogue?;
     private _cart?;
     private _checkout?;
@@ -2849,6 +2858,11 @@ declare class CimplifyClient {
     private saveSessionToken;
     private getHeaders;
     private updateSessionFromResponse;
+    /**
+     * Resilient fetch with timeout and automatic retries for network errors.
+     * Uses exponential backoff: 1s, 2s, 4s between retries.
+     */
+    private resilientFetch;
     query<T = unknown>(query: string, variables?: Record<string, unknown>): Promise<T>;
     call<T = unknown>(method: string, args?: unknown): Promise<T>;
     get<T = unknown>(path: string): Promise<T>;

package/dist/index.d.ts

@@ -2824,6 +2824,12 @@ declare class LiteService {
 interface CimplifyConfig {
     publicKey?: string;
     credentials?: RequestCredentials;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Maximum retry attempts for retryable errors (default: 3) */
+    maxRetries?: number;
+    /** Base delay between retries in milliseconds (default: 1000) */
+    retryDelay?: number;
 }
 declare class CimplifyClient {
     private baseUrl;
@@ -2831,6 +2837,9 @@ declare class CimplifyClient {
     private publicKey;
     private credentials;
     private sessionToken;
+    private timeout;
+    private maxRetries;
+    private retryDelay;
     private _catalogue?;
     private _cart?;
     private _checkout?;
@@ -2849,6 +2858,11 @@ declare class CimplifyClient {
     private saveSessionToken;
     private getHeaders;
     private updateSessionFromResponse;
+    /**
+     * Resilient fetch with timeout and automatic retries for network errors.
+     * Uses exponential backoff: 1s, 2s, 4s between retries.
+     */
+    private resilientFetch;
     query<T = unknown>(query: string, variables?: Record<string, unknown>): Promise<T>;
     call<T = unknown>(method: string, args?: unknown): Promise<T>;
     get<T = unknown>(path: string): Promise<T>;

package/dist/index.js

@@ -1391,6 +1391,51 @@ var LiteService = class {
 // src/client.ts
 var SESSION_TOKEN_HEADER = "x-session-token";
 var SESSION_STORAGE_KEY = "cimplify_session_token";
+var DEFAULT_TIMEOUT_MS = 3e4;
+var DEFAULT_MAX_RETRIES = 3;
+var DEFAULT_RETRY_DELAY_MS = 1e3;
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function isRetryable(error) {
+  if (error instanceof TypeError && error.message.includes("fetch")) {
+    return true;
+  }
+  if (error instanceof DOMException && error.name === "AbortError") {
+    return true;
+  }
+  if (error instanceof CimplifyError) {
+    return error.retryable;
+  }
+  if (error instanceof CimplifyError && error.code === "SERVER_ERROR") {
+    return true;
+  }
+  return false;
+}
+function toNetworkError(error) {
+  if (error instanceof DOMException && error.name === "AbortError") {
+    return new CimplifyError(
+      ErrorCode.TIMEOUT,
+      "Request timed out. Please check your connection and try again.",
+      true
+    );
+  }
+  if (error instanceof TypeError && error.message.includes("fetch")) {
+    return new CimplifyError(
+      ErrorCode.NETWORK_ERROR,
+      "Network error. Please check your internet connection.",
+      true
+    );
+  }
+  if (error instanceof CimplifyError) {
+    return error;
+  }
+  return new CimplifyError(
+    ErrorCode.UNKNOWN_ERROR,
+    error instanceof Error ? error.message : "An unknown error occurred",
+    false
+  );
+}
 function deriveUrls() {
   const hostname = typeof window !== "undefined" ? window.location.hostname : "";
   if (hostname === "localhost" || hostname === "127.0.0.1") {
@@ -1413,6 +1458,9 @@ var CimplifyClient = class {
     this.baseUrl = urls.baseUrl;
     this.linkApiUrl = urls.linkApiUrl;
     this.credentials = config.credentials || "include";
+    this.timeout = config.timeout ?? DEFAULT_TIMEOUT_MS;
+    this.maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
+    this.retryDelay = config.retryDelay ?? DEFAULT_RETRY_DELAY_MS;
     this.sessionToken = this.loadSessionToken();
   }
   getSessionToken() {
@@ -1458,12 +1506,47 @@ var CimplifyClient = class {
       this.saveSessionToken(newToken);
     }
   }
+  /**
+   * Resilient fetch with timeout and automatic retries for network errors.
+   * Uses exponential backoff: 1s, 2s, 4s between retries.
+   */
+  async resilientFetch(url, options) {
+    let lastError;
+    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        const response = await fetch(url, {
+          ...options,
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        if (response.ok || response.status >= 400 && response.status < 500) {
+          return response;
+        }
+        if (response.status >= 500 && attempt < this.maxRetries) {
+          const delay = this.retryDelay * Math.pow(2, attempt);
+          await sleep(delay);
+          continue;
+        }
+        return response;
+      } catch (error) {
+        lastError = error;
+        if (!isRetryable(error) || attempt >= this.maxRetries) {
+          throw toNetworkError(error);
+        }
+        const delay = this.retryDelay * Math.pow(2, attempt);
+        await sleep(delay);
+      }
+    }
+    throw toNetworkError(lastError);
+  }
   async query(query2, variables) {
     const body = { query: query2 };
     if (variables) {
       body.variables = variables;
     }
-    const response = await fetch(`${this.baseUrl}/api/q`, {
+    const response = await this.resilientFetch(`${this.baseUrl}/api/q`, {
       method: "POST",
       credentials: this.credentials,
       headers: this.getHeaders(),
@@ -1477,7 +1560,7 @@ var CimplifyClient = class {
       method,
       args: args !== void 0 ? [args] : []
     };
-    const response = await fetch(`${this.baseUrl}/api/m`, {
+    const response = await this.resilientFetch(`${this.baseUrl}/api/m`, {
       method: "POST",
       credentials: this.credentials,
       headers: this.getHeaders(),
@@ -1487,7 +1570,7 @@ var CimplifyClient = class {
     return this.handleResponse(response);
   }
   async get(path) {
-    const response = await fetch(`${this.baseUrl}${path}`, {
+    const response = await this.resilientFetch(`${this.baseUrl}${path}`, {
       method: "GET",
       credentials: this.credentials,
       headers: this.getHeaders()
@@ -1496,7 +1579,7 @@ var CimplifyClient = class {
     return this.handleRestResponse(response);
   }
   async post(path, body) {
-    const response = await fetch(`${this.baseUrl}${path}`, {
+    const response = await this.resilientFetch(`${this.baseUrl}${path}`, {
       method: "POST",
       credentials: this.credentials,
       headers: this.getHeaders(),
@@ -1506,7 +1589,7 @@ var CimplifyClient = class {
     return this.handleRestResponse(response);
   }
   async delete(path) {
-    const response = await fetch(`${this.baseUrl}${path}`, {
+    const response = await this.resilientFetch(`${this.baseUrl}${path}`, {
       method: "DELETE",
       credentials: this.credentials,
       headers: this.getHeaders()
@@ -1515,7 +1598,7 @@ var CimplifyClient = class {
     return this.handleRestResponse(response);
   }
   async linkGet(path) {
-    const response = await fetch(`${this.linkApiUrl}${path}`, {
+    const response = await this.resilientFetch(`${this.linkApiUrl}${path}`, {
       method: "GET",
       credentials: this.credentials,
       headers: this.getHeaders()
@@ -1524,7 +1607,7 @@ var CimplifyClient = class {
     return this.handleRestResponse(response);
   }
   async linkPost(path, body) {
-    const response = await fetch(`${this.linkApiUrl}${path}`, {
+    const response = await this.resilientFetch(`${this.linkApiUrl}${path}`, {
       method: "POST",
       credentials: this.credentials,
       headers: this.getHeaders(),
@@ -1534,7 +1617,7 @@ var CimplifyClient = class {
     return this.handleRestResponse(response);
   }
   async linkDelete(path) {
-    const response = await fetch(`${this.linkApiUrl}${path}`, {
+    const response = await this.resilientFetch(`${this.linkApiUrl}${path}`, {
       method: "DELETE",
       credentials: this.credentials,
       headers: this.getHeaders()

package/dist/index.mjs

@@ -1389,6 +1389,51 @@ var LiteService = class {
 // src/client.ts
 var SESSION_TOKEN_HEADER = "x-session-token";
 var SESSION_STORAGE_KEY = "cimplify_session_token";
+var DEFAULT_TIMEOUT_MS = 3e4;
+var DEFAULT_MAX_RETRIES = 3;
+var DEFAULT_RETRY_DELAY_MS = 1e3;
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function isRetryable(error) {
+  if (error instanceof TypeError && error.message.includes("fetch")) {
+    return true;
+  }
+  if (error instanceof DOMException && error.name === "AbortError") {
+    return true;
+  }
+  if (error instanceof CimplifyError) {
+    return error.retryable;
+  }
+  if (error instanceof CimplifyError && error.code === "SERVER_ERROR") {
+    return true;
+  }
+  return false;
+}
+function toNetworkError(error) {
+  if (error instanceof DOMException && error.name === "AbortError") {
+    return new CimplifyError(
+      ErrorCode.TIMEOUT,
+      "Request timed out. Please check your connection and try again.",
+      true
+    );
+  }
+  if (error instanceof TypeError && error.message.includes("fetch")) {
+    return new CimplifyError(
+      ErrorCode.NETWORK_ERROR,
+      "Network error. Please check your internet connection.",
+      true
+    );
+  }
+  if (error instanceof CimplifyError) {
+    return error;
+  }
+  return new CimplifyError(
+    ErrorCode.UNKNOWN_ERROR,
+    error instanceof Error ? error.message : "An unknown error occurred",
+    false
+  );
+}
 function deriveUrls() {
   const hostname = typeof window !== "undefined" ? window.location.hostname : "";
   if (hostname === "localhost" || hostname === "127.0.0.1") {
@@ -1411,6 +1456,9 @@ var CimplifyClient = class {
     this.baseUrl = urls.baseUrl;
     this.linkApiUrl = urls.linkApiUrl;
     this.credentials = config.credentials || "include";
+    this.timeout = config.timeout ?? DEFAULT_TIMEOUT_MS;
+    this.maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
+    this.retryDelay = config.retryDelay ?? DEFAULT_RETRY_DELAY_MS;
     this.sessionToken = this.loadSessionToken();
   }
   getSessionToken() {
@@ -1456,12 +1504,47 @@ var CimplifyClient = class {
       this.saveSessionToken(newToken);
     }
   }
+  /**
+   * Resilient fetch with timeout and automatic retries for network errors.
+   * Uses exponential backoff: 1s, 2s, 4s between retries.
+   */
+  async resilientFetch(url, options) {
+    let lastError;
+    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      try {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        const response = await fetch(url, {
+          ...options,
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        if (response.ok || response.status >= 400 && response.status < 500) {
+          return response;
+        }
+        if (response.status >= 500 && attempt < this.maxRetries) {
+          const delay = this.retryDelay * Math.pow(2, attempt);
+          await sleep(delay);
+          continue;
+        }
+        return response;
+      } catch (error) {
+        lastError = error;
+        if (!isRetryable(error) || attempt >= this.maxRetries) {
+          throw toNetworkError(error);
+        }
+        const delay = this.retryDelay * Math.pow(2, attempt);
+        await sleep(delay);
+      }
+    }
+    throw toNetworkError(lastError);
+  }
   async query(query2, variables) {
     const body = { query: query2 };
     if (variables) {
       body.variables = variables;
     }
-    const response = await fetch(`${this.baseUrl}/api/q`, {
+    const response = await this.resilientFetch(`${this.baseUrl}/api/q`, {
       method: "POST",
       credentials: this.credentials,
       headers: this.getHeaders(),
@@ -1475,7 +1558,7 @@ var CimplifyClient = class {
       method,
       args: args !== void 0 ? [args] : []
     };
-    const response = await fetch(`${this.baseUrl}/api/m`, {
+    const response = await this.resilientFetch(`${this.baseUrl}/api/m`, {
       method: "POST",
       credentials: this.credentials,
       headers: this.getHeaders(),
@@ -1485,7 +1568,7 @@ var CimplifyClient = class {
     return this.handleResponse(response);
   }
   async get(path) {
-    const response = await fetch(`${this.baseUrl}${path}`, {
+    const response = await this.resilientFetch(`${this.baseUrl}${path}`, {
       method: "GET",
       credentials: this.credentials,
       headers: this.getHeaders()
@@ -1494,7 +1577,7 @@ var CimplifyClient = class {
     return this.handleRestResponse(response);
   }
   async post(path, body) {
-    const response = await fetch(`${this.baseUrl}${path}`, {
+    const response = await this.resilientFetch(`${this.baseUrl}${path}`, {
       method: "POST",
       credentials: this.credentials,
       headers: this.getHeaders(),
@@ -1504,7 +1587,7 @@ var CimplifyClient = class {
     return this.handleRestResponse(response);
   }
   async delete(path) {
-    const response = await fetch(`${this.baseUrl}${path}`, {
+    const response = await this.resilientFetch(`${this.baseUrl}${path}`, {
       method: "DELETE",
       credentials: this.credentials,
       headers: this.getHeaders()
@@ -1513,7 +1596,7 @@ var CimplifyClient = class {
     return this.handleRestResponse(response);
   }
   async linkGet(path) {
-    const response = await fetch(`${this.linkApiUrl}${path}`, {
+    const response = await this.resilientFetch(`${this.linkApiUrl}${path}`, {
       method: "GET",
       credentials: this.credentials,
       headers: this.getHeaders()
@@ -1522,7 +1605,7 @@ var CimplifyClient = class {
     return this.handleRestResponse(response);
   }
   async linkPost(path, body) {
-    const response = await fetch(`${this.linkApiUrl}${path}`, {
+    const response = await this.resilientFetch(`${this.linkApiUrl}${path}`, {
       method: "POST",
       credentials: this.credentials,
       headers: this.getHeaders(),
@@ -1532,7 +1615,7 @@ var CimplifyClient = class {
     return this.handleRestResponse(response);
   }
   async linkDelete(path) {
-    const response = await fetch(`${this.linkApiUrl}${path}`, {
+    const response = await this.resilientFetch(`${this.linkApiUrl}${path}`, {
       method: "DELETE",
       credentials: this.credentials,
       headers: this.getHeaders()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cimplify/sdk",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Cimplify Commerce SDK for storefronts",
   "keywords": [
     "cimplify",