@numueg/theme-sdk 0.12.0 → 0.13.0

package/dist/index.mjs

@@ -1,5 +1,5 @@
 export { resolveThemeSettings } from './chunk-XF2FGIVS.mjs';
-export { KNOWN_SETTING_TYPES, KNOWN_TEMPLATES, REQUIRED_TEMPLATES, SDK_VERSION, THEME_CONTRACT_VERSION, mergeResults, validateBuiltManifest, validateManifest, validateSectionSchema, validateSettingsAgainstSchema } from './chunk-ZECKSIDL.mjs';
+export { KNOWN_SETTING_TYPES, KNOWN_TEMPLATES, REQUIRED_TEMPLATES, SDK_VERSION, THEME_CONTRACT_VERSION, mergeResults, validateBuiltManifest, validateManifest, validateSectionSchema, validateSettingsAgainstSchema } from './chunk-QPXMBK5U.mjs';
 import { ShopContext, ThemeSettingsContext, CurrentTemplateContext, PageContext, LocalizationContext, CurrencyContext, CartContext, CustomerContext, NavigationContext, CollectionContext, ProductContext, useShop, useLocalization, useCustomer, useThemeSettings } from './chunk-ZYZZG4JR.mjs';
 export { CartContext, CollectionContext, CurrencyContext, CustomerContext, LocalizationContext, NavigationContext, PageContext, ProductContext, ShopContext, ThemeSettingsContext, useCollections, useCustomer, useDirection, useFieldTranslation, useLocale, useLocalization, useNumberFormat, usePage, useProducts, useShop, useThemeSettings, useTranslation } from './chunk-ZYZZG4JR.mjs';
 import { createContext, forwardRef, useState, useImperativeHandle, useEffect, useCallback, useMemo, useRef, useContext, useSyncExternalStore, StrictMode, createElement, Component } from 'react';
@@ -1022,6 +1022,133 @@ function useRelatedProducts(productId, options = {}) {
   });
   return { items: data ?? EMPTY4, loading: isLoading, error: error ?? null };
 }
