medusa-storefront-data 2.4.0 → 2.5.3

package/HOMEPAGE_CONFIG.md

@@ -1,10 +1,48 @@
 # Homepage config and page input
 
-Storefront **packages do not call** `GET /store/dynamic-config`. Segment copy uses **hardcoded JSON defaults** (`segment-data/default-page-input.json`). The **main project** fetches dynamic config once and passes optional `pageInput` overrides.
+Storefront **packages do not call** `GET /store/dynamic-config`. Each homepage section in `medusa-ui-home` keeps its **default copy in `data.json`** beside the UI. The **main project** fetches dynamic config once and passes optional `pageInput` overrides.
+
+## `medusa-ui-home` section layout
+
+Each section id is a folder under `src/home/sections/<id>/`:
+
+| File | Role |
+|------|------|
+| `data.json` | Default segment fields for dynamic-config schema |
+| `theme.ts` | Default class names for slots this section uses + `ThemeOverrides` + `mergeSectionTheme()` |
+| `dynamic-config.ts` | `*HomepageSectionField`, `*DynamicConfigStructure`, section id exports |
+| `component/` | Presentational UI (or `component/index.tsx` re-export for shared widgets) |
+| `section.tsx` | Section React wrapper only; optional `theme` prop |
+| `index.ts` | Package export (`medusa-ui-home/sections/<id>`) |
+
+Shared widgets used by multiple sections live in `src/home/components/` (`dynamic-banner`, `shoppable-gallery`, `shared/product-grid-section`, etc.).
+
+Cross-section slots (e.g. `section`, `sectionPad`, `cardSurface`) live in `src/home/theme/shared.ts` and are composed into `medusa-ui-home/theme` via `defaultHomeThemeClassNames`.
+
+### Per-section theme overrides
+
+```tsx
+import AboutBrandSection, {
+  mergeSectionTheme,
+  type ThemeOverrides,
+} from "medusa-ui-home/sections/aboutBrand"
+
+const aboutBrandTheme: ThemeOverrides = {
+  bannerTitle: "text-3xl font-black text-[var(--sf-color-secondary)]",
+}
+
+// Page / section instance
+<AboutBrandSection {...data} theme={aboutBrandTheme} />
+
+// Or merge into site home theme (Medusa theme-base)
+const homeTheme = mergeThemeSlots(defaultHomeThemeClassNames, {
+  ...mergeSectionTheme({ bannerTitle: "..." }),
+})
+```
 
 ## Tree-shakeable imports (one section)
 
-Import **only** the section UI and its loader. No `loadHomePageData`, no `registerAllHomeSections`, no full home barrel.
+Import **only** the section UI and its loader. No full home barrel or global section registry.
 
 ```tsx
 // app/[countryCode]/page.tsx — single hero block
@@ -33,7 +71,7 @@ export default async function Page({
 | `medusa-ui-home/sections/promoAnnouncements` | `medusa-storefront-data/home/sections/promoAnnouncements` |
 | … | … (all `HomeSectionId` values) |
 
-Run `node scripts/generate-home-section-exports.mjs` after adding a section.
+Run `node scripts/generate-home-section-exports.mjs` after adding a section (creates `sections/<id>/` export entries in `medusa-ui-home` and loader paths in `medusa-storefront-data`).
 
 ## Themed pages (tree-shakeable)
 
@@ -71,9 +109,29 @@ return (
 )
 ```
 
-### Legacy compose registry
+### Main project page (no registration)
+
+Sections accept props from their matching `load*SectionData` helper — no `adaptHomeSection` or `registerAllHomeSections`:
+
+```tsx
+import HeroSection from "medusa-ui-home/sections/hero"
+import WhyChooseUsSection from "medusa-ui-home/sections/whyChooseUs"
+import { loadHeroSectionData } from "medusa-storefront-data/home/sections/hero"
+import { loadWhyChooseUsSectionData } from "medusa-storefront-data/home/sections/whyChooseUs"
 
-`medusa-ui-home/home/register-sections` and `loadHomePageData` still exist but pull **every** section — avoid for tree-shaking.
+const pageInput = /* optional CMS overrides */
+const [hero, whyChooseUs] = await Promise.all([
+  loadHeroSectionData(countryCode, { pageInput }),
+  loadWhyChooseUsSectionData(countryCode, { pageInput }),
+])
+
+return (
+  <>
+    {hero && <HeroSection {...hero} />}
+    {whyChooseUs && <WhyChooseUsSection {...whyChooseUs} />}
+  </>
+)
+```
 
 ## Main project dynamic config
 
