medusa-storefront-data 2.1.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,26 +1,111 @@
-"use server";
+import "server-only";
 
+import { HttpTypes } from "@medusajs/types";
 import { listCollections } from "./collections";
 import { listCategories } from "./categories";
-import { listProductsWithSort, getProductsByTag } from "./products";
+import { listProductsWithSort, getProductsByTag, listProducts } from "./products";
 import { getRegion } from "./regions";
-import { getTestimonialsFromConfig } from "./dynamic-config";
+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,
+  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[];
+}
 
 export type HomePageData = {
   region: Awaited<ReturnType<typeof getRegion>>;
   collections: Array<Record<string, unknown>>;
-  categories: unknown[];
-  newArrivals: unknown[];
-  bestsellers: 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;
+    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 }>;
+  };
+};
+
+export type LoadHomePageDataOptions = {
+  /** Merged `homepage-config` from main project (fetched via dynamic-config API there). */
+  pageInput?: HomepageConfig | null;
 };
 
 /**
- * Parallel home page data loader (replaces per-page Promise.all boilerplate).
+ * 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;
 
@@ -29,16 +114,21 @@ export async function loadHomePageData(countryCode: string): Promise<HomePageDat
     categoriesResult,
     newArrivalsResult,
     bestsellersResult,
-    testimonialsData,
     allRatings,
+    themeByTag,
+    baptismByTag,
   ] = await Promise.all([
     listCollections({ fields: "id, handle, title, metadata" }).catch(() => ({
       collections: [],
     })),
-    listCategories({ limit: 50 }).catch(() => []),
+    listCategories({
+      limit: 100,
+      fields:
+        "id,handle,name,metadata,parent_category_id,*parent_category,*parent_category.parent_category",
+    }).catch(() => []),
     listProductsWithSort({
       page: 1,
-      queryParams: { limit: 8 },
+      queryParams: { limit: 12 },
       sortBy: "created_at",
       countryCode,
     }).catch(() => ({ response: { products: [] } })),
@@ -47,22 +137,89 @@ export async function loadHomePageData(countryCode: string): Promise<HomePageDat
       limit: 10,
       countryCode,
     }).catch(() => []),
-    getTestimonialsFromConfig().catch(() => null),
     fetchRatings(),
+    getProductsByTag({ tagValue: "theme", limit: 8, countryCode }).catch(() => []),
+    getProductsByTag({ tagValue: "baptism", limit: 12, countryCode }).catch(() => []),
   ]);
 
+  const categories = (categoriesResult ?? []) as HttpTypes.StoreProductCategory[];
   const collections =
     (collectionsResult as { collections?: unknown[] }).collections ?? [];
   const newArrivals =
-    (newArrivalsResult as { response?: { products?: unknown[] } }).response?.products ?? [];
+    (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;
+  }
+
+  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
+        );
+
+  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: categoriesResult ?? [],
+    categories,
     newArrivals,
-    bestsellers: bestsellersResult ?? [],
-    testimonials: testimonialsData,
+    bestsellers,
+    testimonials: segmentConfig.testimonials,
     ratings: allRatings ?? [],
+    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,
+    themeProducts,
+    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]