@authvia/payment-method-create 0.5.0 → 0.6.0

package/dist/composables/paymentMethodOptions/usePaymentMethodOptionsHandlers.d.ts

@@ -0,0 +1,43 @@
+import { ComputedRef } from 'vue';
+import { PaymentMethodType } from '../../model';
+import { PaymentMethodOptionsProps } from '../../types/paymentMethodOptions';
+import { MethodSuccessPayload, PazeSuccessPayload, PaymentMethodOptionsEmit } from './paymentMethodOptionsTypes';
+import { PaymentMethodOptionsStateReturn } from './usePaymentMethodOptionsState';
+/**
+ * Click handlers, Plaid/ACH flow, Paze, and success/error emitters for the payment method chooser.
+ */
+export declare function usePaymentMethodOptionsHandlers(props: PaymentMethodOptionsProps, emit: PaymentMethodOptionsEmit, optionsUiState: PaymentMethodOptionsStateReturn): {
+    closePaymentMethodForm: () => void;
+    handlePaymentMethodClick: (type: string) => void;
+    handleAchOptions: () => void;
+    handleAchClose: () => void;
+    handleAchOptionSelect: (option: string) => void;
+    handleUpdateForgetCard: (_value: boolean) => void;
+    pazeAmount: ComputedRef<number | undefined>;
+    handlePazeSuccess: (data: PazeSuccessPayload) => void;
+    handlePazeError: (error: {
+        message: string;
+        type?: PaymentMethodType;
+    }) => void;
+    handlePazeCancel: () => void;
+    handleCreditCardSuccess: (data: MethodSuccessPayload | null) => void;
+    handleCreditCardError: (error: {
+        message: string;
+        type?: PaymentMethodType;
+    }) => void;
+    handlePayoutSuccess: (data: MethodSuccessPayload | null) => void;
+    handlePayoutError: (error: {
+        message: string;
+        type?: PaymentMethodType;
+    }) => void;
+    handlePaymentMethodSuccess: (data: MethodSuccessPayload | null) => void;
+    handlePaymentMethodError: (error: {
+        message: string;
+        type?: PaymentMethodType;
+    }) => void;
+    handleChildSubmit: (payload: unknown) => void;
+    handlePlaidResponse: (accountData: unknown) => void;
+    handlePlaidInitialize: () => void;
+    handlePlaidExit: () => void;
+    handlePlaidError: () => void;
+};

package/dist/composables/paymentMethodOptions/usePaymentMethodOptionsState.d.ts

@@ -0,0 +1,27 @@
+import { ComputedRef, Ref } from 'vue';
+import { PaymentMethodOptionsProps } from '../../types/paymentMethodOptions';
+/**
+ * Dialog attach target, visibility refs, and ACH chooser-related state for payment method options.
+ */
+export declare function usePaymentMethodOptionsState(props: PaymentMethodOptionsProps): {
+    dialogAttachTarget: HTMLElement | undefined;
+    optionsAttachId: string;
+    dialogAttachResolved: ComputedRef<string | HTMLElement>;
+    showChoosePaymentMethodsModal: Ref<boolean>;
+    showPaymentMethodForm: Ref<boolean>;
+    activeFormType: Ref<'creditcard' | 'paypal' | 'venmo' | null>;
+    showACHForm: Ref<boolean>;
+    showACHOptions: Ref<boolean>;
+    showPazeForm: Ref<boolean>;
+    showPlaidOption: Ref<boolean>;
+    showConfirmLoader: Ref<boolean>;
+    errorMessage: Ref<string>;
+    showAchTypeChoice: Ref<boolean>;
+    plaidData: Ref<Record<string, unknown>>;
+    achOptionsTitle: ComputedRef<string>;
+    achOnlineProp: ComputedRef<boolean>;
+    resetAchFlowState: () => void;
+    allPaymentMethodsAllowed: ComputedRef<boolean>;
+    hasAnyPaymentMethod: ComputedRef<boolean>;
+};
+export type PaymentMethodOptionsStateReturn = ReturnType<typeof usePaymentMethodOptionsState>;

package/dist/constants/themeAvwcDerived.d.ts

@@ -5,7 +5,16 @@
 /** Default when `color` / `data-color` is omitted. */
 export declare const DEFAULT_AVWC_PRIMARY_COLOR = "#4CAF50";
 /**
- * Trims `color`; empty or missing → {@link DEFAULT_AVWC_PRIMARY_COLOR}.
+ * Default border radius when `borderRadius` / `data-border-radius` is omitted.
+ * Surfaces as `--avwc-border-radius`.
+ */
+export declare const DEFAULT_AVWC_BORDER_RADIUS: string;
+/** Error / destructive accent (e.g. delete icon, alerts) when not driven by theme config. */
+export declare const DEFAULT_AVWC_ERROR_COLOR: string;
+/** Default Vuetify field variant for payment method inputs. */
+export declare const DEFAULT_AVWC_FIELD_VARIANT: "outlined";
+/**
+ * Trims `color`; empty or missing -> {@link DEFAULT_AVWC_PRIMARY_COLOR}.
  */
 export declare function resolveAvwcPrimaryColor(color: string | null | undefined): string;
 /**

package/dist/entry/web-component.d.ts

@@ -27,6 +27,7 @@ declare class AuthviaPaymentMethodFormElement extends HTMLElement {
     private dependencyObservers;
     private readonly bundledMdiUrl;
     private readonly hasBundledMdi;
+    private hasReportedMissingDependencies;
     constructor();
     /**
      * Copy CSS variables from document :root and host's ancestors to host element.
@@ -34,6 +35,7 @@ declare class AuthviaPaymentMethodFormElement extends HTMLElement {
      */
     private copyCssVariablesFromRoot;
     private initializeComponent;
