medusa-storefront-data 2.5.1 → 2.5.3

package/src/server/help-faq-section-defaults.json

@@ -0,0 +1,92 @@
+{
+  "eyebrow": "Knowledge Base",
+  "title": "Frequently Asked",
+  "titleHighlight": "Questions",
+  "subtitle": "Browse through our most common questions — organized by topic for easy navigation.",
+  "categories": [
+    {
+      "category": "Order & Delivery",
+      "icon": "🚚",
+      "color": "from-blue-500 to-cyan-400",
+      "items": [
+        {
+          "question": "When will I receive my order?",
+          "answer": "Orders are typically processed within 1-2 business days. Delivery takes 3-5 business days depending on your location. Express delivery options may be available at checkout."
+        },
+        {
+          "question": "How can I track my order?",
+          "answer": "Once your order ships, you will receive a tracking link via email and SMS. You can also track your order anytime from your account dashboard under 'My Orders'."
+        },
+        {
+          "question": "Can I cancel or change my order?",
+          "answer": "You can cancel or change your order within 24 hours of placing it. Please contact our support team immediately or use the cancel option in your account. After 24 hours, the order may already be in processing."
+        },
+        {
+          "question": "Do you offer free shipping?",
+          "answer": "Yes! We offer free shipping on all orders above ₹999. For orders below this amount, a nominal shipping fee applies based on your delivery location and the chosen shipping method."
+        }
+      ]
+    },
+    {
+      "category": "Returns & Exchanges",
+      "icon": "📦",
+      "color": "from-emerald-500 to-teal-400",
+      "items": [
+        {
+          "question": "What is your return policy?",
+          "answer": "We offer a 7-day return policy for unused, unwashed items in their original packaging with tags attached. Items must be in their original condition to qualify for a return."
+        },
+        {
+          "question": "How do I initiate a return?",
+          "answer": "Go to your account, click on the specific order, and select 'Return Items'. Follow the instructions to generate a pickup request. Our team will schedule a pickup within 2 business days."
+        },
+        {
+          "question": "Do you offer exchanges?",
+          "answer": "Yes, you can request an exchange for a different size or color within 7 days of delivery, subject to availability. Exchange items must be in original condition with all tags intact."
+        },
+        {
+          "question": "When will I receive my exchanged item?",
+          "answer": "Once we receive and verify your returned item, the exchange will be dispatched within 2 business days. You'll receive a tracking link as soon as it ships."
+        }
+      ]
+    },
+    {
+      "category": "Payment & Refunds",
+      "icon": "💳",
+      "color": "from-violet-500 to-purple-400",
+      "items": [
+        {
+          "question": "When will I receive my refund?",
+          "answer": "Refunds are processed within 5-7 business days after we receive and inspect your returned items. The amount will be credited to your original payment method."
+        },
+        {
+          "question": "What payment methods do you accept?",
+          "answer": "We accept all major credit/debit cards, UPI, Net Banking, Wallets (Paytm, PhonePe, etc.), and Cash on Delivery (COD) for most PIN codes across India."
+        },
+        {
+          "question": "Is my payment information secure?",
+          "answer": "Absolutely! We use industry-standard SSL encryption and our payment gateway (Razorpay) is PCI-DSS compliant. We never store your card details on our servers."
+        }
+      ]
+    },
+    {
+      "category": "Product Inquiry",
+      "icon": "👗",
+      "color": "from-pink-500 to-rose-400",
+      "items": [
+        {
+          "question": "How do I find the right size for my child?",
+          "answer": "Each product page includes a detailed size chart with measurements in both cm and inches. We recommend measuring your child and comparing with our chart for the best fit. When in doubt, size up!"
+        },
+        {
+          "question": "Are products safe for kids?",
+          "answer": "Yes! All our products are certified child-safe. We use non-toxic, hypoallergenic dyes and materials that meet Indian safety standards for children's clothing. Safety is our top priority."
+        },
+        {
+          "question": "How should I care for the clothing?",
+          "answer": "Machine wash cold with like colors. Do not bleach. Tumble dry low or hang dry. Iron on low heat if needed. Detailed care instructions are printed on the garment's inner label."
+        }
+      ]
+    }
+  ]
+}

package/src/server/help-sections/help-faq.ts

