@gusto/embedded-react-sdk 0.53.0 → 0.54.1-rc.1

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

@@ -49,7 +49,12 @@ export interface ContractorBankAccountFormFields {
  * @public
  */
 export interface UseContractorBankAccountFormReady extends BaseFormHookReady<ContractorBankAccountFieldsMetadata, ContractorBankAccountFormData, ContractorBankAccountFormFields> {
-    /** The contractor's current bank account, loaded from the API, if any. */
+    /**
+     * The contractor's current bank account, loaded from the API, if any.
+     * `undefined` whenever the payment method isn't Direct Deposit — including
+     * right after a bank account is removed, since removal only reverts the
+     * payment method to Check and leaves the bank account record on file.
+     */
     data: {
         bankAccount: ContractorBankAccount | undefined;
     };
@@ -72,8 +77,12 @@ export interface UseContractorBankAccountFormReady extends BaseFormHookReady<Con
  * Direct Deposit on the Gusto API as a side-effect, so the Direct Deposit path
  * needs only this submit — no separate payment method update.
  *
- * When the contractor already has a bank account on file, the account number
- * field is pre-filled with the masked token the API returns (e.g. "XXXX1207").
+ * When the contractor's payment method is currently Direct Deposit, the account
+ * number field is pre-filled with the masked token the API returns for that
+ * account (e.g. "XXXX1207"). The bank account API has no proper delete, so
+ * removing a bank account only reverts the payment method to Check and leaves
+ * the account record itself on file — this hook ignores that leftover record
+ * (the form starts blank) until the payment method is Direct Deposit again.
  * The API requires `account_number` on every write and treats that exact masked
  * value as "keep the existing account," so submitting it unchanged preserves the
  * account while still applying any name/routing/type edits; typing a real number

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

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

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/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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"}
+{"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 { useContractorPaymentMethodGet } from '@gusto/embedded-api/react-query/contractorPaymentMethodGet'\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'\nimport { PAYMENT_METHODS } from '@/shared/constants'\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  /**\n   * The contractor's current bank account, loaded from the API, if any.\n   * `undefined` whenever the payment method isn't Direct Deposit — including\n   * right after a bank account is removed, since removal only reverts the\n   * payment method to Check and leaves the bank account record on file.\n   */\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's payment method is currently Direct Deposit, the account\n * number field is pre-filled with the masked token the API returns for that\n * account (e.g. \"XXXX1207\"). The bank account API has no proper delete, so\n * removing a bank account only reverts the payment method to Check and leaves\n * the account record itself on file — this hook ignores that leftover record\n * (the form starts blank) until the payment method is Direct Deposit again.\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 paymentMethodQuery = useContractorPaymentMethodGet({ contractorUuid: contractorId })\n\n  // The bank account API has no proper delete — removing a bank account just\n  // reverts the payment method to Check, leaving the bank account record\n  // itself on file (see gws-flows' BankAccountsController#destroy). So a\n  // bank account returned by the list endpoint is only the contractor's\n  // *current* account when the payment method is actually Direct Deposit;\n  // otherwise it's a detached leftover from a prior removal and must not be\n  // used to prefill this form, or \"Add bank account\" would resurrect stale\n  // data instead of starting blank.\n  const isDirectDeposit =\n    paymentMethodQuery.data?.contractorPaymentMethod?.type === PAYMENT_METHODS.directDeposit\n  const bankAccount = isDirectDeposit\n    ? (bankAccountsQuery.data?.contractorBankAccountList?.[0] ?? undefined)\n    : 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, paymentMethodQuery], {\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 || paymentMethodQuery.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","paymentMethodQuery","useContractorPaymentMethodGet","bankAccount","PAYMENT_METHODS","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/useContractorPaymentMethodSummary/index.d.ts

@@ -0,0 +1 @@
+export { useContractorPaymentMethodSummary, type UseContractorPaymentMethodSummaryParams, type UseContractorPaymentMethodSummaryResult, } from './useContractorPaymentMethodSummary';

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

@@ -0,0 +1,24 @@
+import { ContractorPaymentMethod } from '@gusto/embedded-api/models/components/contractorpaymentmethod';
+import { ContractorBankAccount } from '@gusto/embedded-api/models/components/contractorbankaccount';
+import { BaseHookReady, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
+/** @internal */
+export interface UseContractorPaymentMethodSummaryParams {
+    contractorId: string;
+}
+interface UseContractorPaymentMethodSummaryReady extends BaseHookReady<{
+    paymentMethod: ContractorPaymentMethod;
+    bankAccount: ContractorBankAccount | undefined;
+}, {
+    isFetching: boolean;
+    isPending: boolean;
+}> {
+    actions: {
+        /** Reverts the contractor's payment method to Check. */
+        onRemoveBankAccount: () => Promise<HookSubmitResult<ContractorPaymentMethod> | undefined>;
+    };
+}
+/** @internal */
+export type UseContractorPaymentMethodSummaryResult = HookLoadingResult | UseContractorPaymentMethodSummaryReady;
+/** @internal */
+export declare function useContractorPaymentMethodSummary({ contractorId, }: UseContractorPaymentMethodSummaryParams): UseContractorPaymentMethodSummaryResult;
+export {};

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

@@ -0,0 +1,43 @@
+import { useContractorPaymentMethodGet as d } from "@gusto/embedded-api/react-query/contractorPaymentMethodGet";
+import { useContractorPaymentMethodGetBankAccounts as u } from "@gusto/embedded-api/react-query/contractorPaymentMethodGetBankAccounts";
+import { useContractorPaymentMethodUpdateMutation as y } from "@gusto/embedded-api/react-query/contractorPaymentMethodUpdate";
+import { composeErrorHandler as h } from "../../../../../partner-hook-utils/composeErrorHandler.js";
+import { SDKInternalError as c } from "../../../../../types/sdkError.js";
+import { PAYMENT_METHODS as f } from "../../../../../shared/constants.js";
+function A({
+  contractorId: e
+}) {
+  const t = d(
+    { contractorUuid: e },
+    { staleTime: 1 / 0 }
+  ), o = u(
+    { contractorUuid: e },
+    { staleTime: 1 / 0 }
+  ), r = y(), a = h([t, o]), n = t.data?.contractorPaymentMethod, s = o.data?.contractorBankAccountList?.[0], m = async () => {
+    if (!n?.version)
+      throw new c("Cannot remove bank account before payment method is loaded");
+    const i = await r.mutateAsync({
+      request: {
+        contractorUuid: e,
+        requestBody: { type: f.check, version: n.version }
+      }
+    });
+    if (!i.contractorPaymentMethod)
+      throw new c("Payment method update failed");
+    return { mode: "update", data: i.contractorPaymentMethod };
+  };
+  return t.isLoading || o.isLoading || !n ? { isLoading: !0, errorHandling: a } : {
+    isLoading: !1,
+    data: { paymentMethod: n, bankAccount: s },
+    status: {
+      isFetching: t.isFetching || o.isFetching,
+      isPending: r.isPending
+    },
+    actions: { onRemoveBankAccount: m },
+    errorHandling: a
+  };
+}
+export {
+  A as useContractorPaymentMethodSummary
+};
+//# sourceMappingURL=useContractorPaymentMethodSummary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useContractorPaymentMethodSummary.js","sources":["../../../../../../src/components/Contractor/PaymentMethod/shared/useContractorPaymentMethodSummary/useContractorPaymentMethodSummary.tsx"],"sourcesContent":["import { useContractorPaymentMethodGet } from '@gusto/embedded-api/react-query/contractorPaymentMethodGet'\nimport { useContractorPaymentMethodGetBankAccounts } from '@gusto/embedded-api/react-query/contractorPaymentMethodGetBankAccounts'\nimport { useContractorPaymentMethodUpdateMutation } from '@gusto/embedded-api/react-query/contractorPaymentMethodUpdate'\nimport type { ContractorPaymentMethod } from '@gusto/embedded-api/models/components/contractorpaymentmethod'\nimport type { ContractorBankAccount } from '@gusto/embedded-api/models/components/contractorbankaccount'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type { BaseHookReady, HookLoadingResult, HookSubmitResult } from '@/partner-hook-utils/types'\nimport { SDKInternalError } from '@/types/sdkError'\nimport { PAYMENT_METHODS } from '@/shared/constants'\n\n/** @internal */\nexport interface UseContractorPaymentMethodSummaryParams {\n  contractorId: string\n}\n\ninterface UseContractorPaymentMethodSummaryReady extends BaseHookReady<\n  {\n    paymentMethod: ContractorPaymentMethod\n    bankAccount: ContractorBankAccount | undefined\n  },\n  { isFetching: boolean; isPending: boolean }\n> {\n  actions: {\n    /** Reverts the contractor's payment method to Check. */\n    onRemoveBankAccount: () => Promise<HookSubmitResult<ContractorPaymentMethod> | undefined>\n  }\n}\n\n/** @internal */\nexport type UseContractorPaymentMethodSummaryResult =\n  HookLoadingResult | UseContractorPaymentMethodSummaryReady\n\n/** @internal */\nexport function useContractorPaymentMethodSummary({\n  contractorId,\n}: UseContractorPaymentMethodSummaryParams): UseContractorPaymentMethodSummaryResult {\n  const paymentMethodQuery = useContractorPaymentMethodGet(\n    { contractorUuid: contractorId },\n    { staleTime: Infinity },\n  )\n  const bankAccountsQuery = useContractorPaymentMethodGetBankAccounts(\n    { contractorUuid: contractorId },\n    { staleTime: Infinity },\n  )\n  const removeMutation = useContractorPaymentMethodUpdateMutation()\n\n  const errorHandling = composeErrorHandler([paymentMethodQuery, bankAccountsQuery])\n\n  const paymentMethod = paymentMethodQuery.data?.contractorPaymentMethod\n  const bankAccount = bankAccountsQuery.data?.contractorBankAccountList?.[0]\n\n  const onRemoveBankAccount = async (): Promise<\n    HookSubmitResult<ContractorPaymentMethod> | undefined\n  > => {\n    if (!paymentMethod?.version) {\n      throw new SDKInternalError('Cannot remove bank account before payment method is loaded')\n    }\n    const result = await removeMutation.mutateAsync({\n      request: {\n        contractorUuid: contractorId,\n        requestBody: { type: PAYMENT_METHODS.check, version: paymentMethod.version },\n      },\n    })\n    if (!result.contractorPaymentMethod) {\n      throw new SDKInternalError('Payment method update failed')\n    }\n    return { mode: 'update', data: result.contractorPaymentMethod }\n  }\n\n  if (paymentMethodQuery.isLoading || bankAccountsQuery.isLoading || !paymentMethod) {\n    return { isLoading: true, errorHandling }\n  }\n\n  return {\n    isLoading: false,\n    data: { paymentMethod, bankAccount },\n    status: {\n      isFetching: paymentMethodQuery.isFetching || bankAccountsQuery.isFetching,\n      isPending: removeMutation.isPending,\n    },\n    actions: { onRemoveBankAccount },\n    errorHandling,\n  }\n}\n"],"names":["useContractorPaymentMethodSummary","contractorId","paymentMethodQuery","useContractorPaymentMethodGet","bankAccountsQuery","useContractorPaymentMethodGetBankAccounts","removeMutation","useContractorPaymentMethodUpdateMutation","errorHandling","composeErrorHandler","paymentMethod","bankAccount","onRemoveBankAccount","SDKInternalError","result","PAYMENT_METHODS"],"mappings":";;;;;;AAiCO,SAASA,EAAkC;AAAA,EAChD,cAAAC;AACF,GAAqF;AACnF,QAAMC,IAAqBC;AAAA,IACzB,EAAE,gBAAgBF,EAAA;AAAA,IAClB,EAAE,WAAW,MAAA;AAAA,EAAS,GAElBG,IAAoBC;AAAA,IACxB,EAAE,gBAAgBJ,EAAA;AAAA,IAClB,EAAE,WAAW,MAAA;AAAA,EAAS,GAElBK,IAAiBC,EAAA,GAEjBC,IAAgBC,EAAoB,CAACP,GAAoBE,CAAiB,CAAC,GAE3EM,IAAgBR,EAAmB,MAAM,yBACzCS,IAAcP,EAAkB,MAAM,4BAA4B,CAAC,GAEnEQ,IAAsB,YAEvB;AACH,QAAI,CAACF,GAAe;AAClB,YAAM,IAAIG,EAAiB,4DAA4D;AAEzF,UAAMC,IAAS,MAAMR,EAAe,YAAY;AAAA,MAC9C,SAAS;AAAA,QACP,gBAAgBL;AAAA,QAChB,aAAa,EAAE,MAAMc,EAAgB,OAAO,SAASL,EAAc,QAAA;AAAA,MAAQ;AAAA,IAC7E,CACD;AACD,QAAI,CAACI,EAAO;AACV,YAAM,IAAID,EAAiB,8BAA8B;AAE3D,WAAO,EAAE,MAAM,UAAU,MAAMC,EAAO,wBAAA;AAAA,EACxC;AAEA,SAAIZ,EAAmB,aAAaE,EAAkB,aAAa,CAACM,IAC3D,EAAE,WAAW,IAAM,eAAAF,EAAA,IAGrB;AAAA,IACL,WAAW;AAAA,IACX,MAAM,EAAE,eAAAE,GAAe,aAAAC,EAAA;AAAA,IACvB,QAAQ;AAAA,MACN,YAAYT,EAAmB,cAAcE,EAAkB;AAAA,MAC/D,WAAWE,EAAe;AAAA,IAAA;AAAA,IAE5B,SAAS,EAAE,qBAAAM,EAAA;AAAA,IACX,eAAAJ;AAAA,EAAA;AAEJ;"}

package/dist/components/Contractor/Payments/CreateHistoricalPayment/CreateHistoricalPayment.d.ts

@@ -0,0 +1,41 @@
+import { BaseComponentInterface } from '../../../Base';
+/**
+ * Props for {@link CreateHistoricalPayment}.
+ *
+ * @alpha
+ */
+export interface CreateHistoricalPaymentProps extends BaseComponentInterface<'Contractor.Payments.CreateHistoricalPayment'> {
+    /** UUID of the company recording the historical payment. */
+    companyId: string;
+}
+/**
+ * Records a historical contractor payment — one that already happened outside Gusto and does not
+ * move money — by picking a paid date and the contractors being paid, entering hours, wages,
+ * bonuses, and reimbursements for them, then reviewing and submitting.
+ *
+ * @remarks
+ * Every contractor payment is fixed to the `Historical Payment` payment method, so there is no
+ * payment method choice or debit information to review.
+ * Continue on the contractor-selection step is disabled until the paid date is valid and at least
+ * one contractor is selected. Continue on the amounts step is disabled until at least one selected
+ * contractor has a payment total greater than zero, and swaps the amounts grid for an in-place
+ * review (mirroring `CreatePayment`'s preview step); Edit returns to the grid without losing
+ * entered amounts, and Submit creates the contractor payment group. Once creation succeeds, the
+ * Edit and Submit buttons are replaced with a success message, since the creation token has been
+ * consumed and the host is expected to navigate away (e.g. to `HistoricalPaymentSummary`).
+ *
+ * @events
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `contractor/historicalPayments/edit` | The edit modal was opened for a contractor. | — |
+ * | `contractor/historicalPayments/update` | A contractor's payment values were updated locally. | The updated form values (hours, wage, bonus, reimbursement, payment method, etc.). |
+ * | `contractor/historicalPayments/preview` | The preview API call succeeded. | The contractor payment group preview response. |
+ * | `contractor/historicalPayments/backToEdit` | The user returned from preview to continue editing. | — |
+ * | `contractor/historicalPayments/created` | The payment group was successfully created. | The created contractor payment group response. |
+ *
+ * @param props - See {@link CreateHistoricalPaymentProps}.
+ * @returns The rendered contractor-selection screen, the payment-amounts entry screen, or its
+ * in-place review.
+ * @alpha
+ */
+export declare function CreateHistoricalPayment(props: CreateHistoricalPaymentProps): import("react").JSX.Element;

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

@@ -0,0 +1,175 @@
+import { jsx as t, jsxs as i } from "react/jsx-runtime";
+import { useContractorsListSuspense as j } from "@gusto/embedded-api/react-query/contractorsList";
+import { useContractorPaymentGroupsPreviewMutation as q } from "@gusto/embedded-api/react-query/contractorPaymentGroupsPreview";
+import { useContractorPaymentGroupsCreateMutation as W } from "@gusto/embedded-api/react-query/contractorPaymentGroupsCreate";
+import { RFCDate as O } from "@gusto/embedded-api/types/rfcdate";
+import { useMemo as U, useState as y } from "react";
+import { useTranslation as x } from "react-i18next";
+import { usePaymentAmountsEditor as K } from "../shared/usePaymentAmountsEditor.js";
+import { getHistoricalPaymentCheckDateBounds as V } from "../shared/historicalPaymentDateBounds.js";
+import { useCreateHistoricalPaymentDictionary as z, useCreateHistoricalPaymentReviewDictionary as J } from "./useFormDictionary.js";
+import { formatDateToStringDate as Q } from "../../../../helpers/dateFormatting.js";
+import { Flex as c, FlexItem as X } from "../../../Common/Flex/Flex.js";
+import { ActionsLayout as Z } from "../../../Common/ActionsLayout/ActionsLayout.js";
+import { BaseComponent as $ } from "../../../Base/Base.js";
+import { useBase as tt } from "../../../Base/useBase.js";
+import { useComponentContext as M } from "../../../../contexts/ComponentAdapter/useComponentContext.js";
+import { useI18n as et, useComponentDictionary as nt } from "../../../../i18n/I18n.js";
+import { useDateFormatter as rt } from "../../../../hooks/useDateFormatter.js";
+import { componentEvents as p } from "../../../../shared/constants.js";
+import { SelectContractors as ot } from "../../shared/SelectContractors/SelectContractors.js";
+import { PaymentSummaryBlock as at } from "../shared/PaymentSummaryBlock/PaymentSummaryBlock.js";
+import { SetPaymentAmounts as it } from "../shared/SetPaymentAmounts/SetPaymentAmounts.js";
+const S = ["Historical Payment"];
+function Ot(a) {
+  return /* @__PURE__ */ t($, { ...a, componentName: "Contractor.Payments.CreateHistoricalPayment", children: /* @__PURE__ */ t(ct, { ...a }) });
+}
+function ct({ companyId: a, dictionary: R, onEvent: h }) {
+  et("Contractor.Payments.CreateHistoricalPayment"), nt("Contractor.Payments.CreateHistoricalPayment", R);
+  const { t: e } = x("Contractor.Payments.CreateHistoricalPayment"), { Heading: r, Text: f, Button: u, DatePicker: m } = M(), { minDate: d, maxDate: C } = U(() => V(), []), [o, I] = y(null), [P, E] = y([]), [l, D] = y(null);
+  let s = null;
+  o !== null && o > C ? s = e("select.dateInFutureError") : o !== null && o < d && (s = e("select.dateTooEarlyError", {
+    year: o.getFullYear(),
+    allowedYear: d.getFullYear()
+  }));
+  const T = P.length > 0 && o !== null && s === null, g = () => {
+    if (!T) return;
+    const A = Q(o);
+    A && D({ contractorIds: P, checkDate: A });
+  };
+  return l ? /* @__PURE__ */ t(
+    st,
+    {
+      companyId: a,
+      contractorIds: l.contractorIds,
+      checkDate: l.checkDate,
+      onEvent: h
+    }
+  ) : /* @__PURE__ */ i(c, { flexDirection: "column", gap: 32, children: [
+    /* @__PURE__ */ i(c, { flexDirection: "column", gap: 4, children: [
+      /* @__PURE__ */ t(r, { as: "h2", children: e("select.heading") }),
+      /* @__PURE__ */ t(f, { variant: "supporting", children: e("select.subtitle") })
+    ] }),
+    /* @__PURE__ */ t(
+      m,
+      {
+        label: e("select.dateLabel"),
+        isRequired: !0,
+        value: o,
+        onChange: I,
+        minDate: d,
+        maxDate: C,
+        isInvalid: s !== null,
+        errorMessage: s ?? void 0
+      }
+    ),
+    /* @__PURE__ */ t(ot, { companyId: a, onSelectionChange: E }),
+    /* @__PURE__ */ t(Z, { children: /* @__PURE__ */ t(u, { onClick: g, variant: "primary", isDisabled: !T, children: e("select.continueButton") }) })
+  ] });
+}
+function st({ companyId: a, contractorIds: R, checkDate: h, onEvent: e }) {
+  const { t: r } = x("Contractor.Payments.CreateHistoricalPayment"), { Heading: f, Text: u, Button: m, Alert: d } = M(), { baseSubmitHandler: C } = tt(), { formatLongWithYear: o } = rt(), I = z(), P = J(), { data: E } = j({ companyUuid: a }), l = (E.contractors ?? []).filter(
+    (n) => R.includes(n.uuid)
+  ), { virtualContractorPayments: D, totals: s, editModal: T } = K({
+    contractors: l,
+    allowedPaymentMethods: S,
+    onEditOpen: () => {
+      e(p.CONTRACTOR_HISTORICAL_PAYMENT_EDIT);
+    },
+    onEditSave: (n) => {
+      e(p.CONTRACTOR_HISTORICAL_PAYMENT_UPDATE, n);
+    }
+  }), g = s.total > 0, { mutateAsync: A, isPending: b } = q(), { mutateAsync: B, isPending: L } = W(), [w, k] = y(null), [_, N] = y(!1), H = () => D.filter((n) => n.isTouched).map(({ isTouched: n, ...v }) => v), Y = async () => {
+    g && await C(null, async () => {
+      const n = await A({
+        request: {
+          companyId: a,
+          requestBody: {
+            checkDate: new O(h),
+            contractorPayments: H()
+          }
+        }
+      });
+      k(n.contractorPaymentGroupPreview || null), e(
+        p.CONTRACTOR_HISTORICAL_PAYMENT_PREVIEW,
+        n.contractorPaymentGroupPreview
+      );
+    });
+  }, G = () => {
+    k(null), e(p.CONTRACTOR_HISTORICAL_PAYMENT_BACK_TO_EDIT);
+  }, F = async () => {
+    const n = w?.creationToken;
+    !n || _ || await C(null, async () => {
+      const v = await B({
+        request: {
+          companyId: a,
+          requestBody: {
+            checkDate: new O(h),
+            creationToken: n,
+            contractorPayments: H()
+          }
+        }
+      });
+      v.contractorPaymentGroup && (N(!0), e(
+        p.CONTRACTOR_HISTORICAL_PAYMENT_CREATED,
+        v.contractorPaymentGroup
+      ));
+    });
+  };
+  return w ? /* @__PURE__ */ i(c, { flexDirection: "column", gap: 32, children: [
+    /* @__PURE__ */ i(c, { justifyContent: "space-between", alignItems: "flex-start", gap: 16, children: [
+      /* @__PURE__ */ i(c, { flexDirection: "column", gap: 4, children: [
+        /* @__PURE__ */ t(f, { as: "h2", children: r("review.title") }),
+        /* @__PURE__ */ t(u, { variant: "supporting", children: r("review.subtitle", {
+          checkDate: o(w.checkDate ?? "")
+        }) })
+      ] }),
+      !_ && /* @__PURE__ */ i(c, { justifyContent: "flex-end", gap: 16, children: [
+        /* @__PURE__ */ t(m, { onClick: G, variant: "secondary", children: r("review.editButton") }),
+        /* @__PURE__ */ t(m, { onClick: F, variant: "primary", isLoading: L, children: r("review.submitButton") })
+      ] })
+    ] }),
+    _ && /* @__PURE__ */ t(d, { status: "success", label: r("review.successTitle"), children: /* @__PURE__ */ t(u, { children: r("review.successMessage") }) }),
+    /* @__PURE__ */ t(
+      at,
+      {
+        contractorPaymentGroup: w,
+        contractors: l,
+        showDebitColumns: !1,
+        dictionary: P
+      }
+    )
+  ] }) : /* @__PURE__ */ i(c, { flexDirection: "column", gap: 32, children: [
+    /* @__PURE__ */ i(c, { justifyContent: "flex-end", gap: 16, children: [
+      /* @__PURE__ */ i(c, { flexDirection: "column", gap: 4, children: [
+        /* @__PURE__ */ t(f, { as: "h2", children: r("amounts.heading") }),
+        /* @__PURE__ */ t(u, { variant: "supporting", children: r("amounts.subtitle") })
+      ] }),
+      /* @__PURE__ */ t(X, { children: /* @__PURE__ */ t(
+        m,
+        {
+          onClick: Y,
+          variant: "primary",
+          isDisabled: !g,
+          isLoading: b,
+          children: r("amounts.continueButton")
+        }
+      ) })
+    ] }),
+    /* @__PURE__ */ t(
+      it,
+      {
+        contractors: l,
+        contractorPayments: D,
+        totals: s,
+        allowedPaymentMethods: S,
+        editModal: T,
+        dictionary: I
+      }
+    )
+  ] });
+}
+export {
+  Ot as CreateHistoricalPayment
+};
+//# sourceMappingURL=CreateHistoricalPayment.js.map