@movmo_app/payments 0.5.0 → 0.6.0

package/dist/index.d.ts

@@ -256,6 +256,23 @@ export declare interface PaymentManagerError {
     cause?: unknown;
 }
 
+/**
+ * Payment-domain action reported by `PaymentMethodsManager`'s `onEvent`
+ * callback (MOVMO-479). Success-only — failures are covered by `onError`
+ * above. The package is analytics-agnostic: it never imports an analytics
+ * SDK, it just emits these action strings (plus PII-free props) for a
+ * consumer to map onto its own telemetry catalog.
+ *
+ * - `autoselected` — the manager auto-selected the default card on first load.
+ * - `selected`     — a genuine user row click (NOT the internal reselection
+ *                     fired after `added`/`deleted`).
+ * - `added`         — a new card was saved.
+ * - `edited`        — the cardholder/zip PUT succeeded.
+ * - `deleted`       — the delete request succeeded.
+ * - `set_default`   — the set-default PUT succeeded.
+ */
+export declare type PaymentMethodEvent = 'autoselected' | 'selected' | 'added' | 'edited' | 'deleted' | 'set_default';
+
 /**
  * Compact preview of a single saved card: brand icon + label. Used by
  * consumers (e.g. flights-ui's collapsed checkout drawer) to show the
@@ -288,7 +305,7 @@ export declare interface PaymentMethodPreviewProps {
 }
 
 export declare const PaymentMethodsManager: {
-    ({ userId, defaultCardholderName, defaultCardholderFirstName, defaultCardholderLastName, selectedId, onSelect, onChange, onError, paymentTypeSelector, autoSaveFirstCard, selectionSetsDefault, showDefaultBadge, collapsible, cardLabelFormat, className, }: PaymentMethodsManagerProps): JSX_2.Element;
+    ({ userId, defaultCardholderName, defaultCardholderFirstName, defaultCardholderLastName, selectedId, onSelect, onChange, onError, onEvent, paymentTypeSelector, autoSaveFirstCard, selectionSetsDefault, showDefaultBadge, collapsible, cardLabelFormat, className, }: PaymentMethodsManagerProps): JSX_2.Element;
     displayName: string;
 };
 
@@ -319,6 +336,20 @@ export declare interface PaymentMethodsManagerProps {
      * gates. Additive and non-intrusive — errors are still rendered in-SDK.
      */
     onError?: (error: PaymentManagerError) => void;
+    /**
+     * Analytics-agnostic observability hook (MOVMO-479). Fires for successful
+     * payment-domain actions only — `onError` above already covers failures.
+     * The package never imports an analytics SDK; it just emits a
+     * `PaymentMethodEvent` action string plus PII-free props, and it's up to
+     * the consumer to map that to whatever telemetry system it uses (e.g.
+     * flights-ui's `@movmo_app/analytics` catalog). Fire points: `autoselected`
+     * (first-load default selection), `selected` (a genuine user row click —
+     * NOT the internal reselection after add/delete), `added`, `edited`
+     * (`fields` is key names only, never card values), `deleted`, and
+     * `set_default`. Kept referentially stable via a ref, same discipline as
+     * `onError`/`reportError`.
+     */
+    onEvent?: (action: PaymentMethodEvent, props?: Record<string, unknown>) => void;
     /**
      * Show the Credit card / PayPal / GooglePay / Klarna / ACH radios above
      * the card-capture form. Only Credit card is functional today; the others