@@ -0,0 +1,25 @@
+import "server-only"
+
+import {
+  getHelpFaqFromPageInput,
+  type HelpFaqCategory,
+  type HelpFaqConfig,
+  type HelpFaqSectionCopy,
+} from "../dynamic-config"
+import type { HomepageConfig } from "../homepage-config.types"
+
+export type { HelpFaqCategory, HelpFaqConfig, HelpFaqSectionCopy }
+
+export type HelpFaqSectionData = HelpFaqConfig
+
+export type HelpFaqSectionLoaderOptions = {
+  pageInput?: HomepageConfig | null
+}
+
+/** Help page FAQ block — `sections.helpFaq` + legacy `faq-array`. */
+export async function loadHelpFaqSectionData(
+  _countryCode: string,
+  options?: HelpFaqSectionLoaderOptions
+): Promise<HelpFaqSectionData> {
+  return getHelpFaqFromPageInput(options?.pageInput ?? null)
+}

package/src/server/help-sections/index.ts

@@ -0,0 +1,8 @@
+export {
+  loadHelpFaqSectionData,
+  type HelpFaqCategory,
+  type HelpFaqConfig,
+  type HelpFaqSectionCopy,
+  type HelpFaqSectionData,
+  type HelpFaqSectionLoaderOptions,
+} from "./help-faq"

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

@@ -138,6 +138,28 @@ export type HomepageBlogPostsSection = HomepageSectionCopyFields & {
   "blog-posts"?: HomepageBlogPost[]
 }
 
