@wirexapp/card-sdk-core 1.1.0-beta.3 → 1.1.0

package/dist/protocol.d.ts

@@ -132,12 +132,14 @@ export interface PciAppearanceVariables {
     colorDivider?: string;
     /** Wallet review screen: emphasis colour of the total ("you pay") value. */
     colorEmphasis?: string;
-    /** Reveal frame: square size of the copy-button glyph (e.g. `24px`).
-     *  Default `20px`. */
+    /** Square size of the in-frame icon controls (e.g. `24px`): the reveal
+     *  frame's copy button and show/hide eye, and the collect CVV field's
+     *  show/hide eye. Default `20px`. */
     copyIconSize?: string;
-    /** Reveal frame: copy-button glyph colour. Defaults to `colorLabel`. */
+    /** Colour of the same controls (icon or text shape). Defaults to
+     *  `colorLabel`. */
     colorCopyIcon?: string;
-    /** Reveal frame: copy-button glyph colour on hover. Defaults to `colorText`. */
+    /** Their colour on hover. Defaults to `colorText`. */
     colorCopyIconHover?: string;
     /** Reveal frame: glyph colour of the transient "copied" checkmark.
      *  Defaults to `colorFocus`. */
@@ -195,12 +197,65 @@ export interface PciFrameAuth {
     userEmail?: string;
     userWallet?: string;
 }
-export interface PciCollectInitConfig {
+/**
+ * Optional diagnostics passthrough, shared by every init mode
+ * (docs/ERROR-TRACKING.md §5, §7). Additive within protocol v1: older frames
+ * ignore it, older hosts never send it.
+ */
+export interface PciDiagnosticsInit {
+    /** An OPAQUE, host-chosen id so Wirex can answer "user X could not top up
+     *  at 10:03" — the same id the host gives its own error tracker. Never an
+     *  email, phone number or wallet address: the frame validates
+     *  (`[A-Za-z0-9_\-:.]{1,128}`, no `@`, not digits only, not an EVM or
+     *  Bitcoin address) and DROPS a value that fails, without echoing it.
+     *  Sent as `user.id` and nothing
+     *  else; held in memory for the document's lifetime only. */
+    userId?: string;
+}
+/** The in-frame show/hide control of the collect CVV input — see
+ *  `PciCollectMaskInit.maskToggle`. The reveal's shapes minus `'row'`: a tap
+ *  on an input must focus it, so the field itself is never the control. */
+export type PciCollectMaskToggleMode = 'button' | 'text' | 'none';
+/** Why a `collect-masked-changed` happened: the init option (`'init'`), the
+ *  user's in-frame toggle (`'user'`), the host's `collect-set-masked`
+ *  (`'host'`) or the frame's own `maskAfter` timer (`'timeout'`). The same
+ *  reasons as the reveal's. */
+export type PciCollectMaskedReason = 'init' | 'user' | 'host' | 'timeout';
+/**
+ * Masking of the CVV INPUT while the user types — the three init options the
+ * collect frames share (the combined form applies them to its CVV control,
+ * the per-field frame only when it renders `cvv`; the card number is never
+ * masked). Mirrors the reveal's model: the state lives in the frame, the
+ * user's in-frame toggle and the host's `collect-set-masked` change it, and
+ * `collect-masked-changed` reports it. Differences, all by design: the
+ * masked rendering is the browser's own password bullet (the input flips
+ * between `type="password"` and `type="text"`), so there is no
+ * `maskedPlaceholder`; and there is no reveal gate — the value is what the
+ * user is typing, there is nothing to authorise. Every option is re-validated
+ * in the frame; an older frame ignores all three and keeps the CVV masked.
+ */
+export interface PciCollectMaskInit {
+    /** Start with the CVV masked. Default `true` — the behaviour before this
+     *  option existed. Only a literal `false` starts it shown. */
+    masked?: boolean;
+    /** The user's control inside the field, at its right edge. `'button'` — the
+     *  reveal's eye / eye-off icon, themed by the same `copyIcon*` tokens;
+     *  `'text'` — a text button from the `show` / `hide` strings, sized to the
+     *  wider word; `'none'` (default) — no control, the host drives the state
+     *  through `collect-set-masked` or not at all. */
+    maskToggle?: PciCollectMaskToggleMode;
+    /** Re-mask a SHOWN CVV after this many milliseconds, counted from the
+     *  moment typed digits are visible; masking it earlier cancels the timer.
+     *  `0` / absent = never. Reported with reason `'timeout'`. */
+    maskAfter?: number;
+}
+export interface PciCollectInitConfig extends PciCollectMaskInit {
     mode: 'collect';
     profile: PciCollectProfile;
     auth: PciFrameAuth;
     appearance?: PciAppearance;
     strings?: PciFrameStrings;
+    diagnostics?: PciDiagnosticsInit;
 }
 /**
  * Per-field (split) Collect frame — one iframe renders a single card field,
@@ -209,20 +264,45 @@ export interface PciCollectInitConfig {
  * tokenization over a same-origin BroadcastChannel — the value never reaches
  * the host page. Only the aggregator field (`number`) POSTs; the target URL is
  * the frame service's own `window.__WX_ENDPOINTS__`, not host-supplied. It
- * receives the fresh bearer with the `tokenize` message.
+ * receives the fresh bearer with the `tokenize` message. The masking options
+ * (`PciCollectMaskInit`) apply to the `cvv` field only; every other field
+ * ignores them.
  */
-export interface PciCollectFieldInitConfig {
+export interface PciCollectFieldInitConfig extends PciCollectMaskInit {
     mode: 'collect-field';
     field: PciCollectFieldName;
     /** Shared BroadcastChannel group id; siblings aggregate values under it. */
     groupId: string;
     appearance?: PciAppearance;
     strings?: PciFrameStrings;
+    diagnostics?: PciDiagnosticsInit;
 }
 /** A reveal row. Used to render one field per iframe (`fields`). */
 export type PciRevealField = 'cardholder' | 'number' | 'expiry' | 'cvv' | 'pin';
 /** How a reveal row's value gets copied — see `PciRevealInitConfig.copy`. */
-export type PciRevealCopyMode = 'button' | 'row' | 'none';
+export type PciRevealCopyMode = 'button' | 'text' | 'row' | 'none';
+/** Per-row copy modes — see `PciRevealInitConfig.copyByField`. */
+export type PciRevealCopyByField = Partial<Record<PciRevealField, PciRevealCopyMode>>;
+/** How a reveal row's masked state gets toggled by the USER — the in-frame
+ *  control, see `PciRevealInitConfig.maskToggle`. Same shapes as the copy
+ *  control: an icon button (eye / eye-off), a text button (`show` / `hide`
+ *  strings), the row itself, or nothing. */
+export type PciRevealMaskToggleMode = 'button' | 'text' | 'row' | 'none';
+/** Per-row mask-toggle modes — see `PciRevealInitConfig.maskToggleByField`. */
+export type PciRevealMaskToggleByField = Partial<Record<PciRevealField, PciRevealMaskToggleMode>>;
+/** A masked state PER ROW, as the host sends it: `true` masks the row,
+ *  `false` shows it, an absent row is left as it is. The cardholder row is
+ *  never masked (it is not sensitive): an entry for it is ignored. */
+export type PciRevealMaskedFields = Partial<Record<PciRevealField, boolean>>;
+/** The masked state of every RENDERED row, as the frame reports it. */
+export type PciRevealMaskedState = Partial<Record<PciRevealField, boolean>>;
+/** Why a `reveal-masked-changed` happened: the init option (`'init'`), the
+ *  user's in-frame toggle (`'user'`), the host's `reveal-set-masked`
+ *  (`'host'`) or the frame's own `maskAfter` timer (`'timeout'`). */
+export type PciRevealMaskedReason = 'init' | 'user' | 'host' | 'timeout';
+/** Who may REVEAL a masked row from the in-frame toggle — see
+ *  `PciRevealInitConfig.revealGate`. Hiding is never gated. */
+export type PciRevealGate = 'frame' | 'host';
 /** How a reveal row is drawn — see `PciRevealInitConfig.rowStyle`. */
 export type PciRevealRowStyle = 'plain' | 'boxed';
 /** How a reveal frame arranges its rows — see `PciRevealInitConfig.layout`. */
@@ -245,7 +325,9 @@ export interface PciRevealInitConfig {
     appearance?: PciAppearance;
     strings?: PciFrameStrings;
     /** Copy affordance per row. `'button'` (default) — the icon button beside
-     *  the value, as today; `'row'` — the whole row is the copy control (a real
+     *  the value, as today; `'text'` — a text button drawn from the `copy` /
+     *  `copied` strings (sized to the wider of the two, so the row never
+     *  shifts); `'row'` — the whole row is the copy control (a real
      *  `<button>`: click, Enter, Space), no icon and no reserved width, with the
      *  copied state shown on the value and announced to assistive tech;
      *  `'none'` — no copy affordance at all, the value stays selectable text.
@@ -283,6 +365,60 @@ export interface PciRevealInitConfig {
      *  (one field full-width above a row of others) is two frames. Enumerated
      *  and re-validated in the frame; older frames ignore it and stack. */
     layout?: PciRevealLayout;
+    /** Copy affordance per ROW, overriding `copy` for the named fields only —
+     *  e.g. `{ pin: 'none' }` keeps the icon button on every row but the PIN.
+     *  Each entry is validated in the frame against the same closed set as
+     *  `copy` (`'button' | 'row' | 'none'`); an entry that fails, or names an
+     *  unknown row, is dropped and that row follows `copy`. Older frames
+     *  ignore the whole map and render every row in the `copy` mode. */
+    copyByField?: PciRevealCopyByField;
+    /** Start with the values MASKED. `true` masks every sensitive row, a
+     *  `PciRevealMaskedFields` map masks the named rows only (default: nothing
+     *  masked, rendered as today). While masked the frame replaces the value
+     *  TEXT in its DOM — the card number shows the masked glyph for every
+     *  digit but the last four, the expiry `••/••`, CVV and PIN one glyph per
+     *  character; the cardholder row is never masked (it is not sensitive).
+     *  The values are still fetched at mount, under the same step-up, and the
+     *  copy control still copies the real value: masking is a shoulder-surfing
+     *  measure, not a second authorisation. The state lives in the frame, per
+     *  row; two things change it: the user's in-frame toggle (`maskToggle`)
+     *  and the host's `reveal-set-masked` (`PciRevealElement.setMasked`) — no
+     *  refetch, no new action token either way. The glyph is the
+     *  `maskedPlaceholder` string (default `•`). Re-validated in the frame
+     *  (only booleans count); an older frame ignores it and shows the values —
+     *  hosts that depend on masking must run against frames that carry it
+     *  (`reveal-masked-changed` confirms the applied state). */
+    masked?: boolean | PciRevealMaskedFields;
+    /** The in-frame show/hide control of every sensitive row (default
+     *  `'none'`: no control, the host drives masking through
+     *  `reveal-set-masked`). `'button'` — an eye / eye-off icon button beside
+     *  the value, before the copy button, themed by the same `copyIcon*`
+     *  tokens; `'text'` — a text button from the `show` / `hide` strings,
+     *  sized to the wider word; `'row'` — tapping the value toggles it (when
+     *  the row is ALSO the copy control — `copy: 'row'` — copying wins and the
+     *  toggle for that row renders as `'none'`). Enumerated and re-validated
+     *  in the frame; older frames ignore it. */
+    maskToggle?: PciRevealMaskToggleMode;
+    /** `maskToggle` per ROW, overriding it for the named rows only, validated
+     *  entry by entry like `copyByField`. */
+    maskToggleByField?: PciRevealMaskToggleByField;
+    /** Re-mask a SHOWN row after this many milliseconds, counted from the
+     *  moment its value is visible (at load, after a toggle, after a host
+     *  `reveal-set-masked`); masking it earlier cancels the timer. A number
+     *  applies to every sensitive row, a map names rows; `0` / absent = never
+     *  (the default — a display timeout is the operator's policy, see
+     *  PCI SSC FAQ 1071). The frame reports the re-mask with reason
+     *  `'timeout'`. Hosts with their own policy need none of this: they re-mask
+     *  through `reveal-set-masked`. Validated in the frame (finite, ≥ 0). */
+    maskAfter?: number | Partial<Record<PciRevealField, number>>;
+    /** Who may reveal a masked row from the in-frame toggle. `'frame'`
+     *  (default): the toggle shows the value in place. `'host'`: the toggle
+     *  leaves the row masked and the frame posts `reveal-requested` with the
+     *  field name — the host decides (its own step-up, biometrics, …) and
+     *  reveals with `reveal-set-masked`. Hiding is never gated. Mirrors the
+     *  mobile SDK's controlled `masked` + `revealRequested`. */
+    revealGate?: PciRevealGate;
+    diagnostics?: PciDiagnosticsInit;
 }
 /** Availability probe — no transaction context, no backend calls. The `init`
  *  request's result carries `PciWalletAvailability`. */
@@ -293,11 +429,61 @@ export interface PciWalletProbeInitConfig {
      *  values (auth methods, networks) are used verbatim so the availability
      *  answer reflects the real tokenization path instead of built-in defaults. */
     config?: PciWalletProviderConfig;
+    diagnostics?: PciDiagnosticsInit;
 }
 export interface PciWalletAvailability {
     applePay: boolean;
     googlePay: boolean;
-}
+    /** Google Pay cannot tokenize HERE (no cryptogram cards — desktop, iOS), but
+     *  this context can show the desktop QR handoff: the user scans a code with
+     *  an Android phone, which opens the same checkout top-level and pays there
+     *  (token mode only — see `PciWalletCheckoutAuth`). Absent on frames that
+     *  predate WPAY-4431. */
+    googlePayHandoff?: boolean;
+    /** One summary of Google Pay for this context; the states are mutually
+     *  exclusive. `googlePay` stays the "can pay HERE" boolean, so a host that
+     *  ignores this field behaves exactly as before. Absent on frames that
+     *  predate it (`checkWalletAvailability` derives it from the booleans).
+     *  - `ready`: tokenizes here (= `googlePay: true`)
+     *  - `handoff`: no native Google Pay here; the desktop QR can finish it
+     *    (token mode only, exactly like `googlePayHandoff`)
+     *  - `needs_card`: Android, Google Pay works, but no card in Google Wallet
+     *    on this phone is one the top-up accepts (CRYPTOGRAM_3DS). A host may
+     *    keep the row and send the user to Google Wallet instead of checkout.
+     *    Never reported when the provider block passed to the probe omits
+     *    `google_pay` (the provider does not offer it)
+     *  - `unavailable`: hide the row */
+    googlePayState?: PciGooglePayState;
+}
+export type PciGooglePayState = 'ready' | 'handoff' | 'needs_card' | 'unavailable';
+/** Google Pay with no transaction (WPAY-4115) — for the probe's `needs_card`:
+ *  Google's own sheet with no price (`totalPriceStatus: NOT_CURRENTLY_KNOWN`),
+ *  so a user whose Google Wallet holds no usable card sees what Google Pay
+ *  offers here. No quote, no Wirex backend call: whatever the sheet returns is
+ *  dropped in the frame, and only the outcome reaches the host
+ *  (`wallet-preview-closed`). The `init` result is empty; it fails when the
+ *  block has no `google_pay` or Google Pay JS cannot load. Hosted by native
+ *  WebView shells (Android). */
+export interface PciWalletPreviewInitConfig {
+    mode: 'wallet-preview';
+    /** The DEFAULT provider block, pre-quote; its `google_pay` values are used
+     *  verbatim, exactly as the checkout would use them. */
+    config?: PciWalletProviderConfig;
+    /** ISO 4217 — Google wants one even with no price. Default `EUR`. */
+    currency?: string;
+    /** Open the sheet straight away instead of waiting for a tap on the frame's
+     *  Google Pay button. Android WebView allows it; where the platform wants a
+     *  user gesture the button stays (`wallet-preview-auto` says which). */
+    autoOpen?: boolean;
+    /** The button preset (see `PciWalletButtonAppearance`). Default white, plain. */
+    buttons?: Pick<PciWalletButtonAppearance, 'googlePay'>;
+}
+/** How a preview sheet closed: `continued` — the user pressed the sheet's
+ *  action (nothing is charged; the result is dropped); `cancelled` — the user
+ *  dismissed it; `failed` — it never opened. `statusCode` says why: Google's
+ *  status code, or for a launch the platform refused the DOMException name
+ *  (`NotAllowedError` …), which pay.js would otherwise report as `CANCELED`. */
+export type PciWalletPreviewOutcome = 'continued' | 'cancelled' | 'failed';
 /**
  * Wallet-button presentation presets. Both wallets brand-control their buttons,
  * so only their allowed presets are exposed — validated in-frame like every
@@ -418,6 +604,73 @@ export interface PciWalletBrandingConfig {
      *  privacy policy. */
     privacyUrl?: string;
 }
+/**
+ * TOKEN MODE (WPAY-4431) — the frame EXECUTES the top-up itself instead of
+ * handing the wallet payment token back to the host. The host passes a
+ * short-lived top-up token minted by the backend (`POST
+ * /api/v1/cards/topup/token`: a user token restricted to the estimate/execute
+ * paths); after the sheet authorizes, the frame calls
+ * `POST /api/v1/cards/topup/execute` with it and reports `wallet-executed` /
+ * `wallet-execute-failed`. The encrypted wallet payment token never leaves the
+ * frame. Without `auth` the frame keeps the legacy tokenize-and-return
+ * behaviour (`wallet-token`) unchanged.
+ *
+ * Why: partner Android apps cannot run Google Pay in a WebView (Google
+ * validates the hosting app's package against the merchant profile), so the
+ * checkout must run TOP-LEVEL (Chrome Custom Tabs, our desktop QR) where no
+ * host channel exists to hand a token back to — the page has to finish the
+ * top-up on its own. The token rides postMessage for hosted documents and
+ * the URL FRAGMENT for top-level launches (never a query string; stripped
+ * from the address bar on load).
+ */
+export interface PciWalletCheckoutAuth {
+    /** The backend's short-lived top-up token (`token` of the
+     *  `/cards/topup/token` response). Opaque to the SDK — sent as the
+     *  `Authorization: Bearer` of the execute call and nothing else. Never log
+     *  it; never pass a full user session token in production. */
+    checkoutToken: string;
+    /** Mirrors of the host's own `X-User-Email` / `X-User-Wallet` request
+     *  headers — only for backends that still resolve the caller from them;
+     *  the token itself identifies the user. Optional, never logged. */
+    userEmail?: string;
+    userWallet?: string;
+}
+/** Where Google Pay goes on a device that cannot tokenize natively (desktop):
+ *  `qr` (default in token mode) shows a code the user scans with an Android
+ *  phone. The code carries the checkout itself — the top-up token, the quote
+ *  and the estimate's `provider` name (`buildWalletLaunchFragment`); the phone
+ *  opens this checkout top-level, resolves the provider block from the public
+ *  BaaS config, pays natively and executes. Nothing is stored anywhere and
+ *  this document never learns the outcome: the host reconciles by its own
+ *  status reads after `wallet-state: handoff-pending`. Requires `provider`
+ *  in the init. `none` hides Google Pay on such devices, as before WPAY-4431. */
+export type PciWalletGooglePayHandoff = 'qr' | 'none';
+/** Token mode: the execute call succeeded — the top-up exists. `status` is
+ *  the execute response's status (`Completed` | `Pending` | `Failed` | …):
+ *  treat it exactly like the card top-up flow's; the status feed owns the
+ *  final truth. */
+export interface PciWalletExecuteResult {
+    /** The top-up transaction id. */
+    id: string;
+    status: string;
+    method: 'apple_pay' | 'google_pay';
+    cardNetwork?: string;
+    panLast4?: string;
+    displayName?: string;
+}
+/** Token mode: the execute call did not succeed. `reason` is a stable slug
+ *  for messaging/analytics: `execute_rejected` (4xx — token rejected,
+ *  validation), `already_executed` (409 — a second execute on the same
+ *  estimation; reconcile by status), `estimation_expired` (422),
+ *  `execute_unauthorized` (401/403 — token expired or wrong scope),
+ *  `execute_failed` (5xx), `network_error`. */
+export interface PciWalletExecuteError {
+    reason: string;
+    /** HTTP status of the execute response, when there was one. */
+    status?: number;
+    /** Sanitized backend message — diagnostics and toasts, never the token. */
+    message?: string;
+}
 export interface PciWalletCheckoutInitConfig {
     mode: 'wallet-checkout';
     /** `full` (default) renders the review card (top-up / fee / total).
@@ -442,22 +695,54 @@ export interface PciWalletCheckoutInitConfig {
     buttons?: PciWalletButtonAppearance;
     branding?: PciWalletBrandingConfig;
     strings?: PciFrameStrings;
+    /** TOKEN MODE — see {@link PciWalletCheckoutAuth}. Present: the frame
+     *  executes the top-up itself and reports `wallet-executed` /
+     *  `wallet-execute-failed`; `wallet-token` is never sent. Absent: legacy
+     *  tokenize-and-return. */
+    auth?: PciWalletCheckoutAuth;
+    /** Token mode only — see {@link PciWalletGooglePayHandoff}. Default `qr`. */
+    googlePayHandoff?: PciWalletGooglePayHandoff;
+    /** The estimate's `provider` name — required for the desktop Google Pay QR
+     *  (the phone resolves the provider block by name); harmless otherwise. */
+    provider?: string;
+    /** STANDALONE launches only (a partner app opening this document
+     *  top-level in Chrome Custom Tabs with `#init=` or the launch fragment):
+     *  the link the result screen offers as "Return to the app" — an `https`
+     *  App Link / Universal Link (OS-verified for the partner's package,
+     *  preferred) or the app's own scheme (`com.partner.app:/wallet/return`;
+     *  any installed app may claim a scheme) — with `estimation_id` and
+     *  `outcome` (`completed` | `pending` | `failed` | `already_executed`)
+     *  appended as query parameters — never the token, never the wallet
+     *  payload. Validated in-frame after URL parsing: the schemes a browser
+     *  would execute in the frame's origin (`javascript:`, `data:`, `blob:`,
+     *  …), browser-internal ones and `http:` are ignored
+     *  (`resolveWalletReturnUrl`); hosted documents (iframe, popup, native
+     *  WebView) ignore it entirely. The app reconciles by estimation status —
+     *  the link is a UX signal only. */
+    returnUrl?: string;
     /** DEV ONLY: arm the frame's `wallet-debug` channel — in-frame JS errors,
      *  unhandled rejections and console output stream to the host as
      *  `wallet-debug` events (native WebViews have no reachable console).
      *  Wallet frames only — the PCI collect/reveal frames never forward
      *  console output (cardholder data risk). Never enable in production. */
     debug?: boolean;
-}
-export type PciWalletCheckoutState = 'loading' | 'ready' | 'sheet-open';
+    diagnostics?: PciDiagnosticsInit;
+}
+/** Wallet checkout lifecycle. `sheet-open` = the OS wallet sheet is up;
+ *  token mode adds `executing` (the frame is calling execute) and
+ *  `handoff-pending` (the desktop QR is on screen — the phone pays and
+ *  executes; this frame never learns the outcome, the host reconciles by its
+ *  own status reads). */
+export type PciWalletCheckoutState = 'loading' | 'ready' | 'sheet-open' | 'executing' | 'handoff-pending';
 /**
  * One authorized payment sheet's output. `walletPaymentToken` is the sheet's
- * payment token serialized for the wire — Apple: the whole PKPaymentToken JSON
- * (encrypted `paymentData` verbatim + `paymentMethod` + `transactionIdentifier`,
- * i.e. the PSP's `mobileToken` shape); Google: `tokenizationData.token` as
- * issued — relay it VERBATIM as the execute call's `wallet_payment_token`
- * (never parse, reshape or log it; max 16384 chars server-side). The rest is
- * non-sensitive display
+ * payment token serialized for the wire, in the PSP's `mobileToken` shape —
+ * Apple: the whole PKPaymentToken JSON (encrypted `paymentData` verbatim +
+ * `paymentMethod` + `transactionIdentifier`); Google: the whole
+ * `paymentMethodData` JSON (`type` + `description` + `info` +
+ * `tokenizationData`, the gateway-encrypted token inside). Relay it VERBATIM
+ * as the execute call's `wallet_payment_token` (never parse, reshape or log
+ * it; max 16384 chars server-side). The rest is non-sensitive display
  * metadata. The sheet has already closed successfully when this arrives —
  * sheet success means "tokenized", not "money moved"; the execute response
  * and the status feed own the top-up outcome, and `three_ds_state` is never
@@ -489,7 +774,7 @@ export interface PciWalletPaymentTokenDto {
     /** Apple's `transactionIdentifier` — absent on Google Pay (no analogue). */
     walletTransactionId?: string;
 }
