import { components } from '@amos.com/node';
/**
 * PCI-safe snapshot of card/bank form validity, posted when HTML
 * constraint validation changes. Use this to enable or disable a host
 * checkout button.
 */
export type PaymentMethodFormValidityChangeEvent = {
    isValid: boolean;
};
/**
 * Detected card network from the PAN prefix inside the iframe.
 * `null` when the field is empty or the digits do not match a known brand.
 */
export type CardBrand = "visa" | "mastercard" | "amex" | "discover" | "diners" | "jcb";
/**
 * PCI-safe card brand update from the credit-card iframe. Does not
 * include the PAN, last4, or BIN.
 */
export type PaymentMethodFormCardBrandChangeEvent = {
    brand: CardBrand | null;
};
/**
 * Confirm never heard back from the iframe (or the iframe aborted
 * hung `/confirm`). Not a processor decline — the charge may still
 * settle. Do not retry as a new payment.
 */
export declare const CONFIRM_TIMEOUT_ERROR: "timeout";
export type ConfirmTimeoutError = typeof CONFIRM_TIMEOUT_ERROR;
export type ConfirmTimeoutResult = {
    status: "failed";
    error: ConfirmTimeoutError;
};
/**
 * Dead-iframe backstop for `confirmPayment` / `confirmSetup`.
 *
 * Embed aborts hung `/confirm` at 10s and posts
 * `{ status: "failed", error: "timeout" }`. This wait must stay strictly
 * above that abort plus `postMessage` — do not set it to 10s.
 */
export declare const CONFIRM_TIMEOUT_MS = 15000;
/**
 * Outcome of `confirmPayment`. This is not settlement proof — capture
 * may still finish asynchronously after a succeeded authorization.
 *
 * Recoverable field errors stay in the iframe. The Promise still
 * resolves `{ status: "failed" }`. `paymentIntent` is present when the
 * confirm API returned a body (success or processor decline).
 *
 * `{ status: "failed", error: "timeout" }` means the iframe did not
 * post `CONFIRMATION_RESULT` within {@link CONFIRM_TIMEOUT_MS}, or
 * posted a `/confirm` abort. That is uncertain, not a decline.
 */
export type ConfirmPaymentResult = {
    status: "succeeded";
    paymentIntent: components["schemas"]["PaymentIntent"];
} | ConfirmTimeoutResult | {
    status: "failed";
    paymentIntent?: components["schemas"]["PaymentIntent"];
};
/**
 * Outcome of `confirmSetup`. This is not settlement proof — verify
 * setup success on your backend via webhooks.
 *
 * Recoverable field errors stay in the iframe. The Promise still
 * resolves `{ status: "failed" }`. `setupIntent` is present when the
 * confirm API returned a body (success or failure).
 *
 * `{ status: "failed", error: "timeout" }` is the same uncertain
 * confirm as on {@link ConfirmPaymentResult}.
 */
export type ConfirmSetupResult = {
    status: "succeeded";
    setupIntent: components["schemas"]["SetupIntent"];
} | ConfirmTimeoutResult | {
    status: "failed";
    setupIntent?: components["schemas"]["SetupIntent"];
};
/** True when confirm settled as a timeout, not a processor decline. */
export declare function isConfirmTimeout(result: ConfirmPaymentResult | ConfirmSetupResult | null | undefined): result is ConfirmTimeoutResult;
/**
 * Street fields on {@link WalletCustomerCreateAttributes} billing and
 * shipping addresses. Names match Amos `BillingAddressInput`
 * (`address_line1`, `state`, `postal_code`).
 */
