@enadhq/enad-react-sdk 1.0.0 → 1.1.0

package/dist/client/cart/constants/session.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.mjs","names":[],"sources":["../../../../src/client/cart/constants/session.ts"],"sourcesContent":["export const CART_SESSION_KEY = \"brink_cart_session\"\n"],"mappings":";AAAA,MAAa,mBAAmB"}

package/dist/client/cart/contexts/cart.d.ts

@@ -0,0 +1,44 @@
+import { CartAdapter } from "../types/adapter.js";
+import React from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/client/cart/contexts/cart.d.ts
+/**
+ * @deprecated Use `createBrinkCartAdapter` from `client/cart/brink-adapter` instead.
+ */
+interface BrinkConfig {
+  env: string;
+  storeGroupId: string;
+  countryCode: string;
+  languageCode: string;
+}
+interface CartProviderProps {
+  adapter: CartAdapter;
+  children: React.ReactNode;
+}
+/**
+ * Provides a cart adapter to all child components via React context.
+ *
+ * ```tsx
+ * import { CartProvider } from "@enadhq/enad-react-sdk/client/cart"
+ * import { createBrinkCartAdapter } from "@enadhq/enad-react-sdk/client/cart/brink-adapter"
+ *
+ * const adapter = createBrinkCartAdapter({ env: "production", ... })
+ *
+ * <CartProvider adapter={adapter}>
+ *   {children}
+ * </CartProvider>
+ * ```
+ */
+declare function CartProvider({
+  adapter,
+  children
+}: CartProviderProps): react_jsx_runtime0.JSX.Element;
+/**
+ * Read the cart adapter from context.
+ * Throws if called outside a CartProvider.
+ */
+declare function useCartAdapter(): CartAdapter;
+//#endregion
+export { BrinkConfig, CartProvider, CartProviderProps, useCartAdapter };
+//# sourceMappingURL=cart.d.ts.map

package/dist/client/cart/contexts/cart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart.d.ts","names":[],"sources":["../../../../src/client/cart/contexts/cart.tsx"],"mappings":";;;;;;;;UAUiB,WAAA;EACf,GAAA;EACA,YAAA;EACA,WAAA;EACA,YAAA;AAAA;AAAA,UASe,iBAAA;EACf,OAAA,EAAS,WAAA;EACT,QAAA,EAAU,KAAA,CAAM,SAAA;AAAA;AAFlB;;;;;;;;;;;AAmBA;;;AAnBA,iBAmBgB,YAAA,CAAA;EAAe,OAAA;EAAS;AAAA,GAAY,iBAAA,GAAiB,kBAAA,CAAA,GAAA,CAAA,OAAA;;;;;iBAQrD,cAAA,CAAA,GAAkB,WAAA"}

package/dist/client/cart/contexts/cart.mjs

@@ -0,0 +1,37 @@
+import { createContext, useContext } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/client/cart/contexts/cart.tsx
+const CartAdapterContext = createContext(void 0);
+/**
+* Provides a cart adapter to all child components via React context.
+*
+* ```tsx
+* import { CartProvider } from "@enadhq/enad-react-sdk/client/cart"
+* import { createBrinkCartAdapter } from "@enadhq/enad-react-sdk/client/cart/brink-adapter"
+*
+* const adapter = createBrinkCartAdapter({ env: "production", ... })
+*
+* <CartProvider adapter={adapter}>
+*   {children}
+* </CartProvider>
+* ```
+*/
+function CartProvider({ adapter, children }) {
+	return /* @__PURE__ */ jsx(CartAdapterContext.Provider, {
+		value: adapter,
+		children
+	});
+}
+/**
+* Read the cart adapter from context.
+* Throws if called outside a CartProvider.
+*/
+function useCartAdapter() {
+	const adapter = useContext(CartAdapterContext);
+	if (!adapter) throw new Error("useCartAdapter must be used inside a <CartProvider>. Did you forget to pass a cart adapter to <EnadProvider>?");
+	return adapter;
+}
+//#endregion
+export { CartProvider, useCartAdapter };
+
+//# sourceMappingURL=cart.mjs.map

package/dist/client/cart/contexts/cart.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart.mjs","names":[],"sources":["../../../../src/client/cart/contexts/cart.tsx"],"sourcesContent":["import React, { createContext, useContext } from \"react\";\nimport type { CartAdapter } from \"../types/adapter\";\n\n// ---------------------------------------------------------------------------\n// Legacy BrinkConfig type — kept for backward compatibility with EnadProvider\n// ---------------------------------------------------------------------------\n\n/**\n * @deprecated Use `createBrinkCartAdapter` from `client/cart/brink-adapter` instead.\n */\nexport interface BrinkConfig {\n  env: string;\n  storeGroupId: string;\n  countryCode: string;\n  languageCode: string;\n}\n\n// ---------------------------------------------------------------------------\n// Cart adapter context\n// ---------------------------------------------------------------------------\n\nconst CartAdapterContext = createContext<CartAdapter | undefined>(undefined);\n\nexport interface CartProviderProps {\n  adapter: CartAdapter;\n  children: React.ReactNode;\n}\n\n/**\n * Provides a cart adapter to all child components via React context.\n *\n * ```tsx\n * import { CartProvider } from \"@enadhq/enad-react-sdk/client/cart\"\n * import { createBrinkCartAdapter } from \"@enadhq/enad-react-sdk/client/cart/brink-adapter\"\n *\n * const adapter = createBrinkCartAdapter({ env: \"production\", ... })\n *\n * <CartProvider adapter={adapter}>\n *   {children}\n * </CartProvider>\n * ```\n */\nexport function CartProvider({ adapter, children }: CartProviderProps) {\n  return <CartAdapterContext.Provider value={adapter}>{children}</CartAdapterContext.Provider>;\n}\n\n/**\n * Read the cart adapter from context.\n * Throws if called outside a CartProvider.\n */\nexport function useCartAdapter(): CartAdapter {\n  const adapter = useContext(CartAdapterContext);\n  if (!adapter) {\n    throw new Error(\n      \"useCartAdapter must be used inside a <CartProvider>. Did you forget to pass a cart adapter to <EnadProvider>?\",\n    );\n  }\n  return adapter;\n}\n"],"mappings":";;;AAqBA,MAAM,qBAAqB,cAAuC,KAAA,EAAU;;;;;;;;;;;;;;;AAqB5E,SAAgB,aAAa,EAAE,SAAS,YAA+B;AACrE,QAAO,oBAAC,mBAAmB,UAApB;EAA6B,OAAO;EAAU;EAAuC,CAAA;;;;;;AAO9F,SAAgB,iBAA8B;CAC5C,MAAM,UAAU,WAAW,mBAAmB;AAC9C,KAAI,CAAC,QACH,OAAM,IAAI,MACR,gHACD;AAEH,QAAO"}

