@flopay/shared 1.1.6 → 1.2.0

package/README.md

@@ -108,7 +108,8 @@ throw validationError('Email is required', 'email');
 | `PriceData` | `currency`, `unitAmount`, `productData`, `recurring?` |
 | `RecurringInterval` | `interval` (`'month'`/`'year'`), `intervalCount?` |
 | `BillingProvider` | `'recurly'` / `'chargebee'` / `'stripe'` |
-| `TokenizedBody` | `id?`, `type?`, `threeDSecureActionResultTokenId?`, `originalPaymentMethodId?`, `isPaypal?` |
+| `TokenizedBody` | `id?`, `type?`, `threeDSecureActionResultTokenId?`, `originalPaymentMethodId?`, `gateway?` (`'stripe'` / `'paypal'` / custom), `paymentMethodType?` (Stripe wire identifier — `'card'`, `'apple_pay'`, `'cashapp'`, `'klarna'`, … for `gateway='stripe'`; `'paypal'` for `gateway='paypal'`), `isPaypal?` *(deprecated — replaced by `gateway` + `paymentMethodType`; still set for PayPal during the deprecation window so backends gating on `isPaypal === 'true'` keep working)* |
+| `CheckoutGateway` | Per-gateway config from the billing API: `publishableKey?`, `environment?`, `stripeClientSecret?`, `paypalPublishableKey?`, `enabledPaymentMethods?` (Stripe-only — per-session list of Stripe method type identifiers that the gateway has enabled for this consumer; drives dynamic `ExpressCheckoutElement` / `PaymentElement` rendering in `@flopay/react`) |
 | `NormalizedCheckoutSession` | Provider-agnostic session: `provider`, `mode`, `data`, `raw?` |
 | `CheckoutModeKind` | `'tokenize'` / `'redirect'` |
 | `CreateSessionParams` | Full session creation params: `billingApiUrl`, `checkoutBaseUrl`, `clientId`, `currency` (required — SDK throws `FloPayError({ type: 'validation_error', code: 'CurrencyRequired' })` before issuing the request when none can be resolved), `products?` (unified shape; takes precedence), `items?`, `subscriptions?` (legacy — folded into `products[]` before send), `account`, `successUrl`, `cancelUrl`, `checkoutMode?`, `couponCodes?`, `tagsData?`, `redirectParams?`, `setCookie?`, `timeoutMs?`, `utmMetadata?` |
@@ -161,6 +162,9 @@ throw validationError('Email is required', 'email');
 | `resolveButtonsLayoutTheme(name)` | Map a `ButtonsLayoutTheme` name to its `ButtonsLayoutStyles` preset |
 | `ELEMENT_TYPES` | `['payment', 'card', 'cardNumber', 'cardExpiry', 'cardCvc', 'address']` |
 | `SUPPORTED_CARD_BRANDS` | `['visa', 'mastercard', 'mastercard_debit', 'amex', 'discover']` |
+| `STRIPE_EXPRESS_METHODS` | `['apple_pay', 'google_pay', 'paypal', 'link', 'amazon_pay', 'klarna']` — Stripe method type identifiers supported by `ExpressCheckoutElement` (everything else returned in `gateways.stripe.enabledPaymentMethods` falls into the `PaymentElement` accordion in the React SDK) |
+| `partitionStripeMethods(enabledMethods, { excludePaypal? })` | Split the backend's enabled list into `{ expressMethods, paymentElementMethods }`. Drops `card`; also drops `paypal` when `excludePaypal: true`. |
+| `stripeExpressMethodToOptionKey(method)` | Map Stripe wire identifiers (`apple_pay`, `google_pay`, `amazon_pay`) to the camelCase keys (`applePay`, `googlePay`, `amazonPay`) expected by `ExpressCheckoutElement`'s `paymentMethods` options map. |
 | `CURRENCY_MAP` | Country code to `CurrencyInfo` mapping (EU, GB, US, CA, NZ, AU) |
 | `DEFAULT_CURRENCY` | USD fallback |