@movmo_app/payments 0.6.0 → 0.7.0

package/dist/index.d.ts

@@ -39,6 +39,8 @@ declare interface CardFieldValidity {
     cvv: boolean;
 }
 
+export declare type CardFormField = 'number' | 'expiry' | 'cvv' | 'zip' | 'name';
+
 export declare type CardFormStatus = 'idle' | 'loading' | 'ready' | 'tokenizing' | 'saving' | 'error';
 
 export declare interface CardholderTokenizeData {
@@ -52,6 +54,18 @@ export declare interface CardholderTokenizeData {
     zip?: string;
 }
 
+/**
+ * PII-free validation snapshot: field KEYS only, never values. Lets a parent
+ * (e.g. `PaymentMethodsManager`) turn touched-invalid streaks into a
+ * consumer-side friction signal without the SDK importing an analytics
+ * library or leaking anything the traveler typed.
+ */
+export declare interface CardValidationState {
+    valid: boolean;
+    missing: CardFormField[];
+    touchedInvalid: CardFormField[];
+}
+
 /**
  * Builds an auth-aware `fetch` that the payments package (or any other
  * consumer that registers it via `setPaymentsConfig({ fetch })`) can call.
@@ -154,7 +168,7 @@ export declare const getPaymentsConfig: () => InternalPaymentsConfig;
 /* Excluded from this release type: InternalPaymentsConfig */
 
 export declare const MovmoCardForm: {
-    ({ userId, onSuccess, onError, onErrorDetail, isDefault, className, defaultCardholderName, defaultCardholderFirstName, defaultCardholderLastName, autoSave, formId, hideInternalSaveButton, onCanSubmitChange, onSavingChange, autoFocus, }: MovmoCardFormProps): JSX_2.Element;
+    ({ userId, onSuccess, onError, onErrorDetail, isDefault, className, defaultCardholderName, defaultCardholderFirstName, defaultCardholderLastName, autoSave, formId, hideInternalSaveButton, onCanSubmitChange, onSavingChange, autoFocus, onValidationChange, }: MovmoCardFormProps): JSX_2.Element;
     displayName: string;
 };
 
@@ -221,6 +235,14 @@ export declare interface MovmoCardFormProps {
      * accounts-ui add-card modal so the user can start typing immediately.
      */
     autoFocus?: 'number' | 'cvv';
+    /**
+     * Fires whenever the validation snapshot changes (missing fields or
+     * touched-invalid fields). PII-free by design — carries field KEYS only,
+     * never values — so a parent can turn a touched-invalid streak into an
+     * analytics-neutral friction event without the SDK importing an analytics
+     * library.
+     */
+    onValidationChange?: (state: CardValidationState) => void;
 }
 
 /**
@@ -270,8 +292,15 @@ export declare interface PaymentManagerError {
  * - `edited`        — the cardholder/zip PUT succeeded.
  * - `deleted`       — the delete request succeeded.
  * - `set_default`   — the set-default PUT succeeded.
+ * - `validation_error` — a touched card-form field is invalid (fires once per
+ *                     invalid streak, not per keystroke). This is a friction
+ *                     signal, not a failure — it's the analytics-neutral
+ *                     counterpart to `onError`'s `card-tokenize` source, meant
+ *                     to surface which fields trip people up. Props are
+ *                     `field_count` and `fields` (touched-invalid field KEYS
+ *                     only, e.g. `'zip'` — never card values).
  */
-export declare type PaymentMethodEvent = 'autoselected' | 'selected' | 'added' | 'edited' | 'deleted' | 'set_default';
+export declare type PaymentMethodEvent = 'autoselected' | 'selected' | 'added' | 'edited' | 'deleted' | 'set_default' | 'validation_error';
 
 /**
  * Compact preview of a single saved card: brand icon + label. Used by
@@ -415,7 +444,7 @@ export declare interface PaymentMethodSummary {
     vault?: 'stripe' | 'spreedly';
     /** Current cardholder name (MOVMO-381). Empty/absent for legacy rows. */
     cardholderName?: string;
-    /** Current billing ZIP (MOVMO-381). Empty/absent for legacy rows. */
+    /** Current billing postal code (MOVMO-381). Empty/absent for legacy rows. */
     zip?: string;
 }