export type WalletPostalAddress = Pick<components["schemas"]["BillingAddressInput"], "address_line1" | "address_line2" | "city" | "state" | "postal_code" | "country">;
/**
 * Customer snapshot posted on wallet `CREATE_PAYMENT_INTENT` and passed
 * to Apple Pay / Google Pay `onConfirm`. Name, email, and billing
 * address are always requested; `phone` and `shippingAddress` are only
 * present when the host opted in (`phoneRequired` /
 * `shippingAddressRequired`).
 *
 * Nested `billingAddress` / `shippingAddress` use Amos billing field
 * names (`address_line1`, `state`, `postal_code`). This is not Amos API
 * `CreateCustomerInput`.
 */
export type WalletCustomerCreateAttributes = {
    email?: string;
    name?: string;
    phone?: string;
    billingAddress?: WalletPostalAddress;
    shippingAddress?: WalletPostalAddress;
};
/**
 * Optional wallet sheet contact fields. Name, email, and billing
 * address are always required. Omitted flags default to `false`.
 * These are top-level mount / listener options, not `buttonProps`.
 */
export type WalletContactRequirements = {
    /**
     * Collect a phone number in the wallet sheet.
     * @default false
     */
    phoneRequired?: boolean;
    /**
     * Collect a shipping postal address in the wallet sheet.
     * @default false
     */
    shippingAddressRequired?: boolean;
};
/**
 * CSS custom properties that control the appearance of the embedded
 * Amos iframe UI. Only the variables you provide are sent; omitted
 * variables keep their defaults.
 */
export type ThemeVariable = "--background" | "--foreground" | "--primary" | "--primary-foreground" | "--secondary" | "--secondary-foreground" | "--muted" | "--muted-foreground" | "--accent" | "--accent-foreground" | "--destructive" | "--destructive-foreground" | "--border" | "--popover" | "--popover-foreground" | "--input" | "--input-background" | "--input-height" | "--input-font-size" | "--input-font-weight" | "--input-padding" | "--input-border-width" | "--input-shadow" | "--floating-input-height" | "--floating-label-font-size" | "--floating-label-empty-font-size" | "--floating-label-font-weight" | "--floating-label-color" | "--floating-label-floated-color" | "--floating-label-offset" | "--label-font-size" | "--label-font-weight" | "--field-gap" | "--control-gap" | "--error-font-size" | "--radio-size" | "--ring" | "--ring-width" | "--radius" | "--font-family";
/**
 * A stylesheet that declares `@font-face` rules (Google Fonts CSS, a
 * self-hosted CSS file, etc.). `cssSrc` must be an `https:` URL.
 */
export type CssFontSource = {
    cssSrc: string;
};
/**
 * A single custom `@font-face` rule. `src` is a CSS `src` list of
 * `url("https://…")` / `url(https://…)` plus optional `format(…)`.
 */
export type CustomFontSource = {
    family: string;
    src: string;
    /**
     * @default "swap"
     */
    display?: string;
    style?: string;
    unicodeRange?: string;
    weight?: string;
};
/**
 * A webfont to load inside the payment iframe. Either a CSS stylesheet
 * URL or a custom `@font-face` descriptor.
 */
export type FontSource = CssFontSource | CustomFontSource;
/**
 * Stripe-style class names for {@link Appearance.rules}. Mapped onto
 * iframe `data-slot` targets internally; the DOM is not the public API.
 */
export type AppearanceRuleSelector = ".Input" | ".Input:hover" | ".Input:focus" | ".Input:disabled" | ".Input--invalid" | ".Input::placeholder" | ".Label" | ".Label--floating" | ".Error" | ".Dropdown" | ".DropdownItem" | ".DropdownItem--highlight" | ".RadioIcon" | ".RadioIcon--checked" | ".RadioIconInner";
/**
 * CamelCase CSS properties allowed on {@link Appearance.rules}.
 */
