medusa-storefront-data 2.3.0 → 2.4.0

package/src/server/home-sections/theme-dresses.ts

@@ -0,0 +1,49 @@
+import "server-only"
+
+import { HttpTypes } from "@medusajs/types"
+import { fetchRatings } from "medusa-reviews-logic/server"
+import { getHomeSectionsCopyFromPageInput } from "../dynamic-config"
+import { listCategories } from "../categories"
+import { getProductsByTag } from "../products"
+import {
+  categoryIdsMatching,
+  productsForCategoryIds,
+  requireRegion,
+  type SectionLoaderOptions,
+} from "./shared"
+
+export type ThemeDressesSectionData = {
+  region: NonNullable<Awaited<ReturnType<typeof requireRegion>>>
+  themeProducts: HttpTypes.StoreProduct[]
+  ratings: unknown[]
+  copy: ReturnType<typeof getHomeSectionsCopyFromPageInput>["themeDresses"]
+}
+
+export async function loadThemeDressesSectionData(
+  countryCode: string,
+  options?: SectionLoaderOptions
+): Promise<ThemeDressesSectionData | null> {
+  const region = await requireRegion(countryCode)
+  if (!region) return null
+  const pageInput = options?.pageInput ?? null
+  const [themeByTag, categoriesResult, ratings] = await Promise.all([
+    getProductsByTag({ tagValue: "theme", limit: 8, countryCode }).catch(() => []),
+    listCategories({ limit: 100 }).catch(() => []),
+    fetchRatings(),
+  ])
+  const categories = (categoriesResult ?? []) as HttpTypes.StoreProductCategory[]
+  const themeProducts =
+    themeByTag.length > 0
+      ? themeByTag
+      : await productsForCategoryIds(
+          countryCode,
+          categoryIdsMatching(categories, /theme/),
+          8
+        )
+  return {
+    region,
+    themeProducts,
+    ratings: ratings ?? [],
+    copy: getHomeSectionsCopyFromPageInput(pageInput).themeDresses,
+  }
+}

package/src/server/home-sections/video-stories.ts

@@ -0,0 +1,23 @@
+import "server-only"
+
+import {
+  getHomeSectionsCopyFromPageInput,
+  getVideoStoriesFromPageInput,
+} from "../dynamic-config"
+import type { SectionLoaderOptions } from "./shared"
+
+export type VideoStoriesSectionData = {
+  videoStories: ReturnType<typeof getVideoStoriesFromPageInput>
+  copy: ReturnType<typeof getHomeSectionsCopyFromPageInput>["videoStories"]
+}
+
+export async function loadVideoStoriesSectionData(
+  _countryCode: string,
+  options?: SectionLoaderOptions
+): Promise<VideoStoriesSectionData> {
+  const pageInput = options?.pageInput ?? null
+  return {
+    videoStories: getVideoStoriesFromPageInput(pageInput),
+    copy: getHomeSectionsCopyFromPageInput(pageInput).videoStories,
+  }
+}

package/src/server/home-sections/why-choose-us.ts

@@ -0,0 +1,23 @@
+import "server-only"
+
+import {
+  getFeaturesFromPageInput,
+  getHomeSectionsCopyFromPageInput,
+} from "../dynamic-config"
+import type { SectionLoaderOptions } from "./shared"
+
+export type WhyChooseUsSectionData = {
+  whyChooseUsFeatures: ReturnType<typeof getFeaturesFromPageInput>
+  copy: ReturnType<typeof getHomeSectionsCopyFromPageInput>["whyChooseUs"]
+}
+
+export async function loadWhyChooseUsSectionData(
+  _countryCode: string,
+  options?: SectionLoaderOptions
+): Promise<WhyChooseUsSectionData> {
+  const pageInput = options?.pageInput ?? null
+  return {
+    whyChooseUsFeatures: getFeaturesFromPageInput(pageInput),
+    copy: getHomeSectionsCopyFromPageInput(pageInput).whyChooseUs,
+  }
+}

package/src/server/home.ts

