@viu/emporix-sdk-react 2.7.0 → 2.9.0

package/CHANGELOG.md

@@ -1,5 +1,120 @@
 # @viu/emporix-sdk-react
 
+## 2.9.0
+
+### Minor Changes
+
+- [#108](https://github.com/viuteam/emporix-sdk/pull/108) [`056cb62`](https://github.com/viuteam/emporix-sdk/commit/056cb622106fa5854ec9ebbee6e91c4820e62b29) Thanks [@amnael1](https://github.com/amnael1)! - feat(sdk): generate customer-management types from the real OpenAPI spec
+
+  Replaces the hand-written customer-management mirror (B2B legal-entities /
+  contact-assignments / locations) with codegen output from the vendored
+  "Customer Management Service" spec, so Companies/Contacts/Locations return the
+  real API shape. The `update` methods (and the matching `useUpdateCompany` /
+  `useUpdateContactAssignment` / `useUpdateLocation` hooks) now type their PATCH
+  body as `Partial<*Update>` to reflect the partial-update endpoint. `LegalEntity.id`
+  and sibling ids are optional in the generated shape, matching the wire contract.
+
+- [#109](https://github.com/viuteam/emporix-sdk/pull/109) [`f90e05b`](https://github.com/viuteam/emporix-sdk/commit/f90e05b97f6c022660bc36ac3656e2f48bf78e69) Thanks [@amnael1](https://github.com/amnael1)! - feat(sdk): generate IAM types, add group member mutations
+
+  Replaces the last hand-written `generated/` mirror (`iam`) with codegen from the
+  vendored "IAM Service" spec, so `customerGroups.listForCompany` returns the real
+  group shape (`GroupsQueryDocument` — note: the wire uses `code`/`userType`, not
+  the previously-mirrored `role`, which never existed on the API). Ships the
+  previously-deferred group member mutations now that the endpoints are confirmed:
+  `customerGroups.addMember` / `removeMember`, plus the `useAddGroupMember` /
+  `useRemoveGroupMember` React hooks. No hand-written generated mirrors remain.
+
+- [#107](https://github.com/viuteam/emporix-sdk/pull/107) [`975290c`](https://github.com/viuteam/emporix-sdk/commit/975290c7bd6129754d82e131186cade633394836) Thanks [@amnael1](https://github.com/amnael1)! - feat(product): add searchByName free-text helper + useProductNameSearch
+
+  `products.searchByName(term)` builds the Emporix `name:(~<term>)` regex filter
+  (escaping metacharacters) and delegates to `search`, so consumers no longer
+  hand-build the `q` DSL — a bare free-text term otherwise 400s with
+  "No value for key …". Adds the `useProductNameSearch` React hook (disabled on
+  empty/whitespace).
+
+### Patch Changes
+
+- [#106](https://github.com/viuteam/emporix-sdk/pull/106) [`04b95ea`](https://github.com/viuteam/emporix-sdk/commit/04b95eab1fbf6b09ca29b0e3a98605e5ef938c6c) Thanks [@amnael1](https://github.com/amnael1)! - feat(sdk): generate order-v2 types from the real OpenAPI spec
+
+  Replaces the hand-written `order-v2` type mirror (which invented `items`,
+  `{amount,currency}` totals and a top-level `orderNumber`) with codegen output
+  from the vendored Emporix Order Service spec. `OrdersService` and
+  `SalesOrdersService` now return the real API shape:
+  - line items are `entries` (not `items`); each entry has `itemYrn`,
+    `orderedAmount`/`amount`, and a nested `product`
+  - `totalPrice`/`subTotalPrice` are numbers + a top-level `currency`; rich
+    net/gross/tax lives in `calculatedPrice`
+  - `orderNumber` is under `mixins.generalAttributes`
+  - `SalesOrderPatch` is now `Partial<OrderUpdateDto>` (the real PATCH body)
+
+  Public type surface: `Order`, `OrderEntry`, `OrderStatus`, `SalesOrder`,
+  `Transition`, `SalesOrderPatch`. The unused fictional re-exports (`OrderItem`,
+  `OrderMoney`, `OrderCustomer`, `OrderAddress`, `OrderPayment`, `OrderDelivery`,
+  `OrderTaxLine`, `OrderMetadata`, `OrderTransition`) are removed — they had no
+  runtime counterpart.
+
+  `useReorder` now reads `entries` and re-adds each with its `itemYrn` + price row
+  (`priceId`/amounts/currency) — the cart requires a price, so the previous
+  `{ product: { id } }` body always failed; reorder now actually works.
+
+## 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

package/dist/{chunk-TJXNTSXN.js → chunk-3W3TIKRV.js}

@@ -1,5 +1,5 @@
-import { useEmporix, EmporixSiteContext, useActiveCompany } from './chunk-SDRV73LG.js';
-import { useContext, useState, useEffect, useCallback } from 'react';
+import { useEmporix, EmporixSiteContext, useActiveCompany } from './chunk-JZRSYM3W.js';
+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,
@@ -318,6 +348,17 @@ function useProductSearch(query, params = {}, options = {}) {
     staleTime: PRODUCTS_STALE_TIME
   });
 }
+function useProductNameSearch(term, params = {}, options = {}) {
+  const { client } = useEmporix();
+  const { ctx } = useReadAuth(options.auth);
+  const { siteCode } = useReadSite();
+  return useQuery({
+    queryKey: emporixKey("product-name-search", [term, params], { tenant: client.tenant, authKind: ctx.kind, siteCode }),
+    enabled: typeof term === "string" && term.trim() !== "",
+    queryFn: () => client.products.searchByName(term, params, ctx),
+    staleTime: PRODUCTS_STALE_TIME
+  });
+}
 function useProductsByCodes(codes, options = {}) {
   const { client } = useEmporix();
   const { ctx } = useReadAuth(options.auth);
@@ -546,7 +587,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 });
+        }
       }
     });
   }
