@paydock/client-sdk 1.144.1-beta → 1.145.0-beta

package/bundles/index.mjs.d.ts

@@ -3782,6 +3782,77 @@ declare enum ERROR_OPERATION {
     SHIPPING_UPDATE = "shipping_update"
 }
 
+/**
+ * Base options shared by every wallet's static availability check
+ * (e.g. `ApplePayOpenWalletButton.checkAvailability`). Wallet-specific option
+ * interfaces extend this with their own fields.
+ */
+interface OpenWalletAvailabilityOptions {
+    /** Public key or access token used to fetch the service config when needed. */
+    public_key_or_access_token?: string;
+    /** Service ID — used with `public_key_or_access_token` to resolve the wallet configuration. */
+    service_id?: string;
+    /** Environment for the config fetch (e.g. `'sandbox'`). Defaults to the SDK default. */
+    env?: string;
+    /**
+     * When `true`, performs only the cheap, network-free synchronous check and resolves
+     * immediately — no config fetch, SDK load, or remote capability query.
+     */
+    sync?: boolean;
+}
+/**
+ * Base result shared by every wallet's static availability check. Wallet-specific
+ * result interfaces extend this with their own fields.
+ */
+interface OpenWalletAvailabilityResult {
+    /** Convenience verdict: the wallet is usable for a payment in the current context. */
+    available: boolean;
+    /** Whether the wallet is supported here at all (may be available via a fallback flow). */
+    supported: boolean;
+    /** Machine-readable reason when not available. */
+    reason?: string;
+}
+
+/**
+ * Friendly capability tokens accepted as **input** — the same values used in
+ * `ApplePayOpenWalletMeta.apple_pay_capabilities`. They declare which device
+ * credential statuses should be treated as "available".
+ */
+type ApplePayCapabilityToken = 'credentials_available' | 'credentials_status_unknown' | 'credentials_unavailable';
+/**
+ * Device-reported credential status — the **output** of
+ * `ApplePaySession.applePayCapabilities()`.
+ */
+type ApplePayCredentialStatus = 'paymentCredentialsAvailable' | 'paymentCredentialStatusUnknown' | 'paymentCredentialsUnavailable' | 'applePayUnsupported';
+/**
+ * Options for `ApplePayOpenWalletButton.checkAvailability`. Provide `merchant_id`
+ * directly to skip the network call, **or** provide `public_key_or_access_token` +
+ * `service_id` to have the SDK resolve the merchant identifier from the service config.
+ */
+interface ApplePayAvailabilityOptions extends OpenWalletAvailabilityOptions {
+    /** Apple merchant identifier. Provide this OR (`public_key_or_access_token` + `service_id`). */
+    merchant_id?: string;
+    /**
+     * Device credential statuses that count as available. Defaults to
+     * `['credentials_available', 'credentials_status_unknown']` — `credentials_status_unknown`
+     * is what third-party / cross-device (QR) browsers report, so the default keeps Apple Pay
+     * visible outside Safari.
+     */
+    apple_pay_capabilities?: ApplePayCapabilityToken[];
+}
+/** Result of `ApplePayOpenWalletButton.checkAvailability`. */
+interface ApplePayAvailabilityResult extends OpenWalletAvailabilityResult {
+    /**
+     * Whether a **native, same-device** Apple Pay session is present right now
+     * (`ApplePaySession` exists and `canMakePayments()` is `true`). Apple does not expose
+     * the transport directly, so use this to infer it: `available && has_native_session` ⇒
+     * native sheet likely; `available && !has_native_session` ⇒ cross-device / QR handoff likely.
+     */
+    has_native_session: boolean;
+    /** The raw device-reported credential status. Undefined when unsupported or not queried. */
+    payment_credential_status?: ApplePayCredentialStatus;
+}
+
 /**
  * Events emitted during the OpenWallet payment lifecycle.
  */
@@ -3933,6 +4004,30 @@ interface OnCancelEventData extends OpenWalletBaseEvent {
     event: EVENT$1.CHECKOUT_CLOSE;
 }
 
+/**
+ * Options for `GooglePayOpenWalletButton.checkAvailability`. Extends
+ * {@link OpenWalletAvailabilityOptions}. All fields are optional — Google Pay's
+ * `isReadyToPay` check does not require a merchant identifier. Provide
+ * `public_key_or_access_token` + `service_id` to validate that the service is a Google Pay
+ * service (and resolve the merchant id), or `merchant_id` directly.
+ */
+interface GooglePayAvailabilityOptions extends OpenWalletAvailabilityOptions {
+    /**
+     * Google Pay gateway merchant identifier. Optional — `isReadyToPay` does not require it;
+     * when omitted the readiness check still runs.
+     */
+    merchant_id?: string;
+}
+/** Result of `GooglePayOpenWalletButton.checkAvailability`. */
+interface GooglePayAvailabilityResult extends OpenWalletAvailabilityResult {
+    /**
+     * Google's `isReadyToPay` `paymentMethodPresent` — whether the buyer already has a
+     * payment method usable with Google Pay. `undefined` when not reported (e.g. the
+     * synchronous check, or browsers where it is not surfaced).
+     */
+    payment_method_present?: boolean;
+}
+
 /**
  * Base metadata required to configure an OpenWallet button.
  */
@@ -4201,6 +4296,16 @@ declare abstract class OpenWalletButtons<TMeta extends OpenWalletMeta = OpenWall
     abstract readonly walletType: WalletType;
     /** @private */
     constructor(selector: string, publicKeyOrAccessToken: string, serviceId: string, meta: TMeta);
