@viu/emporix-sdk-react 2.6.0 → 2.8.0

package/CHANGELOG.md

@@ -1,5 +1,86 @@
 # @viu/emporix-sdk-react
 
+## 2.8.0
+
+### Minor Changes
+
+- [#98](https://github.com/viuteam/emporix-sdk/pull/98) [`108a724`](https://github.com/viuteam/emporix-sdk/commit/108a724f1d4342532ae8d575faa501d54d8c591f) Thanks [@amnael1](https://github.com/amnael1)! - Support partial cart-item updates. `client.carts.updateItem(cartId, itemId,
+patch, auth, { partial: true })` now sends `?partial=true`, so a quantity-only
+  change can be `{ quantity }` instead of a full item replace (which otherwise
+  requires re-sending `itemYrn` + the `price` row). The React
+  `useCartMutations().updateItem` mutation accepts an optional `partial` flag in
+  its variables. Default behavior is unchanged.
+
+- [#100](https://github.com/viuteam/emporix-sdk/pull/100) [`b4be158`](https://github.com/viuteam/emporix-sdk/commit/b4be1589b2fb0db44852233efe2a5d575a2e2795) Thanks [@amnael1](https://github.com/amnael1)! - `useCustomerSession()` now exposes the current `saasToken`. It was already
+  tracked internally (from `login` / `exchangeToken`) but not returned — so
+  consumers couldn't pass it to `useCheckout().placeOrder({ ..., saasToken })` for
+  customer checkout, or to saas-token-gated order reads.
+
+### Patch Changes
+
+- [#101](https://github.com/viuteam/emporix-sdk/pull/101) [`e010a5a`](https://github.com/viuteam/emporix-sdk/commit/e010a5ab8f35c92ed946522558db33b2febff5de) Thanks [@amnael1](https://github.com/amnael1)! - fix(react): refresh the cart after a 204-only mutation
+
+  `useCartMutations` assumed every cart write echoes the full updated cart.
+  A partial quantity update (`updateItem(..., { partial: true })`) returns
+  `204 No Content`, which the SDK resolves to `undefined` — and
+  `setQueryData(key, undefined)` is a no-op in React Query, so the cart cache
+  stayed stale and the UI did not reflect the change. The mutation now adopts
+  a real cart body when one is returned and otherwise invalidates the cart
+  query so it refetches. This also makes coupon/address/remove mutations
+  reconcile with the server when they return no body.
+
+- [#103](https://github.com/viuteam/emporix-sdk/pull/103) [`2e5c767`](https://github.com/viuteam/emporix-sdk/commit/2e5c76715f5d08358dd9342ef65d7c4c0d8b9aef) Thanks [@amnael1](https://github.com/amnael1)! - fix(react): drop the cart on logout and react to cart-id clearing
+
+  Two related cleanup gaps caused follow-up errors after logout and checkout:
+  - `useCustomerSession().logout()` cleared the customer token but left the
+    stored `cartId`. The cart belonged to the customer and isn't accessible
+    anonymously, so the cart query immediately refetched it and got a `403`.
+    Logout now clears `cartId` too.
+  - `useActiveCart` cached the cart id in local state and never reacted to
+    external `storage.setCartId(null)` (logout, or the post-order cleanup that
+    closes the cart). It kept fetching the dead cart id — a `403` after logout,
+    a `404` after checkout. It now subscribes to storage cart-id changes and
+    syncs, so clearing the id stops the fetch (and a logged-out cart page
+    bootstraps a fresh anonymous cart on demand).
+
+- [#102](https://github.com/viuteam/emporix-sdk/pull/102) [`020722b`](https://github.com/viuteam/emporix-sdk/commit/020722b2cb696bdc347538205ea4fad884451d88) Thanks [@amnael1](https://github.com/amnael1)! - fix(react): share the customer session across hook instances
+
+  `useCustomerSession` kept its session in a per-instance `useState`. The
+  `token` slot was mirrored from storage (so `isAuthenticated` was consistent),
+  but the in-memory `saasToken` and `refreshToken` lived only in the component
+  instance that called `login()`. A different consumer — e.g. the checkout page
+  reading `saasToken` for the `saas-token` header — saw `null`, so customer
+  checkout failed with `401 "Saas TOKEN is invalid"`.
+
+  The session now lives in a shared, per-storage store consumed via
+  `useSyncExternalStore`, so every `useCustomerSession()` reads the same
+  `{ token, refreshToken, saasToken }`. A login in one component is immediately
+  visible to all others. The tokens remain in-memory only (still cleared on a
+  full reload, by design).
+
+## 2.7.0
+
+### Minor Changes
+
+- [#96](https://github.com/viuteam/emporix-sdk/pull/96) [`da1113a`](https://github.com/viuteam/emporix-sdk/commit/da1113a07f70dceb9f1cb732b28462ccb3671f4a) Thanks [@amnael1](https://github.com/amnael1)! - Fix and extend the Category service for catalogue + hierarchy browsing. Several
+  methods targeted routes that don't exist on the deployed category service
+  (verified against a live tenant):
+  - **`categories.productsIn(...)`** requested a non-existent
+    `/categories/{id}/products` route (always 404). It now resolves products via
+    category **assignments** (`/categories/{id}/assignments` → keep `PRODUCT`
+    refs → `/products/search`), preserving its `PaginatedItems<Product>` contract;
+    categories with no products return an empty page instead of throwing.
+  - **`categories.tree()`** pointed at a non-existent `/categories/{...}Tree`
+    route. It now reads `/category-trees` and returns the catalogue's **root
+    categories** (`Promise<Category[]>`) for top-level navigation. (Return type
+    changed from the previous nested-node shape; the `rootId` argument is removed.)
+  - **New `categories.subcategories(categoryId)`** (+ React `useSubcategories`):
+    a category's direct child categories, resolved from `CATEGORY` assignment refs
+    (mirrors `productsIn`). Returns `[]` when there are none.
+
+  React `useCategoryTree()` now returns `Category[]` (root categories) and takes no
+  `rootId`.
+
 ## 2.6.0
 
 ### Minor Changes

package/dist/{chunk-RCI7242Y.js → chunk-GRGWUXNB.js}

@@ -1,5 +1,5 @@
 import { useEmporix, EmporixSiteContext, useActiveCompany } from './chunk-SDRV73LG.js';
-import { useContext, useState, useEffect, useCallback } from 'react';
+import { useContext, useMemo, useSyncExternalStore, useEffect, useCallback, useState } from 'react';
 import { useQueryClient, useQuery, useMutation, useInfiniteQuery } from '@tanstack/react-query';
 import { auth, EmporixError } from '@viu/emporix-sdk';
 
@@ -29,6 +29,36 @@ async function bootstrapCart(opts) {
   });
 }
 
+// src/hooks/internal/customer-session-store.ts
+var stores = /* @__PURE__ */ new WeakMap();
+function getCustomerSessionStore(storage) {
+  const existing = stores.get(storage);
+  if (existing) return existing;
+  let state = {
+    token: storage.getCustomerToken(),
+    refreshToken: null,
+    saasToken: null
+  };
+  const listeners = /* @__PURE__ */ new Set();
+  const store = {
+    getSnapshot: () => state,
+    setState: (next) => {
+      const resolved = typeof next === "function" ? next(state) : next;
+      if (resolved === state) return;
+      state = resolved;
+      for (const listener of listeners) listener();
+    },
+    subscribe: (listener) => {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+  stores.set(storage, store);
+  return store;
+}
+
 // src/hooks/use-customer-session.ts
 var EMPTY_SESSION = {
   token: null,
@@ -39,14 +69,12 @@ function useCustomerSession() {
   const { client, storage } = useEmporix();
   const qc = useQueryClient();
   const siteCtx = useContext(EmporixSiteContext);
-  const [session, setSession] = useState(() => ({
-    token: storage.getCustomerToken(),
-    refreshToken: null,
-    saasToken: null
-  }));
+  const store = useMemo(() => getCustomerSessionStore(storage), [storage]);
+  const session = useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
+  const setSession = store.setState;
   useEffect(() => {
     return storage.subscribe?.((t) => setSession((s) => ({ ...s, token: t })));
-  }, [storage]);
+  }, [storage, setSession]);
   const meQuery = useQuery({
     queryKey: ["emporix", "customer", "me", { tenant: client.tenant, hasToken: session.token !== null }],
     enabled: session.token !== null,
@@ -80,7 +108,7 @@ function useCustomerSession() {
       await qc.invalidateQueries({ queryKey: ["emporix", "customer"], refetchType: "none" });
       await qc.invalidateQueries({ queryKey: ["emporix", "cart"], refetchType: "none" });
     },
-    [client, storage, qc, siteCtx]
+    [client, storage, qc, siteCtx, setSession]
   );
   const signup = useCallback(
     async (input) => {
@@ -112,7 +140,7 @@ function useCustomerSession() {
       await qc.invalidateQueries({ queryKey: ["emporix", "customer"], refetchType: "none" });
       await qc.invalidateQueries({ queryKey: ["emporix", "cart"], refetchType: "none" });
     },
-    [client, storage, qc, siteCtx]
+    [client, storage, qc, siteCtx, setSession]
   );
   const socialLogin = useCallback(
     async (input) => {
@@ -136,10 +164,11 @@ function useCustomerSession() {
     storage.setCustomerToken(null);
     storage.setRefreshToken(null);
     storage.setActiveLegalEntityId(null);
+    storage.setCartId(null);
     setSession(EMPTY_SESSION);
     qc.removeQueries({ queryKey: ["emporix", "customer"] });
     qc.removeQueries({ queryKey: ["emporix", "cart"] });
-  }, [client, session.token, storage, qc]);
+  }, [client, session.token, storage, qc, setSession]);
   const refresh = useCallback(async () => {
     await meQuery.refetch();
   }, [meQuery]);
@@ -158,10 +187,11 @@ function useCustomerSession() {
     }));
     await qc.invalidateQueries({ queryKey: ["emporix", "customer"] });
     await qc.invalidateQueries({ queryKey: ["emporix", "cart"] });
-  }, [client, storage, qc, session.refreshToken, session.saasToken]);
+  }, [client, storage, qc, session.refreshToken, session.saasToken, setSession]);
   return {
     customerToken: session.token,
     refreshToken: session.refreshToken,
+    saasToken: session.saasToken,
     customer: meQuery.data ?? null,
     isAuthenticated: session.token !== null,
     isLoading: meQuery.isLoading && session.token !== null,
@@ -425,6 +455,17 @@ function useCategory(categoryId, options = {}) {
     staleTime: CATEGORIES_STALE_TIME
   });
 }
+function useSubcategories(categoryId, params = {}, options = {}) {
+  const { client } = useEmporix();
+  const { ctx } = useReadAuth(options.auth);
+  const { siteCode } = useReadSite();
+  return useQuery({
+    queryKey: emporixKey("subcategories", [categoryId ?? null, params], { tenant: client.tenant, authKind: ctx.kind, siteCode }),
+    enabled: typeof categoryId === "string" && categoryId !== "",
+    queryFn: () => client.categories.subcategories(categoryId, params, ctx),
+    staleTime: CATEGORIES_STALE_TIME
+  });
+}
 function useCategories(params = {}, options = {}) {
   const { client } = useEmporix();
   const { ctx } = useReadAuth(options.auth);
@@ -448,13 +489,13 @@ function useCategoriesInfinite(params = {}, options = {}) {
     staleTime: CATEGORIES_STALE_TIME
   });
 }
-function useCategoryTree(rootId, options = {}) {
+function useCategoryTree(options = {}) {
   const { client } = useEmporix();
   const { ctx } = useReadAuth(options.auth);
   const { siteCode } = useReadSite();
   return useQuery({
-    queryKey: emporixKey("category-tree", [rootId ?? null], { tenant: client.tenant, authKind: ctx.kind, siteCode }),
-    queryFn: () => client.categories.tree(rootId, ctx),
+    queryKey: emporixKey("category-tree", [], { tenant: client.tenant, authKind: ctx.kind, siteCode }),
+    queryFn: () => client.categories.tree(ctx),
     staleTime: CATEGORIES_STALE_TIME
   });
 }
@@ -535,7 +576,12 @@ function useCartMutations(cartId) {
         if (c) qc.setQueryData(c.key, c.previous);
       },
       onSuccess: (cart, _v, c) => {
-        if (c) qc.setQueryData(c.key, cart);
+        if (!c) return;
+        if (cart && Array.isArray(cart.items)) {
+          qc.setQueryData(c.key, cart);
+        } else {
+          void qc.invalidateQueries({ queryKey: c.key });
+        }
       }
     });
   }
@@ -554,7 +600,9 @@ function useCartMutations(cartId) {
         ]
       } : prev
     ),
-    updateItem: make((id, v) => client.carts.updateItem(id, v.itemId, v.patch, ctx)),
+    updateItem: make(
+      (id, v) => client.carts.updateItem(id, v.itemId, v.patch, ctx, v.partial ? { partial: true } : {})
+    ),
     removeItem: make(
       (id, v) => client.carts.removeItem(id, v.itemId, ctx),
       (prev, v) => prev ? { ...prev, items: (prev.items ?? []).filter((i) => i.id !== v.itemId) } : prev
@@ -589,6 +637,14 @@ function useActiveCart(opts) {
   const { activeCompany } = useActiveCompany();
   const [cartId, setCartId] = useState(() => storage.getCartId());
   const effectiveLegalEntityId = opts?.legalEntityId ?? activeCompany?.id;
+  useEffect(() => {
+    if (!storage.subscribeAll) return;
+    return storage.subscribeAll((key) => {
+      if (key !== "cartId") return;
+      const next = storage.getCartId();
+      setCartId((prev) => prev === next ? prev : next);
+    });
+  }, [storage]);
   useEffect(() => {
     if (cartId !== null) return;
     if (!opts?.create) return;
@@ -1419,6 +1475,6 @@ function useUpdateApproval() {
   });
 }
 
-export { useActiveCart, useAddToShoppingList, useAddressMutations, useApproval, useApprovals, useAssignContact, useAvailabilities, useAvailability, useCancelOrder, useCart, useCartMutations, useCategories, useCategoriesInfinite, useCategory, useCategoryTree, useChangePassword, useCheckout, useCompany, useCompanyContacts, useCompanyGroups, useCompanyLocations, useCompanySwitcher, useCreateApproval, useCreateCart, useCreateCompany, useCreateLocation, useCreateReturn, useCreateShoppingList, useCustomerAddresses, useCustomerSession, useDefaultSite, useDeleteCompany, useDeleteLocation, useDeleteShoppingList, useMatchPrices, useMatchPricesChunked, useMyCompanies, useMyOrders, useMyOrdersInfinite, useMyReturns, useMyRewardPoints, useMyRewardPointsSummary, useMySegmentCategories, useMySegmentCategoriesInfinite, useMySegmentCategoryTree, useMySegmentItems, useMySegmentProducts, useMySegmentProductsInfinite, useMySegments, useOrder, useOrderTransition, usePasswordReset, usePaymentModes, useProduct, useProductByCode, useProductMedia, useProductSearch, useProducts, useProductsByCodes, useProductsInCategory, useProductsInCategoryInfinite, useProductsInfinite, useRedeemCoupon, useRedeemOptions, useRedeemRewardPoints, useRemoveFromShoppingList, useReorder, useReturn, useSalesOrder, useSetShoppingListItemQuantity, useShoppingLists, useSiteContext, useSites, useUnassignContact, useUpdateApproval, useUpdateCompany, useUpdateContactAssignment, useUpdateCustomer, useUpdateLocation, useUpdateSalesOrder, useValidateCoupon, useVariantChildren };
-//# sourceMappingURL=chunk-RCI7242Y.js.map
-//# sourceMappingURL=chunk-RCI7242Y.js.map
+export { useActiveCart, useAddToShoppingList, useAddressMutations, useApproval, useApprovals, useAssignContact, useAvailabilities, useAvailability, useCancelOrder, useCart, useCartMutations, useCategories, useCategoriesInfinite, useCategory, useCategoryTree, useChangePassword, useCheckout, useCompany, useCompanyContacts, useCompanyGroups, useCompanyLocations, useCompanySwitcher, useCreateApproval, useCreateCart, useCreateCompany, useCreateLocation, useCreateReturn, useCreateShoppingList, useCustomerAddresses, useCustomerSession, useDefaultSite, useDeleteCompany, useDeleteLocation, useDeleteShoppingList, useMatchPrices, useMatchPricesChunked, useMyCompanies, useMyOrders, useMyOrdersInfinite, useMyReturns, useMyRewardPoints, useMyRewardPointsSummary, useMySegmentCategories, useMySegmentCategoriesInfinite, useMySegmentCategoryTree, useMySegmentItems, useMySegmentProducts, useMySegmentProductsInfinite, useMySegments, useOrder, useOrderTransition, usePasswordReset, usePaymentModes, useProduct, useProductByCode, useProductMedia, useProductSearch, useProducts, useProductsByCodes, useProductsInCategory, useProductsInCategoryInfinite, useProductsInfinite, useRedeemCoupon, useRedeemOptions, useRedeemRewardPoints, useRemoveFromShoppingList, useReorder, useReturn, useSalesOrder, useSetShoppingListItemQuantity, useShoppingLists, useSiteContext, useSites, useSubcategories, useUnassignContact, useUpdateApproval, useUpdateCompany, useUpdateContactAssignment, useUpdateCustomer, useUpdateLocation, useUpdateSalesOrder, useValidateCoupon, useVariantChildren };
+//# sourceMappingURL=chunk-GRGWUXNB.js.map
+//# sourceMappingURL=chunk-GRGWUXNB.js.map