medusa-storefront-data 2.3.0 → 2.5.1

package/dist/src/server/shoppable-looks.js

@@ -0,0 +1,136 @@
+import "server-only";
+import { sdk } from "../config";
+import { getRegion } from "./regions";
+import { DEFAULT_HOMEPAGE_SECTIONS } from "./homepage-section-defaults";
+import { getMergedSectionBlock } from "./dynamic-config";
+function parseLookRow(row) {
+    const nested = (row.look ?? row["shop-look"] ?? row);
+    const image = String(nested.image ?? nested["look-image"] ?? nested.thumbnail ?? "").trim();
+    if (!image)
+        return null;
+    const idsRaw = nested["product-ids"] ?? nested.productIds ?? nested.products;
+    const handlesRaw = nested["product-handles"] ?? nested.productHandles ?? nested.handles;
+    const productIds = [];
+    const productHandles = [];
+    if (Array.isArray(idsRaw)) {
+        idsRaw.forEach((entry) => {
+            if (typeof entry === "string" && entry.trim())
+                productIds.push(entry.trim());
+            if (entry && typeof entry === "object") {
+                const id = entry.id ?? entry["product-id"];
+                if (typeof id === "string" && id.trim())
+                    productIds.push(id.trim());
+            }
+        });
+    }
+    if (Array.isArray(handlesRaw)) {
+        handlesRaw.forEach((entry) => {
+            if (typeof entry === "string" && entry.trim())
+                productHandles.push(entry.trim());
+            if (entry && typeof entry === "object") {
+                const handle = entry.handle;
+                if (typeof handle === "string" && handle.trim())
+                    productHandles.push(handle.trim());
+            }
+        });
+    }
+    return { image, productIds, productHandles };
+}
+export function readShoppableLooksBlock(block) {
+    if (!block || typeof block !== "object")
+        return [];
+    const row = block;
+    const raw = row.looks ??
+        row["shop-looks"] ??
+        row["looks-array"] ??
+        row["baptism-picks"] ??
+        [];
+    if (!Array.isArray(raw))
+        return [];
+    return raw
+        .map((item) => {
+        if (!item || typeof item !== "object")
+            return null;
+        return parseLookRow(item);
+    })
+        .filter((x) => x !== null);
+}
+async function fetchProductsForLook(countryCode, productIds, productHandles) {
+    const region = await getRegion(countryCode);
+    if (!region?.id)
+        return [];
+    const fields = "*thumbnail,*images,*variants,*variants.calculated_price,*options,*options.values";
+    const byId = new Map();
+    if (productIds.length > 0) {
+        const { products } = await sdk.store.product.list({ id: productIds, region_id: region.id, fields, limit: productIds.length }, {});
+        products.forEach((p) => {
+            if (p.id)
+                byId.set(p.id, p);
+        });
+    }
+    for (const handle of productHandles) {
+        if (byId.has(handle))
+            continue;
+        try {
+            const { products } = await sdk.store.product.list({ handle, region_id: region.id, fields, limit: 1 }, {});
+            const product = products?.[0];
+            if (product?.id)
+                byId.set(product.id, product);
+        }
+        catch {
+            /* skip */
+        }
+    }
+    const ordered = [];
+    for (const id of productIds) {
+        const p = byId.get(id);
+        if (p)
+            ordered.push(p);
+    }
+    for (const handle of productHandles) {
+        const p = Array.from(byId.values()).find((x) => x.handle === handle);
+        if (p && !ordered.some((o) => o.id === p.id))
+            ordered.push(p);
+    }
+    return ordered;
+}
+export function looksFromProducts(products) {
+    return products
+        .map((product, index) => {
+        const image = product.metadata?.look_image ??
+            product.thumbnail ??
+            product.images?.[0]?.url ??
+            "";
+        if (!image)
+            return null;
+        return {
+            id: product.id ?? `look-${index}`,
+            image,
+            products: [product],
+        };
+    })
+        .filter((x) => x !== null);
+}
+export async function getBaptismPicksLooks(countryCode, fallbackProducts, pageInput) {
+    const block = getMergedSectionBlock("baptismPicks", pageInput);
+    let configs = readShoppableLooksBlock(block);
+    if (configs.length === 0) {
+        configs = readShoppableLooksBlock(DEFAULT_HOMEPAGE_SECTIONS.baptismPicks);
+    }
+    if (configs.length === 0) {
+        return looksFromProducts(fallbackProducts);
+    }
+    const looks = [];
+    for (let i = 0; i < configs.length; i++) {
+        const config = configs[i];
+        const products = await fetchProductsForLook(countryCode, config.productIds, config.productHandles);
+        if (products.length === 0)
+            continue;
+        looks.push({
+            id: `look-${i}`,
+            image: config.image,
+            products,
+        });
+    }
+    return looks.length > 0 ? looks : looksFromProducts(fallbackProducts);
+}

