@authvia/payment-method-create 0.3.0 → 0.5.0

package/dist/constants/themeAvwcDerived.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Builds derived colors from the base primary using real opacity percentages.
+ * Uses `color-mix(..., transparent)` so values read directly as percentages.
+ */
+/** 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}.
+ */
+export declare function resolveAvwcPrimaryColor(color: string | null | undefined): string;
+/**
+ * Derived `--avwc-color-*` for the form root (surface, border, label, hover, pressed, filled-button hover).
+ */
+export declare function getAvwcDerivedThemeVariables(color?: string | null): Record<string, string>;

package/dist/{walletConstants.d.ts → constants/walletConstants.d.ts}

@@ -1,4 +1,4 @@
-import { PaymentOptions } from './types';
+import { PaymentOptions } from '../types';
 export declare const PAYMENT_METHOD_TYPES: string[];
 export declare const walletConstants: Record<string, any>;
 /**

package/dist/entry/index.d.ts

@@ -10,4 +10,6 @@ export type { AuthviaPaymentMethodFormProps, PaymentMethodFormData, VuetifyProps
 export { ErrorHandler, ErrorCodes } from '../utils/errors';
 export { config, getApiEndpoint, getCdnUrl, isDevelopment, isProduction } from '../utils/config';
 export { getInputSpacingClasses, getSpacingCSSVariables } from '../utils/spacing';
+/** Theme: primary accent resolution and derived `--avwc-color-*` (same logic as the form root inline style). */
+export { DEFAULT_AVWC_PRIMARY_COLOR, getAvwcDerivedThemeVariables, resolveAvwcPrimaryColor, } from '../constants/themeAvwcDerived';
 export { usePaymentMethodService } from '../composables/usePaymentMethodService';

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