-export type PciInitConfig = PciCollectInitConfig | PciCollectFieldInitConfig | PciRevealInitConfig | PciWalletProbeInitConfig | PciWalletCheckoutInitConfig;
+export type PciInitConfig = PciCollectInitConfig | PciCollectFieldInitConfig | PciRevealInitConfig | PciWalletProbeInitConfig | PciWalletPreviewInitConfig | PciWalletCheckoutInitConfig;
 /** Extra non-sensitive data merged into the tokenize call by the frame. */
 export interface PciTokenizeTopUpRequest {
     kind: 'topup';
@@ -535,9 +820,24 @@ export interface PciTokenizeOctResult {
     bin: string;
     last4: string;
 }
+/**
+ * How a failed collect request is classified: the mobile SDK's codes. A FROZEN set of six, safe to
+ * switch over exhaustively.
+ */
+export type PciFrameErrorCode = 'unauthorized' | 'actionRequired' | 'updateRequired' | 'invalidInput' | 'temporary' | 'failed';
 export interface PciFrameError {
     message: string;
     status?: number;
+    /** Absent from a frame that predates the classification. */
+    code?: PciFrameErrorCode;
+    retryable?: boolean;
+    /**
+     * Why, when `code` alone cannot say. `invalidInput` covers both `cardAlreadyLinked` (enter another
+     * card) and `cardLimitReached` (remove one first).
+     *
+     * GROWABLE. Always handle the unknown case.
+     */
+    reason?: string;
 }
 interface Envelope {
     v: typeof PCI_PROTOCOL_VERSION;
@@ -552,6 +852,28 @@ export type PciHostToFrameMessage = Envelope & ({
     requestId: string;
     payload: PciTokenizeRequest;
 }
+/** Reveal: mask or show the values in place (see
+ *  `PciRevealInitConfig.masked`). An EVENT, not a request — no
+ *  `requestId`, no reply, no timeout: the frame answers with
+ *  `reveal-masked-changed` when the state actually changed. Sent only
+ *  after init (the bridge drops anything earlier); older frames ignore it. */
+ | {
+    type: 'reveal-set-masked';
+    masked: boolean | PciRevealMaskedFields;
+}
+/** Collect: mask or show the CVV input in place (see
+ *  `PciCollectMaskInit`). The collect twin of `reveal-set-masked` — an
+ *  EVENT with no `requestId` and no reply; the frame answers with
+ *  `collect-masked-changed` when the state actually changed. A frame
+ *  without a CVV control (the OCT profile, a non-CVV field) and an older
+ *  frame both ignore it. Its own type rather than a shared `set-masked`:
+ *  the deployed reveal frames already answer to `reveal-set-masked`,
+ *  each frame document handles only its own event, and the payloads
+ *  differ (a boolean here, a boolean or a per-row map there). */
+ | {
+    type: 'collect-set-masked';
+    masked: boolean;
+}
 /** Re-arm a mounted wallet checkout frame with a fresh quote (typically
  *  after expiry) — re-renders in place, no remount. `config` rides along
  *  because the fresh estimate's `provider` may differ from the last one. */
@@ -560,12 +882,27 @@ export type PciHostToFrameMessage = Envelope & ({
     requestId: string;
     quote: PciWalletQuote;
     config: PciWalletProviderConfig;
+    /** Token mode: a fresh top-up token for the fresh quote (the old one
+     *  may have expired with it). Omitted = keep the mounted token. */
+    auth?: PciWalletCheckoutAuth;
+    /** The fresh estimate's `provider` (the desktop QR needs it). */
+    provider?: string;
 });
 export type PciFrameToHostMessage = Envelope & ({
     type: 'ready';
 } | {
     type: 'change';
     state: PciCollectChangeState;
+}
+/** The collect CVV input's masked state as applied: once at init (an
+ *  older frame never sends it — that is how a host tells) and after every
+ *  change, whoever made it (`reason`). Sent only by a frame that renders
+ *  a CVV control. A boolean and a reason — never the value, its length
+ *  or anything derived from it. */
+ | {
+    type: 'collect-masked-changed';
+    masked: boolean;
+    reason: PciCollectMaskedReason;
 } | {
     type: 'resize';
     height: number;
@@ -581,6 +918,27 @@ export type PciFrameToHostMessage = Envelope & ({
     type: 'reveal-copied';
     field: PciRevealField;
 }
+/** The reveal frame's masked state as applied — the state of every
+ *  rendered MASKABLE row (number, expiry, cvv, pin; the cardholder row is
+ *  never masked and is not listed, so "every value true" means all
+ *  hidden): once at init (confirming the `masked` option was honoured)
+ *  and after every change, whoever made it (`reason`). `field`
+ *  names the one row the user toggled or the timer re-masked; a host
+ *  `reveal-set-masked` and the init report carry no `field`. Metadata
+ *  only: field names, booleans, a reason. */
+ | {
+    type: 'reveal-masked-changed';
+    masked: PciRevealMaskedState;
+    field?: PciRevealField;
+    reason: PciRevealMaskedReason;
+}
+/** `revealGate: 'host'` only: the user asked to reveal a masked row with
+ *  the in-frame toggle. The row stays masked until the host answers with
+ *  `reveal-set-masked`. Field name only. */
+ | {
+    type: 'reveal-requested';
+    field: PciRevealField;
+}
 /** Wallet checkout lifecycle. `sheet-open` = the OS wallet sheet is up. */
  | {
     type: 'wallet-state';
@@ -614,6 +972,32 @@ export type PciFrameToHostMessage = Envelope & ({
  | {
     type: 'wallet-token';
     token: PciWalletPaymentTokenDto;
+}
+/** TOKEN MODE: the frame executed the top-up itself — the host shows the
+ *  outcome (and reconciles by status). Never sent alongside `wallet-token`. */
+ | {
+    type: 'wallet-executed';
+    result: PciWalletExecuteResult;
+}
+/** TOKEN MODE: the execute call failed — see `PciWalletExecuteError`. The
+ *  frame keeps its buttons disabled until a `wallet-update` re-arms it. */
+ | {
+    type: 'wallet-execute-failed';
+    error: PciWalletExecuteError;
+}
+/** PREVIEW: the sheet closed. `trigger` — opened by `autoOpen` or by a tap. */
+ | {
+    type: 'wallet-preview-closed';
+    outcome: PciWalletPreviewOutcome;
+    trigger: 'auto' | 'button';
+    statusCode?: string;
+}
+/** PREVIEW, with `autoOpen`: whether the sheet opened without a tap, sent
+ *  once the attempt settles. `false` leaves the frame's Google Pay button
+ *  as the way in. */
+ | {
+    type: 'wallet-preview-auto';
+    opened: boolean;
 } | {
     type: 'result';
     requestId: string;

package/dist/protocol.d.ts.map

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

package/dist/walletLaunch.d.ts

@@ -0,0 +1,44 @@
+import type { PciWalletQuote } from './protocol.js';
+/**
+ * DIRECT standalone launch (WPAY-4431, store-less variant): everything the
+ * checkout needs rides the URL fragment of `wallet-checkout.html` — the
+ * top-up token, the quote, the provider NAME and an optional return link.
+ * No session on the frames service: the page resolves the provider block
+ * itself from the public BaaS config (`GET /api/v1/config` →
+ * `topup.providers[name]`), so a QR or a Custom Tab URL stays short. The
+ * token dominates the length; a shorter backend token shrinks the code.
+ *
+ * The fragment never reaches a server, but a browser keeps the URL it opened
+ * in its history — use this form only with a token that is bound to the
+ * estimation and single-use, or in a dev build.
+ */
+export interface PciWalletLaunchParams {
+    checkoutToken: string;
+    quote: PciWalletQuote;
+    /** The estimate's `provider` — selects the block in the public config. */
+    provider: string;
+    /** The link the result screen offers as "Return to the app": an `https`
+     *  App Link / Universal Link (preferred) or the app's own scheme — see
+     *  {@link resolveWalletReturnUrl} for what is refused. */
+    returnUrl?: string;
+}
+/** Fragment keys (single letters: the fragment is QR payload). */
+export declare const PCI_WALLET_LAUNCH_KEYS: {
+    readonly token: "t";
+    readonly estimationId: "e";
+    readonly sourceAmount: "s";
+    readonly destinationAmount: "d";
+    readonly fee: "f";
+    readonly expiresAt: "x";
+    readonly provider: "p";
+    readonly returnUrl: "r";
+};
+/** `t=<token>&e=<estimationId>&s=<amount>:<CUR>[&d=…][&f=…][&x=<unix seconds>]&p=<provider>[&r=<return link>]`
+ *  (no leading `#`). Throws a `TypeError` for a `returnUrl` the frame would
+ *  refuse (the frame ignores such a link silently — fail here, at build
+ *  time, instead). The raw value is encoded, never a normalised form, so the
+ *  fragment stays byte-identical across the SDKs. */
+export declare const buildWalletLaunchFragment: (params: PciWalletLaunchParams) => string;
+/** The full URL to open top-level (Custom Tab) or to encode in a QR. */
+export declare const buildWalletLaunchUrl: (frameOrigin: string, params: PciWalletLaunchParams, client?: string) => string;
+//# sourceMappingURL=walletLaunch.d.ts.map