medusa-storefront-data 2.1.0 → 2.4.0

package/homepage-config.example.json

@@ -0,0 +1,209 @@
+{
+  "_comment": "Paste under dynamic-config value as homepage-config. Omitted fields use medusa-storefront-data package defaults.",
+  "homepage-config": {
+    "logo": "/Logo.png",
+    "website-description": "Premium kids fashion for everyday wear and special occasions.",
+
+    "homepage-banner-array": [
+      {
+        "homepage-banner": {
+          "homepage-banner-image": "/banners/hero-1.jpg",
+          "homepage-banner-title": "New Collection",
+          "homepage-banner-subtitle": "Shop the latest styles",
+          "homepage-banner-description": "Discover outfits for every celebration.",
+          "homepage-banner-button-name": "Shop Now",
+          "homepage-banner-button-link": "/store"
+        }
+      }
+    ],
+
+    "promo-bar": {
+      "promo-text": "Free shipping on orders over $99",
+      "promo-code": "FREESHIP",
+      "promo-active": false
+    },
+
+    "contact-us": {
+      "contact-phone": "+1 000 000 0000",
+      "contact-email": "hello@yourstore.com",
+      "contact-address": "Your store address"
+    },
+
+    "social-links": [
+      {
+        "social-link": {
+          "social-platform-name": "Instagram",
+          "social-platform-icon": "/icons/instagram.svg",
+          "social-platform-url": "https://www.instagram.com/yourbrand/"
+        }
+      }
+    ],
+
+    "ratings": [
+      {
+        "text": "Beautiful quality and fast delivery.",
+        "name": "Happy Customer",
+        "rating": 5
+      }
+    ],
+
+    "sections": {
+      "promoAnnouncements": {
+        "messages": [
+          "Free shipping on orders over a threshold",
+          "Worldwide shipping available"
+        ]
+      },
+
+      "newArrivals": {
+        "title": "New Arrivals",
+        "subtitle": "Fresh styles just landed",
+        "variant": "grid"
+      },
+
+      "newArrivalsClassic": {
+        "title": "New Arrivals",
+        "subtitle": "Classic product preview layout",
+        "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": true,
+        "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": [
+          {
+            "image": "https://your-cdn.com/looks/baptism-1.jpg",
+            "product-ids": ["prod_REPLACE_ME_1", "prod_REPLACE_ME_2"]
+          },
+          {
+            "image": "https://your-cdn.com/looks/baptism-2.jpg",
+            "product-handles": ["off-white-baptism-gown"]
+          }
+        ]
+      },
+
+      "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.",
+        "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": "Your review text here.",
+            "name": "Customer Name",
+            "rating": 5
+          }
+        ]
+      },
+
+      "brandPillars": {
+        "title": "Why families choose us",
+        "pillars": [
+          {
+            "title": "Your favorite kids destination",
+            "description": "Trendy, high-quality outfits for little ones.",
+            "image": "/features/store.jpg"
+          }
+        ]
+      },
+
+      "instagramPosts": {
+        "title": "Follow Us on Instagram",
+        "handle": "yourbrand",
+        "profile-url": "https://www.instagram.com/yourbrand/",
+        "profile-image": "/Logo.png",
+        "posts": [
+          {
+            "image": "https://your-cdn.com/instagram/post-1.jpg",
+            "url": "https://www.instagram.com/p/EXAMPLE/"
+          }
+        ]
+      },
+
+      "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" }
+        ]
+      },
+
+      "videoStories": {
+        "title": "Watch Stories & Reviews",
+        "video-urls": [
+          "https://your-cdn.com/videos/story-1.mp4",
+          {
+            "video-story": {
+              "video-url": "https://your-cdn.com/videos/story-2.mp4"
+            }
+          }
+        ]
+      },
+
+      "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/homepage-sections.example.json

@@ -0,0 +1,55 @@
+{
+  "_comment": "Minimal sections override. Full backend template: homepage-config.example.json. Docs: HOMEPAGE_CONFIG.md",
+  "homepage-config": {
+    "sections": {
+      "newArrivals": {
+        "title": "New Arrivals",
+        "subtitle": "Your custom subtitle from CMS",
+        "variant": "grid"
+      },
+      "newArrivalsClassic": {
+        "title": "New Arrivals",
+        "subtitle": "Classic ProductPreview layout",
+        "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": true,
+        "cta-label": "Shop Offers",
+        "cta-href": "/store"
+      },
+      "promoAnnouncements": {
+        "messages": [
+          "Custom announcement line 1",
+          "Custom announcement line 2"
+        ]
+      },
+      "testimonials": {
+        "title": "What Clients Talk About Us",
+        "description": "The Trust We've Earned",
+        "items": [
+          {
+            "text": "Your review text here.",
+            "name": "Customer Name"
+          }
+        ]
+      },
+      "baptismPicks": {
+        "title": "Baptism Picks",
+        "looks": [
+          {
+            "image": "https://your-cdn.com/looks/baptism-1.jpg",
+            "product-ids": ["prod_REPLACE_ME_1", "prod_REPLACE_ME_2"]
+          },
+          {
+            "image": "https://your-cdn.com/looks/baptism-2.jpg",
+            "product-handles": ["off-white-baptism-gown"]
+          }
+        ]
+      }
+    },
+    "ratings": []
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "medusa-storefront-data",
-  "version": "2.1.0",
+  "version": "2.4.0",
   "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",
@@ -203,6 +207,121 @@
       "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/config-merge.ts

@@ -0,0 +1,31 @@
+/** Merge CMS section block onto package defaults (override wins when set). */
+export function mergeSectionBlock(
+  defaults: Record<string, unknown>,
+  override: Record<string, unknown> | null
+): Record<string, unknown> {
+  if (!override) return { ...defaults }
+  const merged = { ...defaults }
+  for (const [key, value] of Object.entries(override)) {
+    if (value === undefined || value === null) continue
+    if (Array.isArray(value)) {
+      if (value.length > 0) merged[key] = value
+      continue
+    }
+    if (typeof value === "string") {
+      if (value.trim()) merged[key] = value.trim()
+      continue
+    }
+    if (typeof value === "boolean" || typeof value === "number") {
+      merged[key] = value
+      continue
+    }
+    if (typeof value === "object") {
+      const base =
+        merged[key] && typeof merged[key] === "object" && !Array.isArray(merged[key])
+          ? (merged[key] as Record<string, unknown>)
+          : {}
+      merged[key] = mergeSectionBlock(base, value as Record<string, unknown>)
+    }
+  }
+  return merged
+}