@amboras-dev/authorize-net 1.1.6 → 1.2.0

package/dist/index.d.mts

@@ -95,6 +95,55 @@ interface AuthorizeNetAdapterProps {
      * "Pay now" bar. Call `registerConfirm(null)` on unmount.
      */
     registerConfirm?: (fn: (() => Promise<void>) | null) => void;
+    /**
+     * Saved-payment-method (vault) state, threaded down from the storefront's
+     * `useCheckout`. Optional because the checkout page has been passing it for
+     * longer than this contract has declared it: older storefront templates -
+     * and any template pinned to an earlier version of this package - render the
+     * adapter without it, and a required field would break their typecheck on
+     * upgrade. Treat `undefined` as "this storefront has no vault UI", not as
+     * "saving is off".
+     */
+    vault?: AuthorizeNetVaultProps;
+}
+/**
+ * Saved-payment-method state the storefront checkout threads into the adapter.
+ *
+ * Field-for-field mirror of the `vault` object on the starter-template
+ * storefront's `PaymentProviderComponentProps`; it is restated here for the
+ * same zero-storefront-dependency reason as `AuthorizeNetAdapterProps`. Any
+ * drift from that shape is a silently broken adapter, so the two must be
+ * changed together.
+ *
+ * Changing either `savePaymentMethod` or `selectedSavedMethodId` re-initializes
+ * the payment session - the save flag and the saved-credential binding live on
+ * the PSP object server-side, so the adapter cannot apply them locally.
+ */
+interface AuthorizeNetVaultProps {
+    /**
+     * EFFECTIVE save flag - already forced to `true` by the checkout when
+     * `saveRequired`, so the adapter renders it rather than recomputing it.
+     */
+    savePaymentMethod: boolean;
+    onSavePaymentMethodChange: (v: boolean) => void;
+    /**
+     * Saving is MANDATORY for this cart (Subscribe & Save). The renewal engine
+     * charges the stored card off-session with no buyer present, so the adapter
+     * must render the consent as checked + disabled instead of as an opt-in.
+     * Vaulting a card without surfacing that consent is not acceptable, and the
+     * card networks require the cardholder to have agreed to the stored-credential
+     * arrangement before the first off-session charge - a silently-checked box the
+     * buyer never saw is exactly the disclosure failure that gets the mandate
+     * disputed and the transaction charged back.
+     */
+    saveRequired: boolean;
+    /**
+     * Id of the already-saved method the buyer chose, or `null` to pay with a new
+     * card. Non-null means nothing is being vaulted on this order, so the consent
+     * must not be rendered at all.
+     */
+    selectedSavedMethodId: string | null;
+    onSelectSavedMethod: (id: string | null) => void;
 }
 /**
  * Shape of the provider object the orchestrator-owned adapter template
@@ -115,4 +164,4 @@ interface AuthorizeNetProviderRegistryEntry {
     Component: ComponentType<AuthorizeNetAdapterProps>;
 }
 
-export type { AuthorizeNetAdapterProps, AuthorizeNetCurrency, AuthorizeNetEnvironment, AuthorizeNetHostedMode, AuthorizeNetPaymentStatus, AuthorizeNetPostUrl, AuthorizeNetProviderId, AuthorizeNetProviderIdPrefix, AuthorizeNetProviderRegistryEntry, AuthorizeNetSessionData, AuthorizeNetTransactionStatus };
+export type { AuthorizeNetAdapterProps, AuthorizeNetCurrency, AuthorizeNetEnvironment, AuthorizeNetHostedMode, AuthorizeNetPaymentStatus, AuthorizeNetPostUrl, AuthorizeNetProviderId, AuthorizeNetProviderIdPrefix, AuthorizeNetProviderRegistryEntry, AuthorizeNetSessionData, AuthorizeNetTransactionStatus, AuthorizeNetVaultProps };

package/dist/index.d.ts

@@ -95,6 +95,55 @@ interface AuthorizeNetAdapterProps {
      * "Pay now" bar. Call `registerConfirm(null)` on unmount.
      */
     registerConfirm?: (fn: (() => Promise<void>) | null) => void;
