@alviere/ui 0.15.2 → 0.16.0

package/dist/index.d.ts

@@ -64,6 +64,7 @@ export declare interface FlowConfig {
     allowBack?: boolean;
     showProgress?: boolean;
     showNavigation?: boolean;
+    maxReAuths?: number;
 }
 
 export declare interface FlowEvent {

package/dist/index.js

@@ -10,7 +10,7 @@ var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot
 var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
 var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
 var _a, _commit_callbacks, _discard_callbacks, _pending, _blocking_pending, _deferred, _dirty_effects, _maybe_dirty_effects, _Batch_instances, traverse_effect_tree_fn, defer_effects_fn, clear_marked_fn, resolve_fn, commit_fn, _pending2, _anchor, _hydrate_open, _props, _children, _effect, _main_effect, _pending_effect, _failed_effect, _offscreen_fragment, _pending_anchor, _local_pending_count, _pending_count, _is_creating_fallback, _effect_pending, _effect_pending_subscriber, _Boundary_instances, hydrate_resolved_content_fn, hydrate_pending_content_fn, get_anchor_fn, run_fn, show_pending_snippet_fn, update_pending_count_fn, _batches, _onscreen, _offscreen, _outroing, _transition, _commit, _discard, _events, _instance;
-import { AlviereCore, AlcoreApiError, AlcoreErrorCodes, isCriticalError } from "@alviere/core";
+import { AlviereCore, AlcoreApiError, AlcoreErrorCodes, isCriticalError, getJWTRefreshTime } from "@alviere/core";
 import { onMount, createEventDispatcher, untrack as untrack$1 } from "svelte";
 const PUBLIC_VERSION = "5";
 if (typeof window !== "undefined") {
@@ -12705,7 +12705,12 @@ function Callout($$anchor, $$props) {
 }
 customElements.define("alviere-callout", create_custom_element(Callout, { message: {}, variant: {}, role: {}, ariaLive: {} }, [], [], true));
 const createFlowCoreStore = () => {
-  const { subscribe, set: set2, update: update2 } = writable({ core: null, isInitialized: false, config: null });
+  const { subscribe, set: set2, update: update2 } = writable({
+    core: null,
+    isInitialized: false,
+    config: null,
+    jwtManager: null
+  });
   return {
     subscribe,
     set: set2,
@@ -12754,11 +12759,22 @@ const createFlowCoreStore = () => {
         return { ...state2, config: { ...state2.config, jwt: newJwt } };
       });
     },
+    /**
+     * Register the JwtManager so child components can call attemptReAuth()
+     */
+    setJwtManager: (manager2) => {
+      update2((state2) => ({ ...state2, jwtManager: manager2 }));
+    },
     /**
      * Reset the store (cleanup)
      */
     reset: () => {
-      set2({ core: null, isInitialized: false, config: null });
+      set2({
+        core: null,
+        isInitialized: false,
+        config: null,
+        jwtManager: null
+      });
     },
     /**
      * Get the current core instance (for non-reactive access)
@@ -13449,9 +13465,9 @@ function createAccountStatusGuard(config) {
     notifyBarrier
   };
 }
-const INDIVIDUAL_PAYER = { "profileId": "INDIVIDUAL_PAYER", "config": { "labels": { "finalText": "Payment in process" } }, "steps": [{ "type": "CREATE_CONSUMER_ACCOUNT", "fields": { "first_name": { "required": "First Name is required", "alphabetic": true }, "last_name": { "required": "Last Name is required", "alphabetic": true }, "email_address": { "required": "Email Address is required", "email": true } }, "fieldMeta": { "first_name": { "label": "First Name" }, "last_name": { "label": "Last Name" }, "email_address": { "label": "Email Address" }, "line_1": { "label": "Address Line 1" }, "line_2": { "label": "Address Line 2" }, "city": { "label": "City" }, "state": { "label": "State/Province" }, "postal_code": { "label": "Postal Code" }, "country": { "label": "Country" } }, "config": { "groups": { "information": "consumer_information" }, "layout": [{ "label": "Personal Information", "group": "consumer_information", "rows": [{ "fields": ["first_name", "last_name"] }, { "fields": ["email_address"] }] }], "statusPolicy": { "allowedStatusesForNextStep": ["ACTIVE"], "polling": { "enabled": true, "intervalMs": 2e3, "maxRetries": 5, "terminalStatuses": ["FAILED", "REJECTED"], "onTerminal": "error" } } } }, { "type": "ADD_BANK_ACCOUNT", "fields": { "ach_routing_number": {}, "ach_account_number": {}, "ach_account_type": {} }, "fieldMeta": { "ach_routing_number": { "label": "Routing Number", "helpText": "You can find your routing number on your check or bank statement." }, "ach_account_number": { "label": "Account Number" }, "ach_account_type": { "label": "Account Type" } }, "config": { "requireRoutingAndAccountConfirmation": true, "metadata": { "payee_uuid": "{{businessUuid}}" }, "labels": { "prenoteInfoLabel": false, "prenotePendingInfoLabel": "Bank account validation and payment is expected to be completed within 5–7 business days." } } }, { "type": "CHECKOUT_CONFIRM", "config": { "labels": { "paymentTimingInfoLabel": "Payment is expected to be completed within 3–5 business days.", "paymentTimingPendingInfoLabel": "Bank account validation and payment is expected to be completed within 5–7 business days." }, "amountEditable": false, "legalTexts": { "required": true, "documents": [{ "type": "ACH_AUTHORIZATION_INDIVIDUAL_PAYER" }] } } }] };
-const BUSINESS_PAYER = { "profileId": "BUSINESS_PAYER", "config": { "labels": { "finalText": "Payment in process" } }, "steps": [{ "type": "CREATE_BUSINESS_ACCOUNT", "fields": { "business_name": { "required": "Business Name is required", "alphabetic": true }, "business_type": { "required": "Business Type is required" }, "country_of_incorporation": { "required": "Country of Incorporation is required" }, "state_of_incorporation": { "required": "State of Incorporation is required" }, "ein": {} }, "fieldMeta": { "business_name": { "label": "Business Name" }, "business_type": { "label": "Business Type" }, "country_of_incorporation": { "label": "Country of Incorporation" }, "state_of_incorporation": { "label": "State of Incorporation" }, "ein": { "label": "EIN" }, "email_address": { "label": "Email Address" }, "line_1": { "label": "Address Line 1" }, "line_2": { "label": "Address Line 2" }, "city": { "label": "City" }, "state": { "label": "State/Province" }, "postal_code": { "label": "Postal Code" }, "country": { "label": "Country" } }, "config": { "groups": { "information": "business_information" }, "layout": [{ "label": "Business Information", "group": "business_information", "rows": [{ "fields": ["business_name", "business_type"] }, { "fields": ["country_of_incorporation", "state_of_incorporation"] }, { "fields": ["ein"] }] }], "statusPolicy": { "allowedStatusesForNextStep": ["ACTIVE"], "polling": { "enabled": true, "intervalMs": 3e3, "maxRetries": 5, "terminalStatuses": ["FAILED", "REJECTED"], "onTerminal": "error" } } } }, { "type": "ADD_BANK_ACCOUNT", "fields": { "ach_routing_number": {}, "ach_account_number": {}, "ach_account_type": {} }, "fieldMeta": { "ach_routing_number": { "label": "Routing Number", "helpText": "You can find your routing number on your check or bank statement." }, "ach_account_number": { "label": "Account Number" }, "ach_account_type": { "label": "Account Type" } }, "config": { "requireRoutingAndAccountConfirmation": true, "metadata": { "payee_uuid": "{{businessUuid}}" }, "labels": { "prenoteInfoLabel": "New bank accounts go through prenote verification. It can take up to 3-5 business days for the account to become ACTIVE and for payments to finish processing.", "prenotePendingInfoLabel": "This bank account is still in prenote verification (PENDING). It can take up to 3-5 business days before it becomes ACTIVE and payments are processed." } } }, { "type": "CHECKOUT_CONFIRM", "config": { "labels": { "paymentTimingInfoLabel": "If this is a newly added bank account, prenote verification can take up to 3-5 business days before the account becomes ACTIVE and the payment is fully processed.", "paymentTimingPendingInfoLabel": "This bank account is still in prenote verification (PENDING). It can take up to 3-5 business days before the account becomes ACTIVE and payment processing completes." }, "amountEditable": false, "legalTexts": { "required": true, "documents": [{ "type": "ACH_AUTHORIZATION_BUSINESS_PAYER" }] } } }] };
-const PAYEE = { "profileId": "PAYEE", "config": { "labels": { "finalText": "Process complete" } }, "steps": [{ "type": "CREATE_BUSINESS_ACCOUNT", "fields": { "business_type": { "required": "Business Type is required" }, "business_name": { "required": "Business Name is required" }, "country_of_incorporation": { "required": "Country of Incorporation is required" }, "state_of_incorporation": { "required": "State of Incorporation is required" }, "nature_of_business": { "required": "Nature of Business is required", "numeric": "Nature of Business must only contain numbers", "minValue": { "value": 11, "message": "Nature of Business must be between 11 and 999999" }, "maxValue": { "value": 999999, "message": "Nature of Business must be between 11 and 999999" } }, "ein": { "required": "EIN is required", "numeric": "EIN must only contain numbers" }, "email_address": { "email": true }, "phone_number": { "required": "Phone Number is required", "phone": true }, "website": { "url": true }, "line_1": { "required": "Address Line 1 is required", "pattern": { "regex": "^.{2,40}$", "message": "Address Line 1 must be between 2 and 40 characters" } }, "line_2": { "pattern": { "regex": "^.{1,30}$", "message": "Address Line 2 must be between 1 and 30 characters" } }, "city": { "required": "City is required" }, "state": { "required": "State is required" }, "postal_code": { "required": "Postal Code is required", "pattern": { "regex": "^.{5,9}$", "message": "Postal Code must be between 5 and 9 characters" } } }, "fieldMeta": { "business_name": { "label": "Business Name" }, "business_type": { "label": "Business Type" }, "country_of_incorporation": { "label": "Country of Incorporation" }, "state_of_incorporation": { "label": "State of Incorporation" }, "nature_of_business": { "label": "Nature of Business (NAICS)" }, "ein": { "label": "EIN" }, "email_address": { "label": "Email Address" }, "phone_number": { "label": "Phone Number" }, "website": { "label": "Website" }, "line_1": { "label": "Address Line 1" }, "line_2": { "label": "Address Line 2" }, "city": { "label": "City" }, "state": { "label": "State" }, "postal_code": { "label": "Postal Code" } }, "config": { "labels": { "createAccountLabel": "Create Account", "creatingAccountLabel": "Creating Account...", "updateAccountLabel": "Update Account", "updatingAccountLabel": "Updating Account..." }, "groups": { "information": "business_information", "primary_address": "primary_address" }, "layout": [{ "label": "Business Information", "group": "business_information", "rows": [{ "fields": ["business_name", "business_type"] }, { "fields": ["country_of_incorporation", "state_of_incorporation"] }, { "fields": ["nature_of_business", "ein"] }, { "fields": ["email_address", "phone_number"] }, { "fields": ["website"] }] }, { "label": "Address", "group": "primary_address", "rows": [{ "fields": ["line_1"] }, { "fields": ["line_2"] }, { "fields": ["city", "state"] }, { "fields": ["postal_code"] }] }], "statusPolicy": { "allowedStatusesForNextStep": ["ACTIVE", "CREATED"], "barrierStatuses": ["MANUAL_REVIEW"], "barrierTitle": "Review in progress", "barrierMessage": "Your account is currently under review. <br />You will be able to continue once the review is complete.", "polling": { "enabled": true, "intervalMs": 3e3, "maxRetries": 5, "terminalStatuses": ["FAILED", "REJECTED"], "onTerminal": "error" } } } }, { "type": "START_ONBOARDING", "config": { "legalTexts": { "required": true, "documents": [{ "type": "TERMS_AND_CONDITIONS" }, { "type": "PRIVACY_POLICY" }] }, "statusPolicy": { "allowedStatusesForNextStep": ["ACTIVE"], "barrierStatuses": ["MANUAL_REVIEW"], "barrierTitle": "Manual review in progress", "barrierMessage": "Your account is currently under review. <br />You will be able to continue once the review is complete.", "polling": { "enabled": true, "intervalMs": 3e3, "maxRetries": 5, "terminalStatuses": ["FAILED", "REJECTED"], "onTerminal": "error" } } } }, { "type": "ADD_BANK_ACCOUNT", "fields": { "ach_routing_number": {}, "ach_account_number": {} }, "fieldMeta": { "ach_routing_number": { "label": "Routing Number", "helpText": "You can find your routing number on your check or bank statement." }, "ach_account_number": { "label": "Account Number" } }, "config": { "labels": { "finalizeButton": "Finalize Onboarding", "prenotePendingInfoLabel": "Bank account validation and payment is expected to be completed within 5–7 business days." }, "requireRoutingAndAccountConfirmation": true } }] };
+const INDIVIDUAL_PAYER = { "profileId": "INDIVIDUAL_PAYER", "config": { "maxReAuths": 3, "labels": { "finalText": "Payment in process" } }, "steps": [{ "type": "CREATE_CONSUMER_ACCOUNT", "fields": { "first_name": { "required": "First Name is required", "alphabetic": true }, "last_name": { "required": "Last Name is required", "alphabetic": true }, "email_address": { "required": "Email Address is required", "email": true } }, "fieldMeta": { "first_name": { "label": "First Name" }, "last_name": { "label": "Last Name" }, "email_address": { "label": "Email Address" }, "line_1": { "label": "Address Line 1" }, "line_2": { "label": "Address Line 2" }, "city": { "label": "City" }, "state": { "label": "State/Province" }, "postal_code": { "label": "Postal Code" }, "country": { "label": "Country" } }, "config": { "groups": { "information": "consumer_information" }, "layout": [{ "label": "Personal Information", "group": "consumer_information", "rows": [{ "fields": ["first_name", "last_name"] }, { "fields": ["email_address"] }] }], "statusPolicy": { "allowedStatusesForNextStep": ["ACTIVE"], "polling": { "enabled": true, "intervalMs": 2e3, "maxRetries": 5, "terminalStatuses": ["FAILED", "REJECTED"], "onTerminal": "error" } } } }, { "type": "ADD_BANK_ACCOUNT", "fields": { "ach_routing_number": {}, "ach_account_number": {}, "ach_account_type": {} }, "fieldMeta": { "ach_routing_number": { "label": "Routing Number", "helpText": "You can find your routing number on your check or bank statement." }, "ach_account_number": { "label": "Account Number" }, "ach_account_type": { "label": "Account Type" } }, "config": { "requireRoutingAndAccountConfirmation": true, "metadata": { "payee_uuid": "{{businessUuid}}" }, "labels": { "prenoteInfoLabel": false, "prenotePendingInfoLabel": "Bank account validation and payment is expected to be completed within 5–7 business days." } } }, { "type": "CHECKOUT_CONFIRM", "config": { "labels": { "paymentTimingInfoLabel": "Payment is expected to be completed within 3–5 business days.", "paymentTimingPendingInfoLabel": "Bank account validation and payment is expected to be completed within 5–7 business days." }, "amountEditable": false, "legalTexts": { "required": true, "documents": [{ "type": "ACH_AUTHORIZATION_INDIVIDUAL_PAYER" }] } } }] };
+const BUSINESS_PAYER = { "profileId": "BUSINESS_PAYER", "config": { "maxReAuths": 3, "labels": { "finalText": "Payment in process" } }, "steps": [{ "type": "CREATE_BUSINESS_ACCOUNT", "fields": { "business_name": { "required": "Business Name is required", "alphabetic": true }, "business_type": { "required": "Business Type is required" }, "country_of_incorporation": { "required": "Country of Incorporation is required" }, "state_of_incorporation": { "required": "State of Incorporation is required" }, "ein": {} }, "fieldMeta": { "business_name": { "label": "Business Name" }, "business_type": { "label": "Business Type" }, "country_of_incorporation": { "label": "Country of Incorporation" }, "state_of_incorporation": { "label": "State of Incorporation" }, "ein": { "label": "EIN" }, "email_address": { "label": "Email Address" }, "line_1": { "label": "Address Line 1" }, "line_2": { "label": "Address Line 2" }, "city": { "label": "City" }, "state": { "label": "State/Province" }, "postal_code": { "label": "Postal Code" }, "country": { "label": "Country" } }, "config": { "groups": { "information": "business_information" }, "layout": [{ "label": "Business Information", "group": "business_information", "rows": [{ "fields": ["business_name", "business_type"] }, { "fields": ["country_of_incorporation", "state_of_incorporation"] }, { "fields": ["ein"] }] }], "statusPolicy": { "allowedStatusesForNextStep": ["ACTIVE"], "polling": { "enabled": true, "intervalMs": 3e3, "maxRetries": 5, "terminalStatuses": ["FAILED", "REJECTED"], "onTerminal": "error" } } } }, { "type": "ADD_BANK_ACCOUNT", "fields": { "ach_routing_number": {}, "ach_account_number": {}, "ach_account_type": {} }, "fieldMeta": { "ach_routing_number": { "label": "Routing Number", "helpText": "You can find your routing number on your check or bank statement." }, "ach_account_number": { "label": "Account Number" }, "ach_account_type": { "label": "Account Type" } }, "config": { "requireRoutingAndAccountConfirmation": true, "metadata": { "payee_uuid": "{{businessUuid}}" }, "labels": { "prenoteInfoLabel": "New bank accounts go through prenote verification. It can take up to 3-5 business days for the account to become ACTIVE and for payments to finish processing.", "prenotePendingInfoLabel": "This bank account is still in prenote verification (PENDING). It can take up to 3-5 business days before it becomes ACTIVE and payments are processed." } } }, { "type": "CHECKOUT_CONFIRM", "config": { "labels": { "paymentTimingInfoLabel": "If this is a newly added bank account, prenote verification can take up to 3-5 business days before the account becomes ACTIVE and the payment is fully processed.", "paymentTimingPendingInfoLabel": "This bank account is still in prenote verification (PENDING). It can take up to 3-5 business days before the account becomes ACTIVE and payment processing completes." }, "amountEditable": false, "legalTexts": { "required": true, "documents": [{ "type": "ACH_AUTHORIZATION_BUSINESS_PAYER" }] } } }] };
+const PAYEE = { "profileId": "PAYEE", "config": { "maxReAuths": 3, "labels": { "finalText": "Process complete" } }, "steps": [{ "type": "CREATE_BUSINESS_ACCOUNT", "fields": { "business_type": { "required": "Business Type is required" }, "business_name": { "required": "Business Name is required" }, "country_of_incorporation": { "required": "Country of Incorporation is required" }, "state_of_incorporation": { "required": "State of Incorporation is required" }, "nature_of_business": { "required": "Nature of Business is required", "numeric": "Nature of Business must only contain numbers", "minValue": { "value": 11, "message": "Nature of Business must be between 11 and 999999" }, "maxValue": { "value": 999999, "message": "Nature of Business must be between 11 and 999999" } }, "ein": { "required": "EIN is required", "numeric": "EIN must only contain numbers" }, "email_address": { "email": true }, "phone_number": { "required": "Phone Number is required", "phone": true }, "website": { "url": true }, "line_1": { "required": "Address Line 1 is required", "pattern": { "regex": "^.{2,40}$", "message": "Address Line 1 must be between 2 and 40 characters" } }, "line_2": { "pattern": { "regex": "^.{1,30}$", "message": "Address Line 2 must be between 1 and 30 characters" } }, "city": { "required": "City is required" }, "state": { "required": "State is required" }, "postal_code": { "required": "Postal Code is required", "pattern": { "regex": "^.{5,9}$", "message": "Postal Code must be between 5 and 9 characters" } } }, "fieldMeta": { "business_name": { "label": "Business Name" }, "business_type": { "label": "Business Type" }, "country_of_incorporation": { "label": "Country of Incorporation" }, "state_of_incorporation": { "label": "State of Incorporation" }, "nature_of_business": { "label": "Nature of Business (NAICS)" }, "ein": { "label": "EIN" }, "email_address": { "label": "Email Address" }, "phone_number": { "label": "Phone Number" }, "website": { "label": "Website" }, "line_1": { "label": "Address Line 1" }, "line_2": { "label": "Address Line 2" }, "city": { "label": "City" }, "state": { "label": "State" }, "postal_code": { "label": "Postal Code" } }, "config": { "labels": { "createAccountLabel": "Create Account", "creatingAccountLabel": "Creating Account...", "updateAccountLabel": "Update Account", "updatingAccountLabel": "Updating Account..." }, "groups": { "information": "business_information", "primary_address": "primary_address" }, "layout": [{ "label": "Business Information", "group": "business_information", "rows": [{ "fields": ["business_name", "business_type"] }, { "fields": ["country_of_incorporation", "state_of_incorporation"] }, { "fields": ["nature_of_business", "ein"] }, { "fields": ["email_address", "phone_number"] }, { "fields": ["website"] }] }, { "label": "Address", "group": "primary_address", "rows": [{ "fields": ["line_1"] }, { "fields": ["line_2"] }, { "fields": ["city", "state"] }, { "fields": ["postal_code"] }] }], "statusPolicy": { "allowedStatusesForNextStep": ["ACTIVE", "CREATED"], "barrierStatuses": ["MANUAL_REVIEW"], "barrierTitle": "Review in progress", "barrierMessage": "Your account is currently under review. <br />You will be able to continue once the review is complete.", "polling": { "enabled": true, "intervalMs": 3e3, "maxRetries": 5, "terminalStatuses": ["FAILED", "REJECTED"], "onTerminal": "error" } } } }, { "type": "START_ONBOARDING", "config": { "legalTexts": { "required": true, "documents": [{ "type": "TERMS_AND_CONDITIONS" }, { "type": "PRIVACY_POLICY" }] }, "statusPolicy": { "allowedStatusesForNextStep": ["ACTIVE"], "barrierStatuses": ["MANUAL_REVIEW"], "barrierTitle": "Manual review in progress", "barrierMessage": "Your account is currently under review. <br />You will be able to continue once the review is complete.", "polling": { "enabled": true, "intervalMs": 3e3, "maxRetries": 5, "terminalStatuses": ["FAILED", "REJECTED"], "onTerminal": "error" } } } }, { "type": "ADD_BANK_ACCOUNT", "fields": { "ach_routing_number": {}, "ach_account_number": {} }, "fieldMeta": { "ach_routing_number": { "label": "Routing Number", "helpText": "You can find your routing number on your check or bank statement." }, "ach_account_number": { "label": "Account Number" } }, "config": { "labels": { "finalizeButton": "Finalize Onboarding", "prenotePendingInfoLabel": "Bank account validation and payment is expected to be completed within 5–7 business days." }, "requireRoutingAndAccountConfirmation": true } }] };
 const recipesJson = {
   INDIVIDUAL_PAYER,
   BUSINESS_PAYER,
@@ -16068,6 +16084,34 @@ customElements.define("alviere-create-consumer-account", create_custom_element(
   [],
   true
 ));
+function getErrorCode(error) {
+  var _a2, _b, _c, _d, _e, _f, _g, _h;
+  if (!error || typeof error !== "object") return void 0;
+  const parsed = error;
+  const parsedMessageCode = typeof parsed.message === "string" ? (_a2 = parsed.message.match(/Alcore API Error\s+(\d+)/)) == null ? void 0 : _a2[1] : void 0;
+  return parsed.errorCode || parsed.error_code || parsed.code || ((_b = parsed.cause) == null ? void 0 : _b.errorCode) || ((_c = parsed.cause) == null ? void 0 : _c.error_code) || ((_d = parsed.cause) == null ? void 0 : _d.code) || ((_f = (_e = parsed.response) == null ? void 0 : _e.data) == null ? void 0 : _f.errorCode) || ((_h = (_g = parsed.response) == null ? void 0 : _g.data) == null ? void 0 : _h.error_code) || parsedMessageCode || void 0;
+}
+async function classifyApiError(error, jwtManager) {
+  const errorCode = getErrorCode(error);
+  if (errorCode === AlcoreErrorCodes.INVALID_JWT) {
+    if (jwtManager == null ? void 0 : jwtManager.canReAuth()) {
+      const success = await jwtManager.attemptReAuth();
+      if (success) return { kind: "reauth-success" };
+    }
+    return { kind: "critical", error, errorCode };
+  }
+  if (errorCode && isCriticalError(errorCode)) {
+    return { kind: "critical", error, errorCode };
+  }
+  return { kind: "non-critical", errorCode };
+}
+function toAlcoreApiError(error, errorCode) {
+  if (error instanceof AlcoreApiError) return error;
+  return new AlcoreApiError(
+    errorCode || "000000",
+    error instanceof Error ? error.message : "An unexpected error occurred"
+  );
+}
 const bankInfoCache = /* @__PURE__ */ new Map();
 async function lookupRoutingNumber(routingNumber, alviereCore) {
   const cleanRouting = routingNumber.replace(/[-\s]/g, "");
@@ -16157,6 +16201,7 @@ function AddBankAccount($$anchor, $$props) {
   push($$props, true);
   append_styles$1($$anchor, $$css$b);
   const $flowRecipeStore = () => store_get(flowRecipeStore, "$flowRecipeStore", $$stores);
+  const $flowCoreStore = () => store_get(flowCoreStore, "$flowCoreStore", $$stores);
   const [$$stores, $$cleanup] = setup_stores();
   var _a2;
   var _b;
@@ -16424,10 +16469,17 @@ function AddBankAccount($$anchor, $$props) {
         if (baseForm.state.validationErrors.ach_routing_number === invalidRoutingNumberMessage) {
           baseForm.actions.clearFieldError("ach_routing_number");
         }
-      }).catch((error) => {
+      }).catch(async (error) => {
         set(bankInfo, null);
-        baseForm.actions.setFieldError("ach_routing_number", invalidRoutingNumberMessage);
-        uiLogger.warn("Failed to lookup bank info:", error);
+        const result = await classifyApiError(error, $flowCoreStore().jwtManager);
+        if (result.kind === "reauth-success") {
+          baseForm.actions.clearFieldError("ach_routing_number");
+        } else if (result.kind === "critical") {
+          dispatchCriticalError(result.error, result.errorCode);
+        } else {
+          baseForm.actions.setFieldError("ach_routing_number", invalidRoutingNumberMessage);
+          uiLogger.warn("Failed to lookup bank info:", error);
+        }
       }).finally(() => {
         set(isLoadingBankInfo, false);
       });
@@ -16517,12 +16569,14 @@ function AddBankAccount($$anchor, $$props) {
       set(isSubmitting, false);
     }
   }
-  function getErrorCode(error) {
-    var _a3, _b2, _c2, _d, _e, _f, _g, _h;
-    if (!error || typeof error !== "object") return void 0;
-    const parsed = error;
-    const parsedMessageCode = typeof parsed.message === "string" ? (_a3 = parsed.message.match(/Alcore API Error\s+(\d+)/)) === null || _a3 === void 0 ? void 0 : _a3[1] : void 0;
-    return parsed.errorCode || parsed.error_code || parsed.code || ((_b2 = parsed.cause) === null || _b2 === void 0 ? void 0 : _b2.errorCode) || ((_c2 = parsed.cause) === null || _c2 === void 0 ? void 0 : _c2.error_code) || ((_d = parsed.cause) === null || _d === void 0 ? void 0 : _d.code) || ((_f = (_e = parsed.response) === null || _e === void 0 ? void 0 : _e.data) === null || _f === void 0 ? void 0 : _f.errorCode) || ((_h = (_g = parsed.response) === null || _g === void 0 ? void 0 : _g.data) === null || _h === void 0 ? void 0 : _h.error_code) || parsedMessageCode || void 0;
+  function dispatchCriticalError(error, errorCode) {
+    if (get$1(hostElement)) {
+      get$1(hostElement).dispatchEvent(new CustomEvent(ComponentEvents.FORM_ERROR, {
+        detail: { error: toAlcoreApiError(error, errorCode), stepType },
+        bubbles: true,
+        composed: true
+      }));
+    }
   }
   function getAddBankAccountErrorMessage(errorCode) {
     if (errorCode === "340029") {
@@ -16545,8 +16599,15 @@ function AddBankAccount($$anchor, $$props) {
   async function handleAddBankAccount(event2) {
     var _a3, _b2;
     event2.preventDefault();
+    if (get$1(isLoadingBankInfo)) {
+      return;
+    }
     baseForm.actions.markAllFieldsAsInteracted();
     baseForm.actions.validateAllFields();
+    const routingOnSubmit = baseForm.state.formData.ach_details.routing_number;
+    if (baseForm.state.alviereCore && (routingOnSubmit === null || routingOnSubmit === void 0 ? void 0 : routingOnSubmit.length) === 9 && !get$1(isLoadingBankInfo) && get$1(bankInfo) === null) {
+      baseForm.actions.setFieldError("ach_routing_number", getFieldErrorMessage("ach_routing_number", "pattern", INVALID_ROUTING_NUMBER_MESSAGE));
+    }
     if (!baseForm.computed.canSubmit) {
       uiLogger.debug("Cannot submit: form validation failed");
       return;
@@ -16626,8 +16687,14 @@ function AddBankAccount($$anchor, $$props) {
       set(showAddForm, false);
     } catch (error) {
       uiLogger.error("❌ Error adding bank account:", error);
-      const errorCode = getErrorCode(error);
-      set(formError, getAddBankAccountErrorMessage(errorCode), true);
+      const result = await classifyApiError(error, $flowCoreStore().jwtManager);
+      if (result.kind === "reauth-success") {
+        set(formError, "Your session has been refreshed. Please try again.");
+      } else if (result.kind === "critical") {
+        dispatchCriticalError(result.error, result.errorCode);
+      } else {
+        set(formError, getAddBankAccountErrorMessage(result.errorCode), true);
+      }
     } finally {
       set(isSubmitting, false);
     }
@@ -17233,6 +17300,7 @@ function AddBankAccount($$anchor, $$props) {
                     baseForm.state.formData.ach_details.type = newValue;
                     baseForm.handlers.handleFieldChange("ach_account_type", newValue);
                   },
+                  onblur: () => baseForm.handlers.handleFieldBlur("ach_account_type"),
                   get validationSchema() {
                     return get$1(fieldSchemas).ach_account_type;
                   },
@@ -17307,6 +17375,13 @@ function AddBankAccount($$anchor, $$props) {
                     if (get$1(requireRoutingAndAccountConfirmation) && baseForm.state.formData.confirm_routing_number) {
                       validateRoutingConfirmation();
                     }
+                  },
+                  onblur: () => {
+                    baseForm.handlers.handleFieldBlur("ach_routing_number");
+                    const routing = baseForm.state.formData.ach_details.routing_number;
+                    if (baseForm.state.alviereCore && (routing == null ? void 0 : routing.length) === 9 && !get$1(isLoadingBankInfo) && get$1(bankInfo) === null) {
+                      baseForm.actions.setFieldError("ach_routing_number", getFieldErrorMessage("ach_routing_number", "pattern", INVALID_ROUTING_NUMBER_MESSAGE));
+                    }
                   }
                 });
               }
@@ -17352,6 +17427,10 @@ function AddBankAccount($$anchor, $$props) {
                           validateRoutingConfirmation();
                         }
                       },
+                      onblur: () => {
+                        baseForm.handlers.handleFieldBlur("confirm_routing_number");
+                        validateRoutingConfirmation();
+                      },
                       blockPaste: true
                     });
                   }
@@ -17420,7 +17499,8 @@ function AddBankAccount($$anchor, $$props) {
                     if (get$1(requireRoutingAndAccountConfirmation) && baseForm.state.formData.confirm_account_number) {
                       validateAccountConfirmation();
                     }
-                  }
+                  },
+                  onblur: () => baseForm.handlers.handleFieldBlur("ach_account_number")
                 });
               }
               var node_23 = sibling(node_22, 2);
