medusa-storefront-data 2.5.8 → 2.5.9

package/dist/src/util/store-client.js

@@ -0,0 +1,75 @@
+import { getStoreAuthOptions } from "medusa-services/auth";
+import { getAuthHeaders, getGuestAuthHeaders } from "../cookies";
+import { getLocaleHeader } from "./get-locale-header";
+import { cookies as nextCookies } from "next/headers";
+function getBackendUrl() {
+    return (process.env.MEDUSA_BACKEND_URL?.replace(/\/$/, "") ||
+        process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL?.replace(/\/$/, "") ||
+        "http://localhost:9000");
+}
+function getPublishableApiKey() {
+    const key = process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY;
+    if (!key) {
+        throw new Error("NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY is not configured");
+    }
+    return key;
+}
+/**
+ * Builds portable Medusa store client options from Next.js cookies and env.
+ */
+export async function getStoreClientOptions() {
+    const auth = await getAuthHeaders();
+    const localeHeader = await getLocaleHeader().catch(() => ({}));
+    return {
+        backendUrl: getBackendUrl(),
+        publishableApiKey: getPublishableApiKey(),
+        authorization: "authorization" in auth ? auth.authorization : undefined,
+        headers: localeHeader["x-medusa-locale"]
+            ? { "x-medusa-locale": localeHeader["x-medusa-locale"] }
+            : undefined,
+    };
+}
+export function getMedusaBackendUrl() {
+    return getBackendUrl();
+}
+export async function getGuestStoreClientOptions() {
+    const guestAuth = await getGuestAuthHeaders();
+    let authorization = "authorization" in guestAuth ? guestAuth.authorization : undefined;
+    if (!authorization) {
+        try {
+            const cookieStore = await nextCookies();
+            const legacyToken = cookieStore.get("_medusa_guest_token")?.value;
+            if (legacyToken) {
+                authorization = `Bearer ${legacyToken}`;
+            }
+        }
+        catch {
+            return null;
+        }
+    }
+    if (!authorization)
+        return null;
+    return {
+        backendUrl: getBackendUrl(),
+        publishableApiKey: getPublishableApiKey(),
+        authorization,
+    };
+}
+export async function getStoreClientOptionsWithToken(token) {
+    return {
+        backendUrl: getBackendUrl(),
+        publishableApiKey: getPublishableApiKey(),
+        authorization: token.startsWith("Bearer ") ? token : `Bearer ${token}`,
+    };
+}
+export async function getAuthClientOptions(authorization) {
+    if (authorization) {
+        return getStoreAuthOptions({
+            backendUrl: getBackendUrl(),
+            publishableApiKey: getPublishableApiKey(),
+            authorization,
+        });
+    }
+    const storeOptions = await getStoreClientOptions();
+    return getStoreAuthOptions(storeOptions);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "medusa-storefront-data",
-  "version": "2.5.8",
+  "version": "2.5.9",
   "type": "module",
   "description": "Medusa storefront server data layer extracted from Next.js storefront",
   "license": "MIT",
@@ -21,13 +21,13 @@
     "test": "npm run build"
   },
   "peerDependencies": {
-    "next": ">=14",
-    "react": ">=18",
     "@medusajs/js-sdk": ">=2",
     "@medusajs/types": ">=2",
     "medusa-reviews-logic": "*",
+    "medusa-services": "^1.0.0",
     "medusa-wishlist-logic": "*",
-    "medusa-services": "^1.0.0"
+    "next": ">=14",
+    "react": ">=18"
   },
   "peerDependenciesMeta": {
     "medusa-reviews-logic": {
@@ -39,13 +39,17 @@
     "server-only": "^0.0.1"
   },
   "devDependencies": {
-    "typescript": "^5.6.0",
-    "@types/react": "^18.3.0",
-    "next": "^15.0.0",
     "@medusajs/js-sdk": "^2.0.0",
     "@medusajs/types": "^2.0.0",
     "@types/node": "^22.0.0",
-    "medusa-services": "workspace:*"
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "medusa-services": "^1.2.1",
+    "medusa-ui-home-config": "^1.1.3",
+    "next": "^15.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.6.0"
   },
   "exports": {
     "./package.json": "./package.json",
@@ -54,6 +58,16 @@
       "import": "./src/server/index.ts",
       "default": "./src/server/index.ts"
     },
+    "./help/sections/helpFaq": {
+      "types": "./dist/server/help-sections/help-faq.d.ts",
+      "import": "./src/server/help-sections/help-faq.ts",
+      "default": "./src/server/help-sections/help-faq.ts"
+    },
+    "./storefront-cms": {
+      "types": "./src/server/storefront-cms.ts",
+      "import": "./src/server/storefront-cms.ts",
+      "default": "./src/server/storefront-cms.ts"
+    },
     "./home/sections/promoAnnouncements": {
       "types": "./dist/server/home-sections/promo-announcements.d.ts",
       "import": "./src/server/home-sections/promo-announcements.ts",
@@ -129,6 +143,11 @@
       "import": "./src/server/home-sections/testimonials.ts",
       "default": "./src/server/home-sections/testimonials.ts"
     },
+    "./home/sections/customerStories": {
+      "types": "./dist/server/home-sections/customer-stories.d.ts",
+      "import": "./src/server/home-sections/customer-stories.ts",
+      "default": "./src/server/home-sections/customer-stories.ts"
+    },
     "./home/sections/brandPillars": {
       "types": "./dist/server/home-sections/brand-pillars.d.ts",
       "import": "./src/server/home-sections/brand-pillars.ts",
@@ -168,16 +187,6 @@
       "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"
-    },
-    "./help/sections/helpFaq": {
-      "types": "./dist/server/help-sections/help-faq.d.ts",
-      "import": "./src/server/help-sections/help-faq.ts",
-      "default": "./src/server/help-sections/help-faq.ts"
-    },
-    "./storefront-cms": {
-      "types": "./src/server/storefront-cms.ts",
-      "import": "./src/server/storefront-cms.ts",
-      "default": "./src/server/storefront-cms.ts"
     }
   },
   "main": "./dist/server/index.js",