+    private reportMissingDependencies;
     private mountComponent;
     private ensureDependencies;
     private getAttributeValue;

package/dist/model/PaymentMethodAPIError.d.ts

@@ -6,6 +6,7 @@ export declare class PaymentMethodAPIError extends Error {
     errors?: Array<any>;
     status?: number;
     id?: string;
+    apiError?: Record<string, unknown>;
     /**
      * Construct Error With Code
      * @param code
@@ -13,6 +14,7 @@ export declare class PaymentMethodAPIError extends Error {
      * @param errors
      * @param status
      * @param id
+     * @param apiError
      */
-    constructor(code: string, message: string, errors?: Array<any>, status?: number, id?: string);
+    constructor(code: string, message: string, errors?: Array<any>, status?: number, id?: string, apiError?: Record<string, unknown>);
 }

package/dist/types/achForm.d.ts

@@ -0,0 +1,42 @@
+import { PaymentMethodBillingAddress } from '../model';
+import { TermsConfig } from '.';
+export type AchFieldKey = 'routingNumber' | 'accountNumber' | 'nameOnAccount';
+export interface P_ACHValues {
+    nameOnAccount: string;
+    accountNumber: string;
+    routingNumber: string;
+    accountType: string;
+    streetAddress: string;
+    city: string;
+    state: string;
+    country: string;
+    postalCode: string;
+}
+/** Props subset used by ACH create / submit flow. */
+export interface AchFormSubmitContextProps {
+    authToken: string;
+    merchantId?: string;
+    customerRef?: string;
+    intent?: string;
+}
+/**
+ * `AuthviaPaymentMethodAddAch` / payment-method-add-ach public props (runtime + typing).
+ * Kept in one place for the SFC and {@link useAuthviaPaymentMethodAddAchForm} (`src/composables/ach/`).
+ */
+export interface AuthviaPaymentMethodAddAchProps {
+    demoMode?: boolean;
+    submitBtnText?: string;
+    plaid?: Record<string, unknown>;
+    billingAddress?: PaymentMethodBillingAddress;
+    terms?: TermsConfig;
+    forgetHidden?: boolean;
+    forgetDefault?: boolean;
+    authToken: string;
+    customerRef?: string;
+    dataBillingAddress?: PaymentMethodBillingAddress;
+    intent?: string;
+    merchantId?: string;
+    variant?: string;
+    color?: string;
+    borderRadius?: string;
+}

package/dist/types/index.d.ts

@@ -8,6 +8,17 @@ export interface PaymentMethodFlowError {
     type?: PaymentMethodType;
     [key: string]: unknown;
 }
