@gusto/embedded-react-sdk 0.50.0 → 0.51.0

package/dist/components/Contractor/PaymentMethod/shared/useContractorBankAccountForm/fields.d.ts

@@ -29,16 +29,7 @@ export type AccountNumberValidation = (typeof ContractorBankAccountErrorCodes)[k
  * @public
  */
 export type NameFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>;
-/**
- * Text input bound to the `name` field of {@link useContractorBankAccountForm}.
- *
- * @remarks
- * Surfaced to partners as `form.Fields.Name`; see {@link ContractorBankAccountFormFields}.
- *
- * @param props - See {@link NameFieldProps}.
- * @returns The rendered text input bound to `name`.
- * @internal
- */
+/** @internal */
 export declare function NameField(props: NameFieldProps): import("react").JSX.Element;
 /**
  * Props accepted by {@link useContractorBankAccountForm}'s `Fields.RoutingNumber` component.
@@ -46,16 +37,7 @@ export declare function NameField(props: NameFieldProps): import("react").JSX.El
  * @public
  */
 export type RoutingNumberFieldProps = HookFieldProps<TextInputHookFieldProps<RoutingNumberValidation>>;
-/**
- * Text input bound to the `routingNumber` field of {@link useContractorBankAccountForm}.
- *
- * @remarks
- * Surfaced to partners as `form.Fields.RoutingNumber`; see {@link ContractorBankAccountFormFields}.
- *
- * @param props - See {@link RoutingNumberFieldProps}.
- * @returns The rendered text input bound to `routingNumber`.
- * @internal
- */
+/** @internal */
 export declare function RoutingNumberField(props: RoutingNumberFieldProps): import("react").JSX.Element;
 /**
  * Props accepted by {@link useContractorBankAccountForm}'s `Fields.AccountNumber` component.
@@ -63,16 +45,7 @@ export declare function RoutingNumberField(props: RoutingNumberFieldProps): impo
  * @public
  */
 export type AccountNumberFieldProps = HookFieldProps<TextInputHookFieldProps<AccountNumberValidation>>;
-/**
- * Text input bound to the `accountNumber` field of {@link useContractorBankAccountForm}.
- *
- * @remarks
- * Surfaced to partners as `form.Fields.AccountNumber`; see {@link ContractorBankAccountFormFields}.
- *
- * @param props - See {@link AccountNumberFieldProps}.
- * @returns The rendered text input bound to `accountNumber`.
- * @internal
- */
+/** @internal */
 export declare function AccountNumberField(props: AccountNumberFieldProps): import("react").JSX.Element;
 /**
  * Props accepted by {@link useContractorBankAccountForm}'s `Fields.AccountType` component.
@@ -80,14 +53,5 @@ export declare function AccountNumberField(props: AccountNumberFieldProps): impo
  * @public
  */
 export type AccountTypeFieldProps = HookFieldProps<RadioGroupHookFieldProps<RequiredValidation, ContractorAccountType>>;
-/**
- * Radio group bound to the `accountType` field of {@link useContractorBankAccountForm}.
- *
- * @remarks
- * Surfaced to partners as `form.Fields.AccountType`; see {@link ContractorBankAccountFormFields}.
- *
- * @param props - See {@link AccountTypeFieldProps}.
- * @returns The rendered radio group bound to `accountType`.
- * @internal
- */
+/** @internal */
 export declare function AccountTypeField(props: AccountTypeFieldProps): import("react").JSX.Element;

package/dist/components/Contractor/PaymentMethod/shared/useContractorBankAccountForm/fields.js

@@ -1,6 +1,6 @@
 import { jsx as n } from "react/jsx-runtime";
-import { TextInputHookField as o } from "../../../../../partner-hook-utils/form/fields/TextInputHookField.js";
 import { RadioGroupHookField as r } from "../../../../../partner-hook-utils/form/fields/RadioGroupHookField.js";
+import { TextInputHookField as o } from "../../../../../partner-hook-utils/form/fields/TextInputHookField.js";
 function m(e) {
   return /* @__PURE__ */ n(o, { ...e, name: "name" });
 }

package/dist/components/Contractor/PaymentMethod/shared/useContractorBankAccountForm/fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Contractor/PaymentMethod/shared/useContractorBankAccountForm/fields.tsx"],"sourcesContent":["import type {\n  ContractorAccountType,\n  ContractorBankAccountErrorCodes,\n} from './useContractorBankAccountFormSchema'\nimport type { TextInputHookFieldProps } from '@/partner-hook-utils/form/fields/TextInputHookField'\nimport type { RadioGroupHookFieldProps } from '@/partner-hook-utils/form/fields/RadioGroupHookField'\nimport { TextInputHookField, RadioGroupHookField } from '@/partner-hook-utils/form/fields'\nimport type { HookFieldProps } from '@/partner-hook-utils/types'\n\n/**\n * Validation error code emitted by {@link useContractorBankAccountForm} fields\n * that only emit `REQUIRED`.\n *\n * @public\n */\nexport type RequiredValidation = typeof ContractorBankAccountErrorCodes.REQUIRED\n\n/**\n * Validation error codes emitted by the `routingNumber` field of\n * {@link useContractorBankAccountForm}.\n *\n * @public\n */\nexport type RoutingNumberValidation = (typeof ContractorBankAccountErrorCodes)[keyof Pick<\n  typeof ContractorBankAccountErrorCodes,\n  'REQUIRED' | 'INVALID_ROUTING_NUMBER'\n>]\n\n/**\n * Validation error codes emitted by the `accountNumber` field of\n * {@link useContractorBankAccountForm}.\n *\n * @public\n */\nexport type AccountNumberValidation = (typeof ContractorBankAccountErrorCodes)[keyof Pick<\n  typeof ContractorBankAccountErrorCodes,\n  'REQUIRED' | 'INVALID_ACCOUNT_NUMBER'\n>]\n\n/**\n * Props accepted by {@link useContractorBankAccountForm}'s `Fields.Name` component.\n *\n * @public\n */\nexport type NameFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/**\n * Text input bound to the `name` field of {@link useContractorBankAccountForm}.\n *\n * @remarks\n * Surfaced to partners as `form.Fields.Name`; see {@link ContractorBankAccountFormFields}.\n *\n * @param props - See {@link NameFieldProps}.\n * @returns The rendered text input bound to `name`.\n * @internal\n */\nexport function NameField(props: NameFieldProps) {\n  return <TextInputHookField {...props} name=\"name\" />\n}\n\n/**\n * Props accepted by {@link useContractorBankAccountForm}'s `Fields.RoutingNumber` component.\n *\n * @public\n */\nexport type RoutingNumberFieldProps = HookFieldProps<\n  TextInputHookFieldProps<RoutingNumberValidation>\n>\n\n/**\n * Text input bound to the `routingNumber` field of {@link useContractorBankAccountForm}.\n *\n * @remarks\n * Surfaced to partners as `form.Fields.RoutingNumber`; see {@link ContractorBankAccountFormFields}.\n *\n * @param props - See {@link RoutingNumberFieldProps}.\n * @returns The rendered text input bound to `routingNumber`.\n * @internal\n */\nexport function RoutingNumberField(props: RoutingNumberFieldProps) {\n  return <TextInputHookField {...props} name=\"routingNumber\" />\n}\n\n/**\n * Props accepted by {@link useContractorBankAccountForm}'s `Fields.AccountNumber` component.\n *\n * @public\n */\nexport type AccountNumberFieldProps = HookFieldProps<\n  TextInputHookFieldProps<AccountNumberValidation>\n>\n\n/**\n * Text input bound to the `accountNumber` field of {@link useContractorBankAccountForm}.\n *\n * @remarks\n * Surfaced to partners as `form.Fields.AccountNumber`; see {@link ContractorBankAccountFormFields}.\n *\n * @param props - See {@link AccountNumberFieldProps}.\n * @returns The rendered text input bound to `accountNumber`.\n * @internal\n */\nexport function AccountNumberField(props: AccountNumberFieldProps) {\n  return <TextInputHookField {...props} name=\"accountNumber\" />\n}\n\n/**\n * Props accepted by {@link useContractorBankAccountForm}'s `Fields.AccountType` component.\n *\n * @public\n */\nexport type AccountTypeFieldProps = HookFieldProps<\n  RadioGroupHookFieldProps<RequiredValidation, ContractorAccountType>\n>\n\n/**\n * Radio group bound to the `accountType` field of {@link useContractorBankAccountForm}.\n *\n * @remarks\n * Surfaced to partners as `form.Fields.AccountType`; see {@link ContractorBankAccountFormFields}.\n *\n * @param props - See {@link AccountTypeFieldProps}.\n * @returns The rendered radio group bound to `accountType`.\n * @internal\n */\nexport function AccountTypeField(props: AccountTypeFieldProps) {\n  return <RadioGroupHookField {...props} name=\"accountType\" />\n}\n"],"names":["NameField","props","jsx","TextInputHookField","RoutingNumberField","AccountNumberField","AccountTypeField","RadioGroupHookField"],"mappings":";;;AAwDO,SAASA,EAAUC,GAAuB;AAC/C,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,QAAO;AACpD;AAqBO,SAASG,EAAmBH,GAAgC;AACjE,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,iBAAgB;AAC7D;AAqBO,SAASI,EAAmBJ,GAAgC;AACjE,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,iBAAgB;AAC7D;AAqBO,SAASK,EAAiBL,GAA8B;AAC7D,SAAO,gBAAAC,EAACK,GAAA,EAAqB,GAAGN,GAAO,MAAK,eAAc;AAC5D;"}
+{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Contractor/PaymentMethod/shared/useContractorBankAccountForm/fields.tsx"],"sourcesContent":["import type {\n  ContractorAccountType,\n  ContractorBankAccountErrorCodes,\n} from './useContractorBankAccountFormSchema'\nimport type { TextInputHookFieldProps } from '@/partner-hook-utils/form/fields/TextInputHookField'\nimport type { RadioGroupHookFieldProps } from '@/partner-hook-utils/form/fields/RadioGroupHookField'\nimport { TextInputHookField, RadioGroupHookField } from '@/partner-hook-utils/form/fields'\nimport type { HookFieldProps } from '@/partner-hook-utils/types'\n\n/**\n * Validation error code emitted by {@link useContractorBankAccountForm} fields\n * that only emit `REQUIRED`.\n *\n * @public\n */\nexport type RequiredValidation = typeof ContractorBankAccountErrorCodes.REQUIRED\n\n/**\n * Validation error codes emitted by the `routingNumber` field of\n * {@link useContractorBankAccountForm}.\n *\n * @public\n */\nexport type RoutingNumberValidation = (typeof ContractorBankAccountErrorCodes)[keyof Pick<\n  typeof ContractorBankAccountErrorCodes,\n  'REQUIRED' | 'INVALID_ROUTING_NUMBER'\n>]\n\n/**\n * Validation error codes emitted by the `accountNumber` field of\n * {@link useContractorBankAccountForm}.\n *\n * @public\n */\nexport type AccountNumberValidation = (typeof ContractorBankAccountErrorCodes)[keyof Pick<\n  typeof ContractorBankAccountErrorCodes,\n  'REQUIRED' | 'INVALID_ACCOUNT_NUMBER'\n>]\n\n/**\n * Props accepted by {@link useContractorBankAccountForm}'s `Fields.Name` component.\n *\n * @public\n */\nexport type NameFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/** @internal */\nexport function NameField(props: NameFieldProps) {\n  return <TextInputHookField {...props} name=\"name\" />\n}\n\n/**\n * Props accepted by {@link useContractorBankAccountForm}'s `Fields.RoutingNumber` component.\n *\n * @public\n */\nexport type RoutingNumberFieldProps = HookFieldProps<\n  TextInputHookFieldProps<RoutingNumberValidation>\n>\n\n/** @internal */\nexport function RoutingNumberField(props: RoutingNumberFieldProps) {\n  return <TextInputHookField {...props} name=\"routingNumber\" />\n}\n\n/**\n * Props accepted by {@link useContractorBankAccountForm}'s `Fields.AccountNumber` component.\n *\n * @public\n */\nexport type AccountNumberFieldProps = HookFieldProps<\n  TextInputHookFieldProps<AccountNumberValidation>\n>\n\n/** @internal */\nexport function AccountNumberField(props: AccountNumberFieldProps) {\n  return <TextInputHookField {...props} name=\"accountNumber\" />\n}\n\n/**\n * Props accepted by {@link useContractorBankAccountForm}'s `Fields.AccountType` component.\n *\n * @public\n */\nexport type AccountTypeFieldProps = HookFieldProps<\n  RadioGroupHookFieldProps<RequiredValidation, ContractorAccountType>\n>\n\n/** @internal */\nexport function AccountTypeField(props: AccountTypeFieldProps) {\n  return <RadioGroupHookField {...props} name=\"accountType\" />\n}\n"],"names":["NameField","props","jsx","TextInputHookField","RoutingNumberField","AccountNumberField","AccountTypeField","RadioGroupHookField"],"mappings":";;;AA+CO,SAASA,EAAUC,GAAuB;AAC/C,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,QAAO;AACpD;AAYO,SAASG,EAAmBH,GAAgC;AACjE,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,iBAAgB;AAC7D;AAYO,SAASI,EAAmBJ,GAAgC;AACjE,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,iBAAgB;AAC7D;AAYO,SAASK,EAAiBL,GAA8B;AAC7D,SAAO,gBAAAC,EAACK,GAAA,EAAqB,GAAGN,GAAO,MAAK,eAAc;AAC5D;"}