@@ -88,12 +146,61 @@ const pageInput = homepageConfigFromDynamicResponse(await getDynamicConfig())
 
 Pass `pageInput` only where you need CMS overrides; omit it to use package JSON defaults.
 
+## Medusa backend admin schemas (`medusa-ui-home-config`)
+
+Use **`medusa-ui-home-config`** in the Medusa server (CommonJS `require` + ESM `import`). Do not import `medusa-ui-home` in `medusa-config` — that package is ESM-only (React UI).
+
+```js
+const { homepageSectionFields } = require("medusa-ui-home-config")
+const { aboutBrandHomepageSectionField } = require(
+  "medusa-ui-home-config/sections/aboutBrand",
+)
+```
+
+```ts
+import { homepageSectionFields } from "medusa-ui-home-config"
+import { heroHomepageSectionField, bannerSlide } from "medusa-ui-home-config/sections/hero"
+```
+
+Compose `options.configs` from `homepageSectionFields` or individual `*HomepageSectionField` exports. Merge API responses with `homepageConfigFromDynamicResponse` from `medusa-storefront-data/dynamic-config`.
+
+Help page FAQs use **`helpFaqHomepageSectionField`** from `medusa-ui-home-config/sections/helpFaq` (also included in `homepageSectionFields`). Store in `homepage-config.sections.helpFaq`:
+
+```json
+{
+  "sections": {
+    "helpFaq": {
+      "eyebrow": "Knowledge Base",
+      "title": "Frequently Asked",
+      "titleHighlight": "Questions",
+      "subtitle": "Browse FAQs by topic.",
+      "categories": [
+        {
+          "category": "Order & Delivery",
+          "icon": "🚚",
+          "color": "from-blue-500 to-cyan-400",
+          "items": [
+            { "question": "When will I receive my order?", "answer": "…" }
+          ]
+        }
+      ]
+    }
+  }
+}
+```
+
+Legacy flat `faq-array` entries are still supported and are grouped by `faq-category`.
+
+Storefront UI still imports from `medusa-ui-home/sections/<id>`.
+
 ## API reference
 
 | Export | Use |
 |--------|-----|
 | `loadHeroSectionData`, `loadNewArrivalsSectionData`, … | **One section** catalog + copy |
-| `loadHomePageData` | All sections (legacy) |
+| `loadHelpFaqSectionData` | Help page FAQ (`sections.helpFaq`) |
+| `getHelpFaqFromPageInput(pageInput)` | FAQ categories + section header copy |
 | `getDynamicConfig()` | **Main project only** |
+| `get*FromPageInput(pageInput)` | Read CMS copy/banners without fetching |
 | `homepageConfigFromDynamicResponse(raw)` | Merge API → `pageInput` |
 | `DEFAULT_PAGE_INPUT` | Package defaults |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "medusa-storefront-data",
-  "version": "2.4.0",
+  "version": "2.5.3",
   "type": "module",
   "description": "Medusa storefront server data layer extracted from Next.js storefront",
   "license": "MIT",
@@ -123,6 +123,11 @@
       "import": "./src/server/dynamic-config.ts",
       "default": "./src/server/dynamic-config.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"