package/dist/src/server/swaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swaps.d.ts","sourceRoot":"","sources":["../../../src/server/swaps.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CACrC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,YAAY,eAAe,EAC3B,UAAU,QAAQ,KACjB,OAAO,CAAC,eAAe,CAsEzB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,GAAU,UAAU,MAAM,mEAoB/C,CAAA"}

package/dist/src/server/variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variants.d.ts","sourceRoot":"","sources":["../../../src/server/variants.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAI3C,eAAO,MAAM,eAAe,GAC1B,YAAY,MAAM,KACjB,OAAO,CAAC,SAAS,CAAC,mBAAmB,GAAG,IAAI,CAU9C,CAAA"}

package/dist/src/server/wishlist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wishlist.d.ts","sourceRoot":"","sources":["../../../src/server/wishlist.ts"],"names":[],"mappings":"AAOA,mEAAmE;AACnE,wBAAsB,WAAW,CAAC,cAAc,UAAO,EAAE,WAAW,CAAC,EAAE,MAAM;;;UAGF,OAAO,EAAE;;;;;GAoDnF"}

package/dist/src/util/get-locale-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-locale-header.d.ts","sourceRoot":"","sources":["../../../src/util/get-locale-header.ts"],"names":[],"mappings":"AAEA,wBAAsB,eAAe;;GAKpC"}

package/dist/src/util/medusa-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"medusa-error.d.ts","sourceRoot":"","sources":["../../../src/util/medusa-error.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,CAkBrD"}

package/dist/src/util/revalidate-cart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revalidate-cart.d.ts","sourceRoot":"","sources":["../../../src/util/revalidate-cart.ts"],"names":[],"mappings":"AAGA,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMxD"}

package/dist/src/util/sort-products.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-products.d.ts","sourceRoot":"","sources":["../../../src/util/sort-products.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/{util → src/util}/store-client.d.ts

@@ -4,8 +4,6 @@ import { type MedusaAuthClientOptions } from "medusa-services/auth";
  * Builds portable Medusa store client options from Next.js cookies and env.
  */
 export declare function getStoreClientOptions(): Promise<MedusaStoreClientOptions>;
-/** @deprecated Use getStoreClientOptions */
-export declare const getStoreCartClientOptions: typeof getStoreClientOptions;
 export declare function getMedusaBackendUrl(): string;
 export declare function getGuestStoreClientOptions(): Promise<MedusaStoreClientOptions | null>;
 export declare function getStoreClientOptionsWithToken(token: string): Promise<MedusaStoreClientOptions>;

package/dist/src/util/store-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-client.d.ts","sourceRoot":"","sources":["../../../src/util/store-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AACzE,OAAO,EAAuB,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAqBxF;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAY/E;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAuB3F;AAED,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,wBAAwB,CAAC,CAMnC;AAED,wBAAsB,oBAAoB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAWnG"}

package/dist/{util → src/util}/store-client.js

@@ -29,8 +29,6 @@ export async function getStoreClientOptions() {
             : undefined,
     };
 }
-/** @deprecated Use getStoreClientOptions */
-export const getStoreCartClientOptions = getStoreClientOptions;
 export function getMedusaBackendUrl() {
     return getBackendUrl();
 }

package/homepage-config.example.json

