@flopay/react 0.5.12 → 0.5.13

package/dist/index.d.cts

@@ -576,4 +576,36 @@ interface FloPayAutomaticPaymentButtonProps extends Omit<React.ButtonHTMLAttribu
 }
 declare function FloPayAutomaticPaymentButton({ sessionId, createSession, paymentMethodId, checkoutMethod, clientId, items, subscriptions, account, successUrl, cancelUrl, couponCodes, tagsData, utmMetadata, billingApiUrl, locale, buttonsTheme, buttonsStyles: stylesOverride, onSuccess, onError, onDecline, children, disabled, type, style, ...buttonProps }: FloPayAutomaticPaymentButtonProps): react_jsx_runtime.JSX.Element;
 
-export { AddressElement, CardCvcElement, CardElement, CardExpiryElement, CardNumberElement, CheckoutForm, type CheckoutFormProps, type CheckoutFormRef, type CheckoutState, type ElementComponentProps, FloPayAutomaticPaymentButton, type FloPayAutomaticPaymentButtonProps, type FloPayAutomaticPaymentSuccessEvent, FloPayCheckout, type FloPayCheckoutProps, FloPayProvider, type FloPayProviderProps, PayPalButton, type PayPalButtonProps, PaymentElement, SplitCardForm, type SplitCardFormProps, type SplitCardFormRef, useCheckout, useElements, useFloPay, usePayPalFloPay };
+interface InAppBrowserNoticeProps {
+    /** Custom message override. Defaults to a generic, non-platform-specific copy. */
+    message?: React.ReactNode;
+    /** Custom button label. Defaults to "Open in browser" / "Link copied". */
+    openButtonLabel?: string;
+    copiedButtonLabel?: string;
+    /** Custom CSS overrides for the container, message, and button. */
+    containerStyle?: React.CSSProperties;
+    buttonStyle?: React.CSSProperties;
+    /** Called when the user clicks the open-in-browser button. */
+    onOpenInBrowser?: (result: {
+        opened: boolean;
+        copied: boolean;
+    }) => void;
+}
+/**
+ * Non-disruptive notice rendered when PayPal and digital wallets fail to load
+ * — typically because the buyer is in an in-app browser (Instagram, Facebook,
+ * TikTok, etc.) or behind an ad-blocker. The card form remains fully
+ * functional; this notice just informs the buyer about the unavailable
+ * methods and offers a one-click attempt to relaunch in the device browser.
+ *
+ * The "Open in browser" button is best-effort:
+ * - Tries `window.open(url, '_blank')` first (works in some webviews).
+ * - Falls back to copying the URL to clipboard so the buyer can paste it
+ *   into Safari/Chrome themselves.
+ *
+ * No reliable cross-platform JS API exists to *force* an in-app webview to
+ * defer to the system browser, so we don't pretend otherwise.
+ */
+declare function InAppBrowserNotice({ message, openButtonLabel, copiedButtonLabel, containerStyle, buttonStyle, onOpenInBrowser, }: InAppBrowserNoticeProps): react_jsx_runtime.JSX.Element;
+
+export { AddressElement, CardCvcElement, CardElement, CardExpiryElement, CardNumberElement, CheckoutForm, type CheckoutFormProps, type CheckoutFormRef, type CheckoutState, type ElementComponentProps, FloPayAutomaticPaymentButton, type FloPayAutomaticPaymentButtonProps, type FloPayAutomaticPaymentSuccessEvent, FloPayCheckout, type FloPayCheckoutProps, FloPayProvider, type FloPayProviderProps, InAppBrowserNotice, type InAppBrowserNoticeProps, PayPalButton, type PayPalButtonProps, PaymentElement, SplitCardForm, type SplitCardFormProps, type SplitCardFormRef, useCheckout, useElements, useFloPay, usePayPalFloPay };

package/dist/index.d.ts

@@ -576,4 +576,36 @@ interface FloPayAutomaticPaymentButtonProps extends Omit<React.ButtonHTMLAttribu
 }
 declare function FloPayAutomaticPaymentButton({ sessionId, createSession, paymentMethodId, checkoutMethod, clientId, items, subscriptions, account, successUrl, cancelUrl, couponCodes, tagsData, utmMetadata, billingApiUrl, locale, buttonsTheme, buttonsStyles: stylesOverride, onSuccess, onError, onDecline, children, disabled, type, style, ...buttonProps }: FloPayAutomaticPaymentButtonProps): react_jsx_runtime.JSX.Element;
 
-export { AddressElement, CardCvcElement, CardElement, CardExpiryElement, CardNumberElement, CheckoutForm, type CheckoutFormProps, type CheckoutFormRef, type CheckoutState, type ElementComponentProps, FloPayAutomaticPaymentButton, type FloPayAutomaticPaymentButtonProps, type FloPayAutomaticPaymentSuccessEvent, FloPayCheckout, type FloPayCheckoutProps, FloPayProvider, type FloPayProviderProps, PayPalButton, type PayPalButtonProps, PaymentElement, SplitCardForm, type SplitCardFormProps, type SplitCardFormRef, useCheckout, useElements, useFloPay, usePayPalFloPay };
+interface InAppBrowserNoticeProps {
+    /** Custom message override. Defaults to a generic, non-platform-specific copy. */
+    message?: React.ReactNode;
+    /** Custom button label. Defaults to "Open in browser" / "Link copied". */
+    openButtonLabel?: string;
+    copiedButtonLabel?: string;
+    /** Custom CSS overrides for the container, message, and button. */
+    containerStyle?: React.CSSProperties;
+    buttonStyle?: React.CSSProperties;
+    /** Called when the user clicks the open-in-browser button. */
+    onOpenInBrowser?: (result: {
+        opened: boolean;
+        copied: boolean;
+    }) => void;
+}
+/**
+ * Non-disruptive notice rendered when PayPal and digital wallets fail to load
+ * — typically because the buyer is in an in-app browser (Instagram, Facebook,
+ * TikTok, etc.) or behind an ad-blocker. The card form remains fully
+ * functional; this notice just informs the buyer about the unavailable
+ * methods and offers a one-click attempt to relaunch in the device browser.
+ *
+ * The "Open in browser" button is best-effort:
+ * - Tries `window.open(url, '_blank')` first (works in some webviews).
+ * - Falls back to copying the URL to clipboard so the buyer can paste it
+ *   into Safari/Chrome themselves.
+ *
+ * No reliable cross-platform JS API exists to *force* an in-app webview to
+ * defer to the system browser, so we don't pretend otherwise.
+ */
+declare function InAppBrowserNotice({ message, openButtonLabel, copiedButtonLabel, containerStyle, buttonStyle, onOpenInBrowser, }: InAppBrowserNoticeProps): react_jsx_runtime.JSX.Element;
+
+export { AddressElement, CardCvcElement, CardElement, CardExpiryElement, CardNumberElement, CheckoutForm, type CheckoutFormProps, type CheckoutFormRef, type CheckoutState, type ElementComponentProps, FloPayAutomaticPaymentButton, type FloPayAutomaticPaymentButtonProps, type FloPayAutomaticPaymentSuccessEvent, FloPayCheckout, type FloPayCheckoutProps, FloPayProvider, type FloPayProviderProps, InAppBrowserNotice, type InAppBrowserNoticeProps, PayPalButton, type PayPalButtonProps, PaymentElement, SplitCardForm, type SplitCardFormProps, type SplitCardFormRef, useCheckout, useElements, useFloPay, usePayPalFloPay };