@@ -1,27 +1,26 @@
-"use server";
+import "server-only";
 
 import { HttpTypes } from "@medusajs/types";
 import { listCollections } from "./collections";
 import { listCategories } from "./categories";
 import { listProductsWithSort, getProductsByTag, listProducts } from "./products";
 import { getRegion } from "./regions";
-import {
-  getTestimonialsFromConfig,
-  getVideoStoriesFromConfig,
-  getAnnouncementMessagesFromConfig,
-  getAboutBrandFromConfig,
-  getBrandPillarsFromConfig,
-  getBlogPostsFromConfig,
-  getPromoCountdownFromConfig,
-  getHomeSectionsCopyFromConfig,
-  getTrustFeaturesFromConfig,
-  type AboutBrandConfig,
-  type BrandPillarConfig,
-  type BlogPostConfig,
-  type HomeSectionsCopy,
-  type TrustFeaturesConfig,
+import type { HomepageConfig } from "./homepage-config.types";
+import type {
+  InstagramPostsData,
+  AboutBrandConfig,
+  BrandPillarConfig,
+  BlogPostConfig,
+  HomeSectionsCopy,
+  TrustFeaturesConfig,
+  HomepageBanner,
 } from "./dynamic-config";
 import { fetchRatings } from "medusa-reviews-logic/server";
+import {
+  getBaptismPicksLooks,
+  type ShoppableLook,
+} from "./shoppable-looks";
+import { resolveHomeSegmentConfigData } from "./resolve-home-segment-data";
 
 async function productsForCategoryIds(
   countryCode: string,
@@ -68,24 +67,45 @@ export type HomePageData = {
     message: string | null;
     endAt: string | null;
     active: boolean;
+    ctaLabel: string | null;
+    ctaHref: string | null;
   };
   luxeFavourites: HttpTypes.StoreProduct[];
   celebrityProduct: HttpTypes.StoreProduct | null;
   baptismGirl: HttpTypes.StoreProduct[];
   baptismBoy: HttpTypes.StoreProduct[];
-  baptismPicks: HttpTypes.StoreProduct[];
+  baptismPicks: ShoppableLook[];
   themeProducts: HttpTypes.StoreProduct[];
   aboutBrand: AboutBrandConfig;
   brandPillars: { sectionTitle: string; pillars: BrandPillarConfig[] };
   blogPosts: BlogPostConfig[];
+  instagramPosts: InstagramPostsData;
   sectionsCopy: HomeSectionsCopy;
   trustFeatures: TrustFeaturesConfig;
+  homeBanners: HomepageBanner[] | null;
+  appBanners: HomepageBanner[] | null;
+  whyChooseUsFeatures: {
+    title: string;
+    features: Array<{ name: string; icon: string }>;
+  };
+};
+
+export type LoadHomePageDataOptions = {
+  /** Merged `homepage-config` from main project (fetched via dynamic-config API there). */
+  pageInput?: HomepageConfig | null;
 };
 
 /**
- * Parallel home page data loader for full storefront homepage sections.
+ * Parallel home page data loader. Catalog APIs run here; segment copy comes from
+ * `pageInput` (or package JSON defaults) — no dynamic-config fetch in this package.
  */
-export async function loadHomePageData(countryCode: string): Promise<HomePageData | null> {
+export async function loadHomePageData(
+  countryCode: string,
+  options?: LoadHomePageDataOptions
+): Promise<HomePageData | null> {
+  const pageInput = options?.pageInput ?? null;
+  const segmentConfig = resolveHomeSegmentConfigData(pageInput);
+
   const region = await getRegion(countryCode);
   if (!region) return null;
 
@@ -94,23 +114,18 @@ export async function loadHomePageData(countryCode: string): Promise<HomePageDat
     categoriesResult,
     newArrivalsResult,
     bestsellersResult,
-    testimonialsData,
     allRatings,
-    videoStoriesData,
-    announcementMessages,
-    promoCountdown,
-    aboutBrand,
-    brandPillars,
-    blogPosts,
     themeByTag,
     baptismByTag,
-    sectionsCopy,
-    trustFeatures,
   ] = await Promise.all([
     listCollections({ fields: "id, handle, title, metadata" }).catch(() => ({
       collections: [],
     })),
-    listCategories({ limit: 100 }).catch(() => []),
+    listCategories({
+      limit: 100,
+      fields:
+        "id,handle,name,metadata,parent_category_id,*parent_category,*parent_category.parent_category",
+    }).catch(() => []),
     listProductsWithSort({
       page: 1,
       queryParams: { limit: 12 },
@@ -122,24 +137,9 @@ export async function loadHomePageData(countryCode: string): Promise<HomePageDat
       limit: 10,
       countryCode,
     }).catch(() => []),
-    getTestimonialsFromConfig().catch(() => ({
-      title: "",
-      testimonials: [],
-    })),
     fetchRatings(),
-    getVideoStoriesFromConfig().catch(() => ({
-      title: "",
-      videoUrls: [],
-    })),
-    getAnnouncementMessagesFromConfig(),
-    getPromoCountdownFromConfig(),
-    getAboutBrandFromConfig(),
-    getBrandPillarsFromConfig(),
-    getBlogPostsFromConfig(),
     getProductsByTag({ tagValue: "theme", limit: 8, countryCode }).catch(() => []),
     getProductsByTag({ tagValue: "baptism", limit: 12, countryCode }).catch(() => []),
-    getHomeSectionsCopyFromConfig(),
-    getTrustFeaturesFromConfig(),
   ]);
 
   const categories = (categoriesResult ?? []) as HttpTypes.StoreProductCategory[];
@@ -185,27 +185,41 @@ export async function loadHomePageData(countryCode: string): Promise<HomePageDat
           8
         );
 
+  const baptismPicksFallback = (baptismByTag.length ? baptismByTag : baptismFallback).slice(
+    0,
+    8
+  );
+  const baptismPicks = await getBaptismPicksLooks(
+    countryCode,
+    baptismPicksFallback,
+    pageInput
+  );
+
   return {
     region,
     collections: collections as Array<Record<string, unknown>>,
     categories,
     newArrivals,
     bestsellers,
-    testimonials: testimonialsData,
+    testimonials: segmentConfig.testimonials,
     ratings: allRatings ?? [],
-    videoStories: videoStoriesData,
-    announcementMessages,
-    promoCountdown,
+    videoStories: segmentConfig.videoStories,
+    announcementMessages: segmentConfig.announcementMessages,
+    promoCountdown: segmentConfig.promoCountdown,
     luxeFavourites: bestsellers.slice(0, 4),
     celebrityProduct: bestsellers[0] ?? newArrivals[0] ?? null,
     baptismGirl: resolvedBaptismGirl,
     baptismBoy: resolvedBaptismBoy,
-    baptismPicks: (baptismByTag.length ? baptismByTag : baptismFallback).slice(0, 5),
+    baptismPicks,
     themeProducts,
-    aboutBrand,
-    brandPillars,
-    blogPosts,
-    sectionsCopy,
-    trustFeatures,
+    aboutBrand: segmentConfig.aboutBrand,
+    brandPillars: segmentConfig.brandPillars,
+    blogPosts: segmentConfig.blogPosts,
+    instagramPosts: segmentConfig.instagramPosts,
+    sectionsCopy: segmentConfig.sectionsCopy,
+    trustFeatures: segmentConfig.trustFeatures,
+    homeBanners: segmentConfig.homeBanners,
+    appBanners: segmentConfig.appBanners,
+    whyChooseUsFeatures: segmentConfig.whyChooseUsFeatures,
   };
 }

