@ozura/elements 1.3.1-next.74 → 1.3.1-next.76

package/dist/vue/sdk/OzVault.d.ts

@@ -1,5 +1,5 @@
 import { OzElement } from './OzElement';
-import { ElementType, BankElementType, ElementOptions, VaultOptions, TokenizeOptions, TokenResponse, BankTokenizeOptions, BankTokenResponse } from '../types';
+import { ElementType, BankElementType, ElementOptions, VaultOptions, TokenizeOptions, TokenResponse, BankTokenizeOptions, BankTokenResponse, FieldStatesSnapshot } from '../types';
 /**
  * The main entry point for OzElements. Creates and manages iframe-based
  * card input elements that keep raw card data isolated from the merchant page.
@@ -33,6 +33,7 @@ export declare class OzVault {
     private tokenizeResolvers;
     private bankTokenizeResolvers;
     private completionState;
+    private fieldStates;
     private tokenizerFrame;
     private tokenizerWindow;
     private tokenizerReady;
@@ -131,6 +132,14 @@ export declare class OzVault {
     get isBankComplete(): boolean;
     /** True iff the set is non-empty and every element has reported complete-and-valid. */
     private allComplete;
+    /**
+     * Snapshot of every created field's latest state, keyed by element type.
+     * Card and bank fields are combined (their type keys never collide). Useful for
+     * gating UI, rendering per-field errors, or showing the card brand without
+     * wiring an onChange listener per element. Returns shallow copies so callers
+     * cannot mutate the vault's internal state.
+     */
+    getFieldStates(): FieldStatesSnapshot;
     /**
      * `true` while a `createToken()` or `createBankToken()` call is in progress
      * (including the transparent wax-key refresh phase). Use this to keep the pay

package/dist/vue/types/index.d.ts

@@ -92,6 +92,21 @@ export interface ElementChangeEvent {
     /** Human-readable error when valid is false and the field has been touched */
     error?: string;
 }
+export interface FieldState {
+    empty: boolean;
+    complete: boolean;
+    valid: boolean;
+    /** Present when valid is false and the field has been touched. */
+    error?: string;
+    /** Card brand — cardNumber field only. */
+    cardBrand?: string;
+}
+/**
+ * Snapshot of every created field's latest state, keyed by element type. Only
+ * fields that have been created are present; each is present from creation,
+ * starting at { empty:true, complete:false, valid:false } until first change.
+ */
+export type FieldStatesSnapshot = Partial<Record<ElementType | BankElementType, FieldState>>;
 export type ElementType = 'cardNumber' | 'cvv' | 'expirationDate';
 /** Bank account element types. */
 export type BankElementType = 'accountNumber' | 'routingNumber';

package/dist/vue/vue/index.d.ts

@@ -24,7 +24,7 @@
  * ```
  */
 import { type Ref, type PropType, type ComputedRef } from 'vue';
-import type { ElementOptions, TokenizeOptions, TokenResponse, BankTokenizeOptions, BankTokenResponse, FontSource, Appearance } from '../types';
+import type { ElementOptions, TokenizeOptions, TokenResponse, BankTokenizeOptions, BankTokenResponse, FontSource, Appearance, FieldStatesSnapshot } from '../types';
 export interface OzElementsProps {
     /** Omit when using a test vault key from a Test project at ozuravault.com.
      *  Required for production vault keys. */
@@ -253,6 +253,18 @@ export interface UseOzElementsReturn {
  * @throws {Error} if called outside an <OzElements> provider
  */
 export declare function useOzElements(): UseOzElementsReturn;
+/**
+ * Reactive snapshot of every created field's state, keyed by element type
+ * (e.g. `cardNumber`, `cvv`, `accountNumber`). Each entry is
+ * `{ empty, complete, valid, error?, cardBrand? }`. Recomputes whenever any
+ * field fires a change event.
+ *
+ * @throws if called outside an `<OzElements>` provider tree.
+ * @example
+ * const fields = useFieldStates();
+ * // fields.value.cvv?.error
+ */
+export declare function useFieldStates(): ComputedRef<FieldStatesSnapshot>;
 /** Props accepted by all individual field components (OzCardNumber, OzExpiry, OzCvv, etc.). */
 export interface OzFieldProps {
     placeholder?: string;
@@ -359,4 +371,4 @@ export declare const OzBankRoutingNumber: import("vue").DefineComponent<{
     style: import("../types").ElementStyleConfig | undefined;
     disabled: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-export type { ElementChangeEvent, TokenizeOptions, TokenResponse, BankTokenizeOptions, BankTokenResponse, Appearance, FontSource, } from '../types';
+export type { ElementChangeEvent, TokenizeOptions, TokenResponse, BankTokenizeOptions, BankTokenResponse, Appearance, FontSource, FieldState, FieldStatesSnapshot, } from '../types';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ozura/elements",
-  "version": "1.3.1-next.74",
+  "version": "1.3.1-next.76",
   "description": "PCI-compliant card tokenization SDK for the Ozura Vault — collect card data in iframe-isolated fields and tokenize without PCI scope",
   "main": "dist/oz-elements.umd.js",
   "module": "dist/oz-elements.esm.js",