@primer-io/primer-js 1.6.3 → 1.7.0

package/dist/primer-loader.d.ts

@@ -537,6 +537,17 @@ export interface PaymentRenderButtonOptions {
 		shadowRoot?: ShadowRoot | null;
 	};
 }
+/**
+ * Field validation state (mirrors @primer-io/sdk-utils/iframes/types)
+ */
+export interface FieldState {
+	valid: boolean;
+	dirty: boolean;
+	touched: boolean;
+	focused: boolean;
+	disabled: boolean;
+	error: string;
+}
 export interface BaseInputStyle {
 	background?: string;
 	borderColor?: number | string;
@@ -680,35 +691,16 @@ export interface TelemetryClient {
 	dispose(): void;
 }
 declare enum HeadlessManagerType {
+	BACKEND_DRIVEN = "BACKEND_DRIVEN",
 	BLIK = "BLIK",
 	CARD = "CARD",
 	NATIVE = "NATIVE",
 	REDIRECT = "REDIRECT",
 	KLARNA = "KLARNA",
 	ADYEN_KLARNA = "ADYEN_KLARNA",
-	ACH = "ACH",
 	MBWAY = "MBWAY",
 	QRCODE = "QRCODE"
 }
-export type PaymentMethodInfo = {
-	type: PaymentMethodType;
-	managerType: HeadlessManagerType;
-};
-declare enum EventTypes {
-	CHANGE = "change",
-	ENTER = "ENTER",
-	ERROR = "error",
-	FOCUS = "focus",
-	BLUR = "blur",
-	CLICK = "click",
-	CLOSE = "close",
-	INPUT = "input",
-	CONFIRMED_KLARNA_CATEGORY = "CONFIRMED_KLARNA_CATEGORY",
-	CONFIRMED_KLARNA_CATEGORY_ERROR = "CONFIRMED_KLARNA_CATEGORY_ERROR",
-	KLARNA_SESSION_UPDATE = "KLARNA_SESSION_UPDATE",
-	KLARNA_SESSION_REFRESH_ERROR = "KLARNA_SESSION_REFRESH_ERROR"
-}
-type EventListener$1 = (event?: Event) => void;
 export interface PayPalOptionsWithPaypalJsTypes {
 	/**
 	 * Button style configuration with optional per-funding-source overrides.
@@ -788,41 +780,32 @@ export interface Payment {
 		[key: string]: unknown;
 	};
 }
-export interface HeadlessHostedInputOptions {
-	placeholder?: string;
-	ariaLabel?: string;
-	style?: Record<string, unknown>;
-}
 export interface CardPaymentMethodSubmitValues {
 	cardNetwork?: string;
 }
-export interface CardPaymentMethodManagerOptions {
-	onBinDataAvailable?: (event: BinDataAvailableEvent) => void;
-	onBinDataLoadingChange?: (loading: boolean) => void;
-	onCardNetworksChange?: (event: CardNetworkChangeEvent) => void;
-	onCardNetworksLoading?: () => void;
-}
-export interface KlarnaPaymentMethodManagerOptions {
-	onPaymentMethodCategoriesChange?: (categories: {
-		id: string;
-		name: string;
-		descriptiveAssetUrl: string;
-		standardAssetUrl: string;
-	}[]) => void;
-	onPaymentMethodAction?: (action: string, data: {
-		paymentMethodType: string;
-		category: string;
-	}) => void;
+export interface KlarnaPaymentCategory {
+	name: string;
+	identifier: string;
+	standardAssetUrl: string;
+	descriptiveAssetUrl: string;
 }
-export interface KlarnaPaymentMethodManager {
+export interface KlarnaPaymentMethod {
+	type: typeof PaymentMethodType.KLARNA;
+	managerType: HeadlessManagerType.KLARNA;
+	getCategories: () => KlarnaPaymentCategory[];
 	renderCategory: (params: {
 		containerId: string | HTMLElement;
 		paymentMethodCategoryId: string;
 		onHeightChange?: (height: number) => void;
 	}) => Promise<void>;
-	start: (params: {
-		paymentMethodCategoryId: string;
-	}) => Promise<void>;
+	/**
+	 * Set the selected payment category for the payment flow
+	 */
+	setSelectedCategory: (categoryId: string) => void;
+	/**
+	 * Start the payment flow with the selected category
+	 */
+	start: () => Promise<void>;
 }
 /**
  * Adyen Klarna payment type option
@@ -832,25 +815,18 @@ export interface AdyenKlarnaPaymentOption {
 	label: string;
 }
 /**
- * Options for creating an Adyen Klarna payment method manager
- */
-export interface AdyenKlarnaPaymentMethodManagerOptions {
-	/**
-	 * Callback when payment options change (e.g., Pay Now, Pay Later)
-	 */
-	onPaymentOptionsChange?: (options: AdyenKlarnaPaymentOption[]) => void;
-}
-/**
- * Adyen Klarna Payment Method Manager
+ * Adyen Klarna Payment Method
  *
  * Unlike direct Klarna integration, Adyen Klarna uses a redirect flow
  * with payment type selection (Pay Now, Pay Later, etc.)
  */
-export interface AdyenKlarnaPaymentMethodManager {
+export interface AdyenKlarnaPaymentMethod {
+	type: typeof PaymentMethodType.ADYEN_KLARNA;
+	managerType: HeadlessManagerType.ADYEN_KLARNA;
 	/**
 	 * Get available payment options
 	 */
-	getPaymentOptions: () => AdyenKlarnaPaymentOption[];
+	getOptions: () => AdyenKlarnaPaymentOption[];
 	/**
 	 * Select a payment option
 	 */
@@ -860,10 +836,6 @@ export interface AdyenKlarnaPaymentMethodManager {
 	 */
 	start: () => Promise<void>;
 }
-export interface AchPaymentMethodManagerOptions {
-	onCollectBankAccountDetailsComplete?: () => void;
-}
-export type PaymentMethodManagerOptions = CardPaymentMethodManagerOptions | KlarnaPaymentMethodManagerOptions | AdyenKlarnaPaymentMethodManagerOptions | AchPaymentMethodManagerOptions | Record<string, unknown>;
 export interface VaultListItem {
 	id: string;
 	analyticsId: string;
@@ -1033,29 +1005,13 @@ export interface KlarnaVaultedPaymentMethodSummary extends BaseVaultedPaymentMet
 		};
 	};
 }
-/**
- * Vaulted ACH (Automated Clearing House) summary with ACH-specific fields.
- */
-export interface ACHVaultedPaymentMethodSummary extends BaseVaultedPaymentMethodSummary {
-	/** Discriminant for ACH instruments */
-	paymentInstrumentType: "AUTOMATED_CLEARING_HOUSE";
-	/** ACH-specific payment instrument data */
-	paymentInstrumentData?: {
-		/** Last 4 digits of account number */
-		accountNumberLastFourDigits?: string;
-		/** Bank name */
-		bankName?: string;
-		/** Account type (e.g., "CHECKING", "SAVINGS") */
-		accountType?: string;
-	};
-}
 /**
  * Generic vaulted payment method summary for payment instruments
  * not explicitly modeled with their own interface.
  */
 export interface GenericVaultedPaymentMethodSummary extends BaseVaultedPaymentMethodSummary {
 	/** Discriminant for all other payment instrument types */
-	paymentInstrumentType: Exclude<PaymentInstrumentType, "PAYMENT_CARD" | "PAYPAL_BILLING_AGREEMENT" | "KLARNA_CUSTOMER_TOKEN" | "AUTOMATED_CLEARING_HOUSE">;
+	paymentInstrumentType: Exclude<PaymentInstrumentType, "PAYMENT_CARD" | "PAYPAL_BILLING_AGREEMENT" | "KLARNA_CUSTOMER_TOKEN">;
 	/** Generic payment instrument data for unknown/other payment methods */
 	paymentInstrumentData?: Record<string, unknown>;
 }
@@ -1063,7 +1019,7 @@ export interface GenericVaultedPaymentMethodSummary extends BaseVaultedPaymentMe
  * Discriminated union of all vaulted payment method summaries.
  * Use the paymentInstrumentType field to narrow to specific types.
  */
-export type VaultedPaymentMethodSummary = CardVaultedPaymentMethodSummary | PayPalVaultedPaymentMethodSummary | KlarnaVaultedPaymentMethodSummary | ACHVaultedPaymentMethodSummary | GenericVaultedPaymentMethodSummary;
+export type VaultedPaymentMethodSummary = CardVaultedPaymentMethodSummary | PayPalVaultedPaymentMethodSummary | KlarnaVaultedPaymentMethodSummary | GenericVaultedPaymentMethodSummary;
 /**
  * Approval state of a MANUAL attempt. `REQUIRES_APPROVAL` is pending; `APPROVED`,
  * `ABORTED` and `EXPIRED` are terminal.
@@ -1130,22 +1086,6 @@ export interface BinDataAvailableEvent {
 	status: "complete" | "partial";
 	firstDigits?: string;
 }
-export interface HostedInput {
-	cleanup: () => void;
-	getOptions: () => HeadlessHostedInputOptions;
-	setOptions: (options: HeadlessHostedInputOptions) => void;
-	render: (container: string | Element, options: HeadlessHostedInputOptions) => Promise<void>;
-	addEventListener: (event: EventTypes, callback: EventListener$1) => void;
-	focus: () => void;
-	blur: () => void;
-	setDisabled: (status: boolean) => void;
-}
-export interface HostedInputs {
-	cardNumberInput: HostedInput;
-	cardholderNameInput: HostedInput;
-	expiryInput: HostedInput;
-	cvvInput: HostedInput;
-}
 export interface InputValidationError {
 	field?: string;
 	name: string;
@@ -1157,63 +1097,110 @@ export interface Validation {
 	validationErrors: InputValidationError[];
 	error?: string;
 }
-export interface CardPaymentMethodManager {
-	createHostedInputs: () => HostedInputs;
-	removeHostedInputs: () => void;
+export type HostedInputEvent = "input" | "focus" | "blur" | "enter";
+export interface HostedInput {
+	render(containerOrId: string | Element, options?: HostedInputOptions): Promise<void>;
+	remove(): void;
+	focus(): void;
+	getFieldState(): Promise<FieldState> | undefined;
+	addEventListener(event: HostedInputEvent, callback: (data?: unknown) => void): void;
+	setOptions(options: HostedInputOptions): void;
+	setCardholderName(cardholderName: string): void;
+}
+export interface CardFormIframes {
+	cardNumber: HostedInput;
+	cardSecurityCode: HostedInput;
+	cardExpiryDate: HostedInput;
+	cardholderName: HostedInput;
+}
+export interface CardPaymentMethod {
+	type: typeof PaymentMethodType.PAYMENT_CARD;
+	managerType: HeadlessManagerType.CARD;
+	iframes: CardFormIframes;
 	submit: (values?: CardPaymentMethodSubmitValues) => Promise<void>;
 	validate: () => Promise<Validation>;
-	reset: () => void;
 	setCardholderName: (cardholderName: string) => void;
 }
-export interface MbwayPaymentMethodManager {
-	start(params: {
-		phoneNumber: string;
-	}): Promise<void>;
+export interface MbwayPaymentMethod {
+	type: typeof PaymentMethodType.ADYEN_MBWAY;
+	managerType: HeadlessManagerType.MBWAY;
+	/**
+	 * Set the phone number used to confirm the payment in the MB WAY app
+	 */
+	setPhoneNumber(phoneNumber: string): void;
+	/**
+	 * Start the payment flow
+	 */
+	start(): Promise<void>;
 }