package/dist/components/Contractor/PaymentMethod/shared/useContractorBankAccountForm/index.d.ts

@@ -1,5 +1,4 @@
-import "./types/i18next.d.ts"
 export { useContractorBankAccountForm } from './useContractorBankAccountForm';
 export type { UseContractorBankAccountFormProps, UseContractorBankAccountFormResult, UseContractorBankAccountFormReady, ContractorBankAccountFormFields, ContractorBankAccountFieldsMetadata, } from './useContractorBankAccountForm';
-export { ContractorBankAccountErrorCodes, ACCOUNT_TYPES, createContractorBankAccountSchema, type ContractorBankAccountErrorCode, type ContractorAccountType, type ContractorBankAccountFormData, type ContractorBankAccountFormOutputs, type ContractorBankAccountFormField, type ContractorBankAccountOptionalFieldsToRequire, } from './useContractorBankAccountFormSchema';
+export { ContractorBankAccountErrorCodes, ACCOUNT_TYPES, type ContractorBankAccountErrorCode, type ContractorAccountType, type ContractorBankAccountFormData, type ContractorBankAccountFormField, type ContractorBankAccountOptionalFieldsToRequire, } from './useContractorBankAccountFormSchema';
 export { type RequiredValidation as ContractorBankAccountRequiredValidation, type RoutingNumberValidation as ContractorBankAccountRoutingNumberValidation, type AccountNumberValidation as ContractorBankAccountAccountNumberValidation, type NameFieldProps, type RoutingNumberFieldProps, type AccountNumberFieldProps, type AccountTypeFieldProps, } from './fields';

package/dist/components/Contractor/PaymentMethod/shared/useContractorBankAccountForm/useContractorBankAccountForm.d.ts

@@ -1,9 +1,9 @@
 import { ComponentType } from 'react';
 import { UseFormProps } from 'react-hook-form';
-import { ContractorBankAccount } from '@gusto/embedded-api-v-2025-11-15/models/components/contractorbankaccount';
+import { ContractorBankAccount } from '@gusto/embedded-api-v-2026-02-01/models/components/contractorbankaccount';
 import { ContractorBankAccountFormData, ContractorBankAccountOptionalFieldsToRequire } from './useContractorBankAccountFormSchema';
 import { AccountNumberFieldProps, AccountTypeFieldProps, NameFieldProps, RoutingNumberFieldProps } from './fields';