package/src/server/dynamic-config.ts

@@ -505,6 +505,142 @@ export function getTestimonialsFromPageInput(
   return { title, subtitle, testimonials }
 }
 
+export type CustomerStoryItem = {
+  id: string
+  image: string
+  text: string
+  name: string
+  rating?: number
+  location?: string
+}
+
+function parseCustomerStoryRow(
+  item: unknown,
+  index: number
+): CustomerStoryItem | null {
+  if (!item || typeof item !== "object") return null
+  const row =
+    (item as Record<string, unknown>).story ??
+    (item as Record<string, unknown>).review ??
+    item
+  const r = row as Record<string, unknown>
+  const text = String(
+    r.text ?? r["review-description"] ?? r.description ?? r.quote ?? ""
+  ).trim()
+  const name = String(
+    r.name ??
+      r["review-user-name"] ??
+      r["user-name"] ??
+      r.user_name ??
+      r.author ??
+      ""
+  ).trim()
+  const image = String(
+    r.image ??
+      r["review-profile-image"] ??
+      r["profile-image"] ??
+      r.profile_image ??
+      ""
+  ).trim()
+  /** Quote + name required; image optional (admin Ratings often has no photo). */
+  if (!text || !name) return null
+  const ratingRaw = r.rating ?? r["review-rating"]
+  const rating =
+    ratingRaw != null && ratingRaw !== ""
+      ? parseFloat(String(ratingRaw))
+      : undefined
+  const location = String(r.location ?? "").trim()
+  return {
+    id: String(r.id ?? `${name.toLowerCase().replace(/[^a-z0-9]+/g, "-")}-${index + 1}`),
+    image: image || "/Logo.png",
+    text,
+    name,
+    rating: Number.isFinite(rating) ? Math.max(0, Math.min(5, rating!)) : undefined,
+    location: location || undefined,
+  }
+}
+
+function parseCustomerStoriesFromBlock(
+  block: Record<string, unknown>
+): CustomerStoryItem[] {
+  const raw =
+    block.items ??
+    block.stories ??
+    block.reviews ??
+    block["customer-stories"] ??
+    []
+  if (!Array.isArray(raw)) return []
+  return raw
+    .map((item, index) => parseCustomerStoryRow(item, index))
+    .filter((row): row is CustomerStoryItem => row !== null)
+}
+
+function parseCustomerStoriesFromRatings(ratings: unknown): CustomerStoryItem[] {
+  if (!Array.isArray(ratings)) return []
+  return ratings
+    .map((item, index) => parseCustomerStoryRow(item, index))
+    .filter((row): row is CustomerStoryItem => row !== null)
+}
+
+function getHomepageRatingsArray(
+  pageInput?: HomepageConfig | null
+): unknown[] {
+  const resolved = resolvePageInput(pageInput)
+  const fromResolved = resolved["ratings"]
+  if (Array.isArray(fromResolved) && fromResolved.length > 0) {
+    return fromResolved
+  }
+  const fromOverride = pageInput?.["ratings"]
+  if (Array.isArray(fromOverride) && fromOverride.length > 0) {
+    return fromOverride
+  }
+  return []
+}
+
+export function getCustomerStoriesFromPageInput(
+  pageInput?: HomepageConfig | null
+): {
+  title: string
+  eyebrow: string
+  items: CustomerStoryItem[]
+} {
+  const homepageConfig = resolvePageInput(pageInput)
+  const block = getMergedSectionBlock("customerStories", pageInput)
+  const copy = parseSectionCopy(block)
+  const ratingTitle = String(homepageConfig["rating-title"] ?? "").trim()
+  const title = copy.title ?? copy.name ?? ratingTitle
+  const eyebrow = copy.eyebrow ?? ""
+  const defaults = DEFAULT_HOMEPAGE_SECTIONS.customerStories as Record<string, unknown>
+
+  /** Admin "Ratings" (`homepage-config.ratings[].review`) — always before merged section defaults. */
+  const ratingsItems = parseCustomerStoriesFromRatings(
+    getHomepageRatingsArray(pageInput)
+  )
+
+  /** CMS `sections.customerStories` only (no package default stories mixed in). */
+  const cmsSectionBlock =
+    findSectionBlock(getHomepageSectionsRoot(pageInput), "customerStories") ?? {}
+  const sectionItems = parseCustomerStoriesFromBlock(cmsSectionBlock)
+
+  let items =
+    ratingsItems.length > 0
+      ? ratingsItems
+      : sectionItems.length > 0
+        ? sectionItems
+        : parseCustomerStoriesFromBlock(block)
+  if (items.length === 0) {
+    items = parseCustomerStoriesFromBlock(
+      defaults as Record<string, unknown>
+    )
+  }
+
+  return {
+    title: title || String(defaults.title ?? "Customer Stories"),
+    eyebrow: eyebrow || String(defaults.eyebrow ?? "WHAT PARENTS SAY"),
+    items,
+  }
+}
+
 
 export function getSocialLinksFromPageInput(
   pageInput?: HomepageConfig | null

package/src/server/hero-banner-priority.ts

@@ -0,0 +1,63 @@
+/** Simplified banner shape used by hero sections (not legacy kebab-case CMS keys). */
+export type HomepageBanner = {
+  image?: string
+  title?: string
+  subtitle?: string
+  description?: string
+  buttonName?: string
+  buttonLink?: string
+}
+
+export type ThemeHeroBannerFallbacks = {
+  home: HomepageBanner
+  app: HomepageBanner
+}
+
+export type HeroBannerSource = "dynamic-config" | "theme-copy" | "library-default"
+
+export type ResolvedHeroBanners = {
+  homeBanners: HomepageBanner[]
+  appBanners: HomepageBanner[]
+  homeSource: HeroBannerSource
+  appSource: HeroBannerSource
+}
+
+export function hasBannerData(
+  banner: HomepageBanner | null | undefined
+): boolean {
+  if (!banner) return false
+  return Boolean(
+    banner.image?.trim() ||
+    banner.title?.trim() ||
+    banner.subtitle?.trim() ||
+    banner.description?.trim() ||
+    banner.buttonName?.trim() ||
+    banner.buttonLink?.trim()
+  )
+}
+
+/**
+ * Whole-banner priority (not per-field):
+ * 1. dynamic-config  2. theme copy.ts  3. package library defaults
+ */
+export function pickHeroBannerBySource(
+  cms: HomepageBanner | null | undefined,
+  theme: HomepageBanner,
+  library: HomepageBanner
+): { banner: HomepageBanner; source: HeroBannerSource } {
+  if (cms && hasBannerData(cms)) {
+    return { banner: cms, source: "dynamic-config" }
+  }
+  if (hasBannerData(theme)) {
+    return { banner: theme, source: "theme-copy" }
+  }
+  return { banner: library, source: "library-default" }
+}
+
+export function resolveHeroBannerWithPriority(
+  cms: HomepageBanner | null | undefined,
+  theme: HomepageBanner,
+  library: HomepageBanner
+): HomepageBanner {
+  return pickHeroBannerBySource(cms, theme, library).banner
+}

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

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

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

@@ -212,6 +212,22 @@ export type HomepageVideoStoriesSection = HomepageSectionCopyFields & {
   "video-stories"?: HomepageVideoStoryEntry[]
 }
 
+export type HomepageCustomerStoryItem = {
+  id?: string
+  image?: string
+  text?: string
+  name?: string
+  rating?: number | string
+  location?: string
+  story?: HomepageCustomerStoryItem
+  review?: HomepageCustomerStoryItem
+}
+
+export type HomepageCustomerStoriesSection = HomepageSectionCopyFields & {
+  items?: HomepageCustomerStoryItem[]
+  stories?: HomepageCustomerStoryItem[]
+}
+
 /** Per-section blocks under `homepage-config.sections`. */
 export type HomepageSectionsConfig = {
   promoAnnouncements?: HomepagePromoAnnouncementsSection
@@ -228,6 +244,7 @@ export type HomepageSectionsConfig = {
   themeDresses?: HomepageSectionCopyFields
   brandMarquee?: HomepageSectionCopyFields
   aboutBrand?: HomepageAboutBrandSection
+  customerStories?: HomepageCustomerStoriesSection
   testimonials?: HomepageTestimonialsSection
   brandPillars?: HomepageBrandPillarsSection
   instagramPosts?: HomepageInstagramPostsSection
@@ -457,6 +474,7 @@ export const HOMEPAGE_SECTION_IDS = [
   "themeDresses",
   "brandMarquee",
   "aboutBrand",
+  "customerStories",
   "testimonials",
   "brandPillars",
   "instagramPosts",

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

@@ -1,4 +1,5 @@
 import helpFaqDefaults from "./help-faq-section-defaults.json"
+import { customerStoriesSectionDefaults } from "medusa-ui-home-config/sections/customerStories"
 
 /**
  * Default `homepage-config.sections` blocks.
@@ -71,6 +72,7 @@ export const DEFAULT_HOMEPAGE_SECTIONS = {
       { label: "Products", value: "3000+" },
     ],
   },
+  customerStories: customerStoriesSectionDefaults,
   testimonials: {
     title: "What Clients Talk About Us",
     description: "The Trust We've Earned",