@amos.com/amos-js 0.9.17 → 0.10.0

package/src/types.ts

@@ -11,6 +11,26 @@ export type PaymentMethodFormValidityChangeEvent = {
   isValid: boolean;
 };
 
+/**
+ * Detected card network from the PAN prefix inside the iframe.
+ * `null` when the field is empty or the digits do not match a known brand.
+ */
+export type CardBrand =
+  | "visa"
+  | "mastercard"
+  | "amex"
+  | "discover"
+  | "diners"
+  | "jcb";
+
+/**
+ * PCI-safe card brand update from the credit-card iframe. Does not
+ * include the PAN, last4, or BIN.
+ */
+export type PaymentMethodFormCardBrandChangeEvent = {
+  brand: CardBrand | null;
+};
+
 /**
  * Why an interactive confirmation attempt ended with `status: "incomplete"`.
  *
@@ -454,12 +474,18 @@ export type Message =
       /** Parent → embed: confirm a payment intent with an embed token. */
       type: "CONFIRM_PAYMENT_INTENT";
     } & Pick<components["schemas"]["PaymentIntent"], "id"> &
-      Pick<components["schemas"]["EmbedToken"], "token">)
+      Pick<components["schemas"]["EmbedToken"], "token"> & {
+        /** Present when ACH verification completed via Plaid Link in the parent. */
+        plaid?: components["schemas"]["PlaidCredentialsInput"];
+      })
   | ({
       /** Parent → embed: confirm a setup intent with an embed token. */
       type: "CONFIRM_SETUP_INTENT";
     } & Pick<components["schemas"]["SetupIntent"], "id"> &
-      Pick<components["schemas"]["EmbedToken"], "token">)
+      Pick<components["schemas"]["EmbedToken"], "token"> & {
+        /** Present when ACH verification completed via Plaid Link in the parent. */
+        plaid?: components["schemas"]["PlaidCredentialsInput"];
+      })
   | {
       /**
        * Embed → parent: the interactive confirmation flow finished.
@@ -498,6 +524,38 @@ export type Message =
        */
       type: "FORM_VALIDITY_CHANGE";
       isValid: boolean;
+    }
+  | {
+      /**
+       * Embed → parent: detected card brand changed. `brand` is the
+       * matched network, or `null` when the field is empty or the
+       * digits do not match a known brand. Does not include PCI data.
+       */
+      type: "CARD_BRAND_CHANGE";
+      brand: CardBrand | null;
+    }
+  | {
+      /**
+       * Embed → parent: merchant ACH verification threshold for this
+       * render token. `achThreshold` is cents, or `null` when the
+       * merchant has no threshold (manual ACH). `requireVerification`
+       * is true when the fetch failed in production (fail closed).
+       */
+      type: "ACH_THRESHOLD";
+      achThreshold?: number | null;
+      requireVerification?: boolean;
+    }
+  | {
+      /** Parent → embed: mint a Plaid Link token for Connect. */
+      type: "CREATE_PLAID_LINK_TOKEN";
+      requestId: string;
+    }
+  | {
+      /** Embed → parent: minted Plaid Link token, or `error`. */
+      type: "PLAID_LINK_TOKEN";
+      requestId: string;
+      link_token?: string;
+      error?: string;
     };
 
 /**