@ozura/elements 1.3.1-next.75 → 1.3.1-next.77

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

@@ -1,3 +1,5 @@
+import type { CardBrand } from '../utils/cardUtils';
+export type { CardBrand } from '../utils/cardUtils';
 export interface ElementStyle {
     color?: string;
     fontSize?: string;
@@ -99,12 +101,13 @@ export interface FieldState {
     /** Present when valid is false and the field has been touched. */
     error?: string;
     /** Card brand — cardNumber field only. */
-    cardBrand?: string;
+    cardBrand?: CardBrand;
 }
 /**
- * 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.
+ * Latest state of each field, keyed by element type. Keys are optional because a
+ * given form may not create every field (e.g. a card-only form has no bank keys);
+ * access with `?.`. At runtime, every field that has been created is present —
+ * from creation onward, starting at the default until its first change.
  */
 export type FieldStatesSnapshot = Partial<Record<ElementType | BankElementType, FieldState>>;
 export type ElementType = 'cardNumber' | 'cvv' | 'expirationDate';

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

@@ -371,4 +371,4 @@ export declare const OzBankRoutingNumber: import("vue").DefineComponent<{
     placeholder: string;
     disabled: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-export type { ElementChangeEvent, TokenizeOptions, TokenResponse, BankTokenizeOptions, BankTokenResponse, Appearance, FontSource, FieldState, FieldStatesSnapshot, } from '../types';
+export type { ElementChangeEvent, TokenizeOptions, TokenResponse, BankTokenizeOptions, BankTokenResponse, Appearance, FontSource, FieldState, FieldStatesSnapshot, CardBrand, } from '../types';

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

@@ -132,6 +132,8 @@ export declare class OzVault {
     get isBankComplete(): boolean;
     /** True iff the set is non-empty and every element has reported complete-and-valid. */
     private allComplete;
+    /** The state a field reports before its first change event (and after reset/reload). */
+    private makeDefaultFieldState;
     /**
      * 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

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

@@ -1,3 +1,5 @@
+import type { CardBrand } from '../utils/cardUtils';
+export type { CardBrand } from '../utils/cardUtils';
 export interface ElementStyle {
     color?: string;
     fontSize?: string;
@@ -99,12 +101,13 @@ export interface FieldState {
     /** Present when valid is false and the field has been touched. */
     error?: string;
     /** Card brand — cardNumber field only. */
-    cardBrand?: string;
+    cardBrand?: CardBrand;
 }
 /**
- * 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.
+ * Latest state of each field, keyed by element type. Keys are optional because a
+ * given form may not create every field (e.g. a card-only form has no bank keys);
+ * access with `?.`. At runtime, every field that has been created is present —
+ * from creation onward, starting at the default until its first change.
  */
 export type FieldStatesSnapshot = Partial<Record<ElementType | BankElementType, FieldState>>;
 export type ElementType = 'cardNumber' | 'cvv' | 'expirationDate';

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

@@ -371,4 +371,4 @@ export declare const OzBankRoutingNumber: import("vue").DefineComponent<{
     placeholder: string;
     disabled: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-export type { ElementChangeEvent, TokenizeOptions, TokenResponse, BankTokenizeOptions, BankTokenResponse, Appearance, FontSource, FieldState, FieldStatesSnapshot, } from '../types';
+export type { ElementChangeEvent, TokenizeOptions, TokenResponse, BankTokenizeOptions, BankTokenResponse, Appearance, FontSource, FieldState, FieldStatesSnapshot, CardBrand, } from '../types';

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

@@ -132,6 +132,8 @@ export declare class OzVault {
     get isBankComplete(): boolean;
     /** True iff the set is non-empty and every element has reported complete-and-valid. */
     private allComplete;
+    /** The state a field reports before its first change event (and after reset/reload). */
+    private makeDefaultFieldState;
     /**
      * 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

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

@@ -1,3 +1,5 @@
+import type { CardBrand } from '../utils/cardUtils';
+export type { CardBrand } from '../utils/cardUtils';
 export interface ElementStyle {
     color?: string;
     fontSize?: string;
@@ -99,12 +101,13 @@ export interface FieldState {
     /** Present when valid is false and the field has been touched. */
     error?: string;
     /** Card brand — cardNumber field only. */
-    cardBrand?: string;
+    cardBrand?: CardBrand;
 }
 /**
- * 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.
+ * Latest state of each field, keyed by element type. Keys are optional because a
+ * given form may not create every field (e.g. a card-only form has no bank keys);
+ * access with `?.`. At runtime, every field that has been created is present —
+ * from creation onward, starting at the default until its first change.
  */
 export type FieldStatesSnapshot = Partial<Record<ElementType | BankElementType, FieldState>>;
 export type ElementType = 'cardNumber' | 'cvv' | 'expirationDate';

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

@@ -371,4 +371,4 @@ export declare const OzBankRoutingNumber: import("vue").DefineComponent<{
     placeholder: string;
     disabled: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-export type { ElementChangeEvent, TokenizeOptions, TokenResponse, BankTokenizeOptions, BankTokenResponse, Appearance, FontSource, FieldState, FieldStatesSnapshot, } from '../types';
+export type { ElementChangeEvent, TokenizeOptions, TokenResponse, BankTokenizeOptions, BankTokenResponse, Appearance, FontSource, FieldState, FieldStatesSnapshot, CardBrand, } from '../types';

package/dist/vue/index.cjs.js

@@ -1283,6 +1283,10 @@ class OzVault {
             return false;
         return els.every(el => this.completionState.get(el.frameId) === true);
     }
+    /** The state a field reports before its first change event (and after reset/reload). */
+    makeDefaultFieldState() {
+        return { empty: true, complete: false, valid: false };
+    }
     /**
      * 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
@@ -1294,10 +1298,10 @@ class OzVault {
         var _a, _b;
         const snapshot = {};
         for (const [type, el] of this.elementsByType) {
-            snapshot[type] = Object.assign({}, ((_a = this.fieldStates.get(el.frameId)) !== null && _a !== void 0 ? _a : { empty: true, complete: false, valid: false }));
+            snapshot[type] = Object.assign({}, ((_a = this.fieldStates.get(el.frameId)) !== null && _a !== void 0 ? _a : this.makeDefaultFieldState()));
         }
         for (const [type, el] of this.bankElementsByType) {
-            snapshot[type] = Object.assign({}, ((_b = this.fieldStates.get(el.frameId)) !== null && _b !== void 0 ? _b : { empty: true, complete: false, valid: false }));
+            snapshot[type] = Object.assign({}, ((_b = this.fieldStates.get(el.frameId)) !== null && _b !== void 0 ? _b : this.makeDefaultFieldState()));
         }
         return snapshot;
     }
@@ -1365,7 +1369,7 @@ class OzVault {
         }, this._debug);
         this.elements.set(el.frameId, el);
         typeMap.set(type, el);
-        this.fieldStates.set(el.frameId, { empty: true, complete: false, valid: false });
+        this.fieldStates.set(el.frameId, this.makeDefaultFieldState());
         return el;
     }
     /**
@@ -1667,7 +1671,7 @@ class OzVault {
         }
         // Mirror for field states: every created field returns to its default.
         for (const frameId of this.fieldStates.keys()) {
-            this.fieldStates.set(frameId, { empty: true, complete: false, valid: false });
+            this.fieldStates.set(frameId, this.makeDefaultFieldState());
         }
         // NOTE: _tokenizeSuccessCount is intentionally NOT reset.
         // It reflects real server-side wax key budget consumption. Zeroing it
@@ -1878,6 +1882,10 @@ class OzVault {
                 // the previous session and justCompleted never fires, breaking auto-advance.
                 if (msg.type === 'OZ_FRAME_READY') {
                     this.completionState.set(frameId, false);
+                    // Mirror the completion reset: a reloaded iframe starts empty, so the
+                    // field state must return to default rather than serving pre-reload data
+                    // (e.g. a stale card brand) until the next OZ_CHANGE arrives.
+                    this.fieldStates.set(frameId, this.makeDefaultFieldState());
                     if (msg.__ozVersion !== PROTOCOL_VERSION) {
                         console.warn(`[OzVault] Protocol version mismatch on element frame "${frameId}" — ` +
                             `SDK expects v${PROTOCOL_VERSION}, frame reported v${typeof msg.__ozVersion === 'number' ? msg.__ozVersion : '(none)'}. ` +
@@ -1919,9 +1927,13 @@ class OzVault {
         var _a, _b, _c;
         const complete = msg.complete;
         const valid = msg.valid;
+        // Narrow rather than blind-cast: a malformed/legacy frame that omits `empty`
+        // must not write `undefined` into the public FieldState contract.
+        const empty = typeof msg.empty === 'boolean' ? msg.empty : true;
         const wasComplete = (_a = this.completionState.get(el.frameId)) !== null && _a !== void 0 ? _a : false;
         this.completionState.set(el.frameId, complete && valid);
-        this.fieldStates.set(el.frameId, Object.assign(Object.assign({ empty: msg.empty, complete,
+        this.fieldStates.set(el.frameId, Object.assign(Object.assign({ empty,
+            complete,
             valid }, (typeof msg.error === 'string' ? { error: msg.error } : {})), (typeof msg.cardBrand === 'string' ? { cardBrand: msg.cardBrand } : {})));
         // Require valid too — avoids advancing at 13 digits for unknown-brand cards
         // where isComplete() fires before the user has finished typing.