bitsnap-react 1.17.0 → 1.18.1

package/dist/index.d.mts

@@ -4,7 +4,7 @@ import { S as SlotAppearance, A as AppearanceElements } from './appearance-core-
 export { PRODUCT_LIST_SLOT_NAMES, ProductList, ProductListAppearance, ProductListAppearanceElements, ProductListAppearanceTokens, ProductListData, ProductListItemContext, ProductListProps, ProductListSlotAppearance, ProductListSlotName, ProductListTextKey, ProductListTexts, ProductListTheme, PublicListProduct, UseProductsOptions, UseProductsResult, formatProductPrice, useProducts } from './catalog.mjs';
 export { BitsnapReturns, BitsnapReturnsProps, BitsnapReturnsProvider, BitsnapReturnsProviderProps, CreateReturnInput, Environment, LegacyCreateReturnInput, LegacyReturnsTexts, LegacyReturnsTheme, ReturnsAppearanceProvider, ReturnsChallenge, ReturnsCodeStep, ReturnsCodeStepProps, ReturnsConfirmation, ReturnsConfirmationProps, ReturnsEmailStep, ReturnsEmailStepProps, ReturnsEnvironment, ReturnsEnvironmentInput, ReturnsMyReturnDetail, ReturnsMyReturnDetailProps, ReturnsMyReturnsList, ReturnsMyReturnsListProps, ReturnsOrderDetail, ReturnsOrderDetailProps, ReturnsOrderList, ReturnsOrderListProps, ReturnsProvider, ReturnsProviderProps, ReturnsResult, ReturnsResultProps, ReturnsSessionStatus, ReturnsTextsInput, SelectedReturnLine, UseCreateReturnResult, UseMyReturnResult, UseMyReturnsResult, UseReturnOrdersResult, UseReturnSessionResult, UseReturnableOrderResult, useCreateReturn, useMyReturn, useMyReturns, useReturnOrders, useReturnSession, useReturnableOrder, useReturnsAppearance, useReturnsSlot, useReturnsText } from './returns.mjs';
 export { b as RETURNS_SLOT_NAMES, R as ReturnsAppearance, c as ReturnsAppearanceElements, d as ReturnsAppearanceTokens, e as ReturnsSlotAppearance, f as ReturnsSlotName, h as ReturnsTextKey, a as ReturnsTexts, g as ReturnsTheme } from './texts-LGhuQfA9.mjs';
-import { ReactNode } from 'react';
+import { CSSProperties, ReactNode } from 'react';
 import z__default from 'zod';
 import { P as PanelLoginProps, a as PanelProps, G as GetThemeOutput } from './types-D6LsoycW.mjs';
 export { b as PanelScreen, c as PanelSearchParamsType } from './types-D6LsoycW.mjs';