+/**
+ * Canonical payload for `error` emits across payment method components.
+ * Keeps Sentry/host listeners aligned on one contract.
+ */
+export interface PaymentMethodErrorPayload {
+    message: string;
+    type: PaymentMethodType;
+    status?: number;
+    code?: string;
+    apiError?: Record<string, unknown>;
+}
 export interface PaymentMethodDisplayText {
     title?: string;
     subtitle?: string;

package/dist/types/paymentMethodOptions.d.ts

@@ -0,0 +1,34 @@
+import { PaymentMethodBillingAddress } from '../model';
+import { PaymentMethodRestrictions, PaymentMethodDisplayConfigMap, TermsConfig } from '.';
+/**
+ * Public props for {@link AuthviaPaymentMethodOptions} (options chooser + dialogs).
+ */
+export interface PaymentMethodOptionsProps {
+    token: string;
+    merchantId?: string;
+    customerRef?: string;
+    intent?: string;
+    allowedPaymentMethodTypes?: string[];
+    achOnline?: boolean;
+    achDemoMode?: boolean;
+    cardDemoMode?: boolean;
+    paymentMethodDisplay?: PaymentMethodDisplayConfigMap;
+    terms?: TermsConfig;
+    cardSubmitBtnText?: string;
+    achSubmitBtnText?: string;
+    cardNumber?: string;
+    cardNameOnCard?: string;
+    cardExpiration?: string;
+    cardCvv?: string;
+    cardBillingAddress?: PaymentMethodBillingAddress;
+    achBillingAddress?: PaymentMethodBillingAddress;
+    pzSettings?: Record<string, unknown>;
+    pvSettings?: Record<string, unknown>;
+    forgetHidden?: boolean;
+    forgetDefault?: boolean;
+    color?: string;
+    borderRadius?: string;
+    variant?: string;
+    restrictions?: PaymentMethodRestrictions[];
+    vuetifyOverrides?: string;
+}

package/dist/utils/achApiErrorMapping.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Map v1 API attribute paths to form field names for ACH error display.
+ */
+export declare function getV1ModelAttributeName(attributeName: string): string | undefined;
+/**
+ * User-facing line for a form attribute key.
+ */
+export declare function getAchErrorMessageForAttribute(attributeName: string): string;

package/dist/utils/achCreatePayload.d.ts

@@ -0,0 +1,8 @@
+import { PaymentMethod } from '../model';
+import { P_ACHValues } from '../types/achForm';
+type AchFormSnapshot = P_ACHValues;
+/**
+ * v3 `POST .../payment-methods` body; used for both `submit` emit and usePaymentMethodService.create.
+ */
+export declare function buildAchCreatePayload(fields: AchFormSnapshot, plaidData: Record<string, unknown> | undefined, isPlaid: boolean): PaymentMethod;
+export {};

package/dist/utils/authviaAddressFormComponent.d.ts

@@ -0,0 +1,6 @@
+import { Component } from 'vue';
+/**
+ * {@link @authvia/address-create} default export is the Vue plugin; the form is a named export.
+ * Package typings only declare default; this file bridges runtime + template resolution.
+ */
+export declare const AuthviaAddressForm: Component;

package/dist/utils/sentryErrorSummary.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Extracts a compact summary from API validation errors for Sentry visibility.
+ * Keeps fields flat so Sentry UI does not collapse nested arrays as "[Array]".
+ */
+export declare function extractApiErrorSummary(payload: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Extracts safe API error metadata from unknown errors.
+ * Includes only known scalar fields needed for Sentry correlation.
+ */
+export declare function extractPaymentMethodErrorMetadata(error: unknown): Record<string, unknown>;

package/dist/utils/sentryWidget.d.ts

@@ -0,0 +1,41 @@
+import { App } from 'vue';
+/** Stable Sentry filter id (CTO / Lock alignment). */
+export declare const WIDGET_SENTRY_COMPONENT: "payment-method-create";
+declare global {
+    interface Window {
+        /** Set by Lock (or another host) before loading the widget so we skip `Sentry.init`. */
+        __AUTHVIA_EMBED__?: {
+            sentry?: 'host';
+        };
+    }
+}
+/**
+ * When true, this build must not call `Sentry.init` with the widget DSN; Lock (or another host) owns the client.
+ */
+export declare function shouldSkipWidgetSentryInit(): boolean;
+/**
+ * `standalone-web-component` when events go to the widget project; `lock-embed` when using the host client.
+ */
+export declare function resolveWidgetIntegrationTag(): 'standalone-web-component' | 'lock-embed';
+/**
+ * Binds Sentry to a Vue app for this package.
+ *
+ * - **Standalone** (`VITE_WIDGET_SENTRY_DSN` set, not an embed build): one `Sentry.init` per page, then Vue error handler.
+ * - **Lock / host** (`VITE_SENTRY_EMBED_MODE=lock` or `window.__AUTHVIA_EMBED__.sentry === 'host'`): no second `init`; attaches the Vue error handler to this app so errors reach the host client.
+ * - **Remounts** (new `createApp`): if the SDK is already initialized, only {@link attachErrorHandler} runs for the new app.
+ *
+ * Call after `createApp` and **before** `app.mount`.
+ *
+ * @param app - Vue 3 application instance
+ */
+export declare function bindWidgetSentryToVueApp(app: App): void;
+/**
+ * Reports an exception to Sentry when the SDK is active, with widget tags.
+ * Safe to call when Sentry was never initialized (no-op for `captureException`; optional structured debug log when enabled).
+ *
+ * In dev, or when `VITE_SENTRY_CAPTURE_DEBUG` is set in `.env`, logs the same payload shape to the browser console.
+ *
+ * @param error - Caught value
+ * @param hint - Optional fields passed through to `captureException` (e.g. `extra`, `contexts`)
+ */
+export declare function captureWidgetException(error: unknown, hint?: Record<string, unknown>): void;

package/dist/utils/tokenUtils.d.ts

@@ -46,3 +46,8 @@ export declare function isTokenExpired(tokenParam: string, bufferSeconds?: numbe
  * Returns false if the token cannot be parsed or `scope` is missing.
  */
 export declare function hasPaymentMethodsCreateScope(tokenParam: string): boolean;
+/**
+ * True when `error` is a normal token validation failure (malformed JWT, missing user claim, etc.).
+ * Used to avoid reporting expected embedder or end-user mistakes to Sentry.
+ */
+export declare function isExpectedTokenValidationError(error: unknown): boolean;