@tagadapay/headless-sdk 1.19.0 → 1.20.1

package/CHANGELOG.md

@@ -0,0 +1,193 @@
+# Changelog
+
+All notable changes to `@tagadapay/headless-sdk`.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); the package follows
+[semantic versioning](https://semver.org/): major = breaking, minor = feature, patch = fix.
+
+## [Unreleased]
+
+## [1.20.1] — 2026-10-22
+
+### Added
+
+- Every request carries `X-Tagada-SDK: headless-sdk/<version>`, so the platform can tell which SDK version a store runs. No contract change.
+
+### Added
+
+- `payment.mountOceanPayment({ checkoutSessionId, container, mode?, returnUrl?, locale?, signal? })`: pay a
+  checkout session with the merchant's own Ocean Payment account, the way the hosted checkout does. With
+  Ocean's public key on the integration, Ocean's card fields render in `container`; otherwise, or with
+  `mode: 'redirect'`, `pay()` sends the shopper to Ocean's page and back to `returnUrl` (default: the
+  current page). `payment.getOceanPaymentConfig(checkoutSessionId)` tells which of the two the store runs.
+- `maybeResumeFromUrl()` and `usePayment()` resume an Ocean card payment after 3-D Secure, which returns
+  the shopper to the page with nothing in the URL.
+- On-chain crypto (`crypto_onchain`), paid from your own page with no redirect:
+  `payment.getCryptoOnchainOptions(checkoutSessionId)` (networks and coins),
+  `payment.createCryptoOnchainPayment({ checkoutSessionId, chainId, asset })` (deposit address, exact amount,
+  wallet URI for the QR code; call again for another coin or an expired quote) and
+  `payment.getCryptoOnchainStatus({ checkoutSessionId, cryptoOnchainPaymentId })`. `payment.createCryptoOnchainCheckout()`
+  runs the whole flow (default network and coin, status polling, quote countdown, `onPaid` once confirmed) and
+  `useCryptoOnchainPayment()` is its React hook. Never send `crypto_onchain` to `pay()` / `processApm()`: the API
+  refuses it with `422 CRYPTO_ONCHAIN_INLINE_ONLY`.
+
+### Fixed
+
+- Polling a payment (`processPayment()`, `resumeAfterRedirect()`, `pollPaymentStatus()`) stops at once on
+  `rejected` and `error` instead of waiting the full timeout and returning `pending`.
+
+## [1.20.0] — 2026-10-16
+
+### Added
+
+- `rx.getIntakeContext({ orderId, checkoutToken })`: resume an unfinished Rx intake after the patient
+  closed the tab or opened the recovery email link. Returns the Rx line (`productId`, `variantId`) and
+  the basics on the order (name, email, phone, shipping address), or `{ caseExists: true }` once a case
+  is in. Date of birth and sex at birth are never returned: ask them again before `submitCase`.
+
+### Fixed
+
+- `processPayment()` and `finalize()` no longer return `status: 'failed'` for a card payment paused on
+  Stripe Radar (`stripe_radar` action, the Tagada-managed processor included): they create the Radar
+  session with Stripe.js, resume the payment and return its real outcome, like the 3DS path.
+
+## [1.19.0] — 2026-10-09
+
+### Added
+
+- `rx.validateIntake()`: checks the patient (US address in the 50 states or DC, US phone, 5 digit ZIP,
+  adult) and, once filled, the intake against the clinical network rules, without creating anything.
+  Call it before payment.
+- `isQuestionActive(question, answers, { state, sexAtBirth })` and `toIntakeAnswers(...)`: render and
+  send the network questionnaire exactly like Tagada's storefronts (hidden questions, "Yes" follow-ups,
+  pregnancy for women only, hidden defaults).
+- `RxClinicalQuestion` exposes `visible`, `rules`, `important`, `critical`, `label`, `defaultValue`.
+
+### Changed
+
+- `rx.submitCase()` now fails with 422 and the list of fields to fix when the patient or intake does not
+  meet the clinical network rules (the server enforces them for every integration). Nothing reaches the
+  clinician and the same order can be resubmitted.
+- Docs: an empty questionnaire means the product has none; a storefront must never replace a network
+  questionnaire with its own quiz.
+
+## [1.18.0] — 2026-10-09
+
+### Added
+
+- `TagadaHeadlessProviderConfigProps`: `TagadaHeadlessProvider` accepts `config` alone, without a `storeId`
+  prop (`config` replaces the individual props). It is the only way to pass `funnel`.
+
+### Changed
+
+- **`customer.getByEmail()` rejects** with a `TagadaError` of code `not_supported`, without sending a
+  request, and is deprecated. It always resolved `null` before, because no route finds a customer by email
+  for a storefront session (the only email search needs a secret API key). Use `portal.getMe()` or
+  `customer.getProfile(customerId)`.
+
+### Fixed
+
+- `customer.getOrders`, `getSubscriptions` and `getSubscription` call the routes that serve them
+  (`GET /api/v1/orders/customer/:customerId`, `GET /api/v1/subscriptions`); they always failed with a 404.
+  They need that customer's session (checkout session or portal login). `getOrders` slices with
+  `limit`/`offset` in the SDK; `getSubscriptions` returns the 20 most recent; `getSubscription` looks the
+  id up among them and rejects with `TagadaNotFoundError` when it is not there.
+- `TagadaHeadlessProvider` keeps the same client while the config values stay equal: an inline `config`
+  no longer builds a new client on every render, which dropped the checkout session token and re-fetched
+  the tracking config. `bootstrap` is compared by content.
+
+## [1.17.0] — 2026-10-08
+
+### Added
+
+- **`client.portal`** (`CustomerPortalModule`): the customer portal over `/api/v1/portal/*` and
+  `/api/v1/subscriptions/*`.
+  - Login: `requestCode`, `verifyCode` (the client keeps the session token).
+  - Reads: `getConfig` (no login), `getMe`, `getCredits`, `getOffer`.
+  - Cancellation: `cancelFlow`, `acceptCancelOffer`, `switchOption`.
+  - Subscriptions: `addToNextOrder`, `sendNow`, `reactivateSubscription`, `setSubscriptionCard`,
+    `setSubscriptionAddress`, `skipDate`, `unskipDate`, `retryPayment`.
+  - Account: `updateProfile`, `requestEmailChangeCode`, `saveAddress`, `removeAddress`,
+    `setDefaultAddress`, `addCard`, `removeCard`, `setDefaultPaymentMethod`.
+  - Purchases: `buyAgain`, `buyNow`, `joinMembership`, `acceptOffer`, `redeemCredits`, `buyCreditPack`.
+    A charge that needs 3DS answers `status: 'requires_action'` with a `redirectUrl`.
+- `client.customer` subscription actions over the existing `/api/v1/subscriptions/*` routes:
+  `pauseSubscription`, `resumeSubscription`, `skipSubscription`, `rescheduleSubscription`,
+  `updateSubscriptionQuantity`, `changeSubscriptionFrequency`, `swapSubscriptionProduct`,
+  `updateSubscriptionPaymentMethod`, `cancelSubscription`.
+- Type namespace `PortalTypes`: the portal data contract (store, products, options, membership, retention,
+  customer, orders, subscriptions, credits, portal design, REST payloads).
+- Lazy own-host v2 tracking behind the R4 store switches.
+- `client.experiments` facade and optional server assignment `bootstrap`.
+- Snapchat `client_dedup_id` and Pinterest `event_id` for events carrying a dedup ID.
+
+### Changed
+
+- `customer.updateProfile(customerId, data)` posts to the existing `/api/v1/customers/:id` route and saves
+  `email` only; the name and phone of a logged-in customer go through `portal.updateProfile`.
+
+### Preserved
+
+- Constructor and SSR silence, opt-in tracking, existing SDK exports and v1 event payloads.
+
+## [1.16.0] — 2026-09-26
+
+### Added
+
+- **`tagada.rx.getActivationStatus(storeId?)`** — the Tagada Rx activation status of a store: steps,
+  missing items, the statement descriptor review state and `payments: 'setting_up' | 'ready'`.
+  Defaults to the client's `storeId`. Calls the public `GET /api/public/v1/rx/activation-status`.
+- Types `RxActivationStatus`, `RxActivationStepKey`, `RxActivationMissingItem`.
+
+### Unchanged, stated on purpose
+
+- `RxModule` takes an optional second constructor argument (the store id); `new RxModule(http)`
+  keeps working.
+- No new HTTP header; every existing signature and return value is identical.
+
+## [1.15.0] — 2026-09-22 (never published to npm; first published in 1.16.0)
+
+### Added
+
+- **`tagada.track`** — report the steps and events of a funnel you code yourself: `step()`,
+  `event()`, `identify()`, `consent()`, `health()`. It stays inert until `track.step()` is called
+  once, and then fires the browser pixels bound to that step on the Tagada canvas.
+- **`useStep(stepId, data?)`** from `@tagadapay/headless-sdk/react`.
+- **`funnel`** client option (optional, defaults to `'main'`): the key of the funnel declared in
+  `tagada.funnel.ts`. Read by `track` only.
+- **`@tagadapay/headless-sdk/stripe`** is now a declared export subpath. The deep file import into
+  `dist/stripe/index.js` keeps working unchanged.
+- **`dist/tagada-pixels.min.js`** — the pixel engine as its own CDN file (`window.TagadaPixels`),
+  loaded on demand by `track`. The core CDN bundle does not carry it.
+
+### Fixed
+
+- The `/stripe` entry no longer throws at import time when the optional peer
+  `@tagadapay/core-js` is absent; only calling a wallet function rejects, and the original loader
+  error is kept as `cause`.
+- `payment.loadCoreJs` keeps the original error as `cause` as well.
+
+### Unchanged, stated on purpose
+
+- No new HTTP header on any route, existing or new.
+- `window.TagadaHeadless`, `window.TagadaHeadless.create` and `window.TagadaHeadlessReact` are
+  identical.
+- Every existing signature and return value is identical, `getExpressMethods()` included.
+- Nothing happens until `track.step()` is called once: an upgrade on its own sends no request.
+
+## [1.14.1] — 2026-09-09
+
+### Fixed
+
+- **`checkout.createSessionUrl()`** — forward `discountCodes`, `metadata`, `customerMetadata`, and
+  `customerTags` to `createSession()` instead of dropping them on the self-hosted checkout path.
+  #TAG-2560
+
+## [1.14.0] — 2026-09-09
+
+### Added
+
+- **`checkout.createSession()`** and **`useCheckout().createSession()`** — optional `discountCodes`,
+  `metadata`, `customerMetadata`, and `customerTags` on session init (pass-through to
+  `POST /api/v1/checkout/session/init`). Use when handing off from your landing page with promo
+  codes and affiliate attribution already attached. #TAG-2560