@@ -207,6 +207,26 @@ type CheckoutTexts = {
     paymentMethodCodDescription: string;
     /** Error shown when the shop refused cash on delivery for the order. */
     paymentMethodCodUnavailable: string;
+    /** Status while the provider confirms a payment started from an express button. */
+    expressPending: string;
+    /** Status after the provider confirmed the payment. */
+    expressConfirmed: string;
+    /** Status when the provider reports a failed payment. */
+    expressFailed: string;
+    /** Status when the buyer cancelled the provider's payment flow. */
+    expressCancelled: string;
+    /** Shown while the payment is still unconfirmed after a page return. */
+    expressPendingLong: string;
+    /** Error shown when the provider's button could not be loaded. */
+    expressLoadFailed: string;
+    /** Error shown when the cart cannot be paid with this provider right now. */
+    expressCartUnavailable: string;
+    /** Error shown when another tab/provider changed the same cart line. */
+    expressCartConflict: string;
+    /** Shown when the server total changed between mounting and paying. */
+    expressPriceChanged: string;
+    /** Error shown when a product could not be added before the InPost binding. */
+    expressProductUnavailable: string;
 };
 
 type BitsnapCartProps = {
@@ -265,6 +285,256 @@ type Props$2 = {
 };
 declare function Wrapper$1(props: Props$2): react_jsx_runtime.JSX.Element;
 
+type CartEnvironment = "test" | "production";
+type CartSnapshotLine = {
+    lineId: string;
+    /** The id the cart was uploaded with; the same id `/buy` takes. */
+    productId: string;
+    variantId: string;
+    quantity: number;
+    name: string;
+    imageUrl?: string;
+    unitPriceMinor: number;
+    lineTotalMinor: number;
+    tax?: number;
+    currency: string;
+};
+type CartSnapshot = {
+    cartId: string;
+    revision: number;
+    status: "open" | "bound" | "checkout" | "ordered" | "expired";
+    environment: CartEnvironment;
+    currency: string;
+    locale: string;
+    lines: CartSnapshotLine[];
+    subtotalMinor: number;
+    deliveryMinor: number;
+    discountMinor: number;
+    totalMinor: number;
+    couponCode?: string;
+    expiresAt: number;
+};
+
+type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+
+/** Official `binding_place` values this SDK exposes. */
+declare const INPOST_BINDING_PLACES: readonly ["PRODUCT_CARD", "BASKET_SUMMARY", "MINICART_PAGE", "CHECKOUT_PAGE", "ORDER_CREATE", "THANK_YOU_PAGE"];
+type InPostBindingPlace = (typeof INPOST_BINDING_PLACES)[number];
+
+/**
+ * React glue between the express client and the buttons. Everything is
+ * browser-only: nothing is requested while rendering on the server, and no
+ * state is shared between two projects or two hosts.
+ */
+type ExpressItem = {
+    id: string;
+    quantity: number;
+};
+
+/**
+ * InPost Pay on a product page or in a cart.
+ *
+ * The button is the official InPost Pay widget: this component renders its
+ * documented `<inpost-izi-button>` element, loads the widget lazily in the
+ * browser and gives it the documented callbacks. The basket itself is durable
+ * on Bitsnap: the first click uploads the cart, binds it through the InPost
+ * merchant API (server side) and returns only the basket key the widget needs.
+ *
+ * Nothing renders unless the backend says the provider is available with a
+ * public `merchantClientId`; a 501, an old backend or a missing credential
+ * shows no button at all.
+ */
+type InPostPayButtonProps = {
+    /**
+     * The Bitsnap project of the cart. Optional when the page already called
+     * `setProjectID(projectID)`; given here it is configured for the page.
+     */
+    projectID?: string;
+    /** Bitsnap host; defaults to the configured one. */
+    host?: string;
+    locale?: string;
+    /** Text overrides, as on `BitsnapCheckout`. */
+    texts?: Partial<CheckoutTexts>;
+    /** Checkout appearance tokens and slots for the status line. */
+    appearance?: CheckoutAppearance;
+    /**
+     * Explicit cart lines (a custom cart layout that is not the Bitsnap drawer).
+     * The SDK uploads and prices them; it never edits the merchant's own state.
+     * Omitted: the Bitsnap cart is the basket.
+     */
+    items?: ExpressItem[];
+    /** Product to add to the basket on click (product page placement). */
+    productId?: string;
+    /** Quantity of `productId`; default 1. */
+    quantity?: number;
+    /** Official widget placement; defaults to PRODUCT_CARD with `productId`, else BASKET_SUMMARY. */
+    bindingPlace?: InPostBindingPlace;
+    /** Official widget `variation` attribute (visual variant). */
+    variation?: string;
+    className?: string;
+    style?: CSSProperties;
+    /** Analytics of the buttons; on by default, `false` opts out. */
+    analytics?: AnalyticsOption;
+    /**
+     * Called after the browser's `orderCreated` event when the server status has
+     * been checked. The event is only a hint: `status` is `completed` only when
+     * the signed server-side order state confirms it.
+     */
+    onOrderCreated?: (info: {
+        providerOrderId?: string;
+        status?: "pending" | "completed" | "cancelled" | "failed";
+    }) => void;
+    /** After InPost changed the basket in its app; the canonical snapshot. */
+    onBasketChanged?: (snapshot: CartSnapshot) => void;
+    /** Test/custom fetch (for example a mocked storefront). */
+    fetch?: FetchLike;
+    /** Bounds for the server confirmation (tests use a fake sleep). */
+    confirmation?: {
+        timeoutMs?: number;
+        intervalMs?: number;
+        sleep?: (ms: number) => Promise<void>;
+        now?: () => number;
+    };
+};
+/**
+ * Standalone InPost Pay button for a product or cart page. Inside
+ * `<BitsnapCheckout>` the checkout renders this component itself.
+ */
+declare function InPostPayButton(props: InPostPayButtonProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Loader of the official Revolut Checkout embed script.
+ *
+ * The script is loaded only in the browser and only when a Revolut Pay button
+ * is about to render: it never runs during server rendering and never lands in
+ * the initial bundle of a page without the button. One `<script>` per mode is
+ * shared by every button on the page, including two shops using different
+ * public keys (the SDK is keyed per `payments()` call, not globally).
+ */
+type RevolutMode = "prod" | "sandbox";
+type RevolutPaymentEvent = {
+    type: "success";
+    orderId: string;
+} | {
+    type: "error";
+    error: {
+        message?: string;
+    };
+    orderId: string;
+} | {
+    type: "cancel";
+    dropOffState?: string;
+    orderId?: string;
+};
+type RevolutPayButtonStyle = {
+    height?: string;
+    size?: "large" | "small";
+    radius?: "none" | "small" | "large" | "round";
+    variant?: "dark" | "light" | "light-outlined";
+    action?: "donate" | "pay" | "subscribe" | "buy";
+};
+type RevolutPayPaymentOptions = {
+    currency: string;
+    totalAmount: number;
+    createOrder: () => Promise<{
+        publicId: string;
+    }>;
+    buttonStyle?: RevolutPayButtonStyle;
+    mobileRedirectUrls?: {
+        success: string;
+        failure: string;
+        cancel: string;
+    };
+    redirectUrls?: {
+        success: string;
+        failure: string;
+        cancel: string;
+    };
+    validate?: () => Promise<boolean> | boolean;
+};
+type RevolutPayModule = {
+    mount: (target: string | HTMLElement | null, options: RevolutPayPaymentOptions) => void;
+    on: {
+        (event: "click", callback: () => void): void;
+        (event: "payment", callback: (payload: RevolutPaymentEvent) => void): void;
+    };
+    destroy: () => void;
+};
+type RevolutPaymentsModule = {
+    revolutPay: RevolutPayModule;
+    destroy?: () => void;
+};
+type RevolutCheckoutNamespace = {
+    payments: (options: {
+        publicToken: string;
+        mode?: RevolutMode;
+        locale?: string;
+    }) => Promise<RevolutPaymentsModule>;
+};
+declare global {
+    interface Window {
+        RevolutCheckout?: RevolutCheckoutNamespace;
+    }
+}
+
+/**
+ * Revolut Pay, mounted through the official Revolut Checkout embed script.
+ *
+ * The SDK is lazy: it loads only after Bitsnap says the provider is available
+ * with a public `publicKey`, and only in the browser. The order is created by
+ * the server (`createOrder` calls Bitsnap), never by the browser's numbers.
+ *
+ * A widget `success` event is a UX signal only: the button shows "confirming"
+ * and asks Bitsnap (`revolut/status`) until the verified webhook settles the
+ * order. Only then are the purchased lines removed from the cart. Cancel,
+ * failure and timeout keep the cart exactly as it was.
+ */
+type RevolutPaymentOutcome = {
+    status: "completed";
+    orderId?: string;
+} | {
+    status: "pending";
+} | {
+    status: "failed";
+} | {
+    status: "cancelled";
+};
+type RevolutPayButtonProps = {
+    /** Bitsnap project; optional when the page called `setProjectID(...)`. */
+    projectID?: string;
+    host?: string;
+    locale?: string;
+    texts?: Partial<CheckoutTexts>;
+    appearance?: CheckoutAppearance;
+    /** Explicit cart lines for a custom cart layout; omitted: the Bitsnap cart. */
+    items?: ExpressItem[];
+    /** Product page support: uploads this product (with `quantity`) as the cart. */
+    productId?: string;
+    quantity?: number;
+    country?: string;
+    couponCode?: string;
+    /** Page the buyer returns to; defaults to the current page. */
+    returnUrl?: string;
+    cancelUrl?: string;
+    /** Official Revolut button appearance. */
+    buttonStyle?: RevolutPayButtonStyle;
+    className?: string;
+    style?: CSSProperties;
+    analytics?: AnalyticsOption;
+    /** Called with the browser-level outcome; `completed` is server-confirmed. */
+    onPaymentResult?: (outcome: RevolutPaymentOutcome) => void;
+    fetch?: FetchLike;
+    /** Polling bounds for the server confirmation (tests use a fake sleep). */
+    confirmation?: {
+        timeoutMs?: number;
+        intervalMs?: number;
+        sleep?: (ms: number) => Promise<void>;
+        now?: () => number;
+    };
+};
+/** Standalone Revolut Pay button for a product or cart page. */
+declare function RevolutPayButton(props: RevolutPayButtonProps): react_jsx_runtime.JSX.Element;
+
 type PublicNotificationGroup = {
     id: string;
     isOn?: boolean;
@@ -697,4 +967,4 @@ declare function persistReturnURL(returnURL: string | null): void;
 declare function readPersistedReturnURL(): string | null;
 declare function buildAccessTokenRedirect(returnURL: string, accessToken: string): string;
 
-export { AnalyticsOption, Wrapper$2 as ApplePayButton, type Props$3 as ApplePayButtonProps, Bitsnap, type BitsnapCartProps, BitsnapCart as BitsnapCheckout, type BuyErrorData, CHECKOUT_SLOT_NAMES, type CheckoutAppearance, type CheckoutAppearanceElements, type CheckoutAppearanceTokens, type CheckoutSlotAppearance, type CheckoutSlotName, type CheckoutTexts, type CheckoutTheme, type ComponentClassNames, type CreateCheckoutResult, type CustomizationTexts, GetThemeOutput, Wrapper$1 as GooglePayButton, type Props$2 as GooglePayButtonProps, ITEM_IDS_NOT_FOUND, type LinkRequest, type NotificationGroup, Wrapper as NotificationsComponent, type Props$1 as NotificationsComponentProps, type NotificationsComponentPublicProps, PanelPage as Panel, type PanelConfig, PanelLogin, PanelLoginProps, PanelProps, PanelProvider, type PublicNotificationGroup, PublicOrderPage, buildAccessTokenRedirect, createCheckout, createPaymentURL, getAllowedReturnOrigins, getLocale, getPanelConfig, getPaymentMethodChoice, getReferenceIfPossible, getReturnURLFromSearch, injectReferenceToRequestIfNeeded, persistReturnURL, readPersistedReturnURL, setAllowedReturnOrigins, setCustomHost, setHost, setLocale, setLoginURL, setPanelConfig, setProjectID as setPanelProjectID, setProjectID$1 as setProjectID, setTheme, usePanelConfig };
+export { AnalyticsOption, Wrapper$2 as ApplePayButton, type Props$3 as ApplePayButtonProps, Bitsnap, type BitsnapCartProps, BitsnapCart as BitsnapCheckout, type BuyErrorData, CHECKOUT_SLOT_NAMES, type CheckoutAppearance, type CheckoutAppearanceElements, type CheckoutAppearanceTokens, type CheckoutSlotAppearance, type CheckoutSlotName, type CheckoutTexts, type CheckoutTheme, type ComponentClassNames, type CreateCheckoutResult, type CustomizationTexts, type ExpressItem, GetThemeOutput, Wrapper$1 as GooglePayButton, type Props$2 as GooglePayButtonProps, ITEM_IDS_NOT_FOUND, InPostPayButton, type InPostPayButtonProps, type LinkRequest, type NotificationGroup, Wrapper as NotificationsComponent, type Props$1 as NotificationsComponentProps, type NotificationsComponentPublicProps, PanelPage as Panel, type PanelConfig, PanelLogin, PanelLoginProps, PanelProps, PanelProvider, type PublicNotificationGroup, PublicOrderPage, RevolutPayButton, type RevolutPayButtonProps, type RevolutPaymentOutcome, buildAccessTokenRedirect, createCheckout, createPaymentURL, getAllowedReturnOrigins, getLocale, getPanelConfig, getPaymentMethodChoice, getReferenceIfPossible, getReturnURLFromSearch, injectReferenceToRequestIfNeeded, persistReturnURL, readPersistedReturnURL, setAllowedReturnOrigins, setCustomHost, setHost, setLocale, setLoginURL, setPanelConfig, setProjectID as setPanelProjectID, setProjectID$1 as setProjectID, setTheme, usePanelConfig };

package/dist/index.d.ts

@@ -4,7 +4,7 @@ import { S as SlotAppearance, A as AppearanceElements } from './appearance-core-
 export { PRODUCT_LIST_SLOT_NAMES, ProductList, ProductListAppearance, ProductListAppearanceElements, ProductListAppearanceTokens, ProductListData, ProductListItemContext, ProductListProps, ProductListSlotAppearance, ProductListSlotName, ProductListTextKey, ProductListTexts, ProductListTheme, PublicListProduct, UseProductsOptions, UseProductsResult, formatProductPrice, useProducts } from './catalog.js';
 export { BitsnapReturns, BitsnapReturnsProps, BitsnapReturnsProvider, BitsnapReturnsProviderProps, CreateReturnInput, Environment, LegacyCreateReturnInput, LegacyReturnsTexts, LegacyReturnsTheme, ReturnsAppearanceProvider, ReturnsChallenge, ReturnsCodeStep, ReturnsCodeStepProps, ReturnsConfirmation, ReturnsConfirmationProps, ReturnsEmailStep, ReturnsEmailStepProps, ReturnsEnvironment, ReturnsEnvironmentInput, ReturnsMyReturnDetail, ReturnsMyReturnDetailProps, ReturnsMyReturnsList, ReturnsMyReturnsListProps, ReturnsOrderDetail, ReturnsOrderDetailProps, ReturnsOrderList, ReturnsOrderListProps, ReturnsProvider, ReturnsProviderProps, ReturnsResult, ReturnsResultProps, ReturnsSessionStatus, ReturnsTextsInput, SelectedReturnLine, UseCreateReturnResult, UseMyReturnResult, UseMyReturnsResult, UseReturnOrdersResult, UseReturnSessionResult, UseReturnableOrderResult, useCreateReturn, useMyReturn, useMyReturns, useReturnOrders, useReturnSession, useReturnableOrder, useReturnsAppearance, useReturnsSlot, useReturnsText } from './returns.js';
 export { b as RETURNS_SLOT_NAMES, R as ReturnsAppearance, c as ReturnsAppearanceElements, d as ReturnsAppearanceTokens, e as ReturnsSlotAppearance, f as ReturnsSlotName, h as ReturnsTextKey, a as ReturnsTexts, g as ReturnsTheme } from './texts-m6XQGZ6w.js';
-import { ReactNode } from 'react';
+import { CSSProperties, ReactNode } from 'react';
 import z__default from 'zod';
 import { P as PanelLoginProps, a as PanelProps, G as GetThemeOutput } from './types-ClFCVzk_.js';
 export { b as PanelScreen, c as PanelSearchParamsType } from './types-ClFCVzk_.js';
@@ -207,6 +207,26 @@ type CheckoutTexts = {
     paymentMethodCodDescription: string;
     /** Error shown when the shop refused cash on delivery for the order. */
     paymentMethodCodUnavailable: string;
+    /** Status while the provider confirms a payment started from an express button. */
+    expressPending: string;
+    /** Status after the provider confirmed the payment. */
+    expressConfirmed: string;
+    /** Status when the provider reports a failed payment. */
+    expressFailed: string;
+    /** Status when the buyer cancelled the provider's payment flow. */
+    expressCancelled: string;
+    /** Shown while the payment is still unconfirmed after a page return. */
+    expressPendingLong: string;
+    /** Error shown when the provider's button could not be loaded. */
+    expressLoadFailed: string;
+    /** Error shown when the cart cannot be paid with this provider right now. */
+    expressCartUnavailable: string;
+    /** Error shown when another tab/provider changed the same cart line. */
+    expressCartConflict: string;
+    /** Shown when the server total changed between mounting and paying. */
+    expressPriceChanged: string;
+    /** Error shown when a product could not be added before the InPost binding. */
+    expressProductUnavailable: string;
 };
 
 type BitsnapCartProps = {
@@ -265,6 +285,256 @@ type Props$2 = {
 };
 declare function Wrapper$1(props: Props$2): react_jsx_runtime.JSX.Element;
 
+type CartEnvironment = "test" | "production";
+type CartSnapshotLine = {
+    lineId: string;
+    /** The id the cart was uploaded with; the same id `/buy` takes. */
+    productId: string;
+    variantId: string;
+    quantity: number;
+    name: string;
+    imageUrl?: string;
+    unitPriceMinor: number;
+    lineTotalMinor: number;
+    tax?: number;
+    currency: string;
+};
+type CartSnapshot = {
+    cartId: string;
+    revision: number;
+    status: "open" | "bound" | "checkout" | "ordered" | "expired";
+    environment: CartEnvironment;
+    currency: string;
+    locale: string;
+    lines: CartSnapshotLine[];
+    subtotalMinor: number;
+    deliveryMinor: number;
+    discountMinor: number;
+    totalMinor: number;
+    couponCode?: string;
+    expiresAt: number;
+};
+
+type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+
+/** Official `binding_place` values this SDK exposes. */
+declare const INPOST_BINDING_PLACES: readonly ["PRODUCT_CARD", "BASKET_SUMMARY", "MINICART_PAGE", "CHECKOUT_PAGE", "ORDER_CREATE", "THANK_YOU_PAGE"];
+type InPostBindingPlace = (typeof INPOST_BINDING_PLACES)[number];
+
+/**
+ * React glue between the express client and the buttons. Everything is
+ * browser-only: nothing is requested while rendering on the server, and no
+ * state is shared between two projects or two hosts.
+ */
+type ExpressItem = {
+    id: string;
+    quantity: number;
+};
+
+/**
+ * InPost Pay on a product page or in a cart.
+ *
+ * The button is the official InPost Pay widget: this component renders its
+ * documented `<inpost-izi-button>` element, loads the widget lazily in the
+ * browser and gives it the documented callbacks. The basket itself is durable
+ * on Bitsnap: the first click uploads the cart, binds it through the InPost
+ * merchant API (server side) and returns only the basket key the widget needs.
+ *
+ * Nothing renders unless the backend says the provider is available with a
+ * public `merchantClientId`; a 501, an old backend or a missing credential
+ * shows no button at all.
+ */
+type InPostPayButtonProps = {
+    /**
+     * The Bitsnap project of the cart. Optional when the page already called
+     * `setProjectID(projectID)`; given here it is configured for the page.
+     */
+    projectID?: string;
+    /** Bitsnap host; defaults to the configured one. */
+    host?: string;
+    locale?: string;
+    /** Text overrides, as on `BitsnapCheckout`. */
+    texts?: Partial<CheckoutTexts>;
+    /** Checkout appearance tokens and slots for the status line. */
+    appearance?: CheckoutAppearance;
+    /**
+     * Explicit cart lines (a custom cart layout that is not the Bitsnap drawer).
+     * The SDK uploads and prices them; it never edits the merchant's own state.
+     * Omitted: the Bitsnap cart is the basket.
+     */
+    items?: ExpressItem[];
+    /** Product to add to the basket on click (product page placement). */
+    productId?: string;
+    /** Quantity of `productId`; default 1. */
+    quantity?: number;
+    /** Official widget placement; defaults to PRODUCT_CARD with `productId`, else BASKET_SUMMARY. */
+    bindingPlace?: InPostBindingPlace;
+    /** Official widget `variation` attribute (visual variant). */
+    variation?: string;
+    className?: string;
+    style?: CSSProperties;
+    /** Analytics of the buttons; on by default, `false` opts out. */
+    analytics?: AnalyticsOption;
+    /**
+     * Called after the browser's `orderCreated` event when the server status has
+     * been checked. The event is only a hint: `status` is `completed` only when
+     * the signed server-side order state confirms it.
+     */
+    onOrderCreated?: (info: {
+        providerOrderId?: string;
+        status?: "pending" | "completed" | "cancelled" | "failed";
+    }) => void;
+    /** After InPost changed the basket in its app; the canonical snapshot. */
+    onBasketChanged?: (snapshot: CartSnapshot) => void;
+    /** Test/custom fetch (for example a mocked storefront). */
+    fetch?: FetchLike;
+    /** Bounds for the server confirmation (tests use a fake sleep). */
+    confirmation?: {
+        timeoutMs?: number;
+        intervalMs?: number;
+        sleep?: (ms: number) => Promise<void>;
+        now?: () => number;
+    };
+};
+/**
+ * Standalone InPost Pay button for a product or cart page. Inside
+ * `<BitsnapCheckout>` the checkout renders this component itself.
+ */
+declare function InPostPayButton(props: InPostPayButtonProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Loader of the official Revolut Checkout embed script.
+ *
+ * The script is loaded only in the browser and only when a Revolut Pay button
+ * is about to render: it never runs during server rendering and never lands in
+ * the initial bundle of a page without the button. One `<script>` per mode is
+ * shared by every button on the page, including two shops using different
+ * public keys (the SDK is keyed per `payments()` call, not globally).
+ */
+type RevolutMode = "prod" | "sandbox";
+type RevolutPaymentEvent = {
+    type: "success";
+    orderId: string;
+} | {
+    type: "error";
+    error: {
+        message?: string;
+    };
+    orderId: string;
+} | {
+    type: "cancel";
+    dropOffState?: string;
+    orderId?: string;
+};
+type RevolutPayButtonStyle = {
+    height?: string;
+    size?: "large" | "small";
+    radius?: "none" | "small" | "large" | "round";
+    variant?: "dark" | "light" | "light-outlined";
+    action?: "donate" | "pay" | "subscribe" | "buy";
+};
+type RevolutPayPaymentOptions = {
+    currency: string;
+    totalAmount: number;
+    createOrder: () => Promise<{
+        publicId: string;
+    }>;
+    buttonStyle?: RevolutPayButtonStyle;
+    mobileRedirectUrls?: {
+        success: string;
+        failure: string;
+        cancel: string;
+    };
+    redirectUrls?: {
+        success: string;
+        failure: string;
+        cancel: string;
+    };
+    validate?: () => Promise<boolean> | boolean;
+};
+type RevolutPayModule = {
+    mount: (target: string | HTMLElement | null, options: RevolutPayPaymentOptions) => void;
+    on: {
+        (event: "click", callback: () => void): void;
+        (event: "payment", callback: (payload: RevolutPaymentEvent) => void): void;
+    };
+    destroy: () => void;
+};
+type RevolutPaymentsModule = {
+    revolutPay: RevolutPayModule;
+    destroy?: () => void;
+};
+type RevolutCheckoutNamespace = {
+    payments: (options: {
+        publicToken: string;
+        mode?: RevolutMode;
+        locale?: string;
+    }) => Promise<RevolutPaymentsModule>;
+};
+declare global {
+    interface Window {
+        RevolutCheckout?: RevolutCheckoutNamespace;
+    }
+}
+
+/**
+ * Revolut Pay, mounted through the official Revolut Checkout embed script.
+ *
+ * The SDK is lazy: it loads only after Bitsnap says the provider is available
+ * with a public `publicKey`, and only in the browser. The order is created by
+ * the server (`createOrder` calls Bitsnap), never by the browser's numbers.
+ *
+ * A widget `success` event is a UX signal only: the button shows "confirming"
+ * and asks Bitsnap (`revolut/status`) until the verified webhook settles the
+ * order. Only then are the purchased lines removed from the cart. Cancel,
+ * failure and timeout keep the cart exactly as it was.
+ */
+type RevolutPaymentOutcome = {
+    status: "completed";
+    orderId?: string;
+} | {
+    status: "pending";
+} | {
+    status: "failed";
+} | {
+    status: "cancelled";
+};
+type RevolutPayButtonProps = {
+    /** Bitsnap project; optional when the page called `setProjectID(...)`. */
+    projectID?: string;
+    host?: string;
+    locale?: string;
+    texts?: Partial<CheckoutTexts>;
+    appearance?: CheckoutAppearance;
+    /** Explicit cart lines for a custom cart layout; omitted: the Bitsnap cart. */
+    items?: ExpressItem[];
+    /** Product page support: uploads this product (with `quantity`) as the cart. */
+    productId?: string;
+    quantity?: number;
+    country?: string;
+    couponCode?: string;
+    /** Page the buyer returns to; defaults to the current page. */
+    returnUrl?: string;
+    cancelUrl?: string;
+    /** Official Revolut button appearance. */
+    buttonStyle?: RevolutPayButtonStyle;
+    className?: string;
+    style?: CSSProperties;
+    analytics?: AnalyticsOption;
+    /** Called with the browser-level outcome; `completed` is server-confirmed. */
+    onPaymentResult?: (outcome: RevolutPaymentOutcome) => void;
+    fetch?: FetchLike;
+    /** Polling bounds for the server confirmation (tests use a fake sleep). */
+    confirmation?: {
+        timeoutMs?: number;
+        intervalMs?: number;
+        sleep?: (ms: number) => Promise<void>;
+        now?: () => number;
+    };
+};
+/** Standalone Revolut Pay button for a product or cart page. */
+declare function RevolutPayButton(props: RevolutPayButtonProps): react_jsx_runtime.JSX.Element;
+
 type PublicNotificationGroup = {
     id: string;
     isOn?: boolean;
@@ -697,4 +967,4 @@ declare function persistReturnURL(returnURL: string | null): void;
 declare function readPersistedReturnURL(): string | null;
 declare function buildAccessTokenRedirect(returnURL: string, accessToken: string): string;
 
-export { AnalyticsOption, Wrapper$2 as ApplePayButton, type Props$3 as ApplePayButtonProps, Bitsnap, type BitsnapCartProps, BitsnapCart as BitsnapCheckout, type BuyErrorData, CHECKOUT_SLOT_NAMES, type CheckoutAppearance, type CheckoutAppearanceElements, type CheckoutAppearanceTokens, type CheckoutSlotAppearance, type CheckoutSlotName, type CheckoutTexts, type CheckoutTheme, type ComponentClassNames, type CreateCheckoutResult, type CustomizationTexts, GetThemeOutput, Wrapper$1 as GooglePayButton, type Props$2 as GooglePayButtonProps, ITEM_IDS_NOT_FOUND, type LinkRequest, type NotificationGroup, Wrapper as NotificationsComponent, type Props$1 as NotificationsComponentProps, type NotificationsComponentPublicProps, PanelPage as Panel, type PanelConfig, PanelLogin, PanelLoginProps, PanelProps, PanelProvider, type PublicNotificationGroup, PublicOrderPage, buildAccessTokenRedirect, createCheckout, createPaymentURL, getAllowedReturnOrigins, getLocale, getPanelConfig, getPaymentMethodChoice, getReferenceIfPossible, getReturnURLFromSearch, injectReferenceToRequestIfNeeded, persistReturnURL, readPersistedReturnURL, setAllowedReturnOrigins, setCustomHost, setHost, setLocale, setLoginURL, setPanelConfig, setProjectID as setPanelProjectID, setProjectID$1 as setProjectID, setTheme, usePanelConfig };
+export { AnalyticsOption, Wrapper$2 as ApplePayButton, type Props$3 as ApplePayButtonProps, Bitsnap, type BitsnapCartProps, BitsnapCart as BitsnapCheckout, type BuyErrorData, CHECKOUT_SLOT_NAMES, type CheckoutAppearance, type CheckoutAppearanceElements, type CheckoutAppearanceTokens, type CheckoutSlotAppearance, type CheckoutSlotName, type CheckoutTexts, type CheckoutTheme, type ComponentClassNames, type CreateCheckoutResult, type CustomizationTexts, type ExpressItem, GetThemeOutput, Wrapper$1 as GooglePayButton, type Props$2 as GooglePayButtonProps, ITEM_IDS_NOT_FOUND, InPostPayButton, type InPostPayButtonProps, type LinkRequest, type NotificationGroup, Wrapper as NotificationsComponent, type Props$1 as NotificationsComponentProps, type NotificationsComponentPublicProps, PanelPage as Panel, type PanelConfig, PanelLogin, PanelLoginProps, PanelProps, PanelProvider, type PublicNotificationGroup, PublicOrderPage, RevolutPayButton, type RevolutPayButtonProps, type RevolutPaymentOutcome, buildAccessTokenRedirect, createCheckout, createPaymentURL, getAllowedReturnOrigins, getLocale, getPanelConfig, getPaymentMethodChoice, getReferenceIfPossible, getReturnURLFromSearch, injectReferenceToRequestIfNeeded, persistReturnURL, readPersistedReturnURL, setAllowedReturnOrigins, setCustomHost, setHost, setLocale, setLoginURL, setPanelConfig, setProjectID as setPanelProjectID, setProjectID$1 as setProjectID, setTheme, usePanelConfig };