package/dist/client/cart/hooks/useCart.d.ts

@@ -0,0 +1,32 @@
+import { Cart } from "../types/adapter.js";
+import * as _tanstack_react_query0 from "@tanstack/react-query";
+
+//#region src/client/cart/hooks/useCart.d.ts
+/**
+ * Hook to manage cart state and actions.
+ * Reads the cart adapter from CartProvider context,
+ * provides the current cart, loading states, and mutation functions.
+ */
+declare const useCart: () => {
+  addItem: _tanstack_react_query0.UseMutateAsyncFunction<Cart, Error, {
+    productVariantId: string;
+    quantity?: number;
+  }, unknown>;
+  updateItem: _tanstack_react_query0.UseMutateAsyncFunction<Cart, Error, {
+    itemId: string;
+    quantity: number;
+  }, unknown>;
+  removeItem: _tanstack_react_query0.UseMutateAsyncFunction<Cart, Error, {
+    itemId: string;
+  }, unknown>;
+  isAdding: boolean;
+  isUpdating: boolean;
+  isRemoving: boolean;
+  cart: Cart | undefined;
+  isLoading: boolean;
+  isFetching: boolean;
+  refreshCart: (options?: _tanstack_react_query0.RefetchOptions) => Promise<_tanstack_react_query0.QueryObserverResult<Cart, Error>>;
+};
+//#endregion
+export { useCart };
+//# sourceMappingURL=useCart.d.ts.map

package/dist/client/cart/hooks/useCart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCart.d.ts","names":[],"sources":["../../../../src/client/cart/hooks/useCart.tsx"],"mappings":";;;;;;;;;cAUa,OAAA;yDAoBZ,IAAA"}

package/dist/client/cart/hooks/useCart.mjs

@@ -0,0 +1,31 @@
+import { useCartAdapter } from "../contexts/cart.mjs";
+import { CACHE_TAGS } from "../../global/constants/tags.mjs";
+import { useCartActions } from "./useCartActions.mjs";
+import { useQuery } from "@tanstack/react-query";
+//#region src/client/cart/hooks/useCart.tsx
+/**
+* Hook to manage cart state and actions.
+* Reads the cart adapter from CartProvider context,
+* provides the current cart, loading states, and mutation functions.
+*/
+const useCart = () => {
+	const adapter = useCartAdapter();
+	const getCartQuery = useQuery({
+		queryKey: [CACHE_TAGS.cart],
+		queryFn: () => adapter.getCart(),
+		refetchOnMount: false
+	});
+	const currentCart = getCartQuery.data;
+	const cartActions = useCartActions(adapter, currentCart);
+	return {
+		cart: currentCart,
+		isLoading: getCartQuery.isLoading,
+		isFetching: getCartQuery.isFetching,
+		refreshCart: getCartQuery.refetch,
+		...cartActions
+	};
+};
+//#endregion
+export { useCart };
+
+//# sourceMappingURL=useCart.mjs.map

package/dist/client/cart/hooks/useCart.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCart.mjs","names":[],"sources":["../../../../src/client/cart/hooks/useCart.tsx"],"sourcesContent":["import { useQuery } from \"@tanstack/react-query\";\nimport { CACHE_TAGS } from \"../../global/constants/tags\";\nimport { useCartAdapter } from \"../contexts/cart\";\nimport { useCartActions } from \"./useCartActions\";\n\n/**\n * Hook to manage cart state and actions.\n * Reads the cart adapter from CartProvider context,\n * provides the current cart, loading states, and mutation functions.\n */\nexport const useCart = () => {\n  const adapter = useCartAdapter();\n\n  const getCartQuery = useQuery({\n    queryKey: [CACHE_TAGS.cart],\n    queryFn: () => adapter.getCart(),\n    refetchOnMount: false,\n  });\n\n  const currentCart = getCartQuery.data;\n\n  const cartActions = useCartActions(adapter, currentCart);\n\n  return {\n    cart: currentCart,\n    isLoading: getCartQuery.isLoading,\n    isFetching: getCartQuery.isFetching,\n    refreshCart: getCartQuery.refetch,\n    ...cartActions,\n  };\n};\n"],"mappings":";;;;;;;;;;AAUA,MAAa,gBAAgB;CAC3B,MAAM,UAAU,gBAAgB;CAEhC,MAAM,eAAe,SAAS;EAC5B,UAAU,CAAC,WAAW,KAAK;EAC3B,eAAe,QAAQ,SAAS;EAChC,gBAAgB;EACjB,CAAC;CAEF,MAAM,cAAc,aAAa;CAEjC,MAAM,cAAc,eAAe,SAAS,YAAY;AAExD,QAAO;EACL,MAAM;EACN,WAAW,aAAa;EACxB,YAAY,aAAa;EACzB,aAAa,aAAa;EAC1B,GAAG;EACJ"}

package/dist/client/cart/hooks/useCartActions.d.ts

