@enadhq/enad-react-sdk 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,288 @@
+# @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` | `"default" \| "mono"` | `"default"` | Base UI component set. `"mono"` uses the monochromatic variant |
+| `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/cart/adapters/brink.d.ts

@@ -0,0 +1,29 @@
+import type { CartAdapter } from "../types/adapter";
+export 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",
+ * })
+ * ```
+ */
+export declare function createBrinkCartAdapter(config: BrinkCartAdapterConfig): CartAdapter;
+//# sourceMappingURL=brink.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brink.d.ts","sourceRoot":"","sources":["../../../../src/client/cart/adapters/brink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAyB,MAAM,kBAAkB,CAAC;AAO3E,MAAM,WAAW,sBAAsB;IACrC,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA6ID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,WAAW,CA+FlF"}

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

@@ -0,0 +1,154 @@
+import { CartAdapterError } from "../types/adapter";
+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 {
+      }
+    }
+  };
+}
+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"
+    };
+  }
+  const adapter = {
+    async getCart() {
+      const existingToken = session.get();
+      if (existingToken) {
+        const res2 = await fetch(`${baseUrl}/shopper/sessions`, {
+          headers: authHeaders(),
+          cache: "no-store"
+        });
+        if (res2.ok) {
+          const data2 = await res2.json();
+          session.set(data2.token);
+          return mapCart(data2);
+        }
+        session.clear();
+      }
+      const res = await fetch(`${baseUrl}/shopper/sessions/start`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ storeGroupId, countryCode, languageCode })
+      });
+      const data = await handleResponse(res);
+      session.set(data.token);
+      return mapCart(data);
+    },
+    async addItem(productVariantId, quantity) {
+      const res = await fetch(`${baseUrl}/shopper/sessions/items`, {
+        method: "POST",
+        headers: authHeaders(),
+        body: JSON.stringify({ productVariantId, quantity })
+      });
+      const data = await handleResponse(res);
+      session.set(data.token);
+      return mapCart(data);
+    },
+    async updateItem(itemId, quantity) {
+      const res = await fetch(`${baseUrl}/shopper/sessions/items/${itemId}`, {
+        method: "PUT",
+        headers: authHeaders(),
+        body: JSON.stringify({ quantity })
+      });
+      const data = await handleResponse(res);
+      session.set(data.token);
+      return mapCart(data);
+    },
+    async removeItem(itemId) {
+      const res = await fetch(`${baseUrl}/shopper/sessions/items/${itemId}`, {
+        method: "DELETE",
+        headers: authHeaders()
+      });
+      const data = await handleResponse(res);
+      session.set(data.token);
+      return mapCart(data);
+    }
+  };
+  return adapter;
+}
+export {
+  createBrinkCartAdapter
+};
+//# sourceMappingURL=brink.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"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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","names":["res","data"]}

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

@@ -0,0 +1,3 @@
+export { createBrinkCartAdapter } from "./brink";
+export type { BrinkCartAdapterConfig } from "./brink";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/cart/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AACjD,YAAY,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,5 @@
+import { createBrinkCartAdapter } from "./brink";
+export {
+  createBrinkCartAdapter
+};
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/cart/adapters/index.ts"],"sourcesContent":["export { createBrinkCartAdapter } from \"./brink\";\nexport type { BrinkCartAdapterConfig } from \"./brink\";\n"],"mappings":"AAAA,SAAS,8BAA8B;","names":[]}

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