+export type HomepageHelpFaqItem = {
+  question?: string
+  answer?: string
+  q?: string
+  a?: string
+  faq?: HomepageHelpFaqItem
+}
+
+export type HomepageHelpFaqCategory = {
+  category?: string
+  name?: string
+  icon?: string
+  color?: string
+  items?: HomepageHelpFaqItem[]
+  faqs?: HomepageHelpFaqItem[]
+}
+
+export type HomepageHelpFaqSection = HomepageSectionCopyFields & {
+  titleHighlight?: string
+  categories?: HomepageHelpFaqCategory[]
+}
+
 export type HomepageInstagramPost = {
   id?: string
   image?: string
@@ -203,6 +225,7 @@ export type HomepageSectionsConfig = {
   lovedByMoms?: HomepageSectionCopyFields
   videoStories?: HomepageVideoStoriesSection
   blogPosts?: HomepageBlogPostsSection
+  helpFaq?: HomepageHelpFaqSection
   /** Allow kebab-case keys from legacy CMS */
   [sectionKey: string]: HomepageSectionCopyFields | undefined
 }
@@ -330,6 +353,7 @@ export const HOMEPAGE_SECTION_IDS = [
   "lovedByMoms",
   "videoStories",
   "blogPosts",
+  "helpFaq",
 ] as const
 
 export type HomepageSectionId = (typeof HOMEPAGE_SECTION_IDS)[number]

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

@@ -1,3 +1,5 @@
+import helpFaqDefaults from "./help-faq-section-defaults.json"
+
 /**
  * Default `homepage-config.sections` blocks.
  * Dynamic config overrides any field; unset fields keep these defaults.
@@ -161,6 +163,7 @@ export const DEFAULT_HOMEPAGE_SECTIONS = {
     title: "Watch Stories & Reviews",
     "video-urls": [],
   },
+  helpFaq: helpFaqDefaults as Record<string, unknown>,
   blogPosts: {
     title: "Blog posts",
     posts: [

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

@@ -195,6 +195,45 @@ function normalizeSections(sections: Loose): Loose {
     }
   }
 
+  const helpFaq = asObject(sections.helpFaq)
+  if (helpFaq) {
+    const categories = asArray(helpFaq.categories)
+      .map((row) => {
+        const cat = asObject((row as Loose)?.category) ?? asObject(row)
+        if (!cat) return null
+        const items = asArray(cat.items)
+          .map((item) => {
+            const faq = asObject((item as Loose)?.faq) ?? asObject(item)
+            if (!faq) return null
+            const question = String(
+              faq.question ?? faq["faq-question"] ?? ""
+            ).trim()
+            const answer = String(faq.answer ?? faq["faq-answer"] ?? "").trim()
+            if (!question || !answer) return null
+            return { question, answer }
+          })
+          .filter(Boolean)
+        const category = String(cat.category ?? cat.name ?? "").trim()
+        if (!category || items.length === 0) return null
+        return {
+          category,
+          icon: cat.icon,
+          color: cat.color,
+          items,
+        }
+      })
+      .filter(Boolean)
+    if (categories.length) {
+      out.helpFaq = {
+        eyebrow: helpFaq.eyebrow,
+        title: helpFaq.title,
+        titleHighlight: helpFaq.titleHighlight,
+        subtitle: helpFaq.subtitle ?? helpFaq.description,
+        categories,
+      }
+    }
+  }
+
   return out
 }
 

package/dist/segment-data/default-page-input.json

@@ -1,191 +0,0 @@
-{
-    "logo": "/Logo.png",
-    "website-description": "Premium kids fashion for everyday wear and special occasions.",
-    "homepage-banner-array": [
-        {
-            "homepage-banner": {
-                "homepage-banner-image": "/newbanner.png",
-                "homepage-banner-title": "Premium Kids Shop",
-                "homepage-banner-subtitle": "Little Trends, Quality Kids Wear",
-                "homepage-banner-description": "Shop stylish kids wear for little ones and children of all years—from newborn up to 15 years.",
-                "homepage-banner-button-name": "Shop Kids Wear",
-                "homepage-banner-button-link": "/store"
-            }
-        }
-    ],
-    "app-banner-array": [
-        {
-            "app-banner": {
-                "app-banner-image": "/appbanner.png",
-                "app-banner-title": "Premium Kids Shop",
-                "app-banner-subtitle": "Little Trends, Quality Kids Wear",
-                "app-banner-description": "Shop stylish kids wear for little ones and children of all years—from newborn up to 15 years.",
-                "app-banner-button-name": "Shop Kids Wear",
-                "app-banner-button-link": "/store"
-            }
-        }
-    ],
-    "promo-bar": {
-        "promo-text": null,
-        "promo-code": null,
-        "promo-active": false
-    },
-    "contact-us": {
-        "contact-phone": "+1 000 000 0000",
-        "contact-email": "hello@yourstore.com",
-        "contact-address": "Your store address"
-    },
-    "social-links": [],
-    "faq-array": [],
-    "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",
-            "variant": "grid"
-        },
-        "newArrivalsClassic": {
-            "title": "New Arrivals",
-            "subtitle": "Fresh styles just landed",
-            "variant": "classic"
-        },
-        "promoCountdown": {
-            "code": "SAVE50",
-            "text": "Up to 50% off — shop your favourites before they're gone!",
-            "end-at": "2026-12-31T23:59:59.000Z",
-            "active": false,
-            "cta-label": "Shop Offers",
-            "cta-href": "/store"
-        },
-        "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",
-            "looks": []
-        },
-        "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",
-            "items": [
-                {
-                    "text": "Amazing place if you are looking for a dress for ur little girl's special day.",
-                    "name": "Greeshma thottippal shanmughan"
-                },
-                {
-                    "text": "I frequently buy dresses for my baby from this store and I am extremely satisfied with the purchase.",
-                    "name": "Priyanka Rajesh"
-                }
-            ]
-        },
-        "instagramPosts": {
-            "title": "Follow Us on Instagram",
-            "handle": "yourbrand",
-            "profile-url": "https://www.instagram.com/yourbrand/",
-            "profile-image": "/Logo.png",
-            "posts": []
-        },
-        "brandPillars": {
-            "title": "This approach resulted in the beautiful structure",
-            "pillars": [
-                {
-                    "title": "Your favorite kids destination",
-                    "description": "Trendy, high-quality outfits for little ones.",
-                    "image": "/features/store.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"
-                }
-            ]
-        },
-        "whyChooseUs": {
-            "title": "Why Choose Us?",
-            "features": [
-                {
-                    "feature-name": "Premium Quality",
-                    "feature-icon": "/icons/quality.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"
-                }
-            ]
-        }
-    }
-}

package/dist/src/config.d.ts

@@ -1,3 +0,0 @@
-import Medusa from "@medusajs/js-sdk";
-export declare const sdk: Medusa;
-//# sourceMappingURL=config.d.ts.map

package/dist/src/config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AACA,OAAO,MAAiC,MAAM,kBAAkB,CAAA;AAShE,eAAO,MAAM,GAAG,QAId,CAAA"}

package/dist/src/config.js

@@ -1,31 +0,0 @@
-import { getLocaleHeader } from "./util/get-locale-header";
-import Medusa from "@medusajs/js-sdk";
-// Defaults to standard port for Medusa server
-let MEDUSA_BACKEND_URL = "http://localhost:9000";
-if (process.env.MEDUSA_BACKEND_URL) {
-    MEDUSA_BACKEND_URL = process.env.MEDUSA_BACKEND_URL;
-}
-export const sdk = new Medusa({
-    baseUrl: MEDUSA_BACKEND_URL,
-    debug: process.env.NODE_ENV === "development",
-    publishableKey: process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY,
-});
-const originalFetch = sdk.client.fetch.bind(sdk.client);
-sdk.client.fetch = async (input, init) => {
-    const headers = init?.headers ?? {};
-    let localeHeader;
-    try {
-        localeHeader = await getLocaleHeader();
-        headers["x-medusa-locale"] ??= localeHeader["x-medusa-locale"];
-    }
-    catch { }
-    const newHeaders = {
-        ...localeHeader,
-        ...headers,
-    };
-    init = {
-        ...init,
-        headers: newHeaders,
-    };
-    return originalFetch(input, init);
-};

package/dist/src/cookies.d.ts

@@ -1,23 +0,0 @@
-import "server-only";
-export declare const getAuthHeaders: () => Promise<{
-    authorization: string;
-} | {}>;
-export declare const getGuestAuthHeaders: () => Promise<{
-    authorization: string;
-} | {}>;
-export declare const getCacheTag: (tag: string) => Promise<string>;
-export declare const getCacheOptions: (tag: string) => Promise<{
-    tags: string[];
-} | {}>;
-export declare const setAuthToken: (token: string) => Promise<void>;
-export declare const removeAuthToken: () => Promise<void>;
-export declare const getCartId: () => Promise<string | undefined>;
-export declare const setCartId: (cartId: string) => Promise<void>;
-export declare const removeCartId: () => Promise<void>;
-export declare const removeSyncLock: () => Promise<void>;
-export declare const setHoldCartId: (cartId: string) => Promise<void>;
-export declare const getHoldCartId: () => Promise<string | undefined>;
-export declare const removeHoldCartId: () => Promise<void>;
-export declare const setBuyNowCartId: (cartId: string) => Promise<void>;
-export declare const removeBuyNowCartId: () => Promise<void>;
-//# sourceMappingURL=cookies.d.ts.map

package/dist/src/cookies.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../src/cookies.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAA;AAGpB,eAAO,MAAM,cAAc,QAAa,OAAO,CAC7C;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,EAAE,CAc/B,CAAA;AAED,eAAO,MAAM,mBAAmB,QAAa,OAAO,CAClD;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,EAAE,CAc/B,CAAA;AAED,eAAO,MAAM,WAAW,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,MAAM,CAa7D,CAAA;AAED,eAAO,MAAM,eAAe,GAC1B,KAAK,MAAM,KACV,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,EAAE,CAYjC,CAAA;AAED,eAAO,MAAM,YAAY,GAAU,OAAO,MAAM,kBAQ/C,CAAA;AAED,eAAO,MAAM,eAAe,qBAK3B,CAAA;AAED,eAAO,MAAM,SAAS,mCAsBrB,CAAA;AAED,eAAO,MAAM,SAAS,GAAU,QAAQ,MAAM,kBAQ7C,CAAA;AAED,eAAO,MAAM,YAAY,qBAKxB,CAAA;AAED,eAAO,MAAM,cAAc,qBAK1B,CAAA;AAED,eAAO,MAAM,aAAa,GAAU,QAAQ,MAAM,kBAQjD,CAAA;AAED,eAAO,MAAM,aAAa,mCAGzB,CAAA;AAED,eAAO,MAAM,gBAAgB,qBAK5B,CAAA;AAED,eAAO,MAAM,eAAe,GAAU,QAAQ,MAAM,kBAQnD,CAAA;AAED,eAAO,MAAM,kBAAkB,qBAK9B,CAAA"}

package/dist/src/cookies.js

@@ -1,140 +0,0 @@
-import "server-only";
-import { cookies as nextCookies, headers } from "next/headers";
-export const getAuthHeaders = async () => {
-    try {
-        const cookies = await nextCookies();
-        const token = cookies.get("_medusa_jwt")?.value;
-        if (!token) {
-            return {};
-        }
-        return { authorization: `Bearer ${token}` };
-    }
-    catch {
-        return {};
-    }
-};
-export const getGuestAuthHeaders = async () => {
-    try {
-        const cookies = await nextCookies();
-        const token = cookies.get("_medusa_guest_jwt")?.value;
-        if (!token) {
-            return {};
-        }
-        return { authorization: `Bearer ${token}` };
-    }
-    catch {
-        return {};
-    }
-};
-export const getCacheTag = async (tag) => {
-    try {
-        const cookies = await nextCookies();
-        const cacheId = cookies.get("_medusa_cache_id")?.value;
-        if (!cacheId) {
-            return "";
-        }
-        return `${tag}-${cacheId}`;
-    }
-    catch (error) {
-        return "";
-    }
-};
-export const getCacheOptions = async (tag) => {
-    if (typeof window !== "undefined") {
-        return {};
-    }
-    const cacheTag = await getCacheTag(tag);
-    if (!cacheTag) {
-        return {};
-    }
-    return { tags: [`${cacheTag}`] };
-};
-export const setAuthToken = async (token) => {
-    const cookies = await nextCookies();
-    cookies.set("_medusa_jwt", token, {
-        maxAge: 60 * 60 * 24 * 7,
-        httpOnly: true,
-        sameSite: "strict",
-        secure: process.env.NODE_ENV === "production",
-    });
-};
-export const removeAuthToken = async () => {
-    const cookies = await nextCookies();
-    cookies.set("_medusa_jwt", "", {
-        maxAge: -1,
-    });
-};
-export const getCartId = async () => {
-    const cookies = await nextCookies();
-    const headerList = await headers();
-    // Check for x-cart-id header FIRST (as it's the most up-to-date from middleware)
-    const headerId = headerList.get("x-cart-id");
-    if (headerId) {
-        return headerId;
-    }
-    // Prioritize buy_now_cart_id if it exists
-    const buyNowId = cookies.get("buy_now_cart_id")?.value;
-    if (buyNowId) {
-        return buyNowId;
-    }
-    // Fallback to regular cart cookies
-    const id = cookies.get("_medusa_cart_id")?.value ||
-        cookies.get("cart_id")?.value ||
-        cookies.get("medusa_cart_id")?.value;
-    return id;
-};
-export const setCartId = async (cartId) => {
-    const cookies = await nextCookies();
-    cookies.set("_medusa_cart_id", cartId, {
-        maxAge: 60 * 60 * 24 * 7,
-        httpOnly: true,
-        sameSite: "strict",
-        secure: process.env.NODE_ENV === "production",
-    });
-};
-export const removeCartId = async () => {
-    const cookies = await nextCookies();
-    cookies.set("_medusa_cart_id", "", {
-        maxAge: -1,
-    });
-};
-export const removeSyncLock = async () => {
-    const cookies = await nextCookies();
-    cookies.set("_medusa_cart_synced", "", {
-        maxAge: -1,
-    });
-};
-export const setHoldCartId = async (cartId) => {
-    const cookies = await nextCookies();
-    cookies.set("_medusa_hold_cart_id", cartId, {
-        maxAge: 60 * 60 * 24,
-        httpOnly: true,
-        sameSite: "strict",
-        secure: process.env.NODE_ENV === "production",
-    });
-};
-export const getHoldCartId = async () => {
-    const cookies = await nextCookies();
-    return cookies.get("_medusa_hold_cart_id")?.value;
-};
-export const removeHoldCartId = async () => {
-    const cookies = await nextCookies();
-    cookies.set("_medusa_hold_cart_id", "", {
-        maxAge: -1,
-    });
-};
-export const setBuyNowCartId = async (cartId) => {
-    const cookies = await nextCookies();
-    cookies.set("buy_now_cart_id", cartId, {
-        maxAge: 60 * 60 * 24 * 7,
-        httpOnly: true,
-        sameSite: "strict",
-        secure: process.env.NODE_ENV === "production",
-    });
-};
-export const removeBuyNowCartId = async () => {
-    const cookies = await nextCookies();
-    cookies.set("buy_now_cart_id", "", {
-        maxAge: -1,
-    });
-};