@cimplify/sdk 0.8.5 → 0.8.7

package/dist/index.js

@@ -1339,6 +1339,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";
@@ -1378,7 +1382,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)) {
@@ -1425,6 +1430,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;
@@ -1540,6 +1548,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;

package/dist/index.mjs

@@ -1337,6 +1337,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";
@@ -1376,7 +1380,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)) {
@@ -1423,6 +1428,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;
@@ -1538,6 +1546,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;

package/dist/react.d.mts

@@ -1,4 +1,4 @@
-import { C as CimplifyClient, X as ProcessCheckoutResult, Z as CheckoutStatus, _ as CheckoutStatusContext, bp as Location, bm as Business, aR as Order, d as QuoteBundleSelectionInput, Q as QuoteCompositeSelectionInput, P as PriceQuote, g as QuoteUiMessage, s as CimplifyElements, w as ElementsOptions, cJ as AuthenticatedData, cF as AddressInfo, cG as PaymentMethodInfo, cL as ElementsCheckoutResult, W as ProcessCheckoutOptions } from './client-iRG2DBq0.mjs';
+import { C as CimplifyClient, Y as ProcessCheckoutResult, _ as CheckoutStatus, $ as CheckoutStatusContext, bq as Location, bn as Business, aS as Order, d as QuoteBundleSelectionInput, Q as QuoteCompositeSelectionInput, P as PriceQuote, g as QuoteUiMessage, s as CimplifyElements, w as ElementsOptions, cK as AuthenticatedData, cG as AddressInfo, cH as PaymentMethodInfo, cM as ElementsCheckoutResult, X as ProcessCheckoutOptions } from './client-6MsOWo8f.mjs';
 import React, { ReactNode } from 'react';
 import { q as Product, d as Pagination, h as CimplifyError, r as ProductWithDetails, K as Category, aw as BundleSelectionInput, a7 as ComponentSelectionInput, N as Collection, X as BundleWithDetails, a3 as CompositeWithDetails, a8 as CompositePriceResult, C as CurrencyCode } from './payment-CLIWNMaP.mjs';
 import { A as AdSlot, a as AdPosition, e as AdContextValue } from './ads-t3FBTU8p.mjs';
@@ -77,6 +77,22 @@ interface CimplifyCheckoutProps {
 }
 declare function CimplifyCheckout({ client, businessId, cartId, locationId, linkUrl, orderTypes, enrollInLink, onComplete, onError, onStatusChange, appearance, demoMode, className, }: CimplifyCheckoutProps): React.ReactElement;
 
+interface PriceProps {
+    /** The amount in base (business) currency. */
+    amount: number | string;
+    /** Optional CSS class name for the wrapping span. */
+    className?: string;
+    /** Optional prefix rendered before the formatted price (e.g. "+"). */
+    prefix?: string;
+}
+/**
+ * Price — renders a single price value in the user's chosen display currency.
+ *
+ * Reads `displayCurrency` and `convertPrice` from CimplifyProvider context
+ * so every price on the page stays consistent with the selected currency.
+ */
+declare function Price({ amount, className, prefix }: PriceProps): React.ReactElement;
+
 interface CimplifyContextValue {
     client: CimplifyClient;
     business: Business | null;
@@ -87,6 +103,16 @@ interface CimplifyContextValue {
     setCurrentLocation: (location: Location) => void;
     isReady: boolean;
     isDemoMode: boolean;
+    /** The business's pricing currency (always the base, for API calls). */
+    baseCurrency: string;
+    /** The currency prices are displayed in. Equals baseCurrency when no FX override is set. */
+    displayCurrency: string;
+    /** Set a display currency override for FX conversion. Pass null to reset to base currency. */
+    setDisplayCurrency: (currency: string | null) => void;
+    /** Convert a base-currency amount to the display currency. No-op when currencies match. */
+    convertPrice: (amount: number | string) => number;
+    /** Current FX rate (baseCurrency → displayCurrency). Null when no conversion is active. */
+    fxRate: number | null;
 }
 interface CimplifyProviderProps {
     client?: CimplifyClient;
@@ -376,4 +402,4 @@ declare function useCheckout(): {
     isLoading: boolean;
 };
 
-export { Ad, AdPosition, type AdProps, AdProvider, AdSlot, type AddToCartOptions, AddressElement, AuthElement, CimplifyCheckout, type CimplifyCheckoutProps, type CimplifyContextValue, CimplifyProvider, type CimplifyProviderProps, ElementsProvider, PaymentElement, type UseBundleOptions, type UseBundleResult, type UseCartItem, type UseCartOptions, type UseCartResult, type UseCategoriesOptions, type UseCategoriesResult, type UseCollectionOptions, type UseCollectionResult, type UseCollectionsOptions, type UseCollectionsResult, type UseCompositeOptions, type UseCompositeResult, type UseLocationsOptions, type UseLocationsResult, type UseOrderOptions, type UseOrderResult, type UseProductOptions, type UseProductResult, type UseProductsOptions, type UseProductsResult, type UseQuoteInput, type UseQuoteOptions, type UseQuoteResult, type UseSearchOptions, type UseSearchResult, useAds, useBundle, useCart, useCategories, useCheckout, useCimplify, useCollection, useCollections, useComposite, useElements, useElementsReady, useLocations, useOptionalCimplify, useOrder, useProduct, useProducts, useQuote, useSearch };
+export { Ad, AdPosition, type AdProps, AdProvider, AdSlot, type AddToCartOptions, AddressElement, AuthElement, CimplifyCheckout, type CimplifyCheckoutProps, type CimplifyContextValue, CimplifyProvider, type CimplifyProviderProps, ElementsProvider, PaymentElement, Price, type PriceProps, type UseBundleOptions, type UseBundleResult, type UseCartItem, type UseCartOptions, type UseCartResult, type UseCategoriesOptions, type UseCategoriesResult, type UseCollectionOptions, type UseCollectionResult, type UseCollectionsOptions, type UseCollectionsResult, type UseCompositeOptions, type UseCompositeResult, type UseLocationsOptions, type UseLocationsResult, type UseOrderOptions, type UseOrderResult, type UseProductOptions, type UseProductResult, type UseProductsOptions, type UseProductsResult, type UseQuoteInput, type UseQuoteOptions, type UseQuoteResult, type UseSearchOptions, type UseSearchResult, useAds, useBundle, useCart, useCategories, useCheckout, useCimplify, useCollection, useCollections, useComposite, useElements, useElementsReady, useLocations, useOptionalCimplify, useOrder, useProduct, useProducts, useQuote, useSearch };

package/dist/react.d.ts

@@ -1,4 +1,4 @@
-import { C as CimplifyClient, X as ProcessCheckoutResult, Z as CheckoutStatus, _ as CheckoutStatusContext, bp as Location, bm as Business, aR as Order, d as QuoteBundleSelectionInput, Q as QuoteCompositeSelectionInput, P as PriceQuote, g as QuoteUiMessage, s as CimplifyElements, w as ElementsOptions, cJ as AuthenticatedData, cF as AddressInfo, cG as PaymentMethodInfo, cL as ElementsCheckoutResult, W as ProcessCheckoutOptions } from './client-8SahVQEy.js';
+import { C as CimplifyClient, Y as ProcessCheckoutResult, _ as CheckoutStatus, $ as CheckoutStatusContext, bq as Location, bn as Business, aS as Order, d as QuoteBundleSelectionInput, Q as QuoteCompositeSelectionInput, P as PriceQuote, g as QuoteUiMessage, s as CimplifyElements, w as ElementsOptions, cK as AuthenticatedData, cG as AddressInfo, cH as PaymentMethodInfo, cM as ElementsCheckoutResult, X as ProcessCheckoutOptions } from './client-CVJ0S99a.js';
 import React, { ReactNode } from 'react';
 import { q as Product, d as Pagination, h as CimplifyError, r as ProductWithDetails, K as Category, aw as BundleSelectionInput, a7 as ComponentSelectionInput, N as Collection, X as BundleWithDetails, a3 as CompositeWithDetails, a8 as CompositePriceResult, C as CurrencyCode } from './payment-CLIWNMaP.js';
 import { A as AdSlot, a as AdPosition, e as AdContextValue } from './ads-t3FBTU8p.js';
@@ -77,6 +77,22 @@ interface CimplifyCheckoutProps {
 }
 declare function CimplifyCheckout({ client, businessId, cartId, locationId, linkUrl, orderTypes, enrollInLink, onComplete, onError, onStatusChange, appearance, demoMode, className, }: CimplifyCheckoutProps): React.ReactElement;
 
+interface PriceProps {
+    /** The amount in base (business) currency. */
+    amount: number | string;
+    /** Optional CSS class name for the wrapping span. */
+    className?: string;
+    /** Optional prefix rendered before the formatted price (e.g. "+"). */
+    prefix?: string;
+}
+/**
+ * Price — renders a single price value in the user's chosen display currency.
+ *
+ * Reads `displayCurrency` and `convertPrice` from CimplifyProvider context
+ * so every price on the page stays consistent with the selected currency.
+ */
+declare function Price({ amount, className, prefix }: PriceProps): React.ReactElement;
+
 interface CimplifyContextValue {
     client: CimplifyClient;
     business: Business | null;
@@ -87,6 +103,16 @@ interface CimplifyContextValue {
     setCurrentLocation: (location: Location) => void;
     isReady: boolean;
     isDemoMode: boolean;
+    /** The business's pricing currency (always the base, for API calls). */
+    baseCurrency: string;
+    /** The currency prices are displayed in. Equals baseCurrency when no FX override is set. */
+    displayCurrency: string;
+    /** Set a display currency override for FX conversion. Pass null to reset to base currency. */
+    setDisplayCurrency: (currency: string | null) => void;
+    /** Convert a base-currency amount to the display currency. No-op when currencies match. */
+    convertPrice: (amount: number | string) => number;
+    /** Current FX rate (baseCurrency → displayCurrency). Null when no conversion is active. */
+    fxRate: number | null;
 }
 interface CimplifyProviderProps {
     client?: CimplifyClient;
@@ -376,4 +402,4 @@ declare function useCheckout(): {
     isLoading: boolean;
 };
 
-export { Ad, AdPosition, type AdProps, AdProvider, AdSlot, type AddToCartOptions, AddressElement, AuthElement, CimplifyCheckout, type CimplifyCheckoutProps, type CimplifyContextValue, CimplifyProvider, type CimplifyProviderProps, ElementsProvider, PaymentElement, type UseBundleOptions, type UseBundleResult, type UseCartItem, type UseCartOptions, type UseCartResult, type UseCategoriesOptions, type UseCategoriesResult, type UseCollectionOptions, type UseCollectionResult, type UseCollectionsOptions, type UseCollectionsResult, type UseCompositeOptions, type UseCompositeResult, type UseLocationsOptions, type UseLocationsResult, type UseOrderOptions, type UseOrderResult, type UseProductOptions, type UseProductResult, type UseProductsOptions, type UseProductsResult, type UseQuoteInput, type UseQuoteOptions, type UseQuoteResult, type UseSearchOptions, type UseSearchResult, useAds, useBundle, useCart, useCategories, useCheckout, useCimplify, useCollection, useCollections, useComposite, useElements, useElementsReady, useLocations, useOptionalCimplify, useOrder, useProduct, useProducts, useQuote, useSearch };
+export { Ad, AdPosition, type AdProps, AdProvider, AdSlot, type AddToCartOptions, AddressElement, AuthElement, CimplifyCheckout, type CimplifyCheckoutProps, type CimplifyContextValue, CimplifyProvider, type CimplifyProviderProps, ElementsProvider, PaymentElement, Price, type PriceProps, type UseBundleOptions, type UseBundleResult, type UseCartItem, type UseCartOptions, type UseCartResult, type UseCategoriesOptions, type UseCategoriesResult, type UseCollectionOptions, type UseCollectionResult, type UseCollectionsOptions, type UseCollectionsResult, type UseCompositeOptions, type UseCompositeResult, type UseLocationsOptions, type UseLocationsResult, type UseOrderOptions, type UseOrderResult, type UseProductOptions, type UseProductResult, type UseProductsOptions, type UseProductsResult, type UseQuoteInput, type UseQuoteOptions, type UseQuoteResult, type UseSearchOptions, type UseSearchResult, useAds, useBundle, useCart, useCategories, useCheckout, useCimplify, useCollection, useCollections, useComposite, useElements, useElementsReady, useLocations, useOptionalCimplify, useOrder, useProduct, useProducts, useQuote, useSearch };