@reblu/site-next 1.20.0 → 1.21.0

package/dist/cart.d.cts

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as zustand_middleware from 'zustand/middleware';
 import * as zustand from 'zustand';
+import { ShopCartValidationError, ShopValidateCartInput, ShopCartValidation } from '@reblu/site-contracts';
 
 /**
  * `CartProvider` — mount this once near the root layout (inside a Client
@@ -167,4 +168,128 @@ declare function useCartHydrated(): boolean;
  */
 declare function useCart(): UseCartResult;
 
-export { type AddItemOutcome, type AddItemStatus, CART_STORAGE_KEY, CART_STORE_PERSIST_VERSION, type CartItem, CartProvider, type CartStore, type UseCartResult, __resetCartStoreForTests, useCart, useCartHydrated, useCartStore };
+/**
+ * Cart validation (REB-981). A persisted cart (`localStorage` `shop-cart`)
+ * outlives the catalog it was filled from: a product can be deleted,
+ * deactivated, sold out or repriced between visits. `validateCart` asks the
+ * SITE's validate-cart Route Handler (`createShopValidateCartRoute`) about
+ * every line and APPLIES the answer to the store, so the cart page and the
+ * checkout never show or submit a line nobody can buy.
+ */
+/** Calls validate-cart for the given lines. Must reject (or throw) on failure. */
+type CartValidator = (input: ShopValidateCartInput) => Promise<ShopCartValidation>;
+interface ValidateCartOptions {
+    /**
+     * The SITE's validate-cart Route Handler path, used by the default
+     * validator. Defaults to `'/api/shop/validate-cart'`.
+     */
+    endpoint?: string;
+    /** Replaces the default `fetch`-based validator entirely. */
+    validate?: CartValidator;
+    /**
+     * `true` (default) removes lines whose error says `suggestedAction:
+     * 'remove'` (`not_found`, `inactive`, `out_of_stock`). `false` leaves them
+     * in the cart and only reports them through `lineErrors`.
+     */
+    removeUnavailable?: boolean;
+}
+/** A line the validation removed — `name`/`variantName` come from the persisted line. */
+interface CartRemovedLine {
+    productId: string;
+    variantId: string | null;
+    name: string;
+    variantName?: string;
+    type: ShopCartValidationError['type'];
+    message: string;
+}
+/** A line whose quantity was clamped to the stock still available. */
+interface CartQuantityChange {
+    productId: string;
+    variantId: string | null;
+    name: string;
+    variantName?: string;
+    from: number;
+    to: number;
+}
+/** A line whose `unitPrice` (integer cents) was refreshed from the live price. */
+interface CartPriceChange {
+    productId: string;
+    variantId: string | null;
+    name: string;
+    variantName?: string;
+    from: number;
+    to: number;
+}
+/**
+ * - `valid` — every line is buyable as it stands; nothing changed.
+ * - `adjusted` — the cart was changed (lines removed, quantities clamped or
+ *   prices refreshed). Show the changes before letting the visitor pay.
+ * - `invalid` — problems remain that were not applied (lines flagged with
+ *   `removeUnavailable: false`, or a cart-wide error).
+ * - `empty` — no lines; nothing was sent.
+ * - `failed` — the request failed; the cart was left exactly as it was.
+ */
+type CartValidationStatus = 'valid' | 'adjusted' | 'invalid' | 'empty' | 'failed';
+interface CartValidationOutcome {
+    status: CartValidationStatus;
+    removed: CartRemovedLine[];
+    quantityChanges: CartQuantityChange[];
+    priceChanges: CartPriceChange[];
+    /** Every line error of the response, keyed by {@link cartLineKey}. */
+    lineErrors: Record<string, ShopCartValidationError>;
+    /** Errors that match no cart line (e.g. `empty_cart`) or were not applied. */
+    unresolvedErrors: ShopCartValidationError[];
+    /** Set when `status` is `'failed'`. */
+    error?: unknown;
+}
+declare const DEFAULT_VALIDATE_CART_ENDPOINT = "/api/shop/validate-cart";
+/** Stable key for a cart line: `productId` + `variantId` (absent and `null` are the same line). */
+declare function cartLineKey(productId: string, variantId?: string | null): string;
+/**
+ * Pure: applies a validate-cart response to a list of lines. Lines the
+ * response does not mention (e.g. added while the request was in flight)
+ * are left untouched.
+ */
+declare function applyCartValidation(items: CartItem[], validation: ShopCartValidation, { removeUnavailable }?: Pick<ValidateCartOptions, 'removeUnavailable'>): Omit<CartValidationOutcome, 'status' | 'error'> & {
+    items: CartItem[];
+};
+/**
+ * Validates the persisted cart against live product, stock and price data
+ * and applies the result to `useCartStore`:
+ *
+ * 1. removes lines the API says to remove, reporting their persisted names;
+ * 2. clamps `insufficient_stock` lines to the quantity still available;
+ * 3. refreshes `unitPrice` (and `maxStock`) from the live data.
+ *
+ * Waits for `CartProvider`'s hydration first, so it never validates the
+ * empty pre-hydration cart. Never throws: a failed request resolves to
+ * `status: 'failed'` and leaves the cart untouched. Running it again on an
+ * already-clean cart is a no-op (`status: 'valid'`).
+ */
+declare function validateCart(options?: ValidateCartOptions): Promise<CartValidationOutcome>;
+
+interface UseCartValidationOptions extends ValidateCartOptions {
+    /** Validate once automatically when the cart has hydrated. Defaults to `true`. */
+    auto?: boolean;
+}
+interface UseCartValidationResult extends Omit<CartValidationOutcome, 'status'> {
+    /** `'idle'` before the first run, `'validating'` while a request is in flight. */
+    status: CartValidationStatus | 'idle' | 'validating';
+    /** The error the last run reported for this line, if any. */
+    getLineError: (productId: string, variantId?: string | null) => ShopCartValidationError | undefined;
+    /**
+     * Runs the validation now (e.g. right before submitting the checkout) and
+     * resolves to its outcome. Concurrent calls share the in-flight request.
+     */
+    revalidate: () => Promise<CartValidationOutcome>;
+}
+/**
+ * `useCartValidation` (REB-981) — runs {@link validateCart} once when the
+ * cart has hydrated (cart page mount) and exposes the last outcome, so the
+ * page can show what was removed or adjusted and mark the offending lines.
+ * Call `revalidate()` before checkout. Later cart edits never re-trigger the
+ * automatic run, so it cannot loop.
+ */
+declare function useCartValidation(options?: UseCartValidationOptions): UseCartValidationResult;
+
+export { type AddItemOutcome, type AddItemStatus, CART_STORAGE_KEY, CART_STORE_PERSIST_VERSION, type CartItem, type CartPriceChange, CartProvider, type CartQuantityChange, type CartRemovedLine, type CartStore, type CartValidationOutcome, type CartValidationStatus, type CartValidator, DEFAULT_VALIDATE_CART_ENDPOINT, type UseCartResult, type UseCartValidationOptions, type UseCartValidationResult, type ValidateCartOptions, __resetCartStoreForTests, applyCartValidation, cartLineKey, useCart, useCartHydrated, useCartStore, useCartValidation, validateCart };

package/dist/cart.d.ts

@@ -1,6 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as zustand_middleware from 'zustand/middleware';
 import * as zustand from 'zustand';
+import { ShopCartValidationError, ShopValidateCartInput, ShopCartValidation } from '@reblu/site-contracts';
 
 /**
  * `CartProvider` — mount this once near the root layout (inside a Client
@@ -167,4 +168,128 @@ declare function useCartHydrated(): boolean;
  */
 declare function useCart(): UseCartResult;
 
-export { type AddItemOutcome, type AddItemStatus, CART_STORAGE_KEY, CART_STORE_PERSIST_VERSION, type CartItem, CartProvider, type CartStore, type UseCartResult, __resetCartStoreForTests, useCart, useCartHydrated, useCartStore };
+/**
+ * Cart validation (REB-981). A persisted cart (`localStorage` `shop-cart`)
+ * outlives the catalog it was filled from: a product can be deleted,
+ * deactivated, sold out or repriced between visits. `validateCart` asks the
+ * SITE's validate-cart Route Handler (`createShopValidateCartRoute`) about
+ * every line and APPLIES the answer to the store, so the cart page and the
+ * checkout never show or submit a line nobody can buy.
+ */
+/** Calls validate-cart for the given lines. Must reject (or throw) on failure. */
+type CartValidator = (input: ShopValidateCartInput) => Promise<ShopCartValidation>;
+interface ValidateCartOptions {
+    /**
+     * The SITE's validate-cart Route Handler path, used by the default
+     * validator. Defaults to `'/api/shop/validate-cart'`.
+     */
+    endpoint?: string;
+    /** Replaces the default `fetch`-based validator entirely. */
+    validate?: CartValidator;
+    /**
+     * `true` (default) removes lines whose error says `suggestedAction:
+     * 'remove'` (`not_found`, `inactive`, `out_of_stock`). `false` leaves them
+     * in the cart and only reports them through `lineErrors`.
+     */
+    removeUnavailable?: boolean;
+}
+/** A line the validation removed — `name`/`variantName` come from the persisted line. */
+interface CartRemovedLine {
+    productId: string;
+    variantId: string | null;
+    name: string;
+    variantName?: string;
+    type: ShopCartValidationError['type'];
+    message: string;
+}
+/** A line whose quantity was clamped to the stock still available. */
+interface CartQuantityChange {
+    productId: string;
+    variantId: string | null;
+    name: string;
+    variantName?: string;
+    from: number;
+    to: number;
+}
+/** A line whose `unitPrice` (integer cents) was refreshed from the live price. */
+interface CartPriceChange {
+    productId: string;
+    variantId: string | null;
+    name: string;
+    variantName?: string;
+    from: number;
+    to: number;
+}
+/**
+ * - `valid` — every line is buyable as it stands; nothing changed.
+ * - `adjusted` — the cart was changed (lines removed, quantities clamped or
+ *   prices refreshed). Show the changes before letting the visitor pay.
+ * - `invalid` — problems remain that were not applied (lines flagged with
+ *   `removeUnavailable: false`, or a cart-wide error).
+ * - `empty` — no lines; nothing was sent.
+ * - `failed` — the request failed; the cart was left exactly as it was.
+ */
+type CartValidationStatus = 'valid' | 'adjusted' | 'invalid' | 'empty' | 'failed';
+interface CartValidationOutcome {
+    status: CartValidationStatus;
+    removed: CartRemovedLine[];
+    quantityChanges: CartQuantityChange[];
+    priceChanges: CartPriceChange[];
+    /** Every line error of the response, keyed by {@link cartLineKey}. */
+    lineErrors: Record<string, ShopCartValidationError>;
+    /** Errors that match no cart line (e.g. `empty_cart`) or were not applied. */
+    unresolvedErrors: ShopCartValidationError[];
+    /** Set when `status` is `'failed'`. */
+    error?: unknown;
+}
+declare const DEFAULT_VALIDATE_CART_ENDPOINT = "/api/shop/validate-cart";
+/** Stable key for a cart line: `productId` + `variantId` (absent and `null` are the same line). */
+declare function cartLineKey(productId: string, variantId?: string | null): string;
+/**
+ * Pure: applies a validate-cart response to a list of lines. Lines the
+ * response does not mention (e.g. added while the request was in flight)
+ * are left untouched.
+ */
+declare function applyCartValidation(items: CartItem[], validation: ShopCartValidation, { removeUnavailable }?: Pick<ValidateCartOptions, 'removeUnavailable'>): Omit<CartValidationOutcome, 'status' | 'error'> & {
+    items: CartItem[];
+};
+/**
+ * Validates the persisted cart against live product, stock and price data
+ * and applies the result to `useCartStore`:
+ *
+ * 1. removes lines the API says to remove, reporting their persisted names;
+ * 2. clamps `insufficient_stock` lines to the quantity still available;
+ * 3. refreshes `unitPrice` (and `maxStock`) from the live data.
+ *
+ * Waits for `CartProvider`'s hydration first, so it never validates the
+ * empty pre-hydration cart. Never throws: a failed request resolves to
+ * `status: 'failed'` and leaves the cart untouched. Running it again on an
+ * already-clean cart is a no-op (`status: 'valid'`).
+ */
+declare function validateCart(options?: ValidateCartOptions): Promise<CartValidationOutcome>;
+
+interface UseCartValidationOptions extends ValidateCartOptions {
+    /** Validate once automatically when the cart has hydrated. Defaults to `true`. */
+    auto?: boolean;
+}
+interface UseCartValidationResult extends Omit<CartValidationOutcome, 'status'> {
+    /** `'idle'` before the first run, `'validating'` while a request is in flight. */
+    status: CartValidationStatus | 'idle' | 'validating';
+    /** The error the last run reported for this line, if any. */
+    getLineError: (productId: string, variantId?: string | null) => ShopCartValidationError | undefined;
+    /**
+     * Runs the validation now (e.g. right before submitting the checkout) and
+     * resolves to its outcome. Concurrent calls share the in-flight request.
+     */
+    revalidate: () => Promise<CartValidationOutcome>;
+}
+/**
+ * `useCartValidation` (REB-981) — runs {@link validateCart} once when the
+ * cart has hydrated (cart page mount) and exposes the last outcome, so the
+ * page can show what was removed or adjusted and mark the offending lines.
+ * Call `revalidate()` before checkout. Later cart edits never re-trigger the
+ * automatic run, so it cannot loop.
+ */
+declare function useCartValidation(options?: UseCartValidationOptions): UseCartValidationResult;
+
+export { type AddItemOutcome, type AddItemStatus, CART_STORAGE_KEY, CART_STORE_PERSIST_VERSION, type CartItem, type CartPriceChange, CartProvider, type CartQuantityChange, type CartRemovedLine, type CartStore, type CartValidationOutcome, type CartValidationStatus, type CartValidator, DEFAULT_VALIDATE_CART_ENDPOINT, type UseCartResult, type UseCartValidationOptions, type UseCartValidationResult, type ValidateCartOptions, __resetCartStoreForTests, applyCartValidation, cartLineKey, useCart, useCartHydrated, useCartStore, useCartValidation, validateCart };