+    /**
+     * Saved-payment-method (vault) state, threaded down from the storefront's
+     * `useCheckout`. Optional because the checkout page has been passing it for
+     * longer than this contract has declared it: older storefront templates -
+     * and any template pinned to an earlier version of this package - render the
+     * adapter without it, and a required field would break their typecheck on
+     * upgrade. Treat `undefined` as "this storefront has no vault UI", not as
+     * "saving is off".
+     */
+    vault?: AuthorizeNetVaultProps;
+}
+/**
+ * Saved-payment-method state the storefront checkout threads into the adapter.
+ *
+ * Field-for-field mirror of the `vault` object on the starter-template
+ * storefront's `PaymentProviderComponentProps`; it is restated here for the
+ * same zero-storefront-dependency reason as `AuthorizeNetAdapterProps`. Any
+ * drift from that shape is a silently broken adapter, so the two must be
+ * changed together.
+ *
+ * Changing either `savePaymentMethod` or `selectedSavedMethodId` re-initializes
+ * the payment session - the save flag and the saved-credential binding live on
+ * the PSP object server-side, so the adapter cannot apply them locally.
+ */
+interface AuthorizeNetVaultProps {
+    /**
+     * EFFECTIVE save flag - already forced to `true` by the checkout when
+     * `saveRequired`, so the adapter renders it rather than recomputing it.
+     */
+    savePaymentMethod: boolean;
+    onSavePaymentMethodChange: (v: boolean) => void;
+    /**
+     * Saving is MANDATORY for this cart (Subscribe & Save). The renewal engine
+     * charges the stored card off-session with no buyer present, so the adapter
+     * must render the consent as checked + disabled instead of as an opt-in.
+     * Vaulting a card without surfacing that consent is not acceptable, and the
+     * card networks require the cardholder to have agreed to the stored-credential
+     * arrangement before the first off-session charge - a silently-checked box the
+     * buyer never saw is exactly the disclosure failure that gets the mandate
+     * disputed and the transaction charged back.
+     */
+    saveRequired: boolean;
+    /**
+     * Id of the already-saved method the buyer chose, or `null` to pay with a new
+     * card. Non-null means nothing is being vaulted on this order, so the consent
+     * must not be rendered at all.
+     */
+    selectedSavedMethodId: string | null;
+    onSelectSavedMethod: (id: string | null) => void;
 }
 /**
  * Shape of the provider object the orchestrator-owned adapter template
@@ -115,4 +164,4 @@ interface AuthorizeNetProviderRegistryEntry {
     Component: ComponentType<AuthorizeNetAdapterProps>;
 }
 
-export type { AuthorizeNetAdapterProps, AuthorizeNetCurrency, AuthorizeNetEnvironment, AuthorizeNetHostedMode, AuthorizeNetPaymentStatus, AuthorizeNetPostUrl, AuthorizeNetProviderId, AuthorizeNetProviderIdPrefix, AuthorizeNetProviderRegistryEntry, AuthorizeNetSessionData, AuthorizeNetTransactionStatus };
+export type { AuthorizeNetAdapterProps, AuthorizeNetCurrency, AuthorizeNetEnvironment, AuthorizeNetHostedMode, AuthorizeNetPaymentStatus, AuthorizeNetPostUrl, AuthorizeNetProviderId, AuthorizeNetProviderIdPrefix, AuthorizeNetProviderRegistryEntry, AuthorizeNetSessionData, AuthorizeNetTransactionStatus, AuthorizeNetVaultProps };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type {\n  AuthorizeNetSessionData,\n  AuthorizeNetHostedMode,\n  AuthorizeNetEnvironment,\n  AuthorizeNetPostUrl,\n  AuthorizeNetCurrency,\n  AuthorizeNetTransactionStatus,\n  AuthorizeNetPaymentStatus,\n  AuthorizeNetProviderIdPrefix,\n  AuthorizeNetProviderId,\n  AuthorizeNetAdapterProps,\n  AuthorizeNetProviderRegistryEntry,\n} from './types'\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type {\n  AuthorizeNetSessionData,\n  AuthorizeNetHostedMode,\n  AuthorizeNetEnvironment,\n  AuthorizeNetPostUrl,\n  AuthorizeNetCurrency,\n  AuthorizeNetTransactionStatus,\n  AuthorizeNetPaymentStatus,\n  AuthorizeNetProviderIdPrefix,\n  AuthorizeNetProviderId,\n  AuthorizeNetAdapterProps,\n  AuthorizeNetVaultProps,\n  AuthorizeNetProviderRegistryEntry,\n} from './types'\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amboras-dev/authorize-net",
-  "version": "1.1.6",
+  "version": "1.2.0",
   "description": "Authorize.Net Accept Hosted payment provider types for Amboras storefronts",
   "main": "dist/index.js",
   "module": "dist/index.mjs",