@@ -17466,6 +17546,10 @@ function AddBankAccount($$anchor, $$props) {
                           validateAccountConfirmation();
                         }
                       },
+                      onblur: () => {
+                        baseForm.handlers.handleFieldBlur("confirm_account_number");
+                        validateAccountConfirmation();
+                      },
                       blockPaste: true
                     });
                   }
@@ -19606,13 +19690,20 @@ delegate(["click"]);
 create_custom_element(FormErrorBoundary, { onError: {}, allowRetry: {}, children: {} }, [], ["handleError", "reset"], true);
 function createJwtFlowManager(options) {
   const { getJwt, getCore, getDebug, onJwtUpdate } = options;
+  const getMaxReAuths = () => {
+    var _a2;
+    return ((_a2 = options.getMaxReAuths) == null ? void 0 : _a2.call(options)) ?? 3;
+  };
   let effectiveJwt = /* @__PURE__ */ state(proxy(getJwt()));
   let pendingJwt = /* @__PURE__ */ state(null);
   let stepJwtSnapshot = /* @__PURE__ */ state(proxy(getJwt()));
+  let reAuthCount = 0;
+  let refreshTimer = null;
   user_effect(() => {
     const currentJwt = getJwt();
     if (currentJwt) {
       set(effectiveJwt, currentJwt, true);
+      scheduleRefresh(currentJwt);
     }
   });
   user_effect(() => {
@@ -19623,7 +19714,7 @@ function createJwtFlowManager(options) {
       set(pendingJwt, null);
       const debug = getDebug();
       if (debug) {
-        uiLogger.info("✅ JWT downgrade successful - updated flow JWT");
+        uiLogger.info("✅ JWT update successful - updated flow JWT");
         uiLogger.info("🔐 Old JWT (first 50 chars):", oldJwt == null ? void 0 : oldJwt.substring(0, 50));
         uiLogger.info("🔐 New JWT (first 50 chars):", (_a2 = get$1(effectiveJwt)) == null ? void 0 : _a2.substring(0, 50));
         uiLogger.info("🔐 New JWT will be used in all subsequent steps");
@@ -19631,11 +19722,72 @@ function createJwtFlowManager(options) {
       onJwtUpdate == null ? void 0 : onJwtUpdate(get$1(effectiveJwt));
     }
   });
+  function scheduleRefresh(jwt) {
+    if (refreshTimer !== null) {
+      clearTimeout(refreshTimer);
+      refreshTimer = null;
+    }
+    const refreshAtMs = getJWTRefreshTime(jwt);
+    if (!refreshAtMs) return;
+    const delay = refreshAtMs - Date.now();
+    if (delay <= 0) {
+      getDebug() && uiLogger.warn("⏰ JWT refresh time already passed — triggering immediately");
+      attemptReAuth().then((success) => {
+        var _a2;
+        if (!success) (_a2 = options.onReAuthExhausted) == null ? void 0 : _a2.call(options);
+      });
+      return;
+    }
+    getDebug() && uiLogger.info(`⏰ JWT refresh scheduled in ${Math.round(delay / 1e3)}s (at ${new Date(refreshAtMs).toISOString()})`);
+    refreshTimer = setTimeout(
+      async () => {
+        var _a2;
+        refreshTimer = null;
+        getDebug() && uiLogger.info("⏰ JWT refresh timer fired — attempting re-auth");
+        const success = await attemptReAuth();
+        if (!success) {
+          (_a2 = options.onReAuthExhausted) == null ? void 0 : _a2.call(options);
+        }
+      },
+      delay
+    );
+  }
+  async function attemptReAuth() {
+    const maxReAuths = getMaxReAuths();
+    if (reAuthCount >= maxReAuths) {
+      getDebug() && uiLogger.warn(`🔐 Re-auth limit reached (${reAuthCount}/${maxReAuths}) — cannot re-authenticate`);
+      return false;
+    }
+    const core = getCore();
+    if (!core) {
+      getDebug() && uiLogger.warn("⚠️ Cannot re-auth — AlviereCore not initialized");
+      return false;
+    }
+    try {
+      const accountUuid = core.getAccountUuid();
+      if (!accountUuid) {
+        getDebug() && uiLogger.warn("⚠️ Cannot re-auth — account UUID not available in JWT");
+        return false;
+      }
+      getDebug() && uiLogger.info(`🔐 Attempting re-auth (${reAuthCount + 1}/${maxReAuths}) for account: ${accountUuid}`);
+      const newJwt = await core.generateScopedToken(accountUuid, false);
+      reAuthCount++;
+      getDebug() && uiLogger.info(`✅ Re-auth successful (${reAuthCount}/${maxReAuths})`);
+      set(pendingJwt, newJwt, true);
+      await new Promise((resolve) => setTimeout(resolve, 0));
+      scheduleRefresh(newJwt);
+      return true;
+    } catch (error) {
+      uiLogger.warn("⚠️ Re-auth attempt failed:", error);
+      return false;
+    }
+  }
   return {
     getJwtForStep: () => get$1(stepJwtSnapshot),
     getEffectiveJwt: () => get$1(effectiveJwt),
     updateJwt: (newJwt) => {
       set(effectiveJwt, newJwt, true);
+      scheduleRefresh(newJwt);
     },
     downgradeJwt: async (accountUuid) => {
       const core = getCore();
@@ -19659,12 +19811,22 @@ function createJwtFlowManager(options) {
         set(pendingJwt, newJwt, true);
         debug && uiLogger.info("🔐 Pending JWT set (first 50 chars):", newJwt == null ? void 0 : newJwt.substring(0, 50));
         await new Promise((resolve) => setTimeout(resolve, 0));
+        scheduleRefresh(newJwt);
       } catch (error) {
         uiLogger.warn("⚠️ Failed to perform JWT downgrade:", error);
       }
     },
     updateStepSnapshot: () => {
       set(stepJwtSnapshot, untrack$1(() => get$1(effectiveJwt)), true);
+    },
+    canReAuth: () => reAuthCount < getMaxReAuths(),
+    attemptReAuth,
+    cancelRefreshTimer: () => {
+      if (refreshTimer !== null) {
+        clearTimeout(refreshTimer);
+        refreshTimer = null;
+        getDebug() && uiLogger.info("⏰ JWT refresh timer cancelled");
+      }
     }
   };
 }
@@ -20147,8 +20309,27 @@ function MultiStepFlow($$anchor, $$props) {
     onJwtUpdate: (newJwt) => {
       flowCoreStore.updateJwt(newJwt);
       jwt(newJwt);
+    },
+    // maxReAuths is read reactively from the resolved recipe config (or FlowConfig prop)
+    getMaxReAuths: () => {
+      var _a3, _b2, _c;
+      return (_c = (_a3 = config() === null || config() === void 0 ? void 0 : config().maxReAuths) !== null && _a3 !== void 0 ? _a3 : (_b2 = get$1(profileRecipe) === null || get$1(profileRecipe) === void 0 ? void 0 : get$1(profileRecipe).config) === null || _b2 === void 0 ? void 0 : _b2.maxReAuths) !== null && _c !== void 0 ? _c : 3;
+    },
+    onReAuthExhausted: () => {
+      debug() && uiLogger.warn("🔐 Re-auth exhausted — halting flow with critical error");
+      set(flowBarrier, null);
+      set(
+        flowError,
+        {
+          message: get$1(criticalErrorMessage),
+          errorCode: "100305",
+          description: "Authentication session expired and could not be renewed."
+        },
+        true
+      );
     }
   });
+  flowCoreStore.setJwtManager(jwtManager);
   const flowManager = createFlowStateManager(() => config());
   const eventDispatcher = createFlowEventDispatcher({
     getFlowElement: () => get$1(
@@ -20357,6 +20538,7 @@ function MultiStepFlow($$anchor, $$props) {
     }
     return () => {
       debug() && uiLogger.info("🧹 Cleaning up flow - resetting AlviereCore store");
+      jwtManager.cancelRefreshTimer();
       resetFlowCore();
       resetFlowRecipe();
     };