package/dist/core/helpers/cryptoOnchain.d.ts

@@ -0,0 +1,83 @@
+/**
+ * On-chain crypto (`crypto_onchain`): the pure rules of the inline payment and the
+ * `CryptoOnchainCheckout` flow. Same behaviour as the hosted (Studio) checkout's crypto panel:
+ * default network and coin, status phases, quote countdown, polling until paid.
+ */
+import type { CryptoOnchainCheckoutOptions, CryptoOnchainCheckoutState, CryptoOnchainNetwork, CryptoOnchainOptionsResult, CryptoOnchainPaymentResult, CryptoOnchainPhase, CryptoOnchainSelection, CryptoOnchainStatus, CryptoOnchainStatusResult } from '../types.js';
+/** `paymentSetupConfig` key and payment method name of on-chain crypto. */
+export declare const CRYPTO_ONCHAIN_PAYMENT_METHOD = "crypto_onchain";
+/** How often the checkout polls the status, in milliseconds. */
+export declare const CRYPTO_ONCHAIN_STATUS_POLL_MS = 5000;
+/** Phases after which polling stops. */
+export declare const CRYPTO_ONCHAIN_FINAL_PHASES: readonly CryptoOnchainPhase[];
+/** True for `crypto_onchain` in any spelling a checkout uses (`crypto-onchain`, `crypto_onchain:int_…`). */
+export declare function isCryptoOnchainMethod(method: string | null | undefined): boolean;
+/**
+ * The default pick: the first mainnet network (testnets only when nothing else is offered) and its
+ * first stablecoin, else its first coin. Null when no network offers a coin.
+ */
+export declare function defaultCryptoOnchainSelection(networks: CryptoOnchainNetwork[]): CryptoOnchainSelection | null;
+/** Switching network keeps the coin when the new network offers it, else takes its default coin. */
+export declare function selectCryptoOnchainNetwork(networks: CryptoOnchainNetwork[], chainId: number, currentAsset: string): CryptoOnchainSelection;
+/** The phase of the latest status (or of the payment as created, before the first poll). */
+export declare function cryptoOnchainPhase(status: Pick<CryptoOnchainStatus, 'status' | 'paid' | 'expired'> | null): CryptoOnchainPhase;
+/** Whole seconds until `expiresAt`, never negative; 0 for a missing or unparsable date. */
+export declare function cryptoOnchainSecondsLeft(expiresAt: string | null, nowMs: number): number;
+/** `m:ss` under an hour, `h:mm:ss` above. */
+export declare function formatCryptoOnchainCountdown(seconds: number): string;
+/** The three calls the flow needs; `PaymentModule` provides them. */
+export interface CryptoOnchainApi {
+    getCryptoOnchainOptions(checkoutSessionId: string): Promise<CryptoOnchainOptionsResult>;
+    createCryptoOnchainPayment(opts: {
+        checkoutSessionId: string;
+        chainId: number;
+        asset: string;
+    }): Promise<CryptoOnchainPaymentResult>;
+    getCryptoOnchainStatus(opts: {
+        checkoutSessionId: string;
+        cryptoOnchainPaymentId: string;
+    }): Promise<CryptoOnchainStatusResult>;
+}
+/**
+ * The inline crypto payment of one checkout session: load the networks and coins, keep the pick,
+ * create (or re-quote) the payment, poll it until crypto-api confirms it and call `onPaid` once.
+ * Create it with `tagada.payment.createCryptoOnchainCheckout()`.
+ */
+export declare class CryptoOnchainCheckout {
+    private readonly api;
+    private readonly options;
+    private state;
+    private readonly listeners;
+    private pollTimer;
+    private stopped;
+    private paidNotified;
+    constructor(api: CryptoOnchainApi, options: CryptoOnchainCheckoutOptions);
+    getState(): CryptoOnchainCheckoutState;
+    /** Listens to every state change; returns the unsubscribe function. */
+    subscribe(listener: (state: CryptoOnchainCheckoutState) => void): () => void;
+    /** What to show: the polled phase, or `expired` once an unpaid quote ran out (renew with `pay()`). */
+    getPhase(nowMs?: number): CryptoOnchainPhase;
+    /** Whole seconds left on the current quote. */
+    getSecondsLeft(nowMs?: number): number;
+    /** Loads the networks and coins and picks the default network and coin. */
+    loadOptions(): Promise<CryptoOnchainCheckoutState>;
+    /** Changes the pick. A new network keeps the coin when it offers it, else takes its default coin. */
+    select(next: {
+        chainId?: number;
+        asset?: string;
+    }): void;
+    /**
+     * Creates the payment for the pick (or `selection`), or re-quotes it: another coin, or a quote
+     * that expired. Save the customer and address on the session first. Starts polling.
+     */
+    pay(selection?: CryptoOnchainSelection): Promise<CryptoOnchainPaymentResult>;
+    /** Polls the status once now (the timer keeps polling until the payment is final). */
+    refreshStatus(): Promise<CryptoOnchainStatus | null>;
+    /** Polls again after `stop()`, while a payment is open (the customer came back to crypto). */
+    resume(): void;
+    /** Stops polling (unmount, or the customer chose another payment method). */
+    stop(): void;
+    private schedulePoll;
+    private setState;
+}
+//# sourceMappingURL=cryptoOnchain.d.ts.map

