medusa-storefront-data 2.5.7 → 2.5.8

package/HOMEPAGE_CONFIG.md

@@ -166,7 +166,7 @@ Compose `options.configs` from `homepageSectionFields` or individual `*HomepageS
 
 Help page FAQs use **`helpFaqHomepageSectionField`** from `medusa-ui-home-config/sections/helpFaq` (also included in `homepageSectionFields`).
 
-**Split dynamic-config keys** (Medusa plugin): store FAQs under `faqs.helpFaq`; homepage sections under `homepage-sections.sections`. `homepageConfigFromDynamicResponse` assembles these automatically:
+**Split dynamic-config keys** (Medusa plugin): store FAQs under `faqs.helpFaq`; homepage sections under `homepage-sections.sections`; hero slides under `hero-banners` (`homeBanners` / `appBanners` with `slide` rows). `homepageConfigFromDynamicResponse` assembles these automatically:
 
 ```json
 {
@@ -196,6 +196,28 @@ Help page FAQs use **`helpFaqHomepageSectionField`** from `medusa-ui-home-config
 }
 ```
 
+**Hero banners** (`hero-banners`): each slide uses `image`, `title`, `subtitle`, `description`, `buttonText`, `buttonLink`. These map to `homepage-banner-array` / `app-banner-array` via `normalizeHomepageConfig` (same fields as `DynamicBanner`: title → eyebrow, subtitle → headline).
+
+```json
+{
+  "hero-banners": {
+    "homeBanners": [
+      {
+        "slide": {
+          "image": "https://…",
+          "title": "BEST QUALITY",
+          "subtitle": "Electronics & Essentials",
+          "description": "…",
+          "buttonText": "Shop now",
+          "buttonLink": "/store"
+        }
+      }
+    ],
+    "appBanners": []
+  }
+}
+```
+
 Legacy single `homepage-config` with `sections.helpFaq` (flat `items` or nested `category` / `faq` wrappers) still works. Legacy flat `faq-array` entries are grouped by `faq-category`.
 
 Storefront UI still imports from `medusa-ui-home/sections/<id>`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "medusa-storefront-data",
-  "version": "2.5.7",
+  "version": "2.5.8",
   "type": "module",
   "description": "Medusa storefront server data layer extracted from Next.js storefront",
   "license": "MIT",
@@ -17,7 +17,8 @@
   ],
   "scripts": {
     "build": "tsc",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "test": "npm run build"
   },
   "peerDependencies": {
     "next": ">=14",

package/src/server/dynamic-config.ts

@@ -9,7 +9,10 @@ import {
 } from "./homepage-section-defaults"
 import type { DynamicConfigResponse, HomepageConfig } from "./homepage-config.types"
 import { mergeSectionBlock } from "./config-merge"
-import { mergePageInputWithDefaults, resolvePageInput } from "./page-input"
+import {
+  mergePageInputWithDefaults,
+  resolvePageInput,
+} from "./page-input"
 
 export {
   DEFAULT_PAGE_INPUT,
@@ -20,7 +23,6 @@ export {
   type StorefrontPageInput,
 } from "./page-input"
 
-
 export const getDynamicConfig = cache(async (): Promise<DynamicConfigResponse | null> => {
   try {
     const publishableKey = process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY
@@ -80,6 +82,7 @@ export function getLogoFromPageInput(
 
 
 
+/** Normalized hero slide used by storefront UI (`getHomeBannersFromPageInput`). */
 export type HomepageBanner = {
   image?: string
   title?: string
@@ -131,8 +134,6 @@ export function getAppBannersFromPageInput(
   return null
 }
 
-
-
 // Legacy function for backward compatibility
 
 export function getWebsiteDescriptionFromPageInput(

package/src/server/page-input.ts

@@ -14,6 +14,87 @@ function asObject(v: unknown): Loose | null {
   return v && typeof v === "object" && !Array.isArray(v) ? (v as Loose) : null
 }
 
+function asArray(v: unknown): unknown[] {
+  return Array.isArray(v) ? v : []
+}
+
+/** `hero-banners.homeBanners[].slide` from medusa-plugin-dynamic-config. */
+function heroSlideRow(row: unknown): Loose | null {
+  const rowObj = asObject(row)
+  if (!rowObj) return null
+  const slide = asObject(rowObj.slide) ?? rowObj
+  const image = slide.image
+  if (image == null || image === "") return null
+  return {
+    image,
+    title: slide.title,
+    subtitle: slide.subtitle,
+    description: slide.description,
+    buttonText: slide.buttonText ?? slide.buttonName,
+    buttonLink: slide.buttonLink,
+  }
+}
+
+function simplifiedConfigFromHeroBanners(
+  response: DynamicConfigResponse | null | undefined
+): HomepageConfig | null {
+  if (!response || typeof response !== "object") return null
+  const root = asObject((response as Loose)["hero-banners"])
+  if (!root) return null
+
+  const desktop = asArray(root.homeBanners)
+    .map(heroSlideRow)
+    .filter((row): row is Loose => row !== null)
+  const mobile = asArray(root.appBanners)
+    .map(heroSlideRow)
+    .filter((row): row is Loose => row !== null)
+
+  if (!desktop.length && !mobile.length) return null
+
+  const banners: Loose = {}
+  if (desktop.length) banners.desktop = desktop
+  if (mobile.length) banners.mobile = mobile
+
+  return { site: { banners } } as HomepageConfig
+}
+
+function mergeHomepageConfigLayers(
+  ...layers: Array<HomepageConfig | null | undefined>
+): HomepageConfig | null {
+  const defined = layers.filter(Boolean) as HomepageConfig[]
+  if (!defined.length) return null
+  if (defined.length === 1) return defined[0]
+
+  const merged: Loose = {}
+  for (const layer of defined) {
+    const site = asObject((layer as Loose).site) ?? {}
+    const mergedSite = asObject(merged.site) ?? {}
+    const layerBanners = asObject(site.banners)
+    if (layerBanners) {
+      mergedSite.banners = {
+        ...(asObject(mergedSite.banners) ?? {}),
+        ...layerBanners,
+      }
+    }
+    for (const [key, value] of Object.entries(site)) {
+      if (key !== "banners" && value !== undefined) mergedSite[key] = value
+    }
+    if (Object.keys(mergedSite).length) merged.site = mergedSite
+
+    const sections = asObject((layer as Loose).sections)
+    if (sections) {
+      merged.sections = { ...(asObject(merged.sections) ?? {}), ...sections }
+    }
+
+    for (const [key, value] of Object.entries(layer as Loose)) {
+      if (key === "site" || key === "sections") continue
+      if (value !== undefined) merged[key] = value
+    }
+  }
+
+  return merged as HomepageConfig
+}
+
 /** Full `homepage-config` blob passed from the main project into pages and layout. */
 export type StorefrontPageInput = HomepageConfig
 
@@ -106,16 +187,24 @@ export function simplifiedHomepageConfigFromDynamicResponse(
     : null
 }
 
+/** CMS-only homepage config (no package JSON defaults). */
+export function homepageConfigFromDynamicResponseNormalized(
+  response: DynamicConfigResponse | null | undefined
+): HomepageConfig {
+  const legacy = response?.["homepage-config"] ?? null
+  const fromSplit = simplifiedHomepageConfigFromDynamicResponse(response)
+  const fromHeroBanners = simplifiedConfigFromHeroBanners(response)
+  const raw = mergeHomepageConfigLayers(fromSplit, legacy, fromHeroBanners)
+  return normalizeHomepageConfig(raw)
+}
+
 /**
  * Build `homepage-config` from Medusa `GET /store/dynamic-config` (main project only).
- * Supports legacy `homepage-config` or split plugin keys.
+ * Supports legacy `homepage-config`, split plugin keys, and `hero-banners`.
  */
 export function homepageConfigFromDynamicResponse(
   response: DynamicConfigResponse | null | undefined
 ): StorefrontPageInput {
-  const legacy = response?.["homepage-config"] ?? null
-  const fromSplit = simplifiedHomepageConfigFromDynamicResponse(response)
-  const raw = fromSplit ?? legacy
-  const normalized = normalizeHomepageConfig(raw)
+  const normalized = homepageConfigFromDynamicResponseNormalized(response)
   return mergePageInputWithDefaults(normalized)
 }

package/dist/segment-data/default-page-input.json

@@ -1,191 +0,0 @@
-{
-    "logo": "/Logo.png",
-    "website-description": "Premium kids fashion for everyday wear and special occasions.",
-    "homepage-banner-array": [
-        {
-            "homepage-banner": {
-                "homepage-banner-image": "/newbanner.png",
-                "homepage-banner-title": "Premium Kids Shop",
-                "homepage-banner-subtitle": "Little Trends, Quality Kids Wear",
-                "homepage-banner-description": "Shop stylish kids wear for little ones and children of all years—from newborn up to 15 years.",
-                "homepage-banner-button-name": "Shop Kids Wear",
-                "homepage-banner-button-link": "/store"
-            }
-        }
-    ],
-    "app-banner-array": [
-        {
-            "app-banner": {
-                "app-banner-image": "/appbanner.png",
-                "app-banner-title": "Premium Kids Shop",
-                "app-banner-subtitle": "Little Trends, Quality Kids Wear",
-                "app-banner-description": "Shop stylish kids wear for little ones and children of all years—from newborn up to 15 years.",
-                "app-banner-button-name": "Shop Kids Wear",
-                "app-banner-button-link": "/store"
-            }
-        }
-    ],
-    "promo-bar": {
-        "promo-text": null,
-        "promo-code": null,
-        "promo-active": false
-    },
-    "contact-us": {
-        "contact-phone": "+1 000 000 0000",
-        "contact-email": "hello@yourstore.com",
-        "contact-address": "Your store address"
-    },
-    "social-links": [],
-    "faq-array": [],
-    "sections": {
-        "promoAnnouncements": {
-            "messages": [
-                "Free shipping on orders over a threshold",
-                "Worldwide shipping available",
-                "Selected products available with customisation",
-                "Need help choosing? Book a video call consultation"
-            ]
-        },
-        "hero": {},
-        "categoryPills": {},
-        "newArrivals": {
-            "title": "New Arrivals",
-            "subtitle": "Fresh styles just landed",
-            "variant": "grid"
-        },
-        "newArrivalsClassic": {
-            "title": "New Arrivals",
-            "subtitle": "Fresh styles just landed",
-            "variant": "classic"
-        },
-        "promoCountdown": {
-            "code": "SAVE50",
-            "text": "Up to 50% off — shop your favourites before they're gone!",
-            "end-at": "2026-12-31T23:59:59.000Z",
-            "active": false,
-            "cta-label": "Shop Offers",
-            "cta-href": "/store"
-        },
-        "celebrityTrust": {
-            "title": "Trusted by Celebrities",
-            "text": "When the stars dress their little ones in our collections."
-        },
-        "luxeFavourites": {
-            "title": "Luxe Favourites"
-        },
-        "shopByCategory": {
-            "title": "Shop By Categories",
-            "description": "Browse by style and occasion"
-        },
-        "baptism": {
-            "title": "Baptism"
-        },
-        "baptismPicks": {
-            "title": "Baptism Picks",
-            "looks": []
-        },
-        "themeDresses": {
-            "title": "Theme",
-            "description": "Dress her in a dreamy theme outfit for her birthday celebration"
-        },
-        "brandMarquee": {
-            "text": "est. 2012"
-        },
-        "aboutBrand": {
-            "eyebrow": "Who We Are",
-            "title": "Discover what makes us different",
-            "description": "We offer stylish, comfortable, and high-quality clothing for children, crafted for everyday wear and special occasions.",
-            "readMoreHref": "/about",
-            "stats": [
-                {
-                    "label": "Visit us in store",
-                    "value": "Find a location"
-                },
-                {
-                    "label": "Happy customers",
-                    "value": "150k+"
-                },
-                {
-                    "label": "Products",
-                    "value": "3000+"
-                }
-            ]
-        },
-        "testimonials": {
-            "title": "What Clients Talk About Us",
-            "description": "The Trust We've Earned",
-            "items": [
-                {
-                    "text": "Amazing place if you are looking for a dress for ur little girl's special day.",
-                    "name": "Greeshma thottippal shanmughan"
-                },
-                {
-                    "text": "I frequently buy dresses for my baby from this store and I am extremely satisfied with the purchase.",
-                    "name": "Priyanka Rajesh"
-                }
-            ]
-        },
-        "instagramPosts": {
-            "title": "Follow Us on Instagram",
-            "handle": "yourbrand",
-            "profile-url": "https://www.instagram.com/yourbrand/",
-            "profile-image": "/Logo.png",
-            "posts": []
-        },
-        "brandPillars": {
-            "title": "This approach resulted in the beautiful structure",
-            "pillars": [
-                {
-                    "title": "Your favorite kids destination",
-                    "description": "Trendy, high-quality outfits for little ones.",
-                    "image": "/features/store.jpg"
-                }
-            ]
-        },
-        "features": {
-            "title": "Why shop with us",
-            "description": "Secure checkout, fast delivery, and easy exchanges",
-            "features": [
-                {
-                    "name": "100% Secure",
-                    "icon": "/secure.svg"
-                },
-                {
-                    "name": "Easy Exchanges",
-                    "icon": "/exchnage.svg"
-                }
-            ]
-        },
-        "whyChooseUs": {
-            "title": "Why Choose Us?",
-            "features": [
-                {
-                    "feature-name": "Premium Quality",
-                    "feature-icon": "/icons/quality.svg"
-                }
-            ]
-        },
-        "lovedByMoms": {
-            "title": "Loved by Moms",
-            "description": "Top-rated styles loved by parents and kids alike."
-        },
-        "shopByAge": {
-            "title": "Shop By Age"
-        },
-        "videoStories": {
-            "title": "Watch Stories & Reviews",
-            "video-urls": []
-        },
-        "blogPosts": {
-            "title": "Blog posts",
-            "posts": [
-                {
-                    "title": "Which Theme Dress Matches Her Vibe?",
-                    "href": "/blog/theme-dress-vibe",
-                    "category": "Theme Dress",
-                    "date": "May 24, 2026"
-                }
-            ]
-        }
-    }
-}

package/dist/src/config.d.ts

@@ -1,3 +0,0 @@
-import Medusa from "@medusajs/js-sdk";
-export declare const sdk: Medusa;
-//# sourceMappingURL=config.d.ts.map

package/dist/src/config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AACA,OAAO,MAAiC,MAAM,kBAAkB,CAAA;AAShE,eAAO,MAAM,GAAG,QAId,CAAA"}

package/dist/src/config.js

@@ -1,31 +0,0 @@
-import { getLocaleHeader } from "./util/get-locale-header";
-import Medusa from "@medusajs/js-sdk";
-// Defaults to standard port for Medusa server
-let MEDUSA_BACKEND_URL = "http://localhost:9000";
-if (process.env.MEDUSA_BACKEND_URL) {
-    MEDUSA_BACKEND_URL = process.env.MEDUSA_BACKEND_URL;
-}
-export const sdk = new Medusa({
-    baseUrl: MEDUSA_BACKEND_URL,
-    debug: process.env.NODE_ENV === "development",
-    publishableKey: process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY,
-});
-const originalFetch = sdk.client.fetch.bind(sdk.client);
-sdk.client.fetch = async (input, init) => {
-    const headers = init?.headers ?? {};
-    let localeHeader;
-    try {
-        localeHeader = await getLocaleHeader();
-        headers["x-medusa-locale"] ??= localeHeader["x-medusa-locale"];
-    }
-    catch { }
-    const newHeaders = {
-        ...localeHeader,
-        ...headers,
-    };
-    init = {
-        ...init,
-        headers: newHeaders,
-    };
-    return originalFetch(input, init);
-};

package/dist/src/cookies.d.ts

@@ -1,23 +0,0 @@
-import "server-only";
-export declare const getAuthHeaders: () => Promise<{
-    authorization: string;
-} | {}>;
-export declare const getGuestAuthHeaders: () => Promise<{
-    authorization: string;
-} | {}>;
-export declare const getCacheTag: (tag: string) => Promise<string>;
-export declare const getCacheOptions: (tag: string) => Promise<{
-    tags: string[];
-} | {}>;
-export declare const setAuthToken: (token: string) => Promise<void>;
-export declare const removeAuthToken: () => Promise<void>;
-export declare const getCartId: () => Promise<string | undefined>;
-export declare const setCartId: (cartId: string) => Promise<void>;
-export declare const removeCartId: () => Promise<void>;
-export declare const removeSyncLock: () => Promise<void>;
-export declare const setHoldCartId: (cartId: string) => Promise<void>;
-export declare const getHoldCartId: () => Promise<string | undefined>;
-export declare const removeHoldCartId: () => Promise<void>;
-export declare const setBuyNowCartId: (cartId: string) => Promise<void>;
-export declare const removeBuyNowCartId: () => Promise<void>;
-//# sourceMappingURL=cookies.d.ts.map

package/dist/src/cookies.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../src/cookies.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAA;AAGpB,eAAO,MAAM,cAAc,QAAa,OAAO,CAC7C;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,EAAE,CAc/B,CAAA;AAED,eAAO,MAAM,mBAAmB,QAAa,OAAO,CAClD;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,EAAE,CAc/B,CAAA;AAED,eAAO,MAAM,WAAW,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,MAAM,CAa7D,CAAA;AAED,eAAO,MAAM,eAAe,GAC1B,KAAK,MAAM,KACV,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,EAAE,CAYjC,CAAA;AAED,eAAO,MAAM,YAAY,GAAU,OAAO,MAAM,kBAQ/C,CAAA;AAED,eAAO,MAAM,eAAe,qBAK3B,CAAA;AAED,eAAO,MAAM,SAAS,mCAsBrB,CAAA;AAED,eAAO,MAAM,SAAS,GAAU,QAAQ,MAAM,kBAQ7C,CAAA;AAED,eAAO,MAAM,YAAY,qBAKxB,CAAA;AAED,eAAO,MAAM,cAAc,qBAK1B,CAAA;AAED,eAAO,MAAM,aAAa,GAAU,QAAQ,MAAM,kBAQjD,CAAA;AAED,eAAO,MAAM,aAAa,mCAGzB,CAAA;AAED,eAAO,MAAM,gBAAgB,qBAK5B,CAAA;AAED,eAAO,MAAM,eAAe,GAAU,QAAQ,MAAM,kBAQnD,CAAA;AAED,eAAO,MAAM,kBAAkB,qBAK9B,CAAA"}

package/dist/src/cookies.js

@@ -1,140 +0,0 @@
-import "server-only";
-import { cookies as nextCookies, headers } from "next/headers";
-export const getAuthHeaders = async () => {
-    try {
-        const cookies = await nextCookies();
-        const token = cookies.get("_medusa_jwt")?.value;
-        if (!token) {
-            return {};
-        }
-        return { authorization: `Bearer ${token}` };
-    }
-    catch {
-        return {};
-    }
-};
-export const getGuestAuthHeaders = async () => {
-    try {
-        const cookies = await nextCookies();
-        const token = cookies.get("_medusa_guest_jwt")?.value;
-        if (!token) {
-            return {};
-        }
-        return { authorization: `Bearer ${token}` };
-    }
-    catch {
-        return {};
-    }
-};
-export const getCacheTag = async (tag) => {
-    try {
-        const cookies = await nextCookies();
-        const cacheId = cookies.get("_medusa_cache_id")?.value;
-        if (!cacheId) {
-            return "";
-        }
-        return `${tag}-${cacheId}`;
-    }
-    catch (error) {
-        return "";
-    }
-};
-export const getCacheOptions = async (tag) => {
-    if (typeof window !== "undefined") {
-        return {};
-    }
-    const cacheTag = await getCacheTag(tag);
-    if (!cacheTag) {
-        return {};
-    }
-    return { tags: [`${cacheTag}`] };
-};
-export const setAuthToken = async (token) => {
-    const cookies = await nextCookies();
-    cookies.set("_medusa_jwt", token, {
-        maxAge: 60 * 60 * 24 * 7,
-        httpOnly: true,
-        sameSite: "strict",
-        secure: process.env.NODE_ENV === "production",
-    });
-};
-export const removeAuthToken = async () => {
-    const cookies = await nextCookies();
-    cookies.set("_medusa_jwt", "", {
-        maxAge: -1,
-    });
-};
-export const getCartId = async () => {
-    const cookies = await nextCookies();
-    const headerList = await headers();
-    // Check for x-cart-id header FIRST (as it's the most up-to-date from middleware)
-    const headerId = headerList.get("x-cart-id");
-    if (headerId) {
-        return headerId;
-    }
-    // Prioritize buy_now_cart_id if it exists
-    const buyNowId = cookies.get("buy_now_cart_id")?.value;
-    if (buyNowId) {
-        return buyNowId;
-    }
-    // Fallback to regular cart cookies
-    const id = cookies.get("_medusa_cart_id")?.value ||
-        cookies.get("cart_id")?.value ||
-        cookies.get("medusa_cart_id")?.value;
-    return id;
-};
-export const setCartId = async (cartId) => {
-    const cookies = await nextCookies();
-    cookies.set("_medusa_cart_id", cartId, {
-        maxAge: 60 * 60 * 24 * 7,
-        httpOnly: true,
-        sameSite: "strict",
-        secure: process.env.NODE_ENV === "production",
-    });
-};
-export const removeCartId = async () => {
-    const cookies = await nextCookies();
-    cookies.set("_medusa_cart_id", "", {
-        maxAge: -1,
-    });
-};
-export const removeSyncLock = async () => {
-    const cookies = await nextCookies();
-    cookies.set("_medusa_cart_synced", "", {
-        maxAge: -1,
-    });
-};
-export const setHoldCartId = async (cartId) => {
-    const cookies = await nextCookies();
-    cookies.set("_medusa_hold_cart_id", cartId, {
-        maxAge: 60 * 60 * 24,
-        httpOnly: true,
-        sameSite: "strict",
-        secure: process.env.NODE_ENV === "production",
-    });
-};
-export const getHoldCartId = async () => {
-    const cookies = await nextCookies();
-    return cookies.get("_medusa_hold_cart_id")?.value;
-};
-export const removeHoldCartId = async () => {
-    const cookies = await nextCookies();
-    cookies.set("_medusa_hold_cart_id", "", {
-        maxAge: -1,
-    });
-};
-export const setBuyNowCartId = async (cartId) => {
-    const cookies = await nextCookies();
-    cookies.set("buy_now_cart_id", cartId, {
-        maxAge: 60 * 60 * 24 * 7,
-        httpOnly: true,
-        sameSite: "strict",
-        secure: process.env.NODE_ENV === "production",
-    });
-};
-export const removeBuyNowCartId = async () => {
-    const cookies = await nextCookies();
-    cookies.set("buy_now_cart_id", "", {
-        maxAge: -1,
-    });
-};