package/src/server/homepage-config.types.ts

@@ -0,0 +1,335 @@
+/**
+ * Medusa `GET /store/dynamic-config` → `homepage-config` shape.
+ * Used by the storefront and as the reference for backend admin JSON.
+ *
+ * Section keys: camelCase (preferred) or kebab-case (`new-arrivals` → `newArrivals`).
+ * Only fields you set override package defaults in `homepage-section-defaults.ts`.
+ */
+
+/** Shared copy fields merged into every section block. */
+export type HomepageSectionCopyFields = {
+  title?: string
+  name?: string
+  subtitle?: string
+  text?: string
+  description?: string
+  eyebrow?: string
+  /** Layout variant, e.g. new arrivals: `grid` | `classic` */
+  variant?: string
+  layout?: string
+}
+
+export type HomepagePromoAnnouncementsSection = HomepageSectionCopyFields & {
+  messages?: string[]
+  items?: Array<string | { message?: string; text?: string }>
+  "announcement-messages"?: string[]
+}
+
+export type HomepagePromoCountdownSection = HomepageSectionCopyFields & {
+  code?: string
+  "coupon-code"?: string
+  text?: string
+  message?: string
+  "promo-text"?: string
+  "end-at"?: string
+  endAt?: string
+  active?: boolean
+  "promo-active"?: boolean
+  "cta-label"?: string
+  "cta-href"?: string
+}
+
+export type HomepageNewArrivalsSection = HomepageSectionCopyFields & {
+  /** `grid` (ProductCardView) or `classic` (ProductPreview + pink background) */
+  variant?: "grid" | "classic" | "legacy" | "preview"
+}
+
+export type HomepageTestimonialItem = {
+  text?: string
+  name?: string
+  rating?: number
+  avatar?: string
+  id?: string
+  testimonial?: HomepageTestimonialItem
+  review?: HomepageTestimonialItem
+}
+
+export type HomepageTestimonialsSection = HomepageSectionCopyFields & {
+  items?: HomepageTestimonialItem[]
+  testimonials?: HomepageTestimonialItem[]
+  reviews?: HomepageTestimonialItem[]
+}
+
+export type HomepageRatingItem = HomepageTestimonialItem
+
+export type HomepageShoppableLook = {
+  image?: string
+  "look-image"?: string
+  "product-ids"?: string[]
+  productIds?: string[]
+  "product-handles"?: string[]
+  productHandles?: string[]
+  look?: HomepageShoppableLook
+}
+
+export type HomepageBaptismPicksSection = HomepageSectionCopyFields & {
+  looks?: HomepageShoppableLook[]
+  "shop-looks"?: HomepageShoppableLook[]
+}
+
+export type HomepageAboutBrandStat = {
+  label?: string
+  name?: string
+  value?: string
+}
+
+export type HomepageAboutBrandSection = HomepageSectionCopyFields & {
+  readMoreHref?: string
+  "read-more-link"?: string
+  stats?: HomepageAboutBrandStat[]
+  "about-stats"?: HomepageAboutBrandStat[]
+}
+
+export type HomepageBrandPillar = {
+  title?: string
+  name?: string
+  description?: string
+  text?: string
+  image?: string
+  icon?: string
+  pillar?: HomepageBrandPillar
+}
+
+export type HomepageBrandPillarsSection = HomepageSectionCopyFields & {
+  pillars?: HomepageBrandPillar[]
+  "brand-pillars"?: HomepageBrandPillar[]
+}
+
+export type HomepageFeatureItem = {
+  name?: string
+  icon?: string
+  "feature-name"?: string
+  "feature-icon"?: string
+  feature?: HomepageFeatureItem
+}
+
+export type HomepageFeaturesSection = HomepageSectionCopyFields & {
+  features?: HomepageFeatureItem[]
+  items?: HomepageFeatureItem[]
+}
+
+export type HomepageBlogPost = {
+  title?: string
+  href?: string
+  link?: string
+  url?: string
+  excerpt?: string
+  description?: string
+  category?: string
+  tag?: string
+  date?: string
+  image?: string
+  thumbnail?: string
+  blog?: HomepageBlogPost
+}
+
+export type HomepageBlogPostsSection = HomepageSectionCopyFields & {
+  posts?: HomepageBlogPost[]
+  "blog-posts"?: HomepageBlogPost[]
+}
+
+export type HomepageInstagramPost = {
+  id?: string
+  image?: string
+  "post-image"?: string
+  url?: string
+  link?: string
+  post?: HomepageInstagramPost
+  instagram?: HomepageInstagramPost
+}
+
+export type HomepageInstagramPostsSection = HomepageSectionCopyFields & {
+  handle?: string
+  username?: string
+  "instagram-handle"?: string
+  "profile-url"?: string
+  profileUrl?: string
+  "profile-image"?: string
+  profileImage?: string
+  posts?: HomepageInstagramPost[]
+  items?: HomepageInstagramPost[]
+}
+
+export type HomepageVideoStoryEntry =
+  | string
+  | {
+      "video-url"?: string
+      video_url?: string
+      url?: string
+      src?: string
+      video?: string
+      "video-story"?: Record<string, unknown>
+    }
+
+export type HomepageVideoStoriesSection = HomepageSectionCopyFields & {
+  "video-urls"?: HomepageVideoStoryEntry[]
+  videoUrls?: HomepageVideoStoryEntry[]
+  videos?: HomepageVideoStoryEntry[]
+  "video-stories"?: HomepageVideoStoryEntry[]
+}
+
+/** Per-section blocks under `homepage-config.sections`. */
+export type HomepageSectionsConfig = {
+  promoAnnouncements?: HomepagePromoAnnouncementsSection
+  hero?: HomepageSectionCopyFields
+  categoryPills?: HomepageSectionCopyFields
+  newArrivals?: HomepageNewArrivalsSection
+  newArrivalsClassic?: HomepageNewArrivalsSection
+  promoCountdown?: HomepagePromoCountdownSection
+  celebrityTrust?: HomepageSectionCopyFields
+  luxeFavourites?: HomepageSectionCopyFields
+  shopByCategory?: HomepageSectionCopyFields
+  baptism?: HomepageSectionCopyFields
+  baptismPicks?: HomepageBaptismPicksSection
+  themeDresses?: HomepageSectionCopyFields
+  brandMarquee?: HomepageSectionCopyFields
+  aboutBrand?: HomepageAboutBrandSection
+  testimonials?: HomepageTestimonialsSection
+  brandPillars?: HomepageBrandPillarsSection
+  instagramPosts?: HomepageInstagramPostsSection
+  features?: HomepageFeaturesSection
+  shopByAge?: HomepageSectionCopyFields
+  whyChooseUs?: HomepageFeaturesSection
+  lovedByMoms?: HomepageSectionCopyFields
+  videoStories?: HomepageVideoStoriesSection
+  blogPosts?: HomepageBlogPostsSection
+  /** Allow kebab-case keys from legacy CMS */
+  [sectionKey: string]: HomepageSectionCopyFields | undefined
+}
+
+export type HomepageBanner = {
+  "homepage-banner-image"?: string
+  "homepage-banner-title"?: string
+  "homepage-banner-subtitle"?: string
+  "homepage-banner-description"?: string
+  "homepage-banner-button-name"?: string
+  "homepage-banner-button-link"?: string
+}
+
+export type HomepageBannerEntry = {
+  "homepage-banner"?: HomepageBanner
+}
+
+export type HomepageAppBanner = {
+  "app-banner-image"?: string
+  "app-banner-title"?: string
+  "app-banner-subtitle"?: string
+  "app-banner-description"?: string
+  "app-banner-button-name"?: string
+  "app-banner-button-link"?: string
+  "app-banner-link"?: string
+}
+
+export type HomepageAppBannerEntry = {
+  "app-banner"?: HomepageAppBanner
+}
+
+export type HomepageContactConfig = {
+  "contact-phone"?: string
+  "contact-email"?: string
+  "contact-address"?: string
+}
+
+export type HomepageSocialLink = {
+  "social-platform-name"?: string
+  "social-platform-icon"?: string
+  "social-platform-url"?: string
+  "social-link"?: HomepageSocialLink
+}
+
+export type HomepagePromoBarConfig = {
+  "promo-text"?: string
+  "promo-code"?: string
+  "promo-value"?: string
+  "promo-active"?: boolean
+}
+
+export type HomepageFaqEntry = {
+  "faq-category"?: string
+  "faq-question"?: string
+  "faq-answer"?: string
+  faq?: HomepageFaqEntry
+}
+
+/**
+ * Root `homepage-config` object stored in Medusa dynamic config.
+ */
+export type HomepageConfig = {
+  logo?: string
+  "website-description"?: string
+  website_description?: string
+
+  /** Hero carousel — used by `hero` section (not `sections.hero`). */
+  "homepage-banner-array"?: HomepageBannerEntry[]
+
+  "app-banner-array"?: HomepageAppBannerEntry[]
+
+  /** Option 1 — central section copy + structured data (preferred). */
+  sections?: HomepageSectionsConfig
+
+  /**
+   * Product reviews for testimonials carousel.
+   * Fallback when `sections.testimonials.items` is empty.
+   */
+  ratings?: HomepageRatingItem[]
+
+  /** Legacy top-level keys (still read; prefer `sections.*`). */
+  "promo-bar"?: HomepagePromoBarConfig
+  "contact-us"?: HomepageContactConfig
+  "social-links"?: HomepageSocialLink[]
+  "faq-array"?: HomepageFaqEntry[]
+  "why-choose-us-title"?: string
+  "why-choose-us-features"?: HomepageFeatureItem[]
+  "about-brand"?: HomepageAboutBrandSection
+  "who-we-are"?: HomepageAboutBrandSection
+  "video-stories"?: HomepageVideoStoryEntry[]
+  "video-stories-array"?: HomepageVideoStoryEntry[]
+  video_stories?: HomepageVideoStoryEntry[]
+  "announcement-messages"?: string[]
+  "announcement-bar"?: string[]
+}
+
+/** Full dynamic config API response. */
+export type DynamicConfigResponse = {
+  "homepage-config"?: HomepageConfig
+  [key: string]: unknown
+}
+
+/** All section ids with package defaults. */
+export const HOMEPAGE_SECTION_IDS = [
+  "promoAnnouncements",
+  "hero",
+  "categoryPills",
+  "newArrivals",
+  "newArrivalsClassic",
+  "promoCountdown",
+  "celebrityTrust",
+  "luxeFavourites",
+  "shopByCategory",
+  "baptism",
+  "baptismPicks",
+  "themeDresses",
+  "brandMarquee",
+  "aboutBrand",
+  "testimonials",
+  "brandPillars",
+  "instagramPosts",
+  "features",
+  "shopByAge",
+  "whyChooseUs",
+  "lovedByMoms",
+  "videoStories",
+  "blogPosts",
+] as const
+
+export type HomepageSectionId = (typeof HOMEPAGE_SECTION_IDS)[number]

