@flopay/react 0.3.13 → 0.3.15

package/README.md

@@ -178,7 +178,7 @@ Skip the backend API route — create the session directly in the component:
 
 The component POSTs to the billing API, gets the full session back, and renders the form — zero backend code needed.
 
-When you use `onBeforeButtonClick`, `createSession.account.email` can be filled in later for the card-button flow. PayPal and wallets still need all required data before they render.
+When you use `onBeforeButtonClick`, `createSession.account.email` can still be filled in later for the card-button flow. PayPal and wallet buttons still bootstrap normally, but this hook does not run for them, so collect any data those methods require before the user uses them.
 
 ### Advanced: Manual Provider Setup
 

package/dist/index.cjs

@@ -351,15 +351,6 @@ function buildSyntheticSession(params, checkoutModeOverride) {
     }))
   };
 }
-function ensureInlineSessionReady(params) {
-  if (!params.account.email?.trim()) {
-    throw new import_shared3.FloPayError(
-      "Email is required before continuing with card checkout.",
-      "validation_error",
-      { param: "createSession.account.email" }
-    );
-  }
-}
 function mergeAccountPatch(base, patch) {
   if (!patch) return base;
   return {
@@ -406,6 +397,14 @@ var FLOPAY_KEYFRAMES = `
 function FloPayKeyframes() {
   return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("style", { children: FLOPAY_KEYFRAMES });
 }
+function toCssSize(value) {
+  if (typeof value === "number") return `${value}px`;
+  return value;
+}
+function toCssWeight(value) {
+  if (typeof value === "number" || typeof value === "string") return value;
+  return void 0;
+}
 function ProcessingOverlay({ status, errorMessage }) {
   return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("div", { style: {
     position: "fixed",
@@ -813,6 +812,7 @@ function SplitCardFormInner({
 }) {
   const flopay = useFloPay();
   const elements = useElements();
+  const checkout = (0, import_react6.useContext)(CheckoutContext);
   const contextBillingUrl = useBillingApiUrl();
   const [processing, setProcessing] = (0, import_react6.useState)(false);
   const [error, setError] = (0, import_react6.useState)(null);
@@ -858,7 +858,8 @@ function SplitCardFormInner({
       title: { ...base.title, ...buttonsStylesOverride.title }
     };
   }, [buttonsTheme, buttonsStylesOverride]);
-  const isSubmitting = externalProcessing ?? processing;
+  const isInlineSessionPatchProcessing = checkout.inlineSessionPatchProcessing ?? false;
+  const isSubmitting = (externalProcessing ?? processing) || isInlineSessionPatchProcessing;
   const isSelfContained = !onTokenizedBody;
   const baseUrl = resolvedBillingApiUrl.replace(/\/+$/, "");
   const resolvedAccount = (0, import_react6.useMemo)(() => mergeAccountPatch({
@@ -917,8 +918,11 @@ function SplitCardFormInner({
       if (result === false) {
         return false;
       }
-      if (result?.account) {
-        setAccountPatch((prev) => ({ ...prev ?? {}, ...result.account }));
+      if (result && typeof result === "object") {
+        await checkout.applyInlineSessionPatch?.(result);
+        if (result.account) {
+          setAccountPatch((prev) => ({ ...prev ?? {}, ...result.account }));
+        }
       }
       return true;
     } catch (err) {
@@ -930,7 +934,7 @@ function SplitCardFormInner({
       onError?.(floPayErr);
       return false;
     }
-  }, [onBeforeButtonClick, sessionId, updateError, onError]);
+  }, [checkout.applyInlineSessionPatch, onBeforeButtonClick, sessionId, updateError, onError]);
   const processPaymentInternal = (0, import_react6.useCallback)(
     async (tokenizedBody) => {
       if (processingRef.current) return;
@@ -1207,23 +1211,58 @@ function SplitCardFormInner({
   const cardInputBg = isButtons ? bStyles.cardInputBackground ?? "white" : "white";
   const hideBackButtonLabel = isEmptySlotContent(cardBackButtonContent);
   const hideTitle = isEmptySlotContent(cardTitleContent);
-  const stripeElementStyle = isButtons && (bStyles.cardInputColor || bStyles.cardInputPlaceholderColor || bStyles.cardInputFontSize) ? {
+  const nameInputOverrides = isButtons ? bStyles.nameInput : void 0;
+  const resolvedInputFontSize = bStyles.cardInputFontSize ?? toCssSize(nameInputOverrides?.fontSize) ?? "16px";
+  const resolvedInputFontFamily = typeof nameInputOverrides?.fontFamily === "string" ? nameInputOverrides.fontFamily : "Poppins, sans-serif";
+  const resolvedInputFontWeight = toCssWeight(nameInputOverrides?.fontWeight) ?? 400;
+  const resolvedInputColor = bStyles.cardInputColor ?? (typeof nameInputOverrides?.color === "string" ? nameInputOverrides.color : void 0) ?? "#262833";
+  const resolvedPlaceholderColor = bStyles.cardInputPlaceholderColor ?? "#9ca3af";
+  const sharedInputTypography = {
+    fontSize: resolvedInputFontSize,
+    fontFamily: resolvedInputFontFamily,
+    fontWeight: resolvedInputFontWeight,
+    color: resolvedInputColor,
+    WebkitFontSmoothing: "antialiased",
+    MozOsxFontSmoothing: "grayscale"
+  };
+  const sharedInputPlaceholderVars = {
+    "--flopay-input-placeholder-color": resolvedPlaceholderColor,
+    "--flopay-input-font-size": resolvedInputFontSize,
+    "--flopay-input-font-family": resolvedInputFontFamily,
+    "--flopay-input-font-weight": String(resolvedInputFontWeight)
+  };
+  const stripeElementStyle = {
     style: {
       base: {
-        ...bStyles.cardInputColor ? { color: bStyles.cardInputColor } : {},
-        ...bStyles.cardInputFontSize ? { fontSize: bStyles.cardInputFontSize } : {},
-        ...bStyles.cardInputPlaceholderColor ? { "::placeholder": { color: bStyles.cardInputPlaceholderColor } } : {}
+        ...sharedInputTypography,
+        fontSmoothing: "antialiased",
+        "::placeholder": {
+          color: resolvedPlaceholderColor,
+          fontSize: resolvedInputFontSize,
+          fontFamily: resolvedInputFontFamily,
+          fontWeight: resolvedInputFontWeight
+        }
       },
       invalid: { color: "#ef4444" }
     }
-  } : {};
+  };
   const cardFormBlock = /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { style: {
     backgroundColor: cardBg,
     borderRadius: "8px",
     padding: isButtons ? "0" : "1rem",
     ...isButtons ? bStyles.cardFormContainer : {},
-    ...isButtons ? { padding: bStyles.cardFormContainer?.padding ?? "0" } : {}
+    ...isButtons ? { padding: bStyles.cardFormContainer?.padding ?? "0" } : {},
+    ...sharedInputPlaceholderVars
   }, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime4.jsx)("style", { children: `
+        .flopay-shared-input::placeholder {
+          color: var(--flopay-input-placeholder-color);
+          opacity: 1;
+          font-size: var(--flopay-input-font-size);
+          font-family: var(--flopay-input-font-family);
+          font-weight: var(--flopay-input-font-weight);
+        }
+      ` }),
     isButtons && showCardForm && /* @__PURE__ */ (0, import_jsx_runtime4.jsxs)("div", { style: {
       display: "flex",
       alignItems: "center",
@@ -1312,6 +1351,7 @@ function SplitCardFormInner({
     }, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
       "input",
       {
+        className: "flopay-shared-input",
         placeholder: "Full Name on Card",
         autoComplete: "cc-name",
         value: fullName,
@@ -1323,9 +1363,7 @@ function SplitCardFormInner({
           border: "none",
           outline: "none",
           background: "transparent",
-          fontSize: bStyles.cardInputFontSize ?? "16px",
-          fontFamily: "Poppins, sans-serif",
-          color: bStyles.cardInputColor ?? "#262833",
+          ...sharedInputTypography,
           ...isButtons && bStyles.nameInput ? bStyles.nameInput : {}
         }
       }
@@ -1360,9 +1398,7 @@ function SplitCardFormInner({
             border: "none",
             outline: "none",
             background: "transparent",
-            fontSize: bStyles.cardInputFontSize ?? "16px",
-            fontFamily: "Poppins, sans-serif",
-            color: bStyles.cardInputColor ?? "#262833",
+            ...sharedInputTypography,
             cursor: "pointer",
             ...isButtons && bStyles.nameInput ? bStyles.nameInput : {}
           },
@@ -1383,6 +1419,7 @@ function SplitCardFormInner({
       }, children: /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(
         "input",
         {
+          className: "flopay-shared-input",
           placeholder: (0, import_shared4.getPostalCodeLabel)(selectedCountry),
           autoComplete: "postal-code",
           value: zipCode,
@@ -1399,9 +1436,7 @@ function SplitCardFormInner({
             border: "none",
             outline: "none",
             background: "transparent",
-            fontSize: bStyles.cardInputFontSize ?? "16px",
-            fontFamily: "Poppins, sans-serif",
-            color: bStyles.cardInputColor ?? "#262833",
+            ...sharedInputTypography,
             ...isButtons && bStyles.nameInput ? bStyles.nameInput : {}
           }
         }
@@ -1508,11 +1543,13 @@ function SplitCardFormInner({
             {
               type: "button",
               onClick: async () => {
+                if (isSubmitting) return;
                 const shouldContinue = await runBeforeCardButtonClick();
                 if (!shouldContinue) return;
                 onButtonClick?.("card");
                 expandToCard();
               },
+              disabled: isSubmitting,
               style: {
                 width: "100%",
                 padding: "0.9rem 1rem",
@@ -1522,7 +1559,7 @@ function SplitCardFormInner({
                 borderRadius: "8px",
                 fontSize: bStyles.cardButtonFontSize ?? "0.95rem",
                 fontWeight: 600,
-                cursor: "pointer",
+                cursor: isSubmitting ? "not-allowed" : "pointer",
                 display: "flex",
                 alignItems: "center",
                 justifyContent: "center",
@@ -1530,6 +1567,7 @@ function SplitCardFormInner({
                 transition: "border-color 0.2s, box-shadow 0.2s, transform 0.1s",
                 boxShadow: "0 1px 2px rgba(0,0,0,0.04)",
                 position: "relative",
+                opacity: isSubmitting ? 0.6 : 1,
                 ...bStyles.cardButton
               },
               onMouseDown: (e) => {
@@ -1613,6 +1651,12 @@ function SplitCardFormInner({
 
 // src/flopay-checkout.tsx
 var import_jsx_runtime5 = require("react/jsx-runtime");
+function hasInlineSessionPatchData(patch) {
+  if (!patch) return false;
+  return Boolean(
+    patch.account && Object.keys(patch.account).length > 0 || patch.couponCodes !== void 0 || patch.tagsData !== void 0 || patch.utmMetadata !== void 0
+  );
+}
 function FloPayCheckout({
   sessionId: sessionIdProp,
   createSession: createSessionParams,
@@ -1660,7 +1704,6 @@ function FloPayCheckout({
   const [createSessionPatch, setCreateSessionPatch] = (0, import_react7.useState)(void 0);
   const [createSessionPatchBaseHash, setCreateSessionPatchBaseHash] = (0, import_react7.useState)("");
   const [cardBootstrapPending, setCardBootstrapPending] = (0, import_react7.useState)(false);
-  const [deferredCardOpen, setDeferredCardOpen] = (0, import_react7.useState)(false);
   const autoCheckoutAttempted = (0, import_react7.useRef)(false);
   const onCompleteRef = (0, import_react7.useRef)(onComplete);
   onCompleteRef.current = onComplete;
@@ -1795,9 +1838,6 @@ function FloPayCheckout({
   );
   const inflightRef = (0, import_react7.useRef)(/* @__PURE__ */ new Map());
   const initializedHashRef = (0, import_react7.useRef)(null);
-  const deferInlineSessionUntilCardClick = Boolean(
-    effectiveCreateSession && !children && layout === "buttons" && onBeforeButtonClick && (effectiveCreateSession.checkoutMode ?? checkoutModeProp ?? "full") === "full"
-  );
   function hashCreateParams(params) {
     const key = JSON.stringify({
       c: params?.clientId,
@@ -1827,7 +1867,6 @@ function FloPayCheckout({
     setResolvedSessionId(sessionIdProp ?? "");
   }, [sessionIdProp]);
   async function resolveInlineSession(params, cacheKey) {
-    ensureInlineSessionReady(params);
     const api = new import_js.PaymentAPI(resolvedBillingUrl);
     let sid = typeof window !== "undefined" ? window.sessionStorage.getItem(cacheKey) : null;
     let realResult = null;
@@ -1872,104 +1911,64 @@ function FloPayCheckout({
       } finally {
         inflightRef.current.delete(cacheKey);
       }
-      if (patch) {
-        setCreateSessionPatchBaseHash(baseCreateSessionHash);
-        setCreateSessionPatch((prev) => mergeInlineSessionPatches(prev, patch));
-      }
-      const { sid, result: realResult } = resolved;
-      setUnified(realResult);
-      if (realResult.data.session) {
-        setSession(realResult.data.session);
-      }
-      if (sid) {
-        setResolvedSessionId(sid);
-      }
-      let publishableKey;
-      if (realResult.provider === "stripe") {
-        publishableKey = realResult.data.stripe?.publishableKey;
-      }
-      if (!publishableKey) publishableKey = fallbackPublishableKey;
-      if (!publishableKey) {
-        throw new import_shared6.FloPayError(
-          "No publishable key found. Provide fallbackPublishableKey or ensure the session includes gatewayData.publishableKey.",
-          "validation_error"
-        );
-      }
-      const instance = await (0, import_js.loadFloPay)(publishableKey, {
-        billingApiUrl: resolvedBillingUrl,
-        locale
-      });
-      flopayRef.current = instance;
-      setFloPay(instance);
       initializedHashRef.current = cacheKey;
-      setIsLoading(false);
+      try {
+        if (patch) {
+          setCreateSessionPatchBaseHash(baseCreateSessionHash);
+          setCreateSessionPatch((prev) => mergeInlineSessionPatches(prev, patch));
+        }
+        const { sid, result: realResult } = resolved;
+        setUnified(realResult);
+        if (realResult.data.session) {
+          setSession(realResult.data.session);
+        }
+        if (sid) {
+          setResolvedSessionId(sid);
+        }
+        let publishableKey;
+        if (realResult.provider === "stripe") {
+          publishableKey = realResult.data.stripe?.publishableKey;
+        }
+        if (!publishableKey) publishableKey = fallbackPublishableKey;
+        if (!publishableKey) {
+          throw new import_shared6.FloPayError(
+            "No publishable key found. Provide fallbackPublishableKey or ensure the session includes gatewayData.publishableKey.",
+            "validation_error"
+          );
+        }
+        const instance = await (0, import_js.loadFloPay)(publishableKey, {
+          billingApiUrl: resolvedBillingUrl,
+          locale
+        });
+        flopayRef.current = instance;
+        setFloPay(instance);
+        setIsLoading(false);
+      } catch (err) {
+        if (initializedHashRef.current === cacheKey) {
+          initializedHashRef.current = null;
+        }
+        throw err;
+      }
       return resolved;
     },
     [fallbackPublishableKey, locale, resolvedBillingUrl]
   );
-  const handleDeferredCardButtonClick = (0, import_react7.useCallback)(async () => {
-    if (cardBootstrapPending) return;
-    setLoadError(null);
+  const handleInlineSessionPatch = (0, import_react7.useCallback)(async (patch) => {
+    if (!hasInlineSessionPatchData(patch) || cardBootstrapPending) return;
     setCardBootstrapPending(true);
     try {
-      const beforeClickResult = await onBeforeButtonClick?.({
-        method: "card",
-        createSession: effectiveCreateSession
-      });
-      if (beforeClickResult === false) {
-        setDeferredCardOpen(false);
-        return;
-      }
-      const patch = beforeClickResult && typeof beforeClickResult === "object" ? beforeClickResult : void 0;
-      const baseParams = createSessionParamsRef.current;
-      if (!baseParams) {
-        throw new import_shared6.FloPayError(
-          "createSession is required to bootstrap checkout.",
-          "validation_error"
-        );
-      }
-      ensureInlineSessionReady(mergeInlineSessionPatch(baseParams, patch));
-      setDeferredCardOpen(true);
-      onButtonClick?.("card");
       await bootstrapInlineSession(patch);
-    } catch (err) {
-      setDeferredCardOpen(false);
-      const floPayErr = err instanceof import_shared6.FloPayError ? err : new import_shared6.FloPayError(
-        err instanceof Error ? err.message : "Failed to start card checkout.",
-        "api_error"
-      );
-      setLoadError(floPayErr);
-      onErrorRef.current?.(floPayErr);
     } finally {
       setCardBootstrapPending(false);
     }
   }, [
     bootstrapInlineSession,
-    baseCreateSessionHash,
-    cardBootstrapPending,
-    effectiveCreateSession,
-    onButtonClick,
-    onBeforeButtonClick
+    cardBootstrapPending
   ]);
   (0, import_react7.useEffect)(() => {
     let cancelled = false;
     setLoadError(null);
     if (createSessionHash) {
-      if (deferInlineSessionUntilCardClick) {
-        if (initializedHashRef.current !== createSessionHash) {
-          setSession(null);
-          setUnified(null);
-          setFloPay(null);
-          setResolvedSessionId("");
-          setDeferredCardOpen(false);
-          flopayRef.current = null;
-        }
-        setCurrentMode(createSessionParamsRef.current?.checkoutMode ?? checkoutModeProp ?? "full");
-        setIsLoading(false);
-        return () => {
-          cancelled = true;
-        };
-      }
       if (initializedHashRef.current === createSessionHash) return;
       const params = createSessionParamsRef.current;
       setSession(buildSyntheticSession(params, checkoutModeProp));
@@ -2065,7 +2064,7 @@ function FloPayCheckout({
     return () => {
       cancelled = true;
     };
-  }, [resolvedSessionId, createSessionHash, checkoutModeProp, deferInlineSessionUntilCardClick, bootstrapInlineSession]);
+  }, [resolvedSessionId, createSessionHash, checkoutModeProp, bootstrapInlineSession]);
   const handleConfirmCheckout = (0, import_react7.useCallback)(async () => {
     if (confirmProcessing || !session) return;
     setConfirmProcessing(true);
@@ -2108,17 +2107,29 @@ function FloPayCheckout({
     }
     return opts;
   }, [unified, session, appearance, resolvedBillingUrl]);
+  const shouldHandleInlineSessionPatch = Boolean(
+    createSessionParams && !children && layout === "buttons" && onBeforeButtonClick && (effectiveCreateSession?.checkoutMode ?? checkoutModeProp ?? "full") === "full"
+  );
   const checkoutValue = (0, import_react7.useMemo)(
     () => ({
       session,
       loading: isLoading,
       error: loadError,
-      checkoutMode: currentMode
+      checkoutMode: currentMode,
+      applyInlineSessionPatch: shouldHandleInlineSessionPatch ? handleInlineSessionPatch : void 0,
+      inlineSessionPatchProcessing: cardBootstrapPending
     }),
-    [session, isLoading, loadError, currentMode]
+    [
+      session,
+      isLoading,
+      loadError,
+      currentMode,
+      shouldHandleInlineSessionPatch,
+      handleInlineSessionPatch,
+      cardBootstrapPending
+    ]
   );
   const shouldShowInterimButtons = Boolean(createSessionParams) && layout === "buttons" && (!flopay || !providerOptions);
-  const shouldKeepDeferredInterimVisible = shouldShowInterimButtons && deferInlineSessionUntilCardClick;
   if (isLoading) {
     if (loadingNode) return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_jsx_runtime5.Fragment, { children: loadingNode });
     if (layout === "buttons") {
@@ -2147,7 +2158,7 @@ function FloPayCheckout({
       /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("style", { children: `@keyframes spin { to { transform: rotate(360deg); } }` })
     ] });
   }
-  if (loadError && !shouldKeepDeferredInterimVisible) {
+  if (loadError) {
     if (errorNode) return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(import_jsx_runtime5.Fragment, { children: errorNode(loadError) });
     return /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
       "div",
@@ -2167,13 +2178,9 @@ function FloPayCheckout({
       InterimButtonsView,
       {
         onButtonClick,
-        onCardButtonClick: deferInlineSessionUntilCardClick ? handleDeferredCardButtonClick : void 0,
-        cardLoading: cardBootstrapPending,
-        cardOpen: deferInlineSessionUntilCardClick ? deferredCardOpen : void 0,
-        errorMessage: shouldKeepDeferredInterimVisible ? loadError?.message ?? null : null,
-        showPayPal: deferInlineSessionUntilCardClick ? false : showPayPal,
-        showApplePay: deferInlineSessionUntilCardClick ? false : showApplePay,
-        showGooglePay: deferInlineSessionUntilCardClick ? false : showGooglePay,
+        showPayPal,
+        showApplePay,
+        showGooglePay,
         buttonsTheme,
         buttonsStyles,
         cardButtonContent,
@@ -2274,7 +2281,6 @@ function FloPayCheckout({
         enableAVS,
         avsLayout,
         country: session?.customer?.country,
-        initialCardOpen: deferredCardOpen,
         submitLabel,
         className
       }