export type AppearanceRuleProperty = "fontFamily" | "fontSize" | "fontWeight" | "fontStyle" | "lineHeight" | "letterSpacing" | "textTransform" | "color" | "backgroundColor" | "border" | "borderColor" | "borderWidth" | "borderStyle" | "borderRadius" | "boxShadow" | "outline" | "padding" | "margin" | "opacity";
export type AppearanceRuleDeclarations = Partial<Record<AppearanceRuleProperty, string>>;
/**
 * Placement of field labels in payment method forms.
 *
 * - `above` — label text is rendered above the control (default).
 * - `floating` — label sits inside the control and shrinks when focused or filled.
 * - `placeholder` — no visible label; use placeholder text and `aria-label` only.
 */
export type AppearanceLabels = "above" | "floating" | "placeholder";
/**
 * Appearance overrides for the embedded Amos iframe UI.
 */
export type Appearance = {
    /**
     * CSS custom properties to override. Each update that includes
     * `themeVariables` **replaces** the full override set: only the
     * variables you list are overridden; unlisted variables revert to
     * iframe defaults. Omit `themeVariables` to keep the previous set.
     * A payload that omits `--font-family` still gets Inter filled in
     * (system stack if that payload also has `fonts: []`).
     */
    themeVariables?: Partial<Record<ThemeVariable, string>>;
    /**
     * Field label placement for card and bank account forms.
     *
     * @default "above"
     */
    labels?: AppearanceLabels;
    /**
     * Webfonts to load in the iframe. Omitted on first paint, the SDK
     * sends Google Fonts Inter. Omitted on `update({ appearance })` keeps
     * the previous set; a provided array replaces it. `[]` clears the
     * webfont; omitted `--font-family` on that payload uses a system
     * stack instead of Inter.
     */
    fonts?: Array<FontSource>;
    /**
     * Per-part CSS, keyed by Stripe-style class names (`.Input`, `.Label`,
     * `.Error`, …). Overrides `themeVariables` for the properties it sets.
     * Values may use `var(--token)` for allowlisted theme variables.
     * Omitted on `update({ appearance })` keeps the previous set; a
     * provided object replaces it (`{}` clears).
     */
    rules?: Partial<Record<AppearanceRuleSelector, AppearanceRuleDeclarations>>;
};
/**
 * Apple's `<apple-pay-button>` attributes. `@types/applepayjs` only
 * covers `ApplePaySession`, so this bag is the custom element's HTML
 * attributes plus inner `style`. Posted as-is on `buttonProps`.
 *
 * Omitted fields keep the painted button's defaults. Height belongs on
 * the mount `height` option.
 *
 * @see https://developer.apple.com/documentation/apple_pay_on_the_web/apple-pay-button
 */
export type ApplePayButtonElementProps = {
    /**
     * Apple Pay button color.
     *
     * @default "black"
     */
    buttonstyle?: string;
    /**
     * Apple Pay button label / verb.
     *
     * @default "plain"
     */
    type?: string;
    /**
     * BCP 47 locale for the button label (e.g. `"en-US"`).
     *
     * @default "en-US"
     */
    locale?: string;
    /**
     * Inline style for the `<apple-pay-button>`. Omitted keys keep fill
     * (`width: 100%` and `--apple-pay-button-width`).
     */
    style?: Record<string, string | number | undefined>;
};
/**
 * Google Pay button visuals: {@link google.payments.api.ButtonOptions}
 * without the fields that cannot go through `postMessage`, plus inner
 * `style`. Posted as-is on `buttonProps`.
 *
 * Omitted fields keep the painted button's defaults (`buttonType:
 * "plain"`, `buttonSizeMode: "fill"`). Height belongs on the mount
 * `height` option.
 *
 * @see https://developers.google.com/pay/api/web/guides/resources/customize
 */
export type GooglePayButtonElementProps = Omit<google.payments.api.ButtonOptions, "onClick" | "buttonRootNode" | "allowedPaymentMethods"> & {
    /**
     * Inline style for the Google Pay button wrapper. Omitted keys keep
     * fill (`width: 100%`).
     */
    style?: Record<string, string | number | undefined>;
};
/**
 * Non-PCI values the host can seed into the card or bank iframe.
 *
 * `name` maps to cardholder name or account holder name depending on
 * which form is mounted. Billing fields that are not shown still go on
 * the confirm payload when present.
 *
 * Never send PAN, CVC, account number, or routing number here.
 */