-export interface BlikPaymentMethodManager {
-	start(params: {
-		blikCode: string;
-	}): Promise<void>;
+export interface BlikPaymentMethod {
+	type: typeof PaymentMethodType.ADYEN_BLIK;
+	managerType: HeadlessManagerType.BLIK;
+	/**
+	 * Set the 6-digit OTP code from the user's banking app
+	 */
+	setBlikCode(code: string): void;
+	/**
+	 * Start the payment flow
+	 */
+	start(): Promise<void>;
 }
-export interface StripeAchCustomerDetails {
-	emailAddress: string;
-	firstName: string;
-	lastName: string;
-}
-export interface AchPaymentMethodManager {
-	start(paymentDetails: StripeAchCustomerDetails): Promise<Validation | void>;
-	setAndValidate(paymentDetails: StripeAchCustomerDetails): Promise<Validation>;
-	collectBankAccountDetails(): Promise<void>;
-	confirmMandate(): Promise<void>;
-	declineMandate(): Promise<void>;
-	getPaymentMethod(): void;
-}
-export interface NativePaymentMethodManager {
-	createButton: () => {
-		render: (container: HTMLElement, buttonOptions?: PaymentRenderButtonOptions) => Promise<void>;
-		setDisabled(disabled: boolean): Promise<void>;
-	};
+export interface NativePaymentMethod {
+	type: typeof PaymentMethodType.APPLE_PAY | typeof PaymentMethodType.GOOGLE_PAY | typeof PaymentMethodType.PAYPAL;
+	managerType: HeadlessManagerType.NATIVE;
+	/**
+	 * Initialize the payment method (e.g. load the external SDK)
+	 */
+	start(): Promise<void>;
+	/**
+	 * Render the payment button into the given container
+	 */
+	render(container: HTMLElement, buttonOptions?: PaymentRenderButtonOptions): Promise<void>;
+	setDisabled(disabled: boolean): Promise<void>;
+}
+/**
+ * Payment method types that have a surface of their own. Everything else is
+ * driven generically — by a redirect, or by the backend.
+ */
+export type SpecializedPaymentMethodType = typeof PaymentMethodType.STRIPE_ACH | typeof PaymentMethodType.PAYMENT_CARD | typeof PaymentMethodType.KLARNA | typeof PaymentMethodType.ADYEN_KLARNA | typeof PaymentMethodType.PAYPAL | typeof PaymentMethodType.GOOGLE_PAY | typeof PaymentMethodType.APPLE_PAY | typeof PaymentMethodType.ADYEN_BLIK | typeof PaymentMethodType.ADYEN_MBWAY | typeof PaymentMethodType.ADYEN_BANCONTACT_PAYCONIQ | typeof PaymentMethodType.XFERS_PAYNOW | typeof PaymentMethodType.OMISE_PROMPTPAY | typeof PaymentMethodType.RAPYD_PROMPTPAY;
+export interface RedirectPaymentMethod {
+	type: Exclude<PaymentMethodType, SpecializedPaymentMethodType>;
+	managerType: HeadlessManagerType.REDIRECT;
+	start: () => Promise<void>;
 }
-export interface RedirectPaymentMethodManager {
+/**
+ * A payment method whose flow is driven by the backend: the SDK executes the
+ * steps the backend sends rather than following a flow hardcoded per method.
+ *
+ * Which surface it renders is up to those steps — today they redirect, so this
+ * looks like {@link RedirectPaymentMethod}, but a step tree can drive other
+ * surfaces, which is why it is a member of its own rather than a redirect.
+ */
+export interface BackendDrivenPaymentMethod {
+	type: Exclude<PaymentMethodType, SpecializedPaymentMethodType>;
+	managerType: HeadlessManagerType.BACKEND_DRIVEN;
 	start: () => Promise<void>;
 }
 /**
- * QRCode Payment Method Manager
+ * QRCode Payment Method
  */
-export interface QRCodePaymentMethodManager {
+export interface QRCodePaymentMethod {
+	type: typeof PaymentMethodType.ADYEN_BANCONTACT_PAYCONIQ | typeof PaymentMethodType.OMISE_PROMPTPAY | typeof PaymentMethodType.RAPYD_PROMPTPAY | typeof PaymentMethodType.XFERS_PAYNOW;
+	managerType: HeadlessManagerType.QRCODE;
 	/**
-	 * Start the payment flow, optionally providing a callback for when the QR code is received
+	 * Provide a callback for when the QR code is received
 	 * @param params Optional parameters, including onQRCodeReceived callback
 	 */
-	start(params?: {
-		onQRCodeReceived?: (qrCode: string) => void;
-	}): Promise<void>;
+	setOnQRCodeReceived(callback: (qrCode: string) => void): void;
+	/**
+	 * Start the payment flow
+	 */
+	start(): Promise<void>;
 	/**
 	 * Stop the payment flow
 	 */
 	stop(): void;
 }
-export type PaymentMethodManager = CardPaymentMethodManager | NativePaymentMethodManager | RedirectPaymentMethodManager | KlarnaPaymentMethodManager | QRCodePaymentMethodManager;
 export interface SDKUtilities {
 	getCardNetworkAsset: (network: string) => {
 		cardUrl: string;
@@ -1239,7 +1226,6 @@ export interface SDKUtilities {
 }
 export interface PrimerHeadlessCheckout {
 	start: () => Promise<void>;
-	createPaymentMethodManager: (type: string, managerOptions?: PaymentMethodManagerOptions) => Promise<PaymentMethodManager | null>;
 	getSDKUtilities: () => SDKUtilities;
 	/** Session-bound telemetry, shared with all sdk-core internals via the checkout context */
 	getTelemetry: () => TelemetryClient;
@@ -1421,23 +1407,21 @@ export interface CreateHeadlessOptions {
 		 */
 		forceRedirect?: boolean;
 		/**
-		 * Whether to try resuming the payment when the redirect popup is closed by the user.
-		 * If false, the payment method will be deselected, allowing the user to select a different payment method.
-		 * @default false
+		 * @deprecated this flag is no longer used and won't have any effect, will be removed in a future version
 		 */
 		resumePaymentOnPopupClosure?: boolean;
 	};
 	/**
 	 * Fires once at SDK init with the initial set of available payment methods.
 	 */
-	onAvailablePaymentMethodsLoad?: (info: PaymentMethodInfo[]) => void;
+	onAvailablePaymentMethodsLoad?: (info: InitializedPaymentMethod[]) => void;
 	/**
 	 * Fires after each successful `refreshClientSession` when the available
 	 * payment methods have changed (added or removed) as a result of the backend
 	 * re-evaluating visibility rules against the updated client session metadata.
 	 * The `info` array reflects the current set in backend order.
 	 */
-	onAvailablePaymentMethodsRefresh?: (info: PaymentMethodInfo[]) => void;
+	onAvailablePaymentMethodsRefresh?: (info: InitializedPaymentMethod[]) => void;
 	onCheckoutComplete?: (data: {
 		payment: Payment | null;
 	}) => void;
@@ -1475,13 +1459,12 @@ export interface CreateHeadlessOptions {
 	 * is resolved. Not fired for a fresh checkout (no attempt in flight).
 	 */
 	onCheckoutResume?: () => void;
+	onBinDataAvailable?: (event: BinDataAvailableEvent) => void;
+	onBinDataLoadingChange?: (loading: boolean) => void;
+	onCardNetworksChange?: (event: CardNetworkChangeEvent) => void;
+	onCardNetworksLoading?: () => void;
 }
-export interface KlarnaPaymentMethodCategory {
-	id: string;
-	name: string;
-	descriptiveAssetUrl: string;
-	standardAssetUrl: string;
-}
+export type InitializedPaymentMethod = CardPaymentMethod | KlarnaPaymentMethod | AdyenKlarnaPaymentMethod | QRCodePaymentMethod | BlikPaymentMethod | MbwayPaymentMethod | RedirectPaymentMethod | BackendDrivenPaymentMethod | NativePaymentMethod;
 export interface CardSecurityCodeInputOptions {
 	ariaLabel?: string;
 	container: string | Element | HTMLElement;
@@ -1637,62 +1620,6 @@ export interface PrimerCheckoutOptions extends Omit<CreateHeadlessOptions, "dial
 	 */
 	disabledPayments?: boolean;
 }
-/**
- * Payment methods that use the REDIRECT manager type — i.e. every
- * PaymentMethodType not handled by a specialized manager (CARD, ACH, KLARNA,
- * ADYEN_KLARNA, NATIVE, BLIK, MBWAY, QRCODE).
- */
-export type RedirectPaymentMethodTypes = Exclude<PaymentMethodType, typeof PaymentMethodType.STRIPE_ACH | typeof PaymentMethodType.PAYMENT_CARD | typeof PaymentMethodType.KLARNA | typeof PaymentMethodType.ADYEN_KLARNA | typeof PaymentMethodType.PAYPAL | typeof PaymentMethodType.GOOGLE_PAY | typeof PaymentMethodType.APPLE_PAY | typeof PaymentMethodType.ADYEN_BLIK | typeof PaymentMethodType.ADYEN_MBWAY | typeof PaymentMethodType.ADYEN_BANCONTACT_PAYCONIQ | typeof PaymentMethodType.XFERS_PAYNOW | typeof PaymentMethodType.OMISE_PROMPTPAY | typeof PaymentMethodType.RAPYD_PROMPTPAY>;
-/**
- * A payment method that authorizes by redirecting the user to an external page.
- */
-export interface RedirectPaymentMethod {
-	type: RedirectPaymentMethodTypes;
-	managerType: HeadlessManagerType.REDIRECT;
-	manager: RedirectPaymentMethodManager;
-}
-export interface NativePaymentMethod {
-	type: typeof PaymentMethodType.PAYPAL | typeof PaymentMethodType.GOOGLE_PAY | typeof PaymentMethodType.APPLE_PAY;
-	managerType: HeadlessManagerType.NATIVE;
-	manager: NativePaymentMethodManager;
-}
-export interface BlikPaymentMethod {
-	type: typeof PaymentMethodType.ADYEN_BLIK;
-	managerType: HeadlessManagerType.BLIK;
-	manager: BlikPaymentMethodManager;
-}
-export interface MbwayPaymentMethod {
-	type: typeof PaymentMethodType.ADYEN_MBWAY;
-	managerType: HeadlessManagerType.MBWAY;
-	manager: MbwayPaymentMethodManager;
-}
-export interface QRCodePaymentMethod {
-	type: typeof PaymentMethodType.ADYEN_BANCONTACT_PAYCONIQ | typeof PaymentMethodType.OMISE_PROMPTPAY | typeof PaymentMethodType.RAPYD_PROMPTPAY | typeof PaymentMethodType.XFERS_PAYNOW;
-	managerType: HeadlessManagerType.QRCODE;
-	manager: QRCodePaymentMethodManager;
-}
-export type InitializedPaymentMethod = {
-	type: typeof PaymentMethodType.STRIPE_ACH;
-	managerType: HeadlessManagerType.ACH;
-	manager: AchPaymentMethodManager;
-} | {
-	type: typeof PaymentMethodType.PAYMENT_CARD;
-	managerType: HeadlessManagerType.CARD;
-	manager: CardPaymentMethodManager;
-} | {
-	type: typeof PaymentMethodType.KLARNA;
-	managerType: HeadlessManagerType.KLARNA;
-	manager: KlarnaPaymentMethodManager;
-} | {
-	type: typeof PaymentMethodType.ADYEN_KLARNA;
-	managerType: HeadlessManagerType.ADYEN_KLARNA;
-	manager: AdyenKlarnaPaymentMethodManager;
-} | QRCodePaymentMethod | BlikPaymentMethod | MbwayPaymentMethod | RedirectPaymentMethod | NativePaymentMethod;
-export interface AssetsConfig {
-	backgroundColor: string;
-	name: string;
-	iconUrl: string;
-}
 /**
  * Options for initializing the Vault Manager
  */
@@ -1731,14 +1658,6 @@ export interface VaultManagerItemState {
 	selectedVaultedPaymentMethod: VaultListItem | null;
 	setSelectedVaultedPaymentMethod: (paymentMethod: VaultListItem | null) => void;
 }
-export type KlarnaCategoriesContextType = {
-	categories: KlarnaPaymentMethodCategory[];
-	isLoading: boolean;
-};
-export type AdyenKlarnaOptionsContextType = {
-	options: AdyenKlarnaPaymentOption[];
-	isLoading: boolean;
-};
 export type CardNetwork = {
 	displayName: string;
 	network: string;
@@ -1787,8 +1706,6 @@ export type ContextType = {
 	telemetry?: TelemetryClient;
 	configuration?: ClientConfiguration;
 	computedStyles?: CSSStyleDeclaration | null;
-	klarnaCategories: KlarnaCategoriesContextType;
-	adyenKlarnaOptions?: AdyenKlarnaOptionsContextType;
 	cardNetworks?: CardNetworksContextType;
 	events?: PrimerEventsController;
 	clientOptions?: PrimerCheckoutOptions;
@@ -1815,8 +1732,6 @@ declare class SDKContextController implements ReactiveController {
 	setCardNetworks(value: CardNetworksContextType): void;
 	setCardNetworksLoadingFalse(): void;
 	setVaultManager(vaultManager: VaultManagerState): void;
-	setKlarnaCategories(value: KlarnaCategoriesContextType): void;
-	setAdyenKlarnaOptions(value: AdyenKlarnaOptionsContextType): void;
 	setComputedStyles(value: CSSStyleDeclaration): void;
 	setVaultManagerCvv(vaultItem: VaultManagerItemState): void;
 	/**
@@ -2199,7 +2114,7 @@ export declare class PrimerJS {
 	/**
 	 * Returns the cached list of payment methods.
 	 */
-	getPaymentMethods(): PaymentMethodInfo[];
+	getPaymentMethods(): InitializedPaymentMethod[];
 	/**
 	 * Internal accessor that returns the initialized payment methods (with their
 	 * managers), used by the refresh path to preserve manager identity across
@@ -2578,7 +2493,6 @@ declare class HeadlessSdkController implements ReactiveController {
 		string | null,
 		PrimerCheckoutOptions | null
 	]) => Promise<PrimerHeadlessCheckout | typeof initialState>;
-	private createManager;
 	/**
 	 * Updates card networks state and dispatches events
 	 *
@@ -2688,6 +2602,11 @@ export declare function injectLightTheme(): void;
  * @returns {void}
  */
 export declare function injectDarkTheme(): void;
+export interface AssetsConfig {
+	backgroundColor: string;
+	name: string;
+	iconUrl: string;
+}
 /**
  * Size options for the spinner component
  */
@@ -3280,10 +3199,13 @@ declare global {
 		"primer-klarna": PrimerKlarnaComponent;
 	}
 }
+type NativePaymentMethod$1 = Extract<InitializedPaymentMethod, {
+	managerType: HeadlessManagerType.NATIVE;
+}>;
 declare class NativePaymentComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
 	type: PaymentMethodType | undefined;
-	paymentMethod: NativePaymentMethod | undefined;
+	paymentMethod: NativePaymentMethod$1 | undefined;
 	primerContext?: ContextType;
 	disabled: boolean;
 	private buttonContainerRef;
@@ -3293,6 +3215,9 @@ declare class NativePaymentComponent extends LitElement {
 	protected willUpdate(changedProperties: PropertyValues): void;
 	render(): import("lit-html").TemplateResult<1>;
 }
+type BlikPaymentMethod$1 = Extract<InitializedPaymentMethod, {
+	managerType: HeadlessManagerType.BLIK;
+}>;
 /**
  * BLIK Payment Component
  *
@@ -3315,7 +3240,7 @@ declare class NativePaymentComponent extends LitElement {
  */
 declare class BlikComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
-	paymentMethod: BlikPaymentMethod | undefined;
+	paymentMethod: BlikPaymentMethod$1 | undefined;
 	disabled: boolean;
 	private currentState;
 	private blikCode;
@@ -3376,13 +3301,16 @@ declare global {
 		"primer-blik": BlikComponent;
 	}
 }
+type AdyenKlarnaPaymentMethod$1 = Extract<InitializedPaymentMethod, {
+	managerType: HeadlessManagerType.ADYEN_KLARNA;
+}>;
 declare class AdyenKlarnaComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
 	primerContext?: ContextType;
 	/**
 	 * The payment method from context
 	 */
-	paymentMethod?: InitializedPaymentMethod;
+	paymentMethod?: AdyenKlarnaPaymentMethod$1;
 	/**
 	 * Whether the component is disabled
 	 */
@@ -3400,7 +3328,6 @@ declare class AdyenKlarnaComponent extends LitElement {
 	 */
 	private loading;
 	private paymentInProgress;
-	private get manager();
 	/**
 	 * Get the Klarna logo URL from the payment method configuration
 	 */
@@ -3415,6 +3342,9 @@ declare global {
 		"primer-adyen-klarna": AdyenKlarnaComponent;
 	}
 }
+type MbwayPaymentMethod$1 = Extract<InitializedPaymentMethod, {
+	managerType: HeadlessManagerType.MBWAY;
+}>;
 /**
  * Adyen MB WAY Payment Component
  *
@@ -3424,7 +3354,7 @@ declare global {
  */
 declare class AdyenMbwayComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
-	paymentMethod: MbwayPaymentMethod | undefined;
+	paymentMethod: MbwayPaymentMethod$1 | undefined;
 	disabled: boolean;
 	private currentState;
 	private phoneNumber;
@@ -3447,9 +3377,12 @@ declare global {
 		"primer-adyen-mbway": AdyenMbwayComponent;
 	}
 }
+type QRCodePaymentMethod$1 = Extract<InitializedPaymentMethod, {
+	managerType: HeadlessManagerType.QRCODE;
+}>;
 declare class QRCodeComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
-	paymentMethod: QRCodePaymentMethod | undefined;
+	paymentMethod: QRCodePaymentMethod$1 | undefined;
 	disabled: boolean;
 	primerContext?: ContextType;
 	private isExpanded;
@@ -3470,6 +3403,48 @@ declare global {
 		"primer-qrcode": QRCodeComponent;
 	}
 }
+declare class PaymentMethodButtonComponent extends LitElement {
+	static styles: import("lit").CSSResult[];
+	type: PaymentMethodType | undefined;
+	disabled: boolean;
+	primerContext?: ContextType;
+	/**
+	 * Based on packages/primer-sdk-web/src/payment-methods/Button.tsx
+	 * Should be replaced once we align on a better solution across all platforms.
+	 */
+	private _legacyGetButtonLabel;
+	private _getBackgroundColor;
+	private _getIconUrl;
+	private _getIconPosition;
+	private _getTextColor;
+	private _getDisplayName;
+	private _setupTask;
+	private _handleClick;
+	render(): symbol | import("lit-html").TemplateResult<1> | undefined;
+}
+declare global {
+	interface HTMLElementTagNameMap {
+		"primer-payment-method-button": PaymentMethodButtonComponent;
+	}
+}
+type BackendDrivenPaymentMethod$1 = Extract<InitializedPaymentMethod, {
+	managerType: HeadlessManagerType.BACKEND_DRIVEN;
+}>;
+/**
+ * Surface for a payment method whose flow the backend drives through a step
+ * tree. Today every step tree starts by handing off to a third party, so this
+ * renders a button — but unlike a redirect method, what the flow needs of this
+ * component is open-ended: steps can ask for input, render UI, or wait, and
+ * this is where that grows.
+ */
+declare class BackendDrivenComponent extends LitElement {
+	static styles: import("lit").CSSResult;
+	paymentMethod: BackendDrivenPaymentMethod$1 | undefined;
+	disabled: boolean;
+	primerContext?: ContextType;
+	private _handleClick;
+	render(): import("lit-html").TemplateResult<1>;
+}
 declare class PaymentMethodComponent extends LitElement {
 	static styles: import("lit").CSSResult[];
 	type: PaymentMethodType | undefined;
@@ -3503,33 +3478,12 @@ declare global {
 		"primer-payment-method-container": PaymentMethodContainerComponent;
 	}
 }
-declare class PaymentMethodButtonComponent extends LitElement {
-	static styles: import("lit").CSSResult[];
-	type: PaymentMethodType | undefined;
-	disabled: boolean;
-	primerContext?: ContextType;
-	/**
-	 * Based on packages/primer-sdk-web/src/payment-methods/Button.tsx
-	 * Should be replaced once we align on a better solution across all platforms.
-	 */
-	private _legacyGetButtonLabel;
-	private _getBackgroundColor;
-	private _getIconUrl;
-	private _getIconPosition;
-	private _getTextColor;
-	private _getDisplayName;
-	private _setupTask;
-	private _handleClick;
-	render(): symbol | import("lit-html").TemplateResult<1> | undefined;
-}
-declare global {
-	interface HTMLElementTagNameMap {
-		"primer-payment-method-button": PaymentMethodButtonComponent;
-	}
-}
+type RedirectPaymentMethod$1 = Extract<InitializedPaymentMethod, {
+	managerType: HeadlessManagerType.REDIRECT;
+}>;
 declare class RedirectPaymentComponent extends LitElement {
 	static styles: import("lit").CSSResult;
-	paymentMethod: RedirectPaymentMethod | undefined;
+	paymentMethod: RedirectPaymentMethod$1 | undefined;
 	disabled: boolean;
 	primerContext?: ContextType;
 	private _handleClick;
@@ -3540,6 +3494,11 @@ declare global {
 		"primer-redirect-payment": RedirectPaymentComponent;
 	}
 }
+declare global {
+	interface HTMLElementTagNameMap {
+		"primer-backend-driven": BackendDrivenComponent;
+	}
+}
 /**
  * BillingAddressComponent provides a form for collecting billing address information.
  *
@@ -4993,6 +4952,7 @@ export declare function loadPrimer(): void;
 
 export {
 	AdyenMbwayComponent as AdyenMbway,
+	BackendDrivenComponent as BackendDriven,
 	BillingAddressComponent as BillingAddress,
 	BlikComponent as Blik,
 	ButtonComponent as Button,