@behio/storefront-sdk 2.0.0 → 2.0.2

package/dist/react.mjs

@@ -134,6 +134,8 @@ var BehioStorefront = class {
     // Token refresh lock
     this.isRefreshing = false;
     this.refreshPromise = null;
+    this.requestContextVersion = 0;
+    this.authContextVersion = 0;
     // Event emitter
     this.listeners = /* @__PURE__ */ new Map();
     // Interceptors
@@ -177,6 +179,28 @@ var BehioStorefront = class {
     this.subscriptions = new SubscriptionsModule(this);
     this.certificates = new CourseCertificatesModule(this);
   }
+  /** @internal Opaque generation, never a token or customer identifier. */
+  getRequestContextVersion() {
+    return this.requestContextVersion;
+  }
+  /** @internal Refreshes must not restore a session that has been replaced. */
+  getAuthContextVersion() {
+    return this.authContextVersion;
+  }
+  /** @internal A refresh rotates credentials within the same customer session. */
+  acceptRefreshedTokens(tokens, expectedVersion) {
+    if (this.authContextVersion !== expectedVersion) return false;
+    if (!this.accessToken) this.setTokens(tokens);
+    else {
+      this.accessToken = tokens.accessToken;
+      this.refreshToken = tokens.refreshToken;
+    }
+    return true;
+  }
+  /** @internal An obsolete response must not update cache, session or retries. */
+  assertRequestContext(version, authOnly = false) {
+    if (version !== (authOnly ? this.authContextVersion : this.requestContextVersion)) throw new BehioApiError(409, null, "The storefront session or pricing context changed. Please retry in the current context.");
+  }
   // --- Public methods ---
   /**
    * Called by the analytics tracker when the visitor grants (id) or revokes
@@ -270,11 +294,19 @@ var BehioStorefront = class {
   }
   /** Set auth tokens (e.g. from localStorage) */
   setTokens(tokens) {
+    if (this.accessToken !== tokens.accessToken || this.refreshToken !== tokens.refreshToken) {
+      this.authContextVersion++;
+      this.requestContextVersion++;
+    }
     this.accessToken = tokens.accessToken;
     this.refreshToken = tokens.refreshToken;
   }
   /** Clear auth tokens */
   clearTokens() {
+    if (this.accessToken || this.refreshToken) {
+      this.authContextVersion++;
+      this.requestContextVersion++;
+    }
     this.accessToken = void 0;
     this.refreshToken = void 0;
   }
@@ -288,6 +320,7 @@ var BehioStorefront = class {
   }
   /** Set cart session token (e.g. from cookie) */
   setCartSession(token) {
+    if (this.cartSession !== token) this.requestContextVersion++;
     this.cartSession = token;
   }
   /** Get cart session token */
@@ -296,6 +329,7 @@ var BehioStorefront = class {
   }
   /** Clear cart session */
   clearCartSession() {
+    if (this.cartSession) this.requestContextVersion++;
     this.cartSession = void 0;
   }
   // --- Default currency / locale (runtime-switchable) ---
@@ -306,6 +340,7 @@ var BehioStorefront = class {
    * (falls back to the shop's default currency server-side).
    */
   setCurrency(currency) {
+    if (this.defaultCurrency !== (currency || void 0)) this.requestContextVersion++;
     this.defaultCurrency = currency || void 0;
   }
   /** Get the current default currency, if any. */
@@ -315,13 +350,16 @@ var BehioStorefront = class {
   /** Set the catalog's delivery country. Use cart.setDestination separately for the cart. */
   setCountry(country) {
     const normalized = country?.trim().toUpperCase();
-    this.defaultCountry = normalized && /^[A-Z]{2}$/.test(normalized) ? normalized : void 0;
+    const next = normalized && /^[A-Z]{2}$/.test(normalized) ? normalized : void 0;
+    if (this.defaultCountry !== next) this.requestContextVersion++;
+    this.defaultCountry = next;
   }
   getCountry() {
     return this.defaultCountry;
   }
   /** Set the default locale sent on every catalog request (per-call wins). */
   setLocale(locale) {
+    if (this.defaultLocale !== (locale || void 0)) this.requestContextVersion++;
     this.defaultLocale = locale || void 0;
   }
   /** Get the current default locale, if any. */
@@ -377,18 +415,17 @@ var BehioStorefront = class {
       return;
     }
     this.isRefreshing = true;
+    const authVersion = this.authContextVersion;
     this.refreshPromise = (async () => {
       try {
         const res = await this.auth.refresh();
-        if (res.error) {
+        if (res.error) throw new BehioApiError(res.error.status ?? 401, res.error.body, res.error.message);
+        if (this.authContextVersion === authVersion) this.emit("auth:token-refresh");
+      } catch (err) {
+        if (this.authContextVersion === authVersion) {
           this.clearTokens();
           this.emit("auth:token-refresh-failed");
-          throw new BehioApiError(401, null, "Token refresh failed");
         }
-        this.emit("auth:token-refresh");
-      } catch (err) {
-        this.clearTokens();
-        this.emit("auth:token-refresh-failed");
         if (err instanceof BehioApiError) throw err;
         throw new BehioApiError(401, null, "Token refresh failed");
       } finally {
@@ -425,6 +462,7 @@ var BehioStorefront = class {
    * @internal — use the typed module methods (behio.certificates.downloadPdf).
    */
   async requestBlob(path) {
+    const authVersion = this.authContextVersion;
     try {
       const headers = { "X-Api-Key": this.apiKey };
       if (this.accessToken)
@@ -440,7 +478,9 @@ var BehioStorefront = class {
         }
         throw new BehioApiError(res.status, body);
       }
-      return ok(await res.blob());
+      const blob = await res.blob();
+      this.assertRequestContext(authVersion, true);
+      return ok(blob);
     } catch (err) {
       if (this.throwOnAvailabilityError && isAvailabilityFailure(err)) {
         throw err;
@@ -454,6 +494,8 @@ var BehioStorefront = class {
    * public callers must go through `request()` which returns Result.
    */
   async rawRequest(method, path, options) {
+    const authOnly = path.startsWith("/auth/");
+    const requestVersion = authOnly ? this.authContextVersion : this.requestContextVersion;
     const params = new URLSearchParams();
     if (options?.query) {
       for (const [key, value] of Object.entries(options.query)) {
@@ -519,6 +561,7 @@ var BehioStorefront = class {
     }
     this.emit("request", { method, path });
     for (let attempt = 0; attempt <= this.retries; attempt++) {
+      this.assertRequestContext(requestVersion, authOnly);
       const controller = new AbortController();
       const timeoutId = setTimeout(() => controller.abort(), this.timeout);
       if (options?.signal) {
@@ -540,6 +583,7 @@ var BehioStorefront = class {
         });
       } catch (err) {
         clearTimeout(timeoutId);
+        this.assertRequestContext(requestVersion, authOnly);
         const isAbort = err instanceof DOMException && err.name === "AbortError";
         const networkErr = new BehioNetworkError(
           isAbort ? "Request timed out" : err.message || "Network error",
@@ -556,6 +600,7 @@ var BehioStorefront = class {
       } finally {
         clearTimeout(timeoutId);
       }
+      this.assertRequestContext(requestVersion, authOnly);
       const remaining = res.headers.get("X-RateLimit-Remaining");
       const reset = res.headers.get("X-RateLimit-Reset");
       if (remaining) this.rateLimitRemaining = parseInt(remaining, 10);
@@ -569,6 +614,7 @@ var BehioStorefront = class {
       this.emit("response", { method, path, status: res.status });
       if (!res.ok) {
         const body = await res.json().catch(() => null);
+        this.assertRequestContext(requestVersion, authOnly);
         const apiError = new BehioApiError(
           res.status,
           body,
@@ -577,11 +623,13 @@ var BehioStorefront = class {
         if (res.status === 401 && this.refreshToken && options?.auth !== false && !options?._isRetryAfterRefresh) {
           try {
             await this.handleTokenRefresh();
+            this.assertRequestContext(requestVersion, authOnly);
             return this.rawRequest(method, path, {
               ...options,
               _isRetryAfterRefresh: true
             });
-          } catch {
+          } catch (error) {
+            if (error instanceof BehioApiError && error.status === 409) throw error;
             this.emit("error", apiError);
             throw apiError;
           }
@@ -606,6 +654,7 @@ var BehioStorefront = class {
         } catch {
         }
       }
+      this.assertRequestContext(requestVersion, authOnly);
       return responseData;
     }
     throw new BehioNetworkError("Request failed after retries");
@@ -950,17 +999,21 @@ var AuthModule = class {
         }
       };
     }
+    const authVersion = this.client.getAuthContextVersion();
     const res = await this.client.request("POST", "/auth/refresh", {
       body: { refreshToken: token },
       auth: false
     });
     if (res.error) return res;
-    this.client.setTokens(res.data);
+    if (!this.client.acceptRefreshedTokens(res.data, authVersion)) {
+      return { data: null, error: toSdkError(new BehioApiError(409, null, "The customer session changed.")) };
+    }
     return res;
   }
   /** Logout (invalidate refresh token) */
   async logout(refreshToken) {
     const token = refreshToken || this.client.getRefreshToken();
+    const authVersion = this.client.getAuthContextVersion();
     const res = await this.client.request(
       "POST",
       "/auth/logout",
@@ -968,8 +1021,10 @@ var AuthModule = class {
         body: { refreshToken: token }
       }
     );
-    this.client.clearTokens();
-    this.client.emit("auth:logout");
+    if (this.client.getAuthContextVersion() === authVersion) {
+      this.client.clearTokens();
+      this.client.emit("auth:logout");
+    }
     return res;
   }
   /** Request password reset email */
@@ -2456,24 +2511,24 @@ function useCart(options) {
     // Only fetch if we have a cart session or are logged in
     enabled: options?.enabled !== false && (!!client.getCartSession() || !!client.getAccessToken())
   });
+  const cancelCartRead = () => queryClient.cancelQueries({ queryKey: [...CART_KEY] });
+  const acceptCart = async (result) => {
+    await cancelCartRead();
+    queryClient.setQueryData([...CART_KEY], result);
+    void refreshBundleQueries(queryClient);
+  };
   const addMutation = useMutation({
     mutationFn: async ({ productId, quantity }) => {
       return unwrap(client.cart.addItem({ productId, quantity: quantity ?? 1 }));
     },
-    onSuccess: (result) => {
+    onMutate: cancelCartRead,
+    onSuccess: async (result) => {
       if (result.newSessionToken) {
         storage.set(STORAGE_KEYS.CART_SESSION, result.newSessionToken);
       }
-      queryClient.setQueryData([...CART_KEY], result);
-      void refreshBundleQueries(queryClient);
+      await acceptCart(result);
     }
   });
-  const cancelCartRead = () => queryClient.cancelQueries({ queryKey: [...CART_KEY] });
-  const acceptCart = async (result) => {
-    await cancelCartRead();
-    queryClient.setQueryData([...CART_KEY], result);
-    void refreshBundleQueries(queryClient);
-  };
   const updateMutation = useMutation({
     mutationFn: async ({ itemId, quantity }) => {
       return unwrap(client.cart.updateQuantity(itemId, quantity));
@@ -2496,7 +2551,9 @@ function useCart(options) {
   });
   const clearMutation = useMutation({
     mutationFn: () => unwrap(client.cart.clear()),
-    onSuccess: () => {
+    onMutate: cancelCartRead,
+    onSuccess: async () => {
+      await cancelCartRead();
       queryClient.setQueryData([...CART_KEY], null);
       client.clearCartSession();
       storage.remove(STORAGE_KEYS.CART_SESSION);
@@ -2505,19 +2562,19 @@ function useCart(options) {
   });
   const applyDiscountMutation = useMutation({
     mutationFn: (code) => unwrap(client.cart.applyDiscount(code)),
-    onSuccess: (result) => {
-      queryClient.setQueryData([...CART_KEY], result);
-    }
+    onMutate: cancelCartRead,
+    onSuccess: acceptCart
   });
   const removeDiscountMutation = useMutation({
     mutationFn: () => unwrap(client.cart.removeDiscount()),
-    onSuccess: (result) => {
-      queryClient.setQueryData([...CART_KEY], result);
-    }
+    onMutate: cancelCartRead,
+    onSuccess: acceptCart
   });
   const mergeMutation = useMutation({
     mutationFn: () => unwrap(client.cart.merge()),
-    onSuccess: (result) => {
+    onMutate: cancelCartRead,
+    onSuccess: async (result) => {
+      await cancelCartRead();
       queryClient.setQueryData([...CART_KEY], result);
       client.clearCartSession();
       storage.remove(STORAGE_KEYS.CART_SESSION);
@@ -2593,6 +2650,19 @@ function useCartCount(options) {
 // src/react/hooks/use-auth.ts
 import { useCallback as useCallback4 } from "react";
 import { useQuery as useQuery12, useMutation as useMutation2, useQueryClient as useQueryClient3 } from "@tanstack/react-query";
+
+// src/react/utils/clear-customer-queries.ts
+async function clearCustomerQueries(queryClient, client) {
+  const version = client.getAuthContextVersion();
+  await queryClient.cancelQueries({ queryKey: ["behio"] });
+  if (client.getAuthContextVersion() !== version) return false;
+  for (const query of queryClient.getQueryCache().findAll({ queryKey: ["behio"] })) {
+    query.setState({ data: void 0, dataUpdatedAt: 0, error: null, errorUpdatedAt: 0, status: "pending" });
+  }
+  return true;
+}
+
+// src/react/hooks/use-auth.ts
 var CUSTOMER_KEY = ["behio", "customer"];
 var CART_KEY3 = ["behio", "cart"];
 function useAuth() {
@@ -2615,42 +2685,52 @@ function useAuth() {
     },
     [client, storage]
   );
-  const clearAuth = useCallback4(() => {
+  const clearAuth = useCallback4(async () => {
     client.clearTokens();
     storage.remove(STORAGE_KEYS.ACCESS_TOKEN);
     storage.remove(STORAGE_KEYS.REFRESH_TOKEN);
+    if (!await clearCustomerQueries(queryClient, client)) return;
+    queryClient.setQueryData([...CART_KEY3], null);
     queryClient.setQueryData([...CUSTOMER_KEY], null);
-    queryClient.invalidateQueries({ queryKey: ["behio", "orders"] });
-    queryClient.invalidateQueries({ queryKey: ["behio", "addresses"] });
-    void refreshBundleQueries(queryClient);
+    if (client.getCartSession()) void queryClient.invalidateQueries({ queryKey: [...CART_KEY3] });
+    void queryClient.invalidateQueries({ queryKey: ["behio"] });
   }, [client, storage, queryClient]);
   const postAuth = useCallback4(async () => {
+    const authVersion = client.getAuthContextVersion();
+    if (!await clearCustomerQueries(queryClient, client)) return;
     await queryClient.invalidateQueries({ queryKey: [...CUSTOMER_KEY] });
+    if (client.getAuthContextVersion() !== authVersion) return;
     if (client.getCartSession()) {
       try {
         await unwrap(client.cart.merge());
+        if (client.getAuthContextVersion() !== authVersion) return;
         client.clearCartSession();
         storage.remove(STORAGE_KEYS.CART_SESSION);
       } catch {
       }
     }
+    if (client.getAuthContextVersion() !== authVersion) return;
     queryClient.invalidateQueries({ queryKey: [...CART_KEY3] });
     void refreshBundleQueries(queryClient);
   }, [client, storage, queryClient]);
   const loginMutation = useMutation2({
     mutationFn: async ({ email, password }) => {
-      return unwrap(client.auth.login({ email, password }));
+      const tokens = await unwrap(client.auth.login({ email, password }));
+      return { tokens, authVersion: client.getAuthContextVersion() };
     },
-    onSuccess: async (tokens) => {
+    onSuccess: async ({ tokens, authVersion }) => {
+      if (client.getAuthContextVersion() !== authVersion) return;
       persistTokens(tokens);
       await postAuth();
     }
   });
   const registerMutation = useMutation2({
     mutationFn: async (input) => {
-      return unwrap(client.auth.register(input));
+      const result = await unwrap(client.auth.register(input));
+      return { result, authVersion: client.getAuthContextVersion() };
     },
-    onSuccess: async (result) => {
+    onSuccess: async ({ result, authVersion }) => {
+      if (client.getAuthContextVersion() !== authVersion) return;
       if (result.accessToken && result.refreshToken) {
         persistTokens({ accessToken: result.accessToken, refreshToken: result.refreshToken });
         await postAuth();
@@ -2659,8 +2739,9 @@ function useAuth() {
   });
   const logoutMutation = useMutation2({
     mutationFn: () => unwrap(client.auth.logout()),
-    onSettled: () => {
-      clearAuth();
+    onMutate: () => client.getAuthContextVersion(),
+    onSettled: (_result, _error, _variables, authVersion) => {
+      if (!client.getAccessToken() || client.getAuthContextVersion() === authVersion) return clearAuth();
     }
   });
   const forgotPasswordMutation = useMutation2({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@behio/storefront-sdk",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "TypeScript SDK for Behio headless e-commerce: core client + React hooks",
   "author": "Behio",
   "license": "MIT",