@flopay/shared 1.11.5 → 1.11.6

package/dist/index.d.cts

@@ -2041,6 +2041,16 @@ interface CountryOption {
     flag: string;
 }
 
+/** The buyer-facing name of a checkout button method ("Card" for anything unknown). */
+declare function getButtonMethodLabel(method: CheckoutButtonMethod): string;
+/**
+ * A value thrown by a merchant's before-click hook, as the `FloPayError` the
+ * checkout shows and reports: a `FloPayError` is kept, an `Error` keeps its
+ * message, anything else becomes "<Method> before-click hook failed.". All are
+ * `validation_error`s unless the hook threw a `FloPayError` of its own.
+ */
+declare function normalizeBeforeButtonClickError(method: CheckoutButtonMethod, err: unknown): FloPayError;
+
 /**
  * Whether a read session is safe to mount in a no-charge card-setup surface.
  * Both the explicit setup mode and the empty, zero-amount cart are required so
@@ -2048,6 +2058,103 @@ interface CountryOption {
  */
 declare function isCardSetupCheckoutSession(session: CheckoutSession): boolean;
 
+/** The states of the processing / outcome modal a setup surface draws. */
+type ProcessingOverlayStatus = 'processing' | 'success' | 'error';
+/**
+ * Visual treatment for the processing / outcome modal. Framework-free: the
+ * panel is a plain style object, so every UI binding draws the same modal
+ * from one derivation (TeamFloPay/sdk#410, CTO decision 1).
+ */
+interface ProcessingOverlayThemeColors {
+    /** Panel surface (background, border, radius, shadow) plus base text color and font. */
+    panel: Record<string, string | number>;
+    spinnerTrackColor: string;
+    spinnerAccentColor: string;
+    labelColors: Record<ProcessingOverlayStatus, string>;
+    /** Secondary copy: the success note and the failure message. */
+    noteColor: string;
+}
+/**
+ * The card-setup processing / success / error modal for a named preset: the
+ * panel reuses the credit-card pane surface and typography; processing wears
+ * the preset primary on the spinner; success and error keep semantic accents.
+ */
+declare function computeCardSetupOverlayTheme(bundle: ThemeBundle): ProcessingOverlayThemeColors;
+
+/**
+ * Surface treatment for the card-setup container — the same complete
+ * `cardFormContainer` look the checkout's credit-card pane wears for a preset —
+ * merged beneath the merchant's `containerStyle` with deterministic precedence:
+ *
+ * 1. Every `containerStyle` property wins over the preset value for the same
+ *    property.
+ * 2. Declarations are applied preset-first, then `containerStyle` in the
+ *    merchant's own order, so a `containerStyle` longhand refines a preset
+ *    shorthand of the same family (`borderColor` recolors the preset `border`;
+ *    `paddingTop` adjusts one side) exactly as CSS cascades a later declaration.
+ * 3. Background is the one family a longhand cannot refine: a color cannot
+ *    displace a preset gradient's image layer. Any `background*` member in
+ *    `containerStyle` therefore replaces the preset's background family
+ *    entirely, so a merchant color never shows a glass gradient through it.
+ *
+ * `classic` and raw `VaultCardThemeColors` supply no surface, so `containerStyle`
+ * applies alone — byte-for-byte the released behavior.
+ *
+ * Framework-free (any style-object type), so every UI binding merges the same
+ * way (TeamFloPay/sdk#410, CTO decision 1).
+ */
+declare function mergeCardSetupSurface<Style extends object>(surface: Style | undefined, containerStyle: Style | undefined): Style | undefined;
+
+/**
+ * The PayPal gateway fields the direct PayPal button needs: the session's
+ * `gateways.paypal`, or the normalized `data.paypal` copy of it.
+ */
+interface DirectPayPalGatewaySource {
+    /** The PayPal client id. */
+    publishableKey?: string | null;
+    environment?: GatewayEnvironment;
+    providerObjectType?: PayPalProviderObjectType;
+    approvalPresentation?: PayPalApprovalPresentation;
+}
+/** What the checkout hands its card form as `directPaypal`. */
+interface DirectPayPalConfig {
+    clientId: string;
+    environment?: GatewayEnvironment;
+    providerObjectType?: PayPalProviderObjectType;
+    approvalPresentation?: PayPalApprovalPresentation;
+    existingOrderId?: string;
+}
+/**
+ * The direct PayPal config for a session's PayPal gateway: its
+ * `publishableKey` is the PayPal client id, and `existingOrderId` is an order
+ * to resume instead of creating one. `undefined` when the gateway has no
+ * client id.
+ */
+declare function resolveDirectPaypalConfig(paypal: DirectPayPalGatewaySource | null | undefined, existingOrderId?: string): DirectPayPalConfig | undefined;
+/**
+ * The buyer-country gate on the Stripe methods outside the wallet row (iDEAL,
+ * Bancontact, …). The buyer's live country (the AVS select, else the static
+ * `country`) is matched against `enabledPaymentMethodCountries`: a method
+ * without an entry, or with an empty list, has no gate. Without the map, the
+ * built-in country table ({@link filterStripeMethodsByCountry}) decides. With
+ * no country, nothing is filtered and `methods` is returned as it is.
+ */
+declare function filterStripeMethodsByCountryGate(methods: string[], country: string | null | undefined, enabledPaymentMethodCountries: Record<string, string[]> | undefined): string[];
+/**
+ * Whether the session can route cards to a gateway the billing API processes
+ * entirely server-side behind the hosted vault form — today the Worldpay
+ * Corporate Gateway (TeamFloPay/backend#1563). Such a gateway has no browser
+ * runtime or credentials, and its payment references are not Stripe objects.
+ */
+declare function hasServerSideCardGateway(session: CheckoutSession | null | undefined): boolean;
+/**
+ * Whether an open session can recover its hosted card form from
+ * `/vault/capture` when the read omitted the embedded block. A server-side
+ * card gateway is the explicit card capability; a terminal session has no
+ * form left to recover.
+ */
+declare function canRecoverHostedCardForm(session: CheckoutSession | null | undefined): boolean;
+
 /** Returns whether a checkout deliberately stops after placing an authorization hold. */
 declare function isAuthorizationOnlySession(session?: {
     captureMethod?: CaptureMethod;
@@ -2147,6 +2254,62 @@ declare function buildItemPayload(item: CheckoutItem, sessionCurrency: string):
  */
 declare function buildSubscriptionPayload(subscription: CheckoutSubscription, sessionCurrency: string): Record<string, unknown>;
 
+/**
+ * The `/process` request a checkout form sends when it continues a tokenized
+ * payment itself (React's `SplitCardForm` `processPaymentInternal`, moved here
+ * so every UI binding sends the same billing fields and analytics metadata).
+ */
+/** The billing inputs a checkout form holds when it posts `/process`. */
+interface CheckoutProcessAvsInput {
+    /** The resolved AVS config (`resolveAVSConfig(enableAVS)`), or none when AVS is off. */
+    avsConfig: AVSFieldConfig | null | undefined;
+    /** The buyer's selected billing country (ISO 3166-1 alpha-2). */
+    country: string;
+    zip?: string | null;
+    city?: string | null;
+    state?: string | null;
+    addressLine1?: string | null;
+    addressLine2?: string | null;
+}
+/** The analytics metadata a checkout form adds to its `/process` request. */
+interface CheckoutProcessMetadataInput extends CheckoutProcessAvsInput {
+    /** The form's `chv` prop, forwarded as is. */
+    chv?: string;
+    /** Whether AVS was enabled (the form's `avsCheck` prop). Sent as `false` when not set. */
+    avsCheck?: boolean;
+    /** `standard_checkout` or `embedded_checkout`. */
+    checkoutType?: string;
+    /** `default_layout`, `buttons_layout` or `custom_layout`. */
+    checkoutLayout?: string;
+}
+type ProcessAccountAddress = Pick<ProcessPaymentParams['accountData'], 'country' | 'zip' | 'city' | 'state' | 'addressLine1' | 'addressLine2'>;
+/**
+ * The address part of `/process`'s `accountData`: nothing without AVS.
+ * With AVS, the country and each field that is visible for that country and
+ * filled. When line 1 is collected but the state is hidden, the state is
+ * derived from the postcode (US/CA) so the provider's AVS still gets one.
+ */
+declare function buildProcessPaymentAvsAccount(input: CheckoutProcessAvsInput): ProcessAccountAddress;
+/**
+ * Which AVS fields were actually shown for the buyer's country, for
+ * analytics. Country-scoped rules (e.g. `['US', 'CA']`) are flattened to
+ * booleans. `undefined` without AVS.
+ */
+declare function buildProcessPaymentAvsExposure(avsConfig: AVSFieldConfig | null | undefined, country: string): AVSFieldConfig | undefined;
+/**
+ * The checkout analytics metadata on `/process`, in the order the released
+ * form sends it: `chv`, `avsCheck` (`false` when not set), `checkoutType`,
+ * `checkoutLayout` and the AVS exposure.
+ */
+declare function buildCheckoutProcessMetadata(input: CheckoutProcessMetadataInput): Pick<ProcessPaymentParams, 'chv' | 'avsCheck' | 'checkoutType' | 'checkoutLayout' | 'avsConfig'>;
+/** How the checkout is logged: React's `resolveCheckoutLogLayout`. */
+type CheckoutLogLayout = 'default_layout' | 'buttons_layout' | 'custom_layout';
+/**
+ * The checkout layout a `FloPayCheckout` reports: `custom_layout` when the
+ * merchant renders its own layout, else the built-in form's layout.
+ */
+declare function resolveCheckoutLogLayout(hasCustomLayout: boolean, layout: 'default' | 'buttons' | undefined): CheckoutLogLayout;
+
 /** FloPay environment — determines which billing API URL is used. */
 type FloPayEnvironment = 'staging' | 'production' | 'local';
 /**
@@ -2178,7 +2341,7 @@ declare function getConfiguredBillingApiUrl(): string;
 declare function getFloPayEnvironment(): FloPayEnvironment;
 
 /** Current SDK version. */
-declare const SDK_VERSION = "1.11.5";
+declare const SDK_VERSION = "1.11.6";
 /**
  * HTTP header the SDK sends on checkout-session create/read requests so the
  * backend can observe compatibility. Version 1.4.9 is the first release that
@@ -2696,6 +2859,36 @@ declare function buildCheckoutDisplayData(session: CheckoutSession, options?: Bu
 /** Return true only for a non-blank email accepted by the backend validator. */
 declare function isValidEmail(email: string | null | undefined): email is string;
 
+declare const EXTERNAL_METHOD_CALLBACK_GRACE_MS = 600;
+interface ExternalMethodFailureContext {
+    inAppBrowser: boolean;
+    handoffObserved: boolean;
+    /** May corroborate a recognized signal, but never determines classification. */
+    elapsedMs?: number;
+}
+interface ExternalMethodFailureClassification {
+    errorCode: 'POPUP_BLOCKED' | 'PROVIDER_RUNTIME_FAILED';
+    popupBlocked: boolean;
+    providerDeclined: boolean;
+    terminalReason: TelemetryTerminalReason;
+}
+/** One buyer-copy contract shared by wallets and both PayPal integrations. */
+declare function buildExternalMethodRecoveryMessage(displayName: string, popupBlocked: boolean, inAppBrowser: boolean): string;
+declare function sanitizeExternalFailureCode(value: unknown): string | undefined;
+declare function getProviderErrorCode(err: unknown): string | undefined;
+declare function getProviderDeclineCode(err: unknown): string | undefined;
+declare function isProviderDecline(err: unknown): boolean;
+declare function isPayPalAcknowledgementDeadWindow(err: unknown): boolean;
+/** Classifies only bounded, positive evidence; time by itself is never evidence. */
+declare function classifyExternalMethodFailure(err: unknown, context: ExternalMethodFailureContext): ExternalMethodFailureClassification;
+declare function isPopupBlockedError(err: unknown): boolean;
+
+/**
+ * The buyer-facing copy for a raw failure message: a known backend message is
+ * replaced, anything else is returned unchanged (`undefined` for a non-string).
+ */
+declare function applyFriendlyMessageOverride(message: string | undefined | null): string | undefined;
+
 /**
  * The Stripe Elements group asking for a usage. It only selects which of
  * today's values a legacy read (one without `futureUse`) keeps.
@@ -2776,6 +2969,25 @@ declare function generateIdempotencyKey(): string | undefined;
  */
 declare function resolveIdempotencyKey(supplied?: string): string | undefined;
 
+interface CachedInlineSession {
+    canonicalIdentity?: string;
+    sid: string;
+    nonce?: string;
+}
+interface CachedInlineIdempotencyKey {
+    canonicalIdentity?: string;
+    idempotencyKey: string;
+}
+declare function readCachedInlineSession(cacheKey: string, canonicalIdentity: string): CachedInlineSession | null;
+declare function readCachedInlineIdempotencyKey(cacheKey: string, canonicalIdentity: string): CachedInlineIdempotencyKey | null;
+declare function clearCachedInlineSession(cacheKey: string, canonicalIdentity: string): void;
+declare function clearCachedInlineCheckout(cacheKey: string, canonicalIdentity: string): void;
+declare function persistCachedInlineSession(cacheKey: string, canonicalIdentity: string, sid: string, nonce?: string): void;
+declare function persistCachedInlineIdempotencyKey(cacheKey: string, canonicalIdentity: string, idempotencyKey: string): void;
+declare function serializeCreateParams(params: InlineSessionDraft | undefined, includeRequestContext?: boolean): string;
+declare function hashCreateParams(params: InlineSessionDraft | undefined, includeRequestContext?: boolean): string;
+declare function legacyCachedSessionMatchesDraft(session: CheckoutSession | undefined, params: InlineSessionDraft): boolean;
+
 /** Schema version for the privacy-safe instrument callback contract. */
 declare const FLO_INSTRUMENT_SCHEMA_VERSION: 1;
 /**
@@ -2826,6 +3038,229 @@ type FloInstrumentEvent = (FloInstrumentCommonFields & {
     phase: FloInstrumentErrorPhase;
 });
 
+/**
+ * Invoke merchant-owned code without allowing its failure to alter checkout.
+ * Failures stay local to the merchant console and are never sent as Flo
+ * telemetry because the SDK cannot act on merchant implementation errors.
+ * Every UI binding (`@flopay/react`, `@flopay/vue`) calls merchant callbacks
+ * through this one invoker.
+ */
+declare function invokeMerchantCallback(callback: (() => unknown) | undefined): void;
+/** An internal observation a UI binding may project onto the merchant instrument feed. */
+type FloInstrumentSource = {
+    class: 'lifecycle';
+    name: TelemetryLogName;
+    provider?: TelemetryProviderInput;
+} | {
+    class: 'technical_error';
+    errorCode: TelemetryErrorCode;
+    requestCategory?: TelemetryRequestCategory;
+    provider?: TelemetryProviderInput;
+} | {
+    class: 'card_surface';
+    provider?: TelemetryProviderInput;
+};
+/** Project the closed internal taxonomy onto the smaller merchant-safe v1 contract. */
+declare function projectFloInstrument(source: FloInstrumentSource): FloInstrumentEvent | null;
+/** Instruments a checkout emits at most once per checkout identity. */
+declare const FLO_INSTRUMENT_ONCE_NAMES: ReadonlySet<FloInstrumentEvent['name']>;
+
+/** One advertised Stripe wallet/APM, with the account the backend chose for it. */
+interface StripeSetupAdvertisement {
+    /** The Stripe payment method type (`apple_pay`, `sepa_debit`, ...). */
+    method: string;
+    /** This entry's own publishable key: the backend can pick an account per method. */
+    publishableKey: string;
+    /** The setup session's own currency, from the read. Never guessed. */
+    currency: string;
+}
+/** Direct PayPal vault flow a setup session advertises. */
+interface PayPalSetupAdvertisement {
+    clientId: string;
+    environment?: string;
+}
+/**
+ * The methods a setup session advertises. The SDK renders exactly these: no
+ * gateway selection, filtering or inference happens on the client.
+ */
+interface PaymentMethodSetupAdvertisement {
+    /** The hosted vault card widget (a `card` entry, or no advertisement at all). */
+    card: boolean;
+    /** Stripe wallets/APMs in advertised order. */
+    stripe: StripeSetupAdvertisement[];
+    paypal: PayPalSetupAdvertisement | null;
+    /** The setup session's own currency from the read, or `null` when it carries none. */
+    currency: string | null;
+    /**
+     * Stripe wallets/APMs the session advertises that are not rendered only
+     * because the read carries no currency, so a session that offers nothing
+     * else can say why instead of claiming it advertises nothing.
+     */
+    skippedForMissingCurrency: string[];
+}
+/**
+ * Read the advertisement from a normalized setup session. Only the session's
+ * `advertisedPaymentMethods` decides it (backend docs/card-setup.md,
+ * "Advertised payment methods"); the purchase-checkout gateway block is never
+ * read, since it lists nothing on a setup session.
+ *
+ * - Field absent (an older backend): the card only, exactly as `FloPayCardSetup`.
+ * - `family: "card"`: the hosted vault card widget.
+ * - `family: "wallet"` / `"apm"` with `providerType: "stripe"`: that Stripe
+ *   method, with the entry's own publishable key. Skipped when the read carries
+ *   no currency, and listed in `skippedForMissingCurrency`.
+ * - `family: "paypal"` (`paypal_vaulted`): the PayPal vault flow, with the
+ *   entry's key as the client id and its environment. It owns `paypal`, so a
+ *   Stripe-rendered `paypal` entry is not drawn a second time.
+ * - Anything else is skipped, never thrown on. The first entry for a
+ *   `paymentMethodType` wins.
+ */
+declare function readSetupAdvertisement(normalized: NormalizedCheckoutSession): PaymentMethodSetupAdvertisement;
+/** The marker of every method the advertisement renders, card first. */
+declare function advertisedMethodKeys(advertisement: PaymentMethodSetupAdvertisement): string[];
+/** Whether the advertisement offers anything to render. */
+declare function advertisesAnyMethod(advertisement: PaymentMethodSetupAdvertisement): boolean;
+/** The session-intent category for an advertised Stripe method. */
+declare function stripeMethodCategory(method: string): 'wallet' | 'apm';
+/** Which wording the outcome overlay uses: card wording only for the card widget. */
+type SetupOverlayWording = 'card' | 'payment_method';
+/** Processing / success / failure overlay labels for a setup outcome. */
+declare function setupOverlayLabels(wording: SetupOverlayWording): {
+    processingLabel: string;
+    successLabel: string;
+    errorLabel: string;
+};
+
+/**
+ * The buyer identity an express surface attaches to the checkout: the
+ * session-patch `account` shape (email and names, plus any other account
+ * fields the click-time patch carried).
+ */
+type PayPalBuyerIdentity = NonNullable<InlineSessionPatch['account']>;
+/**
+ * Trims the names and drops empty ones. Express continuations use empty name
+ * markers to clear hydrated fallbacks through JSON checkpoints
+ * (`preserveMissingNames`); the final process payload strips them again.
+ */
+declare function compactBuyerIdentity(identity: PayPalBuyerIdentity, preserveMissingNames?: boolean): PayPalBuyerIdentity;
+/** Splits a full name at the first whitespace run; a card-holder placeholder is no name. */
+declare function splitFullName(name: string | null | undefined): {
+    firstName?: string;
+    lastName?: string;
+};
+/** The payer PayPal reports for an approved order (`actions.order.get()`). */
+declare function readPayPalPayerIdentity(details: unknown): PayPalBuyerIdentity;
+/**
+ * The buyer identity a PayPal approval starts from: the click-time account
+ * patch wins, then the host's `email` and `billingName`, then the session's
+ * customer.
+ */
+declare function resolvePayPalApprovalIdentity(input: {
+    accountPatch?: InlineSessionPatch['account'] | null;
+    email?: string | null;
+    billingName?: string | null;
+    session?: CheckoutSession | null;
+}): PayPalBuyerIdentity;
+/** Whether the approval still lacks a valid email or any name, so PayPal's payer is read. */
+declare function needsPayPalPayerDetails(identity: PayPalBuyerIdentity): boolean;
+/** Fills the approval identity's gaps from PayPal's order details; PayPal's payer wins per field. */
+declare function mergePayPalPayerIdentity(identity: PayPalBuyerIdentity, details: unknown): PayPalBuyerIdentity;
+/**
+ * Whether a PayPal approval must collect the buyer's email itself: no valid
+ * email is known from the host or the session.
+ */
+declare function paypalProviderIdentityRequired(email: string | null | undefined, session: CheckoutSession | null | undefined): boolean;
+/**
+ * Chooses a PayPal presentation without ever hiding PayPal. Deterministic
+ * non-popup modes are limited to one-time Orders in an in-app browser and
+ * require the backend's advertisement.
+ */
+declare function resolvePayPalPresentationMode(environment: PayPalBrowserEnvironment, advertisedCapability: TelemetryPresentationMode | undefined, providerObjectType: PayPalProviderObjectType): TelemetryPresentationMode;
+
+/**
+ * Whether the configured PayPal object rides the Flo-owned `paypal_vaulted`
+ * channel. An explicitly configured `order` or `setup_token` (the session's
+ * advertisement, or the deprecated prop as a fallback) does. A legacy session
+ * with neither, and an advertised provider-managed `subscription`, keep the
+ * released `paypal` requests byte-identical.
+ */
+declare function usesPayPalVaultedChannel(configuredObjectType: PayPalProviderObjectType | undefined): boolean;
+/**
+ * The `/intents` request body for a direct PayPal button. The payment-method
+ * type is the in-band channel selector: the Flo-owned channel asks for
+ * `paypal_vaulted` (with `intentKind: 'setup'` for a vault setup token); the
+ * legacy channel asks for `paypal` with `intentKind: 'payment'`.
+ */
+declare function buildPayPalSessionIntentRequest(configuredObjectType: PayPalProviderObjectType | undefined): PayPalSessionIntentRequest;
+/**
+ * The tokenized body for PayPal's approval token. A vault setup token and an
+ * advertised order carry the Flo-owned channel so the backend can continue on
+ * it; the legacy fallback keeps the released body byte-identical.
+ */
+declare function buildPayPalTokenizedBody(token: string, configuredObjectType: PayPalProviderObjectType | undefined): TokenizedBody;
+/** What a direct PayPal button knows when it completes an approval itself. */
+interface PayPalProcessPaymentInput {
+    /** The approval's tokenized body ({@link buildPayPalTokenizedBody}). */
+    body: TokenizedBody;
+    /** The session the attempt runs on (the click-time patch's, else the button's). */
+    sessionId: string;
+    /** The checkout session token for the attempt. */
+    nonce: string | undefined;
+    /** The click-time account patch from `runBeforeButtonClick`. */
+    accountPatch?: InlineSessionPatch['account'];
+    /** The checkout session, for the buyer's identity and address. */
+    session?: CheckoutSession | null;
+    /** The button's `email` prop. */
+    email?: string;
+}
+/**
+ * The `/process` call a direct PayPal button makes when no host takes the
+ * tokenized body: the click-time account patch wins, then the session's
+ * customer, then its account data. Returns the (vestigial) user id argument
+ * and the request, in the field order the released button sends.
+ */
+declare function buildPayPalProcessPaymentRequest(input: PayPalProcessPaymentInput): {
+    userId: string;
+    params: ProcessPaymentParams;
+};
+/**
+ * The buyer-facing message for a failed PayPal payment: the raw message (or
+ * the generic fallback) through the shared friendly-message override.
+ */
+declare function friendlyPayPalFailureMessage(rawMessage: string | undefined): string;
+/** A rejected PayPal `/process` response body, read for the buyer message and the decline codes. */
+declare function describePayPalProcessFailure(json: Record<string, unknown> | null): {
+    message: string;
+    code: string | undefined;
+    declineCode: string | undefined;
+};
+/**
+ * The `providerDeclineReason` a PayPal decline reports to `/intents/decline`:
+ * the provider's decline code, then its error code, then the generic reason.
+ */
+declare function resolvePayPalDeclineReason(error: unknown): string;
+/**
+ * Zoid (PayPal's iframe framework) reports its own teardown through `onError`:
+ * "zoid destroyed all components", a closed window, a removed container. Those
+ * are page navigation or unmounting, not payment errors, so no binding shows
+ * them to the buyer.
+ */
+declare function isPayPalTeardownMessage(message: string | undefined): boolean;
+
+/** Privacy-bounded browser context shared by PayPal presentation and telemetry. */
+interface PayPalBrowserEnvironment {
+    inAppBrowser: boolean;
+    appFamily: TelemetryAppFamily;
+    popupCapability: TelemetryPopupCapability;
+}
+/**
+ * Classifies an in-app browser without retaining or returning its user agent.
+ *
+ * Static UA evidence cannot prove that a popup will open, so capability stays
+ * `unknown`; runtime lifecycle evidence is reported separately.
+ */
+declare function detectPayPalEnvironment(userAgent?: string): PayPalBrowserEnvironment;
+
 /**
  * Postal-code → state derivation for AVS.
  *
@@ -2878,6 +3313,55 @@ declare function isValidPostalCode(country: string, postalCode: string): boolean
  */
 declare function getPostalCodeExample(country: string): string | undefined;
 
+/** The submit-button style fields a themed tile copies (any CSS-like record). */
+interface PrimaryTileSubmitStyle {
+    color?: unknown;
+    border?: unknown;
+    borderRadius?: unknown;
+    boxShadow?: unknown;
+}
+/** Inputs for {@link derivePrimaryTileStyle}. */
+interface PrimaryTileStyleSource {
+    themeBundle: ThemeBundle | null | undefined;
+    resolvedPrimaryColor: string;
+    resolvedBorderRadius: string;
+    submitButtonStyle?: PrimaryTileSubmitStyle | undefined;
+    /**
+     * Raw `appearance.colorPrimary` (undefined when the merchant didn't set one).
+     * When present it forces a primary-filled tile even with no theme bundle
+     * (the `classic` preset), so an explicit `colorPrimary` override always wins
+     * over the historic white tile.
+     */
+    explicitPrimaryColor?: string | undefined;
+}
+/** The colour and shape of a primary tile. */
+interface PrimaryTileStyle {
+    backgroundColor: string;
+    color: string;
+    border: string;
+    borderRadius: string | number;
+    boxShadow?: string | undefined;
+}
+/**
+ * Base colours for a primary tile (the buttons-layout card tile and the
+ * one-click button):
+ *
+ * - `'classic'` / no theme: white background, grey border — historic look
+ *   that lines up with the wallet ECE row's flat tiles.
+ * - Any theme bundle (`modern-*`, `bold-*`, `glass-*`): `colorPrimary`
+ *   (`resolvedPrimaryColor` — already merged with any `appearance` override)
+ *   drives the `backgroundColor`, exactly like the "Confirm Payment" submit
+ *   CTA, so all three flo buttons (submit, card, auto-pay) share one fill and
+ *   a per-checkout `colorPrimary` override re-skins every one of them. The
+ *   bundle's `submitButton` still supplies `color` / `border` / `borderRadius`
+ *   / `boxShadow` so typography + shape stay on-theme. Hover (`colorPrimaryHover`)
+ *   is applied by each button's mouse-enter / mouse-leave at the call site.
+ */
+declare function derivePrimaryTileStyle(opts: PrimaryTileStyleSource): PrimaryTileStyle;
+
+declare function markSessionRecentlyCompleted(sessionId: string | null | undefined): void;
+declare function wasSessionRecentlyCompleted(sessionId: string | null | undefined): boolean;
+
 interface SentryStackFrameLike {
     in_app?: boolean;
     filename?: string;
@@ -2900,6 +3384,67 @@ interface SentryEventLike {
  */
 declare function dropThirdPartyOnlyError<T extends SentryEventLike>(event: T): T | null;
 
+/**
+ * A `FloPayAppearance` whose `theme` has been normalized to the set Stripe's
+ * Appearance API accepts, so it can be handed straight to Stripe Elements
+ * without tripping Stripe.js's `Invalid value … provided to "theme"` warning.
+ */
+interface StripeSafeAppearance {
+    theme: 'stripe' | 'night' | 'flat';
+    variables?: FloPayThemeVariables;
+    rules?: Record<string, Record<string, string>>;
+}
+/** Maps FloPay's public appearance token to Stripe's accepted theme set. */
+declare function toStripeAppearanceTheme(theme: 'default' | 'flat' | 'night' | 'none' | undefined): 'stripe' | 'night' | 'flat';
+/**
+ * Normalizes a FloPay appearance before a UI binding passes it to Stripe
+ * Elements. Lives here, free of Stripe.js, so the Stripe-free entries and
+ * every UI binding share one mapping (TeamFloPay/sdk#410, CTO decision 1).
+ */
+declare function toStripeAppearance(appearance: FloPayAppearance): StripeSafeAppearance;
+
+/**
+ * Selects the safe Stripe-routed PayPal surface for the active checkout mount
+ * from the merchant's `walletPresentation` preference. An in-app browser, a
+ * pop-up the browser blocked, or `prefer_redirect` gives the full-page
+ * redirect; anything else keeps the pop-up. Moved from @flopay/react's
+ * `in-app-browser.ts` so @flopay/vue resolves `walletPresentation` the same way.
+ */
+declare function resolveStripePayPalPresentation(environment: PayPalBrowserEnvironment, preference: WalletPresentation, popupCapability?: TelemetryPopupCapability): 'popup' | 'redirect';
+/**
+ * Storage key carrying the effective session / nonce / account patch across a
+ * Stripe-routed PayPal redirect, so the return can `/process` against the same
+ * session PayPal authorized (an inline-session bootstrap inside the click gate
+ * would otherwise be lost when the page reloads after the PayPal round-trip).
+ */
+declare const STRIPE_PAYPAL_RESUME_KEY = "flopay_paypal_resume";
+/** The query parameters Stripe appends to the return URL after a redirect. */
+declare const STRIPE_REDIRECT_PARAMS: readonly ["payment_intent", "payment_intent_client_secret", "redirect_status"];
+interface StripePayPalResumeContinuation<TAccount = unknown> {
+    clientSecret?: string;
+    sessionId?: string;
+    nonce?: string;
+    accountPatch?: TAccount;
+}
+/** `[payment_intent, payment_intent_client_secret, redirect_status]` from the current URL. */
+declare function readStripeRedirectParams(): [string | null, string | null, string | null];
+/** The current URL without Stripe's redirect parameters (the PayPal `return_url`). */
+declare function stripeRedirectReturnUrl(): string;
+/**
+ * The saved continuation, only when it belongs to `clientSecret`, so a stale
+ * payload from a prior attempt can't replay against a different PaymentIntent.
+ */
+declare function readMatchingStripePayPalContinuation<TAccount = unknown>(clientSecret: string | null): StripePayPalResumeContinuation<TAccount> | null;
+/** Whether this page load is the return of a Stripe-routed PayPal redirect this browser started. */
+declare function hasMatchingStripePayPalReturn(): boolean;
+/**
+ * Saves the continuation, or removes it when called without one. Returns
+ * whether storage accepted the change (a redirect must not start without it).
+ */
+declare function writeStripePayPalContinuation(continuation?: StripePayPalResumeContinuation): boolean;
+/** Consumes the continuation and strips Stripe's redirect parameters from the URL. */
+declare function clearStripePayPalReturn(): void;
+
 interface ClassifiedTelemetryFailure {
     errorCode: TelemetryErrorCode;
     statusClass: TelemetryStatusClass;
@@ -2953,6 +3498,34 @@ declare function isSetupIntentClientSecret(clientSecret: string | null | undefin
 /** Treat the checkout's normalized fallback cardholder sentinel as absent. */
 declare function isCardHolderNamePlaceholder(...nameParts: Array<string | null | undefined>): boolean;
 
+/**
+ * Darken a `#rrggbb` color by `amount` (0–1) — used to derive a flo-button hover
+ * shade from the primary when the theme doesn't supply an explicit
+ * `colorPrimaryHover`. Returns the input unchanged for non-hex values.
+ */
+declare function darkenHex(hex: string, amount?: number): string;
+/** Pass through CSS font-weight values; anything else resolves to undefined. */
+declare function toCssWeight(value: string | number | undefined): string | number | undefined;
+/** Inputs for {@link computeVaultCardThemeColors}. */
+interface VaultThemeSource {
+    /** Stripe-side appearance (a theme bundle's, or the merchant's override). */
+    appearance?: FloPayAppearance | undefined;
+    /** Resolved buttons-layout styles (bundle + merchant overrides merged). */
+    buttonsStyles: ButtonsLayoutStyles;
+    /** Surrounding layout — affects the neutral border fallback. */
+    layout?: 'default' | 'buttons';
+}
+/**
+ * Colors pushed into the hosted vault widget so the backend-rendered card form
+ * matches the merchant's theme. The SDK owns *all* theming here — every value
+ * resolves from the theme bundle / appearance overrides (same precedence the
+ * SDK uses for its merchant-hosted AVS inputs); the backend ships only neutral
+ * fallbacks for when a var is absent. Shared by `SplitCardForm` (checkout) and
+ * `FloPayCardSetup` (no-charge card setup) so one `theme` value renders the
+ * same hosted card form everywhere.
+ */
+declare function computeVaultCardThemeColors({ appearance, buttonsStyles, layout, }: VaultThemeSource): VaultCardThemeColors;
+
 /**
  * Production card-capture verification (TeamFloPay/backend#1920, sdk#414).
  *
@@ -2998,4 +3571,31 @@ interface VaultMountContext {
  */
 declare function resolveVaultMountOptions(block: VaultCaptureBlock | null | undefined, context: VaultMountContext): CardCaptureMountOptions | null;
 
-export { ASYNC_AUTO_CHECKOUT_CAPABILITY, type AVSFieldConfig, type AdvertisedPaymentMethod, BILLING_API_URL, BILLING_API_URL_PRODUCTION, BILLING_API_URL_STAGING, BOLD_DARK_APPEARANCE, BOLD_LIGHT_APPEARANCE, BUTTONS_LAYOUT_BOLD_DARK, BUTTONS_LAYOUT_BOLD_LIGHT, BUTTONS_LAYOUT_DARK, BUTTONS_LAYOUT_DEFAULT, BUTTONS_LAYOUT_GLASS_DARK, BUTTONS_LAYOUT_GLASS_LIGHT, BUTTONS_LAYOUT_MINIMAL, BUTTONS_LAYOUT_MODERN_DARK, BUTTONS_LAYOUT_MODERN_LIGHT, BUTTONS_LAYOUT_ROUNDED, type BeforeButtonClickEvent, type BillingDetails, type BillingProvider, type BuildCheckoutDisplayDataOptions, type BuildTelemetryErrorEventInput, type BuildTelemetryLogEventInput, type BuildTelemetryPerformanceEventInput, type BuildTelemetryTerminalEventInput, type ButtonsLayoutStyles, type ButtonsLayoutTheme, CA_PROVINCES, CHECKOUT_PROCESSING_TIMEOUT_MESSAGE, COUNTRY_OPTIONS, CURRENCY_MAP, type CaptureMethod, type CardCaptureAdapter, type CardCaptureEventType, type CardCaptureMountOptions, type CardCaptureOutcomeEvent, type CardCaptureProviderId, type CardSetupFutureUse, type CheckoutAccount, type CheckoutButtonMethod, type CheckoutDisplayData, type CheckoutFailureOutcome, type CheckoutGateway, type CheckoutGateways, type CheckoutItem, type CheckoutMetadata, type CheckoutMode, type CheckoutModeKind, type CheckoutProcessError, type CheckoutProcessingPending, type CheckoutProduct, type CheckoutProductType, type CheckoutSession, type CheckoutSessionMode, type CheckoutSessionProduct, type CheckoutSessionResult, type CheckoutSubscription, type ClassifiedTelemetryFailure, type CountryOption, type CreateCardSetupSessionRequest, type CreateCustomerParams, type CreateSessionIntentRequest, type CreateSessionParams, type CurrencyInfo, type Customer, DEFAULT_API_BASE_URL, DEFAULT_API_VERSION, DEFAULT_APPEARANCE, DEFAULT_CURRENCY, type DeclineEvent, type DetachedCheckoutSession, type DisplayLineItem, type ExternalMethodFailureDetails, FLAT_APPEARANCE, FLO_INSTRUMENT_CATALOG, FLO_INSTRUMENT_SCHEMA_VERSION, FLO_SDK_CAPABILITIES_HEADER, FLO_SDK_VERSION_HEADER, type FloInstrumentErrorPhase, type FloInstrumentEvent, type FloInstrumentLifecycleName, type FloPayAppearance, type FloPayConfig, type FloPayEnvironment, FloPayError, type FloPayErrorType, type FloPayThemeVariables, type FutureUseSessionFields, type FutureUseSurface, type FutureUseUnsupportedMethod, GLASS_DARK_APPEARANCE, GLASS_LIGHT_APPEARANCE, type GatewayEnvironment, IDEMPOTENCY_IN_PROGRESS_CODE, IDEMPOTENCY_KEY_HEADER, type InlineSessionDraft, type InlineSessionParams, type InlineSessionPatch, type LineItem, type ListSavedPaymentMethodsQuery, MAX_IDEMPOTENCY_KEY_LENGTH, MODERN_DARK_APPEARANCE, MODERN_LIGHT_APPEARANCE, NIGHT_APPEARANCE, type NonCardPaymentMethodCategory, type NormalizedCheckoutSession, type NormalizedGatewayEnvironment, PAYPAL_VAULTED_PAYMENT_METHOD_TYPE, type PayPalApprovalPresentation, type PayPalPaymentResult, type PayPalProviderObjectType, type PayPalSessionIntent, type PayPalSessionIntentRequest, type PaymentMethodRemovalConflictCode, type PaymentMethodRemovalConflictError, type PaymentMethodRemovalError, type PaymentMethodRemovalFailureReason, type PaymentMethodRemovalNotFoundError, type PaymentMethodRemovalRetryableError, type PaymentProviderAdapter, type PaymentResult, type PriceData, type ProcessPaymentParams, type RecurringInterval, SAVED_PAYMENT_METHOD_FAMILIES, SAVED_PAYMENT_METHOD_LIST_TYPES, SAVED_PAYMENT_METHOD_TYPES, SDK_VERSION, STORED_PAYMENT_METHOD_UNSUPPORTED_CODE, STORED_PAYMENT_METHOD_UNSUPPORTED_MESSAGE, STRIPE_EXPRESS_METHODS, STRIPE_METHOD_AMOUNT_LIMITS, STRIPE_METHOD_COUNTRIES, STRIPE_METHOD_CURRENCIES, STRIPE_METHOD_MATRIX, SUPPORTED_CARD_BRANDS, type SavedCardDisplay, type SavedCardPaymentMethodDisplay, type SavedOtherPaymentMethodDisplay, type SavedPaymentMethodDisplay, type SavedPaymentMethodFamily, type SavedPaymentMethodListType, type SavedPaymentMethodStatus, type SavedPaymentMethodType, type SentryEventLike, type SentryStackFrameLike, type SerializeTelemetryBatchOptions, type SessionIntent, type SessionIntentDeclineRequest, type StateOption, type StoredPaymentMethodOutcomeCode, type StripeMethodEntry, type StripeMethodThemeVariant, type StripeSessionIntent, type StripeSessionIntentRequest, TELEMETRY_ERROR_CODES, TELEMETRY_FAILURE_CATEGORIES, TELEMETRY_LOG_NAMES, TELEMETRY_MAX_BATCH_BYTES, TELEMETRY_MAX_BATCH_EVENTS, TELEMETRY_SCHEMA_VERSION, TELEMETRY_SDK_PACKAGES, THEMES, THREE_DS_CHALLENGE_WINDOW_MS, type TagsData, type TelemetryAppFamily, type TelemetryBatchEnvelope, type TelemetryCheckoutMode, type TelemetryDurationMode, type TelemetryErrorCode, type TelemetryErrorEvent, type TelemetryErrorReason, type TelemetryEvent, type TelemetryEventClass, type TelemetryExpectedOutcome, type TelemetryExpectedOutcomeEvent, type TelemetryFailureCategory, type TelemetryLayout, type TelemetryLogEvent, type TelemetryLogName, type TelemetryPaymentMethodCategory, type TelemetryPerformanceEvent, type TelemetryPopupCapability, type TelemetryPresentationMode, type TelemetryProvider, type TelemetryProviderInput, type TelemetryRequestCategory, type TelemetrySdkPackage, type TelemetryStage, type TelemetryStatusClass, type TelemetryTerminalReason, type ThemeBundle, type ThemeBundleId, type ThemeId, type TokenizedBody, US_STATES, UUID_V4, type UpdateCustomerParams, VAULT_CAPTURE_FORM_PATH, type VaultCaptureBlock, type VaultCaptureResultMessage, type VaultCardFieldKey, type VaultCardThemeColors, type VaultGradientStop, type VaultLinearGradientBackground, type VaultMountContext, type VaultShadowLayer, type VaultSolidBackground, type VaultSubmitBackground, type VaultSubmitButtonTheme, type VaultSubmitSpacing, type VaultSubmitTypography, type VaultThemeColor, type WalletPresentation, type WebhookEvent, apiError, assertCaptureMethodEligible, authenticationError, buildCheckoutDisplayData, buildItemPayload, buildProductPayload, buildSubscriptionPayload, buildTelemetryErrorEvent, buildTelemetryLogEvent, buildTelemetryPerformanceEvent, buildTelemetryTerminalEvent, classifyPaymentRejection, classifyTelemetryFailure, configureFlopay, dropThirdPartyOnlyError, filterStripeMethodsByAmount, filterStripeMethodsByCountry, filterStripeMethodsByCurrency, foldIntoProducts, generateIdempotencyKey, getConfiguredBillingApiUrl, getCountryByCode, getCurrencyByCountry, getFloPayEnvironment, getPostalCodeExample, getPostalCodeLabel, getStateFromPostalCode, getStateLabel, getStateOptions, getStripeMethodDisplayName, hasVendoredStripeMethodLogo, isAVSEnabled, isAVSFieldVisible, isAuthorizationOnlySession, isCardHolderNamePlaceholder, isCardSetupCheckoutSession, isDetachedSessionEligible, isMoneySettledOutcome, isMountableVaultBlock, isPostalCodeSupported, isSetupCheckoutSession, isSetupIntentClientSecret, isUuidV4, isValidEmail, isValidPostalCode, isValidPublishableKey, isValidSecretKey, isVaultVerificationRequired, needsStripeMethodExplicitConfirm, networkError, normalizeCheckoutFailureOutcome, normalizeGatewayEnvironment, partitionStripeMethods, randomUuidV4, rateLimitError, resolveAVSConfig, resolveBillingApiUrl, resolveButtonsLayoutTheme, resolveIdempotencyKey, resolveSessionCurrency, resolveSetupFutureUsage, resolveStripeMethodBrandVariant, resolveTheme, resolveVaultMountOptions, serializeTelemetryBatch, stripeExpressMethodToOptionKey, telemetryStatusClass, validationError };
+/**
+ * Deferred Stripe Elements mode for the wallet / Express Checkout row
+ * (Apple Pay, Google Pay), from the cart total due today.
+ *
+ * A $0-today cart (free trial) cannot run in `payment` mode: Stripe rejects a
+ * `$0` amount with "amount must be greater than 0", and the historic
+ * `amount: totalAmount || 100` floor surfaced a misleading **$1.00** charge on
+ * the wallet sheet. Those carts run in `setup` mode instead — the wallet
+ * collects the card for the trial with no amount shown, matching the backend's
+ * SetupIntent. Any positive amount keeps `payment` mode with the real total.
+ *
+ * Moved from `@flopay/react`'s `resolveWalletElementsMode` so `@flopay/react`
+ * and `@flopay/vue` decide the wallet row's mode, amount and capture method
+ * with one implementation. Each caller adds its method list and the usage
+ * from `resolveSetupFutureUsage`.
+ *
+ * @param amountInMinorUnits cart total due today, in the smallest currency unit.
+ * @param captureMethod capture contract used by the subsequently created intent.
+ */
+declare function resolveWalletModeOptions(amountInMinorUnits: number | undefined, captureMethod?: CaptureMethod): {
+    mode: 'setup';
+} | {
+    mode: 'payment';
+    amount: number;
+    captureMethod: 'automatic_async' | 'manual';
+};
+
+export { ASYNC_AUTO_CHECKOUT_CAPABILITY, type AVSFieldConfig, type AdvertisedPaymentMethod, BILLING_API_URL, BILLING_API_URL_PRODUCTION, BILLING_API_URL_STAGING, BOLD_DARK_APPEARANCE, BOLD_LIGHT_APPEARANCE, BUTTONS_LAYOUT_BOLD_DARK, BUTTONS_LAYOUT_BOLD_LIGHT, BUTTONS_LAYOUT_DARK, BUTTONS_LAYOUT_DEFAULT, BUTTONS_LAYOUT_GLASS_DARK, BUTTONS_LAYOUT_GLASS_LIGHT, BUTTONS_LAYOUT_MINIMAL, BUTTONS_LAYOUT_MODERN_DARK, BUTTONS_LAYOUT_MODERN_LIGHT, BUTTONS_LAYOUT_ROUNDED, type BeforeButtonClickEvent, type BillingDetails, type BillingProvider, type BuildCheckoutDisplayDataOptions, type BuildTelemetryErrorEventInput, type BuildTelemetryLogEventInput, type BuildTelemetryPerformanceEventInput, type BuildTelemetryTerminalEventInput, type ButtonsLayoutStyles, type ButtonsLayoutTheme, CA_PROVINCES, CHECKOUT_PROCESSING_TIMEOUT_MESSAGE, COUNTRY_OPTIONS, CURRENCY_MAP, type CaptureMethod, type CardCaptureAdapter, type CardCaptureEventType, type CardCaptureMountOptions, type CardCaptureOutcomeEvent, type CardCaptureProviderId, type CardSetupFutureUse, type CheckoutAccount, type CheckoutButtonMethod, type CheckoutDisplayData, type CheckoutFailureOutcome, type CheckoutGateway, type CheckoutGateways, type CheckoutItem, type CheckoutLogLayout, type CheckoutMetadata, type CheckoutMode, type CheckoutModeKind, type CheckoutProcessAvsInput, type CheckoutProcessError, type CheckoutProcessMetadataInput, type CheckoutProcessingPending, type CheckoutProduct, type CheckoutProductType, type CheckoutSession, type CheckoutSessionMode, type CheckoutSessionProduct, type CheckoutSessionResult, type CheckoutSubscription, type ClassifiedTelemetryFailure, type CountryOption, type CreateCardSetupSessionRequest, type CreateCustomerParams, type CreateSessionIntentRequest, type CreateSessionParams, type CurrencyInfo, type Customer, DEFAULT_API_BASE_URL, DEFAULT_API_VERSION, DEFAULT_APPEARANCE, DEFAULT_CURRENCY, type DeclineEvent, type DetachedCheckoutSession, type DirectPayPalConfig, type DirectPayPalGatewaySource, type DisplayLineItem, EXTERNAL_METHOD_CALLBACK_GRACE_MS, type ExternalMethodFailureClassification, type ExternalMethodFailureContext, type ExternalMethodFailureDetails, FLAT_APPEARANCE, FLO_INSTRUMENT_CATALOG, FLO_INSTRUMENT_ONCE_NAMES, FLO_INSTRUMENT_SCHEMA_VERSION, FLO_SDK_CAPABILITIES_HEADER, FLO_SDK_VERSION_HEADER, type FloInstrumentErrorPhase, type FloInstrumentEvent, type FloInstrumentLifecycleName, type FloInstrumentSource, type FloPayAppearance, type FloPayConfig, type FloPayEnvironment, FloPayError, type FloPayErrorType, type FloPayThemeVariables, type FutureUseSessionFields, type FutureUseSurface, type FutureUseUnsupportedMethod, GLASS_DARK_APPEARANCE, GLASS_LIGHT_APPEARANCE, type GatewayEnvironment, IDEMPOTENCY_IN_PROGRESS_CODE, IDEMPOTENCY_KEY_HEADER, type InlineSessionDraft, type InlineSessionParams, type InlineSessionPatch, type LineItem, type ListSavedPaymentMethodsQuery, MAX_IDEMPOTENCY_KEY_LENGTH, MODERN_DARK_APPEARANCE, MODERN_LIGHT_APPEARANCE, NIGHT_APPEARANCE, type NonCardPaymentMethodCategory, type NormalizedCheckoutSession, type NormalizedGatewayEnvironment, PAYPAL_VAULTED_PAYMENT_METHOD_TYPE, type PayPalApprovalPresentation, type PayPalBrowserEnvironment, type PayPalBuyerIdentity, type PayPalPaymentResult, type PayPalProcessPaymentInput, type PayPalProviderObjectType, type PayPalSessionIntent, type PayPalSessionIntentRequest, type PaymentMethodRemovalConflictCode, type PaymentMethodRemovalConflictError, type PaymentMethodRemovalError, type PaymentMethodRemovalFailureReason, type PaymentMethodRemovalNotFoundError, type PaymentMethodRemovalRetryableError, type PaymentMethodSetupAdvertisement, type PaymentProviderAdapter, type PaymentResult, type PriceData, type PrimaryTileStyle, type PrimaryTileStyleSource, type PrimaryTileSubmitStyle, type ProcessPaymentParams, type ProcessingOverlayStatus, type ProcessingOverlayThemeColors, type RecurringInterval, SAVED_PAYMENT_METHOD_FAMILIES, SAVED_PAYMENT_METHOD_LIST_TYPES, SAVED_PAYMENT_METHOD_TYPES, SDK_VERSION, STORED_PAYMENT_METHOD_UNSUPPORTED_CODE, STORED_PAYMENT_METHOD_UNSUPPORTED_MESSAGE, STRIPE_EXPRESS_METHODS, STRIPE_METHOD_AMOUNT_LIMITS, STRIPE_METHOD_COUNTRIES, STRIPE_METHOD_CURRENCIES, STRIPE_METHOD_MATRIX, STRIPE_PAYPAL_RESUME_KEY, STRIPE_REDIRECT_PARAMS, SUPPORTED_CARD_BRANDS, type SavedCardDisplay, type SavedCardPaymentMethodDisplay, type SavedOtherPaymentMethodDisplay, type SavedPaymentMethodDisplay, type SavedPaymentMethodFamily, type SavedPaymentMethodListType, type SavedPaymentMethodStatus, type SavedPaymentMethodType, type SentryEventLike, type SentryStackFrameLike, type SerializeTelemetryBatchOptions, type SessionIntent, type SessionIntentDeclineRequest, type SetupOverlayWording, type StateOption, type StoredPaymentMethodOutcomeCode, type StripeMethodEntry, type StripeMethodThemeVariant, type StripePayPalResumeContinuation, type StripeSafeAppearance, type StripeSessionIntent, type StripeSessionIntentRequest, TELEMETRY_ERROR_CODES, TELEMETRY_FAILURE_CATEGORIES, TELEMETRY_LOG_NAMES, TELEMETRY_MAX_BATCH_BYTES, TELEMETRY_MAX_BATCH_EVENTS, TELEMETRY_SCHEMA_VERSION, TELEMETRY_SDK_PACKAGES, THEMES, THREE_DS_CHALLENGE_WINDOW_MS, type TagsData, type TelemetryAppFamily, type TelemetryBatchEnvelope, type TelemetryCheckoutMode, type TelemetryDurationMode, type TelemetryErrorCode, type TelemetryErrorEvent, type TelemetryErrorReason, type TelemetryEvent, type TelemetryEventClass, type TelemetryExpectedOutcome, type TelemetryExpectedOutcomeEvent, type TelemetryFailureCategory, type TelemetryLayout, type TelemetryLogEvent, type TelemetryLogName, type TelemetryPaymentMethodCategory, type TelemetryPerformanceEvent, type TelemetryPopupCapability, type TelemetryPresentationMode, type TelemetryProvider, type TelemetryProviderInput, type TelemetryRequestCategory, type TelemetrySdkPackage, type TelemetryStage, type TelemetryStatusClass, type TelemetryTerminalReason, type ThemeBundle, type ThemeBundleId, type ThemeId, type TokenizedBody, US_STATES, UUID_V4, type UpdateCustomerParams, VAULT_CAPTURE_FORM_PATH, type VaultCaptureBlock, type VaultCaptureResultMessage, type VaultCardFieldKey, type VaultCardThemeColors, type VaultGradientStop, type VaultLinearGradientBackground, type VaultMountContext, type VaultShadowLayer, type VaultSolidBackground, type VaultSubmitBackground, type VaultSubmitButtonTheme, type VaultSubmitSpacing, type VaultSubmitTypography, type VaultThemeColor, type VaultThemeSource, type WalletPresentation, type WebhookEvent, advertisedMethodKeys, advertisesAnyMethod, apiError, applyFriendlyMessageOverride, assertCaptureMethodEligible, authenticationError, buildCheckoutDisplayData, buildCheckoutProcessMetadata, buildExternalMethodRecoveryMessage, buildItemPayload, buildPayPalProcessPaymentRequest, buildPayPalSessionIntentRequest, buildPayPalTokenizedBody, buildProcessPaymentAvsAccount, buildProcessPaymentAvsExposure, buildProductPayload, buildSubscriptionPayload, buildTelemetryErrorEvent, buildTelemetryLogEvent, buildTelemetryPerformanceEvent, buildTelemetryTerminalEvent, canRecoverHostedCardForm, classifyExternalMethodFailure, classifyPaymentRejection, classifyTelemetryFailure, clearCachedInlineCheckout, clearCachedInlineSession, clearStripePayPalReturn, compactBuyerIdentity, computeCardSetupOverlayTheme, computeVaultCardThemeColors, configureFlopay, darkenHex, derivePrimaryTileStyle, describePayPalProcessFailure, detectPayPalEnvironment, dropThirdPartyOnlyError, filterStripeMethodsByAmount, filterStripeMethodsByCountry, filterStripeMethodsByCountryGate, filterStripeMethodsByCurrency, foldIntoProducts, friendlyPayPalFailureMessage, generateIdempotencyKey, getButtonMethodLabel, getConfiguredBillingApiUrl, getCountryByCode, getCurrencyByCountry, getFloPayEnvironment, getPostalCodeExample, getPostalCodeLabel, getProviderDeclineCode, getProviderErrorCode, getStateFromPostalCode, getStateLabel, getStateOptions, getStripeMethodDisplayName, hasMatchingStripePayPalReturn, hasServerSideCardGateway, hasVendoredStripeMethodLogo, hashCreateParams, invokeMerchantCallback, isAVSEnabled, isAVSFieldVisible, isAuthorizationOnlySession, isCardHolderNamePlaceholder, isCardSetupCheckoutSession, isDetachedSessionEligible, isMoneySettledOutcome, isMountableVaultBlock, isPayPalAcknowledgementDeadWindow, isPayPalTeardownMessage, isPopupBlockedError, isPostalCodeSupported, isProviderDecline, isSetupCheckoutSession, isSetupIntentClientSecret, isUuidV4, isValidEmail, isValidPostalCode, isValidPublishableKey, isValidSecretKey, isVaultVerificationRequired, legacyCachedSessionMatchesDraft, markSessionRecentlyCompleted, mergeCardSetupSurface, mergePayPalPayerIdentity, needsPayPalPayerDetails, needsStripeMethodExplicitConfirm, networkError, normalizeBeforeButtonClickError, normalizeCheckoutFailureOutcome, normalizeGatewayEnvironment, partitionStripeMethods, paypalProviderIdentityRequired, persistCachedInlineIdempotencyKey, persistCachedInlineSession, projectFloInstrument, randomUuidV4, rateLimitError, readCachedInlineIdempotencyKey, readCachedInlineSession, readMatchingStripePayPalContinuation, readPayPalPayerIdentity, readSetupAdvertisement, readStripeRedirectParams, resolveAVSConfig, resolveBillingApiUrl, resolveButtonsLayoutTheme, resolveCheckoutLogLayout, resolveDirectPaypalConfig, resolveIdempotencyKey, resolvePayPalApprovalIdentity, resolvePayPalDeclineReason, resolvePayPalPresentationMode, resolveSessionCurrency, resolveSetupFutureUsage, resolveStripeMethodBrandVariant, resolveStripePayPalPresentation, resolveTheme, resolveVaultMountOptions, resolveWalletModeOptions, sanitizeExternalFailureCode, serializeCreateParams, serializeTelemetryBatch, setupOverlayLabels, splitFullName, stripeExpressMethodToOptionKey, stripeMethodCategory, stripeRedirectReturnUrl, telemetryStatusClass, toCssWeight, toStripeAppearance, toStripeAppearanceTheme, usesPayPalVaultedChannel, validationError, wasSessionRecentlyCompleted, writeStripePayPalContinuation };