@gusto/embedded-react-sdk 0.50.0 → 0.51.2

package/dist/components/Employee/PaymentMethod/shared/useBankForm/useBankForm.js

@@ -1,66 +1,71 @@
 import { useMemo as l } from "react";
-import { useForm as v } from "react-hook-form";
-import { zodResolver as P } from "@hookform/resolvers/zod";
-import { useEmployeePaymentMethodCreateMutation as C } from "@gusto/embedded-api-v-2025-11-15/react-query/employeePaymentMethodCreate";
-import { createBankFormSchema as O, ACCOUNT_TYPES as p } from "./useBankFormSchema.js";
-import { AccountTypeField as V, AccountNumberField as H, RoutingNumberField as R, NameField as q } from "./fields.js";
-import { useDeriveFieldsMetadata as x } from "../../../../../partner-hook-utils/form/useDeriveFieldsMetadata.js";
-import { useHookFormInternals as z } from "../../../../../partner-hook-utils/form/useHookFormInternals.js";
-import { createGetFormSubmissionValues as G } from "../../../../../partner-hook-utils/form/getFormSubmissionValues.js";
-import { withOptions as K } from "../../../../../partner-hook-utils/form/withOptions.js";
-import { composeErrorHandler as L } from "../../../../../partner-hook-utils/composeErrorHandler.js";
-import { useBaseSubmit as U } from "../../../../Base/useBaseSubmit.js";
-import { SDKInternalError as f } from "../../../../../types/sdkError.js";
+import { useForm as I } from "react-hook-form";
+import { zodResolver as v } from "@hookform/resolvers/zod";
+import { useEmployeePaymentMethodCreateMutation as P } from "@gusto/embedded-api/react-query/employeePaymentMethodCreate";
+import { createBankFormSchema as C, ACCOUNT_TYPES as b } from "./useBankFormSchema.js";
+import { AccountTypeField as V, AccountNumberField as H, RoutingNumberField as O, NameField as R } from "./fields.js";
+import { useDeriveFieldsMetadata as q } from "../../../../../partner-hook-utils/form/useDeriveFieldsMetadata.js";
+import { useHookFormInternals as x } from "../../../../../partner-hook-utils/form/useHookFormInternals.js";
+import { createGetFormSubmissionValues as z } from "../../../../../partner-hook-utils/form/getFormSubmissionValues.js";
+import { withOptions as G } from "../../../../../partner-hook-utils/form/withOptions.js";
+import { composeErrorHandler as K } from "../../../../../partner-hook-utils/composeErrorHandler.js";
+import { useBaseSubmit as L } from "../../../../Base/useBaseSubmit.js";
+import { SDKInternalError as p } from "../../../../../types/sdkError.js";
+function U(e) {
+  return {
+    name: e.name,
+    routingNumber: e.routingNumber,
+    accountNumber: e.accountNumber,
+    accountType: G(
+      e.accountType,
+      b.map((o) => ({ value: o, label: o })),
+      [...b]
+    )
+  };
+}
 function re({
-  employeeId: y,
-  optionalFieldsToRequire: m,
-  defaultValues: e,
-  validationMode: N = "onSubmit",
-  shouldFocusError: g = !0
+  employeeId: e,
+  optionalFieldsToRequire: o,
+  defaultValues: t,
+  validationMode: f = "onSubmit",
+  shouldFocusError: y = !0
 }) {
-  const [a, F] = l(
-    () => O({ optionalFieldsToRequire: m }),
-    [m]
-  ), u = l(
+  const [m, N] = l(
+    () => C({ optionalFieldsToRequire: o }),
+    [o]
+  ), a = l(
     () => ({
-      name: e?.name ?? "",
-      routingNumber: e?.routingNumber ?? "",
-      accountNumber: e?.accountNumber ?? "",
-      accountType: e?.accountType ?? "Checking"
+      name: t?.name ?? "",
+      routingNumber: t?.routingNumber ?? "",
+      accountNumber: t?.accountNumber ?? "",
+      accountType: t?.accountType ?? "Checking"
     }),
-    [e]
-  ), o = v({
-    resolver: P(a),
-    mode: N,
-    shouldFocusError: g,
-    defaultValues: u,
-    values: u,
+    [t]
+  ), r = I({
+    resolver: v(m),
+    mode: f,
+    shouldFocusError: y,
+    defaultValues: a,
+    values: a,
     resetOptions: { keepDirtyValues: !0 }
-  }), c = C(), k = c.isPending, {
-    baseSubmitHandler: S,
-    error: h,
-    setError: B
-  } = U("BankForm"), T = L([], { submitError: h, setSubmitError: B }), w = p.map((r) => ({ value: r, label: r })), t = x(F, o.control), A = {
-    name: t.name,
-    routingNumber: t.routingNumber,
-    accountNumber: t.accountNumber,
-    accountType: K(t.accountType, w, [
-      ...p
-    ])
-  }, E = async (r) => {
+  }), u = P(), F = u.isPending, {
+    baseSubmitHandler: g,
+    error: k,
+    setError: S
+  } = L("BankForm"), B = K([], { submitError: k, setSubmitError: S }), h = q(N, r.control), w = U(h), A = async (T) => {
     let i;
-    return await new Promise((s) => {
-      o.handleSubmit(
-        async (I) => {
-          await S(I, async (n) => {
-            const d = r?.employeeId ?? y;
-            if (!d)
-              throw new f(
+    return await new Promise((c) => {
+      r.handleSubmit(
+        async (E) => {
+          await g(E, async (n) => {
+            const s = T?.employeeId ?? e;
+            if (!s)
+              throw new p(
                 "employeeId is required to submit a bank account. Pass it to useBankForm or via BankFormSubmitOptions."
               );
-            const b = await c.mutateAsync({
+            const d = await u.mutateAsync({
               request: {
-                employeeId: d,
+                employeeId: s,
                 employeeBankAccountRequest: {
                   name: n.name,
                   routingNumber: n.routingNumber,
@@ -69,33 +74,33 @@ function re({
                 }
               }
             });
-            if (!b.employeeBankAccount)
-              throw new f("Bank account creation failed");
-            i = { mode: "create", data: b.employeeBankAccount };
-          }), s();
+            if (!d.employeeBankAccount)
+              throw new p("Bank account creation failed");
+            i = { mode: "create", data: d.employeeBankAccount };
+          }), c();
         },
         () => {
-          s();
+          c();
         }
       )();
     }), i;
-  }, M = z(o);
+  }, M = x(r);
   return {
     isLoading: !1,
     data: {},
-    status: { isPending: k, mode: "create" },
-    actions: { onSubmit: E },
-    errorHandling: T,
+    status: { isPending: F, mode: "create" },
+    actions: { onSubmit: A },
+    errorHandling: B,
     form: {
       Fields: {
-        Name: q,
-        RoutingNumber: R,
+        Name: R,
+        RoutingNumber: O,
         AccountNumber: H,
         AccountType: V
       },
-      fieldsMetadata: A,
+      fieldsMetadata: w,
       hookFormInternals: M,
-      getFormSubmissionValues: G(o, a)
+      getFormSubmissionValues: z(r, m)
     }
   };
 }

package/dist/components/Employee/PaymentMethod/shared/useBankForm/useBankForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"useBankForm.js","sources":["../../../../../../src/components/Employee/PaymentMethod/shared/useBankForm/useBankForm.tsx"],"sourcesContent":["import { useMemo } from 'react'\nimport { useForm } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { EmployeeBankAccount } from '@gusto/embedded-api-v-2025-11-15/models/components/employeebankaccount'\nimport { useEmployeePaymentMethodCreateMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeePaymentMethodCreate'\nimport {\n  ACCOUNT_TYPES,\n  type AccountType,\n  createBankFormSchema,\n  type BankFormData,\n  type BankFormOptionalFieldsToRequire,\n  type BankFormOutputs,\n} from './useBankFormSchema'\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 * Optional submit-time overrides for {@link useBankForm}'s `onSubmit`.\n *\n * @public\n */\nexport interface BankFormSubmitOptions {\n  /** Override the `employeeId` configured at hook construction. Useful when the employee is created in the same submit chain. */\n  employeeId?: string\n}\n\n/**\n * Props for {@link useBankForm}.\n *\n * @public\n */\nexport interface UseBankFormProps {\n  /** Employee for whom to create the bank account. May be supplied later via `BankFormSubmitOptions.employeeId`. */\n  employeeId?: string\n  /** Override optional fields to be required. Reserved for future schema expansion — every field is required by default. */\n  optionalFieldsToRequire?: BankFormOptionalFieldsToRequire\n  /** Pre-fill form values. `accountType` defaults to `'Checking'` when not supplied. */\n  defaultValues?: Partial<BankFormData>\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 useBankForm} on `form.Fields`.\n *\n * @public\n */\nexport interface BankFormFields {\n  /** Bound to `name`. */\n  Name: typeof NameField\n  /** Bound to `routingNumber`. */\n  RoutingNumber: typeof RoutingNumberField\n  /** Bound to `accountNumber`. */\n  AccountNumber: typeof AccountNumberField\n  /** Bound to `accountType`. */\n  AccountType: typeof AccountTypeField\n}\n\n/**\n * Ready-state return value of {@link useBankForm}.\n *\n * @public\n */\nexport interface UseBankFormReady extends BaseFormHookReady<\n  FieldsMetadata,\n  BankFormData,\n  BankFormFields\n> {\n  /** No server-fetched data — the create form derives everything from user input. */\n  data: Record<string, never>\n  /** `isPending` reflects the in-flight create mutation; `mode` is always `'create'`. */\n  status: { isPending: boolean; mode: 'create' }\n  /** Submit the form. Optional {@link BankFormSubmitOptions} can override the `employeeId` supplied to the hook. */\n  actions: {\n    onSubmit: (\n      options?: BankFormSubmitOptions,\n    ) => Promise<HookSubmitResult<EmployeeBankAccount> | undefined>\n  }\n}\n\n/**\n * Headless React Hook Form hook for creating an employee 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 employee's payment method on\n * the Gusto API. Returns the standard `HookLoadingResult | UseBankFormReady`\n * discriminated union; in practice the hook transitions to the ready state\n * immediately because it does not fetch any server data.\n *\n * @param props - See {@link UseBankFormProps}.\n * @returns A loading-state result while the hook is initializing, or a {@link UseBankFormReady} ready to render.\n * @public\n *\n * @example\n * ```tsx\n * import { useBankForm, SDKFormProvider } from '@gusto/embedded-react-sdk'\n *\n * function AddBankAccount({ employeeId }: { employeeId: string }) {\n *   const bankForm = useBankForm({ employeeId })\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 useBankForm({\n  employeeId,\n  optionalFieldsToRequire,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseBankFormProps): HookLoadingResult | UseBankFormReady {\n  const [schema, metadataConfig] = useMemo(\n    () => createBankFormSchema({ optionalFieldsToRequire }),\n    [optionalFieldsToRequire],\n  )\n\n  const resolvedDefaults: BankFormData = useMemo(\n    () => ({\n      name: partnerDefaults?.name ?? '',\n      routingNumber: partnerDefaults?.routingNumber ?? '',\n      accountNumber: partnerDefaults?.accountNumber ?? '',\n      accountType: (partnerDefaults?.accountType ?? 'Checking') as AccountType,\n    }),\n    [partnerDefaults],\n  )\n\n  const formMethods = useForm<BankFormData, unknown, BankFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const createMutation = useEmployeePaymentMethodCreateMutation()\n  const isPending = createMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('BankForm')\n\n  const errorHandling = composeErrorHandler([], { submitError, setSubmitError })\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<AccountType>(baseMetadata.accountType, accountTypeOptions, [\n      ...ACCOUNT_TYPES,\n    ]),\n  }\n\n  const onSubmit = async (\n    options?: BankFormSubmitOptions,\n  ): Promise<HookSubmitResult<EmployeeBankAccount> | undefined> => {\n    let submitResult: HookSubmitResult<EmployeeBankAccount> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: BankFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const resolvedEmployeeId = options?.employeeId ?? employeeId\n            if (!resolvedEmployeeId) {\n              throw new SDKInternalError(\n                'employeeId is required to submit a bank account. Pass it to useBankForm or via BankFormSubmitOptions.',\n              )\n            }\n\n            const response = await createMutation.mutateAsync({\n              request: {\n                employeeId: resolvedEmployeeId,\n                employeeBankAccountRequest: {\n                  name: payload.name,\n                  routingNumber: payload.routingNumber,\n                  accountNumber: payload.accountNumber,\n                  accountType: payload.accountType,\n                },\n              },\n            })\n\n            if (!response.employeeBankAccount) {\n              throw new SDKInternalError('Bank account creation failed')\n            }\n\n            submitResult = { mode: 'create' as const, data: response.employeeBankAccount }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  return {\n    isLoading: false as const,\n    data: {} as Record<string, never>,\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 useBankForm} — a discriminated union on `isLoading`.\n *\n * @public\n */\nexport type UseBankFormResult = HookLoadingResult | UseBankFormReady\n\n/**\n * Per-field metadata exposed on `form.fieldsMetadata` for {@link useBankForm}.\n *\n * @public\n */\nexport type BankFormFieldsMetadata = UseBankFormReady['form']['fieldsMetadata']\n"],"names":["useBankForm","employeeId","optionalFieldsToRequire","partnerDefaults","validationMode","shouldFocusError","schema","metadataConfig","useMemo","createBankFormSchema","resolvedDefaults","formMethods","useForm","zodResolver","createMutation","useEmployeePaymentMethodCreateMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","accountTypeOptions","ACCOUNT_TYPES","value","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","withOptions","onSubmit","options","submitResult","resolve","data","payload","resolvedEmployeeId","SDKInternalError","response","hookFormInternals","useHookFormInternals","NameField","RoutingNumberField","AccountNumberField","AccountTypeField","createGetFormSubmissionValues"],"mappings":"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"}
+{"version":3,"file":"useBankForm.js","sources":["../../../../../../src/components/Employee/PaymentMethod/shared/useBankForm/useBankForm.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 { EmployeeBankAccount } from '@gusto/embedded-api/models/components/employeebankaccount'\nimport { useEmployeePaymentMethodCreateMutation } from '@gusto/embedded-api/react-query/employeePaymentMethodCreate'\nimport {\n  ACCOUNT_TYPES,\n  type AccountType,\n  createBankFormSchema,\n  type BankFormData,\n  type BankFormOptionalFieldsToRequire,\n  type BankFormOutputs,\n} from './useBankFormSchema'\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 * Optional submit-time overrides for {@link useBankForm}'s `onSubmit`.\n *\n * @public\n */\nexport interface BankFormSubmitOptions {\n  /** Override the `employeeId` configured at hook construction. Useful when the employee is created in the same submit chain. */\n  employeeId?: string\n}\n\n/**\n * Props for {@link useBankForm}.\n *\n * @public\n */\nexport interface UseBankFormProps {\n  /** Employee for whom to create the bank account. May be supplied later via `BankFormSubmitOptions.employeeId`. */\n  employeeId?: string\n  /** Override optional fields to be required. Reserved for future schema expansion — every field is required by default. */\n  optionalFieldsToRequire?: BankFormOptionalFieldsToRequire\n  /** Pre-fill form values. `accountType` defaults to `'Checking'` when not supplied. */\n  defaultValues?: Partial<BankFormData>\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 useBankForm} on `form.Fields`.\n *\n * @public\n */\nexport interface BankFormFields {\n  /** Bound to `name`. */\n  Name: ComponentType<NameFieldProps>\n  /** Bound to `routingNumber`. */\n  RoutingNumber: ComponentType<RoutingNumberFieldProps>\n  /** Bound to `accountNumber`. */\n  AccountNumber: ComponentType<AccountNumberFieldProps>\n  /** Bound to `accountType`. */\n  AccountType: ComponentType<AccountTypeFieldProps>\n}\n\n/**\n * Ready-state return value of {@link useBankForm}.\n *\n * @public\n */\nexport interface UseBankFormReady extends BaseFormHookReady<\n  BankFormFieldsMetadata,\n  BankFormData,\n  BankFormFields\n> {\n  /** No server-fetched data — the create form derives everything from user input. */\n  data: Record<string, never>\n  /** `isPending` reflects the in-flight create mutation; `mode` is always `'create'`. */\n  status: { isPending: boolean; mode: 'create' }\n  /** Submit the form. Optional {@link BankFormSubmitOptions} can override the `employeeId` supplied to the hook. */\n  actions: {\n    onSubmit: (\n      options?: BankFormSubmitOptions,\n    ) => Promise<HookSubmitResult<EmployeeBankAccount> | undefined>\n  }\n}\n\n/** @internal */\nfunction buildBankFieldsMetadata(base: Record<keyof BankFormData, FieldMetadata>) {\n  return {\n    name: base.name,\n    routingNumber: base.routingNumber,\n    accountNumber: base.accountNumber,\n    accountType: withOptions<AccountType>(\n      base.accountType,\n      ACCOUNT_TYPES.map(value => ({ value, label: value })),\n      [...ACCOUNT_TYPES],\n    ),\n  } satisfies FieldsMetadata\n}\n\n/**\n * Headless React Hook Form hook for creating an employee 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 employee's payment method on\n * the Gusto API. Returns the standard `HookLoadingResult | UseBankFormReady`\n * discriminated union; in practice the hook transitions to the ready state\n * immediately because it does not fetch any server data.\n *\n * @param props - See {@link UseBankFormProps}.\n * @returns A loading-state result while the hook is initializing, or a {@link UseBankFormReady} ready to render.\n * @public\n *\n * @example\n * ```tsx\n * import { useBankForm, SDKFormProvider } from '@gusto/embedded-react-sdk'\n *\n * function AddBankAccount({ employeeId }: { employeeId: string }) {\n *   const bankForm = useBankForm({ employeeId })\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 useBankForm({\n  employeeId,\n  optionalFieldsToRequire,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseBankFormProps): HookLoadingResult | UseBankFormReady {\n  const [schema, metadataConfig] = useMemo(\n    () => createBankFormSchema({ optionalFieldsToRequire }),\n    [optionalFieldsToRequire],\n  )\n\n  const resolvedDefaults: BankFormData = useMemo(\n    () => ({\n      name: partnerDefaults?.name ?? '',\n      routingNumber: partnerDefaults?.routingNumber ?? '',\n      accountNumber: partnerDefaults?.accountNumber ?? '',\n      accountType: (partnerDefaults?.accountType ?? 'Checking') as AccountType,\n    }),\n    [partnerDefaults],\n  )\n\n  const formMethods = useForm<BankFormData, unknown, BankFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const createMutation = useEmployeePaymentMethodCreateMutation()\n  const isPending = createMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('BankForm')\n\n  const errorHandling = composeErrorHandler([], { submitError, setSubmitError })\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const fieldsMetadata = buildBankFieldsMetadata(baseMetadata)\n\n  const onSubmit = async (\n    options?: BankFormSubmitOptions,\n  ): Promise<HookSubmitResult<EmployeeBankAccount> | undefined> => {\n    let submitResult: HookSubmitResult<EmployeeBankAccount> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: BankFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const resolvedEmployeeId = options?.employeeId ?? employeeId\n            if (!resolvedEmployeeId) {\n              throw new SDKInternalError(\n                'employeeId is required to submit a bank account. Pass it to useBankForm or via BankFormSubmitOptions.',\n              )\n            }\n\n            const response = await createMutation.mutateAsync({\n              request: {\n                employeeId: resolvedEmployeeId,\n                employeeBankAccountRequest: {\n                  name: payload.name,\n                  routingNumber: payload.routingNumber,\n                  accountNumber: payload.accountNumber,\n                  accountType: payload.accountType,\n                },\n              },\n            })\n\n            if (!response.employeeBankAccount) {\n              throw new SDKInternalError('Bank account creation failed')\n            }\n\n            submitResult = { mode: 'create' as const, data: response.employeeBankAccount }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  return {\n    isLoading: false as const,\n    data: {} as Record<string, never>,\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 useBankForm} — a discriminated union on `isLoading`.\n *\n * @public\n */\nexport type UseBankFormResult = HookLoadingResult | UseBankFormReady\n\n/**\n * Per-field metadata exposed on `form.fieldsMetadata` for {@link useBankForm}.\n *\n * @public\n */\nexport type BankFormFieldsMetadata = ReturnType<typeof buildBankFieldsMetadata>\n"],"names":["buildBankFieldsMetadata","base","withOptions","ACCOUNT_TYPES","value","useBankForm","employeeId","optionalFieldsToRequire","partnerDefaults","validationMode","shouldFocusError","schema","metadataConfig","useMemo","createBankFormSchema","resolvedDefaults","formMethods","useForm","zodResolver","createMutation","useEmployeePaymentMethodCreateMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","onSubmit","options","submitResult","resolve","data","payload","resolvedEmployeeId","SDKInternalError","response","hookFormInternals","useHookFormInternals","NameField","RoutingNumberField","AccountNumberField","AccountTypeField","createGetFormSubmissionValues"],"mappings":"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"}

package/dist/components/Employee/PaymentMethod/shared/useBankForm/useBankFormSchema.d.ts

@@ -35,7 +35,7 @@ export type AccountType = (typeof ACCOUNT_TYPES)[number];
  *
  * @public
  */
-export type BankFormField = "name" | "routingNumber" | "accountNumber" | "accountType";
+export type BankFormField = "name" | "accountNumber" | "routingNumber" | "accountType";
 /**
  * Shape of the values managed by the bank account form.
  *
@@ -43,11 +43,7 @@ export type BankFormField = "name" | "routingNumber" | "accountNumber" | "accoun
  * @interface
  */
 export type BankFormData = { name: string; routingNumber: string; accountNumber: string; accountType: "Checking" | "Savings"; };
-/**
- * Shape of the validated values produced by the bank account form on submit.
- *
- * @public
- */
+/** @internal */
 export type BankFormOutputs = BankFormData;
 /**
  * Keys of optional bank account fields that can be promoted to required via

package/dist/components/Employee/PaymentMethod/shared/useBankForm/useBankFormSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"useBankFormSchema.js","sources":["../../../../../../src/components/Employee/PaymentMethod/shared/useBankForm/useBankFormSchema.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 bank account form schema. Map these\n * codes to localized copy in `validationMessages` when composing the hook.\n *\n * @public\n */\nexport const BankFormErrorCodes = {\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 bank account form\n * schema.\n *\n * @public\n */\nexport type BankFormErrorCode = (typeof BankFormErrorCodes)[keyof typeof BankFormErrorCodes]\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 * Union of bank account type values that the form accepts.\n *\n * @public\n */\nexport type AccountType = (typeof ACCOUNT_TYPES)[number]\n\nconst fieldValidators = {\n  name: z.string(),\n  routingNumber: z\n    .string()\n    .regex(ROUTING_NUMBER_REGEX, { message: BankFormErrorCodes.INVALID_ROUTING_NUMBER }),\n  accountNumber: z\n    .string()\n    .regex(ACCOUNT_NUMBER_REGEX, { message: BankFormErrorCodes.INVALID_ACCOUNT_NUMBER }),\n  accountType: z.enum(ACCOUNT_TYPES),\n}\n\n/**\n * Field names accepted by the bank account form.\n *\n * @public\n */\nexport type BankFormField = keyof typeof fieldValidators\n\n/**\n * Shape of the values managed by the bank account form.\n *\n * @public\n * @interface\n */\nexport type BankFormData = {\n  [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\n/**\n * Shape of the validated values produced by the bank account form on submit.\n *\n * @public\n */\nexport type BankFormOutputs = BankFormData\n\nconst requiredFieldsConfig = {} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n/**\n * Keys of optional bank account fields that can be promoted to required via\n * the hook's `optionalFieldsToRequire` option.\n *\n * @public\n */\nexport type BankFormOptionalFieldsToRequire = OptionalFieldsToRequire<typeof requiredFieldsConfig>\n\n/** @internal */\ninterface BankFormSchemaOptions {\n  optionalFieldsToRequire?: BankFormOptionalFieldsToRequire\n}\n\n/** @internal */\nexport function createBankFormSchema(options: BankFormSchemaOptions = {}) {\n  return buildFormSchema(fieldValidators, {\n    requiredFieldsConfig,\n    requiredErrorCode: BankFormErrorCodes.REQUIRED,\n    mode: 'create',\n    optionalFieldsToRequire: options.optionalFieldsToRequire,\n  })\n}\n"],"names":["BankFormErrorCodes","ACCOUNT_TYPES","fieldValidators","z","ROUTING_NUMBER_REGEX","ACCOUNT_NUMBER_REGEX","requiredFieldsConfig","createBankFormSchema","options","buildFormSchema"],"mappings":";;;AAcO,MAAMA,IAAqB;AAAA,EAChC,UAAU;AAAA,EACV,wBAAwB;AAAA,EACxB,wBAAwB;AAC1B,GAeaC,IAAgB,CAAC,YAAY,SAAS,GAQ7CC,IAAkB;AAAA,EACtB,MAAMC,EAAE,OAAA;AAAA,EACR,eAAeA,EACZ,OAAA,EACA,MAAMC,GAAsB,EAAE,SAASJ,EAAmB,wBAAwB;AAAA,EACrF,eAAeG,EACZ,OAAA,EACA,MAAME,GAAsB,EAAE,SAASL,EAAmB,wBAAwB;AAAA,EACrF,aAAaG,EAAE,KAAKF,CAAa;AACnC,GAyBMK,IAAuB,CAAA;AAgBtB,SAASC,EAAqBC,IAAiC,IAAI;AACxE,SAAOC,EAAgBP,GAAiB;AAAA,IACtC,sBAAAI;AAAA,IACA,mBAAmBN,EAAmB;AAAA,IACtC,MAAM;AAAA,IACN,yBAAyBQ,EAAQ;AAAA,EAAA,CAClC;AACH;"}
+{"version":3,"file":"useBankFormSchema.js","sources":["../../../../../../src/components/Employee/PaymentMethod/shared/useBankForm/useBankFormSchema.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 bank account form schema. Map these\n * codes to localized copy in `validationMessages` when composing the hook.\n *\n * @public\n */\nexport const BankFormErrorCodes = {\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 bank account form\n * schema.\n *\n * @public\n */\nexport type BankFormErrorCode = (typeof BankFormErrorCodes)[keyof typeof BankFormErrorCodes]\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 * Union of bank account type values that the form accepts.\n *\n * @public\n */\nexport type AccountType = (typeof ACCOUNT_TYPES)[number]\n\nconst fieldValidators = {\n  name: z.string(),\n  routingNumber: z\n    .string()\n    .regex(ROUTING_NUMBER_REGEX, { message: BankFormErrorCodes.INVALID_ROUTING_NUMBER }),\n  accountNumber: z\n    .string()\n    .regex(ACCOUNT_NUMBER_REGEX, { message: BankFormErrorCodes.INVALID_ACCOUNT_NUMBER }),\n  accountType: z.enum(ACCOUNT_TYPES),\n}\n\n/**\n * Field names accepted by the bank account form.\n *\n * @public\n */\nexport type BankFormField = keyof typeof fieldValidators\n\n/**\n * Shape of the values managed by the bank account form.\n *\n * @public\n * @interface\n */\nexport type BankFormData = {\n  [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\n/** @internal */\nexport type BankFormOutputs = BankFormData\n\nconst requiredFieldsConfig = {} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n/**\n * Keys of optional bank account fields that can be promoted to required via\n * the hook's `optionalFieldsToRequire` option.\n *\n * @public\n */\nexport type BankFormOptionalFieldsToRequire = OptionalFieldsToRequire<typeof requiredFieldsConfig>\n\n/** @internal */\ninterface BankFormSchemaOptions {\n  optionalFieldsToRequire?: BankFormOptionalFieldsToRequire\n}\n\n/** @internal */\nexport function createBankFormSchema(options: BankFormSchemaOptions = {}) {\n  return buildFormSchema(fieldValidators, {\n    requiredFieldsConfig,\n    requiredErrorCode: BankFormErrorCodes.REQUIRED,\n    mode: 'create',\n    optionalFieldsToRequire: options.optionalFieldsToRequire,\n  })\n}\n"],"names":["BankFormErrorCodes","ACCOUNT_TYPES","fieldValidators","z","ROUTING_NUMBER_REGEX","ACCOUNT_NUMBER_REGEX","requiredFieldsConfig","createBankFormSchema","options","buildFormSchema"],"mappings":";;;AAcO,MAAMA,IAAqB;AAAA,EAChC,UAAU;AAAA,EACV,wBAAwB;AAAA,EACxB,wBAAwB;AAC1B,GAeaC,IAAgB,CAAC,YAAY,SAAS,GAQ7CC,IAAkB;AAAA,EACtB,MAAMC,EAAE,OAAA;AAAA,EACR,eAAeA,EACZ,OAAA,EACA,MAAMC,GAAsB,EAAE,SAASJ,EAAmB,wBAAwB;AAAA,EACrF,eAAeG,EACZ,OAAA,EACA,MAAME,GAAsB,EAAE,SAASL,EAAmB,wBAAwB;AAAA,EACrF,aAAaG,EAAE,KAAKF,CAAa;AACnC,GAqBMK,IAAuB,CAAA;AAgBtB,SAASC,EAAqBC,IAAiC,IAAI;AACxE,SAAOC,EAAgBP,GAAiB;AAAA,IACtC,sBAAAI;AAAA,IACA,mBAAmBN,EAAmB;AAAA,IACtC,MAAM;AAAA,IACN,yBAAyBQ,EAAQ;AAAA,EAAA,CAClC;AACH;"}

package/dist/components/Employee/PaymentMethod/shared/usePaymentMethodForm/fields.d.ts

@@ -13,16 +13,5 @@ export type RequiredValidation = typeof PaymentMethodFormErrorCodes.REQUIRED;
  * @public
  */
 export type TypeFieldProps = HookFieldProps<RadioGroupHookFieldProps<RequiredValidation, PaymentMethodType>>;
-/**
- * Radio group bound to the `type` field of {@link usePaymentMethodForm}.
- *
- * @remarks
- * Available on the hook result as `form.Fields.Type`. Options are
- * `Direct Deposit` and `Check`; defaults to the employee's existing payment
- * method type. Supply `getOptionLabel` to translate the option labels.
- *
- * @param props - See {@link TypeFieldProps}.
- * @returns The rendered radio group bound to `type`.
- * @public
- */
+/** @internal */
 export declare function TypeField(props: TypeFieldProps): import("react").JSX.Element;

package/dist/components/Employee/PaymentMethod/shared/usePaymentMethodForm/fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Employee/PaymentMethod/shared/usePaymentMethodForm/fields.tsx"],"sourcesContent":["import type { PaymentMethodFormErrorCodes, PaymentMethodType } from './usePaymentMethodFormSchema'\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 * Validation error codes emitted by {@link usePaymentMethodForm} fields that only emit `REQUIRED`.\n *\n * @public\n */\nexport type RequiredValidation = typeof PaymentMethodFormErrorCodes.REQUIRED\n\n/**\n * Props accepted by {@link usePaymentMethodForm}'s `Fields.Type` component.\n *\n * @public\n */\nexport type TypeFieldProps = HookFieldProps<\n  RadioGroupHookFieldProps<RequiredValidation, PaymentMethodType>\n>\n\n/**\n * Radio group bound to the `type` field of {@link usePaymentMethodForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.Type`. Options are\n * `Direct Deposit` and `Check`; defaults to the employee's existing payment\n * method type. Supply `getOptionLabel` to translate the option labels.\n *\n * @param props - See {@link TypeFieldProps}.\n * @returns The rendered radio group bound to `type`.\n * @public\n */\nexport function TypeField(props: TypeFieldProps) {\n  return <RadioGroupHookField {...props} name=\"type\" />\n}\n"],"names":["TypeField","props","jsx","RadioGroupHookField"],"mappings":";;AAiCO,SAASA,EAAUC,GAAuB;AAC/C,SAAO,gBAAAC,EAACC,GAAA,EAAqB,GAAGF,GAAO,MAAK,QAAO;AACrD;"}
+{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Employee/PaymentMethod/shared/usePaymentMethodForm/fields.tsx"],"sourcesContent":["import type { PaymentMethodFormErrorCodes, PaymentMethodType } from './usePaymentMethodFormSchema'\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 * Validation error codes emitted by {@link usePaymentMethodForm} fields that only emit `REQUIRED`.\n *\n * @public\n */\nexport type RequiredValidation = typeof PaymentMethodFormErrorCodes.REQUIRED\n\n/**\n * Props accepted by {@link usePaymentMethodForm}'s `Fields.Type` component.\n *\n * @public\n */\nexport type TypeFieldProps = HookFieldProps<\n  RadioGroupHookFieldProps<RequiredValidation, PaymentMethodType>\n>\n\n/** @internal */\nexport function TypeField(props: TypeFieldProps) {\n  return <RadioGroupHookField {...props} name=\"type\" />\n}\n"],"names":["TypeField","props","jsx","RadioGroupHookField"],"mappings":";;AAsBO,SAASA,EAAUC,GAAuB;AAC/C,SAAO,gBAAAC,EAACC,GAAA,EAAqB,GAAGF,GAAO,MAAK,QAAO;AACrD;"}

package/dist/components/Employee/PaymentMethod/shared/usePaymentMethodForm/index.d.ts

@@ -1,5 +1,4 @@
-import "./types/i18next.d.ts"
 export { usePaymentMethodForm } from './usePaymentMethodForm';
 export type { UsePaymentMethodFormProps, UsePaymentMethodFormResult, UsePaymentMethodFormReady, PaymentMethodFormFields, PaymentMethodFormFieldsMetadata, } from './usePaymentMethodForm';
-export { PAYMENT_METHOD_TYPES, PaymentMethodFormErrorCodes, createPaymentMethodFormSchema, type PaymentMethodFormErrorCode, type PaymentMethodFormData, type PaymentMethodFormField, type PaymentMethodFormOptionalFieldsToRequire, type PaymentMethodFormOutputs, type PaymentMethodType, } from './usePaymentMethodFormSchema';
-export { TypeField as PaymentMethodTypeField, type TypeFieldProps, type RequiredValidation as PaymentMethodFormRequiredValidation, } from './fields';
+export { PAYMENT_METHOD_TYPES, PaymentMethodFormErrorCodes, type PaymentMethodFormErrorCode, type PaymentMethodFormData, type PaymentMethodFormField, type PaymentMethodFormOptionalFieldsToRequire, type PaymentMethodType, } from './usePaymentMethodFormSchema';
+export { type RequiredValidation as PaymentMethodFormRequiredValidation, type TypeFieldProps, } from './fields';

package/dist/components/Employee/PaymentMethod/shared/usePaymentMethodForm/usePaymentMethodForm.d.ts

@@ -1,8 +1,9 @@
+import { ComponentType } from 'react';
 import { UseFormProps } from 'react-hook-form';
-import { EmployeePaymentMethod } from '@gusto/embedded-api-v-2025-11-15/models/components/employeepaymentmethod';
+import { EmployeePaymentMethod } from '@gusto/embedded-api/models/components/employeepaymentmethod';
 import { PaymentMethodFormData, PaymentMethodFormOptionalFieldsToRequire } from './usePaymentMethodFormSchema';
-import { TypeField } from './fields';
-import { BaseFormHookReady, FieldsMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
+import { TypeFieldProps } from './fields';
+import { BaseFormHookReady, FieldMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
 /**
  * Props for {@link usePaymentMethodForm}.
  *
@@ -27,14 +28,14 @@ export interface UsePaymentMethodFormProps {
  */
 export interface PaymentMethodFormFields {
     /** Bound to `type`. */
-    Type: typeof TypeField;
+    Type: ComponentType<TypeFieldProps>;
 }
 /**
  * Ready-state return value of {@link usePaymentMethodForm}.
  *
  * @public
  */
-export interface UsePaymentMethodFormReady extends BaseFormHookReady<FieldsMetadata, PaymentMethodFormData, PaymentMethodFormFields> {
+export interface UsePaymentMethodFormReady extends BaseFormHookReady<PaymentMethodFormFieldsMetadata, PaymentMethodFormData, PaymentMethodFormFields> {
     /** The employee's current payment method, loaded from the API. */
     data: {
         paymentMethod: EmployeePaymentMethod;
@@ -111,4 +112,5 @@ export type UsePaymentMethodFormResult = HookLoadingResult | UsePaymentMethodFor
  *
  * @public
  */
-export type PaymentMethodFormFieldsMetadata = UsePaymentMethodFormReady['form']['fieldsMetadata'];
+export type PaymentMethodFormFieldsMetadata = { type: import("../../../../../partner-hook-utils/types").FieldMetadataWithOptions<"Check" | "Direct Deposit">; };
+export {};

package/dist/components/Employee/PaymentMethod/shared/usePaymentMethodForm/usePaymentMethodForm.js

@@ -1,90 +1,97 @@
-import { useMemo as h } from "react";
-import { useForm as Y } from "react-hook-form";
-import { zodResolver as _ } from "@hookform/resolvers/zod";
-import { useEmployeePaymentMethodGet as A } from "@gusto/embedded-api-v-2025-11-15/react-query/employeePaymentMethodGet";
-import { useEmployeePaymentMethodUpdateMutation as I } from "@gusto/embedded-api-v-2025-11-15/react-query/employeePaymentMethodUpdate";
-import { createPaymentMethodFormSchema as C, PAYMENT_METHOD_TYPES as M } from "./usePaymentMethodFormSchema.js";
-import { TypeField as G } from "./fields.js";
-import { useDeriveFieldsMetadata as N } from "../../../../../partner-hook-utils/form/useDeriveFieldsMetadata.js";
-import { useHookFormInternals as q } from "../../../../../partner-hook-utils/form/useHookFormInternals.js";
-import { createGetFormSubmissionValues as x } 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 { useMemo as M } from "react";
+import { useForm as O } from "react-hook-form";
+import { zodResolver as Y } from "@hookform/resolvers/zod";
+import { useEmployeePaymentMethodGet as _ } from "@gusto/embedded-api/react-query/employeePaymentMethodGet";
+import { useEmployeePaymentMethodUpdateMutation as A } from "@gusto/embedded-api/react-query/employeePaymentMethodUpdate";
+import { createPaymentMethodFormSchema as I, PAYMENT_METHOD_TYPES as h } from "./usePaymentMethodFormSchema.js";
+import { TypeField as C } from "./fields.js";
+import { useDeriveFieldsMetadata as G } from "../../../../../partner-hook-utils/form/useDeriveFieldsMetadata.js";
+import { useHookFormInternals as N } from "../../../../../partner-hook-utils/form/useHookFormInternals.js";
+import { createGetFormSubmissionValues as q } from "../../../../../partner-hook-utils/form/getFormSubmissionValues.js";
+import { withOptions as x } 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 P } from "../../../../../types/sdkError.js";
-import { PAYMENT_METHODS as b, SPLIT_BY as R } from "../../../../../shared/constants.js";
+import { PAYMENT_METHODS as b, SPLIT_BY as Q } from "../../../../../shared/constants.js";
+function R(o) {
+  return {
+    type: x(
+      o.type,
+      h.map((t) => ({ value: t, label: t })),
+      [...h]
+    )
+  };
+}
 function ie({
-  employeeId: s,
-  optionalFieldsToRequire: m,
-  defaultValues: a,
+  employeeId: o,
+  optionalFieldsToRequire: t,
+  defaultValues: m,
   validationMode: S = "onSubmit",
   shouldFocusError: E = !0
 }) {
-  const r = A({ employeeId: s }), t = r.data?.employeePaymentMethod, [n, F] = h(
-    () => C({ optionalFieldsToRequire: m }),
-    [m]
-  ), i = h(
+  const a = _({ employeeId: o }), e = a.data?.employeePaymentMethod, [n, F] = M(
+    () => I({ optionalFieldsToRequire: t }),
+    [t]
+  ), i = M(
     () => ({
-      type: a?.type ?? t?.type ?? b.directDeposit
+      type: m?.type ?? e?.type ?? b.directDeposit
     }),
-    [a, t]
-  ), o = Y({
-    resolver: _(n),
+    [m, e]
+  ), r = O({
+    resolver: Y(n),
     mode: S,
     shouldFocusError: E,
     defaultValues: i,
     values: i,
     resetOptions: { keepDirtyValues: !0 }
-  }), d = I(), g = d.isPending, {
+  }), d = A(), g = d.isPending, {
     baseSubmitHandler: w,
     error: T,
     setError: v
-  } = Q("PaymentMethodForm"), p = K([r], {
+  } = K("PaymentMethodForm"), u = z([a], {
     submitError: T,
     setSubmitError: v
-  }), D = M.map((e) => ({ value: e, label: e })), H = N(F, o.control), B = {
-    type: z(H.type, D, [...M])
-  }, O = async () => {
-    if (!t)
+  }), D = G(F, r.control), H = R(D), B = async () => {
+    if (!e)
       throw new P("Cannot submit payment method form before data is loaded");
-    const e = t;
-    let u;
+    const s = e;
+    let p;
     return await new Promise((y) => {
-      o.handleSubmit(
+      r.handleSubmit(
         async (k) => {
           await w(k, async (c) => {
-            const l = e.version, L = c.type === b.check ? { version: l } : {
-              ...e,
+            const l = s.version, L = c.type === b.check ? { version: l } : {
+              ...s,
               version: l,
-              splitBy: e.splitBy ?? R.percentage,
-              splits: e.splits ?? []
+              splitBy: s.splitBy ?? Q.percentage,
+              splits: s.splits ?? []
             }, f = await d.mutateAsync({
-              request: { employeeId: s, requestBody: { ...L, type: c.type } }
+              request: { employeeId: o, requestBody: { ...L, type: c.type } }
             });
             if (!f.employeePaymentMethod)
               throw new P("Payment method update failed");
-            u = { mode: "update", data: f.employeePaymentMethod };
+            p = { mode: "update", data: f.employeePaymentMethod };
           }), y();
         },
         () => {
           y();
         }
       )();
-    }), u;
-  }, V = q(o);
-  return r.isLoading || !t ? { isLoading: !0, errorHandling: p } : {
+    }), p;
+  }, V = N(r);
+  return a.isLoading || !e ? { isLoading: !0, errorHandling: u } : {
     isLoading: !1,
-    data: { paymentMethod: t },
+    data: { paymentMethod: e },
     status: { isPending: g, mode: "update" },
-    actions: { onSubmit: O },
-    errorHandling: p,
+    actions: { onSubmit: B },
+    errorHandling: u,
     form: {
       Fields: {
-        Type: G
+        Type: C
       },
-      fieldsMetadata: B,
+      fieldsMetadata: H,
       hookFormInternals: V,
-      getFormSubmissionValues: x(o, n)
+      getFormSubmissionValues: q(r, n)
     }
   };
 }

package/dist/components/Employee/PaymentMethod/shared/usePaymentMethodForm/usePaymentMethodForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"usePaymentMethodForm.js","sources":["../../../../../../src/components/Employee/PaymentMethod/shared/usePaymentMethodForm/usePaymentMethodForm.tsx"],"sourcesContent":["import { useMemo } from 'react'\nimport { useForm } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { EmployeePaymentMethod } from '@gusto/embedded-api-v-2025-11-15/models/components/employeepaymentmethod'\nimport { useEmployeePaymentMethodGet } from '@gusto/embedded-api-v-2025-11-15/react-query/employeePaymentMethodGet'\nimport { useEmployeePaymentMethodUpdateMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/employeePaymentMethodUpdate'\nimport {\n  PAYMENT_METHOD_TYPES,\n  type PaymentMethodFormData,\n  type PaymentMethodFormOptionalFieldsToRequire,\n  type PaymentMethodFormOutputs,\n  type PaymentMethodType,\n  createPaymentMethodFormSchema,\n} from './usePaymentMethodFormSchema'\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, SPLIT_BY } from '@/shared/constants'\n\n/**\n * Props for {@link usePaymentMethodForm}.\n *\n * @public\n */\nexport interface UsePaymentMethodFormProps {\n  /** Employee whose payment method is being edited. */\n  employeeId: string\n  /** Override optional fields to be required. Reserved for future schema expansion — `type` is always required and always has a default. */\n  optionalFieldsToRequire?: PaymentMethodFormOptionalFieldsToRequire\n  /** Pre-fill form values. Server data (the current payment method) is used when no override is supplied. */\n  defaultValues?: Partial<PaymentMethodFormData>\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 usePaymentMethodForm} on `form.Fields`.\n *\n * @public\n */\nexport interface PaymentMethodFormFields {\n  /** Bound to `type`. */\n  Type: typeof TypeField\n}\n\n/**\n * Ready-state return value of {@link usePaymentMethodForm}.\n *\n * @public\n */\nexport interface UsePaymentMethodFormReady extends BaseFormHookReady<\n  FieldsMetadata,\n  PaymentMethodFormData,\n  PaymentMethodFormFields\n> {\n  /** The employee's current payment method, loaded from the API. */\n  data: {\n    paymentMethod: EmployeePaymentMethod\n  }\n  /** `isPending` reflects the in-flight update mutation; `mode` is always `'update'`. */\n  status: { isPending: boolean; mode: 'update' }\n  /** Submit the form. Returns the updated payment method on success or `undefined` on validation/mutation failure. */\n  actions: {\n    onSubmit: () => Promise<HookSubmitResult<EmployeePaymentMethod> | undefined>\n  }\n}\n\n/**\n * Headless React Hook Form hook for updating an employee's payment method.\n *\n * @remarks\n * Switches between Direct Deposit and Check. Always operates in update mode —\n * every employee has a payment method, defaulting to Check. Switching to Check\n * sends a minimal request body; switching to or staying on Direct Deposit\n * preserves the existing splits and version so split allocations are not lost\n * when only the type changes.\n *\n * @param props - See {@link UsePaymentMethodFormProps}.\n * @returns A loading-state result while the current payment method is loading, or a {@link UsePaymentMethodFormReady} once ready.\n * @public\n *\n * @example\n * ```tsx\n * import {\n *   usePaymentMethodForm,\n *   SDKFormProvider,\n *   PAYMENT_METHODS,\n *   type PaymentMethodType,\n * } from '@gusto/embedded-react-sdk'\n *\n * function PaymentMethodScreen({ employeeId }: { employeeId: string }) {\n *   const paymentMethodForm = usePaymentMethodForm({ employeeId })\n *\n *   if (paymentMethodForm.isLoading) return null\n *   const { Fields } = paymentMethodForm.form\n *\n *   return (\n *     <SDKFormProvider formHookResult={paymentMethodForm}>\n *       <form\n *         onSubmit={e => {\n *           e.preventDefault()\n *           void paymentMethodForm.actions.onSubmit()\n *         }}\n *       >\n *         <Fields.Type\n *           label=\"Select payment method\"\n *           getOptionLabel={(value: PaymentMethodType) =>\n *             value === PAYMENT_METHODS.directDeposit ? 'Direct Deposit' : 'Check'\n *           }\n *         />\n *         <button type=\"submit\" disabled={paymentMethodForm.status.isPending}>Save</button>\n *       </form>\n *     </SDKFormProvider>\n *   )\n * }\n * ```\n */\nexport function usePaymentMethodForm({\n  employeeId,\n  optionalFieldsToRequire,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UsePaymentMethodFormProps): HookLoadingResult | UsePaymentMethodFormReady {\n  const paymentMethodQuery = useEmployeePaymentMethodGet({ employeeId })\n  const paymentMethod = paymentMethodQuery.data?.employeePaymentMethod\n\n  const [schema, metadataConfig] = useMemo(\n    () => createPaymentMethodFormSchema({ optionalFieldsToRequire }),\n    [optionalFieldsToRequire],\n  )\n\n  const resolvedDefaults: PaymentMethodFormData = useMemo(\n    () => ({\n      type: (partnerDefaults?.type ??\n        paymentMethod?.type ??\n        PAYMENT_METHODS.directDeposit) as PaymentMethodType,\n    }),\n    [partnerDefaults, paymentMethod],\n  )\n\n  const formMethods = useForm<PaymentMethodFormData, unknown, PaymentMethodFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const updateMutation = useEmployeePaymentMethodUpdateMutation()\n  const isPending = updateMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('PaymentMethodForm')\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    type: withOptions<PaymentMethodType>(baseMetadata.type, typeOptions, [...PAYMENT_METHOD_TYPES]),\n  }\n\n  const onSubmit = async (): Promise<HookSubmitResult<EmployeePaymentMethod> | undefined> => {\n    if (!paymentMethod) {\n      throw new SDKInternalError('Cannot submit payment method form before data is loaded')\n    }\n    const currentPaymentMethod = paymentMethod\n    let submitResult: HookSubmitResult<EmployeePaymentMethod> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: PaymentMethodFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const version = currentPaymentMethod.version as string\n            const body =\n              payload.type === PAYMENT_METHODS.check\n                ? { version }\n                : {\n                    ...currentPaymentMethod,\n                    version,\n                    splitBy: currentPaymentMethod.splitBy ?? SPLIT_BY.percentage,\n                    splits: currentPaymentMethod.splits ?? [],\n                  }\n\n            const response = await updateMutation.mutateAsync({\n              request: { employeeId, requestBody: { ...body, type: payload.type } },\n            })\n\n            if (!response.employeePaymentMethod) {\n              throw new SDKInternalError('Payment method update failed')\n            }\n\n            submitResult = { mode: 'update' as const, data: response.employeePaymentMethod }\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 },\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 usePaymentMethodForm} — a discriminated union on `isLoading`.\n *\n * @public\n */\nexport type UsePaymentMethodFormResult = HookLoadingResult | UsePaymentMethodFormReady\n\n/**\n * Per-field metadata exposed on `form.fieldsMetadata` for {@link usePaymentMethodForm}.\n *\n * @public\n */\nexport type PaymentMethodFormFieldsMetadata = UsePaymentMethodFormReady['form']['fieldsMetadata']\n"],"names":["usePaymentMethodForm","employeeId","optionalFieldsToRequire","partnerDefaults","validationMode","shouldFocusError","paymentMethodQuery","useEmployeePaymentMethodGet","paymentMethod","schema","metadataConfig","useMemo","createPaymentMethodFormSchema","resolvedDefaults","PAYMENT_METHODS","formMethods","useForm","zodResolver","updateMutation","useEmployeePaymentMethodUpdateMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","typeOptions","PAYMENT_METHOD_TYPES","value","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","withOptions","onSubmit","SDKInternalError","currentPaymentMethod","submitResult","resolve","data","payload","version","body","SPLIT_BY","response","hookFormInternals","useHookFormInternals","TypeField","createGetFormSubmissionValues"],"mappings":"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"}
+{"version":3,"file":"usePaymentMethodForm.js","sources":["../../../../../../src/components/Employee/PaymentMethod/shared/usePaymentMethodForm/usePaymentMethodForm.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 { EmployeePaymentMethod } from '@gusto/embedded-api/models/components/employeepaymentmethod'\nimport { useEmployeePaymentMethodGet } from '@gusto/embedded-api/react-query/employeePaymentMethodGet'\nimport { useEmployeePaymentMethodUpdateMutation } from '@gusto/embedded-api/react-query/employeePaymentMethodUpdate'\nimport {\n  PAYMENT_METHOD_TYPES,\n  type PaymentMethodFormData,\n  type PaymentMethodFormOptionalFieldsToRequire,\n  type PaymentMethodFormOutputs,\n  type PaymentMethodType,\n  createPaymentMethodFormSchema,\n} from './usePaymentMethodFormSchema'\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, SPLIT_BY } from '@/shared/constants'\n\n/**\n * Props for {@link usePaymentMethodForm}.\n *\n * @public\n */\nexport interface UsePaymentMethodFormProps {\n  /** Employee whose payment method is being edited. */\n  employeeId: string\n  /** Override optional fields to be required. Reserved for future schema expansion — `type` is always required and always has a default. */\n  optionalFieldsToRequire?: PaymentMethodFormOptionalFieldsToRequire\n  /** Pre-fill form values. Server data (the current payment method) is used when no override is supplied. */\n  defaultValues?: Partial<PaymentMethodFormData>\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 usePaymentMethodForm} on `form.Fields`.\n *\n * @public\n */\nexport interface PaymentMethodFormFields {\n  /** Bound to `type`. */\n  Type: ComponentType<TypeFieldProps>\n}\n\n/**\n * Ready-state return value of {@link usePaymentMethodForm}.\n *\n * @public\n */\nexport interface UsePaymentMethodFormReady extends BaseFormHookReady<\n  PaymentMethodFormFieldsMetadata,\n  PaymentMethodFormData,\n  PaymentMethodFormFields\n> {\n  /** The employee's current payment method, loaded from the API. */\n  data: {\n    paymentMethod: EmployeePaymentMethod\n  }\n  /** `isPending` reflects the in-flight update mutation; `mode` is always `'update'`. */\n  status: { isPending: boolean; mode: 'update' }\n  /** Submit the form. Returns the updated payment method on success or `undefined` on validation/mutation failure. */\n  actions: {\n    onSubmit: () => Promise<HookSubmitResult<EmployeePaymentMethod> | undefined>\n  }\n}\n\n/** @internal */\nfunction buildPaymentMethodFieldsMetadata(\n  base: Record<keyof PaymentMethodFormData, FieldMetadata>,\n) {\n  return {\n    type: withOptions<PaymentMethodType>(\n      base.type,\n      PAYMENT_METHOD_TYPES.map(value => ({ value, label: value })),\n      [...PAYMENT_METHOD_TYPES],\n    ),\n  } satisfies FieldsMetadata\n}\n\n/**\n * Headless React Hook Form hook for updating an employee's payment method.\n *\n * @remarks\n * Switches between Direct Deposit and Check. Always operates in update mode —\n * every employee has a payment method, defaulting to Check. Switching to Check\n * sends a minimal request body; switching to or staying on Direct Deposit\n * preserves the existing splits and version so split allocations are not lost\n * when only the type changes.\n *\n * @param props - See {@link UsePaymentMethodFormProps}.\n * @returns A loading-state result while the current payment method is loading, or a {@link UsePaymentMethodFormReady} once ready.\n * @public\n *\n * @example\n * ```tsx\n * import {\n *   usePaymentMethodForm,\n *   SDKFormProvider,\n *   PAYMENT_METHODS,\n *   type PaymentMethodType,\n * } from '@gusto/embedded-react-sdk'\n *\n * function PaymentMethodScreen({ employeeId }: { employeeId: string }) {\n *   const paymentMethodForm = usePaymentMethodForm({ employeeId })\n *\n *   if (paymentMethodForm.isLoading) return null\n *   const { Fields } = paymentMethodForm.form\n *\n *   return (\n *     <SDKFormProvider formHookResult={paymentMethodForm}>\n *       <form\n *         onSubmit={e => {\n *           e.preventDefault()\n *           void paymentMethodForm.actions.onSubmit()\n *         }}\n *       >\n *         <Fields.Type\n *           label=\"Select payment method\"\n *           getOptionLabel={(value: PaymentMethodType) =>\n *             value === PAYMENT_METHODS.directDeposit ? 'Direct Deposit' : 'Check'\n *           }\n *         />\n *         <button type=\"submit\" disabled={paymentMethodForm.status.isPending}>Save</button>\n *       </form>\n *     </SDKFormProvider>\n *   )\n * }\n * ```\n */\nexport function usePaymentMethodForm({\n  employeeId,\n  optionalFieldsToRequire,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UsePaymentMethodFormProps): HookLoadingResult | UsePaymentMethodFormReady {\n  const paymentMethodQuery = useEmployeePaymentMethodGet({ employeeId })\n  const paymentMethod = paymentMethodQuery.data?.employeePaymentMethod\n\n  const [schema, metadataConfig] = useMemo(\n    () => createPaymentMethodFormSchema({ optionalFieldsToRequire }),\n    [optionalFieldsToRequire],\n  )\n\n  const resolvedDefaults: PaymentMethodFormData = useMemo(\n    () => ({\n      type: (partnerDefaults?.type ??\n        paymentMethod?.type ??\n        PAYMENT_METHODS.directDeposit) as PaymentMethodType,\n    }),\n    [partnerDefaults, paymentMethod],\n  )\n\n  const formMethods = useForm<PaymentMethodFormData, unknown, PaymentMethodFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const updateMutation = useEmployeePaymentMethodUpdateMutation()\n  const isPending = updateMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('PaymentMethodForm')\n\n  const errorHandling = composeErrorHandler([paymentMethodQuery], {\n    submitError,\n    setSubmitError,\n  })\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const fieldsMetadata = buildPaymentMethodFieldsMetadata(baseMetadata)\n\n  const onSubmit = async (): Promise<HookSubmitResult<EmployeePaymentMethod> | undefined> => {\n    if (!paymentMethod) {\n      throw new SDKInternalError('Cannot submit payment method form before data is loaded')\n    }\n    const currentPaymentMethod = paymentMethod\n    let submitResult: HookSubmitResult<EmployeePaymentMethod> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: PaymentMethodFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const version = currentPaymentMethod.version as string\n            const body =\n              payload.type === PAYMENT_METHODS.check\n                ? { version }\n                : {\n                    ...currentPaymentMethod,\n                    version,\n                    splitBy: currentPaymentMethod.splitBy ?? SPLIT_BY.percentage,\n                    splits: currentPaymentMethod.splits ?? [],\n                  }\n\n            const response = await updateMutation.mutateAsync({\n              request: { employeeId, requestBody: { ...body, type: payload.type } },\n            })\n\n            if (!response.employeePaymentMethod) {\n              throw new SDKInternalError('Payment method update failed')\n            }\n\n            submitResult = { mode: 'update' as const, data: response.employeePaymentMethod }\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 },\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 usePaymentMethodForm} — a discriminated union on `isLoading`.\n *\n * @public\n */\nexport type UsePaymentMethodFormResult = HookLoadingResult | UsePaymentMethodFormReady\n\n/**\n * Per-field metadata exposed on `form.fieldsMetadata` for {@link usePaymentMethodForm}.\n *\n * @public\n */\nexport type PaymentMethodFormFieldsMetadata = ReturnType<typeof buildPaymentMethodFieldsMetadata>\n"],"names":["buildPaymentMethodFieldsMetadata","base","withOptions","PAYMENT_METHOD_TYPES","value","usePaymentMethodForm","employeeId","optionalFieldsToRequire","partnerDefaults","validationMode","shouldFocusError","paymentMethodQuery","useEmployeePaymentMethodGet","paymentMethod","schema","metadataConfig","useMemo","createPaymentMethodFormSchema","resolvedDefaults","PAYMENT_METHODS","formMethods","useForm","zodResolver","updateMutation","useEmployeePaymentMethodUpdateMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","onSubmit","SDKInternalError","currentPaymentMethod","submitResult","resolve","data","payload","version","body","SPLIT_BY","response","hookFormInternals","useHookFormInternals","TypeField","createGetFormSubmissionValues"],"mappings":"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"}

package/dist/components/Employee/PaymentMethod/shared/usePaymentMethodForm/usePaymentMethodFormSchema.d.ts

@@ -41,11 +41,7 @@ export type PaymentMethodFormField = "type";
  * @interface
  */
 export type PaymentMethodFormData = { type: "Check" | "Direct Deposit"; };
-/**
- * Shape of the validated values produced by the payment method form on submit.
- *
- * @public
- */
+/** @internal */
 export type PaymentMethodFormOutputs = PaymentMethodFormData;
 /**
  * Keys of optional payment method fields that can be promoted to required via

package/dist/components/Employee/PaymentMethod/shared/usePaymentMethodForm/usePaymentMethodFormSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"usePaymentMethodFormSchema.js","sources":["../../../../../../src/components/Employee/PaymentMethod/shared/usePaymentMethodForm/usePaymentMethodFormSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  buildFormSchema,\n  type OptionalFieldsToRequire,\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 payment method form schema. Map these\n * codes to localized copy in `validationMessages` when composing the hook.\n *\n * @public\n */\nexport const PaymentMethodFormErrorCodes = {\n  REQUIRED: 'REQUIRED',\n} as const\n\n/**\n * Union of validation error code strings emitted by the payment method form\n * schema.\n *\n * @public\n */\nexport type PaymentMethodFormErrorCode =\n  (typeof PaymentMethodFormErrorCodes)[keyof typeof PaymentMethodFormErrorCodes]\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 PaymentMethodType = (typeof PAYMENT_METHOD_TYPES)[number]\n\nconst fieldValidators = {\n  type: z.enum(PAYMENT_METHOD_TYPES),\n}\n\n/**\n * Field names accepted by the payment method form.\n *\n * @public\n */\nexport type PaymentMethodFormField = keyof typeof fieldValidators\n\n/**\n * Shape of the values managed by the payment method form.\n *\n * @public\n * @interface\n */\nexport type PaymentMethodFormData = {\n  [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\n/**\n * Shape of the validated values produced by the payment method form on submit.\n *\n * @public\n */\nexport type PaymentMethodFormOutputs = PaymentMethodFormData\n\nconst requiredFieldsConfig = {} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n/**\n * Keys of optional payment method fields that can be promoted to required via\n * the hook's `optionalFieldsToRequire` option.\n *\n * @public\n */\nexport type PaymentMethodFormOptionalFieldsToRequire = OptionalFieldsToRequire<\n  typeof requiredFieldsConfig\n>\n\n/** @internal */\ninterface PaymentMethodFormSchemaOptions {\n  optionalFieldsToRequire?: PaymentMethodFormOptionalFieldsToRequire\n}\n\n/** @internal */\nexport function createPaymentMethodFormSchema(options: PaymentMethodFormSchemaOptions = {}) {\n  return buildFormSchema(fieldValidators, {\n    requiredFieldsConfig,\n    requiredErrorCode: PaymentMethodFormErrorCodes.REQUIRED,\n    mode: 'update',\n    optionalFieldsToRequire: options.optionalFieldsToRequire,\n  })\n}\n"],"names":["PaymentMethodFormErrorCodes","PAYMENT_METHOD_TYPES","PAYMENT_METHODS","fieldValidators","z","requiredFieldsConfig","createPaymentMethodFormSchema","options","buildFormSchema"],"mappings":";;;AAcO,MAAMA,IAA8B;AAAA,EACzC,UAAU;AACZ,GAgBaC,IAAuB,CAACC,EAAgB,eAAeA,EAAgB,KAAK,GASnFC,IAAkB;AAAA,EACtB,MAAMC,EAAE,KAAKH,CAAoB;AACnC,GAyBMI,IAAuB,CAAA;AAkBtB,SAASC,EAA8BC,IAA0C,IAAI;AAC1F,SAAOC,EAAgBL,GAAiB;AAAA,IACtC,sBAAAE;AAAA,IACA,mBAAmBL,EAA4B;AAAA,IAC/C,MAAM;AAAA,IACN,yBAAyBO,EAAQ;AAAA,EAAA,CAClC;AACH;"}
+{"version":3,"file":"usePaymentMethodFormSchema.js","sources":["../../../../../../src/components/Employee/PaymentMethod/shared/usePaymentMethodForm/usePaymentMethodFormSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  buildFormSchema,\n  type OptionalFieldsToRequire,\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 payment method form schema. Map these\n * codes to localized copy in `validationMessages` when composing the hook.\n *\n * @public\n */\nexport const PaymentMethodFormErrorCodes = {\n  REQUIRED: 'REQUIRED',\n} as const\n\n/**\n * Union of validation error code strings emitted by the payment method form\n * schema.\n *\n * @public\n */\nexport type PaymentMethodFormErrorCode =\n  (typeof PaymentMethodFormErrorCodes)[keyof typeof PaymentMethodFormErrorCodes]\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 PaymentMethodType = (typeof PAYMENT_METHOD_TYPES)[number]\n\nconst fieldValidators = {\n  type: z.enum(PAYMENT_METHOD_TYPES),\n}\n\n/**\n * Field names accepted by the payment method form.\n *\n * @public\n */\nexport type PaymentMethodFormField = keyof typeof fieldValidators\n\n/**\n * Shape of the values managed by the payment method form.\n *\n * @public\n * @interface\n */\nexport type PaymentMethodFormData = {\n  [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\n/** @internal */\nexport type PaymentMethodFormOutputs = PaymentMethodFormData\n\nconst requiredFieldsConfig = {} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n/**\n * Keys of optional payment method fields that can be promoted to required via\n * the hook's `optionalFieldsToRequire` option.\n *\n * @public\n */\nexport type PaymentMethodFormOptionalFieldsToRequire = OptionalFieldsToRequire<\n  typeof requiredFieldsConfig\n>\n\n/** @internal */\ninterface PaymentMethodFormSchemaOptions {\n  optionalFieldsToRequire?: PaymentMethodFormOptionalFieldsToRequire\n}\n\n/** @internal */\nexport function createPaymentMethodFormSchema(options: PaymentMethodFormSchemaOptions = {}) {\n  return buildFormSchema(fieldValidators, {\n    requiredFieldsConfig,\n    requiredErrorCode: PaymentMethodFormErrorCodes.REQUIRED,\n    mode: 'update',\n    optionalFieldsToRequire: options.optionalFieldsToRequire,\n  })\n}\n"],"names":["PaymentMethodFormErrorCodes","PAYMENT_METHOD_TYPES","PAYMENT_METHODS","fieldValidators","z","requiredFieldsConfig","createPaymentMethodFormSchema","options","buildFormSchema"],"mappings":";;;AAcO,MAAMA,IAA8B;AAAA,EACzC,UAAU;AACZ,GAgBaC,IAAuB,CAACC,EAAgB,eAAeA,EAAgB,KAAK,GASnFC,IAAkB;AAAA,EACtB,MAAMC,EAAE,KAAKH,CAAoB;AACnC,GAqBMI,IAAuB,CAAA;AAkBtB,SAASC,EAA8BC,IAA0C,IAAI;AAC1F,SAAOC,EAAgBL,GAAiB;AAAA,IACtC,sBAAAE;AAAA,IACA,mBAAmBL,EAA4B;AAAA,IAC/C,MAAM;AAAA,IACN,yBAAyBO,EAAQ;AAAA,EAAA,CAClC;AACH;"}