medusa-storefront-data 2.3.0 → 2.5.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "medusa-storefront-data",
-  "version": "2.3.0",
+  "version": "2.5.1",
   "type": "module",
   "description": "Medusa storefront server data layer extracted from Next.js storefront",
   "license": "MIT",
@@ -9,7 +9,11 @@
   },
   "files": [
     "src",
-    "dist"
+    "dist",
+    "homepage-config.example.json",
+    "homepage-sections.example.json",
+    "segment-data",
+    "HOMEPAGE_CONFIG.md"
   ],
   "scripts": {
     "build": "tsc",
@@ -49,160 +53,120 @@
       "import": "./src/server/index.ts",
       "default": "./src/server/index.ts"
     },
-    "./cookies": {
-      "types": "./dist/cookies.d.ts",
-      "import": "./src/cookies.ts",
-      "default": "./src/cookies.ts"
-    },
-    "./config": {
-      "types": "./dist/config.d.ts",
-      "import": "./src/config.ts",
-      "default": "./src/config.ts"
-    },
-    "./locale-header": {
-      "types": "./dist/util/get-locale-header.d.ts",
-      "import": "./src/util/get-locale-header.ts",
-      "default": "./src/util/get-locale-header.ts"
-    },
-    "./medusa-error": {
-      "types": "./dist/util/medusa-error.d.ts",
-      "import": "./src/util/medusa-error.ts",
-      "default": "./src/util/medusa-error.ts"
-    },
-    "./sort-products": {
-      "types": "./dist/util/sort-products.d.ts",
-      "import": "./src/util/sort-products.ts",
-      "default": "./src/util/sort-products.ts"
-    },
-    "./middleware": {
-      "types": "./dist/middleware.d.ts",
-      "import": "./src/middleware.ts",
-      "default": "./src/middleware.ts"
-    },
-    "./edge": {
-      "types": "./dist/edge.d.ts",
-      "import": "./src/edge.ts",
-      "default": "./src/edge.ts"
-    },
-    "./cart": {
-      "types": "./dist/server/cart.d.ts",
-      "import": "./src/server/cart.ts",
-      "default": "./src/server/cart.ts"
-    },
-    "./categories": {
-      "types": "./dist/server/categories.d.ts",
-      "import": "./src/server/categories.ts",
-      "default": "./src/server/categories.ts"
-    },
-    "./collections": {
-      "types": "./dist/server/collections.d.ts",
-      "import": "./src/server/collections.ts",
-      "default": "./src/server/collections.ts"
-    },
-    "./contact": {
-      "types": "./dist/server/contact.d.ts",
-      "import": "./src/server/contact.ts",
-      "default": "./src/server/contact.ts"
-    },
-    "./customer": {
-      "types": "./dist/server/customer.d.ts",
-      "import": "./src/server/customer.ts",
-      "default": "./src/server/customer.ts"
-    },
-    "./customer-registration": {
-      "types": "./dist/server/customer-registration.d.ts",
-      "import": "./src/server/customer-registration.ts",
-      "default": "./src/server/customer-registration.ts"
-    },
-    "./dynamic-config": {
-      "types": "./dist/server/dynamic-config.d.ts",
-      "import": "./src/server/dynamic-config.ts",
-      "default": "./src/server/dynamic-config.ts"
-    },
-    "./fulfillment": {
-      "types": "./dist/server/fulfillment.d.ts",
-      "import": "./src/server/fulfillment.ts",
-      "default": "./src/server/fulfillment.ts"
-    },
-    "./guest": {
-      "types": "./dist/server/guest.d.ts",
-      "import": "./src/server/guest.ts",
-      "default": "./src/server/guest.ts"
-    },
-    "./home": {
-      "types": "./dist/server/home.d.ts",
-      "import": "./src/server/home.ts",
-      "default": "./src/server/home.ts"
-    },
-    "./locale-actions": {
-      "types": "./dist/server/locale-actions.d.ts",
-      "import": "./src/server/locale-actions.ts",
-      "default": "./src/server/locale-actions.ts"
-    },
-    "./locales": {
-      "types": "./dist/server/locales.d.ts",
-      "import": "./src/server/locales.ts",
-      "default": "./src/server/locales.ts"
-    },
-    "./notifications": {
-      "types": "./dist/server/notifications.d.ts",
-      "import": "./src/server/notifications.ts",
-      "default": "./src/server/notifications.ts"
-    },
-    "./onboarding": {
-      "types": "./dist/server/onboarding.d.ts",
-      "import": "./src/server/onboarding.ts",
-      "default": "./src/server/onboarding.ts"
-    },
-    "./orders": {
-      "types": "./dist/server/orders.d.ts",
-      "import": "./src/server/orders.ts",
-      "default": "./src/server/orders.ts"
-    },
-    "./payment": {
-      "types": "./dist/server/payment.d.ts",
-      "import": "./src/server/payment.ts",
-      "default": "./src/server/payment.ts"
-    },
-    "./payment-details": {
-      "types": "./dist/server/payment-details.d.ts",
-      "import": "./src/server/payment-details.ts",
-      "default": "./src/server/payment-details.ts"
-    },
-    "./pincode": {
-      "types": "./dist/server/pincode.d.ts",
-      "import": "./src/server/pincode.ts",
-      "default": "./src/server/pincode.ts"
-    },
-    "./products": {
-      "types": "./dist/server/products.d.ts",
-      "import": "./src/server/products.ts",
-      "default": "./src/server/products.ts"
-    },
-    "./regions": {
-      "types": "./dist/server/regions.d.ts",
-      "import": "./src/server/regions.ts",
-      "default": "./src/server/regions.ts"
-    },
-    "./returns": {
-      "types": "./dist/server/returns.d.ts",
-      "import": "./src/server/returns.ts",
-      "default": "./src/server/returns.ts"
-    },
-    "./swaps": {
-      "types": "./dist/server/swaps.d.ts",
-      "import": "./src/server/swaps.ts",
-      "default": "./src/server/swaps.ts"
-    },
-    "./variants": {
-      "types": "./dist/server/variants.d.ts",
-      "import": "./src/server/variants.ts",
-      "default": "./src/server/variants.ts"
-    },
-    "./wishlist": {
-      "types": "./dist/server/wishlist.d.ts",
-      "import": "./src/server/wishlist.ts",
-      "default": "./src/server/wishlist.ts"
+    "./home/sections/promoAnnouncements": {
+      "types": "./dist/server/home-sections/promo-announcements.d.ts",
+      "import": "./src/server/home-sections/promo-announcements.ts",
+      "default": "./src/server/home-sections/promo-announcements.ts"
+    },
+    "./home/sections/hero": {
+      "types": "./dist/server/home-sections/hero.d.ts",
+      "import": "./src/server/home-sections/hero.ts",
+      "default": "./src/server/home-sections/hero.ts"
+    },
+    "./home/sections/categoryPills": {
+      "types": "./dist/server/home-sections/category-pills.d.ts",
+      "import": "./src/server/home-sections/category-pills.ts",
+      "default": "./src/server/home-sections/category-pills.ts"
+    },
+    "./home/sections/newArrivals": {
+      "types": "./dist/server/home-sections/new-arrivals.d.ts",
+      "import": "./src/server/home-sections/new-arrivals.ts",
+      "default": "./src/server/home-sections/new-arrivals.ts"
+    },
+    "./home/sections/newArrivalsClassic": {
+      "types": "./dist/server/home-sections/new-arrivals-classic.d.ts",
+      "import": "./src/server/home-sections/new-arrivals-classic.ts",
+      "default": "./src/server/home-sections/new-arrivals-classic.ts"
+    },
+    "./home/sections/promoCountdown": {
+      "types": "./dist/server/home-sections/promo-countdown.d.ts",
+      "import": "./src/server/home-sections/promo-countdown.ts",
+      "default": "./src/server/home-sections/promo-countdown.ts"
+    },
+    "./home/sections/celebrityTrust": {
+      "types": "./dist/server/home-sections/celebrity-trust.d.ts",
+      "import": "./src/server/home-sections/celebrity-trust.ts",
+      "default": "./src/server/home-sections/celebrity-trust.ts"
+    },
+    "./home/sections/luxeFavourites": {
+      "types": "./dist/server/home-sections/luxe-favourites.d.ts",
+      "import": "./src/server/home-sections/luxe-favourites.ts",
+      "default": "./src/server/home-sections/luxe-favourites.ts"
+    },
+    "./home/sections/shopByCategory": {
+      "types": "./dist/server/home-sections/shop-by-category.d.ts",
+      "import": "./src/server/home-sections/shop-by-category.ts",
+      "default": "./src/server/home-sections/shop-by-category.ts"
+    },
+    "./home/sections/baptism": {
+      "types": "./dist/server/home-sections/baptism.d.ts",
+      "import": "./src/server/home-sections/baptism.ts",
+      "default": "./src/server/home-sections/baptism.ts"
+    },
+    "./home/sections/baptismPicks": {
+      "types": "./dist/server/home-sections/baptism-picks.d.ts",
+      "import": "./src/server/home-sections/baptism-picks.ts",
+      "default": "./src/server/home-sections/baptism-picks.ts"
+    },
+    "./home/sections/themeDresses": {
+      "types": "./dist/server/home-sections/theme-dresses.d.ts",
+      "import": "./src/server/home-sections/theme-dresses.ts",
+      "default": "./src/server/home-sections/theme-dresses.ts"
+    },
+    "./home/sections/brandMarquee": {
+      "types": "./dist/server/home-sections/brand-marquee.d.ts",
+      "import": "./src/server/home-sections/brand-marquee.ts",
+      "default": "./src/server/home-sections/brand-marquee.ts"
+    },
+    "./home/sections/aboutBrand": {
+      "types": "./dist/server/home-sections/about-brand.d.ts",
+      "import": "./src/server/home-sections/about-brand.ts",
+      "default": "./src/server/home-sections/about-brand.ts"
+    },
+    "./home/sections/testimonials": {
+      "types": "./dist/server/home-sections/testimonials.d.ts",
+      "import": "./src/server/home-sections/testimonials.ts",
+      "default": "./src/server/home-sections/testimonials.ts"
+    },
+    "./home/sections/brandPillars": {
+      "types": "./dist/server/home-sections/brand-pillars.d.ts",
+      "import": "./src/server/home-sections/brand-pillars.ts",
+      "default": "./src/server/home-sections/brand-pillars.ts"
+    },
+    "./home/sections/instagramPosts": {
+      "types": "./dist/server/home-sections/instagram-posts.d.ts",
+      "import": "./src/server/home-sections/instagram-posts.ts",
+      "default": "./src/server/home-sections/instagram-posts.ts"
+    },
+    "./home/sections/features": {
+      "types": "./dist/server/home-sections/features.d.ts",
+      "import": "./src/server/home-sections/features.ts",
+      "default": "./src/server/home-sections/features.ts"
+    },
+    "./home/sections/shopByAge": {
+      "types": "./dist/server/home-sections/shop-by-age.d.ts",
+      "import": "./src/server/home-sections/shop-by-age.ts",
+      "default": "./src/server/home-sections/shop-by-age.ts"
+    },
+    "./home/sections/whyChooseUs": {
+      "types": "./dist/server/home-sections/why-choose-us.d.ts",
+      "import": "./src/server/home-sections/why-choose-us.ts",
+      "default": "./src/server/home-sections/why-choose-us.ts"
+    },
+    "./home/sections/lovedByMoms": {
+      "types": "./dist/server/home-sections/loved-by-moms.d.ts",
+      "import": "./src/server/home-sections/loved-by-moms.ts",
+      "default": "./src/server/home-sections/loved-by-moms.ts"
+    },
+    "./home/sections/videoStories": {
+      "types": "./dist/server/home-sections/video-stories.d.ts",
+      "import": "./src/server/home-sections/video-stories.ts",
+      "default": "./src/server/home-sections/video-stories.ts"
+    },
+    "./home/sections/blogPosts": {
+      "types": "./dist/server/home-sections/blog-posts.d.ts",
+      "import": "./src/server/home-sections/blog-posts.ts",
+      "default": "./src/server/home-sections/blog-posts.ts"
     }
   },
   "main": "./dist/server/index.js",

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

