@visa/cli 4.1.0-rc.24 → 4.1.0-rc.3

package/dist/checkout-engine/detect.js

@@ -1,372 +0,0 @@
-// Layered field detection. This is the success-rate core of the spike: given a
-// live page, work out which element is the card number, which is the expiry,
-// the cvc, the cardholder name, and the contact/shipping fields, with a
-// confidence and a provenance for each. Higher layers (explicit autocomplete
-// attributes) beat lower ones (raw type inference). Every candidate is kept so
-// the evidence log can show WHY a field was chosen.
-//
-// Layers, highest confidence first:
-//   1.0 autocomplete attributes (cc-number, cc-exp, cc-csc, ...)
-//   0.7 attribute regex bank over name/id/placeholder/aria-label + <select> shape
-//   0.6 associated <label> text
-//   0.5 PSP iframe fingerprints (Stripe/Braintree/Adyen) -> detect + report
-//   0.4 type inference (numeric inputmode/pattern + maxlength)
-export const ALL_ROLES = [
-    'number',
-    'expMonth',
-    'expYear',
-    'expCombined',
-    'cvc',
-    'name',
-    'nameFirst',
-    'nameLast',
-    'email',
-    'addressLine1',
-    'addressLine2',
-    'city',
-    'state',
-    'postalCode',
-    'country',
-];
-// ---------------------------------------------------------------------------
-// Regex bank (layer 2 / 3)
-// ---------------------------------------------------------------------------
-const numberRe = /(card.?number|cardnumber|cardnum|card_num|ccnum|cc.?number|(^|[^a-z])pan([^a-z]|$)|kartennummer|numero.?(de.?)?(carte|tarjeta))/;
-const cvcRe = /(cvv|cvc|csc|cvn|security.?code|card.?code|card.?verif|pruef|prüf)/;
-const expMonthRe = /(exp.?month|expmonth|exp_mm|(^|[^a-z])mm([^a-z]|$)|(^|[^a-z])month([^a-z]|$)|monat|mois|(^|[^a-z])mes([^a-z]|$))/;
-const expYearRe = /(exp.?year|expyear|exp_yy|(^|[^a-z])yy(yy)?([^a-z]|$)|(^|[^a-z])year([^a-z]|$)|jahr|annee|(^|[^a-z])ano([^a-z]|$))/;
-const expCombinedRe = /(exp(iry|iration)?(.?date)?|mm.?\/.?yy|mm.?jj|valid.?thru|ablauf|caducidad)/;
-const emailRe = /(e-?mail|correo|courriel)/;
-const postalRe = /(zip|postal|postcode|(^|[^a-z])plz([^a-z]|$)|(^|[^a-z])cep([^a-z]|$)|codigo.?postal)/;
-const countryRe = /(country|(^|[^a-z])land([^a-z]|$)|(^|[^a-z])pais)/;
-const stateRe = /((^|[^a-z])state([^a-z]|$)|province|region|bundesland|provincia)/;
-const cityRe = /((^|[^a-z])city([^a-z]|$)|(^|[^a-z])town([^a-z]|$)|(^|[^a-z])ort([^a-z]|$)|ciudad|ville)/;
-const addr2Re = /(address.?2|addr.?2|line.?2|(^|[^a-z])apt|apartment|suite|(^|[^a-z])unit|zusatz)/;
-const addr1Re = /(address|street|(^|[^a-z])addr|strasse|stra.?e|adresse|direccion|(^|[^a-z])rue)/;
-const nameFirstRe = /(first.?name|(^|[^a-z])fname|given.?name|vorname|nombre|pr.?nom)/;
-const nameLastRe = /(last.?name|(^|[^a-z])lname|surname|family.?name|nachname|apellido)/;
-const nameRe = /(card.?holder|name.?on.?card|cardname|ccname|karteninhaber|titular|holder|(^|[^a-z])name([^a-z]|$)|(^|[^a-z])nom([^a-z]|$))/;
-const AUTOCOMPLETE_MAP = {
-    'cc-number': 'number',
-    'cc-exp': 'expCombined',
-    'cc-exp-month': 'expMonth',
-    'cc-exp-year': 'expYear',
-    'cc-csc': 'cvc',
-    'cc-name': 'name',
-    name: 'name',
-    email: 'email',
-    'given-name': 'nameFirst',
-    'family-name': 'nameLast',
-    'address-line1': 'addressLine1',
-    'address-line2': 'addressLine2',
-    'address-level2': 'city',
-    'address-level1': 'state',
-    'postal-code': 'postalCode',
-    country: 'country',
-    'country-name': 'country',
-};
-// Real PSP iframe fingerprints. A match on any of these hosts is a real,
-// cross-origin PSP surface: for M0 we DETECT and report it (requiresAdapter)
-// but do not attempt to fill it. Same-origin test iframes never match these.
-const PSP_FINGERPRINTS = [
-    { name: 'stripe', re: /js\.stripe\.com|m\.stripe\.network/ },
-    { name: 'braintree', re: /braintree(gateway|-api)?\.com|assets\.braintreegateway\.com/ },
-    { name: 'adyen', re: /checkoutshopper|adyen\.com/ },
-];
-function fingerprintPsp(src) {
-    for (const f of PSP_FINGERPRINTS)
-        if (f.re.test(src))
-            return f.name;
-    return null;
-}
-// ---------------------------------------------------------------------------
-// Classifier (pure — unit-testable without a browser)
-// ---------------------------------------------------------------------------
-function isMonthOptions(options) {
-    const vals = options.map((o) => o.value).filter((v) => v !== '');
-    const texts = options.map((o) => o.text.toLowerCase()).join(' ');
-    if (/jan|feb|mar|month/.test(texts) && vals.length >= 11)
-        return true;
-    if (vals.length >= 12 && vals.length <= 13) {
-        const nums = vals.filter((v) => /^\d{1,2}$/.test(v)).map((v) => Number(v));
-        if (nums.length >= 12 && nums.every((n) => n >= 1 && n <= 12))
-            return true;
-    }
-    return false;
-}
-function isYearOptions(options) {
-    const vals = options.map((o) => o.value).filter((v) => v !== '');
-    if (vals.length < 4 || vals.length > 30)
-        return false;
-    const four = vals.filter((v) => /^\d{4}$/.test(v)).map(Number);
-    if (four.length >= 4 && four.some((y) => y >= 2020 && y <= 2100))
-        return true;
-    const two = vals.filter((v) => /^\d{2}$/.test(v)).map(Number);
-    if (two.length === vals.length && two.some((n) => n > 12))
-        return true;
-    return false;
-}
-function looksLikeCountry(options) {
-    const texts = options.map((o) => o.text.toLowerCase()).join(' ');
-    if (/united states|canada|united kingdom|australia|germany/.test(texts))
-        return true;
-    const codes = options.map((o) => o.value).filter((v) => /^[A-Za-z]{2}$/.test(v));
-    return codes.length >= 5;
-}
-function attrClassify(text, m) {
-    if (m.tag === 'select') {
-        if (expMonthRe.test(text))
-            return 'expMonth';
-        if (expYearRe.test(text))
-            return 'expYear';
-        if (countryRe.test(text))
-            return 'country';
-        if (stateRe.test(text))
-            return 'state';
-        if (isMonthOptions(m.options))
-            return 'expMonth';
-        if (isYearOptions(m.options))
-            return 'expYear';
-        if (looksLikeCountry(m.options))
-            return 'country';
-        return null;
-    }
-    if (numberRe.test(text))
-        return 'number';
-    if (cvcRe.test(text))
-        return 'cvc';
-    // Expiry: a combined MM/YY field must not be mistaken for a month-only one.
-    // Explicit combined markers, or the presence of BOTH month and year tokens,
-    // win over a single-part match.
-    const explicitCombined = /(mm\s*[/\-]?\s*yy|mm.?jj|valid.?thru|ablauf|caducidad)/.test(text);
-    const hasMonth = expMonthRe.test(text);
-    const hasYear = expYearRe.test(text);
-    if (explicitCombined || (hasMonth && hasYear))
-        return 'expCombined';
-    if (hasMonth && !hasYear)
-        return 'expMonth';
-    if (hasYear && !hasMonth)
-        return 'expYear';
-    if (expCombinedRe.test(text))
-        return 'expCombined';
-    if (emailRe.test(text))
-        return 'email';
-    if (postalRe.test(text))
-        return 'postalCode';
-    if (countryRe.test(text))
-        return 'country';
-    if (stateRe.test(text))
-        return 'state';
-    if (cityRe.test(text))
-        return 'city';
-    if (addr2Re.test(text))
-        return 'addressLine2';
-    if (addr1Re.test(text))
-        return 'addressLine1';
-    if (nameFirstRe.test(text))
-        return 'nameFirst';
-    if (nameLastRe.test(text))
-        return 'nameLast';
-    if (nameRe.test(text))
-        return 'name';
-    return null;
-}
-function fromAutocomplete(ac) {
-    if (!ac)
-        return null;
-    for (const tok of ac.split(/\s+/)) {
-        const role = AUTOCOMPLETE_MAP[tok];
-        if (role)
-            return { role, confidence: 1.0, source: 'autocomplete' };
-    }
-    return null;
-}
-function typeInfer(m) {
-    if (m.tag !== 'input')
-        return null;
-    const ml = Number.parseInt(m.maxlength || '0', 10);
-    const numeric = m.inputmode === 'numeric' ||
-        /\\d|\[0-9\]/.test(m.pattern) ||
-        m.type === 'tel' ||
-        m.type === 'number';
-    if (!numeric)
-        return null;
-    if (ml >= 15 && ml <= 19)
-        return 'number';
-    if (ml >= 3 && ml <= 4)
-        return 'cvc';
-    return null;
-}
-// Returns every layer match for an element. Exported for unit tests.
-export function classifyCandidate(m) {
-    const ac = fromAutocomplete(m.autocomplete);
-    if (ac)
-        return [ac];
-    const out = [];
-    const text = [m.name, m.id, m.placeholder, m.ariaLabel].join(' ').toLowerCase();
-    const attrRole = attrClassify(text, m);
-    if (attrRole)
-        out.push({ role: attrRole, confidence: 0.7, source: 'attr-heuristic' });
-    const labelRole = attrClassify(m.labelText, m);
-    if (labelRole)
-        out.push({ role: labelRole, confidence: 0.6, source: 'label-text' });
-    const inf = typeInfer(m);
-    if (inf)
-        out.push({ role: inf, confidence: 0.4, source: 'type-inference' });
-    return out;
-}
-function bestMatch(matches) {
-    let best = null;
-    for (const mm of matches)
-        if (!best || mm.confidence > best.confidence)
-            best = mm;
-    return best;
-}
-// ---------------------------------------------------------------------------
-// DOM extraction (one evaluate pass per frame; stamps a stable data-ca-id)
-// ---------------------------------------------------------------------------
-async function extractCandidateMeta(root) {
-    return root.evaluate(() => {
-        const SKIP = new Set([
-            'hidden',
-            'submit',
-            'button',
-            'reset',
-            'checkbox',
-            'radio',
-            'image',
-            'file',
-        ]);
-        const els = Array.from(document.querySelectorAll('input, select, textarea'));
-        const out = [];
-        let i = 0;
-        for (const el of els) {
-            const tag = el.tagName.toLowerCase();
-            const type = (el.getAttribute('type') || '').toLowerCase();
-            if (tag === 'input' && SKIP.has(type))
-                continue;
-            const idx = i++;
-            el.setAttribute('data-ca-id', String(idx));
-            let labelText = '';
-            const anyEl = el;
-            if (anyEl.labels)
-                labelText += Array.from(anyEl.labels)
-                    .map((l) => l.textContent || '')
-                    .join(' ');
-            const alb = el.getAttribute('aria-labelledby');
-            if (alb) {
-                labelText +=
-                    ' ' +
-                        alb
-                            .split(/\s+/)
-                            .map((id) => {
-                            const n = document.getElementById(id);
-                            return n ? n.textContent || '' : '';
-                        })
-                            .join(' ');
-            }
-            const wrap = el.closest('label');
-            if (wrap)
-                labelText += ' ' + (wrap.textContent || '');
-            const style = getComputedStyle(el);
-            const visible = el.offsetParent !== null &&
-                style.visibility !== 'hidden' &&
-                style.display !== 'none';
-            const options = tag === 'select'
-                ? Array.from(el.options).map((o) => ({
-                    value: o.value,
-                    text: (o.textContent || '').trim(),
-                }))
-                : [];
-            out.push({
-                idx,
-                tag,
-                type,
-                name: el.getAttribute('name') || '',
-                id: el.id || '',
-                placeholder: el.getAttribute('placeholder') || '',
-                ariaLabel: el.getAttribute('aria-label') || '',
-                autocomplete: (el.getAttribute('autocomplete') || '').toLowerCase(),
-                maxlength: el.getAttribute('maxlength') || '',
-                inputmode: (el.getAttribute('inputmode') || '').toLowerCase(),
-                pattern: el.getAttribute('pattern') || '',
-                labelText: labelText.trim().toLowerCase(),
-                options,
-                visible,
-            });
-        }
-        return out;
-    });
-}
-function toCandidate(m, frame) {
-    const matches = classifyCandidate(m);
-    const best = bestMatch(matches);
-    return {
-        role: best?.role ?? null,
-        confidence: best?.confidence ?? 0,
-        source: best?.source ?? null,
-        matches,
-        frame,
-        meta: m,
-    };
-}
-function buildFieldMap(candidates) {
-    const map = {};
-    for (const c of candidates) {
-        if (!c.role || !c.source)
-            continue;
-        const existing = map[c.role];
-        const better = !existing ||
-            c.confidence > existing.confidence ||
-            (c.confidence === existing.confidence && c.meta.visible && !existing.visible);
-        if (!better)
-            continue;
-        map[c.role] = {
-            locator: `[data-ca-id="${c.meta.idx}"]`,
-            confidence: c.confidence,
-            // The true provenance is kept even for in-frame candidates — the frame
-            // is carried separately in `frame`. 'iframe-psp' means a PSP
-            // fingerprint match, never "this field happened to be in a frame".
-            source: c.source,
-            frame: c.frame,
-            tag: c.meta.tag,
-            inputType: c.meta.type,
-            visible: c.meta.visible,
-            options: c.meta.options.length ? c.meta.options : undefined,
-            maxlength: c.meta.maxlength ? Number.parseInt(c.meta.maxlength, 10) : undefined,
-        };
-    }
-    return map;
-}
-export async function detectFields(page) {
-    const candidates = [];
-    const psps = [];
-    const mainMeta = await extractCandidateMeta(page);
-    for (const m of mainMeta)
-        candidates.push(toCandidate(m, undefined));
-    const frameEls = await page.$$('iframe');
-    for (let k = 0; k < frameEls.length; k++) {
-        const el = frameEls[k];
-        const src = (await el.getAttribute('src')) || '';
-        const frameSelector = `iframe[data-ca-frame="${k}"]`;
-        await el.evaluate((node, idx) => node.setAttribute('data-ca-frame', String(idx)), k);
-        const psp = fingerprintPsp(src);
-        if (psp) {
-            // Real, cross-origin PSP surface: detect + report, do not fill in M0.
-            psps.push({ psp, requiresAdapter: psp, frameSelector });
-            continue;
-        }
-        const frame = await el.contentFrame();
-        if (!frame)
-            continue;
-        try {
-            const meta = await extractCandidateMeta(frame);
-            for (const m of meta)
-                candidates.push(toCandidate(m, frameSelector));
-        }
-        catch {
-            // Frame not accessible; skip.
-        }
-    }
-    return { fields: buildFieldMap(candidates), candidates, psps };
-}

