@gusto/embedded-react-sdk 0.50.0 → 0.51.2

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/models/components/contractorbankaccount'\nimport { useContractorPaymentMethodGetBankAccounts } from '@gusto/embedded-api/react-query/contractorPaymentMethodGetBankAccounts'\nimport { useContractorPaymentMethodsCreateBankAccountMutation } from '@gusto/embedded-api/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/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 {};

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

@@ -1,87 +1,90 @@
-import { useMemo as l } from "react";
-import { useForm as k, useWatch as A } from "react-hook-form";
-import { zodResolver as L } from "@hookform/resolvers/zod";
-import { useContractorPaymentMethodGet as R } from "@gusto/embedded-api-v-2025-11-15/react-query/contractorPaymentMethodGet";
-import { useContractorPaymentMethodUpdateMutation as U } from "@gusto/embedded-api-v-2025-11-15/react-query/contractorPaymentMethodUpdate";
-import { createContractorPaymentMethodSchema as Y, PAYMENT_METHOD_TYPES as f } from "./contractorPaymentMethodSchema.js";
-import { TypeField as _ } from "./fields.js";
-import { useDeriveFieldsMetadata as q } from "../../../../../partner-hook-utils/form/useDeriveFieldsMetadata.js";
-import { useHookFormInternals as B } from "../../../../../partner-hook-utils/form/useHookFormInternals.js";
-import { createGetFormSubmissionValues as G } from "../../../../../partner-hook-utils/form/getFormSubmissionValues.js";
-import { withOptions as I } from "../../../../../partner-hook-utils/form/withOptions.js";
-import { composeErrorHandler as N } from "../../../../../partner-hook-utils/composeErrorHandler.js";
-import { useBaseSubmit as x } from "../../../../Base/useBaseSubmit.js";
-import { SDKInternalError as h } from "../../../../../types/sdkError.js";
-import { PAYMENT_METHODS as M } from "../../../../../shared/constants.js";
+import { useMemo as y } from "react";
+import { useForm as V, useWatch as k } from "react-hook-form";
+import { zodResolver as A } from "@hookform/resolvers/zod";
+import { useContractorPaymentMethodGet as L } from "@gusto/embedded-api/react-query/contractorPaymentMethodGet";
+import { useContractorPaymentMethodUpdateMutation as R } from "@gusto/embedded-api/react-query/contractorPaymentMethodUpdate";
+import { createContractorPaymentMethodSchema as U, PAYMENT_METHOD_TYPES as l } from "./contractorPaymentMethodSchema.js";
+import { TypeField as Y } from "./fields.js";
+import { useDeriveFieldsMetadata as _ } from "../../../../../partner-hook-utils/form/useDeriveFieldsMetadata.js";
+import { useHookFormInternals as q } from "../../../../../partner-hook-utils/form/useHookFormInternals.js";
+import { createGetFormSubmissionValues as B } from "../../../../../partner-hook-utils/form/getFormSubmissionValues.js";
+import { withOptions as G } from "../../../../../partner-hook-utils/form/withOptions.js";
+import { composeErrorHandler as I } from "../../../../../partner-hook-utils/composeErrorHandler.js";
+import { useBaseSubmit as N } from "../../../../Base/useBaseSubmit.js";
+import { SDKInternalError as f } from "../../../../../types/sdkError.js";
+import { PAYMENT_METHODS as h } from "../../../../../shared/constants.js";
+function x(o) {
+  const r = l.map((a) => ({ value: a, label: a }));
+  return {
+    type: G(o.type, r, [
+      ...l
+    ])
+  };
+}
 function mt({
-  contractorId: a,
-  defaultValues: n,
-  validationMode: P = "onSubmit",
-  shouldFocusError: b = !0
+  contractorId: o,
+  defaultValues: r,
+  validationMode: a = "onSubmit",
+  shouldFocusError: M = !0
 }) {
-  const r = R({ contractorUuid: a }), t = r.data?.contractorPaymentMethod, [s, S] = l(() => Y(), []), m = l(
+  const n = L({ contractorUuid: o }), t = n.data?.contractorPaymentMethod, [s, P] = y(() => U(), []), m = y(
     () => ({
-      type: n?.type ?? t?.type ?? M.check
+      type: r?.type ?? t?.type ?? h.check
     }),
-    [n, t]
-  ), e = k({
-    resolver: L(s),
-    mode: P,
-    shouldFocusError: b,
+    [r, t]
+  ), e = V({
+    resolver: A(s),
+    mode: a,
+    shouldFocusError: M,
     defaultValues: m,
     values: m,
     resetOptions: { keepDirtyValues: !0 }
-  }), w = A({ control: e.control, name: "type" }) === M.directDeposit, i = U(), E = i.isPending, {
-    baseSubmitHandler: F,
-    error: T,
-    setError: g
-  } = x("ContractorPaymentMethodForm"), d = N([r], {
-    submitError: T,
-    setSubmitError: g
-  }), D = f.map((o) => ({ value: o, label: o })), c = q(S, e.control), C = {
-    ...c,
-    type: I(c.type, D, [
-      ...f
-    ])
-  }, v = async () => {
+  }), b = k({ control: e.control, name: "type" }) === h.directDeposit, i = R(), S = i.isPending, {
+    baseSubmitHandler: w,
+    error: F,
+    setError: E
+  } = N("ContractorPaymentMethodForm"), d = I([n], {
+    submitError: F,
+    setSubmitError: E
+  }), T = _(P, e.control), g = x(T), C = async () => {
     if (!t)
-      throw new h("Cannot submit payment method form before data is loaded");
-    const o = t.version;
-    let u;
-    return await new Promise((p) => {
+      throw new f("Cannot submit payment method form before data is loaded");
+    const v = t.version;
+    let c;
+    return await new Promise((u) => {
       e.handleSubmit(
-        async (O) => {
-          await F(O, async (V) => {
-            const y = await i.mutateAsync({
+        async (H) => {
+          await w(H, async (O) => {
+            const p = await i.mutateAsync({
               request: {
-                contractorUuid: a,
-                requestBody: { type: V.type, version: o }
+                contractorUuid: o,
+                requestBody: { type: O.type, version: v }
               }
             });
-            if (!y.contractorPaymentMethod)
-              throw new h("Payment method update failed");
-            u = { mode: "update", data: y.contractorPaymentMethod };
-          }), p();
+            if (!p.contractorPaymentMethod)
+              throw new f("Payment method update failed");
+            c = { mode: "update", data: p.contractorPaymentMethod };
+          }), u();
         },
         () => {
-          p();
+          u();
         }
       )();
-    }), u;
-  }, H = B(e);
-  return r.isLoading || !t ? { isLoading: !0, errorHandling: d } : {
+    }), c;
+  }, D = q(e);
+  return n.isLoading || !t ? { isLoading: !0, errorHandling: d } : {
     isLoading: !1,
     data: { paymentMethod: t },
-    status: { isPending: E, mode: "update", isDirectDeposit: w },
-    actions: { onSubmit: v },
+    status: { isPending: S, mode: "update", isDirectDeposit: b },
+    actions: { onSubmit: C },
     errorHandling: d,
     form: {
       Fields: {
-        Type: _
+        Type: Y
       },
-      fieldsMetadata: C,
-      hookFormInternals: H,
-      getFormSubmissionValues: G(e, s)
+      fieldsMetadata: g,
+      hookFormInternals: D,
+      getFormSubmissionValues: B(e, s)
     }
   };
 }

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

@@ -1 +1 @@
-{"version":3,"file":"useContractorPaymentMethodForm.js","sources":["../../../../../../src/components/Contractor/PaymentMethod/shared/useContractorPaymentMethodForm/useContractorPaymentMethodForm.tsx"],"sourcesContent":["import type { ComponentType } from 'react'\nimport { useMemo } from 'react'\nimport { useForm, useWatch } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { ContractorPaymentMethod } from '@gusto/embedded-api-v-2025-11-15/models/components/contractorpaymentmethod'\nimport { useContractorPaymentMethodGet } from '@gusto/embedded-api-v-2025-11-15/react-query/contractorPaymentMethodGet'\nimport { useContractorPaymentMethodUpdateMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/contractorPaymentMethodUpdate'\nimport {\n  createContractorPaymentMethodSchema,\n  type ContractorPaymentMethodFormData,\n  type ContractorPaymentMethodFormOutputs,\n  type ContractorPaymentMethodFormType,\n  PAYMENT_METHOD_TYPES,\n} from './contractorPaymentMethodSchema'\nimport type { TypeFieldProps } from './fields'\nimport { TypeField } 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'\nimport { PAYMENT_METHODS } from '@/shared/constants'\n\n/**\n * Props for {@link useContractorPaymentMethodForm}.\n *\n * @public\n */\nexport interface UseContractorPaymentMethodFormProps {\n  /** Contractor whose payment method is being edited. */\n  contractorId: string\n  /** Pre-fill form values. Server data (the current payment method) is used when no override is supplied. */\n  defaultValues?: Partial<ContractorPaymentMethodFormData>\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 useContractorPaymentMethodForm} on `form.Fields`.\n *\n * @public\n */\nexport interface ContractorPaymentMethodFormFields {\n  /**\n   * Radio group bound to `type`. Selects whether the contractor is paid by\n   * Direct Deposit or Check. Supply `getOptionLabel` to translate the option\n   * labels.\n   */\n  Type: ComponentType<TypeFieldProps>\n}\n\n/**\n * Ready-state return value of {@link useContractorPaymentMethodForm}.\n *\n * @public\n */\nexport interface UseContractorPaymentMethodFormReady extends BaseFormHookReady<\n  FieldsMetadata,\n  ContractorPaymentMethodFormData,\n  ContractorPaymentMethodFormFields\n> {\n  /** The contractor's current payment method, loaded from the API. */\n  data: {\n    paymentMethod: ContractorPaymentMethod\n  }\n  /**\n   * `isPending` reflects the in-flight update mutation; `mode` is always\n   * `'update'`. `isDirectDeposit` reflects the currently selected type so a\n   * composing component can render bank fields and decide whether to submit the\n   * bank-account form.\n   */\n  status: { isPending: boolean; mode: 'update'; isDirectDeposit: boolean }\n  /** Submit the form. Returns the updated payment method on success or `undefined` on validation/mutation failure. */\n  actions: {\n    onSubmit: () => Promise<HookSubmitResult<ContractorPaymentMethod> | undefined>\n  }\n}\n\n/**\n * Headless React Hook Form hook for managing a contractor's payment method type.\n *\n * @remarks\n * Owns only the payment method `type` selection (Direct Deposit or Check) and,\n * on submit, updates the contractor's payment method via `PUT`. Always operates\n * in update mode — every contractor has a payment method, defaulting to Check.\n *\n * The bank account itself is managed by the separate `useContractorBankAccountForm`\n * hook. On the Direct Deposit path the bank-account `POST` updates the payment\n * method as a server side-effect, so a composing component submits the bank form\n * instead of this hook; this hook's `onSubmit` is used for the Check path.\n * `status.isDirectDeposit` lets the component drive that branching.\n *\n * @param props - See {@link UseContractorPaymentMethodFormProps}.\n * @returns A loading-state result while data loads, or a {@link UseContractorPaymentMethodFormReady} once ready.\n * @public\n *\n * @example\n * ```tsx\n * import { useContractorPaymentMethodForm, SDKFormProvider } from '@gusto/embedded-react-sdk'\n *\n * function PaymentTypeScreen({ contractorId }: { contractorId: string }) {\n *   const paymentMethod = useContractorPaymentMethodForm({ contractorId })\n *\n *   if (paymentMethod.isLoading) return null\n *   const { Fields } = paymentMethod.form\n *\n *   return (\n *     <SDKFormProvider formHookResult={paymentMethod}>\n *       <form\n *         onSubmit={e => {\n *           e.preventDefault()\n *           void paymentMethod.actions.onSubmit()\n *         }}\n *       >\n *         <Fields.Type label=\"Select payment method\" />\n *         <button type=\"submit\" disabled={paymentMethod.status.isPending}>Save</button>\n *       </form>\n *     </SDKFormProvider>\n *   )\n * }\n * ```\n */\nexport function useContractorPaymentMethodForm({\n  contractorId,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseContractorPaymentMethodFormProps): HookLoadingResult | UseContractorPaymentMethodFormReady {\n  const paymentMethodQuery = useContractorPaymentMethodGet({ contractorUuid: contractorId })\n  const paymentMethod = paymentMethodQuery.data?.contractorPaymentMethod\n\n  const [schema, metadataConfig] = useMemo(() => createContractorPaymentMethodSchema(), [])\n\n  const resolvedDefaults: ContractorPaymentMethodFormData = useMemo(\n    () => ({\n      type: (partnerDefaults?.type ??\n        paymentMethod?.type ??\n        PAYMENT_METHODS.check) as ContractorPaymentMethodFormType,\n    }),\n    [partnerDefaults, paymentMethod],\n  )\n\n  const formMethods = useForm<\n    ContractorPaymentMethodFormData,\n    unknown,\n    ContractorPaymentMethodFormOutputs\n  >({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const watchedType = useWatch({ control: formMethods.control, name: 'type' })\n  const isDirectDeposit = watchedType === PAYMENT_METHODS.directDeposit\n\n  const updatePaymentMethodMutation = useContractorPaymentMethodUpdateMutation()\n  const isPending = updatePaymentMethodMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('ContractorPaymentMethodForm')\n\n  const errorHandling = composeErrorHandler([paymentMethodQuery], {\n    submitError,\n    setSubmitError,\n  })\n\n  const typeOptions = PAYMENT_METHOD_TYPES.map(value => ({ value, label: value }))\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const fieldsMetadata = {\n    ...baseMetadata,\n    type: withOptions<ContractorPaymentMethodFormType>(baseMetadata.type, typeOptions, [\n      ...PAYMENT_METHOD_TYPES,\n    ]),\n  }\n\n  const onSubmit = async (): Promise<HookSubmitResult<ContractorPaymentMethod> | undefined> => {\n    if (!paymentMethod) {\n      throw new SDKInternalError('Cannot submit payment method form before data is loaded')\n    }\n    const version = paymentMethod.version as string\n    let submitResult: HookSubmitResult<ContractorPaymentMethod> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: ContractorPaymentMethodFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const updateResponse = await updatePaymentMethodMutation.mutateAsync({\n              request: {\n                contractorUuid: contractorId,\n                requestBody: { type: payload.type, version },\n              },\n            })\n\n            if (!updateResponse.contractorPaymentMethod) {\n              throw new SDKInternalError('Payment method update failed')\n            }\n\n            submitResult = { mode: 'update' as const, data: updateResponse.contractorPaymentMethod }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  if (paymentMethodQuery.isLoading || !paymentMethod) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: { paymentMethod },\n    status: { isPending, mode: 'update' as const, isDirectDeposit },\n    actions: { onSubmit },\n    errorHandling,\n    form: {\n      Fields: {\n        Type: TypeField,\n      },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\n/**\n * Return type of {@link useContractorPaymentMethodForm} — a discriminated union on `isLoading`.\n *\n * @public\n */\nexport type UseContractorPaymentMethodFormResult =\n  HookLoadingResult | UseContractorPaymentMethodFormReady\n\n/**\n * Per-field metadata exposed on `form.fieldsMetadata` for {@link useContractorPaymentMethodForm}.\n *\n * @public\n */\nexport type ContractorPaymentMethodFieldsMetadata =\n  UseContractorPaymentMethodFormReady['form']['fieldsMetadata']\n"],"names":["useContractorPaymentMethodForm","contractorId","partnerDefaults","validationMode","shouldFocusError","paymentMethodQuery","useContractorPaymentMethodGet","paymentMethod","schema","metadataConfig","useMemo","createContractorPaymentMethodSchema","resolvedDefaults","PAYMENT_METHODS","formMethods","useForm","zodResolver","isDirectDeposit","useWatch","updatePaymentMethodMutation","useContractorPaymentMethodUpdateMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","typeOptions","PAYMENT_METHOD_TYPES","value","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","withOptions","onSubmit","SDKInternalError","version","submitResult","resolve","data","payload","updateResponse","hookFormInternals","useHookFormInternals","TypeField","createGetFormSubmissionValues"],"mappings":"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"}
+{"version":3,"file":"useContractorPaymentMethodForm.js","sources":["../../../../../../src/components/Contractor/PaymentMethod/shared/useContractorPaymentMethodForm/useContractorPaymentMethodForm.tsx"],"sourcesContent":["import type { ComponentType } from 'react'\nimport { useMemo } from 'react'\nimport { useForm, useWatch } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { ContractorPaymentMethod } from '@gusto/embedded-api/models/components/contractorpaymentmethod'\nimport { useContractorPaymentMethodGet } from '@gusto/embedded-api/react-query/contractorPaymentMethodGet'\nimport { useContractorPaymentMethodUpdateMutation } from '@gusto/embedded-api/react-query/contractorPaymentMethodUpdate'\nimport {\n  createContractorPaymentMethodSchema,\n  type ContractorPaymentMethodFormData,\n  type ContractorPaymentMethodFormOutputs,\n  type ContractorPaymentMethodFormType,\n  PAYMENT_METHOD_TYPES,\n} from './contractorPaymentMethodSchema'\nimport type { TypeFieldProps } from './fields'\nimport { TypeField } 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'\nimport { PAYMENT_METHODS } from '@/shared/constants'\n\n/**\n * Props for {@link useContractorPaymentMethodForm}.\n *\n * @public\n */\nexport interface UseContractorPaymentMethodFormProps {\n  /** Contractor whose payment method is being edited. */\n  contractorId: string\n  /** Pre-fill form values. Server data (the current payment method) is used when no override is supplied. */\n  defaultValues?: Partial<ContractorPaymentMethodFormData>\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 useContractorPaymentMethodForm} on `form.Fields`.\n *\n * @public\n */\nexport interface ContractorPaymentMethodFormFields {\n  /**\n   * Radio group bound to `type`. Selects whether the contractor is paid by\n   * Direct Deposit or Check. Supply `getOptionLabel` to translate the option\n   * labels.\n   */\n  Type: ComponentType<TypeFieldProps>\n}\n\n/**\n * Ready-state return value of {@link useContractorPaymentMethodForm}.\n *\n * @public\n */\nexport interface UseContractorPaymentMethodFormReady extends BaseFormHookReady<\n  ContractorPaymentMethodFieldsMetadata,\n  ContractorPaymentMethodFormData,\n  ContractorPaymentMethodFormFields\n> {\n  /** The contractor's current payment method, loaded from the API. */\n  data: {\n    paymentMethod: ContractorPaymentMethod\n  }\n  /**\n   * `isPending` reflects the in-flight update mutation; `mode` is always\n   * `'update'`. `isDirectDeposit` reflects the currently selected type so a\n   * composing component can render bank fields and decide whether to submit the\n   * bank-account form.\n   */\n  status: { isPending: boolean; mode: 'update'; isDirectDeposit: boolean }\n  /** Submit the form. Returns the updated payment method on success or `undefined` on validation/mutation failure. */\n  actions: {\n    onSubmit: () => Promise<HookSubmitResult<ContractorPaymentMethod> | undefined>\n  }\n}\n\n/** @internal */\nfunction buildContractorPaymentMethodFieldsMetadata(\n  base: Record<keyof ContractorPaymentMethodFormData, FieldMetadata>,\n) {\n  const typeOptions = PAYMENT_METHOD_TYPES.map(value => ({ value, label: value }))\n  return {\n    type: withOptions<ContractorPaymentMethodFormType>(base.type, typeOptions, [\n      ...PAYMENT_METHOD_TYPES,\n    ]),\n  } satisfies FieldsMetadata\n}\n\n/**\n * Headless React Hook Form hook for managing a contractor's payment method type.\n *\n * @remarks\n * Owns only the payment method `type` selection (Direct Deposit or Check) and,\n * on submit, updates the contractor's payment method via `PUT`. Always operates\n * in update mode — every contractor has a payment method, defaulting to Check.\n *\n * The bank account itself is managed by the separate `useContractorBankAccountForm`\n * hook. On the Direct Deposit path the bank-account `POST` updates the payment\n * method as a server side-effect, so a composing component submits the bank form\n * instead of this hook; this hook's `onSubmit` is used for the Check path.\n * `status.isDirectDeposit` lets the component drive that branching.\n *\n * @param props - See {@link UseContractorPaymentMethodFormProps}.\n * @returns A loading-state result while data loads, or a {@link UseContractorPaymentMethodFormReady} once ready.\n * @public\n *\n * @example\n * ```tsx\n * import { useContractorPaymentMethodForm, SDKFormProvider } from '@gusto/embedded-react-sdk'\n *\n * function PaymentTypeScreen({ contractorId }: { contractorId: string }) {\n *   const paymentMethod = useContractorPaymentMethodForm({ contractorId })\n *\n *   if (paymentMethod.isLoading) return null\n *   const { Fields } = paymentMethod.form\n *\n *   return (\n *     <SDKFormProvider formHookResult={paymentMethod}>\n *       <form\n *         onSubmit={e => {\n *           e.preventDefault()\n *           void paymentMethod.actions.onSubmit()\n *         }}\n *       >\n *         <Fields.Type label=\"Select payment method\" />\n *         <button type=\"submit\" disabled={paymentMethod.status.isPending}>Save</button>\n *       </form>\n *     </SDKFormProvider>\n *   )\n * }\n * ```\n */\nexport function useContractorPaymentMethodForm({\n  contractorId,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseContractorPaymentMethodFormProps): HookLoadingResult | UseContractorPaymentMethodFormReady {\n  const paymentMethodQuery = useContractorPaymentMethodGet({ contractorUuid: contractorId })\n  const paymentMethod = paymentMethodQuery.data?.contractorPaymentMethod\n\n  const [schema, metadataConfig] = useMemo(() => createContractorPaymentMethodSchema(), [])\n\n  const resolvedDefaults: ContractorPaymentMethodFormData = useMemo(\n    () => ({\n      type: (partnerDefaults?.type ??\n        paymentMethod?.type ??\n        PAYMENT_METHODS.check) as ContractorPaymentMethodFormType,\n    }),\n    [partnerDefaults, paymentMethod],\n  )\n\n  const formMethods = useForm<\n    ContractorPaymentMethodFormData,\n    unknown,\n    ContractorPaymentMethodFormOutputs\n  >({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const watchedType = useWatch({ control: formMethods.control, name: 'type' })\n  const isDirectDeposit = watchedType === PAYMENT_METHODS.directDeposit\n\n  const updatePaymentMethodMutation = useContractorPaymentMethodUpdateMutation()\n  const isPending = updatePaymentMethodMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('ContractorPaymentMethodForm')\n\n  const errorHandling = composeErrorHandler([paymentMethodQuery], {\n    submitError,\n    setSubmitError,\n  })\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const fieldsMetadata = buildContractorPaymentMethodFieldsMetadata(baseMetadata)\n\n  const onSubmit = async (): Promise<HookSubmitResult<ContractorPaymentMethod> | undefined> => {\n    if (!paymentMethod) {\n      throw new SDKInternalError('Cannot submit payment method form before data is loaded')\n    }\n    const version = paymentMethod.version as string\n    let submitResult: HookSubmitResult<ContractorPaymentMethod> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: ContractorPaymentMethodFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const updateResponse = await updatePaymentMethodMutation.mutateAsync({\n              request: {\n                contractorUuid: contractorId,\n                requestBody: { type: payload.type, version },\n              },\n            })\n\n            if (!updateResponse.contractorPaymentMethod) {\n              throw new SDKInternalError('Payment method update failed')\n            }\n\n            submitResult = { mode: 'update' as const, data: updateResponse.contractorPaymentMethod }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  if (paymentMethodQuery.isLoading || !paymentMethod) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: { paymentMethod },\n    status: { isPending, mode: 'update' as const, isDirectDeposit },\n    actions: { onSubmit },\n    errorHandling,\n    form: {\n      Fields: {\n        Type: TypeField,\n      },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\n/**\n * Return type of {@link useContractorPaymentMethodForm} — a discriminated union on `isLoading`.\n *\n * @public\n */\nexport type UseContractorPaymentMethodFormResult =\n  HookLoadingResult | UseContractorPaymentMethodFormReady\n\n/**\n * Per-field metadata exposed on `form.fieldsMetadata` for {@link useContractorPaymentMethodForm}.\n *\n * @public\n */\nexport type ContractorPaymentMethodFieldsMetadata = ReturnType<\n  typeof buildContractorPaymentMethodFieldsMetadata\n>\n"],"names":["buildContractorPaymentMethodFieldsMetadata","base","typeOptions","PAYMENT_METHOD_TYPES","value","withOptions","useContractorPaymentMethodForm","contractorId","partnerDefaults","validationMode","shouldFocusError","paymentMethodQuery","useContractorPaymentMethodGet","paymentMethod","schema","metadataConfig","useMemo","createContractorPaymentMethodSchema","resolvedDefaults","PAYMENT_METHODS","formMethods","useForm","zodResolver","isDirectDeposit","useWatch","updatePaymentMethodMutation","useContractorPaymentMethodUpdateMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","onSubmit","SDKInternalError","version","submitResult","resolve","data","payload","updateResponse","hookFormInternals","useHookFormInternals","TypeField","createGetFormSubmissionValues"],"mappings":"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"}

package/dist/components/Contractor/Payments/CreatePayment/CreatePayment.js

@@ -1,14 +1,14 @@
 import { jsx as h, jsxs as Q, Fragment as X } from "react/jsx-runtime";
-import { useContractorsListSuspense as Z } from "@gusto/embedded-api-v-2025-11-15/react-query/contractorsList";
-import { useContractorPaymentGroupsCreateMutation as $ } from "@gusto/embedded-api-v-2025-11-15/react-query/contractorPaymentGroupsCreate";
-import { useContractorPaymentGroupsPreviewMutation as tt } from "@gusto/embedded-api-v-2025-11-15/react-query/contractorPaymentGroupsPreview";
+import { useContractorsListSuspense as Z } from "@gusto/embedded-api/react-query/contractorsList";
+import { useContractorPaymentGroupsCreateMutation as $ } from "@gusto/embedded-api/react-query/contractorPaymentGroupsCreate";
+import { useContractorPaymentGroupsPreviewMutation as tt } from "@gusto/embedded-api/react-query/contractorPaymentGroupsPreview";
 import { useState as m, useRef as et, useEffect as ot, useMemo as G } from "react";
 import rt from "dompurify";
-import { RFCDate as V } from "@gusto/embedded-api-v-2025-11-15/types/rfcdate";
+import { RFCDate as V } from "@gusto/embedded-api/types/rfcdate";
 import { useForm as nt } from "react-hook-form";
 import { zodResolver as st } from "@hookform/resolvers/zod";
 import { useTranslation as at } from "react-i18next";
-import { useBankAccountsGet as ct } from "@gusto/embedded-api-v-2025-11-15/react-query/bankAccountsGet";
+import { useBankAccountsGet as ct } from "@gusto/embedded-api/react-query/bankAccountsGet";
 import { CreatePaymentPresentation as it } from "./CreatePaymentPresentation.js";
 import { EditContractorPaymentPresentation as ut } from "./EditContractorPaymentPresentation.js";
 import { createEditContractorPaymentFormSchema as mt } from "./EditContractorPaymentFormSchema.js";