package/dist/cart.js

@@ -136,13 +136,226 @@ function useCart() {
   const itemCount = items.reduce((sum, item) => sum + item.quantity, 0);
   return { items, total, itemCount, hydrated, addItem, removeItem, updateQuantity, clearCart };
 }
+
+// src/cart/validate.ts
+var DEFAULT_VALIDATE_CART_ENDPOINT = "/api/shop/validate-cart";
+function cartLineKey(productId, variantId) {
+  return JSON.stringify([productId, variantId ?? null]);
+}
+function emptyOutcome(status) {
+  return {
+    status,
+    removed: [],
+    quantityChanges: [],
+    priceChanges: [],
+    lineErrors: {},
+    unresolvedErrors: []
+  };
+}
+function isValidation(value) {
+  if (!value || typeof value !== "object") return false;
+  const v = value;
+  return typeof v.valid === "boolean" && Array.isArray(v.errors) && Array.isArray(v.items);
+}
+function defaultValidator(endpoint) {
+  return async (input) => {
+    const res = await fetch(endpoint, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(input)
+    });
+    if (!res.ok) {
+      throw new Error(`validate-cart failed with HTTP ${res.status}`);
+    }
+    const json = await res.json();
+    const data = json && typeof json === "object" ? json.data : void 0;
+    if (!isValidation(data)) {
+      throw new Error("validate-cart returned an unexpected body");
+    }
+    return data;
+  };
+}
+function waitForHydration() {
+  if (useCartStore.persist.hasHydrated()) return Promise.resolve();
+  return new Promise((resolve) => {
+    const unsubscribe = useCartStore.persist.onFinishHydration(() => {
+      unsubscribe();
+      resolve();
+    });
+  });
+}
+function applyCartValidation(items, validation, { removeUnavailable = true } = {}) {
+  const removed = [];
+  const quantityChanges = [];
+  const priceChanges = [];
+  const lineErrors = {};
+  const unresolvedErrors = [];
+  const byKey = new Map(items.map((item) => [cartLineKey(item.productId, item.variantId), item]));
+  const removeKeys = /* @__PURE__ */ new Set();
+  const newQuantity = /* @__PURE__ */ new Map();
+  for (const error of validation.errors) {
+    const key = cartLineKey(error.productId, error.variantId);
+    const line = byKey.get(key);
+    if (!line) {
+      unresolvedErrors.push(error);
+      continue;
+    }
+    lineErrors[key] = error;
+    if (error.suggestedAction === "remove" && removeUnavailable) {
+      removeKeys.add(key);
+      removed.push({
+        productId: line.productId,
+        variantId: line.variantId ?? null,
+        name: line.name,
+        ...line.variantName !== void 0 && { variantName: line.variantName },
+        type: error.type,
+        message: error.message
+      });
+    } else if (error.suggestedAction === "update_quantity" && typeof error.newQuantity === "number") {
+      newQuantity.set(key, error.newQuantity);
+    } else {
+      unresolvedErrors.push(error);
+    }
+  }
+  const live = new Map(
+    validation.items.map((item) => [cartLineKey(item.productId, item.variantId), item])
+  );
+  const next = [];
+  for (const line of items) {
+    const key = cartLineKey(line.productId, line.variantId);
+    if (removeKeys.has(key)) continue;
+    let updated = line;
+    const liveItem = live.get(key);
+    if (liveItem) {
+      if (liveItem.unitPrice !== line.unitPrice) {
+        priceChanges.push({
+          productId: line.productId,
+          variantId: line.variantId ?? null,
+          name: line.name,
+          ...line.variantName !== void 0 && { variantName: line.variantName },
+          from: line.unitPrice,
+          to: liveItem.unitPrice
+        });
+        updated = { ...updated, unitPrice: liveItem.unitPrice };
+      }
+      if (liveItem.maxStock !== line.maxStock) {
+        updated = { ...updated, maxStock: liveItem.maxStock };
+      }
+    }
+    const clampTo = newQuantity.get(key);
+    if (clampTo !== void 0) {
+      const to = Math.trunc(clampTo);
+      if (to < 1) {
+        removed.push({
+          productId: line.productId,
+          variantId: line.variantId ?? null,
+          name: line.name,
+          ...line.variantName !== void 0 && { variantName: line.variantName },
+          type: "out_of_stock",
+          message: lineErrors[key]?.message ?? ""
+        });
+        continue;
+      }
+      if (to < line.quantity) {
+        quantityChanges.push({
+          productId: line.productId,
+          variantId: line.variantId ?? null,
+          name: line.name,
+          ...line.variantName !== void 0 && { variantName: line.variantName },
+          from: line.quantity,
+          to
+        });
+        updated = { ...updated, quantity: to };
+      }
+    }
+    next.push(updated);
+  }
+  return { items: next, removed, quantityChanges, priceChanges, lineErrors, unresolvedErrors };
+}
+async function validateCart(options = {}) {
+  await waitForHydration();
+  const items = useCartStore.getState().items;
+  if (items.length === 0) return emptyOutcome("empty");
+  const validate = options.validate ?? defaultValidator(options.endpoint ?? DEFAULT_VALIDATE_CART_ENDPOINT);
+  let validation;
+  try {
+    validation = await validate({
+      items: items.map((i) => ({
+        productId: i.productId,
+        variantId: i.variantId,
+        quantity: i.quantity
+      }))
+    });
+  } catch (error) {
+    return { ...emptyOutcome("failed"), error };
+  }
+  const applied = applyCartValidation(useCartStore.getState().items, validation, options);
+  const { items: nextItems, ...report } = applied;
+  const changed = report.removed.length > 0 || report.quantityChanges.length > 0 || report.priceChanges.length > 0;
+  const current = useCartStore.getState().items;
+  if (nextItems.length !== current.length || nextItems.some((item, i) => item !== current[i])) {
+    useCartStore.setState({ items: nextItems });
+  }
+  const status = report.unresolvedErrors.length > 0 ? "invalid" : changed ? "adjusted" : "valid";
+  return { status, ...report };
+}
+
+// src/cart/use-cart-validation.ts
+import { useCallback, useEffect as useEffect2, useRef, useState } from "react";
+var IDLE = {
+  removed: [],
+  quantityChanges: [],
+  priceChanges: [],
+  lineErrors: {},
+  unresolvedErrors: []
+};
+function useCartValidation(options = {}) {
+  const { auto = true } = options;
+  const hydrated = useCartHydrated();
+  const [status, setStatus] = useState("idle");
+  const [report, setReport] = useState(IDLE);
+  const optionsRef = useRef(options);
+  useEffect2(() => {
+    optionsRef.current = options;
+  });
+  const inFlight = useRef(null);
+  const autoRan = useRef(false);
+  const revalidate = useCallback(() => {
+    if (inFlight.current) return inFlight.current;
+    setStatus("validating");
+    const run = validateCart(optionsRef.current).then((outcome) => {
+      inFlight.current = null;
+      const { status: nextStatus, ...rest } = outcome;
+      setReport(rest);
+      setStatus(nextStatus);
+      return outcome;
+    });
+    inFlight.current = run;
+    return run;
+  }, []);
+  useEffect2(() => {
+    if (!auto || !hydrated || autoRan.current) return;
+    autoRan.current = true;
+    void revalidate();
+  }, [auto, hydrated, revalidate]);
+  const getLineError = useCallback(
+    (productId, variantId) => report.lineErrors[cartLineKey(productId, variantId)],
+    [report]
+  );
+  return { status, ...report, getLineError, revalidate };
+}
 export {
   CART_STORAGE_KEY,
   CART_STORE_PERSIST_VERSION,
   CartProvider,
+  DEFAULT_VALIDATE_CART_ENDPOINT,
   __resetCartStoreForTests,
+  applyCartValidation,
+  cartLineKey,
   useCart,
   useCartHydrated,
-  useCartStore
+  useCartStore,
+  useCartValidation,
+  validateCart
 };
 //# sourceMappingURL=cart.js.map