@@ -0,0 +1,20 @@
+import type { CartAdapter, CartItem } from "../types/adapter";
+export 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 })
+ * ```
+ */
+export declare function createMockCartAdapter(options?: MockCartAdapterOptions): CartAdapter;
+//# sourceMappingURL=mock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../../src/client/cart/adapters/mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAQ,QAAQ,EAAS,MAAM,kBAAkB,CAAC;AAoC3E,MAAM,WAAW,sBAAsB;IACrC,+CAA+C;IAC/C,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC1B,wCAAwC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,GAAG,WAAW,CA+CvF"}

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

@@ -0,0 +1,76 @@
+function money(amount, currencyCode = "USD") {
+  return { amount, currencyCode };
+}
+let nextItemId = 1;
+function createEmptyCart(currencyCode = "USD") {
+  return {
+    id: "mock-cart",
+    countryCode: "US",
+    currencyCode,
+    languageCode: "en",
+    taxIncludedInPrice: false,
+    discountCodes: [],
+    items: [],
+    totals: {
+      subtotal: money(0, currencyCode),
+      tax: money(0, currencyCode),
+      discount: money(0, currencyCode),
+      total: money(0, currencyCode)
+    }
+  };
+}
+function recalculateTotals(items, currencyCode) {
+  const subtotal = items.reduce((sum, item) => sum + item.unitPrice.amount * item.quantity, 0);
+  return {
+    subtotal: money(subtotal, currencyCode),
+    tax: money(0, currencyCode),
+    discount: money(0, currencyCode),
+    total: money(subtotal, currencyCode)
+  };
+}
+function createMockCartAdapter(options = {}) {
+  const { currencyCode = "USD", delay = 0 } = options;
+  let cart = createEmptyCart(currencyCode);
+  if (options.initialItems) {
+    cart.items = [...options.initialItems];
+    cart.totals = recalculateTotals(cart.items, currencyCode);
+  }
+  async function wait() {
+    if (delay > 0) await new Promise((r) => setTimeout(r, delay));
+  }
+  return {
+    async getCart() {
+      await wait();
+      return { ...cart };
+    },
+    async addItem(productVariantId, quantity) {
+      await wait();
+      const newItem = {
+        id: `mock-item-${nextItemId++}`,
+        productVariantId,
+        displayName: `Product ${productVariantId}`,
+        unitPrice: money(1e3, currencyCode),
+        quantity
+      };
+      cart.items = [...cart.items, newItem];
+      cart.totals = recalculateTotals(cart.items, currencyCode);
+      return { ...cart };
+    },
+    async updateItem(itemId, quantity) {
+      await wait();
+      cart.items = cart.items.map((item) => item.id === itemId ? { ...item, quantity } : item);
+      cart.totals = recalculateTotals(cart.items, currencyCode);
+      return { ...cart };
+    },
+    async removeItem(itemId) {
+      await wait();
+      cart.items = cart.items.filter((item) => item.id !== itemId);
+      cart.totals = recalculateTotals(cart.items, currencyCode);
+      return { ...cart };
+    }
+  };
+}
+export {
+  createMockCartAdapter
+};
+//# sourceMappingURL=mock.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/cart/adapters/mock.ts"],"sourcesContent":["import type { CartAdapter, Cart, CartItem, Money } from \"../types/adapter\";\n\nfunction money(amount: number, currencyCode = \"USD\"): Money {\n  return { amount, currencyCode };\n}\n\nlet nextItemId = 1;\n\nfunction createEmptyCart(currencyCode = \"USD\"): Cart {\n  return {\n    id: \"mock-cart\",\n    countryCode: \"US\",\n    currencyCode,\n    languageCode: \"en\",\n    taxIncludedInPrice: false,\n    discountCodes: [],\n    items: [],\n    totals: {\n      subtotal: money(0, currencyCode),\n      tax: money(0, currencyCode),\n      discount: money(0, currencyCode),\n      total: money(0, currencyCode),\n    },\n  };\n}\n\nfunction recalculateTotals(items: CartItem[], currencyCode: string): Cart[\"totals\"] {\n  const subtotal = items.reduce((sum, item) => sum + item.unitPrice.amount * item.quantity, 0);\n  return {\n    subtotal: money(subtotal, currencyCode),\n    tax: money(0, currencyCode),\n    discount: money(0, currencyCode),\n    total: money(subtotal, currencyCode),\n  };\n}\n\nexport interface MockCartAdapterOptions {\n  /** Initial items to populate the cart with. */\n  initialItems?: CartItem[];\n  /** Currency code. Defaults to \"USD\". */\n  currencyCode?: string;\n  /** Simulated network delay in ms. Defaults to 0. */\n  delay?: number;\n}\n\n/**\n * In-memory cart adapter for testing and development.\n *\n * ```ts\n * import { createMockCartAdapter } from \"@enadhq/enad-react-sdk/client/cart/mock-adapter\"\n *\n * const adapter = createMockCartAdapter({ delay: 200 })\n * ```\n */\nexport function createMockCartAdapter(options: MockCartAdapterOptions = {}): CartAdapter {\n  const { currencyCode = \"USD\", delay = 0 } = options;\n  let cart = createEmptyCart(currencyCode);\n\n  if (options.initialItems) {\n    cart.items = [...options.initialItems];\n    cart.totals = recalculateTotals(cart.items, currencyCode);\n  }\n\n  async function wait() {\n    if (delay > 0) await new Promise((r) => setTimeout(r, delay));\n  }\n\n  return {\n    async getCart(): Promise<Cart> {\n      await wait();\n      return { ...cart };\n    },\n\n    async addItem(productVariantId: string, quantity: number): Promise<Cart> {\n      await wait();\n      const newItem: CartItem = {\n        id: `mock-item-${nextItemId++}`,\n        productVariantId,\n        displayName: `Product ${productVariantId}`,\n        unitPrice: money(1000, currencyCode),\n        quantity,\n      };\n      cart.items = [...cart.items, newItem];\n      cart.totals = recalculateTotals(cart.items, currencyCode);\n      return { ...cart };\n    },\n\n    async updateItem(itemId: string, quantity: number): Promise<Cart> {\n      await wait();\n      cart.items = cart.items.map((item) => (item.id === itemId ? { ...item, quantity } : item));\n      cart.totals = recalculateTotals(cart.items, currencyCode);\n      return { ...cart };\n    },\n\n    async removeItem(itemId: string): Promise<Cart> {\n      await wait();\n      cart.items = cart.items.filter((item) => item.id !== itemId);\n      cart.totals = recalculateTotals(cart.items, currencyCode);\n      return { ...cart };\n    },\n  };\n}\n"],"mappings":"AAEA,SAAS,MAAM,QAAgB,eAAe,OAAc;AAC1D,SAAO,EAAE,QAAQ,aAAa;AAChC;AAEA,IAAI,aAAa;AAEjB,SAAS,gBAAgB,eAAe,OAAa;AACnD,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,aAAa;AAAA,IACb;AAAA,IACA,cAAc;AAAA,IACd,oBAAoB;AAAA,IACpB,eAAe,CAAC;AAAA,IAChB,OAAO,CAAC;AAAA,IACR,QAAQ;AAAA,MACN,UAAU,MAAM,GAAG,YAAY;AAAA,MAC/B,KAAK,MAAM,GAAG,YAAY;AAAA,MAC1B,UAAU,MAAM,GAAG,YAAY;AAAA,MAC/B,OAAO,MAAM,GAAG,YAAY;AAAA,IAC9B;AAAA,EACF;AACF;AAEA,SAAS,kBAAkB,OAAmB,cAAsC;AAClF,QAAM,WAAW,MAAM,OAAO,CAAC,KAAK,SAAS,MAAM,KAAK,UAAU,SAAS,KAAK,UAAU,CAAC;AAC3F,SAAO;AAAA,IACL,UAAU,MAAM,UAAU,YAAY;AAAA,IACtC,KAAK,MAAM,GAAG,YAAY;AAAA,IAC1B,UAAU,MAAM,GAAG,YAAY;AAAA,IAC/B,OAAO,MAAM,UAAU,YAAY;AAAA,EACrC;AACF;AAoBO,SAAS,sBAAsB,UAAkC,CAAC,GAAgB;AACvF,QAAM,EAAE,eAAe,OAAO,QAAQ,EAAE,IAAI;AAC5C,MAAI,OAAO,gBAAgB,YAAY;AAEvC,MAAI,QAAQ,cAAc;AACxB,SAAK,QAAQ,CAAC,GAAG,QAAQ,YAAY;AACrC,SAAK,SAAS,kBAAkB,KAAK,OAAO,YAAY;AAAA,EAC1D;AAEA,iBAAe,OAAO;AACpB,QAAI,QAAQ,EAAG,OAAM,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC;AAAA,EAC9D;AAEA,SAAO;AAAA,IACL,MAAM,UAAyB;AAC7B,YAAM,KAAK;AACX,aAAO,EAAE,GAAG,KAAK;AAAA,IACnB;AAAA,IAEA,MAAM,QAAQ,kBAA0B,UAAiC;AACvE,YAAM,KAAK;AACX,YAAM,UAAoB;AAAA,QACxB,IAAI,aAAa,YAAY;AAAA,QAC7B;AAAA,QACA,aAAa,WAAW,gBAAgB;AAAA,QACxC,WAAW,MAAM,KAAM,YAAY;AAAA,QACnC;AAAA,MACF;AACA,WAAK,QAAQ,CAAC,GAAG,KAAK,OAAO,OAAO;AACpC,WAAK,SAAS,kBAAkB,KAAK,OAAO,YAAY;AACxD,aAAO,EAAE,GAAG,KAAK;AAAA,IACnB;AAAA,IAEA,MAAM,WAAW,QAAgB,UAAiC;AAChE,YAAM,KAAK;AACX,WAAK,QAAQ,KAAK,MAAM,IAAI,CAAC,SAAU,KAAK,OAAO,SAAS,EAAE,GAAG,MAAM,SAAS,IAAI,IAAK;AACzF,WAAK,SAAS,kBAAkB,KAAK,OAAO,YAAY;AACxD,aAAO,EAAE,GAAG,KAAK;AAAA,IACnB;AAAA,IAEA,MAAM,WAAW,QAA+B;AAC9C,YAAM,KAAK;AACX,WAAK,QAAQ,KAAK,MAAM,OAAO,CAAC,SAAS,KAAK,OAAO,MAAM;AAC3D,WAAK,SAAS,kBAAkB,KAAK,OAAO,YAAY;AACxD,aAAO,EAAE,GAAG,KAAK;AAAA,IACnB;AAAA,EACF;AACF;","names":[]}

package/dist/client/cart/components/cart-drawer.d.ts

@@ -0,0 +1,17 @@
+export interface CartDrawerProps {
+    isOpen: boolean;
+    onClose: () => void;
+    className?: string;
+    labels?: {
+        title?: string;
+        emptyCartMessage?: string;
+        continueShopping?: string;
+        subtotal?: string;
+        discount?: string;
+        tax?: string;
+        total?: string;
+        proceedToCheckout?: string;
+    };
+}
+export declare function CartDrawer({ isOpen, onClose, className, labels }: CartDrawerProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=cart-drawer.d.ts.map

package/dist/client/cart/components/cart-drawer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart-drawer.d.ts","sourceRoot":"","sources":["../../../../src/client/cart/components/cart-drawer.tsx"],"names":[],"mappings":"AASA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH;AAySD,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAW,EAAE,EAAE,eAAe,2CAsFtF"}