+    /**
+     * Invalidates the cached service configuration whenever an error or unavailable
+     * event fires, so the next `load()` re-fetches a fresh config. The cache is keyed
+     * on the service ID with a 1-day TTL; clearing it on failure means a config that
+     * changed server-side (and caused the failure) is not reused until the TTL expires.
+     * Registered once per button, independently of any merchant-registered handlers.
+     *
+     * @private
+     */
+    private registerCacheInvalidationOnError;
     /**
      * Creates the wallet-specific service instance for this button.
      * Each concrete subclass implements this to instantiate its specific wallet service.
@@ -5062,11 +5167,6 @@ type ApplePayButtonStyle$1 = 'black' | 'white' | 'white-outline';
 
 type ApplePayButtonType$1 = 'add-money' | 'book' | 'buy' | 'check-out' | 'continue' | 'contribute' | 'donate' | 'order' | 'pay' | 'plain' | 'reload' | 'rent' | 'set-up' | 'subscribe' | 'support' | 'tip' | 'top-up';
 
-declare global {
-    interface Window {
-        ApplePaySession: ApplePaySession;
-    }
-}
 /** Styling configuration for the Apple Pay button. */
 interface ApplePayOpenWalletMetaStyles extends OpenWalletMetaStyles {
     /** Variant displayed on the button (e.g. `'buy'`, `'donate'`, `'plain'`, `'check-out'`). */
@@ -5127,12 +5227,24 @@ interface ApplePayOpenWalletMeta extends OpenWalletMeta, Omit<ApplePayPaymentReq
     /** Visual styling for the Apple Pay button. */
     style?: ApplePayOpenWalletMetaStyles;
     /**
-     * Device capabilities allowed for the wallet button to be considered available.
-     * Used as a relaxation knob for testing — defaults to `['paymentCredentialsAvailable']` only.
+     * Device credential statuses that make the button render. Defaults to
+     * `['credentials_available', 'credentials_status_unknown']`:
+     * - `credentials_available` — the device has a confirmed Apple Pay card ready to use.
+     * - `credentials_status_unknown` — a local card can't be confirmed, but Apple Pay can
+     *   still proceed (e.g. the cross-device flow where the buyer completes payment on their
+     *   iPhone via QR, used by Chrome, Edge and Firefox).
+     * The button renders when the device's reported status is in this list. Narrow to
+     * `['credentials_available']` to require a confirmed local card.
      */
     apple_pay_capabilities?: Array<'credentials_available' | 'credentials_status_unknown' | 'credentials_unavailable'>;
 }
 
+declare global {
+    interface Window {
+        ApplePaySession: ApplePaySession;
+    }
+}
+
 /**
  * @classdesc Apple Pay wallet button that creates One-Time Tokens (OTT) via Apple Pay.
  *
@@ -5171,6 +5283,46 @@ interface ApplePayOpenWalletMeta extends OpenWalletMeta, Omit<ApplePayPaymentReq
 declare class ApplePayOpenWalletButton extends OpenWalletButtons<ApplePayOpenWalletMeta> {
     /** @private */
     readonly walletType: WalletType;
+    /**
+     * Checks Apple Pay availability **without instantiating the button** — the single,
+     * authoritative, cross-browser-aware availability entry point.
+     *
+     * Resolves the merchant identifier (either supplied directly or fetched from the
+     * service configuration), loads Apple's web SDK if needed, then queries
+     * `ApplePaySession.applePayCapabilities()`. Returns a convenience `available` verdict
+     * (computed against `apple_pay_capabilities`), the raw device-reported
+     * `payment_credential_status`, and `has_native_session` so callers can infer the transport:
+     * `available && has_native_session` ⇒ native sheet likely; `available && !has_native_session`
+     * ⇒ cross-device / QR handoff likely.
+     *
+     * Pass `{ sync: true }` for a cheap, network-free native same-device pre-check that
+     * resolves immediately (see {@link ApplePayAvailabilityOptions.sync}).
+     *
+     * @param {ApplePayAvailabilityOptions} [options] - Merchant context, allowed capabilities, and mode.
+     * @returns {Promise<ApplePayAvailabilityResult>} The availability result.
+     *
+     * @example
+     * // Lightest path — no network, when you already know the merchant identifier:
+     * const result = await ApplePayOpenWalletButton.checkAvailability({ merchant_id });
+     *
+     * @example
+     * // Resolve the merchant identifier from the service configuration:
+     * const result = await ApplePayOpenWalletButton.checkAvailability({
+     *   public_key_or_access_token,
+     *   service_id,
+     *   env: 'sandbox',
+     * });
+     * if (result.available) {
+     *   // Render the Apple Pay button (native sheet or cross-device QR, per has_native_session).
+     * } else {
+     *   console.log('Unavailable:', result.reason, result.payment_credential_status);
+     * }
+     *
+     * @example
+     * // Synchronous native-only fast check (no network / SDK load):
+     * const { has_native_session } = await ApplePayOpenWalletButton.checkAvailability({ sync: true });
+     */
+    static checkAvailability(options?: ApplePayAvailabilityOptions): Promise<ApplePayAvailabilityResult>;
     /**
      * Validates Apple Pay-specific required metadata fields.
      * Apple Pay requires `amount_label` and `store_name` to be present and strings.
@@ -5342,6 +5494,38 @@ interface GooglePayCardConfig {
 declare class GooglePayOpenWalletButton extends OpenWalletButtons<GooglePayOpenWalletMeta> {
     /** @private */
     readonly walletType: WalletType;