+    },
     "./fulfillment": {
       "types": "./dist/server/fulfillment.d.ts",
       "import": "./src/server/fulfillment.ts",
@@ -207,121 +212,6 @@
       "types": "./dist/server/wishlist.d.ts",
       "import": "./src/server/wishlist.ts",
       "default": "./src/server/wishlist.ts"
-    },
-    "./home/sections/promoAnnouncements": {
-      "types": "./dist/server/home-sections/promo-announcements.d.ts",
-      "import": "./src/server/home-sections/promo-announcements.ts",
-      "default": "./src/server/home-sections/promo-announcements.ts"
-    },
-    "./home/sections/hero": {
-      "types": "./dist/server/home-sections/hero.d.ts",
-      "import": "./src/server/home-sections/hero.ts",
-      "default": "./src/server/home-sections/hero.ts"
-    },
-    "./home/sections/categoryPills": {
-      "types": "./dist/server/home-sections/category-pills.d.ts",
-      "import": "./src/server/home-sections/category-pills.ts",
-      "default": "./src/server/home-sections/category-pills.ts"
-    },
-    "./home/sections/newArrivals": {
-      "types": "./dist/server/home-sections/new-arrivals.d.ts",
-      "import": "./src/server/home-sections/new-arrivals.ts",
-      "default": "./src/server/home-sections/new-arrivals.ts"
-    },
-    "./home/sections/newArrivalsClassic": {
-      "types": "./dist/server/home-sections/new-arrivals-classic.d.ts",
-      "import": "./src/server/home-sections/new-arrivals-classic.ts",
-      "default": "./src/server/home-sections/new-arrivals-classic.ts"
-    },
-    "./home/sections/promoCountdown": {
-      "types": "./dist/server/home-sections/promo-countdown.d.ts",
-      "import": "./src/server/home-sections/promo-countdown.ts",
-      "default": "./src/server/home-sections/promo-countdown.ts"
-    },
-    "./home/sections/celebrityTrust": {
-      "types": "./dist/server/home-sections/celebrity-trust.d.ts",
-      "import": "./src/server/home-sections/celebrity-trust.ts",
-      "default": "./src/server/home-sections/celebrity-trust.ts"
-    },
-    "./home/sections/luxeFavourites": {
-      "types": "./dist/server/home-sections/luxe-favourites.d.ts",
-      "import": "./src/server/home-sections/luxe-favourites.ts",
-      "default": "./src/server/home-sections/luxe-favourites.ts"
-    },
-    "./home/sections/shopByCategory": {
-      "types": "./dist/server/home-sections/shop-by-category.d.ts",
-      "import": "./src/server/home-sections/shop-by-category.ts",
-      "default": "./src/server/home-sections/shop-by-category.ts"
-    },
-    "./home/sections/baptism": {
-      "types": "./dist/server/home-sections/baptism.d.ts",
-      "import": "./src/server/home-sections/baptism.ts",
-      "default": "./src/server/home-sections/baptism.ts"
-    },
-    "./home/sections/baptismPicks": {
-      "types": "./dist/server/home-sections/baptism-picks.d.ts",
-      "import": "./src/server/home-sections/baptism-picks.ts",
-      "default": "./src/server/home-sections/baptism-picks.ts"
-    },
-    "./home/sections/themeDresses": {
-      "types": "./dist/server/home-sections/theme-dresses.d.ts",
-      "import": "./src/server/home-sections/theme-dresses.ts",
-      "default": "./src/server/home-sections/theme-dresses.ts"
-    },
-    "./home/sections/brandMarquee": {
-      "types": "./dist/server/home-sections/brand-marquee.d.ts",
-      "import": "./src/server/home-sections/brand-marquee.ts",
-      "default": "./src/server/home-sections/brand-marquee.ts"
-    },
-    "./home/sections/aboutBrand": {
-      "types": "./dist/server/home-sections/about-brand.d.ts",
-      "import": "./src/server/home-sections/about-brand.ts",
-      "default": "./src/server/home-sections/about-brand.ts"
-    },
-    "./home/sections/testimonials": {
-      "types": "./dist/server/home-sections/testimonials.d.ts",
-      "import": "./src/server/home-sections/testimonials.ts",
-      "default": "./src/server/home-sections/testimonials.ts"
-    },
-    "./home/sections/brandPillars": {
-      "types": "./dist/server/home-sections/brand-pillars.d.ts",
-      "import": "./src/server/home-sections/brand-pillars.ts",
-      "default": "./src/server/home-sections/brand-pillars.ts"
-    },
-    "./home/sections/instagramPosts": {
-      "types": "./dist/server/home-sections/instagram-posts.d.ts",
-      "import": "./src/server/home-sections/instagram-posts.ts",
-      "default": "./src/server/home-sections/instagram-posts.ts"
-    },
-    "./home/sections/features": {
-      "types": "./dist/server/home-sections/features.d.ts",
-      "import": "./src/server/home-sections/features.ts",
-      "default": "./src/server/home-sections/features.ts"
-    },
-    "./home/sections/shopByAge": {
-      "types": "./dist/server/home-sections/shop-by-age.d.ts",
-      "import": "./src/server/home-sections/shop-by-age.ts",
-      "default": "./src/server/home-sections/shop-by-age.ts"
-    },
-    "./home/sections/whyChooseUs": {
-      "types": "./dist/server/home-sections/why-choose-us.d.ts",
-      "import": "./src/server/home-sections/why-choose-us.ts",
-      "default": "./src/server/home-sections/why-choose-us.ts"
-    },
-    "./home/sections/lovedByMoms": {
-      "types": "./dist/server/home-sections/loved-by-moms.d.ts",
-      "import": "./src/server/home-sections/loved-by-moms.ts",
-      "default": "./src/server/home-sections/loved-by-moms.ts"
-    },
-    "./home/sections/videoStories": {
-      "types": "./dist/server/home-sections/video-stories.d.ts",
-      "import": "./src/server/home-sections/video-stories.ts",
-      "default": "./src/server/home-sections/video-stories.ts"
-    },
-    "./home/sections/blogPosts": {
-      "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"
     }
   },
   "main": "./dist/server/index.js",

