@visa/cli 4.1.0-rc.298 → 4.1.0-rc.299

package/dist/checkout-engine/adapters/shopify.d.ts

@@ -1,98 +0,0 @@
-import type { Page } from 'playwright-core';
-import { type PageAmountRead } from '../amount.js';
-import { type DetectResult, type FieldMap } from '../detect.js';
-import type { CardCredential } from '../instrument.js';
-import type { Contact, FillResult, FilledField, PostalAddress } from '../types.js';
-import { type CheckoutAdapter } from './generic.js';
-type ShopifySummary = {
-    subtotalMinor: number | null;
-    shippingMinor: number | null;
-    taxMinor: number | null;
-    discountMinor: number;
-    totalMinor: number | null;
-    currency: string | null;
-    verified: boolean;
-    /**
-     * Component rows that never rendered and were counted as zero to reconcile
-     * the total (#8669). A summary that leans on an implied row is weaker than a
-     * fully rendered one: the row may simply not have been painted yet.
-     */
-    impliedZeroRows: Array<'tax' | 'shipping'>;
-};
-export declare function parseShopifySummary(text: string): ShopifySummary;
-export declare function readShopifyAmount(page: Page, requireVerified: boolean): Promise<PageAmountRead>;
-/** Consecutive identical reads (200 ms apart) an implied-zero summary must hold. */
-export declare const IMPLIED_ZERO_STABLE_READS = 8;
-export type StableShopifyAmountOptions = {
-    /**
-     * A merchant-authoritative total (minor units) the page must equal before an
-     * implied-zero summary is trusted: for a trusted UCP handoff this is the
-     * server-settled checkout total. Without it, the page must hold the same
-     * implied-zero summary for {@link IMPLIED_ZERO_STABLE_READS} reads.
-     */
-    expectedMinor?: number | null;
-};
-export declare function readStableShopifyAmount(page: Page, timeoutMs?: number, options?: StableShopifyAmountOptions): Promise<PageAmountRead>;
-export declare function isShopifyCheckoutPage(page: Page): Promise<boolean>;
-export type ShopifyCheckoutSurface = {
-    signal: string;
-    subtype: 'recognition' | 'authentication' | 'wallet';
-};
-export type ShopifyGuestCheckoutResult = {
-    status: 'guest-ready';
-    signal: 'guest-card-form';
-} | {
-    status: 'transitioned';
-    signal: string;
-} | {
-    status: 'action-required';
-    signal: string;
-    detail: string;
-};
-export declare function detectShopifyCheckoutSurface(page: Page): Promise<ShopifyCheckoutSurface | null>;
-/**
- * Resolve Shopify's reversible Shop-wallet takeover before review. The helper
- * only clicks an exact guest action or a scoped accessible close control inside
- * a positively identified Shop surface. It never solves authentication, uses a
- * Shop-saved payment method, force-clicks, or mutates the DOM.
- */
-export declare function ensureShopifyGuestCheckout(page: Page, options?: {
-    timeoutMs?: number;
-    stableMs?: number;
-}): Promise<ShopifyGuestCheckoutResult>;
-/** Read-only assertion for the irreversible credential boundary. */
-export declare function assertShopifyGuestCheckout(page: Page): Promise<ShopifyGuestCheckoutResult>;
-/**
- * The en-US variant of a localized Shopify checkout URL, or null when it is
- * already English (or not locale-suffixed). Shopify renders the checkout in
- * the URL's trailing locale segment, and amount reconciliation reads the
- * order summary by its ENGLISH labels — a store whose primary market is not
- * English serves /checkouts/cn/<token>/<locale> and the total never parses
- * (observed live 2026-08-16: /es-us rendered "Precio total" and the review
- * refused fail-closed on a good checkout). The locale segment is
- * presentation-only: swapping it keeps the same checkout session and token.
- */
-export declare function shopifyEnglishCheckoutUrl(current: string): string | null;
-export declare function requiredAddressRoles(address: PostalAddress, prefix?: string): string[];
-export declare function missingContactRoles(filled: FilledField[], expected: string[]): string[];
-/**
- * The contact surface to prefill. Shipping fields when the checkout has them —
- * but a digital-goods (no-shipping) Shopify checkout renders exactly one
- * address block and marks every field autocomplete="billing ..." (observed
- * live 2026-08-16: all 18 candidates billing-classified, so the shipping map
- * came back empty and the prefill reported every role missing). That billing
- * block IS the primary contact surface, under its base roles.
- */
-export declare function contactPrefillFieldMap(detected: DetectResult): {
-    fields: FieldMap;
-    surface: 'shipping' | 'billing-only';
-};
-export declare class ShopifyAdapter implements CheckoutAdapter {
-    private readonly detected;
-    name: string;
-    constructor(detected: DetectResult);
-    matches(detected: DetectResult): boolean;
-    prepareContact(page: Page, contact: Contact): Promise<FillResult>;
-    fill(page: Page, _fields: FieldMap, credential: CardCredential, _contact: Contact): Promise<FillResult>;
-}
-export {};