+    /**
+     * Checks Google Pay availability **without instantiating the button** — the static
+     * availability entry point.
+     *
+     * Loads the Google Pay JS SDK if needed, then runs `PaymentsClient.isReadyToPay()` using
+     * the **default** card configuration (a button instance with a custom `card_config` may
+     * produce a different result). All options are optional — unlike Apple Pay, Google Pay's
+     * readiness check does not require a merchant identifier; supplying `service_id` +
+     * `public_key_or_access_token` additionally validates that the service is a Google Pay service.
+     *
+     * Pass `{ sync: true }` for a cheap, network-free check that only reports whether the
+     * Google Pay JS API is already present (see {@link GooglePayAvailabilityOptions.sync}).
+     *
+     * @param {GooglePayAvailabilityOptions} [options] - Optional merchant context and mode.
+     * @returns {Promise<GooglePayAvailabilityResult>} The availability result.
+     *
+     * @example
+     * // Simplest form — no merchant context needed:
+     * const result = await GooglePayOpenWalletButton.checkAvailability();
+     * if (result.available) {
+     *   // Render the Google Pay button.
+     * }
+     *
+     * @example
+     * // Validate the service is a Google Pay service while checking:
+     * const result = await GooglePayOpenWalletButton.checkAvailability({
+     *   public_key_or_access_token,
+     *   service_id,
+     *   env: 'sandbox',
+     * });
+     */
+    static checkAvailability(options?: GooglePayAvailabilityOptions): Promise<GooglePayAvailabilityResult>;
     /**
      * Validates Google Pay-specific required metadata fields.
      * Google Pay has no additional required fields beyond the base (amount, currency, country).
@@ -7256,4 +7440,4 @@ declare global {
 }
 
 export { AfterpayCheckoutButton, AfterpayOnSiteMessaging, Api, ApplePayOpenWalletButton, ApplePayWalletButtonExpress, CANVAS_3DS_EVENT, CHECKOUT_BUTTON_EVENT, EVENT$2 as CHECKOUT_EVENT, Canvas3ds, Canvas3dsTokenFormat, Checkout, CheckoutActionCode, ClickToPay, Configuration, ContactShippingEditingMode, ELEMENT, ERROR_OPERATION, EVENT$3 as EVENT, Builder$1 as ExternalCheckoutBuilder, Checker as ExternalCheckoutChecker, FORM_FIELD, FRAUD_PREVENTION_EVENTS, FraudPreventionService, GooglePayOpenWalletButton, HtmlMultiWidget, HtmlPaymentSourceWidget, HtmlWidget, InstructionDebugger, MultiWidget, OpenWalletButtons, PAYMENT_EXPIRED, PAYMENT_FAILURE, PAYMENT_SUCCESSFUL, PAYMENT_TYPE, PURPOSE, PayPalDataCollector, PayPalSavePaymentSourceWidget, Builder as PaymentSourceBuilder, PaymentSourceWidget, PaypalCheckoutButton, PaypalWalletButtonExpress, STYLABLE_ELEMENT, STYLABLE_ELEMENT_STATE, STYLE, SUPPORTED_CARD_TYPES, TEXT, TOKEN_TYPE, TRIGGER, TYPE, VAULT_DISPLAY_STYLE, VaultDisplayWidget, EVENT as WALLET_BUTTONS_EXPRESS_EVENT, WALLET_TYPES, WalletButtons, ZipmoneyCheckoutButton };
-export type { ApplePayButtonStyle, ApplePayButtonType, ApplePayOpenWalletMeta, ApplePayWalletMeta, AppleShippingType, BaseWalletMeta, Billing, Canvas3dsAuthPayload, Canvas3dsChargeAuthEventPayload, Canvas3dsErrorEventPayload, Canvas3dsErrorPayload, Canvas3dsEventMap, Canvas3dsEventName, CheckoutIntentTokenPayload, CheckoutPaymentExpiredPayload, CheckoutPaymentFailurePayload, CheckoutPaymentSuccessPayload, CheckoutResponse, CreateOTTData, CreateOTTRequest, CreateOTTResponse, CreateSessionRequest, CreateSessionResponse, EventTypes, FraudPreventionEvent, FraudPreventionEventType, FraudPreventionProvider, GooglePayCardConfig, GooglePayOpenWalletMeta, GooglePayOpenWalletMetaStyles, HandleResponseInterface, IApplePayShippingOption, ICheckout, IClickToPayMeta, IDetails, IElementStyleInput, IEventAfterLoadData, IEventCheckoutFinishData, IEventData$1 as IEventData, IEventError, IEventFinishData, IEventMetaData, IEventSizeData, IFormValidation, IOpenWalletProvider, IPayPalMeta, IStyles$1 as IStyles, ITexts, ITokenStandalone3DS, IWalletMeta, IWalletOnClickEvent, IWalletPaymentSuccessfulEvent, IWalletUnavailableEvent, IWalletUpdateData, IWalletUpdateEvent, OTTResponse, OnCancelEventData, OnClickEventData$1 as OnClickEventData, OnCreateOTTErrorEventData, OnCreateOTTErrorPayload, OnCreateOTTSuccessPayload, OnCreateOTTSuccessfulEventData, OnErrorEventData$1 as OnErrorEventData, OnErrorPayload, OnLoadedEventData, OnUnavailableDetails, OnUnavailableEventData$1 as OnUnavailableEventData, OnUnavailablePayload, OpenWalletBaseEvent, OpenWalletDataEvent, OpenWalletEventType, OpenWalletMeta, PaypalWalletMeta, ProcessAuthenticationResponse, Shipping, VaultDisplayStyle, OnClickEventData as WalletExpressOnClickEventData, OnCloseEventData as WalletExpressOnCloseEventData, OnErrorEventData as WalletExpressOnErrorEventData, OnPaymentErrorEventData as WalletExpressOnPaymentErrorEventData, OnPaymentInReviewEventData as WalletExpressOnPaymentInReviewEventData, OnPaymentSuccessfulEventData as WalletExpressOnPaymentSuccessfulEventData, OnShippingAddressChangeEventData as WalletExpressOnShippingAddressChangeEventData, OnShippingAddressChangeEventResponse as WalletExpressOnShippingAddressChangeEventResponse, OnShippingOptionChangeEventData as WalletExpressOnShippingOptionChangeEventData, OnShippingOptionChangeEventResponse as WalletExpressOnShippingOptionChangeEventResponse, OnUnavailableEventData as WalletExpressOnUnavailableEventData, WalletType, WidgetEventMap, WidgetEventName };
+export type { ApplePayAvailabilityOptions, ApplePayAvailabilityResult, ApplePayButtonStyle, ApplePayButtonType, ApplePayCapabilityToken, ApplePayCredentialStatus, ApplePayOpenWalletMeta, ApplePayWalletMeta, AppleShippingType, BaseWalletMeta, Billing, Canvas3dsAuthPayload, Canvas3dsChargeAuthEventPayload, Canvas3dsErrorEventPayload, Canvas3dsErrorPayload, Canvas3dsEventMap, Canvas3dsEventName, CheckoutIntentTokenPayload, CheckoutPaymentExpiredPayload, CheckoutPaymentFailurePayload, CheckoutPaymentSuccessPayload, CheckoutResponse, CreateOTTData, CreateOTTRequest, CreateOTTResponse, CreateSessionRequest, CreateSessionResponse, EventTypes, FraudPreventionEvent, FraudPreventionEventType, FraudPreventionProvider, GooglePayAvailabilityOptions, GooglePayAvailabilityResult, GooglePayCardConfig, GooglePayOpenWalletMeta, GooglePayOpenWalletMetaStyles, HandleResponseInterface, IApplePayShippingOption, ICheckout, IClickToPayMeta, IDetails, IElementStyleInput, IEventAfterLoadData, IEventCheckoutFinishData, IEventData$1 as IEventData, IEventError, IEventFinishData, IEventMetaData, IEventSizeData, IFormValidation, IOpenWalletProvider, IPayPalMeta, IStyles$1 as IStyles, ITexts, ITokenStandalone3DS, IWalletMeta, IWalletOnClickEvent, IWalletPaymentSuccessfulEvent, IWalletUnavailableEvent, IWalletUpdateData, IWalletUpdateEvent, OTTResponse, OnCancelEventData, OnClickEventData$1 as OnClickEventData, OnCreateOTTErrorEventData, OnCreateOTTErrorPayload, OnCreateOTTSuccessPayload, OnCreateOTTSuccessfulEventData, OnErrorEventData$1 as OnErrorEventData, OnErrorPayload, OnLoadedEventData, OnUnavailableDetails, OnUnavailableEventData$1 as OnUnavailableEventData, OnUnavailablePayload, OpenWalletAvailabilityOptions, OpenWalletAvailabilityResult, OpenWalletBaseEvent, OpenWalletDataEvent, OpenWalletEventType, OpenWalletMeta, PaypalWalletMeta, ProcessAuthenticationResponse, Shipping, VaultDisplayStyle, OnClickEventData as WalletExpressOnClickEventData, OnCloseEventData as WalletExpressOnCloseEventData, OnErrorEventData as WalletExpressOnErrorEventData, OnPaymentErrorEventData as WalletExpressOnPaymentErrorEventData, OnPaymentInReviewEventData as WalletExpressOnPaymentInReviewEventData, OnPaymentSuccessfulEventData as WalletExpressOnPaymentSuccessfulEventData, OnShippingAddressChangeEventData as WalletExpressOnShippingAddressChangeEventData, OnShippingAddressChangeEventResponse as WalletExpressOnShippingAddressChangeEventResponse, OnShippingOptionChangeEventData as WalletExpressOnShippingOptionChangeEventData, OnShippingOptionChangeEventResponse as WalletExpressOnShippingOptionChangeEventResponse, OnUnavailableEventData as WalletExpressOnUnavailableEventData, WalletType, WidgetEventMap, WidgetEventName };

package/bundles/types/helper/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/helper/browser.ts"],"names":[],"mappings":"AAAA,qBAAa,OAAO;WACJ,UAAU,IAAI,OAAO;WAQrB,WAAW,IAAI,OAAO;WAQtB,cAAc,IAAI,OAAO;WAIzB,WAAW,IAAI,MAAM;WAIrB,iBAAiB,IAAI,MAAM;WAI3B,cAAc,IAAI,MAAM;WAsBxB,aAAa,IAAI,OAAO;WAIxB,YAAY,IAAI,MAAM;WAItB,aAAa,IAAI,MAAM;WAIvB,eAAe,IAAI,MAAM;WAIzB,cAAc,IAAI,MAAM;WAIxB,cAAc,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CA8BlE"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/helper/browser.ts"],"names":[],"mappings":"AAAA,qBAAa,OAAO;WACJ,UAAU,IAAI,OAAO;WAQrB,WAAW,IAAI,OAAO;WAQtB,cAAc,IAAI,OAAO;WAIzB,WAAW,IAAI,MAAM;WAIrB,iBAAiB,IAAI,MAAM;WAI3B,cAAc,IAAI,MAAM;WAkCxB,aAAa,IAAI,OAAO;WAIxB,YAAY,IAAI,MAAM;WAItB,aAAa,IAAI,MAAM;WAIvB,eAAe,IAAI,MAAM;WAIzB,cAAc,IAAI,MAAM;WAIxB,cAAc,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAgClE"}

package/bundles/types/helper/element-id.d.ts

@@ -1,5 +1,7 @@
 /**
- * Generate a unique id compatible with HTML element id
+ * Generate a unique id compatible with HTML element id.
+ * Uses the Web Crypto API for cryptographically strong randomness, with a
+ * deterministic fallback only when crypto is unavailable.
  */
 export declare function getUniqueId(): string;
 //# sourceMappingURL=element-id.d.ts.map