package/src/server/brand-pillars-from-categories.ts

@@ -0,0 +1,156 @@
+import type { HttpTypes } from "@medusajs/types"
+import type { BrandPillarConfig } from "./dynamic-config"
+
+type CategoryMetadata = {
+  category_image?: string
+  category_description?: string
+  category_link?: string
+  image?: string
+  thumbnail?: string
+  description?: string
+}
+
+type CollectionMetadata = {
+  category_image?: string
+  image?: string
+  thumbnail?: string
+}
+
+function normalizeKey(value: string): string {
+  return value
+    .toLowerCase()
+    .trim()
+    .replace(/&/g, "and")
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-+|-+$/g, "")
+}
+
+function collectionImageForCategory(
+  collections: Array<Record<string, unknown>> | undefined,
+  category: HttpTypes.StoreProductCategory
+): string | null {
+  if (!collections?.length) return null
+
+  const handleKey = category.handle ? normalizeKey(category.handle) : ""
+  const nameKey = category.name ? normalizeKey(category.name) : ""
+
+  for (const entry of collections) {
+    const meta = (entry.metadata as CollectionMetadata | undefined) ?? {}
+    const image = meta.category_image || meta.image || meta.thumbnail
+    if (!image) continue
+
+    const cHandle = (entry.handle as string | undefined) ?? ""
+    const cTitle = (entry.title as string | undefined) ?? ""
+    if (
+      (handleKey && normalizeKey(cHandle) === handleKey) ||
+      (nameKey && normalizeKey(cTitle) === nameKey)
+    ) {
+      return image
+    }
+  }
+
+  return null
+}
+
+function imageFromCategory(
+  category: HttpTypes.StoreProductCategory
+): string | null {
+  const meta = (category.metadata as CategoryMetadata | undefined) ?? {}
+  return (
+    meta.category_image ||
+    meta.image ||
+    meta.thumbnail ||
+    (category as { thumbnail?: string }).thumbnail ||
+    null
+  )
+}
+
+function resolveCategoryImage(
+  category: HttpTypes.StoreProductCategory,
+  collections?: Array<Record<string, unknown>>
+): string | null {
+  const fromCategory = imageFromCategory(category)
+  if (fromCategory) return fromCategory
+
+  const parent = (
+    category as HttpTypes.StoreProductCategory & {
+      parent_category?: HttpTypes.StoreProductCategory
+    }
+  ).parent_category
+  if (parent) {
+    const fromParent = imageFromCategory(parent)
+    if (fromParent) return fromParent
+  }
+
+  return collectionImageForCategory(collections, category)
+}
+
+function categoryDescription(
+  category: HttpTypes.StoreProductCategory
+): string {
+  const meta = (category.metadata as CategoryMetadata | undefined) ?? {}
+  const native = (category as { description?: string | null }).description
+  return String(
+    native ?? meta.category_description ?? meta.description ?? ""
+  ).trim()
+}
+
+function categoryHref(category: HttpTypes.StoreProductCategory): string | undefined {
+  const meta = (category.metadata as CategoryMetadata | undefined) ?? {}
+  const custom = meta.category_link?.trim()
+  if (custom) return custom
+  if (category.handle) return `/categories/${category.handle}`
+  return undefined
+}
+
+function pickBrandPillarCategories(
+  categories: HttpTypes.StoreProductCategory[],
+  collections: Array<Record<string, unknown>> | undefined,
+  limit = 4
+): HttpTypes.StoreProductCategory[] {
+  const valid = (categories ?? []).filter((c) => c.name && c.handle)
+  const topLevel = valid.filter((c) => !c.parent_category_id)
+  const withImage = topLevel.filter((c) =>
+    Boolean(resolveCategoryImage(c, collections))
+  )
+
+  const pool = withImage.length >= 2 ? withImage : topLevel
+
+  return [...pool]
+    .sort(
+      (a, b) =>
+        Number(Boolean(resolveCategoryImage(b, collections))) -
+          Number(Boolean(resolveCategoryImage(a, collections))) ||
+        (a.name ?? "").localeCompare(b.name ?? "")
+    )
+    .slice(0, limit)
+}
+
+/** Brand pillar cards from top-level product categories (not CMS pillars array). */
+export function buildBrandPillarsFromCategories(
+  categories: HttpTypes.StoreProductCategory[],
+  collections: Array<Record<string, unknown>> | undefined,
+  sectionTitle: string
+): { sectionTitle: string; pillars: BrandPillarConfig[] } {
+  const pillars = pickBrandPillarCategories(categories, collections).flatMap(
+    (category) => {
+      const title = (category.name ?? "").trim()
+      const image = resolveCategoryImage(category, collections) ?? undefined
+      if (!title || !image) return []
+
+      const description = categoryDescription(category)
+      const href = categoryHref(category)
+
+      return [
+        {
+          title,
+          description,
+          image,
+          ...(href ? { href } : {}),
+        },
+      ]
+    }
+  )
+
+  return { sectionTitle, pillars }
+}