@@ -0,0 +1,30 @@
+import { Cart, CartAdapter } from "../types/adapter.js";
+import * as _tanstack_react_query0 from "@tanstack/react-query";
+
+//#region src/client/cart/hooks/useCartActions.d.ts
+/**
+ * Hook providing cart mutation actions: add, update, and remove items.
+ *
+ * Smart logic lives here (not in the adapter):
+ * - addItem checks for existing items and increments quantity instead of duplicating
+ * - updateItem removes the item if quantity drops to zero or below
+ */
+declare const useCartActions: (adapter: CartAdapter, currentCart: Cart | undefined) => {
+  addItem: _tanstack_react_query0.UseMutateAsyncFunction<Cart, Error, {
+    productVariantId: string;
+    quantity?: number;
+  }, unknown>;
+  updateItem: _tanstack_react_query0.UseMutateAsyncFunction<Cart, Error, {
+    itemId: string;
+    quantity: number;
+  }, unknown>;
+  removeItem: _tanstack_react_query0.UseMutateAsyncFunction<Cart, Error, {
+    itemId: string;
+  }, unknown>;
+  isAdding: boolean;
+  isUpdating: boolean;
+  isRemoving: boolean;
+};
+//#endregion
+export { useCartActions };
+//# sourceMappingURL=useCartActions.d.ts.map

package/dist/client/cart/hooks/useCartActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCartActions.d.ts","names":[],"sources":["../../../../src/client/cart/hooks/useCartActions.tsx"],"mappings":";;;;;;;AAWA;;;;cAAa,cAAA,GAAkB,OAAA,EAAS,WAAA,EAAa,WAAA,EAAa,IAAA"}

package/dist/client/cart/hooks/useCartActions.mjs

@@ -0,0 +1,50 @@
+import { CACHE_TAGS } from "../../global/constants/tags.mjs";
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+//#region src/client/cart/hooks/useCartActions.tsx
+/**
+* Hook providing cart mutation actions: add, update, and remove items.
+*
+* Smart logic lives here (not in the adapter):
+* - addItem checks for existing items and increments quantity instead of duplicating
+* - updateItem removes the item if quantity drops to zero or below
+*/
+const useCartActions = (adapter, currentCart) => {
+	const queryClient = useQueryClient();
+	const addItemMutation = useMutation({
+		mutationFn: async ({ productVariantId, quantity = 1 }) => {
+			const existingItem = currentCart?.items.find((i) => i.productVariantId === productVariantId);
+			if (existingItem) return adapter.updateItem(existingItem.id, existingItem.quantity + quantity);
+			return adapter.addItem(productVariantId, quantity);
+		},
+		onSuccess: (data) => {
+			queryClient.setQueryData([CACHE_TAGS.cart], data);
+		}
+	});
+	const updateItemMutation = useMutation({
+		mutationFn: async ({ itemId, quantity }) => {
+			if (quantity <= 0) return adapter.removeItem(itemId);
+			return adapter.updateItem(itemId, quantity);
+		},
+		onSuccess: (data) => {
+			queryClient.setQueryData([CACHE_TAGS.cart], data);
+		}
+	});
+	const removeItemMutation = useMutation({
+		mutationFn: async ({ itemId }) => adapter.removeItem(itemId),
+		onSuccess: (data) => {
+			queryClient.setQueryData([CACHE_TAGS.cart], data);
+		}
+	});
+	return {
+		addItem: addItemMutation.mutateAsync,
+		updateItem: updateItemMutation.mutateAsync,
+		removeItem: removeItemMutation.mutateAsync,
+		isAdding: addItemMutation.isPending,
+		isUpdating: updateItemMutation.isPending,
+		isRemoving: removeItemMutation.isPending
+	};
+};
+//#endregion
+export { useCartActions };
+
+//# sourceMappingURL=useCartActions.mjs.map

package/dist/client/cart/hooks/useCartActions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCartActions.mjs","names":[],"sources":["../../../../src/client/cart/hooks/useCartActions.tsx"],"sourcesContent":["import { useMutation, useQueryClient } from \"@tanstack/react-query\";\nimport { CACHE_TAGS } from \"../../global/constants/tags\";\nimport type { CartAdapter, Cart } from \"../types/adapter\";\n\n/**\n * Hook providing cart mutation actions: add, update, and remove items.\n *\n * Smart logic lives here (not in the adapter):\n * - addItem checks for existing items and increments quantity instead of duplicating\n * - updateItem removes the item if quantity drops to zero or below\n */\nexport const useCartActions = (adapter: CartAdapter, currentCart: Cart | undefined) => {\n  const queryClient = useQueryClient();\n\n  const addItemMutation = useMutation({\n    mutationFn: async ({\n      productVariantId,\n      quantity = 1,\n    }: {\n      productVariantId: string;\n      quantity?: number;\n    }) => {\n      const existingItem = currentCart?.items.find((i) => i.productVariantId === productVariantId);\n\n      // If we already have the item, increment quantity instead of adding a new one.\n      if (existingItem) {\n        return adapter.updateItem(existingItem.id, existingItem.quantity + quantity);\n      }\n      return adapter.addItem(productVariantId, quantity);\n    },\n    onSuccess: (data) => {\n      queryClient.setQueryData([CACHE_TAGS.cart], data);\n    },\n  });\n\n  const updateItemMutation = useMutation({\n    mutationFn: async ({ itemId, quantity }: { itemId: string; quantity: number }) => {\n      // If quantity is zero or less, remove the item\n      if (quantity <= 0) {\n        return adapter.removeItem(itemId);\n      }\n      return adapter.updateItem(itemId, quantity);\n    },\n    onSuccess: (data) => {\n      queryClient.setQueryData([CACHE_TAGS.cart], data);\n    },\n  });\n\n  const removeItemMutation = useMutation({\n    mutationFn: async ({ itemId }: { itemId: string }) => adapter.removeItem(itemId),\n    onSuccess: (data) => {\n      queryClient.setQueryData([CACHE_TAGS.cart], data);\n    },\n  });\n\n  return {\n    addItem: addItemMutation.mutateAsync,\n    updateItem: updateItemMutation.mutateAsync,\n    removeItem: removeItemMutation.mutateAsync,\n    isAdding: addItemMutation.isPending,\n    isUpdating: updateItemMutation.isPending,\n    isRemoving: removeItemMutation.isPending,\n  };\n};\n"],"mappings":";;;;;;;;;;AAWA,MAAa,kBAAkB,SAAsB,gBAAkC;CACrF,MAAM,cAAc,gBAAgB;CAEpC,MAAM,kBAAkB,YAAY;EAClC,YAAY,OAAO,EACjB,kBACA,WAAW,QAIP;GACJ,MAAM,eAAe,aAAa,MAAM,MAAM,MAAM,EAAE,qBAAqB,iBAAiB;AAG5F,OAAI,aACF,QAAO,QAAQ,WAAW,aAAa,IAAI,aAAa,WAAW,SAAS;AAE9E,UAAO,QAAQ,QAAQ,kBAAkB,SAAS;;EAEpD,YAAY,SAAS;AACnB,eAAY,aAAa,CAAC,WAAW,KAAK,EAAE,KAAK;;EAEpD,CAAC;CAEF,MAAM,qBAAqB,YAAY;EACrC,YAAY,OAAO,EAAE,QAAQ,eAAqD;AAEhF,OAAI,YAAY,EACd,QAAO,QAAQ,WAAW,OAAO;AAEnC,UAAO,QAAQ,WAAW,QAAQ,SAAS;;EAE7C,YAAY,SAAS;AACnB,eAAY,aAAa,CAAC,WAAW,KAAK,EAAE,KAAK;;EAEpD,CAAC;CAEF,MAAM,qBAAqB,YAAY;EACrC,YAAY,OAAO,EAAE,aAAiC,QAAQ,WAAW,OAAO;EAChF,YAAY,SAAS;AACnB,eAAY,aAAa,CAAC,WAAW,KAAK,EAAE,KAAK;;EAEpD,CAAC;AAEF,QAAO;EACL,SAAS,gBAAgB;EACzB,YAAY,mBAAmB;EAC/B,YAAY,mBAAmB;EAC/B,UAAU,gBAAgB;EAC1B,YAAY,mBAAmB;EAC/B,YAAY,mBAAmB;EAChC"}