@@ -565,7 +611,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
@@ -600,6 +648,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;
@@ -1066,6 +1122,24 @@ function useDeleteLocation() {
     onSuccess: () => qc.invalidateQueries({ predicate: (q) => q.queryKey.includes("locations") })
   });
 }
+function useAddGroupMember() {
+  const { client } = useEmporix();
+  const resolveAuth = useCustomerAuthResolver();
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: ({ groupId, member }) => client.customerGroups.addMember(groupId, member, resolveAuth()),
+    onSuccess: () => qc.invalidateQueries({ predicate: (q) => q.queryKey.includes("groups") })
+  });
+}
+function useRemoveGroupMember() {
+  const { client } = useEmporix();
+  const resolveAuth = useCustomerAuthResolver();
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: ({ groupId, userId }) => client.customerGroups.removeMember(groupId, userId, resolveAuth()),
+    onSuccess: () => qc.invalidateQueries({ predicate: (q) => q.queryKey.includes("groups") })
+  });
+}
 function useCompanySwitcher() {
   const ctx = useActiveCompany();
   const switchFn = useCallback(
@@ -1201,11 +1275,23 @@ function useReorder() {
       });
       const cartId = storage.getCartId();
       if (!cartId) throw new Error("useReorder: no active cart id in storage");
-      if (order.items.length === 0) return { added: 0, errors: [] };
-      const batchBody = order.items.map((item) => ({
-        product: { id: item.productId },
-        quantity: item.quantity
-      }));
+      const batchBody = (order.entries ?? []).map((entry) => {
+        const p = entry.price;
+        if (!entry.itemYrn || !p?.priceId || p.originalAmount === void 0 || p.effectiveAmount === void 0 || !p.currency) {
+          return null;
+        }
+        return {
+          itemYrn: entry.itemYrn,
+          quantity: entry.orderedAmount ?? entry.amount,
+          price: {
+            priceId: p.priceId,
+            originalAmount: p.originalAmount,
+            effectiveAmount: p.effectiveAmount,
+            currency: p.currency
+          }
+        };
+      }).filter((x) => x !== null);
+      if (batchBody.length === 0) return { added: 0, errors: [] };
       const res = await client.carts.addItemsBatch(cartId, batchBody, ctx);
       let added = 0;
       const errors = [];
@@ -1430,6 +1516,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, useSubcategories, useUnassignContact, useUpdateApproval, useUpdateCompany, useUpdateContactAssignment, useUpdateCustomer, useUpdateLocation, useUpdateSalesOrder, useValidateCoupon, useVariantChildren };
-//# sourceMappingURL=chunk-TJXNTSXN.js.map
-//# sourceMappingURL=chunk-TJXNTSXN.js.map
+export { useActiveCart, useAddGroupMember, 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, useProductNameSearch, useProductSearch, useProducts, useProductsByCodes, useProductsInCategory, useProductsInCategoryInfinite, useProductsInfinite, useRedeemCoupon, useRedeemOptions, useRedeemRewardPoints, useRemoveFromShoppingList, useRemoveGroupMember, useReorder, useReturn, useSalesOrder, useSetShoppingListItemQuantity, useShoppingLists, useSiteContext, useSites, useSubcategories, useUnassignContact, useUpdateApproval, useUpdateCompany, useUpdateContactAssignment, useUpdateCustomer, useUpdateLocation, useUpdateSalesOrder, useValidateCoupon, useVariantChildren };
+//# sourceMappingURL=chunk-3W3TIKRV.js.map
+//# sourceMappingURL=chunk-3W3TIKRV.js.map