package/src/server/homepage-section-defaults.ts

@@ -16,11 +16,20 @@ export const DEFAULT_HOMEPAGE_SECTIONS = {
   newArrivals: {
     title: "New Arrivals",
     subtitle: "Fresh styles just landed",
+    variant: "grid",
+  },
+  newArrivalsClassic: {
+    title: "New Arrivals",
+    subtitle: "Fresh styles just landed",
+    variant: "classic",
   },
   promoCountdown: {
-    text: "Limited-time offer — shop your favourites before they're gone!",
-    code: "SAVE20",
+    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",
@@ -38,6 +47,7 @@ export const DEFAULT_HOMEPAGE_SECTIONS = {
   },
   baptismPicks: {
     title: "Baptism Picks",
+    looks: [],
   },
   themeDresses: {
     title: "Theme",
@@ -62,6 +72,35 @@ export const DEFAULT_HOMEPAGE_SECTIONS = {
   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. You can even get many aesthetic pics just from the shop because the interior of the shop is amazing too.. the dresses are customizable according to themes that you prefer. My little girl looked like a princess in her pink and white dress which I found within minutes entering the shop.",
+        name: "Greeshma thottippal shanmughan",
+      },
+      {
+        text: "I frequently buy dresses for my baby from this store and I am extremely satisfied with the purchase. The quality of the dresses was excellent, and it was perfect for special occasions like birthdays and celebrations.",
+        name: "Priyanka Rajesh",
+      },
+      {
+        text: "I recently bought an Onam outfit from this boutique and I'm so glad I did! The quality is excellent, and the design is beautiful. My daughter looked absolutely stunning in it.",
+        name: "Riya Rilju",
+      },
+      {
+        text: "I'm beyond happy with the beautiful baptism dress they made for my baby! The craftsmanship, attention to detail, and love put into every stitch truly show.",
+        name: "Chinju anthony",
+      },
+      {
+        text: "This is my third baby dress purchase from this store, and I'm still as impressed as ever! The dresses are absolutely adorable, and the sizing is perfect for my little one.",
+        name: "Susmitha",
+      },
+    ],
+  },
+  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",