package/dist/client/cart/index.d.ts

@@ -0,0 +1,8 @@
+import { Cart as Cart$1, CartAdapter, CartAdapterError, CartErrorCode, CartItem as CartItem$1, CartTotals, Money } from "./types/adapter.js";
+import { CartDrawer, CartDrawerProps } from "./components/cart-drawer.js";
+import { CartTrigger } from "./components/cart-trigger.js";
+import { PromoCodeInput, PromoCodeInputProps } from "./components/promo-code-input.js";
+import { CartProvider, CartProviderProps, useCartAdapter } from "./contexts/cart.js";
+import { Cart, CartItem, CartResponse } from "./types/cart.js";
+import { useCart } from "./hooks/useCart.js";
+export { type Cart as BrinkCart, type CartItem as BrinkCartItem, type Cart$1 as Cart, type CartAdapter, CartAdapterError, CartDrawer, type CartDrawerProps, type CartErrorCode, type CartItem$1 as CartItem, CartProvider, type CartProviderProps, type CartResponse, type CartTotals, CartTrigger, type Money, PromoCodeInput, type PromoCodeInputProps, useCart, useCartAdapter };

package/dist/client/cart/index.mjs

@@ -0,0 +1,7 @@
+import { CartAdapterError } from "./types/adapter.mjs";
+import { CartProvider, useCartAdapter } from "./contexts/cart.mjs";
+import { useCart } from "./hooks/useCart.mjs";
+import { CartDrawer } from "./components/cart-drawer.mjs";
+import { CartTrigger } from "./components/cart-trigger.mjs";
+import { PromoCodeInput } from "./components/promo-code-input.mjs";
+export { CartAdapterError, CartDrawer, CartProvider, CartTrigger, PromoCodeInput, useCart, useCartAdapter };

package/dist/client/cart/queries/addToCartQueryFn.d.ts

@@ -0,0 +1,14 @@
+import { BrinkConfig } from "../contexts/cart.js";
+import { CartResponse } from "../types/cart.js";
+
+//#region src/client/cart/queries/addToCartQueryFn.d.ts
+declare const addToCartQueryFn: (brinkConfig: BrinkConfig) => ({
+  productVariantId,
+  quantity
+}: {
+  productVariantId: string;
+  quantity?: number;
+}) => Promise<CartResponse>;
+//#endregion
+export { addToCartQueryFn };
+//# sourceMappingURL=addToCartQueryFn.d.ts.map

package/dist/client/cart/queries/addToCartQueryFn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addToCartQueryFn.d.ts","names":[],"sources":["../../../../src/client/cart/queries/addToCartQueryFn.tsx"],"mappings":";;;;cAKa,gBAAA,GAAoB,WAAA,EAAa,WAAA;EAG9B,gBAAA;EAAA;AAAA;EAIZ,gBAAA;EACA,QAAA;AAAA,MACE,OAAA,CAAQ,YAAA"}

package/dist/client/cart/queries/addToCartQueryFn.mjs

@@ -0,0 +1,28 @@
+import { CART_SESSION_KEY } from "../constants/session.mjs";
+import { getCartSession } from "../utils/session.mjs";
+//#region src/client/cart/queries/addToCartQueryFn.tsx
+const addToCartQueryFn = (brinkConfig) => {
+	const { env } = brinkConfig;
+	return async ({ productVariantId, quantity = 1 }) => {
+		const baseUrl = `https://shopper.eu-west-1.${env}.brinkcommerce.io`;
+		const res = await fetch(`${baseUrl}/shopper/sessions/items`, {
+			method: "POST",
+			headers: {
+				Authorization: `Bearer ${getCartSession()}`,
+				"Content-Type": "application/json"
+			},
+			body: JSON.stringify({
+				productVariantId,
+				quantity
+			})
+		});
+		if (!res.ok) throw new Error("Failed to add item to cart");
+		const data = await res.json();
+		localStorage.setItem(CART_SESSION_KEY, data.token);
+		return data;
+	};
+};
+//#endregion
+export { addToCartQueryFn };
+
+//# sourceMappingURL=addToCartQueryFn.mjs.map

