@enadhq/enad-react-sdk 1.0.0 → 1.1.0

package/README.md

@@ -0,0 +1,305 @@
+# @enadhq/enad-react-sdk
+
+Composable storefront UI components for building e-commerce experiences with React 19 and Next.js 16. Part of the [Enad](https://enad.io) unified commerce platform.
+
+## Install
+
+```bash
+npm install @enadhq/enad-react-sdk
+# or
+pnpm add @enadhq/enad-react-sdk
+```
+
+### Peer dependencies
+
+You need these in your project:
+
+- `react` >= 19
+- `react-dom` >= 19
+- `next` >= 16
+- `@tanstack/react-query` >= 5
+
+## Setup
+
+### 1. Import the stylesheet
+
+Add the SDK stylesheet to your app's root layout:
+
+```tsx
+import "@enadhq/enad-react-sdk/styles.css";
+```
+
+### 2. Wrap your app with `EnadProvider`
+
+`EnadProvider` sets up React Query, the icon system, and the component resolver. Place it at the root of your component tree.
+
+```tsx
+import { EnadProvider } from "@enadhq/enad-react-sdk/client/global";
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return <EnadProvider>{children}</EnadProvider>;
+}
+```
+
+#### Provider options
+
+| Prop                 | Type                 | Default         | Description                                                                            |
+| -------------------- | -------------------- | --------------- | -------------------------------------------------------------------------------------- |
+| `cartAdapter`        | `CartAdapter`        | —               | Cart backend adapter (see [Cart adapters](#cart-adapters) below)                       |
+| `brink`              | `BrinkConfig`        | —               | **Deprecated.** Use `cartAdapter` with `createBrinkCartAdapter()` instead              |
+| `icons`              | `IconSlotMap`        | `phosphorIcons` | Icon set to use. Ships with `phosphorIcons`, `lucideIcons`, and `hugeIcons` adapters   |
+| `componentSet`       | `ComponentSet`       | `"default"`     | Base UI component set. Options: `"brutalist"`, `"editorial"`, `"organic"`, `"minimal"` |
+| `componentOverrides` | `ComponentOverrides` | —               | Override the component set for specific components                                     |
+
+#### Cart adapters
+
+The SDK uses a pluggable adapter pattern for the cart backend. Pass any object that implements the `CartAdapter` interface. The Brink Commerce adapter ships as a separate entry point:
+
+```tsx
+import { EnadProvider } from "@enadhq/enad-react-sdk/client/global";
+import { createBrinkCartAdapter } from "@enadhq/enad-react-sdk/client/cart/brink-adapter";
+
+const cartAdapter = createBrinkCartAdapter({
+  env: "production",
+  storeGroupId: "sg-123",
+  countryCode: "SE",
+  languageCode: "sv",
+});
+
+<EnadProvider cartAdapter={cartAdapter}>{children}</EnadProvider>;
+```
+
+A mock adapter is also available for development and testing:
+
+```tsx
+import { createMockCartAdapter } from "@enadhq/enad-react-sdk/client/cart/mock-adapter";
+
+const cartAdapter = createMockCartAdapter({ delay: 200 });
+```
+
+To write your own adapter for a different backend (Centra, Shopify, a custom API), implement the `CartAdapter` interface from `client/cart`:
+
+```ts
+import type { CartAdapter } from "@enadhq/enad-react-sdk/client/cart";
+
+const myAdapter: CartAdapter = {
+  getCart: () => {
+    /* ... */
+  },
+  addItem: (productVariantId, quantity) => {
+    /* ... */
+  },
+  updateItem: (itemId, quantity) => {
+    /* ... */
+  },
+  removeItem: (itemId) => {
+    /* ... */
+  },
+};
+```
+
+All adapter methods return a normalized `Cart` object. The adapter owns session management internally.
+
+#### Switching icon sets
+
+```tsx
+import { EnadProvider } from "@enadhq/enad-react-sdk/client/global";
+import { lucideIcons } from "@enadhq/enad-react-sdk/client/icons";
+
+<EnadProvider icons={lucideIcons}>{children}</EnadProvider>;
+```
+
+## Package exports
+
+The SDK is split into focused entry points for tree-shaking. Import from the specific module you need.
+
+### `client/global`
+
+Provider setup and top-level utilities.
+
+```tsx
+import { EnadProvider, ErrorBoundary } from "@enadhq/enad-react-sdk/client/global";
+```
+
+### `client/storefront`
+
+Storefront UI components: prices, badges, ratings, variant selectors, product tabs, navigation, newsletter signup, language/country selectors, and more.
+
+```tsx
+import {
+  Price,
+  Badge,
+  StarRating,
+  VariantSelector,
+  ProductTabs,
+} from "@enadhq/enad-react-sdk/client/storefront";
+```
+
+### `client/cart`
+
+Cart components, hooks, adapter interface, and normalized types.
+
+```tsx
+import { CartDrawer, CartTrigger, useCart } from "@enadhq/enad-react-sdk/client/cart";
+import type { CartAdapter, Cart, CartItem, Money } from "@enadhq/enad-react-sdk/client/cart";
+```
+
+### `client/cart/brink-adapter`
+
+Brink Commerce adapter. Separate entry point for tree-shaking.
+
+```tsx
+import { createBrinkCartAdapter } from "@enadhq/enad-react-sdk/client/cart/brink-adapter";
+```
+
+### `client/cart/mock-adapter`
+
+In-memory mock adapter for development and testing.
+
+```tsx
+import { createMockCartAdapter } from "@enadhq/enad-react-sdk/client/cart/mock-adapter";
+```
+
+### `client/search`
+
+Search functionality with the `useSearch` hook.
+
+```tsx
+import { useSearch } from "@enadhq/enad-react-sdk/client/search";
+```
+
+### `client/icons`
+
+Pluggable icon system with adapters for Phosphor, Lucide, and Hugeicons.
+
+```tsx
+import {
+  Icon,
+  useIcon,
+  phosphorIcons,
+  lucideIcons,
+  hugeIcons,
+} from "@enadhq/enad-react-sdk/client/icons";
+```
+
+### `client/theme`
+
+Theme codec for encoding/decoding theme hashes, CSS generation, conflict scanning, and default token values.
+
+```tsx
+import {
+  encodeThemeHash,
+  decodeThemeHash,
+  generateThemeCSS,
+  SDK_DEFAULTS,
+} from "@enadhq/enad-react-sdk/client/theme";
+```
+
+The package also ships an `enad-theme` CLI for theme operations:
+
+```bash
+npx enad-theme --help
+```
+
+### `client/user`
+
+User account context and hooks.
+
+### `client/wishlist`
+
+Wishlist state management.
+
+### `client/ui-interfaces`
+
+TypeScript interfaces for the component system.
+
+### `client/ui-resolver`
+
+Component resolver that maps abstract component names to concrete implementations.
+
+## Component overview
+
+### Blocks
+
+Content blocks for building storefront pages:
+
+- `Hero`, `Gallery`, `GalleryWithCaption`, `GalleryWithLinkBlocks`
+- `TextContent`, `VariableTextContent`, `TextContentWithImage`, `ContentWithImageProductData`
+- `ProductCard`, `ProductImage`, `LinkBlock`, `LinkBlockSmall`
+- `ImageBlock`, `CardImageWithCaption`, `CardVideo`
+- `AccordionBlock`, `Spacer`, `TruncatedText`
+
+### Primitives
+
+Low-level UI elements that other components build on:
+
+- `Button`, `Input`, `Select`, `Checkbox`
+- `Breadcrumbs`, `Pagination`, `TextLink`
+- `QuickLinks`, `DownloadItem`
+
+### Product
+
+Product-specific components:
+
+- `ColorSwatch`, `MaterialSelector`, `QuantityPicker`, `ProductUSP`
+
+### Carousel
+
+- `SwipeableCarousel` — touch-friendly carousel built on Embla
+
+### Layout
+
+- `Header`, `Footer`, `PromotionBar`, `MobileMenuDrawer`
+
+### Filters
+
+- `FilterPanel`, `FilterGroup`, `FilterChip`, `SortSelect`, `ToggleListView`
+
+### Checkout
+
+Checkout flow components (in development).
+
+## Theming
+
+The SDK uses CSS custom properties for all visual tokens (colors, radii, spacing). You own your brand palette — the SDK owns the interaction quality and structural patterns.
+
+Themes are applied through CSS variables. Use the `enad-theme` CLI or the `generateThemeCSS` function to produce a theme stylesheet from a configuration object.
+
+Light and dark modes are both first-class. The SDK respects `prefers-color-scheme` and supports explicit mode toggling.
+
+## Built with
+
+- [Tailwind CSS v4](https://tailwindcss.com) — utility-first styling
+- [Radix UI](https://radix-ui.com) — accessible primitives (dialogs, popovers, accordions)
+- [Embla Carousel](https://www.embla-carousel.com) — lightweight carousel engine
+- [React Query](https://tanstack.com/query) — data fetching and cache management
+- [react-hook-form](https://react-hook-form.com) + [Zod](https://zod.dev) — form handling and validation
+- [class-variance-authority](https://cva.style) — variant-driven component styles
+
+## Development
+
+From the monorepo root:
+
+```bash
+# Build the SDK (ESM via tsup, types via tsc, styles via tailwindcss)
+pnpm build --filter=@enadhq/enad-react-sdk
+
+# Watch mode — rebuilds on file changes
+pnpm dev --filter=@enadhq/enad-react-sdk
+
+# Type check
+pnpm check-types --filter=@enadhq/enad-react-sdk
+
+# Lint
+pnpm lint --filter=@enadhq/enad-react-sdk
+```
+
+The build has three stages:
+
+1. **tsup** — bundles TypeScript to ESM (`dist/*.mjs`)
+2. **tsc** — generates declaration files (`dist/*.d.ts`)
+3. **tailwindcss** — compiles `src/styles.css` to `dist/styles.css`
+
+## License
+
+MIT

package/dist/client/_virtual/_rolldown/runtime.mjs

@@ -0,0 +1,6 @@
+import { createRequire } from "node:module";
+//#region \0rolldown/runtime.js
+var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+//#endregion
+export { __commonJSMin, __require };

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

@@ -0,0 +1,3 @@
+import { NextCookieAdapter } from "./next-cookie-adapter.js";
+import { NextNavigationAdapter } from "./next-navigation-adapter.js";
+export { NextCookieAdapter, NextNavigationAdapter };

package/dist/client/adapters/index.mjs

@@ -0,0 +1,3 @@
+import { NextCookieAdapter } from "./next-cookie-adapter.mjs";
+import { NextNavigationAdapter } from "./next-navigation-adapter.mjs";
+export { NextCookieAdapter, NextNavigationAdapter };

package/dist/client/adapters/next-cookie-adapter.d.ts

@@ -0,0 +1,18 @@
+import { CookieAdapter, CookieOptions } from "../global/auth/cookie-adapter.js";
+
+//#region src/client/adapters/next-cookie-adapter.d.ts
+/**
+ * CookieAdapter implementation for Next.js.
+ * Wraps the `cookies()` function from `next/headers`.
+ *
+ * Each method call invokes `cookies()` to get the current request's
+ * cookie store, so the adapter is safe to reuse across requests.
+ */
+declare class NextCookieAdapter implements CookieAdapter {
+  get(name: string): Promise<string | undefined>;
+  set(name: string, value: string, options?: CookieOptions): Promise<void>;
+  delete(name: string): Promise<void>;
+}
+//#endregion
+export { NextCookieAdapter };
+//# sourceMappingURL=next-cookie-adapter.d.ts.map

package/dist/client/adapters/next-cookie-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-cookie-adapter.d.ts","names":[],"sources":["../../../src/client/adapters/next-cookie-adapter.ts"],"mappings":";;;;;AAUA;;;;;cAAa,iBAAA,YAA6B,aAAA;EAClC,GAAA,CAAI,IAAA,WAAe,OAAA;EAKnB,GAAA,CAAI,IAAA,UAAc,KAAA,UAAe,OAAA,GAAU,aAAA,GAAgB,OAAA;EAK3D,MAAA,CAAO,IAAA,WAAe,OAAA;AAAA"}

package/dist/client/adapters/next-cookie-adapter.mjs

@@ -0,0 +1,25 @@
+import { require_headers } from "../node_modules/.pnpm/next@16.0.1_react-dom@19.2.0_react@19.2.0__react@19.2.0/node_modules/next/headers.mjs";
+//#region src/client/adapters/next-cookie-adapter.ts
+var import_headers = require_headers();
+/**
+* CookieAdapter implementation for Next.js.
+* Wraps the `cookies()` function from `next/headers`.
+*
+* Each method call invokes `cookies()` to get the current request's
+* cookie store, so the adapter is safe to reuse across requests.
+*/
+var NextCookieAdapter = class {
+	async get(name) {
+		return (await (0, import_headers.cookies)()).get(name)?.value;
+	}
+	async set(name, value, options) {
+		(await (0, import_headers.cookies)()).set(name, value, options);
+	}
+	async delete(name) {
+		(await (0, import_headers.cookies)()).delete(name);
+	}
+};
+//#endregion
+export { NextCookieAdapter };
+
+//# sourceMappingURL=next-cookie-adapter.mjs.map

package/dist/client/adapters/next-cookie-adapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-cookie-adapter.mjs","names":[],"sources":["../../../src/client/adapters/next-cookie-adapter.ts"],"sourcesContent":["import { cookies } from \"next/headers\";\nimport type { CookieAdapter, CookieOptions } from \"../global/auth/cookie-adapter\";\n\n/**\n * CookieAdapter implementation for Next.js.\n * Wraps the `cookies()` function from `next/headers`.\n *\n * Each method call invokes `cookies()` to get the current request's\n * cookie store, so the adapter is safe to reuse across requests.\n */\nexport class NextCookieAdapter implements CookieAdapter {\n  async get(name: string): Promise<string | undefined> {\n    const store = await cookies();\n    return store.get(name)?.value;\n  }\n\n  async set(name: string, value: string, options?: CookieOptions): Promise<void> {\n    const store = await cookies();\n    store.set(name, value, options);\n  }\n\n  async delete(name: string): Promise<void> {\n    const store = await cookies();\n    store.delete(name);\n  }\n}\n"],"mappings":";;;;;;;;;;AAUA,IAAa,oBAAb,MAAwD;CACtD,MAAM,IAAI,MAA2C;AAEnD,UADc,OAAA,GAAA,eAAA,UAAe,EAChB,IAAI,KAAK,EAAE;;CAG1B,MAAM,IAAI,MAAc,OAAe,SAAwC;AAE7E,GADc,OAAA,GAAA,eAAA,UAAe,EACvB,IAAI,MAAM,OAAO,QAAQ;;CAGjC,MAAM,OAAO,MAA6B;AAExC,GADc,OAAA,GAAA,eAAA,UAAe,EACvB,OAAO,KAAK"}

package/dist/client/adapters/next-navigation-adapter.d.ts

@@ -0,0 +1,9 @@
+import { NavigationAdapter } from "../global/auth/navigation-adapter.js";
+
+//#region src/client/adapters/next-navigation-adapter.d.ts
+declare class NextNavigationAdapter implements NavigationAdapter {
+  redirect(url: string): never;
+}
+//#endregion
+export { NextNavigationAdapter };
+//# sourceMappingURL=next-navigation-adapter.d.ts.map

package/dist/client/adapters/next-navigation-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-navigation-adapter.d.ts","names":[],"sources":["../../../src/client/adapters/next-navigation-adapter.ts"],"mappings":";;;cAGa,qBAAA,YAAiC,iBAAA;EAC5C,QAAA,CAAS,GAAA;AAAA"}

package/dist/client/adapters/next-navigation-adapter.mjs

@@ -0,0 +1,12 @@
+import { require_navigation } from "../node_modules/.pnpm/next@16.0.1_react-dom@19.2.0_react@19.2.0__react@19.2.0/node_modules/next/navigation.mjs";
+//#region src/client/adapters/next-navigation-adapter.ts
+var import_navigation = require_navigation();
+var NextNavigationAdapter = class {
+	redirect(url) {
+		(0, import_navigation.redirect)(url);
+	}
+};
+//#endregion
+export { NextNavigationAdapter };
+
+//# sourceMappingURL=next-navigation-adapter.mjs.map

package/dist/client/adapters/next-navigation-adapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-navigation-adapter.mjs","names":[],"sources":["../../../src/client/adapters/next-navigation-adapter.ts"],"sourcesContent":["import { redirect } from \"next/navigation\";\nimport type { NavigationAdapter } from \"../global/auth/navigation-adapter\";\n\nexport class NextNavigationAdapter implements NavigationAdapter {\n  redirect(url: string): never {\n    redirect(url);\n  }\n}\n"],"mappings":";;;AAGA,IAAa,wBAAb,MAAgE;CAC9D,SAAS,KAAoB;AAC3B,GAAA,GAAA,kBAAA,UAAS,IAAI"}

package/dist/client/cart/adapters/brink.d.ts

@@ -0,0 +1,33 @@
+import { CartAdapter } from "../types/adapter.js";
+
+//#region src/client/cart/adapters/brink.d.ts
+interface BrinkCartAdapterConfig {
+  /** Brink environment identifier (used to build the API base URL). */
+  env: string;
+  /** Store group identifier. */
+  storeGroupId: string;
+  /** ISO 3166-1 alpha-2 country code. */
+  countryCode: string;
+  /** BCP 47 language code. */
+  languageCode: string;
+  /** Storage key for the session token. Defaults to "brink_cart_session". */
+  sessionKey?: string;
+}
+/**
+ * Create a cart adapter for Brink Commerce.
+ *
+ * ```ts
+ * import { createBrinkCartAdapter } from "@enadhq/enad-react-sdk/client/cart/brink-adapter"
+ *
+ * const adapter = createBrinkCartAdapter({
+ *   env: "production",
+ *   storeGroupId: "sg-123",
+ *   countryCode: "SE",
+ *   languageCode: "sv",
+ * })
+ * ```
+ */
+declare function createBrinkCartAdapter(config: BrinkCartAdapterConfig): CartAdapter;
+//#endregion
+export { BrinkCartAdapterConfig, createBrinkCartAdapter };
+//# sourceMappingURL=brink.d.ts.map

package/dist/client/cart/adapters/brink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brink.d.ts","names":[],"sources":["../../../../src/client/cart/adapters/brink.ts"],"mappings":";;;UAOiB,sBAAA;;EAEf,GAAA;EAFqC;EAIrC,YAAA;EAJqC;EAMrC,WAAA;EAFA;EAIA,YAAA;EAAA;EAEA,UAAA;AAAA;;AA4JF;;;;;;;;;;;;;iBAAgB,sBAAA,CAAuB,MAAA,EAAQ,sBAAA,GAAyB,WAAA"}

package/dist/client/cart/adapters/brink.mjs

@@ -0,0 +1,171 @@
+import { CartAdapterError } from "../types/adapter.mjs";
+//#region src/client/cart/adapters/brink.ts
+function money(amount, currencyCode) {
+	return {
+		amount,
+		currencyCode
+	};
+}
+function mapItem(item, currencyCode) {
+	return {
+		id: item.id,
+		productVariantId: item.productVariantId,
+		sku: item.sku,
+		displayName: item.displayName,
+		unitPrice: money(item.salePriceAmount, currencyCode),
+		listPrice: item.originalPriceAmount != null ? money(item.originalPriceAmount, currencyCode) : void 0,
+		discount: item.discountAmount != null ? money(item.discountAmount, currencyCode) : void 0,
+		tax: item.taxAmount != null ? money(item.taxAmount, currencyCode) : void 0,
+		quantity: item.quantity,
+		imageUrl: item.imageUrl,
+		variantLabel: item.variantLabel,
+		productSlug: item.customAttributes?.productSlug,
+		backendMeta: item.customAttributes
+	};
+}
+function mapCart(response) {
+	const { cart } = response;
+	const cc = cart.currencyCode;
+	return {
+		id: cart.id,
+		countryCode: cart.countryCode,
+		currencyCode: cc,
+		languageCode: cart.languageCode,
+		taxIncludedInPrice: cart.isTaxIncludedInPrice,
+		discountCodes: cart.discountCodes,
+		items: cart.items.map((item) => mapItem(item, cc)),
+		totals: {
+			subtotal: money(cart.totals.subTotal, cc),
+			tax: money(cart.totals.taxTotal, cc),
+			discount: money(cart.totals.discountTotal, cc),
+			total: money(cart.totals.grandTotal, cc)
+		},
+		createdAt: cart.created,
+		updatedAt: cart.updated,
+		backendMeta: {
+			revision: cart.revision,
+			storeGroupId: cart.storeGroupId,
+			sessionToken: response.token,
+			capabilities: response.capabilities
+		}
+	};
+}
+function createSessionStore(key) {
+	return {
+		get() {
+			try {
+				return localStorage.getItem(key);
+			} catch {
+				return null;
+			}
+		},
+		set(token) {
+			try {
+				localStorage.setItem(key, token);
+			} catch {}
+		},
+		clear() {
+			try {
+				localStorage.removeItem(key);
+			} catch {}
+		}
+	};
+}
+/**
+* Create a cart adapter for Brink Commerce.
+*
+* ```ts
+* import { createBrinkCartAdapter } from "@enadhq/enad-react-sdk/client/cart/brink-adapter"
+*
+* const adapter = createBrinkCartAdapter({
+*   env: "production",
+*   storeGroupId: "sg-123",
+*   countryCode: "SE",
+*   languageCode: "sv",
+* })
+* ```
+*/
+function createBrinkCartAdapter(config) {
+	const { env, storeGroupId, countryCode, languageCode } = config;
+	const baseUrl = `https://shopper.eu-west-1.${env}.brinkcommerce.io`;
+	const session = createSessionStore(config.sessionKey ?? "brink_cart_session");
+	async function handleResponse(res) {
+		if (res.status === 401) {
+			session.clear();
+			throw new CartAdapterError("SESSION_EXPIRED", "Cart session has expired");
+		}
+		if (!res.ok) {
+			const text = await res.text().catch(() => "Unknown error");
+			throw new CartAdapterError("UNKNOWN", `Brink API error (${res.status}): ${text}`);
+		}
+		return res.json();
+	}
+	function authHeaders() {
+		const token = session.get();
+		if (!token) return { "Content-Type": "application/json" };
+		return {
+			Authorization: `Bearer ${token}`,
+			"Content-Type": "application/json"
+		};
+	}
+	return {
+		async getCart() {
+			if (session.get()) {
+				const res = await fetch(`${baseUrl}/shopper/sessions`, {
+					headers: authHeaders(),
+					cache: "no-store"
+				});
+				if (res.ok) {
+					const data = await res.json();
+					session.set(data.token);
+					return mapCart(data);
+				}
+				session.clear();
+			}
+			const data = await handleResponse(await fetch(`${baseUrl}/shopper/sessions/start`, {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify({
+					storeGroupId,
+					countryCode,
+					languageCode
+				})
+			}));
+			session.set(data.token);
+			return mapCart(data);
+		},
+		async addItem(productVariantId, quantity) {
+			const data = await handleResponse(await fetch(`${baseUrl}/shopper/sessions/items`, {
+				method: "POST",
+				headers: authHeaders(),
+				body: JSON.stringify({
+					productVariantId,
+					quantity
+				})
+			}));
+			session.set(data.token);
+			return mapCart(data);
+		},
+		async updateItem(itemId, quantity) {
+			const data = await handleResponse(await fetch(`${baseUrl}/shopper/sessions/items/${itemId}`, {
+				method: "PUT",
+				headers: authHeaders(),
+				body: JSON.stringify({ quantity })
+			}));
+			session.set(data.token);
+			return mapCart(data);
+		},
+		async removeItem(itemId) {
+			const data = await handleResponse(await fetch(`${baseUrl}/shopper/sessions/items/${itemId}`, {
+				method: "DELETE",
+				headers: authHeaders()
+			}));
+			session.set(data.token);
+			return mapCart(data);
+		}
+	};
+}
+//#endregion
+export { createBrinkCartAdapter };
+
+//# sourceMappingURL=brink.mjs.map

package/dist/client/cart/adapters/brink.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"brink.mjs","names":[],"sources":["../../../../src/client/cart/adapters/brink.ts"],"sourcesContent":["import type { CartAdapter, Cart, CartItem, Money } from \"../types/adapter\";\nimport { CartAdapterError } from \"../types/adapter\";\n\n// ---------------------------------------------------------------------------\n// Config\n// ---------------------------------------------------------------------------\n\nexport interface BrinkCartAdapterConfig {\n  /** Brink environment identifier (used to build the API base URL). */\n  env: string;\n  /** Store group identifier. */\n  storeGroupId: string;\n  /** ISO 3166-1 alpha-2 country code. */\n  countryCode: string;\n  /** BCP 47 language code. */\n  languageCode: string;\n  /** Storage key for the session token. Defaults to \"brink_cart_session\". */\n  sessionKey?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Brink API response types (internal)\n// ---------------------------------------------------------------------------\n\ninterface BrinkCartItem {\n  id: string;\n  productVariantId: string;\n  quantity: number;\n  salePriceAmount: number;\n  displayName: string;\n  imageUrl?: string;\n  customAttributes?: { productSlug?: string; [key: string]: unknown };\n  originalPriceAmount?: number;\n  discountAmount?: number;\n  taxAmount?: number;\n  variantLabel?: string;\n  sku?: string;\n}\n\ninterface BrinkCart {\n  id: string;\n  storeGroupId: string;\n  countryCode: string;\n  currencyCode: string;\n  languageCode: string;\n  isTaxIncludedInPrice: boolean;\n  discountCodes: string[];\n  created: string;\n  updated: string;\n  discountAmount: number;\n  revision: number;\n  items: BrinkCartItem[];\n  totals: {\n    subTotal: number;\n    taxTotal: number;\n    discountTotal: number;\n    grandTotal: number;\n  };\n}\n\ninterface BrinkCartResponse {\n  token: string;\n  cart: BrinkCart;\n  capabilities: {\n    paymentProviders: { id: string; name: string }[];\n    shippingProviders: { id: string; name: string }[];\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Mapping\n// ---------------------------------------------------------------------------\n\nfunction money(amount: number, currencyCode: string): Money {\n  return { amount, currencyCode };\n}\n\nfunction mapItem(item: BrinkCartItem, currencyCode: string): CartItem {\n  return {\n    id: item.id,\n    productVariantId: item.productVariantId,\n    sku: item.sku,\n    displayName: item.displayName,\n    unitPrice: money(item.salePriceAmount, currencyCode),\n    listPrice:\n      item.originalPriceAmount != null ? money(item.originalPriceAmount, currencyCode) : undefined,\n    discount: item.discountAmount != null ? money(item.discountAmount, currencyCode) : undefined,\n    tax: item.taxAmount != null ? money(item.taxAmount, currencyCode) : undefined,\n    quantity: item.quantity,\n    imageUrl: item.imageUrl,\n    variantLabel: item.variantLabel,\n    productSlug: item.customAttributes?.productSlug,\n    backendMeta: item.customAttributes,\n  };\n}\n\nfunction mapCart(response: BrinkCartResponse): Cart {\n  const { cart } = response;\n  const cc = cart.currencyCode;\n\n  return {\n    id: cart.id,\n    countryCode: cart.countryCode,\n    currencyCode: cc,\n    languageCode: cart.languageCode,\n    taxIncludedInPrice: cart.isTaxIncludedInPrice,\n    discountCodes: cart.discountCodes,\n    items: cart.items.map((item) => mapItem(item, cc)),\n    totals: {\n      subtotal: money(cart.totals.subTotal, cc),\n      tax: money(cart.totals.taxTotal, cc),\n      discount: money(cart.totals.discountTotal, cc),\n      total: money(cart.totals.grandTotal, cc),\n    },\n    createdAt: cart.created,\n    updatedAt: cart.updated,\n    backendMeta: {\n      revision: cart.revision,\n      storeGroupId: cart.storeGroupId,\n      sessionToken: response.token,\n      capabilities: response.capabilities,\n    },\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Session helpers\n// ---------------------------------------------------------------------------\n\nfunction createSessionStore(key: string) {\n  return {\n    get(): string | null {\n      try {\n        return localStorage.getItem(key);\n      } catch {\n        return null;\n      }\n    },\n    set(token: string) {\n      try {\n        localStorage.setItem(key, token);\n      } catch {\n        // localStorage unavailable (SSR, private browsing) — silently skip\n      }\n    },\n    clear() {\n      try {\n        localStorage.removeItem(key);\n      } catch {\n        // noop\n      }\n    },\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Adapter factory\n// ---------------------------------------------------------------------------\n\n/**\n * Create a cart adapter for Brink Commerce.\n *\n * ```ts\n * import { createBrinkCartAdapter } from \"@enadhq/enad-react-sdk/client/cart/brink-adapter\"\n *\n * const adapter = createBrinkCartAdapter({\n *   env: \"production\",\n *   storeGroupId: \"sg-123\",\n *   countryCode: \"SE\",\n *   languageCode: \"sv\",\n * })\n * ```\n */\nexport function createBrinkCartAdapter(config: BrinkCartAdapterConfig): CartAdapter {\n  const { env, storeGroupId, countryCode, languageCode } = config;\n  const baseUrl = `https://shopper.eu-west-1.${env}.brinkcommerce.io`;\n  const session = createSessionStore(config.sessionKey ?? \"brink_cart_session\");\n\n  async function handleResponse(res: Response): Promise<BrinkCartResponse> {\n    if (res.status === 401) {\n      session.clear();\n      throw new CartAdapterError(\"SESSION_EXPIRED\", \"Cart session has expired\");\n    }\n    if (!res.ok) {\n      const text = await res.text().catch(() => \"Unknown error\");\n      throw new CartAdapterError(\"UNKNOWN\", `Brink API error (${res.status}): ${text}`);\n    }\n    return res.json() as Promise<BrinkCartResponse>;\n  }\n\n  function authHeaders(): Record<string, string> {\n    const token = session.get();\n    if (!token) return { \"Content-Type\": \"application/json\" };\n    return {\n      Authorization: `Bearer ${token}`,\n      \"Content-Type\": \"application/json\",\n    };\n  }\n\n  const adapter: CartAdapter = {\n    async getCart(): Promise<Cart> {\n      const existingToken = session.get();\n\n      if (existingToken) {\n        const res = await fetch(`${baseUrl}/shopper/sessions`, {\n          headers: authHeaders(),\n          cache: \"no-store\",\n        });\n\n        if (res.ok) {\n          const data = (await res.json()) as BrinkCartResponse;\n          session.set(data.token);\n          return mapCart(data);\n        }\n\n        // Token expired or invalid — start fresh\n        session.clear();\n      }\n\n      // No session — create one\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      const data = await handleResponse(res);\n      session.set(data.token);\n      return mapCart(data);\n    },\n\n    async addItem(productVariantId: string, quantity: number): Promise<Cart> {\n      const res = await fetch(`${baseUrl}/shopper/sessions/items`, {\n        method: \"POST\",\n        headers: authHeaders(),\n        body: JSON.stringify({ productVariantId, quantity }),\n      });\n\n      const data = await handleResponse(res);\n      session.set(data.token);\n      return mapCart(data);\n    },\n\n    async updateItem(itemId: string, quantity: number): Promise<Cart> {\n      const res = await fetch(`${baseUrl}/shopper/sessions/items/${itemId}`, {\n        method: \"PUT\",\n        headers: authHeaders(),\n        body: JSON.stringify({ quantity }),\n      });\n\n      const data = await handleResponse(res);\n      session.set(data.token);\n      return mapCart(data);\n    },\n\n    async removeItem(itemId: string): Promise<Cart> {\n      const res = await fetch(`${baseUrl}/shopper/sessions/items/${itemId}`, {\n        method: \"DELETE\",\n        headers: authHeaders(),\n      });\n\n      const data = await handleResponse(res);\n      session.set(data.token);\n      return mapCart(data);\n    },\n  };\n\n  return adapter;\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,2 @@
+import { BrinkCartAdapterConfig, createBrinkCartAdapter } from "./brink.js";
+export { type BrinkCartAdapterConfig, createBrinkCartAdapter };

package/dist/client/cart/adapters/index.mjs

@@ -0,0 +1,2 @@
+import { createBrinkCartAdapter } from "./brink.mjs";
+export { createBrinkCartAdapter };

package/dist/client/cart/adapters/mock.d.ts

@@ -0,0 +1,24 @@
+import { CartAdapter, CartItem } from "../types/adapter.js";
+
+//#region src/client/cart/adapters/mock.d.ts
+interface MockCartAdapterOptions {
+  /** Initial items to populate the cart with. */
+  initialItems?: CartItem[];
+  /** Currency code. Defaults to "USD". */
+  currencyCode?: string;
+  /** Simulated network delay in ms. Defaults to 0. */
+  delay?: number;
+}
+/**
+ * In-memory cart adapter for testing and development.
+ *
+ * ```ts
+ * import { createMockCartAdapter } from "@enadhq/enad-react-sdk/client/cart/mock-adapter"
+ *
+ * const adapter = createMockCartAdapter({ delay: 200 })
+ * ```
+ */
+declare function createMockCartAdapter(options?: MockCartAdapterOptions): CartAdapter;
+//#endregion
+export { MockCartAdapterOptions, createMockCartAdapter };
+//# sourceMappingURL=mock.d.ts.map

package/dist/client/cart/adapters/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","names":[],"sources":["../../../../src/client/cart/adapters/mock.ts"],"mappings":";;;UAoCiB,sBAAA;;EAEf,YAAA,GAAe,QAAA;EAFsB;EAIrC,YAAA;EAFuB;EAIvB,KAAA;AAAA;;;;;AAYF;;;;;iBAAgB,qBAAA,CAAsB,OAAA,GAAS,sBAAA,GAA8B,WAAA"}