medusa-storefront-data 2.0.0 → 2.3.0

package/src/server/home.ts

@@ -1,24 +1,89 @@
 "use server";
 
+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 {
+  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[];
+}
+
 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;
+  };
+  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 (replaces per-page Promise.all boilerplate).
+ * Parallel home page data loader for full storefront homepage sections.
  */
 export async function loadHomePageData(countryCode: string): Promise<HomePageData | null> {
   const region = await getRegion(countryCode);
@@ -31,14 +96,24 @@ export async function loadHomePageData(countryCode: string): Promise<HomePageDat
     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: 50 }).catch(() => []),
+    listCategories({ limit: 100 }).catch(() => []),
     listProductsWithSort({
       page: 1,
-      queryParams: { limit: 8 },
+      queryParams: { limit: 12 },
       sortBy: "created_at",
       countryCode,
     }).catch(() => ({ response: { products: [] } })),
@@ -47,22 +122,90 @@ export async function loadHomePageData(countryCode: string): Promise<HomePageDat
       limit: 10,
       countryCode,
     }).catch(() => []),
-    getTestimonialsFromConfig().catch(() => null),
+    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?: 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
+        );
 
   return {
     region,
     collections: collections as Array<Record<string, unknown>>,
-    categories: categoriesResult ?? [],
+    categories,
     newArrivals,
-    bestsellers: bestsellersResult ?? [],
+    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-section-defaults.ts

@@ -0,0 +1,160 @@
+/**
+ * Default `homepage-config.sections` blocks.
+ * Dynamic config overrides any field; unset fields keep these defaults.
+ */
+export const DEFAULT_HOMEPAGE_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",
+  },
+  promoCountdown: {
+    text: "Limited-time offer — shop your favourites before they're gone!",
+    code: "SAVE20",
+    active: false,
+  },
+  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",
+  },
+  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",
+  },
+  brandPillars: {
+    title: "This approach resulted in the beautiful structure",
+    pillars: [
+      {
+        title: "Your favorite kids destination",
+        description:
+          "Trendy, high-quality outfits for little ones—pieces designed for comfort, celebration, and the memories you make together.",
+        image: "/features/store.jpg",
+      },
+      {
+        title: "Video call consultation",
+        description:
+          "Shop from home with our video call service. Our team shows styles in real-time and helps you pick the perfect outfits.",
+        image: "/features/video.jpg",
+      },
+      {
+        title: "Design Your Dream Outfit",
+        description:
+          "We customize colors, themes, and handwork to create a perfectly fitted outfit for your little one's special moments.",
+        image: "/features/design.jpg",
+      },
+      {
+        title: "Luxury Fabrics, Made for Kids",
+        description:
+          "We use premium, breathable fabrics so each outfit feels luxurious and comfortable all day.",
+        image: "/features/fabric.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" },
+      { name: "Fast Delivery", icon: "/fast.svg" },
+      { name: "Cash On Delivery", icon: "/cash.svg" },
+    ],
+  },
+  whyChooseUs: {
+    title: "Why Choose Us?",
+    features: [
+      { "feature-name": "Premium Quality", "feature-icon": "/icons/quality.svg" },
+      { "feature-name": "Easy Returns", "feature-icon": "/icons/returns.svg" },
+      { "feature-name": "Fast Delivery", "feature-icon": "/icons/delivery.svg" },
+      { "feature-name": "Secure Checkout", "feature-icon": "/icons/secure.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",
+      },
+      {
+        title: "How to Choose a Birthday Frock That Matches Your Party Theme",
+        href: "/blog/birthday-frock-party-theme",
+        category: "Birthday Dress",
+        date: "May 14, 2026",
+      },
+      {
+        title: "Beyond Pink: Trending Colors in Kid's Party Wear",
+        href: "/blog/trending-party-wear-colors",
+        category: "Girls Party Dresses",
+        date: "Apr 30, 2026",
+      },
+      {
+        title: "Wearable Wonders: 3D Hand-Embroidered Theme Dresses",
+        href: "/blog/3d-hand-embroidered-dresses",
+        category: "Birthday dress for Baby Girl",
+        date: "Apr 25, 2026",
+      },
+    ],
+  },
+} as const satisfies Record<string, Record<string, unknown>>
+
+export type DefaultHomeSectionId = keyof typeof DEFAULT_HOMEPAGE_SECTIONS
+
+export const HOME_SECTION_COPY_ID_LIST = Object.keys(
+  DEFAULT_HOMEPAGE_SECTIONS
+) as DefaultHomeSectionId[]

package/src/server/swaps.ts

@@ -10,18 +10,20 @@ import { cookies } from "next/headers"
 import { revalidateTag } from "next/cache"
 import { getStoreClientOptions, getStoreClientOptionsWithToken } from "../util/store-client"
 
+export type SwapActionState = {
+  success: boolean
+  error: string | null
+  swap: Record<string, unknown> | null
+}
+
 /**
  * Create an exchange (swap) request.
  * Supports both authenticated customers and guest users.
  */
 export const createSwapRequest = async (
-  prevState: unknown,
+  _prevState: SwapActionState,
   formData: FormData
-): Promise<{
-  success: boolean
-  error: string | null
-  swap: Record<string, unknown> | null
-}> => {
+): Promise<SwapActionState> => {
   const orderId = formData.get("order_id") as string
   const returnItemsJson = formData.get("return_items") as string
   const newItemsJson = formData.get("new_items") as string

package/src/server/wishlist.ts

@@ -43,7 +43,7 @@ export async function getWishlist(includeDetails = true, countryCode?: string) {
                     "*thumbnail,*images,*variants,*variants.options,*options,*options.values,*variants.calculated_price,*variants.inventory_quantity,*variants.manage_inventory,*variants.allow_backorder",
                 ...(regionId ? { region_id: regionId } : {}),
             },
-            { next: { tags: ["products"] } }
+            {}
         );
 
         const fullProducts = productsResponse.products as HttpTypes.StoreProduct[];