package/dist/client/cart/queries/addToCartQueryFn.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"addToCartQueryFn.mjs","names":[],"sources":["../../../../src/client/cart/queries/addToCartQueryFn.tsx"],"sourcesContent":["import { type BrinkConfig } from \"../contexts/cart\"\nimport { CART_SESSION_KEY } from \"../constants/session\"\nimport { getCartSession } from \"../utils/session\"\nimport { type CartResponse } from \"../types/cart\"\n\nexport const addToCartQueryFn = (brinkConfig: BrinkConfig) => {\n  const { env } = brinkConfig\n\n  return async ({\n    productVariantId,\n    quantity = 1,\n  }: {\n    productVariantId: string\n    quantity?: number\n  }): Promise<CartResponse> => {\n    const baseUrl = `https://shopper.eu-west-1.${env}.brinkcommerce.io`\n\n    const res = await fetch(`${baseUrl}/shopper/sessions/items`, {\n      method: \"POST\",\n      headers: {\n        Authorization: `Bearer ${getCartSession()}`,\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify({ productVariantId, quantity }),\n    })\n\n    if (!res.ok) throw new Error(\"Failed to add item to cart\")\n\n    const data = (await res.json()) as CartResponse\n    localStorage.setItem(CART_SESSION_KEY, data.token)\n\n    return data\n  }\n}\n"],"mappings":";;;AAKA,MAAa,oBAAoB,gBAA6B;CAC5D,MAAM,EAAE,QAAQ;AAEhB,QAAO,OAAO,EACZ,kBACA,WAAW,QAIgB;EAC3B,MAAM,UAAU,6BAA6B,IAAI;EAEjD,MAAM,MAAM,MAAM,MAAM,GAAG,QAAQ,0BAA0B;GAC3D,QAAQ;GACR,SAAS;IACP,eAAe,UAAU,gBAAgB;IACzC,gBAAgB;IACjB;GACD,MAAM,KAAK,UAAU;IAAE;IAAkB;IAAU,CAAC;GACrD,CAAC;AAEF,MAAI,CAAC,IAAI,GAAI,OAAM,IAAI,MAAM,6BAA6B;EAE1D,MAAM,OAAQ,MAAM,IAAI,MAAM;AAC9B,eAAa,QAAQ,kBAAkB,KAAK,MAAM;AAElD,SAAO"}

package/dist/client/cart/queries/getCartQueryFn.d.ts

@@ -0,0 +1,8 @@
+import { BrinkConfig } from "../contexts/cart.js";
+import { CartResponse } from "../types/cart.js";
+
+//#region src/client/cart/queries/getCartQueryFn.d.ts
+declare const getCartQueryFn: (brinkConfig: BrinkConfig) => () => Promise<CartResponse>;
+//#endregion
+export { getCartQueryFn };
+//# sourceMappingURL=getCartQueryFn.d.ts.map

package/dist/client/cart/queries/getCartQueryFn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCartQueryFn.d.ts","names":[],"sources":["../../../../src/client/cart/queries/getCartQueryFn.tsx"],"mappings":";;;;cAIa,cAAA,GAAkB,WAAA,EAAa,WAAA,WAGzB,OAAA,CAAQ,YAAA"}

package/dist/client/cart/queries/getCartQueryFn.mjs

@@ -0,0 +1,37 @@
+import { clearCartSession, getCartSession, hasCartSession, setCartSession } from "../utils/session.mjs";
+//#region src/client/cart/queries/getCartQueryFn.tsx
+const getCartQueryFn = (brinkConfig) => {
+	const { env, storeGroupId, countryCode, languageCode } = brinkConfig;
+	return async () => {
+		const baseUrl = `https://shopper.eu-west-1.${env}.brinkcommerce.io`;
+		const existingToken = hasCartSession() ? getCartSession() : null;
+		if (existingToken) {
+			const res = await fetch(`${baseUrl}/shopper/sessions`, {
+				headers: {
+					Authorization: `Bearer ${existingToken}`,
+					"Content-Type": "application/json"
+				},
+				cache: "no-store"
+			});
+			if (res.ok) return await res.json();
+			clearCartSession();
+		}
+		const res = await fetch(`${baseUrl}/shopper/sessions/start`, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({
+				storeGroupId,
+				countryCode,
+				languageCode
+			})
+		});
+		if (!res.ok) throw new Error("Failed to start shopper session");
+		const data = await res.json();
+		setCartSession(data.token);
+		return data;
+	};
+};
+//#endregion
+export { getCartQueryFn };
+
+//# sourceMappingURL=getCartQueryFn.mjs.map