export type PaymentMethodFormDefaultValues = {
    name?: string;
    billingAddress?: {
        line1?: string;
        line2?: string;
        city?: string;
        state?: string;
        postalCode?: string;
        country?: string;
    };
};
/**
 * Named controls inside the card or bank iframe. Card-only ids are a
 * no-op on the bank form and vice versa. Hidden / unmounted controls
 * are also a no-op.
 */
export type PaymentMethodFormField = "cardNumber" | "expiration" | "cvc" | "cardholderName" | "accountHolderName" | "accountNumber" | "confirmAccountNumber" | "routingNumber" | "accountType" | "accountHolderType" | "addressLine1" | "addressLine2" | "city" | "state" | "postalCode" | "country";
/**
 * Typed `postMessage` payloads exchanged between the host page and the
 * embedded Amos iframe.
 */
export type Message = {
    /** Embed → parent: iframe finished loading and is ready for messages. */
    type: "IFRAME_READY";
} | {
    /** Parent → embed: host acknowledged `IFRAME_READY`. */
    type: "PARENT_ACKNOWLEDGED_IFRAME_READY";
} | {
    /** Embed → parent: iframe content height changed (resize container). */
    type: "UPDATE_HEIGHT";
    height: string;
} | {
    /**
     * Parent → embed: express-checkout amount changed. Major-currency
     * decimal string (e.g. `"50.00"` for $50.00).
     */
    type: "UPDATE_AMOUNT";
    amount: string;
} | {
    /** Parent → embed: express-checkout merchant display name changed. */
    type: "UPDATE_MERCHANT_NAME";
    merchantName: string;
} | {
    /** Parent → embed: push appearance overrides into the iframe. */
    type: "UPDATE_APPEARANCE";
    appearance: Appearance;
} | {
    /** Parent → embed: Apple Pay button visuals and contact flags. */
    type: "UPDATE_APPLE_PAY_BUTTON";
    height?: string;
    props: ApplePayButtonElementProps;
    phoneRequired?: boolean;
    shippingAddressRequired?: boolean;
} | {
    /** Parent → embed: Google Pay button visuals and contact flags. */
    type: "UPDATE_GOOGLE_PAY_BUTTON";
    height?: string;
    props: GooglePayButtonElementProps;
    phoneRequired?: boolean;
    shippingAddressRequired?: boolean;
} | {
    /**
     * Parent → embed: validate form inputs (`requestId` only).
     * Embed → parent: validation response (`isValid` set).
     */
    type: "VALIDATE_FORM";
    requestId: string;
    isValid?: boolean;
} | {
    /** Embed → parent: express checkout requests a payment intent from the host. */
    type: "CREATE_PAYMENT_INTENT";
    paymentIntentCreateAttributes: components["schemas"]["CreatePaymentIntentInput"];
    customerCreateAttributes: WalletCustomerCreateAttributes;
} | ({
    /** Parent → embed: confirm a payment intent with an embed token. */
    type: "CONFIRM_PAYMENT_INTENT";
} & Pick<components["schemas"]["PaymentIntent"], "id"> & Pick<components["schemas"]["EmbedToken"], "token"> & {
    /** Present when ACH verification completed via Plaid Link in the parent. */
    plaid?: components["schemas"]["PlaidCredentialsInput"];
    /**
     * Applied immediately before building `payment_method`. Does not
     * replace the last mount/`update` defaultValues used by RESET_FORM.
     */
    defaultValues?: PaymentMethodFormDefaultValues;
}) | ({
    /** Parent → embed: confirm a setup intent with an embed token. */
    type: "CONFIRM_SETUP_INTENT";
} & Pick<components["schemas"]["SetupIntent"], "id"> & Pick<components["schemas"]["EmbedToken"], "token"> & {
    /** Present when ACH verification completed via Plaid Link in the parent. */
    plaid?: components["schemas"]["PlaidCredentialsInput"];
    /**
     * Applied immediately before building `payment_method`. Does not
     * replace the last mount/`update` defaultValues used by RESET_FORM.
     */
    defaultValues?: PaymentMethodFormDefaultValues;
}) | {
    /** Parent → embed: seed or overwrite name and billing address fields. */
    type: "UPDATE_DEFAULT_VALUES";
    defaultValues: PaymentMethodFormDefaultValues;
} | {
    /** Parent → embed: focus a named form control. No-op if unmounted. */
    type: "FOCUS_FIELD";
    field: PaymentMethodFormField;
} | {
    /**
     * Embed → parent: the interactive confirmation flow finished.
     * Parent → embed: express-checkout initiation failed on the host.
     * Not settlement proof — verify payment/setup success on your
     * backend via webhooks (or by retrieving the intent).
     */
    type: "CONFIRMATION_RESULT";
    result: ConfirmPaymentResult | ConfirmSetupResult;
} | {
    /** Embed → parent: appearance overrides were applied in the iframe. */
    type: "UPDATED_APPEARANCE";
} | {
    /** Embed → parent: Apple Pay Code window / waiting UI should show. */
    type: "APPLE_PAY_WINDOW_OPEN";
} | {
    /**
     * Embed → parent: waiting UI should dismiss (cancel before authorize,
     * abort, or session error — not authorize). After authorize the
     * overlay stays until `onConfirm` settles.
     */
    type: "APPLE_PAY_WINDOW_CLOSE";
} | {
    /**
     * Parent → embed: user cancelled from the host-page waiting overlay.
     * Only offered before authorize; the overlay hides Cancel once
     * `CREATE_PAYMENT_INTENT` arrives.
     */
    type: "APPLE_PAY_CANCEL";
} | {
    /** Parent → embed: clear all form field values and API errors. */
    type: "RESET_FORM";
} | {
    /**
     * Embed → parent: card/bank form validity changed.
     * `isValid` is true when all required fields are present and
     * valid. Does not include PCI data.
     */
    type: "FORM_VALIDITY_CHANGE";
    isValid: boolean;
} | {
    /**
     * Embed → parent: the customer pressed Enter in the iframe form.
     * PCI-safe — no field values. The SDK submits the enclosing host
     * `<form>` (same as Stripe Elements). No-op without a host form,
     * or while Plaid Embedded Institution Search is showing.
     */
    type: "FORM_SUBMIT_REQUEST";
} | {
    /**
     * Embed → parent: the customer pressed Escape in the iframe.
     * PCI-safe — no field values. Use `onEscapeKeyPressed` to close a
     * host modal. Not posted while an iframe dropdown or address
     * suggestion list is open (that Escape dismisses the overlay
     * first). No-op while Plaid Embedded Institution Search is
     * showing.
     */
    type: "ESCAPE_KEY_PRESSED";
} | {
    /**
     * Embed → parent: detected card brand changed. `brand` is the
     * matched network, or `null` when the field is empty or the
     * digits do not match a known brand. Does not include PCI data.
     */
    type: "CARD_BRAND_CHANGE";
    brand: CardBrand | null;
} | {
    /** Parent → embed: mint a Plaid Link token for Embedded Link. */
    type: "CREATE_PLAID_LINK_TOKEN";
    requestId: string;
} | {
    /** Embed → parent: minted Plaid Link token, or `error`. */
    type: "PLAID_LINK_TOKEN";
    requestId: string;
    link_token?: string;
    error?: string;
};
/**
 * Identity helper that brands an object as a typed `Message`.
 *
 * Useful when constructing `postMessage` payloads to ensure they conform
 * to the schema understood by the embedded Amos iframe.
 */
export declare function createMessage(message: Message): Message;