@cimplify/sdk 0.3.3 → 0.3.4

package/dist/index.d.mts

@@ -2849,6 +2849,8 @@ declare class CimplifyClient {
     private timeout;
     private maxRetries;
     private retryDelay;
+    /** In-flight request deduplication map */
+    private inflightRequests;
     private _catalogue?;
     private _cart?;
     private _checkout?;
@@ -2872,7 +2874,25 @@ declare class CimplifyClient {
      * Uses exponential backoff: 1s, 2s, 4s between retries.
      */
     private resilientFetch;
+    /**
+     * Generate a deduplication key for a request.
+     * Same query + variables = same key = deduplicated.
+     */
+    private getDedupeKey;
+    /**
+     * Execute a request with deduplication.
+     * If an identical request is already in-flight, return the same promise.
+     * This prevents redundant network calls when multiple components request the same data.
+     */
+    private deduplicatedRequest;
+    /**
+     * Execute a query with deduplication.
+     * Multiple identical queries made simultaneously will share a single network request.
+     */
     query<T = unknown>(query: string, variables?: Record<string, unknown>): Promise<T>;
+    /**
+     * Execute a mutation. NOT deduplicated - mutations have side effects.
+     */
     call<T = unknown>(method: string, args?: unknown): Promise<T>;
     get<T = unknown>(path: string): Promise<T>;
     post<T = unknown>(path: string, body?: unknown): Promise<T>;

package/dist/index.d.ts

@@ -2849,6 +2849,8 @@ declare class CimplifyClient {
     private timeout;
     private maxRetries;
     private retryDelay;
+    /** In-flight request deduplication map */
+    private inflightRequests;
     private _catalogue?;
     private _cart?;
     private _checkout?;
@@ -2872,7 +2874,25 @@ declare class CimplifyClient {
      * Uses exponential backoff: 1s, 2s, 4s between retries.
      */
     private resilientFetch;
+    /**
+     * Generate a deduplication key for a request.
+     * Same query + variables = same key = deduplicated.
+     */
+    private getDedupeKey;
+    /**
+     * Execute a request with deduplication.
+     * If an identical request is already in-flight, return the same promise.
+     * This prevents redundant network calls when multiple components request the same data.
+     */
+    private deduplicatedRequest;
+    /**
+     * Execute a query with deduplication.
+     * Multiple identical queries made simultaneously will share a single network request.
+     */
     query<T = unknown>(query: string, variables?: Record<string, unknown>): Promise<T>;
+    /**
+     * Execute a mutation. NOT deduplicated - mutations have side effects.
+     */
     call<T = unknown>(method: string, args?: unknown): Promise<T>;
     get<T = unknown>(path: string): Promise<T>;
     post<T = unknown>(path: string, body?: unknown): Promise<T>;

package/dist/index.js

@@ -1469,6 +1469,8 @@ function deriveUrls() {
 var CimplifyClient = class {
   constructor(config = {}) {
     this.sessionToken = null;
+    /** In-flight request deduplication map */
+    this.inflightRequests = /* @__PURE__ */ new Map();
     this.publicKey = config.publicKey || "";
     const urls = deriveUrls();
     this.baseUrl = urls.baseUrl;
@@ -1557,20 +1559,53 @@ var CimplifyClient = class {
     }
     throw toNetworkError(lastError);
   }
+  /**
+   * Generate a deduplication key for a request.
+   * Same query + variables = same key = deduplicated.
+   */
+  getDedupeKey(type, payload) {
+    return `${type}:${JSON.stringify(payload)}`;
+  }
+  /**
+   * Execute a request with deduplication.
+   * If an identical request is already in-flight, return the same promise.
+   * This prevents redundant network calls when multiple components request the same data.
+   */
+  async deduplicatedRequest(key, requestFn) {
+    const existing = this.inflightRequests.get(key);
+    if (existing) {
+      return existing;
+    }
+    const request = requestFn().finally(() => {
+      this.inflightRequests.delete(key);
+    });
+    this.inflightRequests.set(key, request);
+    return request;
+  }
+  /**
+   * Execute a query with deduplication.
+   * Multiple identical queries made simultaneously will share a single network request.
+   */
   async query(query2, variables) {
     const body = { query: query2 };
     if (variables) {
       body.variables = variables;
     }
-    const response = await this.resilientFetch(`${this.baseUrl}/api/q`, {
-      method: "POST",
-      credentials: this.credentials,
-      headers: this.getHeaders(),
-      body: JSON.stringify(body)
+    const key = this.getDedupeKey("query", body);
+    return this.deduplicatedRequest(key, async () => {
+      const response = await this.resilientFetch(`${this.baseUrl}/api/q`, {
+        method: "POST",
+        credentials: this.credentials,
+        headers: this.getHeaders(),
+        body: JSON.stringify(body)
+      });
+      this.updateSessionFromResponse(response);
+      return this.handleResponse(response);
     });
-    this.updateSessionFromResponse(response);
-    return this.handleResponse(response);
   }
+  /**
+   * Execute a mutation. NOT deduplicated - mutations have side effects.
+   */
   async call(method, args) {
     const body = {
       method,
@@ -1586,13 +1621,16 @@ var CimplifyClient = class {
     return this.handleResponse(response);
   }
   async get(path) {
-    const response = await this.resilientFetch(`${this.baseUrl}${path}`, {
-      method: "GET",
-      credentials: this.credentials,
-      headers: this.getHeaders()
+    const key = this.getDedupeKey("get", path);
+    return this.deduplicatedRequest(key, async () => {
+      const response = await this.resilientFetch(`${this.baseUrl}${path}`, {
+        method: "GET",
+        credentials: this.credentials,
+        headers: this.getHeaders()
+      });
+      this.updateSessionFromResponse(response);
+      return this.handleRestResponse(response);
     });
-    this.updateSessionFromResponse(response);
-    return this.handleRestResponse(response);
   }
   async post(path, body) {
     const response = await this.resilientFetch(`${this.baseUrl}${path}`, {
@@ -1614,13 +1652,16 @@ var CimplifyClient = class {
     return this.handleRestResponse(response);
   }
   async linkGet(path) {
-    const response = await this.resilientFetch(`${this.linkApiUrl}${path}`, {
-      method: "GET",
-      credentials: this.credentials,
-      headers: this.getHeaders()
+    const key = this.getDedupeKey("linkGet", path);
+    return this.deduplicatedRequest(key, async () => {
+      const response = await this.resilientFetch(`${this.linkApiUrl}${path}`, {
+        method: "GET",
+        credentials: this.credentials,
+        headers: this.getHeaders()
+      });
+      this.updateSessionFromResponse(response);
+      return this.handleRestResponse(response);
     });
-    this.updateSessionFromResponse(response);
-    return this.handleRestResponse(response);
   }
   async linkPost(path, body) {
     const response = await this.resilientFetch(`${this.linkApiUrl}${path}`, {

package/dist/index.mjs

@@ -1467,6 +1467,8 @@ function deriveUrls() {
 var CimplifyClient = class {
   constructor(config = {}) {
     this.sessionToken = null;
+    /** In-flight request deduplication map */
+    this.inflightRequests = /* @__PURE__ */ new Map();
     this.publicKey = config.publicKey || "";
     const urls = deriveUrls();
     this.baseUrl = urls.baseUrl;
@@ -1555,20 +1557,53 @@ var CimplifyClient = class {
     }
     throw toNetworkError(lastError);
   }
+  /**
+   * Generate a deduplication key for a request.
+   * Same query + variables = same key = deduplicated.
+   */
+  getDedupeKey(type, payload) {
+    return `${type}:${JSON.stringify(payload)}`;
+  }
+  /**
+   * Execute a request with deduplication.
+   * If an identical request is already in-flight, return the same promise.
+   * This prevents redundant network calls when multiple components request the same data.
+   */
+  async deduplicatedRequest(key, requestFn) {
+    const existing = this.inflightRequests.get(key);
+    if (existing) {
+      return existing;
+    }
+    const request = requestFn().finally(() => {
+      this.inflightRequests.delete(key);
+    });
+    this.inflightRequests.set(key, request);
+    return request;
+  }
+  /**
+   * Execute a query with deduplication.
+   * Multiple identical queries made simultaneously will share a single network request.
+   */
   async query(query2, variables) {
     const body = { query: query2 };
     if (variables) {
       body.variables = variables;
     }
-    const response = await this.resilientFetch(`${this.baseUrl}/api/q`, {
-      method: "POST",
-      credentials: this.credentials,
-      headers: this.getHeaders(),
-      body: JSON.stringify(body)
+    const key = this.getDedupeKey("query", body);
+    return this.deduplicatedRequest(key, async () => {
+      const response = await this.resilientFetch(`${this.baseUrl}/api/q`, {
+        method: "POST",
+        credentials: this.credentials,
+        headers: this.getHeaders(),
+        body: JSON.stringify(body)
+      });
+      this.updateSessionFromResponse(response);
+      return this.handleResponse(response);
     });
-    this.updateSessionFromResponse(response);
-    return this.handleResponse(response);
   }
+  /**
+   * Execute a mutation. NOT deduplicated - mutations have side effects.
+   */
   async call(method, args) {
     const body = {
       method,
@@ -1584,13 +1619,16 @@ var CimplifyClient = class {
     return this.handleResponse(response);
   }
   async get(path) {
-    const response = await this.resilientFetch(`${this.baseUrl}${path}`, {
-      method: "GET",
-      credentials: this.credentials,
-      headers: this.getHeaders()
+    const key = this.getDedupeKey("get", path);
+    return this.deduplicatedRequest(key, async () => {
+      const response = await this.resilientFetch(`${this.baseUrl}${path}`, {
+        method: "GET",
+        credentials: this.credentials,
+        headers: this.getHeaders()
+      });
+      this.updateSessionFromResponse(response);
+      return this.handleRestResponse(response);
     });
-    this.updateSessionFromResponse(response);
-    return this.handleRestResponse(response);
   }
   async post(path, body) {
     const response = await this.resilientFetch(`${this.baseUrl}${path}`, {
@@ -1612,13 +1650,16 @@ var CimplifyClient = class {
     return this.handleRestResponse(response);
   }
   async linkGet(path) {
-    const response = await this.resilientFetch(`${this.linkApiUrl}${path}`, {
-      method: "GET",
-      credentials: this.credentials,
-      headers: this.getHeaders()
+    const key = this.getDedupeKey("linkGet", path);
+    return this.deduplicatedRequest(key, async () => {
+      const response = await this.resilientFetch(`${this.linkApiUrl}${path}`, {
+        method: "GET",
+        credentials: this.credentials,
+        headers: this.getHeaders()
+      });
+      this.updateSessionFromResponse(response);
+      return this.handleRestResponse(response);
     });
-    this.updateSessionFromResponse(response);
-    return this.handleRestResponse(response);
   }
   async linkPost(path, body) {
     const response = await this.resilientFetch(`${this.linkApiUrl}${path}`, {

package/package.json

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