package/dist/client/cart/queries/getCartQueryFn.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCartQueryFn.mjs","names":[],"sources":["../../../../src/client/cart/queries/getCartQueryFn.tsx"],"sourcesContent":["import { type BrinkConfig } from \"../contexts/cart\"\nimport { type CartResponse } from \"../types/cart\"\nimport { clearCartSession, getCartSession, hasCartSession, setCartSession } from \"../utils/session\"\n\nexport const getCartQueryFn = (brinkConfig: BrinkConfig) => {\n  const { env, storeGroupId, countryCode, languageCode } = brinkConfig\n\n  return async (): Promise<CartResponse> => {\n    const baseUrl = `https://shopper.eu-west-1.${env}.brinkcommerce.io`\n\n    const existingToken = hasCartSession() ? getCartSession() : null\n\n    if (existingToken) {\n      const res = await fetch(`${baseUrl}/shopper/sessions`, {\n        headers: {\n          Authorization: `Bearer ${existingToken}`,\n          \"Content-Type\": \"application/json\",\n        },\n        cache: \"no-store\",\n      })\n\n      if (res.ok) {\n        return (await res.json()) as CartResponse\n      }\n\n      clearCartSession()\n    }\n\n    const res = await fetch(`${baseUrl}/shopper/sessions/start`, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({ storeGroupId, countryCode, languageCode }),\n    })\n\n    if (!res.ok) throw new Error(\"Failed to start shopper session\")\n\n    const data = (await res.json()) as CartResponse\n\n    setCartSession(data.token)\n\n    return data\n  }\n}\n"],"mappings":";;AAIA,MAAa,kBAAkB,gBAA6B;CAC1D,MAAM,EAAE,KAAK,cAAc,aAAa,iBAAiB;AAEzD,QAAO,YAAmC;EACxC,MAAM,UAAU,6BAA6B,IAAI;EAEjD,MAAM,gBAAgB,gBAAgB,GAAG,gBAAgB,GAAG;AAE5D,MAAI,eAAe;GACjB,MAAM,MAAM,MAAM,MAAM,GAAG,QAAQ,oBAAoB;IACrD,SAAS;KACP,eAAe,UAAU;KACzB,gBAAgB;KACjB;IACD,OAAO;IACR,CAAC;AAEF,OAAI,IAAI,GACN,QAAQ,MAAM,IAAI,MAAM;AAG1B,qBAAkB;;EAGpB,MAAM,MAAM,MAAM,MAAM,GAAG,QAAQ,0BAA0B;GAC3D,QAAQ;GACR,SAAS,EAAE,gBAAgB,oBAAoB;GAC/C,MAAM,KAAK,UAAU;IAAE;IAAc;IAAa;IAAc,CAAC;GAClE,CAAC;AAEF,MAAI,CAAC,IAAI,GAAI,OAAM,IAAI,MAAM,kCAAkC;EAE/D,MAAM,OAAQ,MAAM,IAAI,MAAM;AAE9B,iBAAe,KAAK,MAAM;AAE1B,SAAO"}

package/dist/client/cart/queries/removeCartItemQueryFn.d.ts

@@ -0,0 +1,12 @@
+import { BrinkConfig } from "../contexts/cart.js";
+import { CartResponse } from "../types/cart.js";
+
+//#region src/client/cart/queries/removeCartItemQueryFn.d.ts
+declare const removeCartItemQueryFn: (brinkConfig: BrinkConfig) => ({
+  itemId
+}: {
+  itemId: string;
+}) => Promise<CartResponse>;
+//#endregion
+export { removeCartItemQueryFn };
+//# sourceMappingURL=removeCartItemQueryFn.d.ts.map

package/dist/client/cart/queries/removeCartItemQueryFn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeCartItemQueryFn.d.ts","names":[],"sources":["../../../../src/client/cart/queries/removeCartItemQueryFn.tsx"],"mappings":";;;;cAIa,qBAAA,GAAyB,WAAA,EAAa,WAAA;EAGnC;AAAA;EAAc,MAAA;AAAA,MAAmB,OAAA,CAAQ,YAAA"}

package/dist/client/cart/queries/removeCartItemQueryFn.mjs

@@ -0,0 +1,23 @@
+import { getCartSession, setCartSession } from "../utils/session.mjs";
+//#region src/client/cart/queries/removeCartItemQueryFn.tsx
+const removeCartItemQueryFn = (brinkConfig) => {
+	const { env } = brinkConfig;
+	return async ({ itemId }) => {
+		const baseUrl = `https://shopper.eu-west-1.${env}.brinkcommerce.io`;
+		const res = await fetch(`${baseUrl}/shopper/sessions/items/${itemId}`, {
+			method: "DELETE",
+			headers: { Authorization: `Bearer ${getCartSession()}` }
+		});
+		if (!res.ok) {
+			const errorText = await res.text();
+			throw new Error(`Failed to remove cart item: ${errorText}`);
+		}
+		const data = await res.json();
+		setCartSession(data.token);
+		return data;
+	};
+};
+//#endregion
+export { removeCartItemQueryFn };
+
+//# sourceMappingURL=removeCartItemQueryFn.mjs.map

package/dist/client/cart/queries/removeCartItemQueryFn.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeCartItemQueryFn.mjs","names":[],"sources":["../../../../src/client/cart/queries/removeCartItemQueryFn.tsx"],"sourcesContent":["import { type BrinkConfig } from \"../contexts/cart\"\nimport { type CartResponse } from \"../types/cart\"\nimport { getCartSession, setCartSession } from \"../utils/session\"\n\nexport const removeCartItemQueryFn = (brinkConfig: BrinkConfig) => {\n  const { env } = brinkConfig\n\n  return async ({ itemId }: { itemId: string }): Promise<CartResponse> => {\n    const baseUrl = `https://shopper.eu-west-1.${env}.brinkcommerce.io`\n\n    const res = await fetch(`${baseUrl}/shopper/sessions/items/${itemId}`, {\n      method: \"DELETE\",\n      headers: {\n        Authorization: `Bearer ${getCartSession()}`,\n      },\n    })\n\n    if (!res.ok) {\n      const errorText = await res.text()\n      throw new Error(`Failed to remove cart item: ${errorText}`)\n    }\n\n    const data = (await res.json()) as CartResponse\n\n    // Update token in localStorage if it changed\n    setCartSession(data.token)\n\n    return data\n  }\n}\n"],"mappings":";;AAIA,MAAa,yBAAyB,gBAA6B;CACjE,MAAM,EAAE,QAAQ;AAEhB,QAAO,OAAO,EAAE,aAAwD;EACtE,MAAM,UAAU,6BAA6B,IAAI;EAEjD,MAAM,MAAM,MAAM,MAAM,GAAG,QAAQ,0BAA0B,UAAU;GACrE,QAAQ;GACR,SAAS,EACP,eAAe,UAAU,gBAAgB,IAC1C;GACF,CAAC;AAEF,MAAI,CAAC,IAAI,IAAI;GACX,MAAM,YAAY,MAAM,IAAI,MAAM;AAClC,SAAM,IAAI,MAAM,+BAA+B,YAAY;;EAG7D,MAAM,OAAQ,MAAM,IAAI,MAAM;AAG9B,iBAAe,KAAK,MAAM;AAE1B,SAAO"}

package/dist/client/cart/queries/updateCartItemQueryFn.d.ts

