@behio/storefront-sdk 0.1.7 → 0.1.9

package/README.md

@@ -509,6 +509,7 @@ const tracked = await shop.orders.track('tracking-token-uuid');
 | Hook | Purpose | Auth required |
 |------|---------|---------------|
 | [`useShopInfo()`](#useshopinfo) | E-shop info (name, currencies, languages) | No |
+| [`useShopSeo(opts?)`](#useshopseo) | Per-locale SEO metadata for the homepage | No |
 | [`useProducts(query?)`](#useproducts) | Product list with filters, pagination, search | No |
 | [`useProduct(slug)`](#useproduct) | Product detail | No |
 | [`useCategories(locale?)`](#usecategories) | Category tree | No |
@@ -525,6 +526,9 @@ const tracked = await shop.orders.track('tracking-token-uuid');
 | [`useCustomer()`](#usecustomer) | Profile + update | Yes |
 | [`useAddresses()`](#useaddresses) | Address CRUD | Yes |
 | [`usePages()` / `usePage(slug)`](#usepages) | CMS pages | No |
+| [`useBundles()` / `useBundle(slug)`](#usebundles) | Active bundles (sets) with auto-computed savings | No |
+| [`useCrossSell(productSlug)`](#usecrosssell) | Related / upsell / cross-sell products per product | No |
+| [`useProductPromotions(productSlug)`](#useproductpromotions) | Active promotions applicable to a product (with countdown) | No |
 
 \* Guest checkout works without auth if the e-shop allows it.
 
@@ -534,6 +538,55 @@ const { data, isLoading, error } = useShopInfo();
 // data: ShopInfo
 ```
 
+### useShopSeo
+
+Returns per-locale SEO metadata (title, description, keywords, OG tags). Falls back to the shop's default locale when `locale` is omitted, and to `metaTitle / metaDescription` on the shop itself if there's no per-locale override.
+
+```tsx
+const { data: seo } = useShopSeo({ locale: 'cs' });
+// data: { locale, title, description, keywords, ogTitle, ogDescription, ogImage }
+```
+
+**Server-side / SSR** — use the core client directly to fetch at request time and pass as `initialData`:
+
+```tsx
+// app/[locale]/page.tsx (Next.js RSC)
+import { BehioStorefront } from '@behio/storefront-sdk';
+import type { Metadata } from 'next';
+
+const shop = new BehioStorefront({ apiKey: process.env.BEHIO_API_KEY! });
+
+export async function generateMetadata({ params }: { params: { locale: string } }): Promise<Metadata> {
+  const seo = await shop.getShopSeo(params.locale);
+  return {
+    title: seo.title ?? undefined,
+    description: seo.description ?? undefined,
+    openGraph: {
+      title: seo.ogTitle ?? seo.title ?? undefined,
+      description: seo.ogDescription ?? seo.description ?? undefined,
+      images: seo.ogImage ? [seo.ogImage] : undefined,
+    },
+  };
+}
+
+export default async function Home({ params }: { params: { locale: string } }) {
+  const seo = await shop.getShopSeo(params.locale);
+  // Pass to client component for React Query hydration:
+  // <ClientHome initialSeo={seo} />
+}
+```
+
+Client hydration:
+```tsx
+'use client';
+import { useShopSeo } from '@behio/storefront-sdk/react';
+
+export function ClientHome({ initialSeo }: { initialSeo: ShopSeo }) {
+  const { data } = useShopSeo({ locale: 'cs', initialData: initialSeo });
+  return <h1>{data.title}</h1>;
+}
+```
+
 ### useProducts
 
 Supports **both** traditional pagination and infinite scroll from one hook.
@@ -735,6 +788,336 @@ const { data: pages } = usePages('cs');
 const { data: page } = usePage('about-us', 'cs');
 ```
 
+### useBundles / useBundle
+
+**What it is.** A "bundle" is a merchant-curated set of products sold together
+at a single fixed price that's (usually) lower than buying the components
+individually — think *starter kit*, *holiday gift set*, *3-for-2 deals*, or
+*"breakfast combo"*. The merchant defines what goes in (which products, what
+quantities, what cover image) and sets one total price for the whole thing.
+
+**Why it matters.** Bundles are one of the highest-ROI features in e-commerce:
+they raise average order value without having to discount individual products,
+they give customers a clear "good deal" signal (the savings badge), and they
+let you clear slow-moving inventory by pairing it with fast-movers. Most eshop
+platforms treat bundles as paid add-ons or plugins — here it's native.
+
+**Where you use it.**
+
+- **Homepage / landing pages** — list active bundles as hero cards with cover
+  image + `-25%` badge. Drives impulse purchase.
+- **Category pages** — show a relevant bundle ("vše na grilování") next to
+  individual products in the same category.
+- **Cart / checkout** — suggest a bundle as upsell ("Přidejte ještě tohle a
+  dostanete celý set s 20% slevou").
+- **Dedicated `/bundles` page** — marketing landing for all active sets.
+
+**What's in the data:**
+
+- `bundlePrice` — what the customer pays for the whole set
+- `itemsSum` — what the components would cost individually (sum of default prices)
+- `savings` — `itemsSum - bundlePrice` (absolute savings in the currency)
+- `savingsPercent` — pre-computed percent so you don't have to do the math in JSX
+- `items[]` — the components with their quantities (for display and stock check)
+- `endsAt` — optional expiry timestamp; if set, the bundle auto-deactivates
+
+```tsx
+import { useBundles, useBundle, useCart, useBehio } from '@behio/storefront-sdk/react';
+
+// ---- Homepage hero: all active bundles ----
+function BundlesGrid() {
+  const { data, isLoading } = useBundles();
+  if (isLoading) return <Skeleton />;
+  if (!data?.items.length) return null; // no active bundles → hide section
+
+  return (
+    <section className="grid grid-cols-3 gap-4">
+      {data.items.map((bundle) => (
+        <a key={bundle.id} href={`/bundle/${bundle.slug}`} className="relative">
+          {bundle.coverImage && <img src={bundle.coverImage} alt={bundle.name} />}
+          <h3>{bundle.name}</h3>
+          <div>
+            <strong>{bundle.bundlePrice} {bundle.currency}</strong>
+            {bundle.savings > 0 && (
+              <>
+                <s>{bundle.itemsSum} {bundle.currency}</s>
+                <span className="badge">-{bundle.savingsPercent}%</span>
+              </>
+            )}
+          </div>
+          <p>{bundle.items.length} produktů ušetříte {bundle.savings} {bundle.currency}</p>
+        </a>
+      ))}
+    </section>
+  );
+}
+
+// ---- Bundle detail page with "Add to cart" ----
+function BundleDetail({ slug }: { slug: string }) {
+  const { data: bundle, isLoading } = useBundle(slug);
+  const { client } = useBehio();
+  const { refresh } = useCart();
+
+  if (isLoading) return <Skeleton />;
+  if (!bundle) return <NotFound />;
+
+  async function addToCart() {
+    await client.cart.addBundle(bundle.id, 1);
+    await refresh(); // cart badge updates everywhere
+  }
+
+  return (
+    <article>
+      <h1>{bundle.name}</h1>
+      <p>{bundle.description}</p>
+
+      <ul>
+        {bundle.items.map((item) => (
+          <li key={item.productId}>
+            {item.quantity}× {item.name}
+            {item.defaultPrice && (
+              <span className="text-muted">
+                ({item.defaultPrice} {bundle.currency} /ks běžně)
+              </span>
+            )}
+          </li>
+        ))}
+      </ul>
+
+      <div className="price-box">
+        <strong>{bundle.bundlePrice} {bundle.currency}</strong>
+        {bundle.savings > 0 && (
+          <p>
+            Jednotlivě by stálo <s>{bundle.itemsSum} {bundle.currency}</s> —
+            ušetříte <strong>{bundle.savings} {bundle.currency}</strong>
+            ({bundle.savingsPercent}%)
+          </p>
+        )}
+        <button onClick={addToCart}>Přidat celý balíček do košíku</button>
+      </div>
+    </article>
+  );
+}
+```
+
+**Behind the scenes at checkout.** When the customer buys a bundle, Behio
+rozpadá balíček do order-itemů s proporčně rozpočítanou cenou podle
+defaultních cen komponent (zachováno pro účetnictví a skladové odpisy), ale
+total na faktuře odpovídá `bundlePrice` — zákazník vidí jednu celistvou
+položku, sklady se odepisují správně z komponent.
+
+---
+
+### useCrossSell
+
+**What it is.** Three related lists of product recommendations shown on a
+product detail page:
+
+- **Related (Podobné)** — alternativy ke stejnému účelu (jiné vodítko, jiné
+  krmivo). Když tě tenhle produkt zaujal, tady jsou jiné stejné kategorie.
+- **Upsell (Lepší varianta)** — dražší / vybavenější verze. „Vidíš levný
+  obojek? Tady je verze s koženým prošitím za 2×." Cílem je zvýšit
+  average order value.
+- **Cross-sell (Často kupováno s)** — komplementární produkty. K obojku
+  vodítko, k misce čistič. Čistý AOV boost na PDP a v košíku.
+
+**Why to split them.** Každý z těchto typů má jinou UX roli a měla by být
+různě formulována. Když se to smíchá, ztratí se kontext — zákazník nepozná,
+proč mu to zobrazuješ.
+
+**Where to use it.**
+
+- **Product detail page** — tři samostatné sekce pod popisem (nebo v sidebar
+  sloupci). Nejvyšší konverzní dopad je **Cross-sell "často kupováno s"**
+  přímo u tlačítka "Přidat do košíku".
+- **Cart sidebar** — mini-cross-sell widget ("Nezapomeňte ještě na tohle").
+- **Post-purchase page** — "Chcete ještě tohle?" pro druhou objednávku.
+
+**Pozor.** Endpoint vrací **jen aktivní produkty ve stejném eshopu**. Když
+jsi v adminu nějaký linknul a pak ho deaktivoval/smazal, zmizí ze seznamu
+automaticky — nemusíš to řešit na FE.
+
+```tsx
+import { useCrossSell, useBehio } from '@behio/storefront-sdk/react';
+
+function CrossSellSection({ title, items }: { title: string; items: CrossSellItem[] }) {
+  if (!items?.length) return null; // nezobrazuj prázdnou sekci
+  return (
+    <section>
+      <h2>{title}</h2>
+      <div className="carousel">
+        {items.map((item) => (
+          <a key={item.productId} href={`/produkt/${item.slug}`} className="card">
+            {item.imageUrl && <img src={item.imageUrl} alt={item.name} />}
+            <h4>{item.name}</h4>
+            <span>{item.price} Kč</span>
+            {item.stockCached === 0 && <span className="text-red">Vyprodáno</span>}
+          </a>
+        ))}
+      </div>
+    </section>
+  );
+}
+
+function ProductDetail({ slug }: { slug: string }) {
+  const { data: crossSell } = useCrossSell(slug);
+
+  return (
+    <>
+      {/* ... product info ... */}
+
+      <CrossSellSection
+        title="Často kupováno s"
+        items={crossSell?.crossSell ?? []}
+      />
+      <CrossSellSection
+        title="Možná vás zaujme i"
+        items={crossSell?.related ?? []}
+      />
+      <CrossSellSection
+        title="Chcete raději lepší variantu?"
+        items={crossSell?.upsell ?? []}
+      />
+    </>
+  );
+}
+```
+
+**Tip — merge do jedné sekce.** Pokud máš málo content a chceš to zjednodušit:
+
+```tsx
+const allRecommendations = [
+  ...(crossSell?.crossSell ?? []),
+  ...(crossSell?.related ?? []),
+  ...(crossSell?.upsell ?? []),
+].slice(0, 6);
+```
+
+---
+
+### useProductPromotions
+
+**What it is.** Vrací aktuálně platné akce (`Eshop_Promotion`) týkající se
+konkrétního produktu — tedy všechny promotions, kde `startsAt <= teď < endsAt`
+a produkt spadá do scope akce (může to být `ALL_PRODUCTS`, `SPECIFIC_PRODUCTS`,
+`CATEGORIES` nebo `LABELS`, backend to vyřeší za tebe).
+
+**Co to není.** Není to výpočet *konečné ceny po slevě* — na to je samostatná
+vrstva (cart evaluator). Tenhle hook je čistě pro **zobrazovací vrstvu**: badge,
+countdown, upozornění „akční cena do půlnoci".
+
+**Proč je to oddělené.** Konverzně nejsilnější marketingový prvek v eshopu je
+**urgency + scarcity**. „Do konce akce: 2h 14m 37s" přímo na PDP zvyšuje
+conversion rate měřitelně — je to letitá best practice (Amazon Lightning
+Deals, Booking "rezervováno 3× za posledních 24h", atd.). Hook ti dodá data,
+ty uděláš countdown komponentu.
+
+**Kde to použít.**
+
+- **Product card v listu** — badge `-20%` nebo vlajka „AKCE".
+- **Product detail** — velký banner s countdown nad cenou: „Koupíte-li do
+  půlnoci, ušetříte 200 Kč."
+- **Cart** — varování „Vaše sleva vyprší za 5 minut" aby tlačilo k
+  dokončení objednávky.
+
+**Pole z API:**
+
+- `id`, `name`, `slug` — identifikace akce
+- `type` — `FLASH_SALE` / `SEASONAL` / `CLEARANCE` / `BOGO` / `BUNDLE` / `LOYALTY`
+- `discountType` — `PERCENTAGE` / `FIXED_AMOUNT` / `FREE_SHIPPING` / `BUY_X_GET_Y`
+- `discountValue` — hodnota (u PERCENTAGE je to %, u FIXED_AMOUNT Kč, …)
+- `endsAt` — timestamp konce. Pokud `null`, akce je na neurčito.
+- `badgeText`, `badgeColor` — merchant ručně nastavil text a barvu badge
+  (např. „-30%" s červenou); pokud oboje `null`, vymysli default podle `discountType`.
+- `showCountdown` — **respect this!** Když merchant nechce countdown, nerender
+  ho. Ne všechny akce (CLEARANCE, LOYALTY) mají smysl odpočítávat.
+- `couponRequired` — akce se uplatní jen po zadání kódu na checkoutu.
+  Na PDP ukaž info box („Použijte kód LETO pro uplatnění"), neukazuj jako
+  automatickou slevu.
+
+```tsx
+import { useProductPromotions } from '@behio/storefront-sdk/react';
+import { useEffect, useState } from 'react';
+
+function ProductPromotionBanner({ slug }: { slug: string }) {
+  // Refetch každé 4 minuty aby se promotion aktualizovala když mezitím
+  // skončila jedna a začala další. Pro pouhý countdown nemusíš refetchovat —
+  // countdown děláš lokálně z endsAt.
+  const { data } = useProductPromotions(slug, { refetchIntervalMs: 4 * 60_000 });
+  const promotions = data?.items ?? [];
+
+  if (!promotions.length) return null;
+
+  // Nejvyšší priority akce (BE už vrací seřazené priority DESC + createdAt ASC)
+  const promo = promotions[0];
+
+  const badge = promo.badgeText ?? formatDefaultBadge(promo);
+  const badgeColor = promo.badgeColor ?? '#ef4444';
+
+  return (
+    <div className="promo-banner" style={{ backgroundColor: badgeColor + '20', borderColor: badgeColor }}>
+      <div>
+        <span className="badge" style={{ backgroundColor: badgeColor }}>{badge}</span>
+        <strong>{promo.name}</strong>
+        {promo.couponRequired && (
+          <p>Uplatníte zadáním kódu <code>{promo.name}</code> v košíku</p>
+        )}
+      </div>
+      {promo.showCountdown && promo.endsAt && <Countdown endsAt={promo.endsAt} />}
+    </div>
+  );
+}
+
+function Countdown({ endsAt }: { endsAt: number }) {
+  const [now, setNow] = useState(Date.now());
+  useEffect(() => {
+    const id = setInterval(() => setNow(Date.now()), 1000);
+    return () => clearInterval(id);
+  }, []);
+
+  const ms = Math.max(0, endsAt - now);
+  if (ms === 0) return <span>Akce skončila</span>;
+
+  const d = Math.floor(ms / 86400_000);
+  const h = Math.floor((ms % 86400_000) / 3600_000);
+  const m = Math.floor((ms % 3600_000) / 60_000);
+  const s = Math.floor((ms % 60_000) / 1000);
+
+  if (d > 0) return <span>Končí za {d}d {h}h {m}m</span>;
+  return <span>Končí za {h}h {m}m {s}s</span>;
+}
+
+function formatDefaultBadge(p: { discountType: string; discountValue: number }) {
+  switch (p.discountType) {
+    case 'PERCENTAGE': return `-${p.discountValue}%`;
+    case 'FIXED_AMOUNT': return `-${p.discountValue} Kč`;
+    case 'FREE_SHIPPING': return 'Doprava zdarma';
+    case 'BUY_X_GET_Y': return `${p.discountValue}+1 ZDARMA`;
+    default: return 'AKCE';
+  }
+}
+```
+
+**Pattern — product card badge.** Když chceš jen malou vlaječku na kartě
+produktu v listu (bez countdown), zavolej hook per-card a vezmi první promo:
+
+```tsx
+function ProductCardBadge({ slug }: { slug: string }) {
+  const { data } = useProductPromotions(slug);
+  const promo = data?.items[0];
+  if (!promo) return null;
+  return (
+    <span className="badge" style={{ background: promo.badgeColor ?? '#ef4444' }}>
+      {promo.badgeText ?? formatDefaultBadge(promo)}
+    </span>
+  );
+}
+```
+
+Pozor — v listovém kontextu to dělá N dotazů (jeden per karta). Pokud máš
+200 produktů, radši vytvoř vlastní bulk endpoint nebo invaliduj méně často
+přes React Query `staleTime`.
+
 ## All API methods
 
 ### Catalog
@@ -748,6 +1131,17 @@ shop.catalog.getLabels(locale?)              → { labels: ProductLabel[] }
 shop.catalog.getFeatured()                   → PaginatedResponse<ProductListItem>
 shop.catalog.getFilters()                    → { filters: FilterField[] }
 shop.catalog.search(query, opts?)            → PaginatedResponse<ProductListItem>
+shop.catalog.getBundles()                    → { items: Bundle[] }
+shop.catalog.getBundle(slug)                 → Bundle
+shop.catalog.getCrossSell(productSlug)       → { related, upsell, crossSell: CrossSellItem[] }
+shop.catalog.getProductPromotions(slug)      → { items: ActivePromotion[] }
+```
+
+### Cart — bundles
+```typescript
+shop.cart.addBundle(bundleId, quantity?)     → Cart
+shop.cart.updateBundleQuantity(id, qty)      → Cart
+shop.cart.removeBundle(bundleId)             → Cart
 ```
 
 ### Auth
@@ -807,6 +1201,7 @@ shop.pages.get(slug, locale?)                → PageDetail
 ### Instance utilities
 ```typescript
 shop.getShopInfo()                           → ShopInfo
+shop.getShopSeo(locale?)                     → ShopSeo (per-locale SEO for SSR/metadata)
 shop.setTokens({ accessToken, refreshToken })
 shop.clearTokens()
 shop.getAccessToken()                        → string | undefined

package/dist/{chunk-S4DOL3OV.mjs → chunk-HYKJO2IB.mjs}

@@ -108,6 +108,12 @@ var BehioStorefront = class {
   async getShopInfo() {
     return this.request("GET", "/shop");
   }
+  /** Get SEO metadata for the shop homepage in the given locale (defaults to shop default). */
+  async getShopSeo(locale) {
+    return this.request("GET", "/shop/seo", {
+      query: locale ? { locale } : void 0
+    });
+  }
   /** Set auth tokens (e.g. from localStorage) */
   setTokens(tokens) {
     this.accessToken = tokens.accessToken;
@@ -396,6 +402,22 @@ var CatalogModule = class {
   async search(query, options) {
     return this.getProducts({ search: query, ...options });
   }
+  /** List all active bundles */
+  async getBundles() {
+    return this.client.request("GET", "/catalog/bundles");
+  }
+  /** Get a single bundle by slug */
+  async getBundle(slug) {
+    return this.client.request("GET", `/catalog/bundles/${slug}`);
+  }
+  /** Cross-sell / related / upsell products for a product */
+  async getCrossSell(productSlug) {
+    return this.client.request("GET", `/catalog/products/${productSlug}/cross-sell`);
+  }
+  /** Active promotions applicable to a product (with countdown end time) */
+  async getProductPromotions(productSlug) {
+    return this.client.request("GET", `/catalog/products/${productSlug}/promotions`);
+  }
 };
 var AuthModule = class {
   constructor(client) {
@@ -507,6 +529,28 @@ var CartModule = class {
     this.client.emit("cart:cleared");
     return result;
   }
+  /** Add a bundle to the cart (price is locked at the bundle's current price) */
+  async addBundle(bundleId, quantity = 1) {
+    const result = await this.client.request("POST", "/cart/bundles", {
+      body: { bundleId, quantity }
+    });
+    this.client.emit("cart:updated", result);
+    return result;
+  }
+  /** Update quantity of a bundle already in the cart */
+  async updateBundleQuantity(bundleId, quantity) {
+    const result = await this.client.request("PATCH", `/cart/bundles/${bundleId}`, {
+      body: { quantity }
+    });
+    this.client.emit("cart:updated", result);
+    return result;
+  }
+  /** Remove a bundle from the cart */
+  async removeBundle(bundleId) {
+    const result = await this.client.request("DELETE", `/cart/bundles/${bundleId}`);
+    this.client.emit("cart:updated", result);
+    return result;
+  }
   /** Merge anonymous cart into authenticated customer cart */
   async merge() {
     const result = await this.client.request("POST", "/cart/merge");
@@ -561,7 +605,7 @@ var OrdersModule = class {
   async cancel(orderNumber) {
     return this.client.request("POST", `/orders/${orderNumber}/cancel`);
   }
-  /** Track order by tracking token (no auth required) */
+  /** Track order by tracking token (no customer login required, only API key) */
   async track(trackingToken) {
     return this.client.request("GET", `/orders/track/${trackingToken}`, { auth: false });
   }

package/dist/{chunk-GGAO5T5P.js → chunk-QOEYSUF2.js}

@@ -108,6 +108,12 @@ var BehioStorefront = class {
   async getShopInfo() {
     return this.request("GET", "/shop");
   }
+  /** Get SEO metadata for the shop homepage in the given locale (defaults to shop default). */
+  async getShopSeo(locale) {
+    return this.request("GET", "/shop/seo", {
+      query: locale ? { locale } : void 0
+    });
+  }
   /** Set auth tokens (e.g. from localStorage) */
   setTokens(tokens) {
     this.accessToken = tokens.accessToken;
@@ -396,6 +402,22 @@ var CatalogModule = class {
   async search(query, options) {
     return this.getProducts({ search: query, ...options });
   }
+  /** List all active bundles */
+  async getBundles() {
+    return this.client.request("GET", "/catalog/bundles");
+  }
+  /** Get a single bundle by slug */
+  async getBundle(slug) {
+    return this.client.request("GET", `/catalog/bundles/${slug}`);
+  }
+  /** Cross-sell / related / upsell products for a product */
+  async getCrossSell(productSlug) {
+    return this.client.request("GET", `/catalog/products/${productSlug}/cross-sell`);
+  }
+  /** Active promotions applicable to a product (with countdown end time) */
+  async getProductPromotions(productSlug) {
+    return this.client.request("GET", `/catalog/products/${productSlug}/promotions`);
+  }
 };
 var AuthModule = class {
   constructor(client) {
@@ -507,6 +529,28 @@ var CartModule = class {
     this.client.emit("cart:cleared");
     return result;
   }
+  /** Add a bundle to the cart (price is locked at the bundle's current price) */
+  async addBundle(bundleId, quantity = 1) {
+    const result = await this.client.request("POST", "/cart/bundles", {
+      body: { bundleId, quantity }
+    });
+    this.client.emit("cart:updated", result);
+    return result;
+  }
+  /** Update quantity of a bundle already in the cart */
+  async updateBundleQuantity(bundleId, quantity) {
+    const result = await this.client.request("PATCH", `/cart/bundles/${bundleId}`, {
+      body: { quantity }
+    });
+    this.client.emit("cart:updated", result);
+    return result;
+  }
+  /** Remove a bundle from the cart */
+  async removeBundle(bundleId) {
+    const result = await this.client.request("DELETE", `/cart/bundles/${bundleId}`);
+    this.client.emit("cart:updated", result);
+    return result;
+  }
   /** Merge anonymous cart into authenticated customer cart */
   async merge() {
     const result = await this.client.request("POST", "/cart/merge");
@@ -561,7 +605,7 @@ var OrdersModule = class {
   async cancel(orderNumber) {
     return this.client.request("POST", `/orders/${orderNumber}/cancel`);
   }
-  /** Track order by tracking token (no auth required) */
+  /** Track order by tracking token (no customer login required, only API key) */
   async track(trackingToken) {
     return this.client.request("GET", `/orders/track/${trackingToken}`, { auth: false });
   }

package/dist/index.d.mts

@@ -41,6 +41,15 @@ interface ShopInfo {
     metaDescription?: string;
     allowGuestCheckout: boolean;
 }
+interface ShopSeo {
+    locale: string;
+    title: string | null;
+    description: string | null;
+    keywords: string | null;
+    ogTitle: string | null;
+    ogDescription: string | null;
+    ogImage: string | null;
+}
 interface ProductPrice {
     amount: number;
     currency: string;
@@ -381,6 +390,52 @@ interface ResponseInterceptorData {
 interface ResponseInterceptor {
     (response: ResponseInterceptorData): void | Promise<void>;
 }
+interface BundleItem {
+    productId: string;
+    slug: string | null;
+    name: string;
+    sku: string;
+    quantity: number;
+    imageUrl: string | null;
+    defaultPrice: number | null;
+}
+interface Bundle {
+    id: string;
+    slug: string;
+    name: string;
+    description: string | null;
+    bundlePrice: number;
+    currency: string;
+    coverImage: string | null;
+    endsAt: number | null;
+    itemsSum: number;
+    savings: number;
+    savingsPercent: number;
+    items: BundleItem[];
+}
+interface CrossSellItem {
+    productId: string;
+    slug: string | null;
+    name: string;
+    sku: string;
+    price: number | null;
+    imageUrl: string | null;
+    stockCached: number;
+}
+interface ActivePromotion {
+    id: string;
+    name: string;
+    slug: string;
+    type: string;
+    discountType: string;
+    discountValue: number;
+    startsAt: number;
+    endsAt: number | null;
+    badgeText: string | null;
+    badgeColor: string | null;
+    showCountdown: boolean;
+    couponRequired: boolean;
+}
 
 declare class BehioStorefront {
     private baseUrl;
@@ -411,6 +466,8 @@ declare class BehioStorefront {
     readonly pages: PagesModule;
     /** Get basic shop info */
     getShopInfo(): Promise<ShopInfo>;
+    /** Get SEO metadata for the shop homepage in the given locale (defaults to shop default). */
+    getShopSeo(locale?: string): Promise<ShopSeo>;
     /** Set auth tokens (e.g. from localStorage) */
     setTokens(tokens: {
         accessToken: string;
@@ -488,6 +545,22 @@ declare class CatalogModule {
         page?: number;
         limit?: number;
     }): Promise<PaginatedResponse<ProductListItem>>;
+    /** List all active bundles */
+    getBundles(): Promise<{
+        items: Bundle[];
+    }>;
+    /** Get a single bundle by slug */
+    getBundle(slug: string): Promise<Bundle>;
+    /** Cross-sell / related / upsell products for a product */
+    getCrossSell(productSlug: string): Promise<{
+        related: CrossSellItem[];
+        upsell: CrossSellItem[];
+        crossSell: CrossSellItem[];
+    }>;
+    /** Active promotions applicable to a product (with countdown end time) */
+    getProductPromotions(productSlug: string): Promise<{
+        items: ActivePromotion[];
+    }>;
 }
 declare class AuthModule {
     private client;
@@ -524,6 +597,12 @@ declare class CartModule {
     removeItem(itemId: string): Promise<Cart>;
     /** Clear entire cart */
     clear(): Promise<void>;
+    /** Add a bundle to the cart (price is locked at the bundle's current price) */
+    addBundle(bundleId: string, quantity?: number): Promise<Cart>;
+    /** Update quantity of a bundle already in the cart */
+    updateBundleQuantity(bundleId: string, quantity: number): Promise<Cart>;
+    /** Remove a bundle from the cart */
+    removeBundle(bundleId: string): Promise<Cart>;
     /** Merge anonymous cart into authenticated customer cart */
     merge(): Promise<Cart>;
     /** Apply discount code */
@@ -549,7 +628,7 @@ declare class OrdersModule {
     get(orderNumber: string): Promise<OrderDetail>;
     /** Cancel a PENDING order (requires auth) */
     cancel(orderNumber: string): Promise<OrderDetail>;
-    /** Track order by tracking token (no auth required) */
+    /** Track order by tracking token (no customer login required, only API key) */
     track(trackingToken: string): Promise<OrderDetail>;
 }
 declare class CustomerModule {
@@ -583,4 +662,4 @@ declare class PagesModule {
     get(slug: string, locale?: string): Promise<PageDetail>;
 }
 
-export { type AddToCartInput, type AddressType, AddressTypes, type AuthTokens, BehioApiError, type BehioErrorCode, type BehioEventHandler, type BehioEventType, BehioNetworkError, BehioStorefront, type BehioStorefrontConfig, type Cart, type CartDiscount, type CartItem, type CartItemProduct, type Category, type CategoryDetail, type CheckoutAddress, type CheckoutInput, type CustomerAddress, type CustomerProfile, type DataGroupFieldType, type FilterField, type FulfillmentStatus, FulfillmentStatuses, type LoginInput, type MessageResponse, type OrderDetail, type OrderItem, type OrderListItem, type OrderStatus, type OrderStatusHistory, OrderStatuses, type Page, type PageDetail, type PaginatedResponse, type PaymentStatus, PaymentStatuses, type ProductDetail, type ProductLabel, type ProductListItem, type ProductPrice, ProductSort, type ProductSortValue, type ProductVariant, type ProductVolumePrice, type ProductsQuery, type RegisterInput, type RequestInterceptor, type RequestInterceptorConfig, type ResponseInterceptor, type ResponseInterceptorData, type ShopInfo };
+export { type ActivePromotion, type AddToCartInput, type AddressType, AddressTypes, type AuthTokens, BehioApiError, type BehioErrorCode, type BehioEventHandler, type BehioEventType, BehioNetworkError, BehioStorefront, type BehioStorefrontConfig, type Bundle, type BundleItem, type Cart, type CartDiscount, type CartItem, type CartItemProduct, type Category, type CategoryDetail, type CheckoutAddress, type CheckoutInput, type CrossSellItem, type CustomerAddress, type CustomerProfile, type DataGroupFieldType, type FilterField, type FulfillmentStatus, FulfillmentStatuses, type LoginInput, type MessageResponse, type OrderDetail, type OrderItem, type OrderListItem, type OrderStatus, type OrderStatusHistory, OrderStatuses, type Page, type PageDetail, type PaginatedResponse, type PaymentStatus, PaymentStatuses, type ProductDetail, type ProductLabel, type ProductListItem, type ProductPrice, ProductSort, type ProductSortValue, type ProductVariant, type ProductVolumePrice, type ProductsQuery, type RegisterInput, type RequestInterceptor, type RequestInterceptorConfig, type ResponseInterceptor, type ResponseInterceptorData, type ShopInfo, type ShopSeo };

package/dist/index.d.ts

@@ -41,6 +41,15 @@ interface ShopInfo {
     metaDescription?: string;
     allowGuestCheckout: boolean;
 }
+interface ShopSeo {
+    locale: string;
+    title: string | null;
+    description: string | null;
+    keywords: string | null;
+    ogTitle: string | null;
+    ogDescription: string | null;
+    ogImage: string | null;
+}
 interface ProductPrice {
     amount: number;
     currency: string;
@@ -381,6 +390,52 @@ interface ResponseInterceptorData {
 interface ResponseInterceptor {
     (response: ResponseInterceptorData): void | Promise<void>;
 }
+interface BundleItem {
+    productId: string;
+    slug: string | null;
+    name: string;
+    sku: string;
+    quantity: number;
+    imageUrl: string | null;
+    defaultPrice: number | null;
+}
+interface Bundle {
+    id: string;
+    slug: string;
+    name: string;
+    description: string | null;
+    bundlePrice: number;
+    currency: string;
+    coverImage: string | null;
+    endsAt: number | null;
+    itemsSum: number;
+    savings: number;
+    savingsPercent: number;
+    items: BundleItem[];
+}
+interface CrossSellItem {
+    productId: string;
+    slug: string | null;
+    name: string;
+    sku: string;
+    price: number | null;
+    imageUrl: string | null;
+    stockCached: number;
+}
+interface ActivePromotion {
+    id: string;
+    name: string;
+    slug: string;
+    type: string;
+    discountType: string;
+    discountValue: number;
+    startsAt: number;
+    endsAt: number | null;
+    badgeText: string | null;
+    badgeColor: string | null;
+    showCountdown: boolean;
+    couponRequired: boolean;
+}
 
 declare class BehioStorefront {
     private baseUrl;
@@ -411,6 +466,8 @@ declare class BehioStorefront {
     readonly pages: PagesModule;
     /** Get basic shop info */
     getShopInfo(): Promise<ShopInfo>;
+    /** Get SEO metadata for the shop homepage in the given locale (defaults to shop default). */
+    getShopSeo(locale?: string): Promise<ShopSeo>;
     /** Set auth tokens (e.g. from localStorage) */
     setTokens(tokens: {
         accessToken: string;
@@ -488,6 +545,22 @@ declare class CatalogModule {
         page?: number;
         limit?: number;
     }): Promise<PaginatedResponse<ProductListItem>>;
+    /** List all active bundles */
+    getBundles(): Promise<{
+        items: Bundle[];
+    }>;
+    /** Get a single bundle by slug */
+    getBundle(slug: string): Promise<Bundle>;
+    /** Cross-sell / related / upsell products for a product */
+    getCrossSell(productSlug: string): Promise<{
+        related: CrossSellItem[];
+        upsell: CrossSellItem[];
+        crossSell: CrossSellItem[];
+    }>;
+    /** Active promotions applicable to a product (with countdown end time) */
+    getProductPromotions(productSlug: string): Promise<{
+        items: ActivePromotion[];
+    }>;
 }
 declare class AuthModule {
     private client;
@@ -524,6 +597,12 @@ declare class CartModule {
     removeItem(itemId: string): Promise<Cart>;
     /** Clear entire cart */
     clear(): Promise<void>;
+    /** Add a bundle to the cart (price is locked at the bundle's current price) */
+    addBundle(bundleId: string, quantity?: number): Promise<Cart>;
+    /** Update quantity of a bundle already in the cart */
+    updateBundleQuantity(bundleId: string, quantity: number): Promise<Cart>;
+    /** Remove a bundle from the cart */
+    removeBundle(bundleId: string): Promise<Cart>;
     /** Merge anonymous cart into authenticated customer cart */
     merge(): Promise<Cart>;
     /** Apply discount code */
@@ -549,7 +628,7 @@ declare class OrdersModule {
     get(orderNumber: string): Promise<OrderDetail>;
     /** Cancel a PENDING order (requires auth) */
     cancel(orderNumber: string): Promise<OrderDetail>;
-    /** Track order by tracking token (no auth required) */
+    /** Track order by tracking token (no customer login required, only API key) */
     track(trackingToken: string): Promise<OrderDetail>;
 }
 declare class CustomerModule {
@@ -583,4 +662,4 @@ declare class PagesModule {
     get(slug: string, locale?: string): Promise<PageDetail>;
 }
 
-export { type AddToCartInput, type AddressType, AddressTypes, type AuthTokens, BehioApiError, type BehioErrorCode, type BehioEventHandler, type BehioEventType, BehioNetworkError, BehioStorefront, type BehioStorefrontConfig, type Cart, type CartDiscount, type CartItem, type CartItemProduct, type Category, type CategoryDetail, type CheckoutAddress, type CheckoutInput, type CustomerAddress, type CustomerProfile, type DataGroupFieldType, type FilterField, type FulfillmentStatus, FulfillmentStatuses, type LoginInput, type MessageResponse, type OrderDetail, type OrderItem, type OrderListItem, type OrderStatus, type OrderStatusHistory, OrderStatuses, type Page, type PageDetail, type PaginatedResponse, type PaymentStatus, PaymentStatuses, type ProductDetail, type ProductLabel, type ProductListItem, type ProductPrice, ProductSort, type ProductSortValue, type ProductVariant, type ProductVolumePrice, type ProductsQuery, type RegisterInput, type RequestInterceptor, type RequestInterceptorConfig, type ResponseInterceptor, type ResponseInterceptorData, type ShopInfo };
+export { type ActivePromotion, type AddToCartInput, type AddressType, AddressTypes, type AuthTokens, BehioApiError, type BehioErrorCode, type BehioEventHandler, type BehioEventType, BehioNetworkError, BehioStorefront, type BehioStorefrontConfig, type Bundle, type BundleItem, type Cart, type CartDiscount, type CartItem, type CartItemProduct, type Category, type CategoryDetail, type CheckoutAddress, type CheckoutInput, type CrossSellItem, type CustomerAddress, type CustomerProfile, type DataGroupFieldType, type FilterField, type FulfillmentStatus, FulfillmentStatuses, type LoginInput, type MessageResponse, type OrderDetail, type OrderItem, type OrderListItem, type OrderStatus, type OrderStatusHistory, OrderStatuses, type Page, type PageDetail, type PaginatedResponse, type PaymentStatus, PaymentStatuses, type ProductDetail, type ProductLabel, type ProductListItem, type ProductPrice, ProductSort, type ProductSortValue, type ProductVariant, type ProductVolumePrice, type ProductsQuery, type RegisterInput, type RequestInterceptor, type RequestInterceptorConfig, type ResponseInterceptor, type ResponseInterceptorData, type ShopInfo, type ShopSeo };

package/dist/index.js

@@ -7,7 +7,7 @@
 
 
 
-var _chunkGGAO5T5Pjs = require('./chunk-GGAO5T5P.js');
+var _chunkQOEYSUF2js = require('./chunk-QOEYSUF2.js');
 
 
 
@@ -17,4 +17,4 @@ var _chunkGGAO5T5Pjs = require('./chunk-GGAO5T5P.js');
 
 
 
-exports.AddressTypes = _chunkGGAO5T5Pjs.AddressTypes; exports.BehioApiError = _chunkGGAO5T5Pjs.BehioApiError; exports.BehioNetworkError = _chunkGGAO5T5Pjs.BehioNetworkError; exports.BehioStorefront = _chunkGGAO5T5Pjs.BehioStorefront; exports.FulfillmentStatuses = _chunkGGAO5T5Pjs.FulfillmentStatuses; exports.OrderStatuses = _chunkGGAO5T5Pjs.OrderStatuses; exports.PaymentStatuses = _chunkGGAO5T5Pjs.PaymentStatuses; exports.ProductSort = _chunkGGAO5T5Pjs.ProductSort;
+exports.AddressTypes = _chunkQOEYSUF2js.AddressTypes; exports.BehioApiError = _chunkQOEYSUF2js.BehioApiError; exports.BehioNetworkError = _chunkQOEYSUF2js.BehioNetworkError; exports.BehioStorefront = _chunkQOEYSUF2js.BehioStorefront; exports.FulfillmentStatuses = _chunkQOEYSUF2js.FulfillmentStatuses; exports.OrderStatuses = _chunkQOEYSUF2js.OrderStatuses; exports.PaymentStatuses = _chunkQOEYSUF2js.PaymentStatuses; exports.ProductSort = _chunkQOEYSUF2js.ProductSort;

package/dist/index.mjs

@@ -7,7 +7,7 @@ import {
   OrderStatuses,
   PaymentStatuses,
   ProductSort
-} from "./chunk-S4DOL3OV.mjs";
+} from "./chunk-HYKJO2IB.mjs";
 export {
   AddressTypes,
   BehioApiError,

package/dist/react.d.mts

@@ -1,8 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
-import { BehioStorefront, ProductsQuery, PaginatedResponse, ProductListItem, ProductDetail, Category, CategoryDetail, ProductLabel, FilterField, Cart, CustomerProfile, RegisterInput, CustomerAddress, OrderListItem, OrderDetail, CheckoutInput, PageDetail, Page, ShopInfo } from './index.mjs';
-export { AddToCartInput, AuthTokens, BehioApiError, CartDiscount, CartItem, CheckoutAddress, FulfillmentStatus, LoginInput, MessageResponse, OrderItem, OrderStatus, PaymentStatus, ProductPrice, ProductVariant } from './index.mjs';
+import { BehioStorefront, ProductsQuery, PaginatedResponse, ProductListItem, ProductDetail, Category, CategoryDetail, ProductLabel, FilterField, Cart, CustomerProfile, RegisterInput, CustomerAddress, OrderListItem, OrderDetail, CheckoutInput, PageDetail, Page, ShopInfo, ShopSeo, Bundle, CrossSellItem, ActivePromotion } from './index.mjs';
+export { AddToCartInput, AuthTokens, BehioApiError, BundleItem, CartDiscount, CartItem, CheckoutAddress, FulfillmentStatus, LoginInput, MessageResponse, OrderItem, OrderStatus, PaymentStatus, ProductPrice, ProductVariant } from './index.mjs';
 import * as _tanstack_query_core from '@tanstack/query-core';
 
 interface StorageAdapter {
@@ -265,6 +265,62 @@ interface UseShopInfoOptions {
 }
 declare function useShopInfo(options?: UseShopInfoOptions): _tanstack_react_query.UseQueryResult<ShopInfo, Error>;
 
+interface UseShopSeoOptions {
+    /** Override locale (ISO-639-1). Defaults to the shop's default locale. */
+    locale?: string;
+    /** Hydrate from SSR-fetched data (use `client.getShopSeo(locale)` on the server). */
+    initialData?: ShopSeo;
+    /** Disable the query. */
+    enabled?: boolean;
+}
+/**
+ * React Query hook for per-locale shop SEO metadata. Safe to render on the
+ * server via `initialData` from `client.getShopSeo(locale)`.
+ */
+declare function useShopSeo(options?: UseShopSeoOptions): _tanstack_react_query.UseQueryResult<ShopSeo, Error>;
+
+/** List all active bundles. */
+declare function useBundles(options?: {
+    enabled?: boolean;
+    initialData?: {
+        items: Bundle[];
+    };
+}): _tanstack_react_query.UseQueryResult<{
+    items: Bundle[];
+}, Error>;
+/** Get a single bundle by slug. */
+declare function useBundle(slug: string | undefined, options?: {
+    enabled?: boolean;
+    initialData?: Bundle;
+}): _tanstack_react_query.UseQueryResult<Bundle, Error>;
+
+type CrossSellResponse = {
+    related: CrossSellItem[];
+    upsell: CrossSellItem[];
+    crossSell: CrossSellItem[];
+};
+/**
+ * Fetch related / upsell / cross-sell products for a given product.
+ * Returns all three lists separately so the UI can group them into
+ * different sections on the product detail page.
+ */
+declare function useCrossSell(productSlug: string | undefined, options?: {
+    enabled?: boolean;
+    initialData?: CrossSellResponse;
+}): _tanstack_react_query.UseQueryResult<CrossSellResponse, Error>;
+
+/**
+ * Fetch currently active promotions applicable to a specific product.
+ * Use this on product detail pages to render countdown timers and
+ * "AKCE -20%" badges.
+ */
+declare function useProductPromotions(productSlug: string | undefined, options?: {
+    enabled?: boolean;
+    refetchIntervalMs?: number;
+}): _tanstack_react_query.UseQueryResult<{
+    items: ActivePromotion[];
+}, Error>;
+
 /**
  * Returns the raw BehioStorefront client instance.
  *
@@ -283,4 +339,4 @@ declare function useBehioClient(): BehioStorefront;
  */
 declare function formatPrice(amount: number, currency: string, locale?: string): string;
 
-export { BehioProvider, type BehioProviderProps, Cart, Category, CategoryDetail, CheckoutInput, CustomerAddress, CustomerProfile, FilterField, OrderDetail, OrderListItem, Page, PageDetail, PaginatedResponse, ProductDetail, ProductLabel, ProductListItem, ProductsQuery, RegisterInput, ShopInfo, type StorageAdapter, type UseAddressesOptions, type UseCartCountOptions, type UseCartOptions, type UseCategoriesOptions, type UseCategoryOptions, type UseCustomerOptions, type UseFeaturedOptions, type UseFiltersOptions, type UseLabelsOptions, type UseOrderOptions, type UseOrdersOptions, type UsePageOptions, type UsePagesOptions, type UseProductOptions, type UseProductsOptions, type UseSearchOptions, type UseShopInfoOptions, cookieStorage, createMemoryStorage, detectStorage, formatPrice, localStorageAdapter, memoryStorage, useAddresses, useAuth, useBehio, useBehioClient, useCart, useCartCount, useCategories, useCategory, useCheckout, useCustomer, useFeatured, useFilters, useLabels, useOrder, useOrders, usePage, usePages, useProduct, useProducts, useSearch, useShopInfo };
+export { ActivePromotion, BehioProvider, type BehioProviderProps, Bundle, Cart, Category, CategoryDetail, CheckoutInput, CrossSellItem, CustomerAddress, CustomerProfile, FilterField, OrderDetail, OrderListItem, Page, PageDetail, PaginatedResponse, ProductDetail, ProductLabel, ProductListItem, ProductsQuery, RegisterInput, ShopInfo, ShopSeo, type StorageAdapter, type UseAddressesOptions, type UseCartCountOptions, type UseCartOptions, type UseCategoriesOptions, type UseCategoryOptions, type UseCustomerOptions, type UseFeaturedOptions, type UseFiltersOptions, type UseLabelsOptions, type UseOrderOptions, type UseOrdersOptions, type UsePageOptions, type UsePagesOptions, type UseProductOptions, type UseProductsOptions, type UseSearchOptions, type UseShopInfoOptions, type UseShopSeoOptions, cookieStorage, createMemoryStorage, detectStorage, formatPrice, localStorageAdapter, memoryStorage, useAddresses, useAuth, useBehio, useBehioClient, useBundle, useBundles, useCart, useCartCount, useCategories, useCategory, useCheckout, useCrossSell, useCustomer, useFeatured, useFilters, useLabels, useOrder, useOrders, usePage, usePages, useProduct, useProductPromotions, useProducts, useSearch, useShopInfo, useShopSeo };

package/dist/react.d.ts

@@ -1,8 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
-import { BehioStorefront, ProductsQuery, PaginatedResponse, ProductListItem, ProductDetail, Category, CategoryDetail, ProductLabel, FilterField, Cart, CustomerProfile, RegisterInput, CustomerAddress, OrderListItem, OrderDetail, CheckoutInput, PageDetail, Page, ShopInfo } from './index.js';
-export { AddToCartInput, AuthTokens, BehioApiError, CartDiscount, CartItem, CheckoutAddress, FulfillmentStatus, LoginInput, MessageResponse, OrderItem, OrderStatus, PaymentStatus, ProductPrice, ProductVariant } from './index.js';
+import { BehioStorefront, ProductsQuery, PaginatedResponse, ProductListItem, ProductDetail, Category, CategoryDetail, ProductLabel, FilterField, Cart, CustomerProfile, RegisterInput, CustomerAddress, OrderListItem, OrderDetail, CheckoutInput, PageDetail, Page, ShopInfo, ShopSeo, Bundle, CrossSellItem, ActivePromotion } from './index.js';
+export { AddToCartInput, AuthTokens, BehioApiError, BundleItem, CartDiscount, CartItem, CheckoutAddress, FulfillmentStatus, LoginInput, MessageResponse, OrderItem, OrderStatus, PaymentStatus, ProductPrice, ProductVariant } from './index.js';
 import * as _tanstack_query_core from '@tanstack/query-core';
 
 interface StorageAdapter {
@@ -265,6 +265,62 @@ interface UseShopInfoOptions {
 }
 declare function useShopInfo(options?: UseShopInfoOptions): _tanstack_react_query.UseQueryResult<ShopInfo, Error>;
 
+interface UseShopSeoOptions {
+    /** Override locale (ISO-639-1). Defaults to the shop's default locale. */
+    locale?: string;
+    /** Hydrate from SSR-fetched data (use `client.getShopSeo(locale)` on the server). */
+    initialData?: ShopSeo;
+    /** Disable the query. */
+    enabled?: boolean;
+}
+/**
+ * React Query hook for per-locale shop SEO metadata. Safe to render on the
+ * server via `initialData` from `client.getShopSeo(locale)`.
+ */
+declare function useShopSeo(options?: UseShopSeoOptions): _tanstack_react_query.UseQueryResult<ShopSeo, Error>;
+
+/** List all active bundles. */
+declare function useBundles(options?: {
+    enabled?: boolean;
+    initialData?: {
+        items: Bundle[];
+    };
+}): _tanstack_react_query.UseQueryResult<{
+    items: Bundle[];
+}, Error>;
+/** Get a single bundle by slug. */
+declare function useBundle(slug: string | undefined, options?: {
+    enabled?: boolean;
+    initialData?: Bundle;
+}): _tanstack_react_query.UseQueryResult<Bundle, Error>;
+
+type CrossSellResponse = {
+    related: CrossSellItem[];
+    upsell: CrossSellItem[];
+    crossSell: CrossSellItem[];
+};
+/**
+ * Fetch related / upsell / cross-sell products for a given product.
+ * Returns all three lists separately so the UI can group them into
+ * different sections on the product detail page.
+ */
+declare function useCrossSell(productSlug: string | undefined, options?: {
+    enabled?: boolean;
+    initialData?: CrossSellResponse;
+}): _tanstack_react_query.UseQueryResult<CrossSellResponse, Error>;
+
+/**
+ * Fetch currently active promotions applicable to a specific product.
+ * Use this on product detail pages to render countdown timers and
+ * "AKCE -20%" badges.
+ */
+declare function useProductPromotions(productSlug: string | undefined, options?: {
+    enabled?: boolean;
+    refetchIntervalMs?: number;
+}): _tanstack_react_query.UseQueryResult<{
+    items: ActivePromotion[];
+}, Error>;
+
 /**
  * Returns the raw BehioStorefront client instance.
  *
@@ -283,4 +339,4 @@ declare function useBehioClient(): BehioStorefront;
  */
 declare function formatPrice(amount: number, currency: string, locale?: string): string;
 
-export { BehioProvider, type BehioProviderProps, Cart, Category, CategoryDetail, CheckoutInput, CustomerAddress, CustomerProfile, FilterField, OrderDetail, OrderListItem, Page, PageDetail, PaginatedResponse, ProductDetail, ProductLabel, ProductListItem, ProductsQuery, RegisterInput, ShopInfo, type StorageAdapter, type UseAddressesOptions, type UseCartCountOptions, type UseCartOptions, type UseCategoriesOptions, type UseCategoryOptions, type UseCustomerOptions, type UseFeaturedOptions, type UseFiltersOptions, type UseLabelsOptions, type UseOrderOptions, type UseOrdersOptions, type UsePageOptions, type UsePagesOptions, type UseProductOptions, type UseProductsOptions, type UseSearchOptions, type UseShopInfoOptions, cookieStorage, createMemoryStorage, detectStorage, formatPrice, localStorageAdapter, memoryStorage, useAddresses, useAuth, useBehio, useBehioClient, useCart, useCartCount, useCategories, useCategory, useCheckout, useCustomer, useFeatured, useFilters, useLabels, useOrder, useOrders, usePage, usePages, useProduct, useProducts, useSearch, useShopInfo };
+export { ActivePromotion, BehioProvider, type BehioProviderProps, Bundle, Cart, Category, CategoryDetail, CheckoutInput, CrossSellItem, CustomerAddress, CustomerProfile, FilterField, OrderDetail, OrderListItem, Page, PageDetail, PaginatedResponse, ProductDetail, ProductLabel, ProductListItem, ProductsQuery, RegisterInput, ShopInfo, ShopSeo, type StorageAdapter, type UseAddressesOptions, type UseCartCountOptions, type UseCartOptions, type UseCategoriesOptions, type UseCategoryOptions, type UseCustomerOptions, type UseFeaturedOptions, type UseFiltersOptions, type UseLabelsOptions, type UseOrderOptions, type UseOrdersOptions, type UsePageOptions, type UsePagesOptions, type UseProductOptions, type UseProductsOptions, type UseSearchOptions, type UseShopInfoOptions, type UseShopSeoOptions, cookieStorage, createMemoryStorage, detectStorage, formatPrice, localStorageAdapter, memoryStorage, useAddresses, useAuth, useBehio, useBehioClient, useBundle, useBundles, useCart, useCartCount, useCategories, useCategory, useCheckout, useCrossSell, useCustomer, useFeatured, useFilters, useLabels, useOrder, useOrders, usePage, usePages, useProduct, useProductPromotions, useProducts, useSearch, useShopInfo, useShopSeo };

package/dist/react.js

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkGGAO5T5Pjs = require('./chunk-GGAO5T5P.js');
+var _chunkQOEYSUF2js = require('./chunk-QOEYSUF2.js');
 
 // src/react/provider.tsx
 var _react = require('react');
@@ -114,7 +114,7 @@ function BehioProvider({
   const storageAdapter = _react.useMemo.call(void 0, () => resolveStorage(storageOption), [storageOption]);
   const clientRef = _react.useRef.call(void 0, null);
   if (!clientRef.current) {
-    clientRef.current = new (0, _chunkGGAO5T5Pjs.BehioStorefront)({
+    clientRef.current = new (0, _chunkQOEYSUF2js.BehioStorefront)({
       apiKey,
       baseUrl,
       locale,
@@ -872,6 +872,64 @@ function useShopInfo(options) {
   });
 }
 
+// src/react/hooks/use-shop-seo.ts
+
+function useShopSeo(options) {
+  const { client } = useBehio();
+  const { locale, initialData, enabled = true } = _nullishCoalesce(options, () => ( {}));
+  return _reactquery.useQuery.call(void 0, {
+    queryKey: ["behio", "shop-seo", _nullishCoalesce(locale, () => ( "_default"))],
+    queryFn: () => client.getShopSeo(locale),
+    initialData,
+    enabled
+  });
+}
+
+// src/react/hooks/use-bundles.ts
+
+function useBundles(options) {
+  const { client } = useBehio();
+  return _reactquery.useQuery.call(void 0, {
+    queryKey: ["behio", "bundles"],
+    queryFn: () => client.catalog.getBundles(),
+    enabled: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _60 => _60.enabled]), () => ( true)),
+    initialData: _optionalChain([options, 'optionalAccess', _61 => _61.initialData])
+  });
+}
+function useBundle(slug, options) {
+  const { client } = useBehio();
+  return _reactquery.useQuery.call(void 0, {
+    queryKey: ["behio", "bundle", slug],
+    queryFn: () => client.catalog.getBundle(slug),
+    enabled: Boolean(slug) && (_nullishCoalesce(_optionalChain([options, 'optionalAccess', _62 => _62.enabled]), () => ( true))),
+    initialData: _optionalChain([options, 'optionalAccess', _63 => _63.initialData])
+  });
+}
+
+// src/react/hooks/use-cross-sell.ts
+
+function useCrossSell(productSlug, options) {
+  const { client } = useBehio();
+  return _reactquery.useQuery.call(void 0, {
+    queryKey: ["behio", "cross-sell", productSlug],
+    queryFn: () => client.catalog.getCrossSell(productSlug),
+    enabled: Boolean(productSlug) && (_nullishCoalesce(_optionalChain([options, 'optionalAccess', _64 => _64.enabled]), () => ( true))),
+    initialData: _optionalChain([options, 'optionalAccess', _65 => _65.initialData])
+  });
+}
+
+// src/react/hooks/use-product-promotions.ts
+
+function useProductPromotions(productSlug, options) {
+  const { client } = useBehio();
+  return _reactquery.useQuery.call(void 0, {
+    queryKey: ["behio", "product-promotions", productSlug],
+    queryFn: () => client.catalog.getProductPromotions(productSlug),
+    enabled: Boolean(productSlug) && (_nullishCoalesce(_optionalChain([options, 'optionalAccess', _66 => _66.enabled]), () => ( true))),
+    refetchInterval: _optionalChain([options, 'optionalAccess', _67 => _67.refetchIntervalMs])
+  });
+}
+
 // src/react/hooks/use-behio-client.ts
 function useBehioClient() {
   return useBehio().client;
@@ -920,4 +978,9 @@ function formatPrice(amount, currency, locale) {
 
 
 
-exports.BehioProvider = BehioProvider; exports.cookieStorage = cookieStorage; exports.createMemoryStorage = createMemoryStorage; exports.detectStorage = detectStorage; exports.formatPrice = formatPrice; exports.localStorageAdapter = localStorageAdapter; exports.memoryStorage = memoryStorage; exports.useAddresses = useAddresses; exports.useAuth = useAuth; exports.useBehio = useBehio; exports.useBehioClient = useBehioClient; exports.useCart = useCart; exports.useCartCount = useCartCount; exports.useCategories = useCategories; exports.useCategory = useCategory; exports.useCheckout = useCheckout; exports.useCustomer = useCustomer; exports.useFeatured = useFeatured; exports.useFilters = useFilters; exports.useLabels = useLabels; exports.useOrder = useOrder; exports.useOrders = useOrders; exports.usePage = usePage; exports.usePages = usePages; exports.useProduct = useProduct; exports.useProducts = useProducts; exports.useSearch = useSearch; exports.useShopInfo = useShopInfo;
+
+
+
+
+
+exports.BehioProvider = BehioProvider; exports.cookieStorage = cookieStorage; exports.createMemoryStorage = createMemoryStorage; exports.detectStorage = detectStorage; exports.formatPrice = formatPrice; exports.localStorageAdapter = localStorageAdapter; exports.memoryStorage = memoryStorage; exports.useAddresses = useAddresses; exports.useAuth = useAuth; exports.useBehio = useBehio; exports.useBehioClient = useBehioClient; exports.useBundle = useBundle; exports.useBundles = useBundles; exports.useCart = useCart; exports.useCartCount = useCartCount; exports.useCategories = useCategories; exports.useCategory = useCategory; exports.useCheckout = useCheckout; exports.useCrossSell = useCrossSell; exports.useCustomer = useCustomer; exports.useFeatured = useFeatured; exports.useFilters = useFilters; exports.useLabels = useLabels; exports.useOrder = useOrder; exports.useOrders = useOrders; exports.usePage = usePage; exports.usePages = usePages; exports.useProduct = useProduct; exports.useProductPromotions = useProductPromotions; exports.useProducts = useProducts; exports.useSearch = useSearch; exports.useShopInfo = useShopInfo; exports.useShopSeo = useShopSeo;

package/dist/react.mjs

@@ -1,6 +1,6 @@
 import {
   BehioStorefront
-} from "./chunk-S4DOL3OV.mjs";
+} from "./chunk-HYKJO2IB.mjs";
 
 // src/react/provider.tsx
 import { useRef, useEffect, useMemo } from "react";
@@ -872,6 +872,64 @@ function useShopInfo(options) {
   });
 }
 
+// src/react/hooks/use-shop-seo.ts
+import { useQuery as useQuery15 } from "@tanstack/react-query";
+function useShopSeo(options) {
+  const { client } = useBehio();
+  const { locale, initialData, enabled = true } = options ?? {};
+  return useQuery15({
+    queryKey: ["behio", "shop-seo", locale ?? "_default"],
+    queryFn: () => client.getShopSeo(locale),
+    initialData,
+    enabled
+  });
+}
+
+// src/react/hooks/use-bundles.ts
+import { useQuery as useQuery16 } from "@tanstack/react-query";
+function useBundles(options) {
+  const { client } = useBehio();
+  return useQuery16({
+    queryKey: ["behio", "bundles"],
+    queryFn: () => client.catalog.getBundles(),
+    enabled: options?.enabled ?? true,
+    initialData: options?.initialData
+  });
+}
+function useBundle(slug, options) {
+  const { client } = useBehio();
+  return useQuery16({
+    queryKey: ["behio", "bundle", slug],
+    queryFn: () => client.catalog.getBundle(slug),
+    enabled: Boolean(slug) && (options?.enabled ?? true),
+    initialData: options?.initialData
+  });
+}
+
+// src/react/hooks/use-cross-sell.ts
+import { useQuery as useQuery17 } from "@tanstack/react-query";
+function useCrossSell(productSlug, options) {
+  const { client } = useBehio();
+  return useQuery17({
+    queryKey: ["behio", "cross-sell", productSlug],
+    queryFn: () => client.catalog.getCrossSell(productSlug),
+    enabled: Boolean(productSlug) && (options?.enabled ?? true),
+    initialData: options?.initialData
+  });
+}
+
+// src/react/hooks/use-product-promotions.ts
+import { useQuery as useQuery18 } from "@tanstack/react-query";
+function useProductPromotions(productSlug, options) {
+  const { client } = useBehio();
+  return useQuery18({
+    queryKey: ["behio", "product-promotions", productSlug],
+    queryFn: () => client.catalog.getProductPromotions(productSlug),
+    enabled: Boolean(productSlug) && (options?.enabled ?? true),
+    refetchInterval: options?.refetchIntervalMs
+  });
+}
+
 // src/react/hooks/use-behio-client.ts
 function useBehioClient() {
   return useBehio().client;
@@ -903,11 +961,14 @@ export {
   useAuth,
   useBehio,
   useBehioClient,
+  useBundle,
+  useBundles,
   useCart,
   useCartCount,
   useCategories,
   useCategory,
   useCheckout,
+  useCrossSell,
   useCustomer,
   useFeatured,
   useFilters,
@@ -917,7 +978,9 @@ export {
   usePage,
   usePages,
   useProduct,
+  useProductPromotions,
   useProducts,
   useSearch,
-  useShopInfo
+  useShopInfo,
+  useShopSeo
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@behio/storefront-sdk",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "TypeScript SDK for Behio Headless E-Shop — core client + React hooks",
   "author": "Behio",
   "license": "MIT",