package/dist/checkout-engine/evidence.d.ts

@@ -1,22 +0,0 @@
-export type EvidenceStepType = 'navigation' | 'dom-stable' | 'review' | 'approval' | 'adapter-selected' | 'reveal' | 'detect' | 'field-fill' | 'amount-fill' | 'credential-minted' | 'fill-complete' | 'psp-detected' | 'mandate-verdict' | 'submit' | 'challenge-hold' | 'outcome' | 'note';
-export type EvidenceStep = {
-    ts: string;
-    type: EvidenceStepType;
-    data: Record<string, unknown>;
-};
-export declare function maskPan(pan: string): string;
-export declare function maskCvc(_cvc: string): string;
-export declare function maskExpiry(): string;
-export declare function redactContact(role: string, value: string): string;
-export declare class EvidenceLog {
-    private steps;
-    private snapshotSummary;
-    step(type: EvidenceStepType, data?: Record<string, unknown>): void;
-    setSnapshotSummary(summary: string): void;
-    getSteps(): readonly EvidenceStep[];
-    toJSONL(): string;
-    toObject(): {
-        steps: EvidenceStep[];
-        snapshotSummary: string | null;
-    };
-}

package/dist/checkout-engine/evidence.js

@@ -1,59 +0,0 @@
-// Evidence log. A timestamped JSONL trail of everything the executor did:
-// navigation, adapter choice, each field fill (with confidence + source),
-// the mandate verdict, the submit, and the final outcome, plus a compact
-// accessibility snapshot of the end state.
-//
-// Money-adjacent hygiene rule: the full PAN, the cvc, and the card expiry
-// NEVER enter the log. PANs are masked to last-4; cvc and expiry are redacted
-// entirely. maskPan/maskCvc/maskExpiry are the only sanctioned way to put a
-// card value anywhere near a log line. Contact PII (cardholder name, email,
-// address, ...) is redacted via redactContact: the log records THAT a field
-// was filled, never the personal value.
-// Mask a PAN to its last four digits. Non-digits are stripped for the count.
-export function maskPan(pan) {
-    const digits = (pan || '').replace(/\D/g, '');
-    if (digits.length <= 4)
-        return '****';
-    return `**** **** **** ${digits.slice(-4)}`;
-}
-// The cvc is never displayed, even masked by length.
-export function maskCvc(_cvc) {
-    return 'redacted';
-}
-// The expiry is credential material too (one of the three keyable components
-// alongside the DPAN and the DAVV) — it never enters the log, in any format.
-export function maskExpiry() {
-    return 'redacted';
-}
-// Contact values (cardholder name, email, address, ...) are PII and never
-// enter the log raw either. Email keeps its domain for debuggability;
-// everything else becomes a bare presence marker.
-export function redactContact(role, value) {
-    if (!value)
-        return '';
-    if (role === 'email') {
-        const at = value.lastIndexOf('@');
-        return at > 0 ? `<redacted>@${value.slice(at + 1)}` : '<redacted>';
-    }
-    return '<redacted>';
-}
-export class EvidenceLog {
-    steps = [];
-    snapshotSummary = null;
-    step(type, data = {}) {
-        this.steps.push({ ts: new Date().toISOString(), type, data });
-    }
-    setSnapshotSummary(summary) {
-        this.snapshotSummary = summary;
-    }
-    getSteps() {
-        return this.steps;
-    }
-    // Newline-delimited JSON. One object per line.
-    toJSONL() {
-        return this.steps.map((s) => JSON.stringify(s)).join('\n');
-    }
-    toObject() {
-        return { steps: this.steps, snapshotSummary: this.snapshotSummary };
-    }
-}