package/dist/core/helpers/cryptoOnchain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cryptoOnchain.d.ts","sourceRoot":"","sources":["../../../src/core/helpers/cryptoOnchain.ts"],"names":[],"mappings":"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"}

package/dist/core/helpers/cryptoOnchain.js

@@ -0,0 +1,247 @@
+/** `paymentSetupConfig` key and payment method name of on-chain crypto. */
+export const CRYPTO_ONCHAIN_PAYMENT_METHOD = 'crypto_onchain';
+/** How often the checkout polls the status, in milliseconds. */
+export const CRYPTO_ONCHAIN_STATUS_POLL_MS = 5000;
+/** Phases after which polling stops. */
+export const CRYPTO_ONCHAIN_FINAL_PHASES = ['paid', 'underpaid', 'failed', 'expired'];
+/** True for `crypto_onchain` in any spelling a checkout uses (`crypto-onchain`, `crypto_onchain:int_…`). */
+export function isCryptoOnchainMethod(method) {
+    if (!method)
+        return false;
+    return method.trim().toLowerCase().replace(/-/g, '_').split(':')[0] === CRYPTO_ONCHAIN_PAYMENT_METHOD;
+}
+/**
+ * The default pick: the first mainnet network (testnets only when nothing else is offered) and its
+ * first stablecoin, else its first coin. Null when no network offers a coin.
+ */
+export function defaultCryptoOnchainSelection(networks) {
+    const usable = networks.filter((network) => network.assets.length > 0);
+    const network = usable.find((candidate) => !candidate.testnet) ?? usable[0];
+    if (!network)
+        return null;
+    const asset = network.assets.find((candidate) => candidate.stable) ?? network.assets[0];
+    return { chainId: network.chainId, asset: asset.symbol };
+}
+/** Switching network keeps the coin when the new network offers it, else takes its default coin. */
+export function selectCryptoOnchainNetwork(networks, chainId, currentAsset) {
+    const assets = networks.find((network) => network.chainId === chainId)?.assets ?? [];
+    const keep = assets.find((asset) => asset.symbol === currentAsset);
+    const fallback = assets.find((asset) => asset.stable) ?? assets[0];
+    return { chainId, asset: (keep ?? fallback)?.symbol ?? currentAsset };
+}
+/** The phase of the latest status (or of the payment as created, before the first poll). */
+export function cryptoOnchainPhase(status) {
+    if (!status)
+        return 'waiting';
+    if (status.paid)
+        return 'paid';
+    switch (status.status) {
+        case 'detected':
+        case 'overpaid':
+            return 'confirming';
+        case 'underpaid':
+            return 'underpaid';
+        case 'failed':
+            return 'failed';
+        case 'expired':
+            return 'expired';
+        default:
+            return status.expired ? 'expired' : 'waiting';
+    }
+}
+/** Whole seconds until `expiresAt`, never negative; 0 for a missing or unparsable date. */
+export function cryptoOnchainSecondsLeft(expiresAt, nowMs) {
+    if (!expiresAt)
+        return 0;
+    const end = Date.parse(expiresAt);
+    if (Number.isNaN(end))
+        return 0;
+    return Math.max(0, Math.floor((end - nowMs) / 1000));
+}
+/** `m:ss` under an hour, `h:mm:ss` above. */
+export function formatCryptoOnchainCountdown(seconds) {
+    const s = Math.max(0, Math.floor(seconds));
+    const h = Math.floor(s / 3600);
+    const m = Math.floor((s % 3600) / 60);
+    const sec = String(s % 60).padStart(2, '0');
+    return h > 0 ? `${h}:${String(m).padStart(2, '0')}:${sec}` : `${m}:${sec}`;
+}
+const UNAVAILABLE = 'Crypto payments are not available right now. Choose another payment method.';
+/**
+ * The inline crypto payment of one checkout session: load the networks and coins, keep the pick,
+ * create (or re-quote) the payment, poll it until crypto-api confirms it and call `onPaid` once.
+ * Create it with `tagada.payment.createCryptoOnchainCheckout()`.
+ */
+export class CryptoOnchainCheckout {
+    constructor(api, options) {
+        this.api = api;
+        this.options = options;
+        this.state = {
+            options: 'idle',
+            networks: [],
+            selection: null,
+            payment: null,
+            paymentStatus: null,
+            isCreating: false,
+            error: null,
+        };
+        this.listeners = new Set();
+        this.pollTimer = null;
+        this.stopped = false;
+        this.paidNotified = false;
+        this.subscribe = this.subscribe.bind(this);
+        this.getState = this.getState.bind(this);
+    }
+    getState() {
+        return this.state;
+    }
+    /** Listens to every state change; returns the unsubscribe function. */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    /** What to show: the polled phase, or `expired` once an unpaid quote ran out (renew with `pay()`). */
+    getPhase(nowMs = Date.now()) {
+        const { payment, paymentStatus } = this.state;
+        const phase = cryptoOnchainPhase(paymentStatus ?? (payment ? { status: payment.status, paid: false, expired: false } : null));
+        const quoteOver = payment !== null && phase === 'waiting' && cryptoOnchainSecondsLeft(payment.expiresAt, nowMs) === 0;
+        return quoteOver ? 'expired' : phase;
+    }
+    /** Whole seconds left on the current quote. */
+    getSecondsLeft(nowMs = Date.now()) {
+        return cryptoOnchainSecondsLeft(this.state.payment?.expiresAt ?? null, nowMs);
+    }
+    /** Loads the networks and coins and picks the default network and coin. */
+    async loadOptions() {
+        this.setState({ options: 'loading', error: null });
+        try {
+            const result = await this.api.getCryptoOnchainOptions(this.options.checkoutSessionId);
+            if (!result.ok) {
+                this.setState({ options: 'unavailable', networks: [], selection: null, error: result.message || UNAVAILABLE });
+                return this.state;
+            }
+            const selection = this.state.selection ?? defaultCryptoOnchainSelection(result.networks);
+            this.setState(selection
+                ? { options: 'ready', networks: result.networks, selection }
+                : { options: 'unavailable', networks: result.networks, selection: null, error: UNAVAILABLE });
+        }
+        catch (error) {
+            this.setState({ options: 'unavailable', error: messageOf(error) });
+        }
+        return this.state;
+    }
+    /** Changes the pick. A new network keeps the coin when it offers it, else takes its default coin. */
+    select(next) {
+        const current = this.state.selection;
+        if (next.chainId !== undefined && next.chainId !== current?.chainId) {
+            this.setState({ selection: selectCryptoOnchainNetwork(this.state.networks, next.chainId, next.asset ?? current?.asset ?? '') });
+            return;
+        }
+        if (next.asset !== undefined && current)
+            this.setState({ selection: { ...current, asset: next.asset } });
+    }
+    /**
+     * Creates the payment for the pick (or `selection`), or re-quotes it: another coin, or a quote
+     * that expired. Save the customer and address on the session first. Starts polling.
+     */
+    async pay(selection) {
+        const target = selection ?? this.state.selection;
+        if (!target)
+            return { ok: false, code: 'ASSET_NOT_AVAILABLE', message: 'Choose a network and a coin' };
+        if (this.state.isCreating)
+            return { ok: false, code: 'CHECKOUT_FAILED', message: 'A payment is already being created' };
+        this.setState({ isCreating: true, error: null, selection: target });
+        try {
+            const result = await this.api.createCryptoOnchainPayment({
+                checkoutSessionId: this.options.checkoutSessionId,
+                chainId: target.chainId,
+                asset: target.asset,
+            });
+            if (!result.ok) {
+                this.setState({ isCreating: false, error: result.message });
+                return result;
+            }
+            this.stopped = false;
+            this.setState({ isCreating: false, payment: result.payment, paymentStatus: null });
+            this.schedulePoll();
+            return result;
+        }
+        catch (error) {
+            const message = messageOf(error);
+            this.setState({ isCreating: false, error: message });
+            return { ok: false, code: 'CHECKOUT_FAILED', message };
+        }
+    }
+    /** Polls the status once now (the timer keeps polling until the payment is final). */
+    async refreshStatus() {
+        const payment = this.state.payment;
+        if (!payment)
+            return null;
+        try {
+            const result = await this.api.getCryptoOnchainStatus({
+                checkoutSessionId: this.options.checkoutSessionId,
+                cryptoOnchainPaymentId: payment.cryptoOnchainPaymentId,
+            });
+            // A newer quote replaced this payment while the call was in flight.
+            if (!result.ok || this.state.payment?.cryptoOnchainPaymentId !== payment.cryptoOnchainPaymentId)
+                return null;
+            const status = {
+                status: result.status,
+                paymentId: result.paymentId,
+                orderId: result.orderId,
+                confirmations: result.confirmations,
+                requiredConfirmations: result.requiredConfirmations,
+                txHash: result.txHash,
+                explorerTxUrl: result.explorerTxUrl,
+                paid: result.paid,
+                expired: result.expired,
+                redirectUrl: result.redirectUrl,
+            };
+            this.setState({ paymentStatus: status });
+            if (status.paid && !this.paidNotified) {
+                this.paidNotified = true;
+                this.options.onPaid?.(status);
+            }
+            return status;
+        }
+        catch {
+            // The next tick retries; the payment still settles server side.
+            return null;
+        }
+    }
+    /** Polls again after `stop()`, while a payment is open (the customer came back to crypto). */
+    resume() {
+        if (!this.state.payment || CRYPTO_ONCHAIN_FINAL_PHASES.includes(this.getPhase()))
+            return;
+        this.stopped = false;
+        this.schedulePoll();
+    }
+    /** Stops polling (unmount, or the customer chose another payment method). */
+    stop() {
+        this.stopped = true;
+        if (this.pollTimer)
+            clearTimeout(this.pollTimer);
+        this.pollTimer = null;
+    }
+    schedulePoll() {
+        if (this.pollTimer)
+            clearTimeout(this.pollTimer);
+        this.pollTimer = setTimeout(async () => {
+            this.pollTimer = null;
+            await this.refreshStatus();
+            if (!this.stopped && !CRYPTO_ONCHAIN_FINAL_PHASES.includes(this.getPhase()))
+                this.schedulePoll();
+        }, this.options.pollIntervalMs ?? CRYPTO_ONCHAIN_STATUS_POLL_MS);
+    }
+    setState(patch) {
+        this.state = { ...this.state, ...patch };
+        this.options.onChange?.(this.state);
+        this.listeners.forEach((listener) => listener(this.state));
+    }
+}
+function messageOf(error) {
+    return error instanceof Error && error.message ? error.message : UNAVAILABLE;
+}
+//# sourceMappingURL=cryptoOnchain.js.map