@@ -0,0 +1,191 @@
+{
+  "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/src/server/brand-pillars-from-categories.ts

@@ -0,0 +1,156 @@
+import type { HttpTypes } from "@medusajs/types"
+import type { BrandPillarConfig } from "./dynamic-config"
+
+type CategoryMetadata = {
+  category_image?: string
+  category_description?: string
+  category_link?: string
+  image?: string
+  thumbnail?: string
+  description?: string
+}
+
+type CollectionMetadata = {
+  category_image?: string
+  image?: string
+  thumbnail?: string
+}
+
+function normalizeKey(value: string): string {
+  return value
+    .toLowerCase()
+    .trim()
+    .replace(/&/g, "and")
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-+|-+$/g, "")
+}
+
+function collectionImageForCategory(
+  collections: Array<Record<string, unknown>> | undefined,
+  category: HttpTypes.StoreProductCategory
+): string | null {
+  if (!collections?.length) return null
+
+  const handleKey = category.handle ? normalizeKey(category.handle) : ""
+  const nameKey = category.name ? normalizeKey(category.name) : ""
+
+  for (const entry of collections) {
+    const meta = (entry.metadata as CollectionMetadata | undefined) ?? {}
+    const image = meta.category_image || meta.image || meta.thumbnail
+    if (!image) continue
+
+    const cHandle = (entry.handle as string | undefined) ?? ""
+    const cTitle = (entry.title as string | undefined) ?? ""
+    if (
+      (handleKey && normalizeKey(cHandle) === handleKey) ||
+      (nameKey && normalizeKey(cTitle) === nameKey)
+    ) {
+      return image
+    }
+  }
+
+  return null
+}
+
+function imageFromCategory(
+  category: HttpTypes.StoreProductCategory
+): string | null {
+  const meta = (category.metadata as CategoryMetadata | undefined) ?? {}
+  return (
+    meta.category_image ||
+    meta.image ||
+    meta.thumbnail ||
+    (category as { thumbnail?: string }).thumbnail ||
+    null
+  )
+}
+
+function resolveCategoryImage(
+  category: HttpTypes.StoreProductCategory,
+  collections?: Array<Record<string, unknown>>
+): string | null {
+  const fromCategory = imageFromCategory(category)
+  if (fromCategory) return fromCategory
+
+  const parent = (
+    category as HttpTypes.StoreProductCategory & {
+      parent_category?: HttpTypes.StoreProductCategory
+    }
+  ).parent_category
+  if (parent) {
+    const fromParent = imageFromCategory(parent)
+    if (fromParent) return fromParent
+  }
+
+  return collectionImageForCategory(collections, category)
+}
+
+function categoryDescription(
+  category: HttpTypes.StoreProductCategory
+): string {
+  const meta = (category.metadata as CategoryMetadata | undefined) ?? {}
+  const native = (category as { description?: string | null }).description
+  return String(
+    native ?? meta.category_description ?? meta.description ?? ""
+  ).trim()
+}
+
+function categoryHref(category: HttpTypes.StoreProductCategory): string | undefined {
+  const meta = (category.metadata as CategoryMetadata | undefined) ?? {}
+  const custom = meta.category_link?.trim()
+  if (custom) return custom
+  if (category.handle) return `/categories/${category.handle}`
+  return undefined
+}
+
+function pickBrandPillarCategories(
+  categories: HttpTypes.StoreProductCategory[],
+  collections: Array<Record<string, unknown>> | undefined,
+  limit = 4
+): HttpTypes.StoreProductCategory[] {
+  const valid = (categories ?? []).filter((c) => c.name && c.handle)
+  const topLevel = valid.filter((c) => !c.parent_category_id)
+  const withImage = topLevel.filter((c) =>
+    Boolean(resolveCategoryImage(c, collections))
+  )
+
+  const pool = withImage.length >= 2 ? withImage : topLevel
+
+  return [...pool]
+    .sort(
+      (a, b) =>
+        Number(Boolean(resolveCategoryImage(b, collections))) -
+          Number(Boolean(resolveCategoryImage(a, collections))) ||
+        (a.name ?? "").localeCompare(b.name ?? "")
+    )
+    .slice(0, limit)
+}
+
+/** Brand pillar cards from top-level product categories (not CMS pillars array). */
+export function buildBrandPillarsFromCategories(
+  categories: HttpTypes.StoreProductCategory[],
+  collections: Array<Record<string, unknown>> | undefined,
+  sectionTitle: string
+): { sectionTitle: string; pillars: BrandPillarConfig[] } {
+  const pillars = pickBrandPillarCategories(categories, collections).flatMap(
+    (category) => {
+      const title = (category.name ?? "").trim()
+      const image = resolveCategoryImage(category, collections) ?? undefined
+      if (!title || !image) return []
+
+      const description = categoryDescription(category)
+      const href = categoryHref(category)
+
+      return [
+        {
+          title,
+          description,
+          image,
+          ...(href ? { href } : {}),
+        },
+      ]
+    }
+  )
+
+  return { sectionTitle, pillars }
+}