package/src/server/cart.ts

@@ -55,7 +55,7 @@ import {
   medusaCustomerUpdateAddress,
 } from "medusa-services/customer"
 import { medusaPaymentSessionInitiate } from "medusa-services/payment"
-import { getStoreCartClientOptions } from "../util/store-client"
+import { getStoreClientOptions } from "../util/store-client"
 import { revalidateCartTags } from "../util/revalidate-cart"
 
 import { cache } from "react"
@@ -86,7 +86,7 @@ export const retrieveCart = cache(
         
         // Skip metadata check if we are clearly in checkout to avoid extra API call
         if (!pathname.includes("/checkout")) {
-          const options = await getStoreCartClientOptions()
+          const options = await getStoreClientOptions()
           const currentCart = await medusaCartRetrieve(id, options, { fields: "metadata" })
             .then(({ cart }) => cart)
             .catch(() => null)
@@ -143,7 +143,7 @@ export async function getOrSetCart(countryCode: string) {
   }
 
   let cart = await retrieveCart(undefined, "id,region_id")
-  const options = await getStoreCartClientOptions()
+  const options = await getStoreClientOptions()
 
   if (!cart) {
     const locale = await getLocale()
@@ -176,7 +176,7 @@ export async function updateCart(data: HttpTypes.StoreUpdateCart) {
   }
 
   try {
-    const options = await getStoreCartClientOptions()
+    const options = await getStoreClientOptions()
     const { cart } = await medusaCartUpdate(cartId, data as Record<string, unknown>, options)
     await revalidateCartTags()
     return cart as unknown as HttpTypes.StoreCart
@@ -205,7 +205,7 @@ export async function addToCart({
   }
 
   try {
-    const options = await getStoreCartClientOptions()
+    const options = await getStoreClientOptions()
     await medusaCartAddLineItem(cart.id, { variant_id: variantId, quantity }, options)
     await revalidateCartTags()
   } catch (e) {
@@ -232,7 +232,7 @@ export async function buyNow({
     throw new Error(`Region not found for country code: ${countryCode}`)
   }
 
-  const options = await getStoreCartClientOptions()
+  const options = await getStoreClientOptions()
   const locale = await getLocale()
   
   // 1. Create a NEW cart regardless of existing one
@@ -343,7 +343,7 @@ export async function updateLineItem({
   }
 
   try {
-    const options = await getStoreCartClientOptions()
+    const options = await getStoreClientOptions()
     await medusaCartUpdateLineItem(cartId, lineId, { quantity }, options)
     await revalidateCartTags()
   } catch (e) {
@@ -363,7 +363,7 @@ export async function deleteLineItem(lineId: string) {
   }
 
   try {
-    const options = await getStoreCartClientOptions()
+    const options = await getStoreClientOptions()
     await medusaCartRemoveLineItem(cartId, lineId, options)
     await revalidateCartTags()
   } catch (e) {
@@ -409,7 +409,7 @@ export async function setShippingMethod({
   shippingMethodId: string
 }) {
   try {
-    const options = await getStoreCartClientOptions()
+    const options = await getStoreClientOptions()
     await medusaCartAddShippingMethod(cartId, shippingMethodId, options)
     const cartCacheTag = await getCacheTag("carts")
     revalidateTag(cartCacheTag)
@@ -429,7 +429,7 @@ export async function setShippingMethodSilently({
   shippingMethodId: string
 }) {
   try {
-    const options = await getStoreCartClientOptions()
+    const options = await getStoreClientOptions()
     await medusaCartAddShippingMethod(cartId, shippingMethodId, options)
     return { success: true }
   } catch (e) {
@@ -490,13 +490,13 @@ export async function initiatePaymentSession(
     }
 
     if (Object.keys(addressUpdates).length > 0) {
-      const options = await getStoreCartClientOptions()
+      const options = await getStoreClientOptions()
       await medusaCartUpdate(latestCart.id, addressUpdates, options)
     }
   }
 
   // 3. Final re-fetch (direct call to bypass any lib-level cache)
-  const options = await getStoreCartClientOptions()
+  const options = await getStoreClientOptions()
   const { cart: finalCartRaw } = await medusaCartRetrieve(cart.id, options, {
     fields: "*shipping_address,*billing_address",
   })
@@ -552,7 +552,7 @@ export async function applyPromotions(codes: string[]) {
   }
 
   try {
-    const options = await getStoreCartClientOptions()
+    const options = await getStoreClientOptions()
     const { cart } = await medusaCartApplyPromotions(cartId, codes, options)
     await revalidateCartTags()
     return cart as unknown as HttpTypes.StoreCart
@@ -668,7 +668,7 @@ export async function setAddresses(currentState: unknown, formData: FormData) {
     const authHeaders = await getAuthHeaders()
     if (authHeaders && "authorization" in authHeaders) {
       try {
-        const options = await getStoreCartClientOptions()
+        const options = await getStoreClientOptions()
         const { customer } = await medusaCustomerRetrieve(options, { fields: "*addresses" })
 
         const addressExists = customer?.addresses?.some((a: any) =>
@@ -731,7 +731,7 @@ export async function placeOrder(cartId?: string) {
 
   let cartRes
   try {
-    const options = await getStoreCartClientOptions()
+    const options = await getStoreClientOptions()
     cartRes = await medusaCartComplete(id, options)
     const cartCacheTag = await getCacheTag("carts")
     revalidateTag(cartCacheTag)
@@ -740,7 +740,7 @@ export async function placeOrder(cartId?: string) {
   }
 
   if (cartRes?.type === "order") {
-    const order = cartRes.order as HttpTypes.StoreOrder
+    const order = cartRes.order as unknown as HttpTypes.StoreOrder
     const countryCode = order.shipping_address?.country_code?.toLowerCase()
 
     const orderCacheTag = await getCacheTag("orders")
@@ -840,7 +840,7 @@ export async function addCustomerAddressToCart(currentState: unknown, formData:
     // 1. Add/Update Customer Address Book
     // We try/catch this separately so if it fails (e.g. user not logged in), we still try to proceed with checkout
     try {
-      const options = await getStoreCartClientOptions()
+      const options = await getStoreClientOptions()
       if (addressId) {
         await medusaCustomerUpdateAddress(addressId, addressData, options)
       } else {
@@ -916,7 +916,7 @@ export async function updateAddressSilently(data: any) {
       }
     }
 
-    const options = await getStoreCartClientOptions()
+    const options = await getStoreClientOptions()
     await medusaCartUpdate(cartId, payload, options)
     
     // Revalidate tags to ensure CartTotals gets new shipping info
@@ -935,7 +935,7 @@ export async function updateCartMetadataSilently(metadata: any) {
   if (!cartId) return
 
   try {
-    const options = await getStoreCartClientOptions()
+    const options = await getStoreClientOptions()
     await medusaCartUpdate(cartId, { metadata }, options)
     // We intentionally DO NOT call revalidateTag here to prevent page refresh loops
     return { success: true }
@@ -953,7 +953,7 @@ export async function getAbandonedCarts() {
   }
 
   try {
-    const options = await getStoreCartClientOptions()
+    const options = await getStoreClientOptions()
     const res = await medusaCartList(options, {
       fields: "*items, *items.product, *items.product.thumbnail, *items.variant, *items.metadata, +total",
     }).catch(() => null)
@@ -989,7 +989,7 @@ export async function resumeAbandonedCart(cartId: string, countryCode: string) {
 
 export async function deleteCart(cartId: string) {
   try {
-    const options = await getStoreCartClientOptions()
+    const options = await getStoreClientOptions()
     await medusaCartDelete(cartId, options)
     
     revalidateTag("carts")