package/dist/core/helpers/cryptoOnchain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cryptoOnchain.js","sourceRoot":"","sources":["../../../src/core/helpers/cryptoOnchain.ts"],"names":[],"mappings":"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"}

package/dist/core/helpers/oceanpayment.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Browser plumbing for Ocean Payment's inline card form (Oceanpayment
+ * Embedded SDK). Mirrors the hosted checkout's OceanPaymentPanel
+ * (apps/studio-app/.../PaymentMethodSelector/TakeoverPanels.tsx).
+ */
+export interface OceanpaymentGlobal {
+    init: (sandbox: boolean, cssUrl: string, language: string, configuration: Record<string, unknown>) => void;
+    checkout: (data: Record<string, string>) => void;
+}
+export type OceanWindow = Window & {
+    Oceanpayment?: OceanpaymentGlobal;
+    /** Ocean's SDK calls this global — the name is fixed by the SDK. */
+    oceanpaymentCallBack?: (data: unknown) => void;
+};
+export declare const OCEAN_SDK_URL = "https://secure.oceanpayment.com/pages/js/oceanpayment.js";
+/** Fixed by Ocean's SDK, which looks the container up by this id. */
+export declare const OCEAN_CONTAINER_ID = "oceanpayment-element";
+/** Ocean's iframe answers every checkout(); this only guards a lost message. */
+export declare const OCEAN_CALLBACK_TIMEOUT_MS = 120000;
+export declare function oceanLanguage(locale: string | undefined): string;
+/**
+ * Load Ocean's SDK once per page: a second copy would deliver every result
+ * twice. A failed or stalled load is forgotten, so the next mount retries.
+ */
+export declare function loadOceanSdk(): Promise<OceanpaymentGlobal>;
+export declare function parkOceanPayment(paymentId: string): void;
+/**
+ * Back from Ocean's 3-D Secure page: turn the parked payment into the
+ * `paymentAction` / `paymentActionStatus` / `paymentId` markers that
+ * `maybeResumeFromUrl()` and `usePayment()` already resume from.
+ */
+export declare function restoreOceanPaymentReturn(): void;
+//# sourceMappingURL=oceanpayment.d.ts.map

package/dist/core/helpers/oceanpayment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oceanpayment.d.ts","sourceRoot":"","sources":["../../../src/core/helpers/oceanpayment.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC3G,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;CAClD;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG;IACjC,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,oEAAoE;IACpE,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CAChD,CAAC;AAEF,eAAO,MAAM,aAAa,6DAA6D,CAAC;AACxF,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,yBAAyB,CAAC;AACzD,gFAAgF;AAChF,eAAO,MAAM,yBAAyB,SAAU,CAAC;AASjD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAIhE;AAKD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAwB1D;AAWD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAMxD;AAeD;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAchD"}