@@ -0,0 +1,14 @@
+import { BrinkConfig } from "../contexts/cart.js";
+import { CartResponse } from "../types/cart.js";
+
+//#region src/client/cart/queries/updateCartItemQueryFn.d.ts
+declare const updateCartItemFn: (brinkConfig: BrinkConfig) => ({
+  itemId,
+  quantity
+}: {
+  itemId: string;
+  quantity: number;
+}) => Promise<CartResponse>;
+//#endregion
+export { updateCartItemFn };
+//# sourceMappingURL=updateCartItemQueryFn.d.ts.map

package/dist/client/cart/queries/updateCartItemQueryFn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateCartItemQueryFn.d.ts","names":[],"sources":["../../../../src/client/cart/queries/updateCartItemQueryFn.tsx"],"mappings":";;;;cAKa,gBAAA,GAAoB,WAAA,EAAa,WAAA;EAG9B,MAAA;EAAA;AAAA;EAIZ,MAAA;EACA,QAAA;AAAA,MACE,OAAA,CAAQ,YAAA"}

package/dist/client/cart/queries/updateCartItemQueryFn.mjs

@@ -0,0 +1,25 @@
+import { CART_SESSION_KEY } from "../constants/session.mjs";
+import { getCartSession } from "../utils/session.mjs";
+//#region src/client/cart/queries/updateCartItemQueryFn.tsx
+const updateCartItemFn = (brinkConfig) => {
+	const { env } = brinkConfig;
+	return async ({ itemId, quantity }) => {
+		const baseUrl = `https://shopper.eu-west-1.${env}.brinkcommerce.io`;
+		const res = await fetch(`${baseUrl}/shopper/sessions/items/${itemId}`, {
+			method: "PUT",
+			headers: {
+				Authorization: `Bearer ${getCartSession()}`,
+				"Content-Type": "application/json"
+			},
+			body: JSON.stringify({ quantity })
+		});
+		if (!res.ok) throw new Error("Failed to update cart item");
+		const data = await res.json();
+		localStorage.setItem(CART_SESSION_KEY, data.token);
+		return data;
+	};
+};
+//#endregion
+export { updateCartItemFn };
+
+//# sourceMappingURL=updateCartItemQueryFn.mjs.map

package/dist/client/cart/queries/updateCartItemQueryFn.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateCartItemQueryFn.mjs","names":[],"sources":["../../../../src/client/cart/queries/updateCartItemQueryFn.tsx"],"sourcesContent":["import { type BrinkConfig } from \"../contexts/cart\"\nimport { CART_SESSION_KEY } from \"../constants/session\"\nimport { getCartSession } from \"../utils/session\"\nimport { type CartResponse } from \"../types/cart\"\n\nexport const updateCartItemFn = (brinkConfig: BrinkConfig) => {\n  const { env } = brinkConfig\n\n  return async ({\n    itemId,\n    quantity,\n  }: {\n    itemId: string\n    quantity: number\n  }): Promise<CartResponse> => {\n    const baseUrl = `https://shopper.eu-west-1.${env}.brinkcommerce.io`\n\n    const res = await fetch(`${baseUrl}/shopper/sessions/items/${itemId}`, {\n      method: \"PUT\",\n      headers: {\n        Authorization: `Bearer ${getCartSession()}`,\n        \"Content-Type\": \"application/json\",\n      },\n      body: JSON.stringify({ quantity }),\n    })\n\n    if (!res.ok) throw new Error(\"Failed to update cart item\")\n\n    const data = (await res.json()) as CartResponse\n    localStorage.setItem(CART_SESSION_KEY, data.token)\n\n    return data\n  }\n}\n"],"mappings":";;;AAKA,MAAa,oBAAoB,gBAA6B;CAC5D,MAAM,EAAE,QAAQ;AAEhB,QAAO,OAAO,EACZ,QACA,eAI2B;EAC3B,MAAM,UAAU,6BAA6B,IAAI;EAEjD,MAAM,MAAM,MAAM,MAAM,GAAG,QAAQ,0BAA0B,UAAU;GACrE,QAAQ;GACR,SAAS;IACP,eAAe,UAAU,gBAAgB;IACzC,gBAAgB;IACjB;GACD,MAAM,KAAK,UAAU,EAAE,UAAU,CAAC;GACnC,CAAC;AAEF,MAAI,CAAC,IAAI,GAAI,OAAM,IAAI,MAAM,6BAA6B;EAE1D,MAAM,OAAQ,MAAM,IAAI,MAAM;AAC9B,eAAa,QAAQ,kBAAkB,KAAK,MAAM;AAElD,SAAO"}

package/dist/client/cart/types/adapter.d.ts

