@cimplify/sdk 0.8.5 → 0.8.7

package/dist/react.mjs

@@ -742,6 +742,110 @@ function CimplifyCheckout({
   ] });
 }
 
+// src/utils/price.ts
+var CURRENCY_SYMBOLS = {
+  // Major world currencies
+  USD: "$",
+  EUR: "\u20AC",
+  GBP: "\xA3",
+  JPY: "\xA5",
+  CNY: "\xA5",
+  CHF: "CHF",
+  CAD: "C$",
+  AUD: "A$",
+  NZD: "NZ$",
+  HKD: "HK$",
+  SGD: "S$",
+  INR: "\u20B9",
+  BRL: "R$",
+  MXN: "MX$",
+  KRW: "\u20A9",
+  RUB: "\u20BD",
+  TRY: "\u20BA",
+  THB: "\u0E3F",
+  PLN: "z\u0142",
+  SEK: "kr",
+  NOK: "kr",
+  DKK: "kr",
+  CZK: "K\u010D",
+  HUF: "Ft",
+  ILS: "\u20AA",
+  AED: "\u062F.\u0625",
+  SAR: "\uFDFC",
+  MYR: "RM",
+  PHP: "\u20B1",
+  IDR: "Rp",
+  VND: "\u20AB",
+  TWD: "NT$",
+  // African currencies
+  GHS: "GH\u20B5",
+  NGN: "\u20A6",
+  KES: "KSh",
+  ZAR: "R",
+  XOF: "CFA",
+  XAF: "FCFA",
+  EGP: "E\xA3",
+  MAD: "MAD",
+  TZS: "TSh",
+  UGX: "USh",
+  RWF: "FRw",
+  ETB: "Br",
+  ZMW: "ZK",
+  BWP: "P",
+  MUR: "\u20A8",
+  SCR: "\u20A8",
+  NAD: "N$",
+  SZL: "E",
+  LSL: "L",
+  MWK: "MK",
+  AOA: "Kz",
+  CDF: "FC",
+  GMD: "D",
+  GNF: "FG",
+  LRD: "L$",
+  SLL: "Le",
+  MZN: "MT",
+  SDG: "SDG",
+  SSP: "SSP",
+  SOS: "Sh.So.",
+  DJF: "Fdj",
+  ERN: "Nfk",
+  CVE: "$",
+  STN: "Db",
+  KMF: "CF",
+  BIF: "FBu"
+};
+function getCurrencySymbol(currencyCode2) {
+  return CURRENCY_SYMBOLS[currencyCode2.toUpperCase()] || currencyCode2;
+}
+function formatPrice(amount, currency = "GHS", locale = "en-US") {
+  const numAmount = typeof amount === "string" ? parseFloat(amount) : amount;
+  if (isNaN(numAmount)) {
+    return `${getCurrencySymbol(currency)}0.00`;
+  }
+  try {
+    return new Intl.NumberFormat(locale, {
+      style: "currency",
+      currency: currency.toUpperCase(),
+      minimumFractionDigits: 2,
+      maximumFractionDigits: 2
+    }).format(numAmount);
+  } catch {
+    return `${getCurrencySymbol(currency)}${numAmount.toFixed(2)}`;
+  }
+}
+function parsePrice(value) {
+  if (value === void 0 || value === null) {
+    return 0;
+  }
+  if (typeof value === "number") {
+    return isNaN(value) ? 0 : value;
+  }
+  const cleaned = value.replace(/[^\d.-]/g, "");
+  const parsed = parseFloat(cleaned);
+  return isNaN(parsed) ? 0 : parsed;
+}
+
 // src/types/common.ts
 function money(value) {
   return value;
@@ -1353,19 +1457,6 @@ var MOBILE_MONEY_PROVIDER = {
   AIRTEL: "airtel"
 };
 
-// src/utils/price.ts
-function parsePrice(value) {
-  if (value === void 0 || value === null) {
-    return 0;
-  }
-  if (typeof value === "number") {
-    return isNaN(value) ? 0 : value;
-  }
-  const cleaned = value.replace(/[^\d.-]/g, "");
-  const parsed = parseFloat(cleaned);
-  return isNaN(parsed) ? 0 : parsed;
-}
-
 // src/utils/payment.ts
 var PAYMENT_SUCCESS_STATUSES = /* @__PURE__ */ new Set([
   "success",
@@ -1557,6 +1648,10 @@ var DEFAULT_POLL_INTERVAL_MS = 3e3;
 var DEFAULT_MAX_POLL_ATTEMPTS = 60;
 var MAX_CONSECUTIVE_NETWORK_ERRORS = 5;
 var CARD_PROVIDER_PAYSTACK = "paystack";
+var NEXT_ACTION_NONE = "none";
+var NEXT_ACTION_CARD_POPUP = "card_popup";
+var NEXT_ACTION_REDIRECT = "redirect";
+var NEXT_ACTION_AUTHORIZATION = "authorization";
 function normalizeCardPopupError(error) {
   if (!error || error === "PAYMENT_CANCELLED" || error === "CANCELLED") {
     return "PAYMENT_CANCELLED";
@@ -1596,7 +1691,8 @@ function isValidMobileMoneyProvider(value) {
   return VALID_MOBILE_MONEY_PROVIDERS.has(value);
 }
 function normalizeAuthorizationType(value) {
-  return value === "otp" || value === "pin" ? value : void 0;
+  const lower = value?.toLowerCase();
+  return lower === "otp" || lower === "pin" ? lower : void 0;
 }
 function formatMoney2(value) {
   if (typeof value === "number" && Number.isFinite(value)) {
@@ -1643,6 +1739,9 @@ var CheckoutResolver = class {
       if (!checkoutResult.order_id) {
         return this.fail("CHECKOUT_FAILED", "Checkout did not return an order ID.", false);
       }
+      if (checkoutResult.next_action) {
+        return this.resolveNextAction(checkoutResult);
+      }
       let latestCheckoutResult = checkoutResult;
       let authorizationType = normalizeAuthorizationType(checkoutResult.authorization_type);
       let paymentReference = checkoutResult.payment_reference;
@@ -1758,6 +1857,110 @@ var CheckoutResolver = class {
       return this.fail("CHECKOUT_FAILED", message, true);
     }
   }
+  async resolveNextAction(checkoutResult) {
+    const action = checkoutResult.next_action;
+    if (this.isSuccessfulStatus(checkoutResult.payment_status)) {
+      return this.finalizeSuccess(checkoutResult);
+    }
+    let latestCheckoutResult = checkoutResult;
+    let paymentReference = checkoutResult.payment_reference;
+    switch (action.type) {
+      case NEXT_ACTION_NONE:
+        return this.finalizeSuccess(checkoutResult);
+      case NEXT_ACTION_CARD_POPUP: {
+        const provider = normalizeCardProvider(action.provider);
+        this.emit("awaiting_authorization", {
+          display_text: "Complete payment in the card authorization popup.",
+          order_id: checkoutResult.order_id,
+          order_number: checkoutResult.order_number
+        });
+        if (!this.allowPopups) {
+          return this.fail(
+            "PROVIDER_UNAVAILABLE",
+            "Card payment popup is unavailable in this environment.",
+            false
+          );
+        }
+        const popupResult = await openCardPopup(
+          provider,
+          checkoutResult,
+          this.checkoutData.customer.email || "customer@cimplify.io",
+          this.getOrderCurrency(checkoutResult),
+          this.signal
+        );
+        if (!popupResult.success) {
+          const popupError = normalizeCardPopupError(popupResult.error);
+          if (popupError === "POPUP_BLOCKED") {
+            return this.fail(
+              "POPUP_BLOCKED",
+              "Unable to open card payment popup. Please allow popups and try again.",
+              true
+            );
+          }
+          if (popupError === "PROVIDER_UNAVAILABLE") {
+            return this.fail("PROVIDER_UNAVAILABLE", "Card payment provider is unavailable.", false);
+          }
+          return this.fail("PAYMENT_CANCELLED", "Card payment was cancelled before completion.", true);
+        }
+        paymentReference = popupResult.reference || paymentReference;
+        break;
+      }
+      case NEXT_ACTION_REDIRECT: {
+        if (typeof window !== "undefined" && this.returnUrl) {
+          window.location.assign(action.authorization_url);
+          return this.fail("REDIRECT_REQUIRED", "Redirecting to complete payment authorization.", true);
+        }
+        if (typeof window !== "undefined") {
+          const popup = window.open(
+            action.authorization_url,
+            "cimplify-auth",
+            "width=520,height=760,noopener,noreferrer"
+          );
+          if (!popup) {
+            return this.fail(
+              "POPUP_BLOCKED",
+              "Authorization popup was blocked. Please allow popups and retry.",
+              true
+            );
+          }
+        }
+        break;
+      }
+      case NEXT_ACTION_AUTHORIZATION: {
+        const authType = normalizeAuthorizationType(action.authorization_type);
+        const authorization = await this.handleAuthorization({
+          authorizationType: authType,
+          paymentReference,
+          displayText: action.display_text,
+          provider: checkoutResult.provider
+        });
+        if (!authorization.ok) {
+          return authorization.result;
+        }
+        if (authorization.value) {
+          latestCheckoutResult = authorization.value;
+          paymentReference = authorization.value.payment_reference || paymentReference;
+          if (this.isSuccessfulStatus(authorization.value.payment_status)) {
+            return this.finalizeSuccess(authorization.value);
+          }
+          if (this.isFailureStatus(authorization.value.payment_status)) {
+            return this.fail(
+              "AUTHORIZATION_FAILED",
+              authorization.value.display_text || "Payment authorization failed.",
+              false
+            );
+          }
+        }
+        break;
+      }
+    }
+    return this.pollUntilTerminal({
+      orderId: checkoutResult.order_id,
+      latestCheckoutResult,
+      paymentReference,
+      authorizationType: normalizeAuthorizationType(checkoutResult.authorization_type)
+    });
+  }
   async pollUntilTerminal(input) {
     let consecutiveErrors = 0;
     let latestCheckoutResult = input.latestCheckoutResult;
@@ -4202,6 +4405,8 @@ function createCimplifyClient(config = {}) {
   return new CimplifyClient(config);
 }
 var LOCATION_STORAGE_KEY = "cimplify_location_id";
+var DISPLAY_CURRENCY_STORAGE_KEY = "cimplify_display_currency";
+var FX_REFRESH_INTERVAL = 12e4;
 var DEFAULT_CURRENCY = "USD";
 var DEFAULT_COUNTRY = "US";
 function createDefaultClient() {
@@ -4230,6 +4435,27 @@ function setStoredLocationId(locationId) {
   }
   window.localStorage.setItem(LOCATION_STORAGE_KEY, locationId);
 }
+function getStoredDisplayCurrency() {
+  if (typeof window === "undefined" || !window.localStorage) {
+    return null;
+  }
+  const value = window.localStorage.getItem(DISPLAY_CURRENCY_STORAGE_KEY);
+  if (!value) {
+    return null;
+  }
+  const normalized = value.trim().toUpperCase();
+  return normalized.length > 0 ? normalized : null;
+}
+function setStoredDisplayCurrency(currency) {
+  if (typeof window === "undefined" || !window.localStorage) {
+    return;
+  }
+  if (!currency) {
+    window.localStorage.removeItem(DISPLAY_CURRENCY_STORAGE_KEY);
+    return;
+  }
+  window.localStorage.setItem(DISPLAY_CURRENCY_STORAGE_KEY, currency.toUpperCase());
+}
 function resolveInitialLocation(locations) {
   if (locations.length === 0) {
     return null;
@@ -4259,6 +4485,54 @@ function CimplifyProvider({
     onLocationChangeRef.current = onLocationChange;
   }, [onLocationChange]);
   const isDemoMode = resolvedClient.getPublicKey().trim().length === 0;
+  const baseCurrency = business?.default_currency || DEFAULT_CURRENCY;
+  const [displayCurrencyOverride, setDisplayCurrencyOverride] = useState(
+    () => getStoredDisplayCurrency()
+  );
+  const [fxRate, setFxRate] = useState(null);
+  const displayCurrency = displayCurrencyOverride && displayCurrencyOverride !== baseCurrency ? displayCurrencyOverride : baseCurrency;
+  const setDisplayCurrency = useCallback(
+    (currency) => {
+      const normalized = currency?.trim().toUpperCase() || null;
+      setDisplayCurrencyOverride(normalized);
+      setStoredDisplayCurrency(normalized);
+      if (!normalized || normalized === baseCurrency) {
+        setFxRate(null);
+      }
+    },
+    [baseCurrency]
+  );
+  useEffect(() => {
+    if (displayCurrency === baseCurrency || isDemoMode) {
+      setFxRate(null);
+      return;
+    }
+    let cancelled = false;
+    async function fetchRate() {
+      const result = await resolvedClient.fx.getRate(
+        baseCurrency,
+        displayCurrency
+      );
+      if (!cancelled && result.ok) {
+        setFxRate(result.value.rate);
+      }
+    }
+    void fetchRate();
+    const intervalId = setInterval(() => void fetchRate(), FX_REFRESH_INTERVAL);
+    return () => {
+      cancelled = true;
+      clearInterval(intervalId);
+    };
+  }, [resolvedClient, baseCurrency, displayCurrency, isDemoMode]);
+  const convertPrice = useCallback(
+    (amount) => {
+      const num = typeof amount === "string" ? parseFloat(amount) : amount;
+      if (isNaN(num)) return 0;
+      if (!fxRate || displayCurrency === baseCurrency) return num;
+      return Math.round(num * fxRate * 100) / 100;
+    },
+    [fxRate, displayCurrency, baseCurrency]
+  );
   const setCurrentLocation = useCallback(
     (location) => {
       setCurrentLocationState(location);
@@ -4328,22 +4602,32 @@ function CimplifyProvider({
     () => ({
       client: resolvedClient,
       business,
-      currency: business?.default_currency || DEFAULT_CURRENCY,
+      currency: baseCurrency,
       country: business?.country_code || DEFAULT_COUNTRY,
       locations,
       currentLocation,
       setCurrentLocation,
       isReady,
-      isDemoMode
+      isDemoMode,
+      baseCurrency,
+      displayCurrency,
+      setDisplayCurrency,
+      convertPrice,
+      fxRate
     }),
     [
       resolvedClient,
       business,
+      baseCurrency,
       locations,
       currentLocation,
       setCurrentLocation,
       isReady,
-      isDemoMode
+      isDemoMode,
+      displayCurrency,
+      setDisplayCurrency,
+      convertPrice,
+      fxRate
     ]
   );
   return /* @__PURE__ */ jsx(CimplifyContext.Provider, { value: contextValue, children });
@@ -4358,6 +4642,13 @@ function useCimplify() {
 function useOptionalCimplify() {
   return useContext(CimplifyContext);
 }
+function Price({ amount, className, prefix }) {
+  const { displayCurrency, convertPrice } = useCimplify();
+  return /* @__PURE__ */ jsxs("span", { className, children: [
+    prefix,
+    formatPrice(convertPrice(amount), displayCurrency)
+  ] });
+}
 var productsCache = /* @__PURE__ */ new Map();
 var productsInflight = /* @__PURE__ */ new Map();
 function buildProductsCacheKey(client, locationId, options) {
@@ -6387,4 +6678,4 @@ function useCheckout() {
   return { submit, process, isLoading };
 }
 
-export { Ad, AdProvider, AddressElement, AuthElement, CimplifyCheckout, CimplifyProvider, ElementsProvider, PaymentElement, useAds, useBundle, useCart, useCategories, useCheckout, useCimplify, useCollection, useCollections, useComposite, useElements, useElementsReady, useLocations, useOptionalCimplify, useOrder, useProduct, useProducts, useQuote, useSearch };
+export { Ad, AdProvider, AddressElement, AuthElement, CimplifyCheckout, CimplifyProvider, ElementsProvider, PaymentElement, Price, useAds, useBundle, useCart, useCategories, useCheckout, useCimplify, useCollection, useCollections, useComposite, useElements, useElementsReady, useLocations, useOptionalCimplify, useOrder, useProduct, useProducts, useQuote, useSearch };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cimplify/sdk",
-  "version": "0.8.5",
+  "version": "0.8.7",
   "description": "Cimplify Commerce SDK for storefronts",
   "keywords": [
     "cimplify",