+function useActivePromotions(page = "/", locale = "ar") {
+  const key = `numu:promotions:${page}:${locale}`;
+  const fetcher = useCallback(
+    async (signal) => {
+      const qs = new URLSearchParams({ page, locale });
+      const res = await fetch(`/api/storefront/promotions?${qs.toString()}`, {
+        credentials: "include",
+        cache: "no-store",
+        signal
+      });
+      if (!res.ok) return null;
+      const json = await res.json();
+      if (!json) return null;
+      return (json.data ?? json) || null;
+    },
+    [page, locale]
+  );
+  const { data } = useCachedResource(
+    key,
+    fetcher,
+    { initialData: null }
+  );
+  return data ?? null;
+}
+
+// src/utils/money.ts
+function resolveLocale(locale) {
+  return locale === "ar" ? "ar-EG" : "en-EG";
+}
+function formatMoney(cents, options = {}) {
+  const { currency, locale, fractionDigits = 0 } = options;
+  const safe = Number.isFinite(cents) ? cents : 0;
+  return new Intl.NumberFormat(resolveLocale(locale), {
+    style: "currency",
+    currency: currency || "EGP",
+    maximumFractionDigits: fractionDigits
+  }).format(safe / 100);
+}
+function formatMoneyMajor(amount, options = {}) {
+  return formatMoney(
+    (Number.isFinite(amount) ? amount : 0) * 100,
+    options
+  );
+}
+function centsToMajor(cents) {
+  return (Number.isFinite(cents) ? cents : 0) / 100;
+}
+function majorToCents(amount) {
+  return Math.round((Number.isFinite(amount) ? amount : 0) * 100);
+}
+
+// src/lib/promotions.ts
+function multibuyOffers(promotions) {
+  if (!promotions) return [];
+  const list = Array.isArray(promotions) ? promotions : promotions.auto_discounts ?? [];
+  const offers = [];
+  for (const promo of list) {
+    const rule = promo?.discount_rule;
+    if (!rule || rule.kind !== "multibuy") continue;
+    const quantity = rule.multibuy_quantity;
+    const groupPriceCents = rule.multibuy_price_cents;
+    if (typeof quantity !== "number" || quantity < 2) continue;
+    if (typeof groupPriceCents !== "number" || groupPriceCents <= 0) continue;
+    const eligibleProductIds = promo.eligible_product_ids ?? [];
+    const eligibleCategoryIds = promo.eligible_category_ids ?? [];
+    offers.push({
+      promotionId: promo.promotion_id,
+      quantity,
+      groupPriceCents,
+      groupPriceMajor: centsToMajor(groupPriceCents),
+      headline: promo.translated_content?.headline,
+      eligibleProductIds,
+      eligibleCategoryIds,
+      // No scoping rows at all ⇒ every product qualifies. Note an older
+      // backend that doesn't send these fields also lands here, which is the
+      // right default: counting everything is what themes did before.
+      isStoreWide: eligibleProductIds.length === 0 && eligibleCategoryIds.length === 0,
+      raw: promo
+    });
+  }
+  return offers;
+}
+function offerIncludesProduct(offer, product) {
+  if (!offer) return false;
+  if (offer.isStoreWide) return true;
+  const id = product?.product_id ?? product?.id;
+  if (id && offer.eligibleProductIds.includes(id)) return true;
+  const category = product?.category_id;
+  return Boolean(category && offer.eligibleCategoryIds.includes(category));
+}
+function eligibleUnitsInCart(offer, cart) {
+  if (!offer) return 0;
+  return (cart?.items ?? []).reduce((sum, item) => {
+    if (!item) return sum;
+    if (!offerIncludesProduct(offer, item)) return sum;
+    return sum + (item.quantity || 0);
+  }, 0);
+}
+function offerProgress(offer, cart, eligibleUnits) {
+  const empty = {
+    unitsInCart: 0,
+    unitsNeeded: 0,
+    groupsUnlocked: 0,
+    savingMajor: 0
+  };
+  if (!offer) return empty;
+  const unitsInCart = typeof eligibleUnits === "number" ? Math.max(0, eligibleUnits) : eligibleUnitsInCart(offer, cart);
+  const groupsUnlocked = Math.floor(unitsInCart / offer.quantity);
+  const remainder = unitsInCart % offer.quantity;
+  const unitsNeeded = remainder === 0 ? 0 : offer.quantity - remainder;
+  const applied = (cart?.applied_promotions ?? []).find(
+    (p) => p && p.id === offer.promotionId
+  );
+  return {
+    unitsInCart,
+    unitsNeeded,
+    groupsUnlocked,
+    savingMajor: applied ? applied.amount || 0 : 0
+  };
+}
+function offerBeatsRegularPrice(offer, unitPriceMajor) {
+  if (!offer || typeof unitPriceMajor !== "number" || unitPriceMajor <= 0) {
+    return false;
+  }
+  const unitCents = Math.round(unitPriceMajor * 100);
+  return unitCents * offer.quantity > offer.groupPriceCents;
+}
 function useProductSizeChart(productOverride) {
   const ctxProduct = useProductOptional();
   const product = productOverride ?? ctxProduct;
@@ -1495,11 +1622,27 @@ var EMPTY_CART = {
 };
 function normalizeCartFromServer(cart) {
   const toMajor = (n) => typeof n === "number" ? n / 100 : 0;
+  const { automatic_discount_cents: wireAutomaticCents, ...rest } = cart;
   return {
-    ...cart,
+    ...rest,
     subtotal: toMajor(cart.subtotal),
     total: toMajor(cart.total),
     ...cart.discount_amount != null ? { discount_amount: toMajor(cart.discount_amount) } : {},
+    // Offers-v2 automatic promotions. These MUST be converted here too —
+    // they arrive in cents next to already-major totals, so forwarding them
+    // raw makes every theme render a saving 100x too large. This function is
+    // the one and only cents→major boundary for the cart.
+    //
+    // The backend field is `automatic_discount_cents`; themes get
+    // `automatic_discount` (major), because a `_cents` name holding pounds
+    // invites exactly the double-divide this conversion exists to prevent.
+    ...wireAutomaticCents != null ? { automatic_discount: toMajor(wireAutomaticCents) } : {},
+    ...Array.isArray(cart.applied_promotions) ? {
+      applied_promotions: cart.applied_promotions.map((p) => ({
+        ...p,
+        amount: toMajor(p.amount)
+      }))
+    } : {},
     items: Array.isArray(cart.items) ? cart.items.map((it) => {
       const raw = it;
       return {
@@ -3850,32 +3993,6 @@ function assetUrl(name) {
   return `${cleanBase}${filename}`;
 }
 
-// src/utils/money.ts
-function resolveLocale(locale) {
-  return locale === "ar" ? "ar-EG" : "en-EG";
-}
-function formatMoney(cents, options = {}) {
-  const { currency, locale, fractionDigits = 0 } = options;
-  const safe = Number.isFinite(cents) ? cents : 0;
-  return new Intl.NumberFormat(resolveLocale(locale), {
-    style: "currency",
-    currency: currency || "EGP",
-    maximumFractionDigits: fractionDigits
-  }).format(safe / 100);
-}
-function formatMoneyMajor(amount, options = {}) {
-  return formatMoney(
-    (Number.isFinite(amount) ? amount : 0) * 100,
-    options
-  );
-}
-function centsToMajor(cents) {
-  return (Number.isFinite(cents) ? cents : 0) / 100;
-}
-function majorToCents(amount) {
-  return Math.round((Number.isFinite(amount) ? amount : 0) * 100);
-}
-
 // src/utils/templates.ts
 function resolveSections(group) {
   if (!group) return [];
@@ -3964,6 +4081,6 @@ function buildLocaleBundle(modules) {
   return bundle;
 }
 
-export { AddToCartButton, Block, CollectionCard, CollectionProvider, CurrencySwitcher, EditableImage, EditableText, Form, HeroMedia, ICON_NAMES, Icon, IconMap, Image, LOGO_SHAPE_OPTIONS, LOGO_SIZE_OPTIONS, Link, LocaleSwitcher, Logo, MAX_BLOCK_DEPTH, Money, NAVIGATE_EVENT, NuMuProvider, ProductCard, ProductProvider, RichText, Section, SectionContext, applyGlobalStyleTokens, applyImageTransform, asImageTransform, assetUrl, availableValues, buildLocaleBundle, buildThemeElement, centsToMajor, clearSdkSingleton, collectBlocks, collectSections, collectionHref, computeGlobalStyleTokens, defaultVariant, defineBlock, defineSection, defineThemeEntry, dynamicSource, findVariantByOptions, flattenMessages, focalSrc, formatMoney, formatMoneyMajor, getReactSingleton, getSdkSingleton, isDefinedBlock, isDefinedSection, isDynamicSource, isSdkAvailable, logoImgStyle, logoStyleTokens, majorToCents, mountTheme, pickTranslations, productHref, publishVariantSelection, readVariantSelection, registerReactSingleton, registerSdkSingleton, requestNavigate, resolveDynamicValue, resolveFontStack, resolveSections, resolveSettingsMap, resolveSizeChart, resolveSourcePath, sanitizeHtml, selectChromeSections, selectTemplateSections, useAnalytics, useApp, useArticle, useArticles, useBlog, useBlogs, useCachedResource, useCart, useCheckout, useCollection, useCollectionOptional, useCurrency, useCurrentTemplate, useCustomerActions, useCustomerAddresses, useGiftCardBalance, useImage, useListingHeading, useMetafield, useMetafields, useMoney, useNavigation, useOrder, useOrders, useProduct, useProductOptional, useProductSizeChart, useRelatedProducts, useReorder, useResolvedSettings, useSearch, useSection, useSectionGroup, useSectionOptional, useShippingRates, useVariantSelection, useWishlist };
+export { AddToCartButton, Block, CollectionCard, CollectionProvider, CurrencySwitcher, EditableImage, EditableText, Form, HeroMedia, ICON_NAMES, Icon, IconMap, Image, LOGO_SHAPE_OPTIONS, LOGO_SIZE_OPTIONS, Link, LocaleSwitcher, Logo, MAX_BLOCK_DEPTH, Money, NAVIGATE_EVENT, NuMuProvider, ProductCard, ProductProvider, RichText, Section, SectionContext, applyGlobalStyleTokens, applyImageTransform, asImageTransform, assetUrl, availableValues, buildLocaleBundle, buildThemeElement, centsToMajor, clearSdkSingleton, collectBlocks, collectSections, collectionHref, computeGlobalStyleTokens, defaultVariant, defineBlock, defineSection, defineThemeEntry, dynamicSource, eligibleUnitsInCart, findVariantByOptions, flattenMessages, focalSrc, formatMoney, formatMoneyMajor, getReactSingleton, getSdkSingleton, isDefinedBlock, isDefinedSection, isDynamicSource, isSdkAvailable, logoImgStyle, logoStyleTokens, majorToCents, mountTheme, multibuyOffers, offerBeatsRegularPrice, offerIncludesProduct, offerProgress, pickTranslations, productHref, publishVariantSelection, readVariantSelection, registerReactSingleton, registerSdkSingleton, requestNavigate, resolveDynamicValue, resolveFontStack, resolveSections, resolveSettingsMap, resolveSizeChart, resolveSourcePath, sanitizeHtml, selectChromeSections, selectTemplateSections, useActivePromotions, useAnalytics, useApp, useArticle, useArticles, useBlog, useBlogs, useCachedResource, useCart, useCheckout, useCollection, useCollectionOptional, useCurrency, useCurrentTemplate, useCustomerActions, useCustomerAddresses, useGiftCardBalance, useImage, useListingHeading, useMetafield, useMetafields, useMoney, useNavigation, useOrder, useOrders, useProduct, useProductOptional, useProductSizeChart, useRelatedProducts, useReorder, useResolvedSettings, useSearch, useSection, useSectionGroup, useSectionOptional, useShippingRates, useVariantSelection, useWishlist };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map