@@ -39,7 +39,8 @@ declare class AuthviaPaymentMethodFormElement extends HTMLElement {
     private getAttributeValue;
     /**
      * Dialog overlays mount under {@link AuthviaPaymentMethodFormElement.container}, a sibling of the
-     * Vue form root, so they do not inherit inline --avwc-* from the inner div. Mirror theme tokens here.
+     * Vue form root, so they do not inherit the inner div’s inline style. Sets accent, radius, and
+     * `getAvwcDerivedThemeVariables` on the container so teleports inherit the same tokens.
      */
     private syncContainerThemeTokens;
     private getComponentProps;

package/dist/types/index.d.ts

@@ -1,16 +1,29 @@
 import { PaymentMethodType } from '../model';
+/**
+ * Runtime error from a specific payment method flow (card, ACH, Paze, PayPal, Venmo).
+ * Inner components attach `type` so hosts can branch without parsing `message`.
+ */
+export interface PaymentMethodFlowError {
+    message?: string;
+    type?: PaymentMethodType;
+    [key: string]: unknown;
+}
 export interface PaymentMethodDisplayText {
     title?: string;
     subtitle?: string;
     order?: number;
 }
 export interface PaymentMethodDisplayConfigMap {
+    /** Vertical spacing between option rows (CSS `gap`, e.g. `12px`, `1rem`). */
+    gap?: string;
     ach?: PaymentMethodDisplayText;
     card?: PaymentMethodDisplayText;
     paypal?: PaymentMethodDisplayText;
     paze?: PaymentMethodDisplayText;
     venmo?: PaymentMethodDisplayText;
 }
+/** Keys under `paymentMethodDisplay` that configure a single method (excludes list-level `gap`). */
+export type PaymentMethodDisplayRowKey = Exclude<keyof PaymentMethodDisplayConfigMap, 'gap'>;
 export interface TermsLinkConfig {
     show?: boolean;
     text?: string;
@@ -43,7 +56,6 @@ export interface AuthviaPaymentMethodFormProps {
     token?: string;
     merchantId?: string;
     card?: {
-        allow?: boolean;
         demoMode?: boolean;
         title?: string;
         subtitle?: string;

package/dist/utils/config.d.ts

@@ -17,8 +17,7 @@ export declare const config: {
  */
 export declare function getApiEndpoint(path: string): string;
 /**
- * Default path (relative to {@link config.cdnUrl}) for the credit-card loader script.
- * Matches the legacy hardcoded `/js/authvia-credit-card.js` used before env-based layout overrides.
+ * Default `src` for the credit-card loader script (absolute URL). {@link getCdnUrl} does not prefix {@link config.cdnUrl} onto http(s) URLs.
  */
 export declare const DEFAULT_CREDIT_CARD_SCRIPT_PATH: string;
 /**

package/dist/utils/paypalConfig.d.ts

@@ -18,13 +18,32 @@ export declare function getPaypalSdkUrlFromEnv(): string;
  * @param url - Candidate base URL (typically from env via `getPaypalSdkUrlFromEnv()`)
  */
 export declare function isValidPaypalSdkBaseUrl(url: string): boolean;
+/**
+ * True when the host enabled PayPal in the picker (`paypal` is boolean `true` or a config object).
+ * For `intent` other than `payouts`, the picker only lists PayPal when {@link isPayPalVenmoWalletReadyForNonPayoutIntent}
+ * is satisfied (same checks as the wallet open flow).
+ */
+export declare function isPayPalPropProvided(value: unknown): boolean;
 /**
  * Type guard: PayPal module config (`merchantId` required; optional `redirectUrl`).
- * Legacy embeds may still send `clientId` on this object; it is ignored — the JS SDK uses
- * `VITE_APP_PAYPAL_CLIENT_ID` only (validated on click).
+ * Extra payload fields do not fail the guard. The PayPal JS SDK client id is injected at build time via
+ * `VITE_APP_PAYPAL_CLIENT_ID` (CI/CD per environment); the UI validates on click.
  */
 export declare function isPayPalConfig(value: unknown): value is PayPalConfig;
 /**
  * Type guard: Venmo-only wallet config (same shape as PayPal; no `paypal` prop required).
  */
 export declare function isVenmoWalletConfig(value: unknown): value is PayPalConfig;
+/**
+ * Resolves PayPal/Venmo wallet settings (`merchantId`, `redirectUrl`, `venmo` flag) for the options layer.
+ * Keep in sync with `pvSettings` on `AuthviaPaymentMethodForm`.
+ *
+ * @param redirectUrlFallback - Typically `window.location.href` in the browser; use `''` in tests.
+ */
+export declare function buildPayPalVenmoPvSettings(paypal: unknown, venmo: unknown, redirectUrlFallback: string): Record<string, unknown>;
+/** True when `pv.merchantId` is present and non-empty after trim. */
+export declare function hasPaypalMerchantIdInPv(pv: Record<string, unknown> | null | undefined): boolean;
+/**
+ * For `intent` other than `payouts`, opening PayPal/Venmo requires merchant id and `VITE_APP_PAYPAL_CLIENT_ID`.
+ */
+export declare function isPayPalVenmoWalletReadyForNonPayoutIntent(pv: Record<string, unknown>): boolean;

package/dist/utils/pazeConfig.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Paze wallet init requires all of these on the `paze` prop (non-empty after trim).
+ * Aligns with validation in `AuthviaPaymentMethodOptions` before opening the Paze flow.
+ */
+export declare const PAZE_SETTINGS_REQUIRED_KEYS: readonly ["amount", "clientId", "profileId", "name"];
+/**
+ * True when every required Paze field is present and non-empty (strings or numbers OK for `amount`).
+ */
+export declare function isPazeConfigComplete(value: unknown): boolean;

package/dist/utils/tokenUtils.d.ts

@@ -41,3 +41,8 @@ export declare function getUserAndToken(authToken: string | undefined): UserAndT
  * @returns true if the token is expired or has no exp claim (treated as expired)
  */
 export declare function isTokenExpired(tokenParam: string, bufferSeconds?: number): boolean;
+/**
+ * Whether the JWT `scope` claim lists `payment_methods:create` (space-delimited scopes).
+ * Returns false if the token cannot be parsed or `scope` is missing.
+ */
+export declare function hasPaymentMethodsCreateScope(tokenParam: string): boolean;