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

package/bundles/types/api/api-base.d.ts

@@ -1,5 +1,6 @@
-import { Env } from '../configs/env';
 import { Observable } from 'rxjs';
+import { Env } from '../configs/env';
+import { type ErrorCause } from '../helper/event-error';
 import { type HttpRequestMethod } from '../shared/http/http-request';
 import { type ReportErrorFn, type ReportEventFn } from '../shared/services/instrumentation/repositories';
 export declare enum API_AUTH_TYPE {
@@ -38,10 +39,22 @@ export declare class ApiBase {
         text: string;
         status: number;
     }, cb: any, errorCb: any): any;
-    parserPromise<Res>({ text, status, }: {
+    parserPromise<Res>({ text, status }: {
         text: string;
         status: number;
     }): Promise<Res>;
+    /**
+     * Wires the XHR failure events that `onload` does not cover. `onload` only
+     * fires when an HTTP response is received (any status, including 4xx/5xx);
+     * transport-level failures — a dropped connection, a failed CORS preflight,
+     * an HTTP/2 protocol error, or a timeout — fire `onerror`/`ontimeout`/
+     * `onabort` instead. Without these the request never settles and fails
+     * silently (e.g. `onUnavailable` is never invoked for wallet callbacks).
+     */
+    protected attachFailureHandlers(request: XMLHttpRequest, onFailure: (error: {
+        message: string;
+        code: ErrorCause;
+    }) => void): void;
     reportEvent: ReportEventFn;
     reportError: ReportErrorFn;
     protected newApiRequest(method: Extract<HttpRequestMethod, 'GET' | 'POST'>, link: string): XMLHttpRequest;

package/bundles/types/api/api-base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-base.d.ts","sourceRoot":"","sources":["../../src/api/api-base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAmB,MAAM,MAAM,CAAC;AAEnD,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EACH,KAAK,aAAa,EAClB,KAAK,aAAa,EAErB,MAAM,iDAAiD,CAAC;AAEzD,oBAAY,aAAa;IACrB,UAAU,IAAI;IACd,KAAK,IAAI;CACZ;AAED,qBAAa,OAAO;IAChB,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;gBAEZ,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa;IAMlD;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO;IAM5C,iBAAiB,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,EAC5C,MAAM,EAAE,KAAK,GAAG,MAAM,EACtB,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,GAAG,GACjB,UAAU,CAAC,GAAG,CAAC;IAYlB,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,cAAc;IAsBtB,WAAW;IAQX,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,iBAAiB,EAAE,KAAK,GAAG,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM;;+BAKhD,CAAC,IAAI,KAAK,IAAI,mBAAmB,GAAG;;IAuB9D,gBAAgB,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,EACpC,MAAM,EAAE,OAAO,CAAC,iBAAiB,EAAE,KAAK,GAAG,MAAM,CAAC,EAClD,IAAI,EAAE,MAAM,GACb;QACC,MAAM,EAAE,cAAc,CAAC;QACvB,IAAI,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;KACrC;IA+BD,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,EAAE,KAAA,EAAE,OAAO,KAAA;IAkBtE,aAAa,CAAC,GAAG,EAAE,EACf,IAAI,EACJ,MAAM,GACT,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAkBlD,WAAW,EAAE,aAAa,CAExB;IAEF,WAAW,EAAE,aAAa,CAExB;IAEF,SAAS,CAAC,aAAa,CACnB,MAAM,EAAE,OAAO,CAAC,iBAAiB,EAAE,KAAK,GAAG,MAAM,CAAC,EAClD,IAAI,EAAE,MAAM;IAoBhB,IAAW,GAAG;;;;MAMb;CACJ"}
+{"version":3,"file":"api-base.d.ts","sourceRoot":"","sources":["../../src/api/api-base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAmB,MAAM,MAAM,CAAC;AACnD,OAAO,EAAW,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,aAAa,EACnB,MAAM,iDAAiD,CAAC;AAEzD,oBAAY,aAAa;IACvB,UAAU,IAAI;IACd,KAAK,IAAI;CACV;AAED,qBAAa,OAAO;IAClB,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;gBAEZ,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa;IAMlD;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO;IAM5C,iBAAiB,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,EAC9C,MAAM,EAAE,KAAK,GAAG,MAAM,EACtB,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,GAAG,GACf,UAAU,CAAC,GAAG,CAAC;IAYlB,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,cAAc;IAsBtB,WAAW;IAQX,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,iBAAiB,EAAE,KAAK,GAAG,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM;;+BAKpD,CAAC,IAAI,KAAK,IAAI,mBAAmB,GAAG;;IA6B1D,gBAAgB,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,EACtC,MAAM,EAAE,OAAO,CAAC,iBAAiB,EAAE,KAAK,GAAG,MAAM,CAAC,EAClD,IAAI,EAAE,MAAM,GACX;QACD,MAAM,EAAE,cAAc,CAAC;QACvB,IAAI,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;KACnC;IAkCD,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,EAAE,KAAA,EAAE,OAAO,KAAA;IAkBtE,aAAa,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAkBpF;;;;;;;OAOG;IACH,SAAS,CAAC,qBAAqB,CAC7B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,CAAA;KAAE,KAAK,IAAI;IAmBnE,WAAW,EAAE,aAAa,CAExB;IAEF,WAAW,EAAE,aAAa,CAExB;IAEF,SAAS,CAAC,aAAa,CACrB,MAAM,EAAE,OAAO,CAAC,iBAAiB,EAAE,KAAK,GAAG,MAAM,CAAC,EAClD,IAAI,EAAE,MAAM;IAoBd,IAAW,GAAG;;;;MAMb;CACF"}

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":"AAAA,OAAO,EAAiB,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAGvD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,8BAA8B,EAC9B,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACf,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,0DAA0D,CAAC;AACjH,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,8DAA8D,CAAC;AACzH,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,yDAAyD,CAAC;AAC/G,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,6DAA6D,CAAC;AACvH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAM/D;;;;;;;;;;;;;GAaG;AACH,8BAAsB,iBAAiB,CAAC,KAAK,SAAS,cAAc,GAAG,cAAc;IACnF,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC;IAC/B,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC;IAC3B,SAAS,CAAC,GAAG,SAAe;IAC5B,SAAS,CAAC,SAAS,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC;IACtB,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC;IACrC,SAAS,CAAC,aAAa,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACvD,SAAS,CAAC,UAAU,UAAS;IAC7B,OAAO,CAAC,wCAAwC,CAAS;IAEzD,eAAe;IACf,kBAAyB,UAAU,EAAE,UAAU,CAAC;IAEhD,eAAe;gBAEb,QAAQ,EAAE,MAAM,EAChB,sBAAsB,EAAE,MAAM,EAC9B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,KAAK;IAyBb;;;;;;;;OAQG;IACH,OAAO,CAAC,gCAAgC;IAMxC;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,mBAAmB,CACpC,aAAa,EAAE,iBAAiB,GAC/B,iBAAiB;IAEpB;;;;;;;OAOG;IACH,SAAS,CAAC,QAAQ,CAAC,mBAAmB,CAAC,aAAa,EAAE,iBAAiB,GAAG,IAAI;IAE9E;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,CAAC,kBAAkB,IAAI,IAAI;IAE7C,OAAO,CAAC,cAAc;IAOtB;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAexB,SAAS,CAAC,0BAA0B,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAIlE,SAAS,CAAC,aAAa,CACrB,KAAK,EAAE,KAAK,EACZ,SAAS,GAAE,eAAkD,GAC5D,IAAI;IAkBP;;;;;;;;;;;OAWG;IACI,IAAI,IAAI,IAAI;IAenB;;;;;;;;;OASG;IACI,MAAM,IAAI,IAAI;IAKrB;;;;;;;;;;;;;;;;OAgBG;IACI,OAAO,IAAI,IAAI;IAKtB;;;;;OAKG;IACH,SAAS,CAAC,mBAAmB,IAAI,IAAI;IAiBrC;;;;;;;;;;OAUG;IACI,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;IAKzC;;;;;;;;;OASG;IACI,OAAO,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IAOjC;;;;;;OAMG;IACI,OAAO,IAAI,IAAI;IAOtB;;;;;;OAMG;IACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACI,OAAO,CACZ,OAAO,EAAE,CACP,IAAI,EAAE,gBAAgB,KACnB,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,GACtD,IAAI;IAYP;;;;;OAKG;IACH;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACI,SAAS,CACd,OAAO,EAAE,CAAC,IAAI,EAAE,8BAA8B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACtE,IAAI;IAqBP;;;;;OAKG;IACH;;;;;;;;;;;;;;OAcG;IACI,aAAa,CAClB,OAAO,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC9D,IAAI;IAqBP;;;;;OAKG;IACH;;;;;;;;;;;;;;;OAeG;IACI,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAkB/E;;;;;OAKG;IACH;;;;;;;;;;;;;;OAcG;IACI,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAqBjF;;;;;;;;;;;;;OAaG;IACI,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAkBjF;;;;;;OAMG;IACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACI,uBAAuB,CAC5B,OAAO,EAAE,CACP,IAAI,EAAE,gCAAgC,KAEpC,oCAAoC,GACpC,OAAO,CAAC,oCAAoC,CAAC;IAYnD;;;;;;OAMG;IACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACI,uBAAuB,CAC5B,OAAO,EAAE,CACP,IAAI,EAAE,+BAA+B,KAEnC,mCAAmC,GACnC,OAAO,CAAC,mCAAmC,CAAC;IAalD;;;;;;OAMG;IACH,IAAW,wCAAwC,IAAI,OAAO,CAE7D;CACF"}

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"}

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

@@ -1,2 +1,3 @@
+export type { ApplePayAvailabilityOptions, ApplePayAvailabilityResult, ApplePayCapabilityToken, ApplePayCredentialStatus, } from './apple-pay-availability.interface';
 export type { ApplePayLineItem, ApplePayMerchantCapability, ApplePayPaymentContact, ApplePayPaymentRequest, } from './apple-pay-payment-request.interface';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/open-wallets/interfaces/apple-pay/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,uCAAuC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/open-wallets/interfaces/apple-pay/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,oCAAoC,CAAC;AAC5C,YAAY,EACV,gBAAgB,EAChB,0BAA0B,EAC1B,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,uCAAuC,CAAC"}

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

@@ -0,0 +1,25 @@
+import type { OpenWalletAvailabilityOptions, OpenWalletAvailabilityResult } from '../open-wallet-availability.interface';
+/**
+ * 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.
+ */
+export 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`. */
+export 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;
+}
+//# sourceMappingURL=google-pay-availability.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"google-pay-availability.interface.d.ts","sourceRoot":"","sources":["../../../../src/open-wallets/interfaces/google-pay/google-pay-availability.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,4BAA4B,EAC7B,MAAM,uCAAuC,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,WAAW,4BAA6B,SAAQ,6BAA6B;IACjF;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,+DAA+D;AAC/D,MAAM,WAAW,2BAA4B,SAAQ,4BAA4B;IAC/E;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC"}

package/bundles/types/open-wallets/interfaces/google-pay/index.d.ts

@@ -1,2 +1,3 @@
+export type { GooglePayAvailabilityOptions, GooglePayAvailabilityResult, } from './google-pay-availability.interface';
 export type { GooglePayAuthMethod, GooglePayCardConfig, GooglePayCardNetwork, GooglePayOpenWalletMeta, GooglePayOpenWalletMetaStyles, } from './google-pay-meta.interface';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/open-wallets/interfaces/google-pay/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/open-wallets/interfaces/google-pay/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,6BAA6B,CAAC"}

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

@@ -1,6 +1,9 @@
 export type { WalletType } from '../types/wallet-type.type';
 export { WALLET_TYPES } from '../types/wallet-type.type';
+export type { ApplePayAvailabilityOptions, ApplePayAvailabilityResult, ApplePayCapabilityToken, ApplePayCredentialStatus, } from './apple-pay/apple-pay-availability.interface';
 export type { OnCancelEventData, OnClickEventData, OnCreateOTTErrorEventData, OnCreateOTTErrorPayload, OnCreateOTTSuccessfulEventData, OnCreateOTTSuccessPayload, OnErrorEventData, OnErrorPayload, OnLoadedEventData, OnUnavailableDetails, OnUnavailableEventData, OnUnavailablePayload, } from './events.interface';
+export type { GooglePayAvailabilityOptions, GooglePayAvailabilityResult, } from './google-pay/google-pay-availability.interface';
+export type { OpenWalletAvailabilityOptions, OpenWalletAvailabilityResult, } from './open-wallet-availability.interface';
 export type { OpenWalletMeta } from './open-wallet-meta.interface';
 export type { IOpenWalletProvider } from './payment-source.interface';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/open-wallets/interfaces/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,yBAAyB,EACzB,uBAAuB,EACvB,8BAA8B,EAC9B,yBAAyB,EACzB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/open-wallets/interfaces/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,YAAY,EACV,2BAA2B,EAC3B,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,8CAA8C,CAAC;AACtD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,yBAAyB,EACzB,uBAAuB,EACvB,8BAA8B,EAC9B,yBAAyB,EACzB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,gDAAgD,CAAC;AACxD,YAAY,EACV,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * Base options shared by every wallet's static availability check
+ * (e.g. `ApplePayOpenWalletButton.checkAvailability`). Wallet-specific option
+ * interfaces extend this with their own fields.
+ */
+export 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.
+ */
+export 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;
+}
+//# sourceMappingURL=open-wallet-availability.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"open-wallet-availability.interface.d.ts","sourceRoot":"","sources":["../../../src/open-wallets/interfaces/open-wallet-availability.interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,+EAA+E;IAC/E,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,+FAA+F;IAC/F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,sFAAsF;IACtF,SAAS,EAAE,OAAO,CAAC;IACnB,0FAA0F;IAC1F,SAAS,EAAE,OAAO,CAAC;IACnB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

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

@@ -0,0 +1,58 @@
+/// <reference types="applepayjs" />
+import type { ApplePayAvailabilityResult, ApplePayCapabilityToken } from '../../interfaces/apple-pay/apple-pay-availability.interface';
+declare global {
+    interface Window {
+        ApplePaySession: ApplePaySession;
+    }
+}
+/** Parameters for {@link evaluateApplePayAvailability}. */
+export interface EvaluateApplePayAvailabilityParams {
+    /** Apple merchant identifier required by `ApplePaySession.applePayCapabilities`. */
+    merchantId: string;
+    /**
+     * Statuses that count as available. Defaults to
+     * `['credentials_available', 'credentials_status_unknown']` — the `unknown` status
+     * is the normal value in third-party / cross-device (QR) browsers, so including it
+     * is what makes Apple Pay show up outside Safari.
+     */
+    apple_pay_capabilities?: ApplePayCapabilityToken[];
+}
+/** CDN location of Apple's web SDK (provides the `<apple-pay-button>` web component). */
+export declare const APPLE_PAY_SDK_URL = "https://applepay.cdn-apple.com/jsapi/1.latest/apple-pay-sdk.js";
+/**
+ * Statuses that count as available when the merchant does not override them.
+ * Includes `paymentCredentialStatusUnknown` so the button is shown in third-party /
+ * cross-device (QR) browsers, per Apple's guidance.
+ */
+export declare const DEFAULT_APPLE_PAY_CAPABILITIES: ApplePayJS.PaymentCredentialStatus[];
+/**
+ * Maps the SDK's friendly capability tokens to Apple's `PaymentCredentialStatus` values.
+ * Unknown tokens are passed through unchanged.
+ */
+export declare function formatCapabilities(capabilities: ApplePayCapabilityToken[] | string[]): ApplePayJS.PaymentCredentialStatus[];
+/**
+ * Synchronous, network-free check for a **native, same-device** Apple Pay session
+ * (`window.ApplePaySession` exists and `canMakePayments()` is `true`). Safe to call in
+ * any environment (never throws).
+ *
+ * Note: this is a legacy/Safari-oriented signal. It is **not** authoritative for
+ * cross-browser / cross-device (QR) availability — in Chrome/Edge/Firefox
+ * `window.ApplePaySession` is supplied by the CDN SDK and may be absent until it loads,
+ * and the cross-device flow is reflected by `applePayCapabilities()`, not this call.
+ * Use {@link evaluateApplePayAvailability} for the authoritative, cross-browser answer.
+ */
+export declare function hasNativeApplePaySession(): boolean;
+/**
+ * Idempotently loads Apple's web SDK from the CDN.
+ * Resolves immediately if the `<apple-pay-button>` custom element is already
+ * registered, and de-duplicates concurrent loads. Rejects if the script fails to load.
+ */
+export declare function loadApplePaySdk(): Promise<void>;
+/**
+ * Core Apple Pay availability evaluation, shared by the instance flow
+ * (`ApplePayOpenWalletService`) and the static `ApplePayOpenWalletButton.checkAvailability`.
+ *
+ * Assumes the Apple Pay SDK is already loaded (call {@link loadApplePaySdk} first).
+ */
+export declare function evaluateApplePayAvailability(params: EvaluateApplePayAvailabilityParams): Promise<ApplePayAvailabilityResult>;
+//# sourceMappingURL=apple-pay-availability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apple-pay-availability.d.ts","sourceRoot":"","sources":["../../../../src/open-wallets/services/apple-pay/apple-pay-availability.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,uBAAuB,EAExB,MAAM,6DAA6D,CAAC;AAErE,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,eAAe,EAAE,eAAe,CAAC;KAClC;CACF;AAED,2DAA2D;AAC3D,MAAM,WAAW,kCAAkC;IACjD,oFAAoF;IACpF,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,uBAAuB,EAAE,CAAC;CACpD;AAED,yFAAyF;AACzF,eAAO,MAAM,iBAAiB,mEACoC,CAAC;AAEnE;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,EAAE,UAAU,CAAC,uBAAuB,EAG9E,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,uBAAuB,EAAE,GAAG,MAAM,EAAE,GACjD,UAAU,CAAC,uBAAuB,EAAE,CAUtC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAWlD;AAID;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAwB/C;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,kCAAkC,GACzC,OAAO,CAAC,0BAA0B,CAAC,CAsDrC"}