-import { BaseFormHookReady, FieldsMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
+import { BaseFormHookReady, FieldMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
 /**
  * Props for {@link useContractorBankAccountForm}.
  *
@@ -48,7 +48,7 @@ export interface ContractorBankAccountFormFields {
  *
  * @public
  */
-export interface UseContractorBankAccountFormReady extends BaseFormHookReady<FieldsMetadata, ContractorBankAccountFormData, ContractorBankAccountFormFields> {
+export interface UseContractorBankAccountFormReady extends BaseFormHookReady<ContractorBankAccountFieldsMetadata, ContractorBankAccountFormData, ContractorBankAccountFormFields> {
     /** The contractor's current bank account, loaded from the API, if any. */
     data: {
         bankAccount: ContractorBankAccount | undefined;
@@ -124,4 +124,5 @@ export type UseContractorBankAccountFormResult = HookLoadingResult | UseContract
  *
  * @public
  */
-export type ContractorBankAccountFieldsMetadata = UseContractorBankAccountFormReady['form']['fieldsMetadata'];
+export type ContractorBankAccountFieldsMetadata = { name: FieldMetadata; routingNumber: FieldMetadata; accountNumber: FieldMetadata; accountType: import("../../../../../partner-hook-utils/types").FieldMetadataWithOptions<"Checking" | "Savings">; };
+export {};

package/dist/components/Contractor/PaymentMethod/shared/useContractorBankAccountForm/useContractorBankAccountForm.js

@@ -1,70 +1,74 @@
-import { useMemo as N } from "react";
-import { useForm as E } from "react-hook-form";
-import { zodResolver as P } from "@hookform/resolvers/zod";
-import { useContractorPaymentMethodGetBankAccounts as V } from "@gusto/embedded-api-v-2025-11-15/react-query/contractorPaymentMethodGetBankAccounts";
-import { useContractorPaymentMethodsCreateBankAccountMutation as H } from "@gusto/embedded-api-v-2025-11-15/react-query/contractorPaymentMethodsCreateBankAccount";
-import { createContractorBankAccountSchema as L, ACCOUNT_TYPES as g } from "./useContractorBankAccountFormSchema.js";
-import { AccountTypeField as O, AccountNumberField as R, RoutingNumberField as U, NameField as x } from "./fields.js";
-import { useDeriveFieldsMetadata as G } from "../../../../../partner-hook-utils/form/useDeriveFieldsMetadata.js";
-import { useHookFormInternals as I } from "../../../../../partner-hook-utils/form/useHookFormInternals.js";
-import { createGetFormSubmissionValues as q } from "../../../../../partner-hook-utils/form/getFormSubmissionValues.js";
-import { withOptions as z } from "../../../../../partner-hook-utils/form/withOptions.js";
-import { composeErrorHandler as K } from "../../../../../partner-hook-utils/composeErrorHandler.js";
-import { useBaseSubmit as Q } from "../../../../Base/useBaseSubmit.js";
-import { SDKInternalError as Y } from "../../../../../types/sdkError.js";
+import { useMemo as f } from "react";
+import { useForm as v } from "react-hook-form";
+import { zodResolver as E } from "@hookform/resolvers/zod";
+import { useContractorPaymentMethodGetBankAccounts as P } from "@gusto/embedded-api-v-2026-02-01/react-query/contractorPaymentMethodGetBankAccounts";
+import { useContractorPaymentMethodsCreateBankAccountMutation as V } from "@gusto/embedded-api-v-2026-02-01/react-query/contractorPaymentMethodsCreateBankAccount";
+import { createContractorBankAccountSchema as H, ACCOUNT_TYPES as N } from "./useContractorBankAccountFormSchema.js";
+import { AccountTypeField as L, AccountNumberField as O, RoutingNumberField as R, NameField as U } from "./fields.js";
+import { useDeriveFieldsMetadata as x } from "../../../../../partner-hook-utils/form/useDeriveFieldsMetadata.js";
+import { useHookFormInternals as G } from "../../../../../partner-hook-utils/form/useHookFormInternals.js";
+import { createGetFormSubmissionValues as I } from "../../../../../partner-hook-utils/form/getFormSubmissionValues.js";
+import { withOptions as q } from "../../../../../partner-hook-utils/form/withOptions.js";
+import { composeErrorHandler as z } from "../../../../../partner-hook-utils/composeErrorHandler.js";
+import { useBaseSubmit as K } from "../../../../Base/useBaseSubmit.js";
+import { SDKInternalError as Q } from "../../../../../types/sdkError.js";
+function Y(o) {
+  const n = N.map((t) => ({ value: t, label: t }));
+  return {
+    name: o.name,
+    routingNumber: o.routingNumber,
+    accountNumber: o.accountNumber,
+    accountType: q(o.accountType, n, [
+      ...N
+    ])
+  };
+}
 function at({
-  contractorId: m,
-  optionalFieldsToRequire: i,
-  defaultValues: o,
+  contractorId: o,
+  optionalFieldsToRequire: n,
+  defaultValues: t,
   validationMode: A = "onSubmit",
-  shouldFocusError: k = !0
+  shouldFocusError: g = !0
 }) {
-  const u = V({
-    contractorUuid: m
-  }), t = u.data?.contractorBankAccountList?.[0] ?? void 0, r = t?.hiddenAccountNumber ?? void 0, [s, y] = N(
-    () => L({
-      optionalFieldsToRequire: i,
+  const u = P({
+    contractorUuid: o
+  }), e = u.data?.contractorBankAccountList?.[0] ?? void 0, r = e?.hiddenAccountNumber ?? void 0, [m, k] = f(
+    () => H({
+      optionalFieldsToRequire: n,
       existingAccountNumberMask: r
     }),
-    [i, r]
-  ), d = N(
+    [n, r]
+  ), i = f(
     () => ({
-      name: o?.name ?? t?.name ?? "",
-      routingNumber: o?.routingNumber ?? t?.routingNumber ?? "",
-      accountNumber: o?.accountNumber ?? r ?? "",
-      accountType: o?.accountType ?? t?.accountType ?? "Checking"
+      name: t?.name ?? e?.name ?? "",
+      routingNumber: t?.routingNumber ?? e?.routingNumber ?? "",
+      accountNumber: t?.accountNumber ?? r ?? "",
+      accountType: t?.accountType ?? e?.accountType ?? "Checking"
     }),
-    [o, t, r]
-  ), n = E({
-    resolver: P(s),
+    [t, e, r]
+  ), c = v({
+    resolver: E(m),
     mode: A,
-    shouldFocusError: k,
-    defaultValues: d,
-    values: d,
+    shouldFocusError: g,
+    defaultValues: i,
+    values: i,
     resetOptions: { keepDirtyValues: !0 }
-  }), b = H(), B = b.isPending, {
-    baseSubmitHandler: F,
-    error: h,
+  }), s = V(), y = s.isPending, {
+    baseSubmitHandler: B,
+    error: F,
     setError: C
-  } = Q("ContractorBankAccountForm"), p = K([u], {
-    submitError: h,
+  } = K("ContractorBankAccountForm"), d = z([u], {
+    submitError: F,
     setSubmitError: C
-  }), S = g.map((e) => ({ value: e, label: e })), c = G(y, n.control), T = {
-    name: c.name,
-    routingNumber: c.routingNumber,
-    accountNumber: c.accountNumber,
-    accountType: z(c.accountType, S, [
-      ...g
-    ])
-  }, M = async () => {
-    let e;
-    return await new Promise((f) => {
-      n.handleSubmit(
-        async (v) => {
-          await F(v, async (a) => {
-            const l = await b.mutateAsync({
+  }), h = x(k, c.control), M = Y(h), S = async () => {
+    let b;
+    return await new Promise((l) => {
+      c.handleSubmit(
+        async (w) => {
+          await B(w, async (a) => {
+            const p = await s.mutateAsync({
               request: {
-                contractorUuid: m,
+                contractorUuid: o,
                 contractorBankAccountCreateRequestBody: {
                   name: a.name,
                   routingNumber: a.routingNumber,
@@ -73,33 +77,33 @@ function at({
                 }
               }
             });
-            if (!l.contractorBankAccount)
-              throw new Y("Bank account creation failed");
-            e = { mode: "create", data: l.contractorBankAccount };
-          }), f();
+            if (!p.contractorBankAccount)
+              throw new Q("Bank account creation failed");
+            b = { mode: "create", data: p.contractorBankAccount };
+          }), l();
         },
         () => {
-          f();
+          l();
         }
       )();
-    }), e;
-  }, w = I(n);
-  return u.isLoading ? { isLoading: !0, errorHandling: p } : {
+    }), b;
+  }, T = G(c);
+  return u.isLoading ? { isLoading: !0, errorHandling: d } : {
     isLoading: !1,
-    data: { bankAccount: t },
-    status: { isPending: B, mode: "create" },
-    actions: { onSubmit: M },
-    errorHandling: p,
+    data: { bankAccount: e },
+    status: { isPending: y, mode: "create" },
+    actions: { onSubmit: S },
+    errorHandling: d,
     form: {
       Fields: {
-        Name: x,
-        RoutingNumber: U,
-        AccountNumber: R,
-        AccountType: O
+        Name: U,
+        RoutingNumber: R,
+        AccountNumber: O,
+        AccountType: L
       },
-      fieldsMetadata: T,
-      hookFormInternals: w,
-      getFormSubmissionValues: q(n, s)
+      fieldsMetadata: M,
+      hookFormInternals: T,
+      getFormSubmissionValues: I(c, m)
     }
   };
 }

package/dist/components/Contractor/PaymentMethod/shared/useContractorBankAccountForm/useContractorBankAccountForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"useContractorBankAccountForm.js","sources":["../../../../../../src/components/Contractor/PaymentMethod/shared/useContractorBankAccountForm/useContractorBankAccountForm.tsx"],"sourcesContent":["import type { ComponentType } from 'react'\nimport { useMemo } from 'react'\nimport { useForm } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { ContractorBankAccount } from '@gusto/embedded-api-v-2025-11-15/models/components/contractorbankaccount'\nimport { useContractorPaymentMethodGetBankAccounts } from '@gusto/embedded-api-v-2025-11-15/react-query/contractorPaymentMethodGetBankAccounts'\nimport { useContractorPaymentMethodsCreateBankAccountMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/contractorPaymentMethodsCreateBankAccount'\nimport {\n  ACCOUNT_TYPES,\n  createContractorBankAccountSchema,\n  type ContractorAccountType,\n  type ContractorBankAccountFormData,\n  type ContractorBankAccountFormOutputs,\n  type ContractorBankAccountOptionalFieldsToRequire,\n} from './useContractorBankAccountFormSchema'\nimport type {\n  AccountNumberFieldProps,\n  AccountTypeFieldProps,\n  NameFieldProps,\n  RoutingNumberFieldProps,\n} from './fields'\nimport { AccountNumberField, AccountTypeField, NameField, RoutingNumberField } from './fields'\nimport { useDeriveFieldsMetadata } from '@/partner-hook-utils/form/useDeriveFieldsMetadata'\nimport { useHookFormInternals } from '@/partner-hook-utils/form/useHookFormInternals'\nimport { createGetFormSubmissionValues } from '@/partner-hook-utils/form/getFormSubmissionValues'\nimport { withOptions } from '@/partner-hook-utils/form/withOptions'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type {\n  BaseFormHookReady,\n  FieldsMetadata,\n  HookLoadingResult,\n  HookSubmitResult,\n} from '@/partner-hook-utils/types'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { SDKInternalError } from '@/types/sdkError'\n\n/**\n * Props for {@link useContractorBankAccountForm}.\n *\n * @public\n */\nexport interface UseContractorBankAccountFormProps {\n  /** Contractor for whom to create the bank account. */\n  contractorId: string\n  /** Override optional fields to be required. */\n  optionalFieldsToRequire?: ContractorBankAccountOptionalFieldsToRequire\n  /** Pre-fill form values. The contractor's existing bank account is used when no override is supplied. */\n  defaultValues?: Partial<ContractorBankAccountFormData>\n  /** When validation runs. Passed through to react-hook-form. Defaults to `'onSubmit'`. */\n  validationMode?: UseFormProps['mode']\n  /** Auto-focus the first invalid field on submit. Set to `false` when using `composeSubmitHandler`. Defaults to `true`. */\n  shouldFocusError?: boolean\n}\n\n/**\n * Field components exposed by {@link useContractorBankAccountForm} on `form.Fields`.\n *\n * @public\n */\nexport interface ContractorBankAccountFormFields {\n  /** Bound to `name`. Captures the bank account nickname. */\n  Name: ComponentType<NameFieldProps>\n  /** Bound to `routingNumber`. Validated against a 9-digit numeric pattern. */\n  RoutingNumber: ComponentType<RoutingNumberFieldProps>\n  /**\n   * Bound to `accountNumber`. Pre-filled with the masked account number (e.g.\n   * \"XXXX1207\"), which is accepted unchanged to keep the existing account; a\n   * newly entered value is validated against the 1–17 digit numeric pattern.\n   */\n  AccountNumber: ComponentType<AccountNumberFieldProps>\n  /**\n   * Bound to `accountType`. Options are `Checking` and `Savings`; defaults to\n   * `Checking`. Supply `getOptionLabel` to translate the option labels.\n   */\n  AccountType: ComponentType<AccountTypeFieldProps>\n}\n\n/**\n * Ready-state return value of {@link useContractorBankAccountForm}.\n *\n * @public\n */\nexport interface UseContractorBankAccountFormReady extends BaseFormHookReady<\n  FieldsMetadata,\n  ContractorBankAccountFormData,\n  ContractorBankAccountFormFields\n> {\n  /** The contractor's current bank account, loaded from the API, if any. */\n  data: {\n    bankAccount: ContractorBankAccount | undefined\n  }\n  /** `isPending` reflects the in-flight create mutation; `mode` is always `'create'`. */\n  status: { isPending: boolean; mode: 'create' }\n  /** Submit the form. Returns the created bank account on success or `undefined` on validation/mutation failure. */\n  actions: {\n    onSubmit: () => Promise<HookSubmitResult<ContractorBankAccount> | undefined>\n  }\n}\n\n/**\n * Headless React Hook Form hook for creating a contractor's bank account.\n *\n * @remarks\n * Captures the account nickname, routing number, account number, and account\n * type. Creating a bank account also updates the contractor's payment method to\n * Direct Deposit on the Gusto API as a side-effect, so the Direct Deposit path\n * needs only this submit — no separate payment method update.\n *\n * When the contractor already has a bank account on file, the account number\n * field is pre-filled with the masked token the API returns (e.g. \"XXXX1207\").\n * The API requires `account_number` on every write and treats that exact masked\n * value as \"keep the existing account,\" so submitting it unchanged preserves the\n * account while still applying any name/routing/type edits; typing a real number\n * replaces it.\n *\n * @param props - See {@link UseContractorBankAccountFormProps}.\n * @returns A loading-state result while data loads, or a {@link UseContractorBankAccountFormReady} once ready.\n * @public\n *\n * @example\n * ```tsx\n * import { useContractorBankAccountForm, SDKFormProvider } from '@gusto/embedded-react-sdk'\n *\n * function AddBankAccount({ contractorId }: { contractorId: string }) {\n *   const bankForm = useContractorBankAccountForm({ contractorId })\n *\n *   if (bankForm.isLoading) return null\n *   const { Fields } = bankForm.form\n *\n *   return (\n *     <SDKFormProvider formHookResult={bankForm}>\n *       <form\n *         onSubmit={e => {\n *           e.preventDefault()\n *           void bankForm.actions.onSubmit()\n *         }}\n *       >\n *         <Fields.Name label=\"Account nickname\" />\n *         <Fields.RoutingNumber label=\"Routing number\" />\n *         <Fields.AccountNumber label=\"Account number\" />\n *         <Fields.AccountType label=\"Account type\" />\n *         <button type=\"submit\" disabled={bankForm.status.isPending}>Save</button>\n *       </form>\n *     </SDKFormProvider>\n *   )\n * }\n * ```\n */\nexport function useContractorBankAccountForm({\n  contractorId,\n  optionalFieldsToRequire,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseContractorBankAccountFormProps): HookLoadingResult | UseContractorBankAccountFormReady {\n  const bankAccountsQuery = useContractorPaymentMethodGetBankAccounts({\n    contractorUuid: contractorId,\n  })\n  const bankAccount = bankAccountsQuery.data?.contractorBankAccountList?.[0] ?? undefined\n\n  const existingAccountNumberMask = bankAccount?.hiddenAccountNumber ?? undefined\n\n  const [schema, metadataConfig] = useMemo(\n    () =>\n      createContractorBankAccountSchema({\n        optionalFieldsToRequire,\n        existingAccountNumberMask,\n      }),\n    [optionalFieldsToRequire, existingAccountNumberMask],\n  )\n\n  // The account number is seeded with the masked token the API returns (e.g.\n  // \"XXXX1207\"). The bank account API requires account_number on every write\n  // and treats that exact masked value as \"keep the existing account,\" so\n  // submitting it unchanged preserves the account; typing a new number replaces it.\n  const resolvedDefaults: ContractorBankAccountFormData = useMemo(\n    () => ({\n      name: partnerDefaults?.name ?? bankAccount?.name ?? '',\n      routingNumber: partnerDefaults?.routingNumber ?? bankAccount?.routingNumber ?? '',\n      accountNumber: partnerDefaults?.accountNumber ?? existingAccountNumberMask ?? '',\n      accountType: (partnerDefaults?.accountType ??\n        bankAccount?.accountType ??\n        'Checking') as ContractorAccountType,\n    }),\n    [partnerDefaults, bankAccount, existingAccountNumberMask],\n  )\n\n  const formMethods = useForm<\n    ContractorBankAccountFormData,\n    unknown,\n    ContractorBankAccountFormOutputs\n  >({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const createMutation = useContractorPaymentMethodsCreateBankAccountMutation()\n  const isPending = createMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('ContractorBankAccountForm')\n\n  const errorHandling = composeErrorHandler([bankAccountsQuery], {\n    submitError,\n    setSubmitError,\n  })\n\n  const accountTypeOptions = ACCOUNT_TYPES.map(value => ({ value, label: value }))\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const fieldsMetadata = {\n    name: baseMetadata.name,\n    routingNumber: baseMetadata.routingNumber,\n    accountNumber: baseMetadata.accountNumber,\n    accountType: withOptions<ContractorAccountType>(baseMetadata.accountType, accountTypeOptions, [\n      ...ACCOUNT_TYPES,\n    ]),\n  }\n\n  const onSubmit = async (): Promise<HookSubmitResult<ContractorBankAccount> | undefined> => {\n    let submitResult: HookSubmitResult<ContractorBankAccount> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: ContractorBankAccountFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const response = await createMutation.mutateAsync({\n              request: {\n                contractorUuid: contractorId,\n                contractorBankAccountCreateRequestBody: {\n                  name: payload.name,\n                  routingNumber: payload.routingNumber,\n                  accountNumber: payload.accountNumber,\n                  accountType: payload.accountType,\n                },\n              },\n            })\n\n            if (!response.contractorBankAccount) {\n              throw new SDKInternalError('Bank account creation failed')\n            }\n\n            submitResult = { mode: 'create' as const, data: response.contractorBankAccount }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  if (bankAccountsQuery.isLoading) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: { bankAccount },\n    status: { isPending, mode: 'create' as const },\n    actions: { onSubmit },\n    errorHandling,\n    form: {\n      Fields: {\n        Name: NameField,\n        RoutingNumber: RoutingNumberField,\n        AccountNumber: AccountNumberField,\n        AccountType: AccountTypeField,\n      },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\n/**\n * Return type of {@link useContractorBankAccountForm} — a discriminated union on `isLoading`.\n *\n * @public\n */\nexport type UseContractorBankAccountFormResult =\n  HookLoadingResult | UseContractorBankAccountFormReady\n\n/**\n * Per-field metadata exposed on `form.fieldsMetadata` for {@link useContractorBankAccountForm}.\n *\n * @public\n */\nexport type ContractorBankAccountFieldsMetadata =\n  UseContractorBankAccountFormReady['form']['fieldsMetadata']\n"],"names":["useContractorBankAccountForm","contractorId","optionalFieldsToRequire","partnerDefaults","validationMode","shouldFocusError","bankAccountsQuery","useContractorPaymentMethodGetBankAccounts","bankAccount","existingAccountNumberMask","schema","metadataConfig","useMemo","createContractorBankAccountSchema","resolvedDefaults","formMethods","useForm","zodResolver","createMutation","useContractorPaymentMethodsCreateBankAccountMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","accountTypeOptions","ACCOUNT_TYPES","value","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","withOptions","onSubmit","submitResult","resolve","data","payload","response","SDKInternalError","hookFormInternals","useHookFormInternals","NameField","RoutingNumberField","AccountNumberField","AccountTypeField","createGetFormSubmissionValues"],"mappings":"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"}
+{"version":3,"file":"useContractorBankAccountForm.js","sources":["../../../../../../src/components/Contractor/PaymentMethod/shared/useContractorBankAccountForm/useContractorBankAccountForm.tsx"],"sourcesContent":["import type { ComponentType } from 'react'\nimport { useMemo } from 'react'\nimport { useForm } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { ContractorBankAccount } from '@gusto/embedded-api-v-2026-02-01/models/components/contractorbankaccount'\nimport { useContractorPaymentMethodGetBankAccounts } from '@gusto/embedded-api-v-2026-02-01/react-query/contractorPaymentMethodGetBankAccounts'\nimport { useContractorPaymentMethodsCreateBankAccountMutation } from '@gusto/embedded-api-v-2026-02-01/react-query/contractorPaymentMethodsCreateBankAccount'\nimport {\n  ACCOUNT_TYPES,\n  createContractorBankAccountSchema,\n  type ContractorAccountType,\n  type ContractorBankAccountFormData,\n  type ContractorBankAccountFormOutputs,\n  type ContractorBankAccountOptionalFieldsToRequire,\n} from './useContractorBankAccountFormSchema'\nimport type {\n  AccountNumberFieldProps,\n  AccountTypeFieldProps,\n  NameFieldProps,\n  RoutingNumberFieldProps,\n} from './fields'\nimport { AccountNumberField, AccountTypeField, NameField, RoutingNumberField } from './fields'\nimport { useDeriveFieldsMetadata } from '@/partner-hook-utils/form/useDeriveFieldsMetadata'\nimport { useHookFormInternals } from '@/partner-hook-utils/form/useHookFormInternals'\nimport { createGetFormSubmissionValues } from '@/partner-hook-utils/form/getFormSubmissionValues'\nimport { withOptions } from '@/partner-hook-utils/form/withOptions'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type {\n  BaseFormHookReady,\n  FieldMetadata,\n  FieldsMetadata,\n  HookLoadingResult,\n  HookSubmitResult,\n} from '@/partner-hook-utils/types'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { SDKInternalError } from '@/types/sdkError'\n\n/**\n * Props for {@link useContractorBankAccountForm}.\n *\n * @public\n */\nexport interface UseContractorBankAccountFormProps {\n  /** Contractor for whom to create the bank account. */\n  contractorId: string\n  /** Override optional fields to be required. */\n  optionalFieldsToRequire?: ContractorBankAccountOptionalFieldsToRequire\n  /** Pre-fill form values. The contractor's existing bank account is used when no override is supplied. */\n  defaultValues?: Partial<ContractorBankAccountFormData>\n  /** When validation runs. Passed through to react-hook-form. Defaults to `'onSubmit'`. */\n  validationMode?: UseFormProps['mode']\n  /** Auto-focus the first invalid field on submit. Set to `false` when using `composeSubmitHandler`. Defaults to `true`. */\n  shouldFocusError?: boolean\n}\n\n/**\n * Field components exposed by {@link useContractorBankAccountForm} on `form.Fields`.\n *\n * @public\n */\nexport interface ContractorBankAccountFormFields {\n  /** Bound to `name`. Captures the bank account nickname. */\n  Name: ComponentType<NameFieldProps>\n  /** Bound to `routingNumber`. Validated against a 9-digit numeric pattern. */\n  RoutingNumber: ComponentType<RoutingNumberFieldProps>\n  /**\n   * Bound to `accountNumber`. Pre-filled with the masked account number (e.g.\n   * \"XXXX1207\"), which is accepted unchanged to keep the existing account; a\n   * newly entered value is validated against the 1–17 digit numeric pattern.\n   */\n  AccountNumber: ComponentType<AccountNumberFieldProps>\n  /**\n   * Bound to `accountType`. Options are `Checking` and `Savings`; defaults to\n   * `Checking`. Supply `getOptionLabel` to translate the option labels.\n   */\n  AccountType: ComponentType<AccountTypeFieldProps>\n}\n\n/**\n * Ready-state return value of {@link useContractorBankAccountForm}.\n *\n * @public\n */\nexport interface UseContractorBankAccountFormReady extends BaseFormHookReady<\n  ContractorBankAccountFieldsMetadata,\n  ContractorBankAccountFormData,\n  ContractorBankAccountFormFields\n> {\n  /** The contractor's current bank account, loaded from the API, if any. */\n  data: {\n    bankAccount: ContractorBankAccount | undefined\n  }\n  /** `isPending` reflects the in-flight create mutation; `mode` is always `'create'`. */\n  status: { isPending: boolean; mode: 'create' }\n  /** Submit the form. Returns the created bank account on success or `undefined` on validation/mutation failure. */\n  actions: {\n    onSubmit: () => Promise<HookSubmitResult<ContractorBankAccount> | undefined>\n  }\n}\n\n/** @internal */\nfunction buildContractorBankAccountFieldsMetadata(\n  base: Record<keyof ContractorBankAccountFormData, FieldMetadata>,\n) {\n  const accountTypeOptions = ACCOUNT_TYPES.map(value => ({ value, label: value }))\n  return {\n    name: base.name,\n    routingNumber: base.routingNumber,\n    accountNumber: base.accountNumber,\n    accountType: withOptions<ContractorAccountType>(base.accountType, accountTypeOptions, [\n      ...ACCOUNT_TYPES,\n    ]),\n  } satisfies FieldsMetadata\n}\n\n/**\n * Headless React Hook Form hook for creating a contractor's bank account.\n *\n * @remarks\n * Captures the account nickname, routing number, account number, and account\n * type. Creating a bank account also updates the contractor's payment method to\n * Direct Deposit on the Gusto API as a side-effect, so the Direct Deposit path\n * needs only this submit — no separate payment method update.\n *\n * When the contractor already has a bank account on file, the account number\n * field is pre-filled with the masked token the API returns (e.g. \"XXXX1207\").\n * The API requires `account_number` on every write and treats that exact masked\n * value as \"keep the existing account,\" so submitting it unchanged preserves the\n * account while still applying any name/routing/type edits; typing a real number\n * replaces it.\n *\n * @param props - See {@link UseContractorBankAccountFormProps}.\n * @returns A loading-state result while data loads, or a {@link UseContractorBankAccountFormReady} once ready.\n * @public\n *\n * @example\n * ```tsx\n * import { useContractorBankAccountForm, SDKFormProvider } from '@gusto/embedded-react-sdk'\n *\n * function AddBankAccount({ contractorId }: { contractorId: string }) {\n *   const bankForm = useContractorBankAccountForm({ contractorId })\n *\n *   if (bankForm.isLoading) return null\n *   const { Fields } = bankForm.form\n *\n *   return (\n *     <SDKFormProvider formHookResult={bankForm}>\n *       <form\n *         onSubmit={e => {\n *           e.preventDefault()\n *           void bankForm.actions.onSubmit()\n *         }}\n *       >\n *         <Fields.Name label=\"Account nickname\" />\n *         <Fields.RoutingNumber label=\"Routing number\" />\n *         <Fields.AccountNumber label=\"Account number\" />\n *         <Fields.AccountType label=\"Account type\" />\n *         <button type=\"submit\" disabled={bankForm.status.isPending}>Save</button>\n *       </form>\n *     </SDKFormProvider>\n *   )\n * }\n * ```\n */\nexport function useContractorBankAccountForm({\n  contractorId,\n  optionalFieldsToRequire,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseContractorBankAccountFormProps): HookLoadingResult | UseContractorBankAccountFormReady {\n  const bankAccountsQuery = useContractorPaymentMethodGetBankAccounts({\n    contractorUuid: contractorId,\n  })\n  const bankAccount = bankAccountsQuery.data?.contractorBankAccountList?.[0] ?? undefined\n\n  const existingAccountNumberMask = bankAccount?.hiddenAccountNumber ?? undefined\n\n  const [schema, metadataConfig] = useMemo(\n    () =>\n      createContractorBankAccountSchema({\n        optionalFieldsToRequire,\n        existingAccountNumberMask,\n      }),\n    [optionalFieldsToRequire, existingAccountNumberMask],\n  )\n\n  // The account number is seeded with the masked token the API returns (e.g.\n  // \"XXXX1207\"). The bank account API requires account_number on every write\n  // and treats that exact masked value as \"keep the existing account,\" so\n  // submitting it unchanged preserves the account; typing a new number replaces it.\n  const resolvedDefaults: ContractorBankAccountFormData = useMemo(\n    () => ({\n      name: partnerDefaults?.name ?? bankAccount?.name ?? '',\n      routingNumber: partnerDefaults?.routingNumber ?? bankAccount?.routingNumber ?? '',\n      accountNumber: partnerDefaults?.accountNumber ?? existingAccountNumberMask ?? '',\n      accountType: (partnerDefaults?.accountType ??\n        bankAccount?.accountType ??\n        'Checking') as ContractorAccountType,\n    }),\n    [partnerDefaults, bankAccount, existingAccountNumberMask],\n  )\n\n  const formMethods = useForm<\n    ContractorBankAccountFormData,\n    unknown,\n    ContractorBankAccountFormOutputs\n  >({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const createMutation = useContractorPaymentMethodsCreateBankAccountMutation()\n  const isPending = createMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('ContractorBankAccountForm')\n\n  const errorHandling = composeErrorHandler([bankAccountsQuery], {\n    submitError,\n    setSubmitError,\n  })\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const fieldsMetadata = buildContractorBankAccountFieldsMetadata(baseMetadata)\n\n  const onSubmit = async (): Promise<HookSubmitResult<ContractorBankAccount> | undefined> => {\n    let submitResult: HookSubmitResult<ContractorBankAccount> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: ContractorBankAccountFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const response = await createMutation.mutateAsync({\n              request: {\n                contractorUuid: contractorId,\n                contractorBankAccountCreateRequestBody: {\n                  name: payload.name,\n                  routingNumber: payload.routingNumber,\n                  accountNumber: payload.accountNumber,\n                  accountType: payload.accountType,\n                },\n              },\n            })\n\n            if (!response.contractorBankAccount) {\n              throw new SDKInternalError('Bank account creation failed')\n            }\n\n            submitResult = { mode: 'create' as const, data: response.contractorBankAccount }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  if (bankAccountsQuery.isLoading) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: { bankAccount },\n    status: { isPending, mode: 'create' as const },\n    actions: { onSubmit },\n    errorHandling,\n    form: {\n      Fields: {\n        Name: NameField,\n        RoutingNumber: RoutingNumberField,\n        AccountNumber: AccountNumberField,\n        AccountType: AccountTypeField,\n      },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\n/**\n * Return type of {@link useContractorBankAccountForm} — a discriminated union on `isLoading`.\n *\n * @public\n */\nexport type UseContractorBankAccountFormResult =\n  HookLoadingResult | UseContractorBankAccountFormReady\n\n/**\n * Per-field metadata exposed on `form.fieldsMetadata` for {@link useContractorBankAccountForm}.\n *\n * @public\n */\nexport type ContractorBankAccountFieldsMetadata = ReturnType<\n  typeof buildContractorBankAccountFieldsMetadata\n>\n"],"names":["buildContractorBankAccountFieldsMetadata","base","accountTypeOptions","ACCOUNT_TYPES","value","withOptions","useContractorBankAccountForm","contractorId","optionalFieldsToRequire","partnerDefaults","validationMode","shouldFocusError","bankAccountsQuery","useContractorPaymentMethodGetBankAccounts","bankAccount","existingAccountNumberMask","schema","metadataConfig","useMemo","createContractorBankAccountSchema","resolvedDefaults","formMethods","useForm","zodResolver","createMutation","useContractorPaymentMethodsCreateBankAccountMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","onSubmit","submitResult","resolve","data","payload","response","SDKInternalError","hookFormInternals","useHookFormInternals","NameField","RoutingNumberField","AccountNumberField","AccountTypeField","createGetFormSubmissionValues"],"mappings":"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"}

package/dist/components/Contractor/PaymentMethod/shared/useContractorBankAccountForm/useContractorBankAccountFormSchema.d.ts

@@ -36,7 +36,7 @@ export type ContractorAccountType = (typeof ACCOUNT_TYPES)[number];
  *
  * @public
  */
-export type ContractorBankAccountFormField = "name" | "routingNumber" | "accountNumber" | "accountType";
+export type ContractorBankAccountFormField = "name" | "accountNumber" | "routingNumber" | "accountType";
 /**
  * Shape of the values managed by the contractor bank account form.
  *
@@ -46,9 +46,11 @@ export type ContractorBankAccountFormField = "name" | "routingNumber" | "account
 export type ContractorBankAccountFormData = { name: string; routingNumber: string; accountNumber: string; accountType: "Checking" | "Savings"; };
 /**
  * Shape of the validated values produced by the contractor bank account form on
- * submit.
+ * submit. Internal seam between the form's input and parsed-output types; the
+ * two coincide today, and partners consume the parsed values through
+ * `form.getFormSubmissionValues` (typed as the form-data shape).
  *
- * @public
+ * @internal
  */
 export type ContractorBankAccountFormOutputs = ContractorBankAccountFormData;
 /**

package/dist/components/Contractor/PaymentMethod/shared/useContractorBankAccountForm/useContractorBankAccountFormSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"useContractorBankAccountFormSchema.js","sources":["../../../../../../src/components/Contractor/PaymentMethod/shared/useContractorBankAccountForm/useContractorBankAccountFormSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  buildFormSchema,\n  type OptionalFieldsToRequire,\n  type RequiredFieldConfig,\n} from '@/partner-hook-utils/form/buildFormSchema'\nimport { ACCOUNT_NUMBER_REGEX, ROUTING_NUMBER_REGEX } from '@/helpers/validations'\n\n/**\n * Validation error codes emitted by the contractor bank account form schema.\n * Map these codes to localized copy in `validationMessages` when composing the\n * hook.\n *\n * @public\n */\nexport const ContractorBankAccountErrorCodes = {\n  REQUIRED: 'REQUIRED',\n  INVALID_ROUTING_NUMBER: 'INVALID_ROUTING_NUMBER',\n  INVALID_ACCOUNT_NUMBER: 'INVALID_ACCOUNT_NUMBER',\n} as const\n\n/**\n * Union of validation error code strings emitted by the contractor bank account\n * form schema.\n *\n * @public\n */\nexport type ContractorBankAccountErrorCode =\n  (typeof ContractorBankAccountErrorCodes)[keyof typeof ContractorBankAccountErrorCodes]\n\n/**\n * Supported bank account type values: checking and savings.\n *\n * @public\n */\nexport const ACCOUNT_TYPES = ['Checking', 'Savings'] as const\n\n/**\n * Union of bank account type values that the form accepts.\n *\n * @public\n */\nexport type ContractorAccountType = (typeof ACCOUNT_TYPES)[number]\n\nconst fieldValidators = {\n  name: z.string(),\n  routingNumber: z.string().regex(ROUTING_NUMBER_REGEX, {\n    message: ContractorBankAccountErrorCodes.INVALID_ROUTING_NUMBER,\n  }),\n  accountNumber: z.string().regex(ACCOUNT_NUMBER_REGEX, {\n    message: ContractorBankAccountErrorCodes.INVALID_ACCOUNT_NUMBER,\n  }),\n  accountType: z.enum(ACCOUNT_TYPES),\n}\n\n/**\n * Field names accepted by the contractor bank account form.\n *\n * @public\n */\nexport type ContractorBankAccountFormField = keyof typeof fieldValidators\n\n/**\n * Shape of the values managed by the contractor bank account form.\n *\n * @public\n * @interface\n */\nexport type ContractorBankAccountFormData = {\n  [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\n\n/**\n * Shape of the validated values produced by the contractor bank account form on\n * submit.\n *\n * @public\n */\nexport type ContractorBankAccountFormOutputs = ContractorBankAccountFormData\n\nconst requiredFieldsConfig = {\n  name: 'always',\n  routingNumber: 'always',\n  accountNumber: 'always',\n  accountType: 'always',\n} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n/**\n * Keys of optional contractor bank account fields that can be promoted to\n * required via the hook's `optionalFieldsToRequire` option.\n *\n * @public\n */\nexport type ContractorBankAccountOptionalFieldsToRequire = OptionalFieldsToRequire<\n  typeof requiredFieldsConfig\n>\n\n/** @internal */\ninterface ContractorBankAccountSchemaOptions {\n  optionalFieldsToRequire?: ContractorBankAccountOptionalFieldsToRequire\n  /**\n   * The contractor's current masked account number (e.g. `\"XXXX1207\"`), if one\n   * is on file. The bank account API requires `account_number` on every write\n   * and treats this exact masked token as \"keep the existing account number,\"\n   * so the field is pre-filled with it and validation accepts it unchanged. Any\n   * other value must be a real 1–17 digit account number.\n   */\n  existingAccountNumberMask?: string\n}\n\n/** @internal */\nexport function createContractorBankAccountSchema(\n  options: ContractorBankAccountSchemaOptions = {},\n) {\n  const { optionalFieldsToRequire, existingAccountNumberMask } = options\n\n  const accountNumber = existingAccountNumberMask\n    ? z\n        .string()\n        .refine(value => value === existingAccountNumberMask || ACCOUNT_NUMBER_REGEX.test(value), {\n          message: ContractorBankAccountErrorCodes.INVALID_ACCOUNT_NUMBER,\n        })\n    : fieldValidators.accountNumber\n\n  return buildFormSchema(\n    { ...fieldValidators, accountNumber },\n    {\n      requiredFieldsConfig,\n      requiredErrorCode: ContractorBankAccountErrorCodes.REQUIRED,\n      mode: 'create',\n      optionalFieldsToRequire,\n    },\n  )\n}\n"],"names":["ContractorBankAccountErrorCodes","ACCOUNT_TYPES","fieldValidators","z","ROUTING_NUMBER_REGEX","ACCOUNT_NUMBER_REGEX","requiredFieldsConfig","createContractorBankAccountSchema","options","optionalFieldsToRequire","existingAccountNumberMask","accountNumber","value","buildFormSchema"],"mappings":";;;AAeO,MAAMA,IAAkC;AAAA,EAC7C,UAAU;AAAA,EACV,wBAAwB;AAAA,EACxB,wBAAwB;AAC1B,GAgBaC,IAAgB,CAAC,YAAY,SAAS,GAS7CC,IAAkB;AAAA,EACtB,MAAMC,EAAE,OAAA;AAAA,EACR,eAAeA,EAAE,SAAS,MAAMC,GAAsB;AAAA,IACpD,SAASJ,EAAgC;AAAA,EAAA,CAC1C;AAAA,EACD,eAAeG,EAAE,SAAS,MAAME,GAAsB;AAAA,IACpD,SAASL,EAAgC;AAAA,EAAA,CAC1C;AAAA,EACD,aAAaG,EAAE,KAAKF,CAAa;AACnC,GA2BMK,IAAuB;AAAA,EAC3B,MAAM;AAAA,EACN,eAAe;AAAA,EACf,eAAe;AAAA,EACf,aAAa;AACf;AA0BO,SAASC,EACdC,IAA8C,IAC9C;AACA,QAAM,EAAE,yBAAAC,GAAyB,2BAAAC,EAAA,IAA8BF,GAEzDG,IAAgBD,IAClBP,EACG,OAAA,EACA,OAAO,CAAAS,MAASA,MAAUF,KAA6BL,EAAqB,KAAKO,CAAK,GAAG;AAAA,IACxF,SAASZ,EAAgC;AAAA,EAAA,CAC1C,IACHE,EAAgB;AAEpB,SAAOW;AAAA,IACL,EAAE,GAAGX,GAAiB,eAAAS,EAAA;AAAA,IACtB;AAAA,MACE,sBAAAL;AAAA,MACA,mBAAmBN,EAAgC;AAAA,MACnD,MAAM;AAAA,MACN,yBAAAS;AAAA,IAAA;AAAA,EACF;AAEJ;"}
+{"version":3,"file":"useContractorBankAccountFormSchema.js","sources":["../../../../../../src/components/Contractor/PaymentMethod/shared/useContractorBankAccountForm/useContractorBankAccountFormSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  buildFormSchema,\n  type OptionalFieldsToRequire,\n  type RequiredFieldConfig,\n} from '@/partner-hook-utils/form/buildFormSchema'\nimport { ACCOUNT_NUMBER_REGEX, ROUTING_NUMBER_REGEX } from '@/helpers/validations'\n\n/**\n * Validation error codes emitted by the contractor bank account form schema.\n * Map these codes to localized copy in `validationMessages` when composing the\n * hook.\n *\n * @public\n */\nexport const ContractorBankAccountErrorCodes = {\n  REQUIRED: 'REQUIRED',\n  INVALID_ROUTING_NUMBER: 'INVALID_ROUTING_NUMBER',\n  INVALID_ACCOUNT_NUMBER: 'INVALID_ACCOUNT_NUMBER',\n} as const\n\n/**\n * Union of validation error code strings emitted by the contractor bank account\n * form schema.\n *\n * @public\n */\nexport type ContractorBankAccountErrorCode =\n  (typeof ContractorBankAccountErrorCodes)[keyof typeof ContractorBankAccountErrorCodes]\n\n/**\n * Supported bank account type values: checking and savings.\n *\n * @public\n */\nexport const ACCOUNT_TYPES = ['Checking', 'Savings'] as const\n\n/**\n * Union of bank account type values that the form accepts.\n *\n * @public\n */\nexport type ContractorAccountType = (typeof ACCOUNT_TYPES)[number]\n\nconst fieldValidators = {\n  name: z.string(),\n  routingNumber: z.string().regex(ROUTING_NUMBER_REGEX, {\n    message: ContractorBankAccountErrorCodes.INVALID_ROUTING_NUMBER,\n  }),\n  accountNumber: z.string().regex(ACCOUNT_NUMBER_REGEX, {\n    message: ContractorBankAccountErrorCodes.INVALID_ACCOUNT_NUMBER,\n  }),\n  accountType: z.enum(ACCOUNT_TYPES),\n}\n\n/**\n * Field names accepted by the contractor bank account form.\n *\n * @public\n */\nexport type ContractorBankAccountFormField = keyof typeof fieldValidators\n\n/**\n * Shape of the values managed by the contractor bank account form.\n *\n * @public\n * @interface\n */\nexport type ContractorBankAccountFormData = {\n  [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\n\n/**\n * Shape of the validated values produced by the contractor bank account form on\n * submit. Internal seam between the form's input and parsed-output types; the\n * two coincide today, and partners consume the parsed values through\n * `form.getFormSubmissionValues` (typed as the form-data shape).\n *\n * @internal\n */\nexport type ContractorBankAccountFormOutputs = ContractorBankAccountFormData\n\nconst requiredFieldsConfig = {\n  name: 'always',\n  routingNumber: 'always',\n  accountNumber: 'always',\n  accountType: 'always',\n} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n/**\n * Keys of optional contractor bank account fields that can be promoted to\n * required via the hook's `optionalFieldsToRequire` option.\n *\n * @public\n */\nexport type ContractorBankAccountOptionalFieldsToRequire = OptionalFieldsToRequire<\n  typeof requiredFieldsConfig\n>\n\n/** @internal */\ninterface ContractorBankAccountSchemaOptions {\n  optionalFieldsToRequire?: ContractorBankAccountOptionalFieldsToRequire\n  /**\n   * The contractor's current masked account number (e.g. `\"XXXX1207\"`), if one\n   * is on file. The bank account API requires `account_number` on every write\n   * and treats this exact masked token as \"keep the existing account number,\"\n   * so the field is pre-filled with it and validation accepts it unchanged. Any\n   * other value must be a real 1–17 digit account number.\n   */\n  existingAccountNumberMask?: string\n}\n\n/** @internal */\nexport function createContractorBankAccountSchema(\n  options: ContractorBankAccountSchemaOptions = {},\n) {\n  const { optionalFieldsToRequire, existingAccountNumberMask } = options\n\n  const accountNumber = existingAccountNumberMask\n    ? z\n        .string()\n        .refine(value => value === existingAccountNumberMask || ACCOUNT_NUMBER_REGEX.test(value), {\n          message: ContractorBankAccountErrorCodes.INVALID_ACCOUNT_NUMBER,\n        })\n    : fieldValidators.accountNumber\n\n  return buildFormSchema(\n    { ...fieldValidators, accountNumber },\n    {\n      requiredFieldsConfig,\n      requiredErrorCode: ContractorBankAccountErrorCodes.REQUIRED,\n      mode: 'create',\n      optionalFieldsToRequire,\n    },\n  )\n}\n"],"names":["ContractorBankAccountErrorCodes","ACCOUNT_TYPES","fieldValidators","z","ROUTING_NUMBER_REGEX","ACCOUNT_NUMBER_REGEX","requiredFieldsConfig","createContractorBankAccountSchema","options","optionalFieldsToRequire","existingAccountNumberMask","accountNumber","value","buildFormSchema"],"mappings":";;;AAeO,MAAMA,IAAkC;AAAA,EAC7C,UAAU;AAAA,EACV,wBAAwB;AAAA,EACxB,wBAAwB;AAC1B,GAgBaC,IAAgB,CAAC,YAAY,SAAS,GAS7CC,IAAkB;AAAA,EACtB,MAAMC,EAAE,OAAA;AAAA,EACR,eAAeA,EAAE,SAAS,MAAMC,GAAsB;AAAA,IACpD,SAASJ,EAAgC;AAAA,EAAA,CAC1C;AAAA,EACD,eAAeG,EAAE,SAAS,MAAME,GAAsB;AAAA,IACpD,SAASL,EAAgC;AAAA,EAAA,CAC1C;AAAA,EACD,aAAaG,EAAE,KAAKF,CAAa;AACnC,GA6BMK,IAAuB;AAAA,EAC3B,MAAM;AAAA,EACN,eAAe;AAAA,EACf,eAAe;AAAA,EACf,aAAa;AACf;AA0BO,SAASC,EACdC,IAA8C,IAC9C;AACA,QAAM,EAAE,yBAAAC,GAAyB,2BAAAC,EAAA,IAA8BF,GAEzDG,IAAgBD,IAClBP,EACG,OAAA,EACA,OAAO,CAAAS,MAASA,MAAUF,KAA6BL,EAAqB,KAAKO,CAAK,GAAG;AAAA,IACxF,SAASZ,EAAgC;AAAA,EAAA,CAC1C,IACHE,EAAgB;AAEpB,SAAOW;AAAA,IACL,EAAE,GAAGX,GAAiB,eAAAS,EAAA;AAAA,IACtB;AAAA,MACE,sBAAAL;AAAA,MACA,mBAAmBN,EAAgC;AAAA,MACnD,MAAM;AAAA,MACN,yBAAAS;AAAA,IAAA;AAAA,EACF;AAEJ;"}

package/dist/components/Contractor/PaymentMethod/shared/useContractorPaymentMethodForm/contractorPaymentMethodSchema.d.ts

@@ -43,9 +43,11 @@ export type ContractorPaymentMethodFormField = "type";
 export type ContractorPaymentMethodFormData = { type: "Check" | "Direct Deposit"; };
 /**
  * Shape of the validated values produced by the contractor payment method form
- * on submit.
+ * on submit. Internal seam between the form's input and parsed-output types; the
+ * two coincide today, and partners consume the parsed values through
+ * `form.getFormSubmissionValues` (typed as the form-data shape).
  *
- * @public
+ * @internal
  */
 export type ContractorPaymentMethodFormOutputs = ContractorPaymentMethodFormData;
 /** @internal */

package/dist/components/Contractor/PaymentMethod/shared/useContractorPaymentMethodForm/contractorPaymentMethodSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"contractorPaymentMethodSchema.js","sources":["../../../../../../src/components/Contractor/PaymentMethod/shared/useContractorPaymentMethodForm/contractorPaymentMethodSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  buildFormSchema,\n  type RequiredFieldConfig,\n} from '@/partner-hook-utils/form/buildFormSchema'\nimport { PAYMENT_METHODS } from '@/shared/constants'\n\n/**\n * Validation error codes emitted by the contractor payment method form schema.\n * Map these codes to localized copy in `validationMessages` when composing the\n * hook.\n *\n * @public\n */\nexport const ContractorPaymentMethodErrorCodes = {\n  REQUIRED: 'REQUIRED',\n} as const\n\n/**\n * Union of validation error code strings emitted by the contractor payment\n * method form schema.\n *\n * @public\n */\nexport type ContractorPaymentMethodErrorCode =\n  (typeof ContractorPaymentMethodErrorCodes)[keyof typeof ContractorPaymentMethodErrorCodes]\n\n/**\n * Supported payment method type values: direct deposit and check.\n *\n * @public\n */\nexport const PAYMENT_METHOD_TYPES = [PAYMENT_METHODS.directDeposit, PAYMENT_METHODS.check] as const\n\n/**\n * Union of payment method type values that the form accepts.\n *\n * @public\n */\nexport type ContractorPaymentMethodFormType = (typeof PAYMENT_METHOD_TYPES)[number]\n\nconst fieldValidators = {\n  type: z.enum(PAYMENT_METHOD_TYPES),\n}\n\n/**\n * Field names accepted by the contractor payment method form.\n *\n * @public\n */\nexport type ContractorPaymentMethodFormField = keyof typeof fieldValidators\n\n/**\n * Shape of the values managed by the contractor payment method form.\n *\n * @public\n * @interface\n */\nexport type ContractorPaymentMethodFormData = {\n  [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\n\n/**\n * Shape of the validated values produced by the contractor payment method form\n * on submit.\n *\n * @public\n */\nexport type ContractorPaymentMethodFormOutputs = ContractorPaymentMethodFormData\n\nconst requiredFieldsConfig = {} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n/** @internal */\nexport function createContractorPaymentMethodSchema() {\n  return buildFormSchema(fieldValidators, {\n    requiredFieldsConfig,\n    requiredErrorCode: ContractorPaymentMethodErrorCodes.REQUIRED,\n    mode: 'update',\n  })\n}\n"],"names":["ContractorPaymentMethodErrorCodes","PAYMENT_METHOD_TYPES","PAYMENT_METHODS","fieldValidators","z","requiredFieldsConfig","createContractorPaymentMethodSchema","buildFormSchema"],"mappings":";;;AAcO,MAAMA,IAAoC;AAAA,EAC/C,UAAU;AACZ,GAgBaC,IAAuB,CAACC,EAAgB,eAAeA,EAAgB,KAAK,GASnFC,IAAkB;AAAA,EACtB,MAAMC,EAAE,KAAKH,CAAoB;AACnC,GA2BMI,IAAuB,CAAA;AAGtB,SAASC,IAAsC;AACpD,SAAOC,EAAgBJ,GAAiB;AAAA,IACtC,sBAAAE;AAAA,IACA,mBAAmBL,EAAkC;AAAA,IACrD,MAAM;AAAA,EAAA,CACP;AACH;"}
+{"version":3,"file":"contractorPaymentMethodSchema.js","sources":["../../../../../../src/components/Contractor/PaymentMethod/shared/useContractorPaymentMethodForm/contractorPaymentMethodSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  buildFormSchema,\n  type RequiredFieldConfig,\n} from '@/partner-hook-utils/form/buildFormSchema'\nimport { PAYMENT_METHODS } from '@/shared/constants'\n\n/**\n * Validation error codes emitted by the contractor payment method form schema.\n * Map these codes to localized copy in `validationMessages` when composing the\n * hook.\n *\n * @public\n */\nexport const ContractorPaymentMethodErrorCodes = {\n  REQUIRED: 'REQUIRED',\n} as const\n\n/**\n * Union of validation error code strings emitted by the contractor payment\n * method form schema.\n *\n * @public\n */\nexport type ContractorPaymentMethodErrorCode =\n  (typeof ContractorPaymentMethodErrorCodes)[keyof typeof ContractorPaymentMethodErrorCodes]\n\n/**\n * Supported payment method type values: direct deposit and check.\n *\n * @public\n */\nexport const PAYMENT_METHOD_TYPES = [PAYMENT_METHODS.directDeposit, PAYMENT_METHODS.check] as const\n\n/**\n * Union of payment method type values that the form accepts.\n *\n * @public\n */\nexport type ContractorPaymentMethodFormType = (typeof PAYMENT_METHOD_TYPES)[number]\n\nconst fieldValidators = {\n  type: z.enum(PAYMENT_METHOD_TYPES),\n}\n\n/**\n * Field names accepted by the contractor payment method form.\n *\n * @public\n */\nexport type ContractorPaymentMethodFormField = keyof typeof fieldValidators\n\n/**\n * Shape of the values managed by the contractor payment method form.\n *\n * @public\n * @interface\n */\nexport type ContractorPaymentMethodFormData = {\n  [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\n\n/**\n * Shape of the validated values produced by the contractor payment method form\n * on submit. Internal seam between the form's input and parsed-output types; the\n * two coincide today, and partners consume the parsed values through\n * `form.getFormSubmissionValues` (typed as the form-data shape).\n *\n * @internal\n */\nexport type ContractorPaymentMethodFormOutputs = ContractorPaymentMethodFormData\n\nconst requiredFieldsConfig = {} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n/** @internal */\nexport function createContractorPaymentMethodSchema() {\n  return buildFormSchema(fieldValidators, {\n    requiredFieldsConfig,\n    requiredErrorCode: ContractorPaymentMethodErrorCodes.REQUIRED,\n    mode: 'update',\n  })\n}\n"],"names":["ContractorPaymentMethodErrorCodes","PAYMENT_METHOD_TYPES","PAYMENT_METHODS","fieldValidators","z","requiredFieldsConfig","createContractorPaymentMethodSchema","buildFormSchema"],"mappings":";;;AAcO,MAAMA,IAAoC;AAAA,EAC/C,UAAU;AACZ,GAgBaC,IAAuB,CAACC,EAAgB,eAAeA,EAAgB,KAAK,GASnFC,IAAkB;AAAA,EACtB,MAAMC,EAAE,KAAKH,CAAoB;AACnC,GA6BMI,IAAuB,CAAA;AAGtB,SAASC,IAAsC;AACpD,SAAOC,EAAgBJ,GAAiB;AAAA,IACtC,sBAAAE;AAAA,IACA,mBAAmBL,EAAkC;AAAA,IACrD,MAAM;AAAA,EAAA,CACP;AACH;"}

package/dist/components/Contractor/PaymentMethod/shared/useContractorPaymentMethodForm/fields.d.ts

@@ -7,14 +7,5 @@ import { HookFieldProps } from '../../../../../partner-hook-utils/types';
  * @public
  */
 export type TypeFieldProps = HookFieldProps<RadioGroupHookFieldProps<never, ContractorPaymentMethodFormType>>;
-/**
- * Radio group bound to the `type` field of {@link useContractorPaymentMethodForm}.
- *
- * @remarks
- * Surfaced to partners as `form.Fields.Type`; see {@link ContractorPaymentMethodFormFields}.
- *
- * @param props - See {@link TypeFieldProps}.
- * @returns The rendered radio group bound to `type`.
- * @internal
- */
+/** @internal */
 export declare function TypeField(props: TypeFieldProps): import("react").JSX.Element;

package/dist/components/Contractor/PaymentMethod/shared/useContractorPaymentMethodForm/fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Contractor/PaymentMethod/shared/useContractorPaymentMethodForm/fields.tsx"],"sourcesContent":["import type { ContractorPaymentMethodFormType } from './contractorPaymentMethodSchema'\nimport type { RadioGroupHookFieldProps } from '@/partner-hook-utils/form/fields/RadioGroupHookField'\nimport { RadioGroupHookField } from '@/partner-hook-utils/form/fields'\nimport type { HookFieldProps } from '@/partner-hook-utils/types'\n\n/**\n * Props accepted by {@link useContractorPaymentMethodForm}'s `Fields.Type` component.\n *\n * @public\n */\nexport type TypeFieldProps = HookFieldProps<\n  RadioGroupHookFieldProps<never, ContractorPaymentMethodFormType>\n>\n\n/**\n * Radio group bound to the `type` field of {@link useContractorPaymentMethodForm}.\n *\n * @remarks\n * Surfaced to partners as `form.Fields.Type`; see {@link ContractorPaymentMethodFormFields}.\n *\n * @param props - See {@link TypeFieldProps}.\n * @returns The rendered radio group bound to `type`.\n * @internal\n */\nexport function TypeField(props: TypeFieldProps) {\n  return <RadioGroupHookField {...props} name=\"type\" />\n}\n"],"names":["TypeField","props","jsx","RadioGroupHookField"],"mappings":";;AAwBO,SAASA,EAAUC,GAAuB;AAC/C,SAAO,gBAAAC,EAACC,GAAA,EAAqB,GAAGF,GAAO,MAAK,QAAO;AACrD;"}
+{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Contractor/PaymentMethod/shared/useContractorPaymentMethodForm/fields.tsx"],"sourcesContent":["import type { ContractorPaymentMethodFormType } from './contractorPaymentMethodSchema'\nimport type { RadioGroupHookFieldProps } from '@/partner-hook-utils/form/fields/RadioGroupHookField'\nimport { RadioGroupHookField } from '@/partner-hook-utils/form/fields'\nimport type { HookFieldProps } from '@/partner-hook-utils/types'\n\n/**\n * Props accepted by {@link useContractorPaymentMethodForm}'s `Fields.Type` component.\n *\n * @public\n */\nexport type TypeFieldProps = HookFieldProps<\n  RadioGroupHookFieldProps<never, ContractorPaymentMethodFormType>\n>\n\n/** @internal */\nexport function TypeField(props: TypeFieldProps) {\n  return <RadioGroupHookField {...props} name=\"type\" />\n}\n"],"names":["TypeField","props","jsx","RadioGroupHookField"],"mappings":";;AAeO,SAASA,EAAUC,GAAuB;AAC/C,SAAO,gBAAAC,EAACC,GAAA,EAAqB,GAAGF,GAAO,MAAK,QAAO;AACrD;"}

package/dist/components/Contractor/PaymentMethod/shared/useContractorPaymentMethodForm/index.d.ts

@@ -1,5 +1,4 @@
-import "./types/i18next.d.ts"
 export { useContractorPaymentMethodForm } from './useContractorPaymentMethodForm';
 export type { UseContractorPaymentMethodFormProps, UseContractorPaymentMethodFormResult, UseContractorPaymentMethodFormReady, ContractorPaymentMethodFormFields, ContractorPaymentMethodFieldsMetadata, } from './useContractorPaymentMethodForm';
-export { ContractorPaymentMethodErrorCodes, PAYMENT_METHOD_TYPES, createContractorPaymentMethodSchema, type ContractorPaymentMethodErrorCode, type ContractorPaymentMethodFormType, type ContractorPaymentMethodFormData, type ContractorPaymentMethodFormOutputs, type ContractorPaymentMethodFormField, } from './contractorPaymentMethodSchema';
+export { ContractorPaymentMethodErrorCodes, type ContractorPaymentMethodErrorCode, type ContractorPaymentMethodFormType, type ContractorPaymentMethodFormData, type ContractorPaymentMethodFormField, } from './contractorPaymentMethodSchema';
 export { type TypeFieldProps } from './fields';

package/dist/components/Contractor/PaymentMethod/shared/useContractorPaymentMethodForm/useContractorPaymentMethodForm.d.ts

@@ -1,9 +1,9 @@
 import { ComponentType } from 'react';
 import { UseFormProps } from 'react-hook-form';
-import { ContractorPaymentMethod } from '@gusto/embedded-api-v-2025-11-15/models/components/contractorpaymentmethod';
+import { ContractorPaymentMethod } from '@gusto/embedded-api-v-2026-02-01/models/components/contractorpaymentmethod';
 import { ContractorPaymentMethodFormData } from './contractorPaymentMethodSchema';
 import { TypeFieldProps } from './fields';
-import { BaseFormHookReady, FieldsMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
+import { BaseFormHookReady, FieldMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
 /**
  * Props for {@link useContractorPaymentMethodForm}.
  *
@@ -37,7 +37,7 @@ export interface ContractorPaymentMethodFormFields {
  *
  * @public
  */
-export interface UseContractorPaymentMethodFormReady extends BaseFormHookReady<FieldsMetadata, ContractorPaymentMethodFormData, ContractorPaymentMethodFormFields> {
+export interface UseContractorPaymentMethodFormReady extends BaseFormHookReady<ContractorPaymentMethodFieldsMetadata, ContractorPaymentMethodFormData, ContractorPaymentMethodFormFields> {
     /** The contractor's current payment method, loaded from the API. */
     data: {
         paymentMethod: ContractorPaymentMethod;
@@ -114,4 +114,5 @@ export type UseContractorPaymentMethodFormResult = HookLoadingResult | UseContra
  *
  * @public
  */
-export type ContractorPaymentMethodFieldsMetadata = UseContractorPaymentMethodFormReady['form']['fieldsMetadata'];
+export type ContractorPaymentMethodFieldsMetadata = { type: import("../../../../../partner-hook-utils/types").FieldMetadataWithOptions<"Check" | "Direct Deposit">; };
+export {};