package/bundles/types/helper/element-id.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"element-id.d.ts","sourceRoot":"","sources":["../../src/helper/element-id.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,WAAW,WAE1B"}
+{"version":3,"file":"element-id.d.ts","sourceRoot":"","sources":["../../src/helper/element-id.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,WAAW,WAkB1B"}

package/bundles/types/helper/uuid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../src/helper/uuid.ts"],"names":[],"mappings":"AACA,qBAAa,IAAI;WAEE,QAAQ;IAUvB,OAAO,CAAC,MAAM,CAAC,IAAI;IAQnB,OAAO,CAAC,MAAM,CAAC,MAAM;CAKxB"}
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../src/helper/uuid.ts"],"names":[],"mappings":"AAAA,qBAAa,IAAI;WACD,QAAQ;IAwCtB,OAAO,CAAC,MAAM,CAAC,IAAI;IAQnB,OAAO,CAAC,MAAM,CAAC,MAAM;CAatB"}

package/bundles/types/open-wallets/apple-pay-open-wallet-button.d.ts

@@ -1,6 +1,7 @@
 import { type GetConfigResponse } from '../api/api-service-internal';
 import type { OpenWalletService } from './base/open-wallet.service';
 import { OpenWalletButtons } from './base/open-wallet-buttons';
+import type { ApplePayAvailabilityOptions, ApplePayAvailabilityResult } from './interfaces/apple-pay/apple-pay-availability.interface';
 import type { ApplePayOpenWalletMeta } from './services/apple-pay';
 import type { WalletType } from './types';
 /**
@@ -41,6 +42,46 @@ import type { WalletType } from './types';
 export declare class ApplePayOpenWalletButton extends OpenWalletButtons<ApplePayOpenWalletMeta> {
     /** @private */
     readonly walletType: WalletType;
+    /**
+     * Checks Apple Pay availability **without instantiating the button** — the single,
+     * authoritative, cross-browser-aware availability entry point.
+     *
+     * Resolves the merchant identifier (either supplied directly or fetched from the
+     * service configuration), loads Apple's web SDK if needed, then queries
+     * `ApplePaySession.applePayCapabilities()`. Returns a convenience `available` verdict
+     * (computed against `apple_pay_capabilities`), the raw device-reported
+     * `payment_credential_status`, and `has_native_session` so callers can infer the transport:
+     * `available && has_native_session` ⇒ native sheet likely; `available && !has_native_session`
+     * ⇒ cross-device / QR handoff likely.
+     *
+     * Pass `{ sync: true }` for a cheap, network-free native same-device pre-check that
+     * resolves immediately (see {@link ApplePayAvailabilityOptions.sync}).
+     *
+     * @param {ApplePayAvailabilityOptions} [options] - Merchant context, allowed capabilities, and mode.
+     * @returns {Promise<ApplePayAvailabilityResult>} The availability result.
+     *
+     * @example
+     * // Lightest path — no network, when you already know the merchant identifier:
+     * const result = await ApplePayOpenWalletButton.checkAvailability({ merchant_id });
+     *
+     * @example
+     * // Resolve the merchant identifier from the service configuration:
+     * const result = await ApplePayOpenWalletButton.checkAvailability({
+     *   public_key_or_access_token,
+     *   service_id,
+     *   env: 'sandbox',
+     * });
+     * if (result.available) {
+     *   // Render the Apple Pay button (native sheet or cross-device QR, per has_native_session).
+     * } else {
+     *   console.log('Unavailable:', result.reason, result.payment_credential_status);
+     * }
+     *
+     * @example
+     * // Synchronous native-only fast check (no network / SDK load):
+     * const { has_native_session } = await ApplePayOpenWalletButton.checkAvailability({ sync: true });
+     */
+    static checkAvailability(options?: ApplePayAvailabilityOptions): Promise<ApplePayAvailabilityResult>;
     /**
      * Validates Apple Pay-specific required metadata fields.
      * Apple Pay requires `amount_label` and `store_name` to be present and strings.

package/bundles/types/open-wallets/apple-pay-open-wallet-button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apple-pay-open-wallet-button.d.ts","sourceRoot":"","sources":["../../src/open-wallets/apple-pay-open-wallet-button.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAiB,MAAM,6BAA6B,CAAC;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAEnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,wBAAyB,SAAQ,iBAAiB,CAAC,sBAAsB,CAAC;IACrF,eAAe;IACf,SAAgB,UAAU,EAAE,UAAU,CAA0B;IAEhE;;;;;;;OAOG;IACH,SAAS,CAAC,kBAAkB,IAAI,IAAI;IAmBpC;;;;;;OAMG;IACH,SAAS,CAAC,mBAAmB,CAAC,aAAa,EAAE,iBAAiB,GAAG,IAAI;IASrE;;;;;;OAMG;IACH,SAAS,CAAC,mBAAmB,CAAC,aAAa,EAAE,iBAAiB,GAAG,iBAAiB;CAUnF"}
+{"version":3,"file":"apple-pay-open-wallet-button.d.ts","sourceRoot":"","sources":["../../src/open-wallets/apple-pay-open-wallet-button.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,iBAAiB,EAAiB,MAAM,6BAA6B,CAAC;AAEpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,KAAK,EACV,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,yDAAyD,CAAC;AACjE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAOnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,wBAAyB,SAAQ,iBAAiB,CAAC,sBAAsB,CAAC;IACrF,eAAe;IACf,SAAgB,UAAU,EAAE,UAAU,CAA0B;IAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;WACiB,iBAAiB,CACnC,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,0BAA0B,CAAC;IA+EtC;;;;;;;OAOG;IACH,SAAS,CAAC,kBAAkB,IAAI,IAAI;IAmBpC;;;;;;OAMG;IACH,SAAS,CAAC,mBAAmB,CAAC,aAAa,EAAE,iBAAiB,GAAG,IAAI;IASrE;;;;;;OAMG;IACH,SAAS,CAAC,mBAAmB,CAAC,aAAa,EAAE,iBAAiB,GAAG,iBAAiB;CAUnF"}

package/bundles/types/open-wallets/base/open-wallet-buttons.d.ts

@@ -38,6 +38,16 @@ export declare abstract class OpenWalletButtons<TMeta extends OpenWalletMeta = O
     abstract readonly walletType: WalletType;
     /** @private */
     constructor(selector: string, publicKeyOrAccessToken: string, serviceId: string, meta: TMeta);
+    /**
+     * Invalidates the cached service configuration whenever an error or unavailable
+     * event fires, so the next `load()` re-fetches a fresh config. The cache is keyed
+     * on the service ID with a 1-day TTL; clearing it on failure means a config that
+     * changed server-side (and caused the failure) is not reused until the TTL expires.
+     * Registered once per button, independently of any merchant-registered handlers.
+     *
+     * @private
+     */
+    private registerCacheInvalidationOnError;
     /**
      * Creates the wallet-specific service instance for this button.
      * Each concrete subclass implements this to instantiate its specific wallet service.

package/bundles/types/open-wallets/base/open-wallet-buttons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"open-wallet-buttons.d.ts","sourceRoot":"","sources":["../../../src/open-wallets/base/open-wallet-buttons.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"open-wallet-buttons.d.ts","sourceRoot":"","sources":["../../../src/open-wallets/base/open-wallet-buttons.ts"],"names":[],"mappings":"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"}

package/bundles/types/open-wallets/base/service-config-cache.d.ts

@@ -0,0 +1,23 @@
+import type { ApiInternal } from '../../api/api-internal';
+import type { GetConfigResponse } from '../../api/api-service-internal';
+/**
+ * Removes the cached service configuration for the given service ID, forcing the next
+ * fetch to go to the network. Called on error / unavailable flows so a potentially
+ * stale cached config is not reused after something changed server-side. No-throw when
+ * `localStorage` is unavailable.
+ *
+ * @param serviceId - The service ID whose cached configuration should be cleared.
+ */
+export declare function clearServiceConfigCache(serviceId: string): void;
+/**
+ * Fetches the wallet service configuration, backed by a 1-day `localStorage` cache
+ * keyed on the service ID. Falls back gracefully (no caching) when `localStorage`
+ * is unavailable (e.g. private browsing). Shared by the instance `load()` flow and
+ * the static availability checks so both reuse the same cached fetch.
+ *
+ * @param api - The configured API client (env must already be set).
+ * @param serviceId - The service ID to fetch the configuration for.
+ * @returns The service configuration response.
+ */
+export declare function getServiceConfigCached(api: ApiInternal, serviceId: string): Promise<GetConfigResponse>;
+//# sourceMappingURL=service-config-cache.d.ts.map

package/bundles/types/open-wallets/base/service-config-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-config-cache.d.ts","sourceRoot":"","sources":["../../../src/open-wallets/base/service-config-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAUxE;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAM/D;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,CAAC,CAkC5B"}

package/bundles/types/open-wallets/google-pay-open-wallet-button.d.ts

@@ -1,7 +1,7 @@
 import { type GetConfigResponse } from '../api/api-service-internal';
 import type { OpenWalletService } from './base/open-wallet.service';
 import { OpenWalletButtons } from './base/open-wallet-buttons';
-import type { GooglePayOpenWalletMeta } from './interfaces/google-pay';
+import type { GooglePayAvailabilityOptions, GooglePayAvailabilityResult, GooglePayOpenWalletMeta } from './interfaces/google-pay';
 import type { WalletType } from './types';
 /**
  * @classdesc Google Pay wallet button that creates One-Time Tokens (OTT) via Google Pay.
@@ -39,6 +39,38 @@ import type { WalletType } from './types';
 export declare class GooglePayOpenWalletButton extends OpenWalletButtons<GooglePayOpenWalletMeta> {
     /** @private */
     readonly walletType: WalletType;
+    /**
+     * Checks Google Pay availability **without instantiating the button** — the static
+     * availability entry point.
+     *
+     * Loads the Google Pay JS SDK if needed, then runs `PaymentsClient.isReadyToPay()` using
+     * the **default** card configuration (a button instance with a custom `card_config` may
+     * produce a different result). All options are optional — unlike Apple Pay, Google Pay's
+     * readiness check does not require a merchant identifier; supplying `service_id` +
+     * `public_key_or_access_token` additionally validates that the service is a Google Pay service.
+     *
+     * Pass `{ sync: true }` for a cheap, network-free check that only reports whether the
+     * Google Pay JS API is already present (see {@link GooglePayAvailabilityOptions.sync}).
+     *
+     * @param {GooglePayAvailabilityOptions} [options] - Optional merchant context and mode.
+     * @returns {Promise<GooglePayAvailabilityResult>} The availability result.
+     *
+     * @example
+     * // Simplest form — no merchant context needed:
+     * const result = await GooglePayOpenWalletButton.checkAvailability();
+     * if (result.available) {
+     *   // Render the Google Pay button.
+     * }
+     *
+     * @example
+     * // Validate the service is a Google Pay service while checking:
+     * const result = await GooglePayOpenWalletButton.checkAvailability({
+     *   public_key_or_access_token,
+     *   service_id,
+     *   env: 'sandbox',
+     * });
+     */
+    static checkAvailability(options?: GooglePayAvailabilityOptions): Promise<GooglePayAvailabilityResult>;
     /**
      * Validates Google Pay-specific required metadata fields.
      * Google Pay has no additional required fields beyond the base (amount, currency, country).

package/bundles/types/open-wallets/google-pay-open-wallet-button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google-pay-open-wallet-button.d.ts","sourceRoot":"","sources":["../../src/open-wallets/google-pay-open-wallet-button.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAiB,MAAM,6BAA6B,CAAC;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,yBAA0B,SAAQ,iBAAiB,CAAC,uBAAuB,CAAC;IACvF,eAAe;IACf,SAAgB,UAAU,EAAE,UAAU,CAA2B;IAEjE;;;;OAIG;IACH,SAAS,CAAC,kBAAkB,IAAI,IAAI;IAMpC;;;;;;OAMG;IACH,SAAS,CAAC,mBAAmB,CAAC,aAAa,EAAE,iBAAiB,GAAG,IAAI;IASrE;;;;;;OAMG;IACH,SAAS,CAAC,mBAAmB,CAAC,aAAa,EAAE,iBAAiB,GAAG,iBAAiB;CAUnF"}
+{"version":3,"file":"google-pay-open-wallet-button.d.ts","sourceRoot":"","sources":["../../src/open-wallets/google-pay-open-wallet-button.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,iBAAiB,EAAiB,MAAM,6BAA6B,CAAC;AAEpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,KAAK,EACV,4BAA4B,EAC5B,2BAA2B,EAC3B,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AAOjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAG1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,yBAA0B,SAAQ,iBAAiB,CAAC,uBAAuB,CAAC;IACvF,eAAe;IACf,SAAgB,UAAU,EAAE,UAAU,CAA2B;IAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;WACiB,iBAAiB,CACnC,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,2BAA2B,CAAC;IAqDvC;;;;OAIG;IACH,SAAS,CAAC,kBAAkB,IAAI,IAAI;IAMpC;;;;;;OAMG;IACH,SAAS,CAAC,mBAAmB,CAAC,aAAa,EAAE,iBAAiB,GAAG,IAAI;IASrE;;;;;;OAMG;IACH,SAAS,CAAC,mBAAmB,CAAC,aAAa,EAAE,iBAAiB,GAAG,iBAAiB;CAUnF"}

package/bundles/types/open-wallets/index.d.ts

@@ -26,7 +26,7 @@ export { WALLET_TYPES } from './types/wallet-type.type';
  * @param {IApplePayShippingOption[]} [shipping_options] - Array of available shipping options. The first item is used as the default selected option. Requires `request_shipping` to be `true`.
  * @param {boolean} [show_billing_address] - Show billing address fields in the Apple Pay sheet.
  * @param {string} store_name - The merchant's store name displayed during payment.
- * @param {Array<'credentials_available' | 'credentials_status_unknown' | 'credentials_unavailable'>} [apple_pay_capabilities] - Device capabilities needed for the wallet button to be available.
+ * @param {Array<'credentials_available' | 'credentials_status_unknown' | 'credentials_unavailable'>} [apple_pay_capabilities] - Device credential statuses that make the button render. Defaults to `['credentials_available', 'credentials_status_unknown']`: `credentials_available` means the device has a confirmed Apple Pay card ready to use; `credentials_status_unknown` means a local card can't be confirmed but Apple Pay can still proceed (e.g. the cross-device QR flow used by Chrome, Edge and Firefox). Narrow to `['credentials_available']` to require a confirmed local card.
  * @param {Array<'supports3DS' | 'supportsEMV' | 'supportsCredit' | 'supportsDebit'>} [merchant_capabilities] - Array of merchant capabilities influencing the transaction processing features available.
  * @param {Array<'visa' | 'masterCard' | 'amex' | 'chinaUnionPay' | 'discover' | 'interac' | 'jcb' | 'privateLabel'>} [supported_networks] - List of payment networks supported for Apple Pay transactions.
  * @param {Array<'email' | 'name' | 'phone' | 'postalAddress'>} [required_billing_contact_fields] - Contact fields required from the user for billing purposes. Phone and email are currently not returned by Apple.
@@ -57,6 +57,87 @@ export { WALLET_TYPES } from './types/wallet-type.type';
  * @param {GooglePayButtonColor} [style.button_color] - The color of the Google Pay button (`'default'`, `'black'`, `'white'`).
  * @param {GooglePayButtonSizeMode} [style.button_size_mode] - The size mode (`'static'`, `'fill'`).
  **/
+/**
+ * Base options shared by every wallet's static availability check
+ * (e.g. {@link ApplePayOpenWalletButton}.checkAvailability). Wallet-specific option
+ * interfaces (such as {@link ApplePayAvailabilityOptions}) extend this.
+ *
+ * @interface OpenWalletAvailabilityOptions
+ *
+ * @type {object}
+ * @param {string} [public_key_or_access_token] - Public key or access token used to fetch the service config when needed.
+ * @param {string} [service_id] - Service ID — used with `public_key_or_access_token` to resolve the wallet configuration.
+ * @param {string} [env] - Environment for the config fetch (e.g. `'sandbox'`). Defaults to the SDK default.
+ * @param {boolean} [sync] - When `true`, performs only the cheap, network-free synchronous check and resolves immediately — no config fetch, SDK load, or remote capability query.
+ **/
+/**
+ * Base result shared by every wallet's static availability check. Wallet-specific
+ * result interfaces (such as {@link ApplePayAvailabilityResult}) extend this.
+ *
+ * @interface OpenWalletAvailabilityResult
+ *
+ * @type {object}
+ * @param {boolean} available - Convenience verdict: the wallet is usable for a payment in the current context.
+ * @param {boolean} supported - Whether the wallet is supported here at all (may be available via a fallback flow).
+ * @param {string} [reason] - Machine-readable reason when not available.
+ **/
+/**
+ * Options for `ApplePayOpenWalletButton.checkAvailability`. Extends
+ * {@link OpenWalletAvailabilityOptions}. Provide `merchant_id` directly to skip the network
+ * call, **or** provide `public_key_or_access_token` + `service_id` to resolve the merchant
+ * identifier from the service configuration.
+ *
+ * @interface ApplePayAvailabilityOptions
+ * @extends OpenWalletAvailabilityOptions
+ *
+ * @type {object}
+ * @param {string} [merchant_id] - Apple merchant identifier. Provide this OR (`public_key_or_access_token` + `service_id`).
+ * @param {Array<'credentials_available' | 'credentials_status_unknown' | 'credentials_unavailable'>} [apple_pay_capabilities] - Device credential statuses that count as available. Defaults to `['credentials_available', 'credentials_status_unknown']` — `credentials_status_unknown` is what third-party / cross-device (QR) browsers report, so the default keeps Apple Pay visible outside Safari.
+ * @param {boolean} [sync] - When `true`, runs only the synchronous native same-device check (`window.ApplePaySession` + `canMakePayments()`) and resolves immediately — no merchant resolution, SDK load, or `applePayCapabilities()` query. In this mode `available` reflects the native session only and `payment_credential_status` is `undefined`; it is **not** authoritative for cross-browser / QR availability.
+ **/
+/**
+ * Result of `ApplePayOpenWalletButton.checkAvailability`. Extends
+ * {@link OpenWalletAvailabilityResult}.
+ *
+ * Infer the transport (Apple does not expose it directly): `available && has_native_session`
+ * ⇒ native sheet likely; `available && !has_native_session` ⇒ cross-device / QR handoff likely.
+ *
+ * @interface ApplePayAvailabilityResult
+ * @extends OpenWalletAvailabilityResult
+ *
+ * @type {object}
+ * @param {boolean} available - Whether the device credential status is within the allowed capability set.
+ * @param {boolean} supported - Whether Apple Pay is usable here at all (incl. the cross-device QR flow). Derived from `payment_credential_status` (anything other than `applePayUnsupported`); falls back to the native `canMakePayments()` signal when the capabilities query could not run.
+ * @param {boolean} has_native_session - Whether a native, same-device Apple Pay session is present right now (`ApplePaySession` exists and `canMakePayments()` is `true`).
+ * @param {'paymentCredentialsAvailable' | 'paymentCredentialStatusUnknown' | 'paymentCredentialsUnavailable' | 'applePayUnsupported'} [payment_credential_status] - The raw device-reported credential status. Undefined when unsupported or not queried.
+ * @param {string} [reason] - Machine-readable reason when not available: `'unsupported_browser'`, `'missing_merchant_id'`, `'service_type_mismatch'`, `'config_fetch_failed'`, `'sdk_load_failed'`, `'query_failed'`, `'no_credentials'`, or `'no_native_session'` (only from the synchronous `sync: true` check).
+ **/
+/**
+ * Options for `GooglePayOpenWalletButton.checkAvailability`. Extends
+ * {@link OpenWalletAvailabilityOptions}. All fields are optional — Google Pay's
+ * `isReadyToPay` check does not require a merchant identifier. Supplying
+ * `public_key_or_access_token` + `service_id` additionally validates the service type.
+ *
+ * @interface GooglePayAvailabilityOptions
+ * @extends OpenWalletAvailabilityOptions
+ *
+ * @type {object}
+ * @param {string} [merchant_id] - Google Pay gateway merchant identifier. Optional; the readiness check runs without it.
+ * @param {boolean} [sync] - When `true`, reports only whether the Google Pay JS API is already present in the page (no `isReadyToPay` call). It does **not** run the device/card readiness check.
+ **/
+/**
+ * Result of `GooglePayOpenWalletButton.checkAvailability`. Extends
+ * {@link OpenWalletAvailabilityResult}.
+ *
+ * @interface GooglePayAvailabilityResult
+ * @extends OpenWalletAvailabilityResult
+ *
+ * @type {object}
+ * @param {boolean} available - Whether Google Pay is ready to pay in the current context (from `isReadyToPay().result`).
+ * @param {boolean} supported - Whether the Google Pay JS API is present and the readiness query could run.
+ * @param {boolean} [payment_method_present] - Google's `isReadyToPay` `paymentMethodPresent` — whether the buyer already has a usable payment method. Undefined when not reported.
+ * @param {string} [reason] - Machine-readable reason when not available: `'unsupported_browser'`, `'service_type_mismatch'`, `'config_fetch_failed'`, `'sdk_load_failed'`, `'query_failed'`, `'no_payment_method'`, or `'api_not_loaded'` (only from the synchronous `sync: true` check).
+ **/
 /**
  * Interface for OnClickEventData.
  * Emitted when the wallet button is clicked.

package/bundles/types/open-wallets/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/open-wallets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAM1E,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,mBAAmB,cAAc,CAAC;AAClC,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,mDAAmD,CAAC;AAC3D,YAAY,EAAE,sBAAsB,EAAE,MAAM,oDAAoD,CAAC;AACjG,mBAAmB,SAAS,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2BI;AAEJ;;;;;;;;;;;;;;;;;;;IAmBI;AAEJ;;;;;;;;;;;;;;;IAeI;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAoCI;AAEJ;;;;;;;;;;IAUI;AAEJ;;;;;;;;;;;IAWI;AAEJ;;;;;;;;;;;IAWI;AAEJ;;;;;;;;;IASI;AAEJ;;;;;;;IAOI;AAEJ;;;;;;;;;;;;;;;;;;;;;IAqBI;AAEJ;;;;;;;;;;;;IAYI;AAEJ;;;;;;;;;;;;;;IAcI;AAEJ;;;;;;;;;;IAUI;AAEJ;;;;;;;;;;;;;;;;;;;;;IAqBI;AAEJ;;;;;;;;;;IAUI;AAEJ;;;;;;;;;IASI;AAEJ;;;;;;;;;;;;IAYI;AAEJ;;;;;;;;;;;;;GAaG;AAEH;;;;;;;GAOG;AAEH;;;;;;;GAOG;AAEH;;;;;;;;;;GAUG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/open-wallets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAM1E,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,mBAAmB,cAAc,CAAC;AAClC,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,mDAAmD,CAAC;AAC3D,YAAY,EAAE,sBAAsB,EAAE,MAAM,oDAAoD,CAAC;AACjG,mBAAmB,SAAS,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2BI;AAEJ;;;;;;;;;;;;;;;;;;;IAmBI;AAEJ;;;;;;;;;;;;IAYI;AAEJ;;;;;;;;;;IAUI;AAEJ;;;;;;;;;;;;;IAaI;AAEJ;;;;;;;;;;;;;;;;IAgBI;AAEJ;;;;;;;;;;;;IAYI;AAEJ;;;;;;;;;;;;IAYI;AAEJ;;;;;;;;;;;;;;;IAeI;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAoCI;AAEJ;;;;;;;;;;IAUI;AAEJ;;;;;;;;;;;IAWI;AAEJ;;;;;;;;;;;IAWI;AAEJ;;;;;;;;;IASI;AAEJ;;;;;;;IAOI;AAEJ;;;;;;;;;;;;;;;;;;;;;IAqBI;AAEJ;;;;;;;;;;;;IAYI;AAEJ;;;;;;;;;;;;;;IAcI;AAEJ;;;;;;;;;;IAUI;AAEJ;;;;;;;;;;;;;;;;;;;;;IAqBI;AAEJ;;;;;;;;;;IAUI;AAEJ;;;;;;;;;IASI;AAEJ;;;;;;;;;;;;IAYI;AAEJ;;;;;;;;;;;;;GAaG;AAEH;;;;;;;GAOG;AAEH;;;;;;;GAOG;AAEH;;;;;;;;;;GAUG"}

package/bundles/types/open-wallets/interfaces/apple-pay/apple-pay-availability.interface.d.ts

@@ -0,0 +1,41 @@
+import type { OpenWalletAvailabilityOptions, OpenWalletAvailabilityResult } from '../open-wallet-availability.interface';
+/**
+ * Friendly capability tokens accepted as **input** — the same values used in
+ * `ApplePayOpenWalletMeta.apple_pay_capabilities`. They declare which device
+ * credential statuses should be treated as "available".
+ */
+export type ApplePayCapabilityToken = 'credentials_available' | 'credentials_status_unknown' | 'credentials_unavailable';
+/**
+ * Device-reported credential status — the **output** of
+ * `ApplePaySession.applePayCapabilities()`.
+ */
+export type ApplePayCredentialStatus = 'paymentCredentialsAvailable' | 'paymentCredentialStatusUnknown' | 'paymentCredentialsUnavailable' | 'applePayUnsupported';
+/**
+ * Options for `ApplePayOpenWalletButton.checkAvailability`. Provide `merchant_id`
+ * directly to skip the network call, **or** provide `public_key_or_access_token` +
+ * `service_id` to have the SDK resolve the merchant identifier from the service config.
+ */
+export interface ApplePayAvailabilityOptions extends OpenWalletAvailabilityOptions {
+    /** Apple merchant identifier. Provide this OR (`public_key_or_access_token` + `service_id`). */
+    merchant_id?: string;
+    /**
+     * Device credential statuses that count as available. Defaults to
+     * `['credentials_available', 'credentials_status_unknown']` — `credentials_status_unknown`
+     * is what third-party / cross-device (QR) browsers report, so the default keeps Apple Pay
+     * visible outside Safari.
+     */
+    apple_pay_capabilities?: ApplePayCapabilityToken[];
+}
+/** Result of `ApplePayOpenWalletButton.checkAvailability`. */
+export interface ApplePayAvailabilityResult extends OpenWalletAvailabilityResult {
+    /**
+     * Whether a **native, same-device** Apple Pay session is present right now
+     * (`ApplePaySession` exists and `canMakePayments()` is `true`). Apple does not expose
+     * the transport directly, so use this to infer it: `available && has_native_session` ⇒
+     * native sheet likely; `available && !has_native_session` ⇒ cross-device / QR handoff likely.
+     */
+    has_native_session: boolean;
+    /** The raw device-reported credential status. Undefined when unsupported or not queried. */
+    payment_credential_status?: ApplePayCredentialStatus;
+}
+//# sourceMappingURL=apple-pay-availability.interface.d.ts.map

package/bundles/types/open-wallets/interfaces/apple-pay/apple-pay-availability.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apple-pay-availability.interface.d.ts","sourceRoot":"","sources":["../../../../src/open-wallets/interfaces/apple-pay/apple-pay-availability.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,4BAA4B,EAC7B,MAAM,uCAAuC,CAAC;AAE/C;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAC/B,uBAAuB,GACvB,4BAA4B,GAC5B,yBAAyB,CAAC;AAE9B;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAChC,6BAA6B,GAC7B,gCAAgC,GAChC,+BAA+B,GAC/B,qBAAqB,CAAC;AAE1B;;;;GAIG;AACH,MAAM,WAAW,2BAA4B,SAAQ,6BAA6B;IAChF,gGAAgG;IAChG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,uBAAuB,EAAE,CAAC;CACpD;AAED,8DAA8D;AAC9D,MAAM,WAAW,0BAA2B,SAAQ,4BAA4B;IAC9E;;;;;OAKG;IACH,kBAAkB,EAAE,OAAO,CAAC;IAC5B,4FAA4F;IAC5F,yBAAyB,CAAC,EAAE,wBAAwB,CAAC;CACtD"}