@tagadapay/headless-sdk 1.20.0 → 1.21.0

package/CHANGELOG.md

@@ -7,6 +7,62 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); the
 
 ## [Unreleased]
 
+## [1.21.0] — 2026-10-23
+
+### Added
+
+- Stores on the Payments API (V3) pay with the same calls. When `pay()` / `payDirect()` / `processApm()` answer
+  `{ paymentId, clientSecret, amount, currency }` with no `payment` (a payment the page confirms: local methods,
+  payDirect), `finalize()` and `processPayment()` confirm it with `@tagadapay/core-js/payments-v3`, run its next
+  action (3D Secure in a modal, a wallet step), call `complete` for the order and answer the usual
+  `ProcessPaymentResult` (`succeeded` with the order, `failed` with the decline message, `requires_redirect`,
+  or `pending` while the payment is still processing). A redirect returns with the usual `paymentAction` /
+  `paymentId` parameters; `maybeResumeFromUrl()`, `resumeAfterRedirect()` and `usePayment()` resume it.
+  Callers provide nothing new on Tagada-hosted pages: the publishable key comes from the injected step config
+  (`window.__TGD_STEP_CONFIG__.paymentsApi`). Needs `@tagadapay/core-js` 3.7.0 or later, loaded only on a V3
+  payment. Not in the CDN build yet: there the payment answers `failed` with a message saying so.
+- The publishable key follows the checkout session's mode, as in Studio: a draft session takes the test key, any
+  other the live key, never the other mode's. With no key for that mode the payment answers `failed` with a
+  message saying so. `CheckoutSession` gains the optional `draft` field (`loadSession()` reads it); a session the
+  page never loaded pays live.
+- Card, Apple Pay and Google Pay payments on a V3 store keep the V2-shaped answer and path. V2 stores are unchanged.
+
+### Changed
+
+- The optional peer `@tagadapay/core-js` is now `^3.7.0` (was `^3.0.0`). If you install core-js next to this
+  SDK, upgrade it with this release: `npm install @tagadapay/headless-sdk@1.21 @tagadapay/core-js@^3.7`. Bundlers
+  resolve the new `@tagadapay/core-js/payments-v3` import at build time, and core-js 3.6 and older do not have it.
+  core-js 3.7 is a minor release: nothing you use from 3.x changes. If you do not install core-js, nothing changes.
+
+## [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

package/README.md

@@ -115,6 +115,8 @@ The return type is a discriminated union:
 | `failed` | Payment declined or errored. `result.error` has details. |
 | `pending` | Still processing (rare — polling timed out). |
 
+**Stores on the Payments API (V3), from 1.21.0.** Same calls. Card and Apple Pay / Google Pay payments are answered as on V2. For a payment the page confirms (`processApm()`, `payDirect()`, `processPayment()` with no card), `pay()` answers `{ paymentId, clientSecret, amount, currency }`: pass it to `finalize()` (`processPayment()` does it), which confirms it with `@tagadapay/core-js/payments-v3` (install `@tagadapay/core-js` 3.7.0 or later) and answers the result above. It needs the page's publishable key, injected on Tagada-hosted pages (`window.__TGD_STEP_CONFIG__.paymentsApi`); the CDN build does not support it yet.
+
 ## Address Handling
 
 The SDK handles both **shipped** and **digital** products:

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

package/dist/core/helpers/oceanpayment.js

@@ -0,0 +1,111 @@
+/**
+ * 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 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 const OCEAN_CONTAINER_ID = 'oceanpayment-element';
+/** Ocean's iframe answers every checkout(); this only guards a lost message. */
+export const OCEAN_CALLBACK_TIMEOUT_MS = 120000;
+/**
+ * Ocean builds its card fields server-side from `?language=`. An unknown code
+ * falls back to English, and `fi` comes back in Polish, so Finnish shoppers
+ * get English.
+ */
+const OCEAN_LANGUAGE_OVERRIDES = { fi: 'en' };
+export function oceanLanguage(locale) {
+    const primary = locale?.split(/[-_]/)[0]?.toLowerCase();
+    if (!primary)
+        return 'en';
+    return OCEAN_LANGUAGE_OVERRIDES[primary] ?? primary;
+}
+const OCEAN_SDK_LOAD_TIMEOUT_MS = 30000;
+let oceanSdkLoading = null;
+/**
+ * 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 function loadOceanSdk() {
+    const w = window;
+    if (w.Oceanpayment)
+        return Promise.resolve(w.Oceanpayment);
+    if (oceanSdkLoading)
+        return oceanSdkLoading;
+    oceanSdkLoading = new Promise((resolve, reject) => {
+        const script = document.createElement('script');
+        const fail = (message) => {
+            clearTimeout(timer);
+            script.remove();
+            oceanSdkLoading = null;
+            reject(new Error(message));
+        };
+        const timer = setTimeout(() => fail('The Ocean Payment card form took too long to load'), OCEAN_SDK_LOAD_TIMEOUT_MS);
+        script.addEventListener('load', () => {
+            if (!w.Oceanpayment)
+                return fail('Ocean Payment script loaded without window.Oceanpayment');
+            clearTimeout(timer);
+            resolve(w.Oceanpayment);
+        });
+        script.addEventListener('error', () => fail('Failed to load the Ocean Payment card form'));
+        script.src = OCEAN_SDK_URL;
+        document.head.appendChild(script);
+    });
+    return oceanSdkLoading;
+}
+/**
+ * Ocean's inline card form leaves the page only for 3-D Secure, and Ocean
+ * returns the shopper to the exact page URL the form was opened on — without
+ * any payment reference in it. The payment id is parked in sessionStorage
+ * before leaving; a stale entry (abandoned 3DS) is ignored after 30 minutes.
+ */
+const OCEAN_PENDING_KEY = 'tgd:headless:oceanpayment:pending';
+const OCEAN_PENDING_TTL_MS = 30 * 60 * 1000;
+export function parkOceanPayment(paymentId) {
+    try {
+        sessionStorage.setItem(OCEAN_PENDING_KEY, JSON.stringify({ paymentId, at: Date.now() }));
+    }
+    catch {
+        // Storage unavailable — Ocean's webhook still settles the order.
+    }
+}
+function takeParkedOceanPayment() {
+    try {
+        const raw = sessionStorage.getItem(OCEAN_PENDING_KEY);
+        if (!raw)
+            return undefined;
+        sessionStorage.removeItem(OCEAN_PENDING_KEY);
+        const { paymentId, at } = JSON.parse(raw);
+        if (!paymentId || !at || Date.now() - at > OCEAN_PENDING_TTL_MS)
+            return undefined;
+        return paymentId;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * 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 function restoreOceanPaymentReturn() {
+    if (typeof window === 'undefined')
+        return;
+    const paymentId = takeParkedOceanPayment();
+    if (!paymentId)
+        return;
+    try {
+        const url = new URL(window.location.href);
+        if (url.searchParams.get('paymentId'))
+            return;
+        url.searchParams.set('paymentId', paymentId);
+        url.searchParams.set('paymentAction', 'requireAction');
+        url.searchParams.set('paymentActionStatus', 'completed');
+        window.history.replaceState(window.history.state, '', url.toString());
+    }
+    catch {
+        // Best-effort: Ocean's webhook still settles the order.
+    }
+}
+//# sourceMappingURL=oceanpayment.js.map

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

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