@economist/web-apple-pay 0.1.1-beta.0

package/dist/src/apple-pay-button.d.ts

@@ -0,0 +1,45 @@
+import type { Offer, ProductVariant } from './types/offer.types';
+export declare const APPLE_PAY_EXCLUDED_VARIANTS: readonly ProductVariant[];
+export declare class ApplePayButton extends HTMLElement {
+    #private;
+    static readonly tag = "teg-apple-pay-button";
+    static define(): void;
+    /**
+     * Creates and configures an ApplePayButton if the feature flag is present.
+     */
+    static createIfEnabled(offer: Offer | undefined, country: string, entryPoint: string): ApplePayButton | null;
+    get offer(): Offer | null;
+    set offer(value: Offer | null);
+    get country(): string;
+    set country(value: string);
+    get entryPoint(): string;
+    set entryPoint(value: string);
+    /**
+     * Awaitable contract for the component's current render lifecycle.
+     *
+     * - If called **after** the element has been appended to the DOM, resolves
+     *   once `connectedCallback` finishes — whether Apple Pay rendered
+     *   successfully or was hidden (unavailable / suppressed by session).
+     * - If called **before** the element is appended (or if it has never been
+     *   connected), resolves immediately to `undefined`. It does **not** wait
+     *   for a future connection, so always `await whenReady()` after `appendChild`:
+     *
+     * ```ts
+     * container.appendChild(btn);  // browser fires connectedCallback
+     * await btn.whenReady();       // waits for render to finish
+     * if (btn.style.display !== 'none') { /* available *\/ }
+     * ```
+     */
+    whenReady(): Promise<void>;
+    connectedCallback(): Promise<void>;
+    /**
+     * Resets all render state when the element is removed from the DOM.
+     *
+     * A shared library component cannot assume it won't be moved in the DOM
+     * (e.g. lazy panels, SPA route changes). Resetting on disconnect means
+     * reattach always triggers a fresh `#run()` — new session check, new payment
+     * options fetch, fresh event listeners — preventing stale data from persisting
+     * and eliminating the implicit reliance on the DOM as a render-state flag.
+     */
+    disconnectedCallback(): void;
+}