@@ -0,0 +1,113 @@
+//#region src/client/cart/types/adapter.d.ts
+/**
+ * Normalized cart types for the adapter interface.
+ *
+ * These are SDK-owned types that all adapters must map their backend
+ * responses into. Backend-specific fields go in `backendMeta`.
+ */
+/** Amount in minor currency units (e.g. cents). */
+interface Money {
+  /** Integer amount in the smallest currency unit (e.g. 1299 = $12.99). */
+  amount: number;
+  /** ISO 4217 currency code (e.g. "SEK", "USD", "EUR"). */
+  currencyCode: string;
+}
+interface CartItem {
+  /** Opaque line-item ID from the backend. Stable within a session. */
+  id: string;
+  /** Product variant identifier. */
+  productVariantId: string;
+  /** SKU — the universal product identifier across backends. */
+  sku?: string;
+  /** Display name shown to the customer. */
+  displayName: string;
+  /** Current unit price (after any discounts applied at line level). */
+  unitPrice: Money;
+  /** Original list price before discounts, if different from unitPrice. */
+  listPrice?: Money;
+  /** Line-level discount amount, if the backend provides it. */
+  discount?: Money;
+  /** Line-level tax amount, if the backend provides it. */
+  tax?: Money;
+  /** Quantity of this item in the cart. */
+  quantity: number;
+  /** Product image URL. */
+  imageUrl?: string;
+  /** Human-readable variant label (e.g. "Red / XL"). */
+  variantLabel?: string;
+  /** Slug or path for linking to the product page. */
+  productSlug?: string;
+  /** Whether this item requires shipping. */
+  requiresShipping?: boolean;
+  /**
+   * Arbitrary backend-specific metadata.
+   * SDK core never reads this — adapters and consumers can use it freely.
+   */
+  backendMeta?: Record<string, unknown>;
+}
+interface CartTotals {
+  subtotal: Money;
+  tax: Money;
+  discount: Money;
+  total: Money;
+}
+interface Cart {
+  id: string;
+  /** ISO 3166-1 alpha-2 country code (e.g. "SE", "US"). */
+  countryCode: string;
+  /** ISO 4217 currency code — also carried on Money values for convenience. */
+  currencyCode: string;
+  /** BCP 47 language code (e.g. "en", "sv"). */
+  languageCode: string;
+  /** Whether prices include tax (common in EU). */
+  taxIncludedInPrice: boolean;
+  /** Applied discount codes. */
+  discountCodes: string[];
+  items: CartItem[];
+  totals: CartTotals;
+  /** ISO 8601 timestamps, if the backend provides them. */
+  createdAt?: string;
+  updatedAt?: string;
+  /** Backend-specific metadata (e.g. Brink revision, Shopify GID). */
+  backendMeta?: Record<string, unknown>;
+}
+type CartErrorCode = "ITEM_NOT_FOUND" | "INSUFFICIENT_STOCK" | "DISCOUNT_INVALID" | "DISCOUNT_NOT_STACKABLE" | "SESSION_EXPIRED" | "PRICE_CHANGED" | "NETWORK_ERROR" | "UNKNOWN";
+declare class CartAdapterError extends Error {
+  code: CartErrorCode;
+  constructor(code: CartErrorCode, message: string);
+}
+/**
+ * The contract that every cart backend must implement.
+ *
+ * Adapters own session management internally — the SDK never touches
+ * tokens, cookies, or storage directly.
+ *
+ * All methods return normalized Cart objects. The adapter is responsible
+ * for mapping backend responses into the SDK-owned types above.
+ */
+interface CartAdapter {
+  /**
+   * Get the current cart, or create a new session if none exists.
+   * Called by useCart's React Query query function.
+   */
+  getCart(): Promise<Cart>;
+  /**
+   * Add an item to the cart.
+   * The SDK may call this after checking for existing items (dedup logic
+   * in useCartActions), but the adapter should not assume this.
+   */
+  addItem(productVariantId: string, quantity: number): Promise<Cart>;
+  /**
+   * Update the quantity of an existing cart line item.
+   * @param itemId - The opaque line-item ID from CartItem.id
+   */
+  updateItem(itemId: string, quantity: number): Promise<Cart>;
+  /**
+   * Remove an item from the cart.
+   * @param itemId - The opaque line-item ID from CartItem.id
+   */
+  removeItem(itemId: string): Promise<Cart>;
+}
+//#endregion
+export { Cart, CartAdapter, CartAdapterError, CartErrorCode, CartItem, CartTotals, Money };
+//# sourceMappingURL=adapter.d.ts.map

package/dist/client/cart/types/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","names":[],"sources":["../../../../src/client/cart/types/adapter.ts"],"mappings":";;AAYA;;;;;AAWA;AAAA,UAXiB,KAAA;;EAEf,MAAA;EAqBY;EAnBZ,YAAA;AAAA;AAAA,UAOe,QAAA;EA+BK;EA7BpB,EAAA;EAAA;EAEA,gBAAA;EAEA;EAAA,GAAA;EAIA;EAFA,WAAA;EAIA;EAFA,SAAA,EAAW,KAAA;EAIX;EAFA,SAAA,GAAY,KAAA;EAIZ;EAFA,QAAA,GAAW,KAAA;EAIX;EAFA,GAAA,GAAM,KAAA;EAMN;EAJA,QAAA;EAQA;EANA,QAAA;EAWc;EATd,YAAA;EASoB;EAPpB,WAAA;EAcyB;EAZzB,gBAAA;EAaU;;;;EARV,WAAA,GAAc,MAAA;AAAA;AAAA,UAOC,UAAA;EACf,QAAA,EAAU,KAAA;EACV,GAAA,EAAK,KAAA;EACL,QAAA,EAAU,KAAA;EACV,KAAA,EAAO,KAAA;AAAA;AAAA,UAOQ,IAAA;EACf,EAAA;EARY;EAUZ,WAAA;EAHe;EAKf,YAAA;;EAEA,YAAA;EAMQ;EAJR,kBAAA;EASoB;EAPpB,aAAA;EACA,KAAA,EAAO,QAAA;EACP,MAAA,EAAQ,UAAA;EARR;EAUA,SAAA;EACA,SAAA;EALA;EAOA,WAAA,GAAc,MAAA;AAAA;AAAA,KAOJ,aAAA;AAAA,cAUC,gBAAA,SAAyB,KAAA;EACpC,IAAA,EAAM,aAAA;cACM,IAAA,EAAM,aAAA,EAAe,OAAA;AAAA;;;;AAZnC;;;;;AAUA;UAsBiB,WAAA;;;;;EAKf,OAAA,IAAW,OAAA,CAAQ,IAAA;EA3BsB;;;;;EAkCzC,OAAA,CAAQ,gBAAA,UAA0B,QAAA,WAAmB,OAAA,CAAQ,IAAA;EAhCjD;;;;EAsCZ,UAAA,CAAW,MAAA,UAAgB,QAAA,WAAmB,OAAA,CAAQ,IAAA;EAlB5B;;;;EAwB1B,UAAA,CAAW,MAAA,WAAiB,OAAA,CAAQ,IAAA;AAAA"}

package/dist/client/cart/types/adapter.mjs

@@ -0,0 +1,13 @@
+//#region src/client/cart/types/adapter.ts
+var CartAdapterError = class extends Error {
+	code;
+	constructor(code, message) {
+		super(message);
+		this.name = "CartAdapterError";
+		this.code = code;
+	}
+};
+//#endregion
+export { CartAdapterError };
+
+//# sourceMappingURL=adapter.mjs.map