@@ -0,0 +1,209 @@
+{
+  "_comment": "Paste under dynamic-config value as homepage-config. Omitted fields use medusa-storefront-data package defaults.",
+  "homepage-config": {
+    "logo": "/Logo.png",
+    "website-description": "Premium kids fashion for everyday wear and special occasions.",
+
+    "homepage-banner-array": [
+      {
+        "homepage-banner": {
+          "homepage-banner-image": "/banners/hero-1.jpg",
+          "homepage-banner-title": "New Collection",
+          "homepage-banner-subtitle": "Shop the latest styles",
+          "homepage-banner-description": "Discover outfits for every celebration.",
+          "homepage-banner-button-name": "Shop Now",
+          "homepage-banner-button-link": "/store"
+        }
+      }
+    ],
+
+    "promo-bar": {
+      "promo-text": "Free shipping on orders over $99",
+      "promo-code": "FREESHIP",
+      "promo-active": false
+    },
+
+    "contact-us": {
+      "contact-phone": "+1 000 000 0000",
+      "contact-email": "hello@yourstore.com",
+      "contact-address": "Your store address"
+    },
+
+    "social-links": [
+      {
+        "social-link": {
+          "social-platform-name": "Instagram",
+          "social-platform-icon": "/icons/instagram.svg",
+          "social-platform-url": "https://www.instagram.com/yourbrand/"
+        }
+      }
+    ],
+
+    "ratings": [
+      {
+        "text": "Beautiful quality and fast delivery.",
+        "name": "Happy Customer",
+        "rating": 5
+      }
+    ],
+
+    "sections": {
+      "promoAnnouncements": {
+        "messages": [
+          "Free shipping on orders over a threshold",
+          "Worldwide shipping available"
+        ]
+      },
+
+      "newArrivals": {
+        "title": "New Arrivals",
+        "subtitle": "Fresh styles just landed",
+        "variant": "grid"
+      },
+
+      "newArrivalsClassic": {
+        "title": "New Arrivals",
+        "subtitle": "Classic product preview layout",
+        "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": true,
+        "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": [
+          {
+            "image": "https://your-cdn.com/looks/baptism-1.jpg",
+            "product-ids": ["prod_REPLACE_ME_1", "prod_REPLACE_ME_2"]
+          },
+          {
+            "image": "https://your-cdn.com/looks/baptism-2.jpg",
+            "product-handles": ["off-white-baptism-gown"]
+          }
+        ]
+      },
+
+      "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.",
+        "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": "Your review text here.",
+            "name": "Customer Name",
+            "rating": 5
+          }
+        ]
+      },
+
+      "brandPillars": {
+        "title": "Why families choose us",
+        "pillars": [
+          {
+            "title": "Your favorite kids destination",
+            "description": "Trendy, high-quality outfits for little ones.",
+            "image": "/features/store.jpg"
+          }
+        ]
+      },
+
+      "instagramPosts": {
+        "title": "Follow Us on Instagram",
+        "handle": "yourbrand",
+        "profile-url": "https://www.instagram.com/yourbrand/",
+        "profile-image": "/Logo.png",
+        "posts": [
+          {
+            "image": "https://your-cdn.com/instagram/post-1.jpg",
+            "url": "https://www.instagram.com/p/EXAMPLE/"
+          }
+        ]
+      },
+
+      "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" }
+        ]
+      },
+
+      "videoStories": {
+        "title": "Watch Stories & Reviews",
+        "video-urls": [
+          "https://your-cdn.com/videos/story-1.mp4",
+          {
+            "video-story": {
+              "video-url": "https://your-cdn.com/videos/story-2.mp4"
+            }
+          }
+        ]
+      },
+
+      "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/homepage-sections.example.json

@@ -0,0 +1,55 @@
+{
+  "_comment": "Minimal sections override. Full backend template: homepage-config.example.json. Docs: HOMEPAGE_CONFIG.md",
+  "homepage-config": {
+    "sections": {
+      "newArrivals": {
+        "title": "New Arrivals",
+        "subtitle": "Your custom subtitle from CMS",
+        "variant": "grid"
+      },
+      "newArrivalsClassic": {
+        "title": "New Arrivals",
+        "subtitle": "Classic ProductPreview layout",
+        "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": true,
+        "cta-label": "Shop Offers",
+        "cta-href": "/store"
+      },
+      "promoAnnouncements": {
+        "messages": [
+          "Custom announcement line 1",
+          "Custom announcement line 2"
+        ]
+      },
+      "testimonials": {
+        "title": "What Clients Talk About Us",
+        "description": "The Trust We've Earned",
+        "items": [
+          {
+            "text": "Your review text here.",
+            "name": "Customer Name"
+          }
+        ]
+      },
+      "baptismPicks": {
+        "title": "Baptism Picks",
+        "looks": [
+          {
+            "image": "https://your-cdn.com/looks/baptism-1.jpg",
+            "product-ids": ["prod_REPLACE_ME_1", "prod_REPLACE_ME_2"]
+          },
+          {
+            "image": "https://your-cdn.com/looks/baptism-2.jpg",
+            "product-handles": ["off-white-baptism-gown"]
+          }
+        ]
+      }
+    },
+    "ratings": []
+  }
+}