package/dist/cart.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cart/provider.tsx","../src/cart/store.ts","../src/cart/use-cart.ts"],"sourcesContent":["'use client'\n\nimport { useEffect } from 'react'\nimport { useCartStore } from './store'\n\n/**\n * `CartProvider` — mount this once near the root layout (inside a Client\n * Component boundary). It owns the ONE explicit-hydration call\n * `useCartStore.persist.rehydrate()` requires (`store.ts`'s `skipHydration`\n * doc) — a SITE that forgets to mount it gets an always-empty cart that never\n * reads back whatever a previous visit (or page reload) persisted.\n */\nexport function CartProvider({ children }: { children: React.ReactNode }) {\n  useEffect(() => {\n    useCartStore.persist.rehydrate()\n  }, [])\n\n  return <>{children}</>\n}\n","import { create } from 'zustand'\nimport { persist } from 'zustand/middleware'\n\n/**\n * `useCartStore` — the SDK's cart state (REB-829). Ported verbatim (same\n * shape, same quantity-clamping rules) from demo-site's local\n * `lib/store/cart-store.ts`, which every SITE was otherwise expected to\n * hand-copy. `CART_STORAGE_KEY` stays exactly `'shop-cart'` on purpose: a\n * SITE migrating from the local copy keeps its visitors' existing carts.\n *\n * `skipHydration: true` (zustand persist) is load-bearing for SSR: without\n * it, zustand's persist middleware reads `localStorage` synchronously during\n * module evaluation, which throws (or silently desyncs) on the server. The\n * `CartProvider` (`./provider`) calls `useCartStore.persist.rehydrate()`\n * inside a `useEffect`, so hydration only ever happens client-side, after\n * mount — the same explicit-hydration contract the SITE README documents.\n */\nexport const CART_STORAGE_KEY = 'shop-cart'\n\n/**\n * The zustand `persist` schema version for the cart's PERSISTED shape (the\n * `CartItem[]` written to `localStorage` under `CART_STORAGE_KEY`) — bump\n * this (with a `migrate` option) if that shape ever changes incompatibly.\n * Also folded into {@link CART_STORE_GLOBAL_KEY} (REB-837 review fix): a\n * future incompatible shape change should mint a NEW global singleton\n * rather than let a stale, already-evaluated old-shape instance (e.g. kept\n * alive across an HMR reload in dev) silently satisfy the new one.\n */\nexport const CART_STORE_PERSIST_VERSION = 0\n\nexport interface CartItem {\n  productId: string\n  variantId?: string | null\n  name: string\n  variantName?: string\n  /** Integer cents — every Reblu shop price travels as cents, never a float. */\n  unitPrice: number\n  quantity: number\n  imageUrl?: string\n  /** `null` means untracked/unlimited stock — never clamp against it. */\n  maxStock: number | null\n  /** Basis points, e.g. `2100` = 21%. `null`/`undefined` = unknown or exempt. */\n  taxRateBps?: number | null\n  taxRateName?: string | null\n}\n\n/**\n * Outcome of `addItem` (REB-837): a SITE's add-to-cart feedback (toast,\n * `AddToCartButton`'s built-in confirmed/error state) needs to know what\n * actually happened, not just fire-and-forget — `'clamped'` only differs\n * from `'added'` in the RESULTING quantity reaching less than what was\n * requested (capped by `maxStock`) while the line still grew; `'refused'`\n * means nothing was added (invalid quantity, out of stock, or the line was\n * already at `maxStock` — REB-839).\n */\nexport type AddItemStatus = 'added' | 'clamped' | 'refused'\n\nexport interface AddItemOutcome {\n  status: AddItemStatus\n  /** The resulting line quantity after the call (`0` when refused and no line exists). */\n  quantity: number\n}\n\nexport interface CartStore {\n  items: CartItem[]\n  addItem: (item: CartItem) => AddItemOutcome\n  removeItem: (productId: string, variantId?: string | null) => void\n  updateQuantity: (\n    productId: string,\n    variantId: string | null | undefined,\n    quantity: number,\n  ) => void\n  clearCart: () => void\n  getTotal: () => number\n  getItemCount: () => number\n}\n\nfunction isSameItem(a: CartItem, productId: string, variantId?: string | null): boolean {\n  return a.productId === productId && (a.variantId ?? null) === (variantId ?? null)\n}\n\n/**\n * REB-829 review finding: neither `addItem` nor `updateQuantity` validated\n * `quantity` — `0`, a negative number, `NaN` (e.g. a stray `parseInt('')`\n * upstream), a non-integer, or `maxStock` itself being `0` (out of stock)\n * all used to leave an invalid line sitting in the cart, silently reaching\n * checkout.\n *\n * Normalizes to a safe POSITIVE INTEGER clamped to `maxStock`. Returns `0`\n * to signal \"not a valid positive quantity\" — callers decide what that\n * means for them: `addItem` ignores the call (never creates/corrupts a\n * line), `updateQuantity` removes the line (same as its pre-existing\n * `quantity <= 0` → remove contract, just now reached by more inputs).\n *\n * `Math.trunc` rounds toward zero (not `Math.floor`, which would round a\n * negative input further negative before the `< 1` check below ever saw it\n * — not a behavioural difference here since any negative result is\n * rejected either way, but `trunc` is the operation that actually means\n * \"drop the fractional part\").\n */\nfunction normalizeQuantity(quantity: number, maxStock: number | null): number {\n  if (!Number.isFinite(quantity)) return 0\n  const truncated = Math.trunc(quantity)\n  if (truncated < 1) return 0\n  if (maxStock === null) return truncated\n  const maxTruncated = Math.trunc(maxStock)\n  if (maxTruncated < 1) return 0\n  return Math.min(truncated, maxTruncated)\n}\n\n/**\n * REB-837 cross-entry singleton guard — the mutation that caught it: a\n * single test rendering `useShopOrderStatus` (the `./shop` tsup entry) and\n * asserting on `useCartStore` (the `./cart` entry) saw the order resolve to\n * `paid` but the cart stay non-empty. Root cause: `splitting: false` (R4,\n * `tsup.config.ts`) bundles each entry standalone, so a plain relative\n * import of this file from `./shop` INLINES a SEPARATE copy of this\n * `create(...)` call — a second, disconnected store instance with its own\n * state, not the one `@reblu/site-next/cart` consumers read. `clearCart()`\n * from inside the hook silently cleared the WRONG store.\n *\n * `globalThis` keyed by a `Symbol.for(...)` (same registry entry regardless\n * of which bundle's copy of this module evaluates it first) makes every\n * entry that imports this file — however many times esbuild inlines it —\n * resolve to the SAME store. Verified by mutation: removing this guard\n * (reverting to a bare `export const useCartStore = create(...)`) turns\n * `use-shop-order-status.test.ts`'s cart-clearing assertions red again once\n * the hook is exercised through its OWN entry rather than imported directly\n * within `cart`'s own test file (which never saw the bug, since it only\n * ever touches ONE copy of this module).\n */\nfunction createCartStore() {\n  return create<CartStore>()(\n    persist(\n      (set, get) => ({\n        items: [],\n\n        addItem: (item) => {\n          // REB-837: `set`'s updater can't return a value to the caller, so the\n          // outcome is captured in this closure variable and returned after.\n          let outcome: AddItemOutcome = { status: 'refused', quantity: 0 }\n\n          set((state) => {\n            const existing = state.items.find((i) => isSameItem(i, item.productId, item.variantId))\n\n            if (existing) {\n              // REB-829 review follow-up (a): incoming maxStock is the\n              // FRESHEST stock signal available — if it says 0, the product is\n              // confirmed out of stock right now, so the existing line is\n              // removed outright (same contract as updateQuantity's own\n              // \"quantity resolves to <1 → remove\"), not merely left alone.\n              if (item.maxStock !== null && Math.trunc(item.maxStock) < 1) {\n                outcome = { status: 'refused', quantity: 0 }\n                return {\n                  items: state.items.filter((i) => !isSameItem(i, item.productId, item.variantId)),\n                }\n              }\n\n              const requestedQty = existing.quantity + item.quantity\n              const newQty = normalizeQuantity(requestedQty, item.maxStock)\n              if (newQty < 1) {\n                // Invalid delta (NaN/non-positive quantity) — leave the\n                // existing, previously-valid line untouched rather than\n                // destroying good data because of one bad call.\n                outcome = { status: 'refused', quantity: existing.quantity }\n                return {}\n              }\n\n              // REB-839: nothing was gained when stock caps the line at (or,\n              // with fresher stock, below) what it already held — report that\n              // as 'refused', never as a partial-success 'clamped'. The line is\n              // still reconciled below to the fresher maxStock.\n              outcome = {\n                status:\n                  newQty <= existing.quantity\n                    ? 'refused'\n                    : newQty < requestedQty\n                      ? 'clamped'\n                      : 'added',\n                quantity: newQty,\n              }\n\n              // Refresh maxStock with the incoming value on every successful\n              // merge — the stale-maxStock finding: a stored line used to keep\n              // its ORIGINAL maxStock forever, so a later updateQuantity call\n              // clamped against stock data that could be long out of date.\n              return {\n                items: state.items.map((i) =>\n                  isSameItem(i, item.productId, item.variantId)\n                    ? { ...i, quantity: newQty, maxStock: item.maxStock }\n                    : i,\n                ),\n              }\n            }\n\n            const qty = normalizeQuantity(item.quantity, item.maxStock)\n            if (qty < 1) {\n              // Invalid quantity, or maxStock 0 (out of stock) — never create\n              // a line nobody could actually buy.\n              outcome = { status: 'refused', quantity: 0 }\n              return {}\n            }\n\n            outcome = { status: qty < item.quantity ? 'clamped' : 'added', quantity: qty }\n            return { items: [...state.items, { ...item, quantity: qty }] }\n          })\n\n          return outcome\n        },\n\n        removeItem: (productId, variantId) => {\n          set((state) => ({\n            items: state.items.filter((i) => !isSameItem(i, productId, variantId)),\n          }))\n        },\n\n        updateQuantity: (productId, variantId, quantity) => {\n          const existing = get().items.find((i) => isSameItem(i, productId, variantId))\n          if (!existing) return\n\n          const newQty = normalizeQuantity(quantity, existing.maxStock)\n          if (newQty < 1) {\n            get().removeItem(productId, variantId)\n            return\n          }\n\n          set((state) => ({\n            items: state.items.map((i) =>\n              isSameItem(i, productId, variantId) ? { ...i, quantity: newQty } : i,\n            ),\n          }))\n        },\n\n        clearCart: () => set({ items: [] }),\n\n        getTotal: () => get().items.reduce((sum, item) => sum + item.unitPrice * item.quantity, 0),\n\n        getItemCount: () => get().items.reduce((sum, item) => sum + item.quantity, 0),\n      }),\n      {\n        name: CART_STORAGE_KEY,\n        version: CART_STORE_PERSIST_VERSION,\n        skipHydration: true,\n      },\n    ),\n  )\n}\n\ntype CartStoreApi = ReturnType<typeof createCartStore>\n\n/**\n * Versioned (REB-837 review fix) with {@link CART_STORE_PERSIST_VERSION} —\n * an incompatible shape change bumps that version, which mints a NEW\n * `Symbol.for(...)` registry key, so a stale old-shape singleton (e.g. kept\n * alive across an HMR reload in dev before a code change takes effect)\n * never satisfies the new one.\n */\nconst CART_STORE_GLOBAL_KEY = Symbol.for(\n  `@reblu/site-next/cart-store@v${CART_STORE_PERSIST_VERSION}`,\n)\n\ninterface GlobalWithCartStore {\n  [CART_STORE_GLOBAL_KEY]?: CartStoreApi\n}\n\nconst globalForCartStore = globalThis as typeof globalThis & GlobalWithCartStore\n\nexport const useCartStore: CartStoreApi =\n  globalForCartStore[CART_STORE_GLOBAL_KEY] ??\n  (globalForCartStore[CART_STORE_GLOBAL_KEY] = createCartStore())\n\n/**\n * TEST-ONLY (REB-837 review fix). Clears the `globalThis`-keyed slot so the\n * NEXT access to `useCartStore` — in THIS module instance — creates a fresh\n * store. The singleton is intentionally shared process-wide; most tests\n * should keep resetting STATE via `useCartStore.setState(...)` in\n * `beforeEach`, not the instance itself. Reach for this only to prove\n * something about the singleton mechanism (e.g. the cross-entry test in\n * `tests/cart-store-cross-entry-singleton.test.ts`) — it does not and\n * cannot affect an ALREADY-evaluated copy of this module inlined into a\n * different tsup entry's bundle (each such copy owns its own `const\n * globalForCartStore`/`CART_STORE_GLOBAL_KEY` closed over at that copy's\n * own module-evaluation time, same as any other ES module binding).\n */\nexport function __resetCartStoreForTests(): void {\n  delete globalForCartStore[CART_STORE_GLOBAL_KEY]\n}\n","'use client'\n\nimport { useSyncExternalStore } from 'react'\n\nimport { useCartStore, type AddItemOutcome, type CartItem } from './store'\n\nexport interface UseCartResult {\n  items: CartItem[]\n  /** Sum of every line's `unitPrice * quantity`, in integer cents. */\n  total: number\n  /** Sum of every line's `quantity`. */\n  itemCount: number\n  /**\n   * Whether `CartProvider`'s `persist.rehydrate()` has finished (REB-837).\n   * `false` on the server and on the very first client render — `items`\n   * (and therefore `itemCount`) jumps from `0` to whatever was persisted the\n   * instant hydration finishes, which is NOT a real \"item added\" event. A\n   * consumer driving `CartIcon`'s `bumpOnAdd` MUST gate the bump on this\n   * flag (see `CartIcon`'s own guard) or every page load with a non-empty\n   * cart bumps the badge once for free.\n   */\n  hydrated: boolean\n  addItem: (item: CartItem) => AddItemOutcome\n  removeItem: (productId: string, variantId?: string | null) => void\n  updateQuantity: (\n    productId: string,\n    variantId: string | null | undefined,\n    quantity: number,\n  ) => void\n  clearCart: () => void\n}\n\nfunction subscribeHydration(onStoreChange: () => void): () => void {\n  return useCartStore.persist.onFinishHydration(onStoreChange)\n}\n\nfunction getHydratedSnapshot(): boolean {\n  return useCartStore.persist.hasHydrated()\n}\n\n/** Server snapshot is always `false` — the server never reads `localStorage`. */\nfunction getServerHydratedSnapshot(): boolean {\n  return false\n}\n\n/**\n * `useCartHydrated` — standalone so a SITE that only needs the flag (e.g. to\n * gate its own effects) doesn't have to subscribe to the whole cart via\n * `useCart()`.\n */\nexport function useCartHydrated(): boolean {\n  return useSyncExternalStore(subscribeHydration, getHydratedSnapshot, getServerHydratedSnapshot)\n}\n\n/**\n * `useCart` — the ergonomic entry point for a SITE's cart UI: a single\n * selector call that re-renders only on `items` changes, with `total`/\n * `itemCount` derived inline (cheap — a plain `reduce` over a typically-small\n * array) rather than via `useCartStore`'s own `getTotal`/`getItemCount`\n * selectors, which are stable function references and would NOT trigger a\n * re-render on their own. A SITE that wants raw store access (existing\n * per-field selectors, e.g. `useCartStore((s) => s.addItem)`) can still\n * import `useCartStore` directly — this hook doesn't replace it.\n */\nexport function useCart(): UseCartResult {\n  const items = useCartStore((s) => s.items)\n  const addItem = useCartStore((s) => s.addItem)\n  const removeItem = useCartStore((s) => s.removeItem)\n  const updateQuantity = useCartStore((s) => s.updateQuantity)\n  const clearCart = useCartStore((s) => s.clearCart)\n  const hydrated = useCartHydrated()\n\n  const total = items.reduce((sum, item) => sum + item.unitPrice * item.quantity, 0)\n  const itemCount = items.reduce((sum, item) => sum + item.quantity, 0)\n\n  return { items, total, itemCount, hydrated, addItem, removeItem, updateQuantity, clearCart }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/cart/provider.tsx","../src/cart/store.ts","../src/cart/use-cart.ts","../src/cart/validate.ts","../src/cart/use-cart-validation.ts"],"sourcesContent":["'use client'\n\nimport { useEffect } from 'react'\nimport { useCartStore } from './store'\n\n/**\n * `CartProvider` — mount this once near the root layout (inside a Client\n * Component boundary). It owns the ONE explicit-hydration call\n * `useCartStore.persist.rehydrate()` requires (`store.ts`'s `skipHydration`\n * doc) — a SITE that forgets to mount it gets an always-empty cart that never\n * reads back whatever a previous visit (or page reload) persisted.\n */\nexport function CartProvider({ children }: { children: React.ReactNode }) {\n  useEffect(() => {\n    useCartStore.persist.rehydrate()\n  }, [])\n\n  return <>{children}</>\n}\n","import { create } from 'zustand'\nimport { persist } from 'zustand/middleware'\n\n/**\n * `useCartStore` — the SDK's cart state (REB-829). Ported verbatim (same\n * shape, same quantity-clamping rules) from demo-site's local\n * `lib/store/cart-store.ts`, which every SITE was otherwise expected to\n * hand-copy. `CART_STORAGE_KEY` stays exactly `'shop-cart'` on purpose: a\n * SITE migrating from the local copy keeps its visitors' existing carts.\n *\n * `skipHydration: true` (zustand persist) is load-bearing for SSR: without\n * it, zustand's persist middleware reads `localStorage` synchronously during\n * module evaluation, which throws (or silently desyncs) on the server. The\n * `CartProvider` (`./provider`) calls `useCartStore.persist.rehydrate()`\n * inside a `useEffect`, so hydration only ever happens client-side, after\n * mount — the same explicit-hydration contract the SITE README documents.\n */\nexport const CART_STORAGE_KEY = 'shop-cart'\n\n/**\n * The zustand `persist` schema version for the cart's PERSISTED shape (the\n * `CartItem[]` written to `localStorage` under `CART_STORAGE_KEY`) — bump\n * this (with a `migrate` option) if that shape ever changes incompatibly.\n * Also folded into {@link CART_STORE_GLOBAL_KEY} (REB-837 review fix): a\n * future incompatible shape change should mint a NEW global singleton\n * rather than let a stale, already-evaluated old-shape instance (e.g. kept\n * alive across an HMR reload in dev) silently satisfy the new one.\n */\nexport const CART_STORE_PERSIST_VERSION = 0\n\nexport interface CartItem {\n  productId: string\n  variantId?: string | null\n  name: string\n  variantName?: string\n  /** Integer cents — every Reblu shop price travels as cents, never a float. */\n  unitPrice: number\n  quantity: number\n  imageUrl?: string\n  /** `null` means untracked/unlimited stock — never clamp against it. */\n  maxStock: number | null\n  /** Basis points, e.g. `2100` = 21%. `null`/`undefined` = unknown or exempt. */\n  taxRateBps?: number | null\n  taxRateName?: string | null\n}\n\n/**\n * Outcome of `addItem` (REB-837): a SITE's add-to-cart feedback (toast,\n * `AddToCartButton`'s built-in confirmed/error state) needs to know what\n * actually happened, not just fire-and-forget — `'clamped'` only differs\n * from `'added'` in the RESULTING quantity reaching less than what was\n * requested (capped by `maxStock`) while the line still grew; `'refused'`\n * means nothing was added (invalid quantity, out of stock, or the line was\n * already at `maxStock` — REB-839).\n */\nexport type AddItemStatus = 'added' | 'clamped' | 'refused'\n\nexport interface AddItemOutcome {\n  status: AddItemStatus\n  /** The resulting line quantity after the call (`0` when refused and no line exists). */\n  quantity: number\n}\n\nexport interface CartStore {\n  items: CartItem[]\n  addItem: (item: CartItem) => AddItemOutcome\n  removeItem: (productId: string, variantId?: string | null) => void\n  updateQuantity: (\n    productId: string,\n    variantId: string | null | undefined,\n    quantity: number,\n  ) => void\n  clearCart: () => void\n  getTotal: () => number\n  getItemCount: () => number\n}\n\nfunction isSameItem(a: CartItem, productId: string, variantId?: string | null): boolean {\n  return a.productId === productId && (a.variantId ?? null) === (variantId ?? null)\n}\n\n/**\n * REB-829 review finding: neither `addItem` nor `updateQuantity` validated\n * `quantity` — `0`, a negative number, `NaN` (e.g. a stray `parseInt('')`\n * upstream), a non-integer, or `maxStock` itself being `0` (out of stock)\n * all used to leave an invalid line sitting in the cart, silently reaching\n * checkout.\n *\n * Normalizes to a safe POSITIVE INTEGER clamped to `maxStock`. Returns `0`\n * to signal \"not a valid positive quantity\" — callers decide what that\n * means for them: `addItem` ignores the call (never creates/corrupts a\n * line), `updateQuantity` removes the line (same as its pre-existing\n * `quantity <= 0` → remove contract, just now reached by more inputs).\n *\n * `Math.trunc` rounds toward zero (not `Math.floor`, which would round a\n * negative input further negative before the `< 1` check below ever saw it\n * — not a behavioural difference here since any negative result is\n * rejected either way, but `trunc` is the operation that actually means\n * \"drop the fractional part\").\n */\nfunction normalizeQuantity(quantity: number, maxStock: number | null): number {\n  if (!Number.isFinite(quantity)) return 0\n  const truncated = Math.trunc(quantity)\n  if (truncated < 1) return 0\n  if (maxStock === null) return truncated\n  const maxTruncated = Math.trunc(maxStock)\n  if (maxTruncated < 1) return 0\n  return Math.min(truncated, maxTruncated)\n}\n\n/**\n * REB-837 cross-entry singleton guard — the mutation that caught it: a\n * single test rendering `useShopOrderStatus` (the `./shop` tsup entry) and\n * asserting on `useCartStore` (the `./cart` entry) saw the order resolve to\n * `paid` but the cart stay non-empty. Root cause: `splitting: false` (R4,\n * `tsup.config.ts`) bundles each entry standalone, so a plain relative\n * import of this file from `./shop` INLINES a SEPARATE copy of this\n * `create(...)` call — a second, disconnected store instance with its own\n * state, not the one `@reblu/site-next/cart` consumers read. `clearCart()`\n * from inside the hook silently cleared the WRONG store.\n *\n * `globalThis` keyed by a `Symbol.for(...)` (same registry entry regardless\n * of which bundle's copy of this module evaluates it first) makes every\n * entry that imports this file — however many times esbuild inlines it —\n * resolve to the SAME store. Verified by mutation: removing this guard\n * (reverting to a bare `export const useCartStore = create(...)`) turns\n * `use-shop-order-status.test.ts`'s cart-clearing assertions red again once\n * the hook is exercised through its OWN entry rather than imported directly\n * within `cart`'s own test file (which never saw the bug, since it only\n * ever touches ONE copy of this module).\n */\nfunction createCartStore() {\n  return create<CartStore>()(\n    persist(\n      (set, get) => ({\n        items: [],\n\n        addItem: (item) => {\n          // REB-837: `set`'s updater can't return a value to the caller, so the\n          // outcome is captured in this closure variable and returned after.\n          let outcome: AddItemOutcome = { status: 'refused', quantity: 0 }\n\n          set((state) => {\n            const existing = state.items.find((i) => isSameItem(i, item.productId, item.variantId))\n\n            if (existing) {\n              // REB-829 review follow-up (a): incoming maxStock is the\n              // FRESHEST stock signal available — if it says 0, the product is\n              // confirmed out of stock right now, so the existing line is\n              // removed outright (same contract as updateQuantity's own\n              // \"quantity resolves to <1 → remove\"), not merely left alone.\n              if (item.maxStock !== null && Math.trunc(item.maxStock) < 1) {\n                outcome = { status: 'refused', quantity: 0 }\n                return {\n                  items: state.items.filter((i) => !isSameItem(i, item.productId, item.variantId)),\n                }\n              }\n\n              const requestedQty = existing.quantity + item.quantity\n              const newQty = normalizeQuantity(requestedQty, item.maxStock)\n              if (newQty < 1) {\n                // Invalid delta (NaN/non-positive quantity) — leave the\n                // existing, previously-valid line untouched rather than\n                // destroying good data because of one bad call.\n                outcome = { status: 'refused', quantity: existing.quantity }\n                return {}\n              }\n\n              // REB-839: nothing was gained when stock caps the line at (or,\n              // with fresher stock, below) what it already held — report that\n              // as 'refused', never as a partial-success 'clamped'. The line is\n              // still reconciled below to the fresher maxStock.\n              outcome = {\n                status:\n                  newQty <= existing.quantity\n                    ? 'refused'\n                    : newQty < requestedQty\n                      ? 'clamped'\n                      : 'added',\n                quantity: newQty,\n              }\n\n              // Refresh maxStock with the incoming value on every successful\n              // merge — the stale-maxStock finding: a stored line used to keep\n              // its ORIGINAL maxStock forever, so a later updateQuantity call\n              // clamped against stock data that could be long out of date.\n              return {\n                items: state.items.map((i) =>\n                  isSameItem(i, item.productId, item.variantId)\n                    ? { ...i, quantity: newQty, maxStock: item.maxStock }\n                    : i,\n                ),\n              }\n            }\n\n            const qty = normalizeQuantity(item.quantity, item.maxStock)\n            if (qty < 1) {\n              // Invalid quantity, or maxStock 0 (out of stock) — never create\n              // a line nobody could actually buy.\n              outcome = { status: 'refused', quantity: 0 }\n              return {}\n            }\n\n            outcome = { status: qty < item.quantity ? 'clamped' : 'added', quantity: qty }\n            return { items: [...state.items, { ...item, quantity: qty }] }\n          })\n\n          return outcome\n        },\n\n        removeItem: (productId, variantId) => {\n          set((state) => ({\n            items: state.items.filter((i) => !isSameItem(i, productId, variantId)),\n          }))\n        },\n\n        updateQuantity: (productId, variantId, quantity) => {\n          const existing = get().items.find((i) => isSameItem(i, productId, variantId))\n          if (!existing) return\n\n          const newQty = normalizeQuantity(quantity, existing.maxStock)\n          if (newQty < 1) {\n            get().removeItem(productId, variantId)\n            return\n          }\n\n          set((state) => ({\n            items: state.items.map((i) =>\n              isSameItem(i, productId, variantId) ? { ...i, quantity: newQty } : i,\n            ),\n          }))\n        },\n\n        clearCart: () => set({ items: [] }),\n\n        getTotal: () => get().items.reduce((sum, item) => sum + item.unitPrice * item.quantity, 0),\n\n        getItemCount: () => get().items.reduce((sum, item) => sum + item.quantity, 0),\n      }),\n      {\n        name: CART_STORAGE_KEY,\n        version: CART_STORE_PERSIST_VERSION,\n        skipHydration: true,\n      },\n    ),\n  )\n}\n\ntype CartStoreApi = ReturnType<typeof createCartStore>\n\n/**\n * Versioned (REB-837 review fix) with {@link CART_STORE_PERSIST_VERSION} —\n * an incompatible shape change bumps that version, which mints a NEW\n * `Symbol.for(...)` registry key, so a stale old-shape singleton (e.g. kept\n * alive across an HMR reload in dev before a code change takes effect)\n * never satisfies the new one.\n */\nconst CART_STORE_GLOBAL_KEY = Symbol.for(\n  `@reblu/site-next/cart-store@v${CART_STORE_PERSIST_VERSION}`,\n)\n\ninterface GlobalWithCartStore {\n  [CART_STORE_GLOBAL_KEY]?: CartStoreApi\n}\n\nconst globalForCartStore = globalThis as typeof globalThis & GlobalWithCartStore\n\nexport const useCartStore: CartStoreApi =\n  globalForCartStore[CART_STORE_GLOBAL_KEY] ??\n  (globalForCartStore[CART_STORE_GLOBAL_KEY] = createCartStore())\n\n/**\n * TEST-ONLY (REB-837 review fix). Clears the `globalThis`-keyed slot so the\n * NEXT access to `useCartStore` — in THIS module instance — creates a fresh\n * store. The singleton is intentionally shared process-wide; most tests\n * should keep resetting STATE via `useCartStore.setState(...)` in\n * `beforeEach`, not the instance itself. Reach for this only to prove\n * something about the singleton mechanism (e.g. the cross-entry test in\n * `tests/cart-store-cross-entry-singleton.test.ts`) — it does not and\n * cannot affect an ALREADY-evaluated copy of this module inlined into a\n * different tsup entry's bundle (each such copy owns its own `const\n * globalForCartStore`/`CART_STORE_GLOBAL_KEY` closed over at that copy's\n * own module-evaluation time, same as any other ES module binding).\n */\nexport function __resetCartStoreForTests(): void {\n  delete globalForCartStore[CART_STORE_GLOBAL_KEY]\n}\n","'use client'\n\nimport { useSyncExternalStore } from 'react'\n\nimport { useCartStore, type AddItemOutcome, type CartItem } from './store'\n\nexport interface UseCartResult {\n  items: CartItem[]\n  /** Sum of every line's `unitPrice * quantity`, in integer cents. */\n  total: number\n  /** Sum of every line's `quantity`. */\n  itemCount: number\n  /**\n   * Whether `CartProvider`'s `persist.rehydrate()` has finished (REB-837).\n   * `false` on the server and on the very first client render — `items`\n   * (and therefore `itemCount`) jumps from `0` to whatever was persisted the\n   * instant hydration finishes, which is NOT a real \"item added\" event. A\n   * consumer driving `CartIcon`'s `bumpOnAdd` MUST gate the bump on this\n   * flag (see `CartIcon`'s own guard) or every page load with a non-empty\n   * cart bumps the badge once for free.\n   */\n  hydrated: boolean\n  addItem: (item: CartItem) => AddItemOutcome\n  removeItem: (productId: string, variantId?: string | null) => void\n  updateQuantity: (\n    productId: string,\n    variantId: string | null | undefined,\n    quantity: number,\n  ) => void\n  clearCart: () => void\n}\n\nfunction subscribeHydration(onStoreChange: () => void): () => void {\n  return useCartStore.persist.onFinishHydration(onStoreChange)\n}\n\nfunction getHydratedSnapshot(): boolean {\n  return useCartStore.persist.hasHydrated()\n}\n\n/** Server snapshot is always `false` — the server never reads `localStorage`. */\nfunction getServerHydratedSnapshot(): boolean {\n  return false\n}\n\n/**\n * `useCartHydrated` — standalone so a SITE that only needs the flag (e.g. to\n * gate its own effects) doesn't have to subscribe to the whole cart via\n * `useCart()`.\n */\nexport function useCartHydrated(): boolean {\n  return useSyncExternalStore(subscribeHydration, getHydratedSnapshot, getServerHydratedSnapshot)\n}\n\n/**\n * `useCart` — the ergonomic entry point for a SITE's cart UI: a single\n * selector call that re-renders only on `items` changes, with `total`/\n * `itemCount` derived inline (cheap — a plain `reduce` over a typically-small\n * array) rather than via `useCartStore`'s own `getTotal`/`getItemCount`\n * selectors, which are stable function references and would NOT trigger a\n * re-render on their own. A SITE that wants raw store access (existing\n * per-field selectors, e.g. `useCartStore((s) => s.addItem)`) can still\n * import `useCartStore` directly — this hook doesn't replace it.\n */\nexport function useCart(): UseCartResult {\n  const items = useCartStore((s) => s.items)\n  const addItem = useCartStore((s) => s.addItem)\n  const removeItem = useCartStore((s) => s.removeItem)\n  const updateQuantity = useCartStore((s) => s.updateQuantity)\n  const clearCart = useCartStore((s) => s.clearCart)\n  const hydrated = useCartHydrated()\n\n  const total = items.reduce((sum, item) => sum + item.unitPrice * item.quantity, 0)\n  const itemCount = items.reduce((sum, item) => sum + item.quantity, 0)\n\n  return { items, total, itemCount, hydrated, addItem, removeItem, updateQuantity, clearCart }\n}\n","import type {\n  ShopCartValidation,\n  ShopCartValidationError,\n  ShopValidateCartInput,\n} from '@reblu/site-contracts'\n\nimport { useCartStore, type CartItem } from './store'\n\n/**\n * Cart validation (REB-981). A persisted cart (`localStorage` `shop-cart`)\n * outlives the catalog it was filled from: a product can be deleted,\n * deactivated, sold out or repriced between visits. `validateCart` asks the\n * SITE's validate-cart Route Handler (`createShopValidateCartRoute`) about\n * every line and APPLIES the answer to the store, so the cart page and the\n * checkout never show or submit a line nobody can buy.\n */\n\n/** Calls validate-cart for the given lines. Must reject (or throw) on failure. */\nexport type CartValidator = (input: ShopValidateCartInput) => Promise<ShopCartValidation>\n\nexport interface ValidateCartOptions {\n  /**\n   * The SITE's validate-cart Route Handler path, used by the default\n   * validator. Defaults to `'/api/shop/validate-cart'`.\n   */\n  endpoint?: string\n  /** Replaces the default `fetch`-based validator entirely. */\n  validate?: CartValidator\n  /**\n   * `true` (default) removes lines whose error says `suggestedAction:\n   * 'remove'` (`not_found`, `inactive`, `out_of_stock`). `false` leaves them\n   * in the cart and only reports them through `lineErrors`.\n   */\n  removeUnavailable?: boolean\n}\n\n/** A line the validation removed — `name`/`variantName` come from the persisted line. */\nexport interface CartRemovedLine {\n  productId: string\n  variantId: string | null\n  name: string\n  variantName?: string\n  type: ShopCartValidationError['type']\n  message: string\n}\n\n/** A line whose quantity was clamped to the stock still available. */\nexport interface CartQuantityChange {\n  productId: string\n  variantId: string | null\n  name: string\n  variantName?: string\n  from: number\n  to: number\n}\n\n/** A line whose `unitPrice` (integer cents) was refreshed from the live price. */\nexport interface CartPriceChange {\n  productId: string\n  variantId: string | null\n  name: string\n  variantName?: string\n  from: number\n  to: number\n}\n\n/**\n * - `valid` — every line is buyable as it stands; nothing changed.\n * - `adjusted` — the cart was changed (lines removed, quantities clamped or\n *   prices refreshed). Show the changes before letting the visitor pay.\n * - `invalid` — problems remain that were not applied (lines flagged with\n *   `removeUnavailable: false`, or a cart-wide error).\n * - `empty` — no lines; nothing was sent.\n * - `failed` — the request failed; the cart was left exactly as it was.\n */\nexport type CartValidationStatus = 'valid' | 'adjusted' | 'invalid' | 'empty' | 'failed'\n\nexport interface CartValidationOutcome {\n  status: CartValidationStatus\n  removed: CartRemovedLine[]\n  quantityChanges: CartQuantityChange[]\n  priceChanges: CartPriceChange[]\n  /** Every line error of the response, keyed by {@link cartLineKey}. */\n  lineErrors: Record<string, ShopCartValidationError>\n  /** Errors that match no cart line (e.g. `empty_cart`) or were not applied. */\n  unresolvedErrors: ShopCartValidationError[]\n  /** Set when `status` is `'failed'`. */\n  error?: unknown\n}\n\nexport const DEFAULT_VALIDATE_CART_ENDPOINT = '/api/shop/validate-cart'\n\n/** Stable key for a cart line: `productId` + `variantId` (absent and `null` are the same line). */\nexport function cartLineKey(productId: string, variantId?: string | null): string {\n  return JSON.stringify([productId, variantId ?? null])\n}\n\nfunction emptyOutcome(status: CartValidationStatus): CartValidationOutcome {\n  return {\n    status,\n    removed: [],\n    quantityChanges: [],\n    priceChanges: [],\n    lineErrors: {},\n    unresolvedErrors: [],\n  }\n}\n\nfunction isValidation(value: unknown): value is ShopCartValidation {\n  if (!value || typeof value !== 'object') return false\n  const v = value as Record<string, unknown>\n  return typeof v.valid === 'boolean' && Array.isArray(v.errors) && Array.isArray(v.items)\n}\n\nfunction defaultValidator(endpoint: string): CartValidator {\n  return async (input) => {\n    const res = await fetch(endpoint, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify(input),\n    })\n    if (!res.ok) {\n      throw new Error(`validate-cart failed with HTTP ${res.status}`)\n    }\n    const json: unknown = await res.json()\n    const data = json && typeof json === 'object' ? (json as { data?: unknown }).data : undefined\n    if (!isValidation(data)) {\n      throw new Error('validate-cart returned an unexpected body')\n    }\n    return data\n  }\n}\n\nfunction waitForHydration(): Promise<void> {\n  if (useCartStore.persist.hasHydrated()) return Promise.resolve()\n  return new Promise((resolve) => {\n    const unsubscribe = useCartStore.persist.onFinishHydration(() => {\n      unsubscribe()\n      resolve()\n    })\n  })\n}\n\n/**\n * Pure: applies a validate-cart response to a list of lines. Lines the\n * response does not mention (e.g. added while the request was in flight)\n * are left untouched.\n */\nexport function applyCartValidation(\n  items: CartItem[],\n  validation: ShopCartValidation,\n  { removeUnavailable = true }: Pick<ValidateCartOptions, 'removeUnavailable'> = {},\n): Omit<CartValidationOutcome, 'status' | 'error'> & { items: CartItem[] } {\n  const removed: CartRemovedLine[] = []\n  const quantityChanges: CartQuantityChange[] = []\n  const priceChanges: CartPriceChange[] = []\n  const lineErrors: Record<string, ShopCartValidationError> = {}\n  const unresolvedErrors: ShopCartValidationError[] = []\n\n  const byKey = new Map(items.map((item) => [cartLineKey(item.productId, item.variantId), item]))\n  const removeKeys = new Set<string>()\n  const newQuantity = new Map<string, number>()\n\n  for (const error of validation.errors) {\n    const key = cartLineKey(error.productId, error.variantId)\n    const line = byKey.get(key)\n    if (!line) {\n      unresolvedErrors.push(error)\n      continue\n    }\n    lineErrors[key] = error\n    if (error.suggestedAction === 'remove' && removeUnavailable) {\n      removeKeys.add(key)\n      removed.push({\n        productId: line.productId,\n        variantId: line.variantId ?? null,\n        name: line.name,\n        ...(line.variantName !== undefined && { variantName: line.variantName }),\n        type: error.type,\n        message: error.message,\n      })\n    } else if (error.suggestedAction === 'update_quantity' && typeof error.newQuantity === 'number') {\n      newQuantity.set(key, error.newQuantity)\n    } else {\n      // Flagged but not applied (`removeUnavailable: false`, or an action\n      // this version does not know) — the line stays and still blocks.\n      unresolvedErrors.push(error)\n    }\n  }\n\n  const live = new Map(\n    validation.items.map((item) => [cartLineKey(item.productId, item.variantId), item]),\n  )\n\n  const next: CartItem[] = []\n  for (const line of items) {\n    const key = cartLineKey(line.productId, line.variantId)\n    if (removeKeys.has(key)) continue\n\n    let updated = line\n    const liveItem = live.get(key)\n    if (liveItem) {\n      if (liveItem.unitPrice !== line.unitPrice) {\n        priceChanges.push({\n          productId: line.productId,\n          variantId: line.variantId ?? null,\n          name: line.name,\n          ...(line.variantName !== undefined && { variantName: line.variantName }),\n          from: line.unitPrice,\n          to: liveItem.unitPrice,\n        })\n        updated = { ...updated, unitPrice: liveItem.unitPrice }\n      }\n      if (liveItem.maxStock !== line.maxStock) {\n        updated = { ...updated, maxStock: liveItem.maxStock }\n      }\n    }\n\n    const clampTo = newQuantity.get(key)\n    if (clampTo !== undefined) {\n      const to = Math.trunc(clampTo)\n      if (to < 1) {\n        // No stock left at all — treat as unavailable.\n        removed.push({\n          productId: line.productId,\n          variantId: line.variantId ?? null,\n          name: line.name,\n          ...(line.variantName !== undefined && { variantName: line.variantName }),\n          type: 'out_of_stock',\n          message: lineErrors[key]?.message ?? '',\n        })\n        continue\n      }\n      if (to < line.quantity) {\n        quantityChanges.push({\n          productId: line.productId,\n          variantId: line.variantId ?? null,\n          name: line.name,\n          ...(line.variantName !== undefined && { variantName: line.variantName }),\n          from: line.quantity,\n          to,\n        })\n        updated = { ...updated, quantity: to }\n      }\n    }\n\n    next.push(updated)\n  }\n\n  return { items: next, removed, quantityChanges, priceChanges, lineErrors, unresolvedErrors }\n}\n\n/**\n * Validates the persisted cart against live product, stock and price data\n * and applies the result to `useCartStore`:\n *\n * 1. removes lines the API says to remove, reporting their persisted names;\n * 2. clamps `insufficient_stock` lines to the quantity still available;\n * 3. refreshes `unitPrice` (and `maxStock`) from the live data.\n *\n * Waits for `CartProvider`'s hydration first, so it never validates the\n * empty pre-hydration cart. Never throws: a failed request resolves to\n * `status: 'failed'` and leaves the cart untouched. Running it again on an\n * already-clean cart is a no-op (`status: 'valid'`).\n */\nexport async function validateCart(options: ValidateCartOptions = {}): Promise<CartValidationOutcome> {\n  await waitForHydration()\n\n  const items = useCartStore.getState().items\n  if (items.length === 0) return emptyOutcome('empty')\n\n  const validate = options.validate ?? defaultValidator(options.endpoint ?? DEFAULT_VALIDATE_CART_ENDPOINT)\n\n  let validation: ShopCartValidation\n  try {\n    validation = await validate({\n      items: items.map((i) => ({\n        productId: i.productId,\n        variantId: i.variantId,\n        quantity: i.quantity,\n      })),\n    })\n  } catch (error) {\n    return { ...emptyOutcome('failed'), error }\n  }\n\n  // Apply against the CURRENT lines, not the snapshot sent: the visitor may\n  // have changed the cart while the request was in flight.\n  const applied = applyCartValidation(useCartStore.getState().items, validation, options)\n  const { items: nextItems, ...report } = applied\n  const changed =\n    report.removed.length > 0 || report.quantityChanges.length > 0 || report.priceChanges.length > 0\n  const current = useCartStore.getState().items\n  // Only write when a line object actually changed (a refreshed `maxStock`\n  // alone counts) — an unchanged cart never re-renders its subscribers.\n  if (nextItems.length !== current.length || nextItems.some((item, i) => item !== current[i])) {\n    useCartStore.setState({ items: nextItems })\n  }\n\n  const status: CartValidationStatus =\n    report.unresolvedErrors.length > 0 ? 'invalid' : changed ? 'adjusted' : 'valid'\n\n  return { status, ...report }\n}\n","'use client'\n\nimport { useCallback, useEffect, useRef, useState } from 'react'\nimport type { ShopCartValidationError } from '@reblu/site-contracts'\n\nimport { useCartHydrated } from './use-cart'\nimport {\n  cartLineKey,\n  validateCart,\n  type CartValidationOutcome,\n  type CartValidationStatus,\n  type ValidateCartOptions,\n} from './validate'\n\nexport interface UseCartValidationOptions extends ValidateCartOptions {\n  /** Validate once automatically when the cart has hydrated. Defaults to `true`. */\n  auto?: boolean\n}\n\nexport interface UseCartValidationResult extends Omit<CartValidationOutcome, 'status'> {\n  /** `'idle'` before the first run, `'validating'` while a request is in flight. */\n  status: CartValidationStatus | 'idle' | 'validating'\n  /** The error the last run reported for this line, if any. */\n  getLineError: (productId: string, variantId?: string | null) => ShopCartValidationError | undefined\n  /**\n   * Runs the validation now (e.g. right before submitting the checkout) and\n   * resolves to its outcome. Concurrent calls share the in-flight request.\n   */\n  revalidate: () => Promise<CartValidationOutcome>\n}\n\nconst IDLE: Omit<CartValidationOutcome, 'status'> = {\n  removed: [],\n  quantityChanges: [],\n  priceChanges: [],\n  lineErrors: {},\n  unresolvedErrors: [],\n}\n\n/**\n * `useCartValidation` (REB-981) — runs {@link validateCart} once when the\n * cart has hydrated (cart page mount) and exposes the last outcome, so the\n * page can show what was removed or adjusted and mark the offending lines.\n * Call `revalidate()` before checkout. Later cart edits never re-trigger the\n * automatic run, so it cannot loop.\n */\nexport function useCartValidation(options: UseCartValidationOptions = {}): UseCartValidationResult {\n  const { auto = true } = options\n  const hydrated = useCartHydrated()\n  const [status, setStatus] = useState<UseCartValidationResult['status']>('idle')\n  const [report, setReport] = useState<Omit<CartValidationOutcome, 'status'>>(IDLE)\n\n  // Latest options without re-creating `revalidate` (synced after render,\n  // never written during it).\n  const optionsRef = useRef(options)\n  useEffect(() => {\n    optionsRef.current = options\n  })\n  const inFlight = useRef<Promise<CartValidationOutcome> | null>(null)\n  const autoRan = useRef(false)\n\n  const revalidate = useCallback((): Promise<CartValidationOutcome> => {\n    if (inFlight.current) return inFlight.current\n    setStatus('validating')\n    const run = validateCart(optionsRef.current).then((outcome) => {\n      inFlight.current = null\n      const { status: nextStatus, ...rest } = outcome\n      setReport(rest)\n      setStatus(nextStatus)\n      return outcome\n    })\n    inFlight.current = run\n    return run\n  }, [])\n\n  useEffect(() => {\n    if (!auto || !hydrated || autoRan.current) return\n    autoRan.current = true\n    void revalidate()\n  }, [auto, hydrated, revalidate])\n\n  const getLineError = useCallback(\n    (productId: string, variantId?: string | null) =>\n      report.lineErrors[cartLineKey(productId, variantId)],\n    [report],\n  )\n\n  return { status, ...report, getLineError, revalidate }\n}\n"],"mappings":";;;AAEA,SAAS,iBAAiB;;;ACF1B,SAAS,cAAc;AACvB,SAAS,eAAe;AAgBjB,IAAM,mBAAmB;AAWzB,IAAM,6BAA6B;AAiD1C,SAAS,WAAW,GAAa,WAAmB,WAAoC;AACtF,SAAO,EAAE,cAAc,cAAc,EAAE,aAAa,WAAW,aAAa;AAC9E;AAqBA,SAAS,kBAAkB,UAAkB,UAAiC;AAC5E,MAAI,CAAC,OAAO,SAAS,QAAQ,EAAG,QAAO;AACvC,QAAM,YAAY,KAAK,MAAM,QAAQ;AACrC,MAAI,YAAY,EAAG,QAAO;AAC1B,MAAI,aAAa,KAAM,QAAO;AAC9B,QAAM,eAAe,KAAK,MAAM,QAAQ;AACxC,MAAI,eAAe,EAAG,QAAO;AAC7B,SAAO,KAAK,IAAI,WAAW,YAAY;AACzC;AAuBA,SAAS,kBAAkB;AACzB,SAAO,OAAkB;AAAA,IACvB;AAAA,MACE,CAAC,KAAK,SAAS;AAAA,QACb,OAAO,CAAC;AAAA,QAER,SAAS,CAAC,SAAS;AAGjB,cAAI,UAA0B,EAAE,QAAQ,WAAW,UAAU,EAAE;AAE/D,cAAI,CAAC,UAAU;AACb,kBAAM,WAAW,MAAM,MAAM,KAAK,CAAC,MAAM,WAAW,GAAG,KAAK,WAAW,KAAK,SAAS,CAAC;AAEtF,gBAAI,UAAU;AAMZ,kBAAI,KAAK,aAAa,QAAQ,KAAK,MAAM,KAAK,QAAQ,IAAI,GAAG;AAC3D,0BAAU,EAAE,QAAQ,WAAW,UAAU,EAAE;AAC3C,uBAAO;AAAA,kBACL,OAAO,MAAM,MAAM,OAAO,CAAC,MAAM,CAAC,WAAW,GAAG,KAAK,WAAW,KAAK,SAAS,CAAC;AAAA,gBACjF;AAAA,cACF;AAEA,oBAAM,eAAe,SAAS,WAAW,KAAK;AAC9C,oBAAM,SAAS,kBAAkB,cAAc,KAAK,QAAQ;AAC5D,kBAAI,SAAS,GAAG;AAId,0BAAU,EAAE,QAAQ,WAAW,UAAU,SAAS,SAAS;AAC3D,uBAAO,CAAC;AAAA,cACV;AAMA,wBAAU;AAAA,gBACR,QACE,UAAU,SAAS,WACf,YACA,SAAS,eACP,YACA;AAAA,gBACR,UAAU;AAAA,cACZ;AAMA,qBAAO;AAAA,gBACL,OAAO,MAAM,MAAM;AAAA,kBAAI,CAAC,MACtB,WAAW,GAAG,KAAK,WAAW,KAAK,SAAS,IACxC,EAAE,GAAG,GAAG,UAAU,QAAQ,UAAU,KAAK,SAAS,IAClD;AAAA,gBACN;AAAA,cACF;AAAA,YACF;AAEA,kBAAM,MAAM,kBAAkB,KAAK,UAAU,KAAK,QAAQ;AAC1D,gBAAI,MAAM,GAAG;AAGX,wBAAU,EAAE,QAAQ,WAAW,UAAU,EAAE;AAC3C,qBAAO,CAAC;AAAA,YACV;AAEA,sBAAU,EAAE,QAAQ,MAAM,KAAK,WAAW,YAAY,SAAS,UAAU,IAAI;AAC7E,mBAAO,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,EAAE,GAAG,MAAM,UAAU,IAAI,CAAC,EAAE;AAAA,UAC/D,CAAC;AAED,iBAAO;AAAA,QACT;AAAA,QAEA,YAAY,CAAC,WAAW,cAAc;AACpC,cAAI,CAAC,WAAW;AAAA,YACd,OAAO,MAAM,MAAM,OAAO,CAAC,MAAM,CAAC,WAAW,GAAG,WAAW,SAAS,CAAC;AAAA,UACvE,EAAE;AAAA,QACJ;AAAA,QAEA,gBAAgB,CAAC,WAAW,WAAW,aAAa;AAClD,gBAAM,WAAW,IAAI,EAAE,MAAM,KAAK,CAAC,MAAM,WAAW,GAAG,WAAW,SAAS,CAAC;AAC5E,cAAI,CAAC,SAAU;AAEf,gBAAM,SAAS,kBAAkB,UAAU,SAAS,QAAQ;AAC5D,cAAI,SAAS,GAAG;AACd,gBAAI,EAAE,WAAW,WAAW,SAAS;AACrC;AAAA,UACF;AAEA,cAAI,CAAC,WAAW;AAAA,YACd,OAAO,MAAM,MAAM;AAAA,cAAI,CAAC,MACtB,WAAW,GAAG,WAAW,SAAS,IAAI,EAAE,GAAG,GAAG,UAAU,OAAO,IAAI;AAAA,YACrE;AAAA,UACF,EAAE;AAAA,QACJ;AAAA,QAEA,WAAW,MAAM,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC;AAAA,QAElC,UAAU,MAAM,IAAI,EAAE,MAAM,OAAO,CAAC,KAAK,SAAS,MAAM,KAAK,YAAY,KAAK,UAAU,CAAC;AAAA,QAEzF,cAAc,MAAM,IAAI,EAAE,MAAM,OAAO,CAAC,KAAK,SAAS,MAAM,KAAK,UAAU,CAAC;AAAA,MAC9E;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,SAAS;AAAA,QACT,eAAe;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AACF;AAWA,IAAM,wBAAwB,uBAAO;AAAA,EACnC,gCAAgC,0BAA0B;AAC5D;AAMA,IAAM,qBAAqB;AAEpB,IAAM,eACX,mBAAmB,qBAAqB,MACvC,mBAAmB,qBAAqB,IAAI,gBAAgB;AAexD,SAAS,2BAAiC;AAC/C,SAAO,mBAAmB,qBAAqB;AACjD;;;AD7QS;AALF,SAAS,aAAa,EAAE,SAAS,GAAkC;AACxE,YAAU,MAAM;AACd,iBAAa,QAAQ,UAAU;AAAA,EACjC,GAAG,CAAC,CAAC;AAEL,SAAO,gCAAG,UAAS;AACrB;;;AEhBA,SAAS,4BAA4B;AA8BrC,SAAS,mBAAmB,eAAuC;AACjE,SAAO,aAAa,QAAQ,kBAAkB,aAAa;AAC7D;AAEA,SAAS,sBAA+B;AACtC,SAAO,aAAa,QAAQ,YAAY;AAC1C;AAGA,SAAS,4BAAqC;AAC5C,SAAO;AACT;AAOO,SAAS,kBAA2B;AACzC,SAAO,qBAAqB,oBAAoB,qBAAqB,yBAAyB;AAChG;AAYO,SAAS,UAAyB;AACvC,QAAM,QAAQ,aAAa,CAAC,MAAM,EAAE,KAAK;AACzC,QAAM,UAAU,aAAa,CAAC,MAAM,EAAE,OAAO;AAC7C,QAAM,aAAa,aAAa,CAAC,MAAM,EAAE,UAAU;AACnD,QAAM,iBAAiB,aAAa,CAAC,MAAM,EAAE,cAAc;AAC3D,QAAM,YAAY,aAAa,CAAC,MAAM,EAAE,SAAS;AACjD,QAAM,WAAW,gBAAgB;AAEjC,QAAM,QAAQ,MAAM,OAAO,CAAC,KAAK,SAAS,MAAM,KAAK,YAAY,KAAK,UAAU,CAAC;AACjF,QAAM,YAAY,MAAM,OAAO,CAAC,KAAK,SAAS,MAAM,KAAK,UAAU,CAAC;AAEpE,SAAO,EAAE,OAAO,OAAO,WAAW,UAAU,SAAS,YAAY,gBAAgB,UAAU;AAC7F;;;ACcO,IAAM,iCAAiC;AAGvC,SAAS,YAAY,WAAmB,WAAmC;AAChF,SAAO,KAAK,UAAU,CAAC,WAAW,aAAa,IAAI,CAAC;AACtD;AAEA,SAAS,aAAa,QAAqD;AACzE,SAAO;AAAA,IACL;AAAA,IACA,SAAS,CAAC;AAAA,IACV,iBAAiB,CAAC;AAAA,IAClB,cAAc,CAAC;AAAA,IACf,YAAY,CAAC;AAAA,IACb,kBAAkB,CAAC;AAAA,EACrB;AACF;AAEA,SAAS,aAAa,OAA6C;AACjE,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,IAAI;AACV,SAAO,OAAO,EAAE,UAAU,aAAa,MAAM,QAAQ,EAAE,MAAM,KAAK,MAAM,QAAQ,EAAE,KAAK;AACzF;AAEA,SAAS,iBAAiB,UAAiC;AACzD,SAAO,OAAO,UAAU;AACtB,UAAM,MAAM,MAAM,MAAM,UAAU;AAAA,MAChC,QAAQ;AAAA,MACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,MAC9C,MAAM,KAAK,UAAU,KAAK;AAAA,IAC5B,CAAC;AACD,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,IAAI,MAAM,kCAAkC,IAAI,MAAM,EAAE;AAAA,IAChE;AACA,UAAM,OAAgB,MAAM,IAAI,KAAK;AACrC,UAAM,OAAO,QAAQ,OAAO,SAAS,WAAY,KAA4B,OAAO;AACpF,QAAI,CAAC,aAAa,IAAI,GAAG;AACvB,YAAM,IAAI,MAAM,2CAA2C;AAAA,IAC7D;AACA,WAAO;AAAA,EACT;AACF;AAEA,SAAS,mBAAkC;AACzC,MAAI,aAAa,QAAQ,YAAY,EAAG,QAAO,QAAQ,QAAQ;AAC/D,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,cAAc,aAAa,QAAQ,kBAAkB,MAAM;AAC/D,kBAAY;AACZ,cAAQ;AAAA,IACV,CAAC;AAAA,EACH,CAAC;AACH;AAOO,SAAS,oBACd,OACA,YACA,EAAE,oBAAoB,KAAK,IAAoD,CAAC,GACP;AACzE,QAAM,UAA6B,CAAC;AACpC,QAAM,kBAAwC,CAAC;AAC/C,QAAM,eAAkC,CAAC;AACzC,QAAM,aAAsD,CAAC;AAC7D,QAAM,mBAA8C,CAAC;AAErD,QAAM,QAAQ,IAAI,IAAI,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,KAAK,WAAW,KAAK,SAAS,GAAG,IAAI,CAAC,CAAC;AAC9F,QAAM,aAAa,oBAAI,IAAY;AACnC,QAAM,cAAc,oBAAI,IAAoB;AAE5C,aAAW,SAAS,WAAW,QAAQ;AACrC,UAAM,MAAM,YAAY,MAAM,WAAW,MAAM,SAAS;AACxD,UAAM,OAAO,MAAM,IAAI,GAAG;AAC1B,QAAI,CAAC,MAAM;AACT,uBAAiB,KAAK,KAAK;AAC3B;AAAA,IACF;AACA,eAAW,GAAG,IAAI;AAClB,QAAI,MAAM,oBAAoB,YAAY,mBAAmB;AAC3D,iBAAW,IAAI,GAAG;AAClB,cAAQ,KAAK;AAAA,QACX,WAAW,KAAK;AAAA,QAChB,WAAW,KAAK,aAAa;AAAA,QAC7B,MAAM,KAAK;AAAA,QACX,GAAI,KAAK,gBAAgB,UAAa,EAAE,aAAa,KAAK,YAAY;AAAA,QACtE,MAAM,MAAM;AAAA,QACZ,SAAS,MAAM;AAAA,MACjB,CAAC;AAAA,IACH,WAAW,MAAM,oBAAoB,qBAAqB,OAAO,MAAM,gBAAgB,UAAU;AAC/F,kBAAY,IAAI,KAAK,MAAM,WAAW;AAAA,IACxC,OAAO;AAGL,uBAAiB,KAAK,KAAK;AAAA,IAC7B;AAAA,EACF;AAEA,QAAM,OAAO,IAAI;AAAA,IACf,WAAW,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,KAAK,WAAW,KAAK,SAAS,GAAG,IAAI,CAAC;AAAA,EACpF;AAEA,QAAM,OAAmB,CAAC;AAC1B,aAAW,QAAQ,OAAO;AACxB,UAAM,MAAM,YAAY,KAAK,WAAW,KAAK,SAAS;AACtD,QAAI,WAAW,IAAI,GAAG,EAAG;AAEzB,QAAI,UAAU;AACd,UAAM,WAAW,KAAK,IAAI,GAAG;AAC7B,QAAI,UAAU;AACZ,UAAI,SAAS,cAAc,KAAK,WAAW;AACzC,qBAAa,KAAK;AAAA,UAChB,WAAW,KAAK;AAAA,UAChB,WAAW,KAAK,aAAa;AAAA,UAC7B,MAAM,KAAK;AAAA,UACX,GAAI,KAAK,gBAAgB,UAAa,EAAE,aAAa,KAAK,YAAY;AAAA,UACtE,MAAM,KAAK;AAAA,UACX,IAAI,SAAS;AAAA,QACf,CAAC;AACD,kBAAU,EAAE,GAAG,SAAS,WAAW,SAAS,UAAU;AAAA,MACxD;AACA,UAAI,SAAS,aAAa,KAAK,UAAU;AACvC,kBAAU,EAAE,GAAG,SAAS,UAAU,SAAS,SAAS;AAAA,MACtD;AAAA,IACF;AAEA,UAAM,UAAU,YAAY,IAAI,GAAG;AACnC,QAAI,YAAY,QAAW;AACzB,YAAM,KAAK,KAAK,MAAM,OAAO;AAC7B,UAAI,KAAK,GAAG;AAEV,gBAAQ,KAAK;AAAA,UACX,WAAW,KAAK;AAAA,UAChB,WAAW,KAAK,aAAa;AAAA,UAC7B,MAAM,KAAK;AAAA,UACX,GAAI,KAAK,gBAAgB,UAAa,EAAE,aAAa,KAAK,YAAY;AAAA,UACtE,MAAM;AAAA,UACN,SAAS,WAAW,GAAG,GAAG,WAAW;AAAA,QACvC,CAAC;AACD;AAAA,MACF;AACA,UAAI,KAAK,KAAK,UAAU;AACtB,wBAAgB,KAAK;AAAA,UACnB,WAAW,KAAK;AAAA,UAChB,WAAW,KAAK,aAAa;AAAA,UAC7B,MAAM,KAAK;AAAA,UACX,GAAI,KAAK,gBAAgB,UAAa,EAAE,aAAa,KAAK,YAAY;AAAA,UACtE,MAAM,KAAK;AAAA,UACX;AAAA,QACF,CAAC;AACD,kBAAU,EAAE,GAAG,SAAS,UAAU,GAAG;AAAA,MACvC;AAAA,IACF;AAEA,SAAK,KAAK,OAAO;AAAA,EACnB;AAEA,SAAO,EAAE,OAAO,MAAM,SAAS,iBAAiB,cAAc,YAAY,iBAAiB;AAC7F;AAeA,eAAsB,aAAa,UAA+B,CAAC,GAAmC;AACpG,QAAM,iBAAiB;AAEvB,QAAM,QAAQ,aAAa,SAAS,EAAE;AACtC,MAAI,MAAM,WAAW,EAAG,QAAO,aAAa,OAAO;AAEnD,QAAM,WAAW,QAAQ,YAAY,iBAAiB,QAAQ,YAAY,8BAA8B;AAExG,MAAI;AACJ,MAAI;AACF,iBAAa,MAAM,SAAS;AAAA,MAC1B,OAAO,MAAM,IAAI,CAAC,OAAO;AAAA,QACvB,WAAW,EAAE;AAAA,QACb,WAAW,EAAE;AAAA,QACb,UAAU,EAAE;AAAA,MACd,EAAE;AAAA,IACJ,CAAC;AAAA,EACH,SAAS,OAAO;AACd,WAAO,EAAE,GAAG,aAAa,QAAQ,GAAG,MAAM;AAAA,EAC5C;AAIA,QAAM,UAAU,oBAAoB,aAAa,SAAS,EAAE,OAAO,YAAY,OAAO;AACtF,QAAM,EAAE,OAAO,WAAW,GAAG,OAAO,IAAI;AACxC,QAAM,UACJ,OAAO,QAAQ,SAAS,KAAK,OAAO,gBAAgB,SAAS,KAAK,OAAO,aAAa,SAAS;AACjG,QAAM,UAAU,aAAa,SAAS,EAAE;AAGxC,MAAI,UAAU,WAAW,QAAQ,UAAU,UAAU,KAAK,CAAC,MAAM,MAAM,SAAS,QAAQ,CAAC,CAAC,GAAG;AAC3F,iBAAa,SAAS,EAAE,OAAO,UAAU,CAAC;AAAA,EAC5C;AAEA,QAAM,SACJ,OAAO,iBAAiB,SAAS,IAAI,YAAY,UAAU,aAAa;AAE1E,SAAO,EAAE,QAAQ,GAAG,OAAO;AAC7B;;;AC7SA,SAAS,aAAa,aAAAA,YAAW,QAAQ,gBAAgB;AA6BzD,IAAM,OAA8C;AAAA,EAClD,SAAS,CAAC;AAAA,EACV,iBAAiB,CAAC;AAAA,EAClB,cAAc,CAAC;AAAA,EACf,YAAY,CAAC;AAAA,EACb,kBAAkB,CAAC;AACrB;AASO,SAAS,kBAAkB,UAAoC,CAAC,GAA4B;AACjG,QAAM,EAAE,OAAO,KAAK,IAAI;AACxB,QAAM,WAAW,gBAAgB;AACjC,QAAM,CAAC,QAAQ,SAAS,IAAI,SAA4C,MAAM;AAC9E,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAgD,IAAI;AAIhF,QAAM,aAAa,OAAO,OAAO;AACjC,EAAAC,WAAU,MAAM;AACd,eAAW,UAAU;AAAA,EACvB,CAAC;AACD,QAAM,WAAW,OAA8C,IAAI;AACnE,QAAM,UAAU,OAAO,KAAK;AAE5B,QAAM,aAAa,YAAY,MAAsC;AACnE,QAAI,SAAS,QAAS,QAAO,SAAS;AACtC,cAAU,YAAY;AACtB,UAAM,MAAM,aAAa,WAAW,OAAO,EAAE,KAAK,CAAC,YAAY;AAC7D,eAAS,UAAU;AACnB,YAAM,EAAE,QAAQ,YAAY,GAAG,KAAK,IAAI;AACxC,gBAAU,IAAI;AACd,gBAAU,UAAU;AACpB,aAAO;AAAA,IACT,CAAC;AACD,aAAS,UAAU;AACnB,WAAO;AAAA,EACT,GAAG,CAAC,CAAC;AAEL,EAAAA,WAAU,MAAM;AACd,QAAI,CAAC,QAAQ,CAAC,YAAY,QAAQ,QAAS;AAC3C,YAAQ,UAAU;AAClB,SAAK,WAAW;AAAA,EAClB,GAAG,CAAC,MAAM,UAAU,UAAU,CAAC;AAE/B,QAAM,eAAe;AAAA,IACnB,CAAC,WAAmB,cAClB,OAAO,WAAW,YAAY,WAAW,SAAS,CAAC;AAAA,IACrD,CAAC,MAAM;AAAA,EACT;AAEA,SAAO,EAAE,QAAQ,GAAG,QAAQ,cAAc,WAAW;AACvD;","names":["useEffect","useEffect"]}

package/dist/consent.js

@@ -121,7 +121,7 @@ function ConsentGate({ category, children }) {
 }
 
 // src/analytics.tsx
-import Script from "next/script";
+import Script from "next/script.js";
 
 // src/json-ld.tsx
 import { jsx as jsx3 } from "react/jsx-runtime";