package/dist/checkout-engine/executor.d.ts

@@ -1,172 +0,0 @@
-import type { Browser, BrowserContext, Page } from 'playwright-core';
-import { type FieldMap } from './detect.js';
-import { type Mandate } from './mandate.js';
-import type { Instrument } from './instrument.js';
-import type { Contact } from './types.js';
-import { EvidenceLog } from './evidence.js';
-import { type ObservedOutcome } from './outcome.js';
-export type CheckoutMode = 'dry-run' | 'submit';
-export type CheckoutOutcome = 'filled-dry-run' | 'partial-fill' | 'adapter-required' | 'confirmed' | 'declined' | 'action-required' | 'cancelled' | 'blocked-by-mandate' | 'failed';
-export type CredentialLifecycle = 'not-requested' | 'minted-not-exposed' | 'partially-exposed' | 'fully-filled';
-export type CredentialTiming = {
-    approvedAt?: string;
-    credentialMintedAt?: string;
-    credentialExpiresAt?: string;
-    fillCompletedAt?: string;
-};
-export type CheckoutResult = {
-    outcome: CheckoutOutcome;
-    fields: FieldMap;
-    evidence: EvidenceLog;
-    confirmationRef?: string;
-    requiresAdapter: string[];
-    credentialLifecycle: CredentialLifecycle;
-    credentialTiming: CredentialTiming;
-    detail?: string;
-};
-export type PrepareCheckoutOptions = {
-    url: string;
-    mandate: Mandate;
-    browser: Browser;
-    amountMinor?: number;
-    currency?: string;
-    debugShotsDir?: string;
-};
-export type RunCheckoutOptions = PrepareCheckoutOptions & {
-    instrument: Instrument;
-    contact: Contact;
-    mode: CheckoutMode;
-    outcomeDeadlineMs?: number;
-};
-export type CheckoutReview = {
-    id: string;
-    url: string;
-    merchantHost: string;
-    amountMinor: number;
-    currency: string;
-    mandateMaxAmountMinor: number;
-    mandateExpiresAt: string;
-    submitTarget: string | null;
-    submitTargetFingerprint: Readonly<CheckoutSubmitTargetFingerprint> | null;
-    detectedRoles: readonly string[];
-};
-export type CheckoutSubmitTargetFingerprint = {
-    kind: 'submit-control' | 'text-button';
-    label: string;
-    elementTag: string;
-    elementId: string | null;
-    elementName: string | null;
-    elementType: string | null;
-    formAction: string | null;
-    formMethod: string | null;
-    formTarget: string | null;
-};
-export type PreparedCheckout = {
-    readonly review: Readonly<CheckoutReview>;
-    readonly fields: Readonly<FieldMap>;
-    readonly evidence: EvidenceLog;
-    readonly requiresAdapter: readonly string[];
-};
-export type PrepareCheckoutResult = {
-    status: 'ready';
-    checkout: PreparedCheckout;
-} | {
-    status: 'finished';
-    result: CheckoutResult;
-};
-export type CheckoutApproval = {
-    approved: true;
-    reviewId: string;
-};
-export type SubmitApprovedCheckoutOptions = {
-    approval: CheckoutApproval;
-    instrument: Instrument;
-    contact: Contact;
-    mode: CheckoutMode;
-    outcomeDeadlineMs?: number;
-    challengeHoldMs?: number;
-    onChallengeHold?: (signal: string | null) => void;
-};
-export declare function minorFromDecimal(text: string): number | null;
-export declare function pageCurrency(text: string): string | null;
-export type PreparedCheckoutSession = {
-    checkout: PreparedCheckout;
-    context: BrowserContext;
-    page: Page;
-    options: PrepareCheckoutOptions;
-    evidence: EvidenceLog;
-    fields: FieldMap;
-    requiresAdapter: Set<string>;
-};
-export type PreparedCheckoutSessionStore = {
-    put: (reviewId: string, state: PreparedCheckoutSession) => void;
-    take: (reviewId: string) => PreparedCheckoutSession | undefined;
-    peek: (reviewId: string) => PreparedCheckoutSession | undefined;
-    pendingCleanupReviewIds: () => readonly string[];
-    reapExpired: (nowMs?: number) => Promise<number>;
-    dispose: () => Promise<void>;
-};
-export type InMemoryPreparedCheckoutStoreOptions = {
-    ttlMs?: number;
-    cleanupRetryMs?: number;
-    now?: () => number;
-};
-export declare const DEFAULT_PREPARED_CHECKOUT_TTL_MS: number;
-export declare const DEFAULT_PREPARED_CHECKOUT_CLEANUP_RETRY_MS = 5000;
-export declare class InMemoryPreparedCheckoutStore implements PreparedCheckoutSessionStore {
-    private readonly entries;
-    private readonly cleanupPending;
-    private readonly ttlMs;
-    private readonly cleanupRetryMs;
-    private readonly now;
-    private reaper;
-    constructor(options?: InMemoryPreparedCheckoutStoreOptions);
-    put(reviewId: string, state: PreparedCheckoutSession): void;
-    take(reviewId: string): PreparedCheckoutSession | undefined;
-    peek(reviewId: string): PreparedCheckoutSession | undefined;
-    pendingCleanupReviewIds(): readonly string[];
-    reapExpired(nowMs?: number): Promise<number>;
-    dispose(): Promise<void>;
-    private queueCleanup;
-    private scheduleReaper;
-    private closeState;
-}
-export declare function reconcileHeldOutcome(original: ObservedOutcome, held: ObservedOutcome): ObservedOutcome;
-export declare function debugShotMaskPlan(fields: FieldMap): {
-    skipReason: string | null;
-    maskLocators: string[];
-    maskFrames: {
-        frame: string;
-        locator: string;
-    }[];
-};
-export declare function isStripeLinkConsumerRequest(url: string): boolean;
-export declare function suppressStripeLink(page: Page, evidence: EvidenceLog): Promise<void>;
-export type LinkQuietResult = {
-    fired: boolean;
-    waitedMs: number;
-};
-/**
- * Wait for the suppressed Stripe Link lookup to fire and settle BEFORE the
- * submit click. Stripe debounces its consumer-session lookup ~300ms after the
- * email input changes; our fill→click gap is single-digit ms, so the (aborted)
- * lookup used to land INSIDE Stripe's in-flight submit chain and kill it
- * silently — the click looked accepted but tokenization never ran and the page
- * sat on the form until the outcome deadline (#5879: three identical live
- * stalls at donate.stripe.com). Verified live A/B on that page: instant click →
- * dead submit, no /v1/payment_methods; lookup settled first → tokenization and
- * the confirm step both reached.
- *
- * If the lookup already fired, only the short settle applies (lets Stripe's
- * abort handling unwind). If it never fires — non-Link page variants, no email
- * field — the bound expires and the click proceeds as before.
- */
-export declare function waitForLinkLookupQuiet(page: Page, opts?: {
-    boundMs?: number;
-    settleMs?: number;
-    delay?: (ms: number) => Promise<void>;
-}): Promise<LinkQuietResult>;
-export declare function prepareCheckout(opts: PrepareCheckoutOptions, store?: PreparedCheckoutSessionStore): Promise<PrepareCheckoutResult>;
-export declare function submitApprovedCheckout(reviewId: string, opts: SubmitApprovedCheckoutOptions, store?: PreparedCheckoutSessionStore): Promise<CheckoutResult>;
-export declare function cancelPreparedCheckout(reviewId: string, detail?: string, store?: PreparedCheckoutSessionStore): Promise<CheckoutResult>;
-export declare function runCheckout(opts: RunCheckoutOptions, store?: PreparedCheckoutSessionStore): Promise<CheckoutResult>;