medusa-storefront-data 2.3.0 → 2.5.1

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,211 +1,50 @@
-"use server";
-
-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,
-} from "./dynamic-config";
-import { fetchRatings } from "medusa-reviews-logic/server";
-
-async function productsForCategoryIds(
-  countryCode: string,
-  categoryIds: string[],
-  limit: number
-): Promise<HttpTypes.StoreProduct[]> {
-  if (!categoryIds.length) return [];
-  try {
-    const { response } = await listProducts({
-      countryCode,
-      queryParams: {
-        category_id: categoryIds,
-        limit,
-      } as HttpTypes.FindParams & HttpTypes.StoreProductListParams,
-    });
-    return response.products ?? [];
-  } catch {
-    return [];
-  }
-}
-
-function categoryIdsMatching(
-  categories: HttpTypes.StoreProductCategory[],
-  pattern: RegExp
-): string[] {
-  return categories
-    .filter((c) => pattern.test((c.name || c.handle || "").toLowerCase()))
-    .map((c) => c.id)
-    .filter(Boolean) as string[];
-}
-
+import type { HttpTypes } from "@medusajs/types"
+import type {
+  InstagramPostsData,
+  AboutBrandConfig,
+  BrandPillarConfig,
+  BlogPostConfig,
+  HomeSectionsCopy,
+  TrustFeaturesConfig,
+  HomepageBanner,
+} from "./dynamic-config"
+import type { ShoppableLook } from "./shoppable-looks"
+
+/** Shape returned by the legacy `loadHomePageData` loader (removed — use per-section loaders). */
 export type HomePageData = {
-  region: Awaited<ReturnType<typeof getRegion>>;
-  collections: Array<Record<string, unknown>>;
-  categories: HttpTypes.StoreProductCategory[];
-  newArrivals: HttpTypes.StoreProduct[];
-  bestsellers: HttpTypes.StoreProduct[];
-  testimonials: unknown | null;
-  ratings: unknown[];
-  videoStories: { title: string; videoUrls: string[] } | null;
-  announcementMessages: string[];
+  region: HttpTypes.StoreRegion | null
+  collections: Array<Record<string, unknown>>
+  categories: HttpTypes.StoreProductCategory[]
+  newArrivals: HttpTypes.StoreProduct[]
+  bestsellers: HttpTypes.StoreProduct[]
+  testimonials: unknown | null
+  ratings: unknown[]
+  videoStories: { title: string; videoUrls: string[] } | null
+  announcementMessages: string[]
   promoCountdown: {
-    code: string | null;
-    message: string | null;
-    endAt: string | null;
-    active: boolean;
-  };
-  luxeFavourites: HttpTypes.StoreProduct[];
-  celebrityProduct: HttpTypes.StoreProduct | null;
-  baptismGirl: HttpTypes.StoreProduct[];
-  baptismBoy: HttpTypes.StoreProduct[];
-  baptismPicks: HttpTypes.StoreProduct[];
-  themeProducts: HttpTypes.StoreProduct[];
-  aboutBrand: AboutBrandConfig;
-  brandPillars: { sectionTitle: string; pillars: BrandPillarConfig[] };
-  blogPosts: BlogPostConfig[];
-  sectionsCopy: HomeSectionsCopy;
-  trustFeatures: TrustFeaturesConfig;
-};
-
-/**
- * Parallel home page data loader for full storefront homepage sections.
- */
-export async function loadHomePageData(countryCode: string): Promise<HomePageData | null> {
-  const region = await getRegion(countryCode);
-  if (!region) return null;
-
-  const [
-    collectionsResult,
-    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(() => []),
-    listProductsWithSort({
-      page: 1,
-      queryParams: { limit: 12 },
-      sortBy: "created_at",
-      countryCode,
-    }).catch(() => ({ response: { products: [] } })),
-    getProductsByTag({
-      tagValue: "bestseller",
-      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[];
-  const collections =
-    (collectionsResult as { collections?: unknown[] }).collections ?? [];
-  const newArrivals =
-    (newArrivalsResult as { response?: { products?: HttpTypes.StoreProduct[] } })
-      .response?.products ?? [];
-  const bestsellers = (bestsellersResult ?? []) as HttpTypes.StoreProduct[];
-
-  const girlIds = categoryIdsMatching(categories, /baptism.*girl|girl.*baptism|^girl$/);
-  const boyIds = categoryIdsMatching(categories, /baptism.*boy|boy.*baptism|^boy$/);
-  const baptismIds = categoryIdsMatching(categories, /baptism/);
-
-  const [baptismGirl, baptismBoy] = await Promise.all([
-    girlIds.length
-      ? productsForCategoryIds(countryCode, girlIds, 8)
-      : baptismByTag.filter((p) => /girl/i.test(p.title || "")).slice(0, 8),
-    boyIds.length
-      ? productsForCategoryIds(countryCode, boyIds, 8)
-      : baptismByTag.filter((p) => /boy/i.test(p.title || "")).slice(0, 8),
-  ]);
-
-  let baptismFallback: HttpTypes.StoreProduct[] = [];
-  if (baptismGirl.length === 0 && baptismBoy.length === 0) {
-    baptismFallback =
-      baptismIds.length > 0
-        ? await productsForCategoryIds(countryCode, baptismIds, 12)
-        : baptismByTag;
+    code: string | null
+    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: 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 }>
   }
-
-  const resolvedBaptismGirl =
-    baptismGirl.length > 0 ? baptismGirl : baptismFallback.slice(0, 8);
-  const resolvedBaptismBoy =
-    baptismBoy.length > 0 ? baptismBoy : baptismFallback.slice(0, 8);
-
-  const themeProducts =
-    themeByTag.length > 0
-      ? themeByTag
-      : await productsForCategoryIds(
-          countryCode,
-          categoryIdsMatching(categories, /theme/),
-          8
-        );
-
-  return {
-    region,
-    collections: collections as Array<Record<string, unknown>>,
-    categories,
-    newArrivals,
-    bestsellers,
-    testimonials: testimonialsData,
-    ratings: allRatings ?? [],
-    videoStories: videoStoriesData,
-    announcementMessages,
-    promoCountdown,
-    luxeFavourites: bestsellers.slice(0, 4),
-    celebrityProduct: bestsellers[0] ?? newArrivals[0] ?? null,
-    baptismGirl: resolvedBaptismGirl,
-    baptismBoy: resolvedBaptismBoy,
-    baptismPicks: (baptismByTag.length ? baptismByTag : baptismFallback).slice(0, 5),
-    themeProducts,
-    aboutBrand,
-    brandPillars,
-    blogPosts,
-    sectionsCopy,
-    trustFeatures,
-  };
 }

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]