@gusto/embedded-react-sdk 0.51.0 → 0.51.2

package/dist/components/Contractor/Address/shared/useContractorAddressForm/useContractorAddressForm.js

@@ -1,9 +1,9 @@
 import { useMemo as A } from "react";
 import { useForm as O } from "react-hook-form";
 import { zodResolver as P } from "@hookform/resolvers/zod";
-import { useContractorsGet as L } from "@gusto/embedded-api-v-2026-02-01/react-query/contractorsGet";
-import { useContractorsGetAddress as Q } from "@gusto/embedded-api-v-2026-02-01/react-query/contractorsGetAddress";
-import { useContractorsUpdateAddressMutation as R } from "@gusto/embedded-api-v-2026-02-01/react-query/contractorsUpdateAddress";
+import { useContractorsGet as L } from "@gusto/embedded-api/react-query/contractorsGet";
+import { useContractorsGetAddress as Q } from "@gusto/embedded-api/react-query/contractorsGetAddress";
+import { useContractorsUpdateAddressMutation as R } from "@gusto/embedded-api/react-query/contractorsUpdateAddress";
 import { createContractorAddressSchema as T } from "./contractorAddressSchema.js";
 import { ZipField as Z, StateField as x, CityField as I, Street2Field as K, Street1Field as _ } from "./fields.js";
 import { useDeriveFieldsMetadata as j } from "../../../../../partner-hook-utils/form/useDeriveFieldsMetadata.js";

package/dist/components/Contractor/Address/shared/useContractorAddressForm/useContractorAddressForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"useContractorAddressForm.js","sources":["../../../../../../src/components/Contractor/Address/shared/useContractorAddressForm/useContractorAddressForm.tsx"],"sourcesContent":["import { useMemo } from 'react'\nimport type { ComponentType } from 'react'\nimport { useForm } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type {\n  Contractor,\n  ContractorType,\n} from '@gusto/embedded-api-v-2026-02-01/models/components/contractor'\nimport type { ContractorAddress } from '@gusto/embedded-api-v-2026-02-01/models/components/contractoraddress'\nimport { useContractorsGet } from '@gusto/embedded-api-v-2026-02-01/react-query/contractorsGet'\nimport { useContractorsGetAddress } from '@gusto/embedded-api-v-2026-02-01/react-query/contractorsGetAddress'\nimport { useContractorsUpdateAddressMutation } from '@gusto/embedded-api-v-2026-02-01/react-query/contractorsUpdateAddress'\nimport {\n  createContractorAddressSchema,\n  type ContractorAddressOptionalFieldsToRequire,\n  type ContractorAddressFormData,\n  type ContractorAddressFormOutputs,\n} from './contractorAddressSchema'\nimport { Street1Field, Street2Field, CityField, StateField, ZipField } from './fields'\nimport type {\n  Street1FieldProps,\n  Street2FieldProps,\n  CityFieldProps,\n  StateFieldProps,\n  ZipFieldProps,\n} 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 { STATES_ABBR } from '@/shared/constants'\n\nexport type { ContractorAddressOptionalFieldsToRequire } from './contractorAddressSchema'\n\n/**\n * Optional overrides passed to {@link UseContractorAddressFormReady.actions.onSubmit | onSubmit}.\n *\n * @public\n */\nexport interface ContractorAddressSubmitOptions {\n  /** Override the contractor identifier supplied to the hook. */\n  contractorId?: string\n}\n\n/**\n * Configuration options for {@link useContractorAddressForm}.\n *\n * @public\n */\nexport interface UseContractorAddressFormProps {\n  /** UUID of the contractor whose address is being edited. */\n  contractorId: string\n  /** Override fields that are optional by default to be required. See `ContractorAddressOptionalFieldsToRequire`. */\n  optionalFieldsToRequire?: ContractorAddressOptionalFieldsToRequire\n  /** Pre-fill form values. Server data takes precedence. */\n  defaultValues?: Partial<ContractorAddressFormData>\n  /** 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` so submit-time focus is coordinated across multiple forms. Defaults to `true`. */\n  shouldFocusError?: boolean\n}\n\n/**\n * Field components exposed by {@link useContractorAddressForm} on `form.Fields`.\n *\n * @public\n */\nexport interface ContractorAddressFormFields {\n  /** Bound to `street1`. Text input for the first street address line. Required. */\n  Street1: ComponentType<Street1FieldProps>\n  /** Bound to `street2`. Text input for the second street address line. Optional. */\n  Street2: ComponentType<Street2FieldProps>\n  /** Bound to `city`. Text input for the city. Required. */\n  City: ComponentType<CityFieldProps>\n  /**\n   * Bound to `state`. Select whose options are the standard two-letter US state\n   * abbreviations. Supply `getOptionLabel` to localize the option labels. Required.\n   */\n  State: ComponentType<StateFieldProps>\n  /**\n   * Bound to `zip`. Text input for the ZIP code. Required; also validates ZIP\n   * format and emits `INVALID_ZIP` when the value does not match.\n   */\n  Zip: ComponentType<ZipFieldProps>\n}\n\n/**\n * Ready-state shape returned by {@link useContractorAddressForm} once data has loaded.\n *\n * @remarks\n * Discriminated by `isLoading: false`. Extends {@link BaseFormHookReady} with\n * the contractor-address-specific `data`, `status`, `actions`, and `form.Fields` shape.\n *\n * @public\n */\nexport interface UseContractorAddressFormReady extends BaseFormHookReady<\n  ContractorAddressFieldsMetadata,\n  ContractorAddressFormData,\n  ContractorAddressFormFields\n> {\n  /** Static entity data resolved from the API. */\n  data: {\n    /** The contractor address row loaded for update. */\n    contractorAddress: ContractorAddress\n    /** The full contractor entity loaded alongside the address. */\n    contractor: Contractor\n    /** The contractor's type — drives whether the address is labelled \"home\" (Individual) or \"business\" (Business). */\n    contractorType: ContractorType | undefined\n  }\n  /** Reactive status flags. */\n  status: { isPending: boolean; mode: 'update' }\n  /** Available actions. */\n  actions: {\n    onSubmit: (\n      options?: ContractorAddressSubmitOptions,\n    ) => Promise<HookSubmitResult<ContractorAddress> | undefined>\n  }\n}\n\n/** @internal */\nfunction buildContractorAddressFieldsMetadata(\n  base: Record<keyof ContractorAddressFormData, FieldMetadata>,\n) {\n  const stateOptions = STATES_ABBR.map(abbr => ({\n    value: abbr,\n    label: abbr,\n  }))\n  return {\n    street1: base.street1,\n    street2: base.street2,\n    city: base.city,\n    state: withOptions(base.state, stateOptions, STATES_ABBR),\n    zip: base.zip,\n  } satisfies FieldsMetadata\n}\n\n/**\n * Form hook for editing a contractor's address.\n *\n * @remarks\n * A contractor always has exactly one address (created with the contractor),\n * so this hook operates only in update mode and issues a PUT on submit. The\n * same address is labelled a \"home\" address for Individual contractors and a\n * \"business\" address for Business contractors; the hook exposes `contractorType`\n * so the consuming component can choose the appropriate copy.\n *\n * @param props - See {@link UseContractorAddressFormProps}.\n * @returns A {@link HookLoadingResult} while loading, or a {@link UseContractorAddressFormReady} once ready.\n * @public\n *\n * @example\n * ```tsx\n * import {\n *   useContractorAddressForm,\n *   SDKFormProvider,\n *   type UseContractorAddressFormReady,\n * } from '@gusto/embedded-react-sdk'\n *\n * function ContractorAddressPage({ contractorId }: { contractorId: string }) {\n *   const contractorAddress = useContractorAddressForm({ contractorId })\n *\n *   if (contractorAddress.isLoading) return <div>Loading...</div>\n *\n *   return <ContractorAddressReady contractorAddress={contractorAddress} />\n * }\n *\n * function ContractorAddressReady({\n *   contractorAddress,\n * }: {\n *   contractorAddress: UseContractorAddressFormReady\n * }) {\n *   const { Fields } = contractorAddress.form\n *\n *   return (\n *     <SDKFormProvider formHookResult={contractorAddress}>\n *       <form onSubmit={e => { e.preventDefault(); void contractorAddress.actions.onSubmit() }}>\n *         <Fields.Street1 label=\"Street address\" />\n *         <Fields.Street2 label=\"Apt, suite, etc. (optional)\" />\n *         <Fields.City label=\"City\" />\n *         <Fields.State label=\"State\" />\n *         <Fields.Zip label=\"ZIP code\" />\n *         <button type=\"submit\" disabled={contractorAddress.status.isPending}>Save</button>\n *       </form>\n *     </SDKFormProvider>\n *   )\n * }\n * ```\n */\nexport function useContractorAddressForm({\n  contractorId,\n  optionalFieldsToRequire,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseContractorAddressFormProps): HookLoadingResult | UseContractorAddressFormReady {\n  const contractorQuery = useContractorsGet(\n    { contractorUuid: contractorId },\n    { enabled: !!contractorId },\n  )\n  const addressQuery = useContractorsGetAddress(\n    { contractorUuid: contractorId },\n    { enabled: !!contractorId },\n  )\n\n  const contractor = contractorQuery.data?.contractor\n  const contractorType = contractor?.type\n  const fetchedAddress = addressQuery.data?.contractorAddress\n\n  const [schema, metadataConfig] = useMemo(\n    () => createContractorAddressSchema({ optionalFieldsToRequire }),\n    [optionalFieldsToRequire],\n  )\n\n  const resolvedDefaults: ContractorAddressFormData = useMemo(\n    () => ({\n      street1: fetchedAddress?.street1 ?? partnerDefaults?.street1 ?? '',\n      street2: fetchedAddress?.street2 ?? partnerDefaults?.street2 ?? '',\n      city: fetchedAddress?.city ?? partnerDefaults?.city ?? '',\n      state: fetchedAddress?.state ?? partnerDefaults?.state ?? '',\n      zip: fetchedAddress?.zip ?? partnerDefaults?.zip ?? '',\n    }),\n    [fetchedAddress, partnerDefaults],\n  )\n\n  const formMethods = useForm<ContractorAddressFormData, unknown, ContractorAddressFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const updateAddressMutation = useContractorsUpdateAddressMutation()\n\n  const isPending = updateAddressMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('ContractorAddressForm')\n\n  const errorHandling = composeErrorHandler([contractorQuery, addressQuery], {\n    submitError,\n    setSubmitError,\n  })\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const fieldsMetadata = buildContractorAddressFieldsMetadata(baseMetadata)\n\n  const onSubmit = async (\n    options?: ContractorAddressSubmitOptions,\n  ): Promise<HookSubmitResult<ContractorAddress> | undefined> => {\n    let submitResult: HookSubmitResult<ContractorAddress> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: ContractorAddressFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const resolvedContractorId = options?.contractorId ?? contractorId\n\n            if (!fetchedAddress?.version) {\n              throw new SDKInternalError(\n                'Cannot update contractor address: no matching address on file',\n              )\n            }\n\n            const result = await updateAddressMutation.mutateAsync({\n              request: {\n                contractorUuid: resolvedContractorId,\n                contractorAddressUpdateBody: {\n                  version: fetchedAddress.version,\n                  street1: payload.street1,\n                  street2: payload.street2 || undefined,\n                  city: payload.city,\n                  state: payload.state,\n                  zip: payload.zip,\n                },\n              },\n            })\n\n            if (!result.contractorAddress) {\n              throw new SDKInternalError('Contractor address update failed')\n            }\n\n            submitResult = {\n              mode: 'update',\n              data: result.contractorAddress,\n            }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  if (!contractor || !fetchedAddress) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: {\n      contractorAddress: fetchedAddress,\n      contractor,\n      contractorType,\n    },\n    status: {\n      isPending,\n      mode: 'update' as const,\n    },\n    actions: { onSubmit },\n    errorHandling,\n    form: {\n      Fields: {\n        Street1: Street1Field,\n        Street2: Street2Field,\n        City: CityField,\n        State: StateField,\n        Zip: ZipField,\n      },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\n/**\n * Discriminated union returned by {@link useContractorAddressForm}.\n *\n * @public\n */\nexport type UseContractorAddressFormResult = HookLoadingResult | UseContractorAddressFormReady\n/**\n * Type of `form.fieldsMetadata` returned by {@link useContractorAddressForm}.\n *\n * @public\n */\nexport type ContractorAddressFieldsMetadata = ReturnType<\n  typeof buildContractorAddressFieldsMetadata\n>\n"],"names":["buildContractorAddressFieldsMetadata","base","stateOptions","STATES_ABBR","abbr","withOptions","useContractorAddressForm","contractorId","optionalFieldsToRequire","partnerDefaults","validationMode","shouldFocusError","contractorQuery","useContractorsGet","addressQuery","useContractorsGetAddress","contractor","contractorType","fetchedAddress","schema","metadataConfig","useMemo","createContractorAddressSchema","resolvedDefaults","formMethods","useForm","zodResolver","updateAddressMutation","useContractorsUpdateAddressMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","onSubmit","options","submitResult","resolve","data","payload","resolvedContractorId","SDKInternalError","result","hookFormInternals","useHookFormInternals","Street1Field","Street2Field","CityField","StateField","ZipField","createGetFormSubmissionValues"],"mappings":"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"}
+{"version":3,"file":"useContractorAddressForm.js","sources":["../../../../../../src/components/Contractor/Address/shared/useContractorAddressForm/useContractorAddressForm.tsx"],"sourcesContent":["import { useMemo } from 'react'\nimport type { ComponentType } from 'react'\nimport { useForm } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { Contractor, ContractorType } from '@gusto/embedded-api/models/components/contractor'\nimport type { ContractorAddress } from '@gusto/embedded-api/models/components/contractoraddress'\nimport { useContractorsGet } from '@gusto/embedded-api/react-query/contractorsGet'\nimport { useContractorsGetAddress } from '@gusto/embedded-api/react-query/contractorsGetAddress'\nimport { useContractorsUpdateAddressMutation } from '@gusto/embedded-api/react-query/contractorsUpdateAddress'\nimport {\n  createContractorAddressSchema,\n  type ContractorAddressOptionalFieldsToRequire,\n  type ContractorAddressFormData,\n  type ContractorAddressFormOutputs,\n} from './contractorAddressSchema'\nimport { Street1Field, Street2Field, CityField, StateField, ZipField } from './fields'\nimport type {\n  Street1FieldProps,\n  Street2FieldProps,\n  CityFieldProps,\n  StateFieldProps,\n  ZipFieldProps,\n} 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 { STATES_ABBR } from '@/shared/constants'\n\nexport type { ContractorAddressOptionalFieldsToRequire } from './contractorAddressSchema'\n\n/**\n * Optional overrides passed to {@link UseContractorAddressFormReady.actions.onSubmit | onSubmit}.\n *\n * @public\n */\nexport interface ContractorAddressSubmitOptions {\n  /** Override the contractor identifier supplied to the hook. */\n  contractorId?: string\n}\n\n/**\n * Configuration options for {@link useContractorAddressForm}.\n *\n * @public\n */\nexport interface UseContractorAddressFormProps {\n  /** UUID of the contractor whose address is being edited. */\n  contractorId: string\n  /** Override fields that are optional by default to be required. See `ContractorAddressOptionalFieldsToRequire`. */\n  optionalFieldsToRequire?: ContractorAddressOptionalFieldsToRequire\n  /** Pre-fill form values. Server data takes precedence. */\n  defaultValues?: Partial<ContractorAddressFormData>\n  /** 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` so submit-time focus is coordinated across multiple forms. Defaults to `true`. */\n  shouldFocusError?: boolean\n}\n\n/**\n * Field components exposed by {@link useContractorAddressForm} on `form.Fields`.\n *\n * @public\n */\nexport interface ContractorAddressFormFields {\n  /** Bound to `street1`. Text input for the first street address line. Required. */\n  Street1: ComponentType<Street1FieldProps>\n  /** Bound to `street2`. Text input for the second street address line. Optional. */\n  Street2: ComponentType<Street2FieldProps>\n  /** Bound to `city`. Text input for the city. Required. */\n  City: ComponentType<CityFieldProps>\n  /**\n   * Bound to `state`. Select whose options are the standard two-letter US state\n   * abbreviations. Supply `getOptionLabel` to localize the option labels. Required.\n   */\n  State: ComponentType<StateFieldProps>\n  /**\n   * Bound to `zip`. Text input for the ZIP code. Required; also validates ZIP\n   * format and emits `INVALID_ZIP` when the value does not match.\n   */\n  Zip: ComponentType<ZipFieldProps>\n}\n\n/**\n * Ready-state shape returned by {@link useContractorAddressForm} once data has loaded.\n *\n * @remarks\n * Discriminated by `isLoading: false`. Extends {@link BaseFormHookReady} with\n * the contractor-address-specific `data`, `status`, `actions`, and `form.Fields` shape.\n *\n * @public\n */\nexport interface UseContractorAddressFormReady extends BaseFormHookReady<\n  ContractorAddressFieldsMetadata,\n  ContractorAddressFormData,\n  ContractorAddressFormFields\n> {\n  /** Static entity data resolved from the API. */\n  data: {\n    /** The contractor address row loaded for update. */\n    contractorAddress: ContractorAddress\n    /** The full contractor entity loaded alongside the address. */\n    contractor: Contractor\n    /** The contractor's type — drives whether the address is labelled \"home\" (Individual) or \"business\" (Business). */\n    contractorType: ContractorType | undefined\n  }\n  /** Reactive status flags. */\n  status: { isPending: boolean; mode: 'update' }\n  /** Available actions. */\n  actions: {\n    onSubmit: (\n      options?: ContractorAddressSubmitOptions,\n    ) => Promise<HookSubmitResult<ContractorAddress> | undefined>\n  }\n}\n\n/** @internal */\nfunction buildContractorAddressFieldsMetadata(\n  base: Record<keyof ContractorAddressFormData, FieldMetadata>,\n) {\n  const stateOptions = STATES_ABBR.map(abbr => ({\n    value: abbr,\n    label: abbr,\n  }))\n  return {\n    street1: base.street1,\n    street2: base.street2,\n    city: base.city,\n    state: withOptions(base.state, stateOptions, STATES_ABBR),\n    zip: base.zip,\n  } satisfies FieldsMetadata\n}\n\n/**\n * Form hook for editing a contractor's address.\n *\n * @remarks\n * A contractor always has exactly one address (created with the contractor),\n * so this hook operates only in update mode and issues a PUT on submit. The\n * same address is labelled a \"home\" address for Individual contractors and a\n * \"business\" address for Business contractors; the hook exposes `contractorType`\n * so the consuming component can choose the appropriate copy.\n *\n * @param props - See {@link UseContractorAddressFormProps}.\n * @returns A {@link HookLoadingResult} while loading, or a {@link UseContractorAddressFormReady} once ready.\n * @public\n *\n * @example\n * ```tsx\n * import {\n *   useContractorAddressForm,\n *   SDKFormProvider,\n *   type UseContractorAddressFormReady,\n * } from '@gusto/embedded-react-sdk'\n *\n * function ContractorAddressPage({ contractorId }: { contractorId: string }) {\n *   const contractorAddress = useContractorAddressForm({ contractorId })\n *\n *   if (contractorAddress.isLoading) return <div>Loading...</div>\n *\n *   return <ContractorAddressReady contractorAddress={contractorAddress} />\n * }\n *\n * function ContractorAddressReady({\n *   contractorAddress,\n * }: {\n *   contractorAddress: UseContractorAddressFormReady\n * }) {\n *   const { Fields } = contractorAddress.form\n *\n *   return (\n *     <SDKFormProvider formHookResult={contractorAddress}>\n *       <form onSubmit={e => { e.preventDefault(); void contractorAddress.actions.onSubmit() }}>\n *         <Fields.Street1 label=\"Street address\" />\n *         <Fields.Street2 label=\"Apt, suite, etc. (optional)\" />\n *         <Fields.City label=\"City\" />\n *         <Fields.State label=\"State\" />\n *         <Fields.Zip label=\"ZIP code\" />\n *         <button type=\"submit\" disabled={contractorAddress.status.isPending}>Save</button>\n *       </form>\n *     </SDKFormProvider>\n *   )\n * }\n * ```\n */\nexport function useContractorAddressForm({\n  contractorId,\n  optionalFieldsToRequire,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseContractorAddressFormProps): HookLoadingResult | UseContractorAddressFormReady {\n  const contractorQuery = useContractorsGet(\n    { contractorUuid: contractorId },\n    { enabled: !!contractorId },\n  )\n  const addressQuery = useContractorsGetAddress(\n    { contractorUuid: contractorId },\n    { enabled: !!contractorId },\n  )\n\n  const contractor = contractorQuery.data?.contractor\n  const contractorType = contractor?.type\n  const fetchedAddress = addressQuery.data?.contractorAddress\n\n  const [schema, metadataConfig] = useMemo(\n    () => createContractorAddressSchema({ optionalFieldsToRequire }),\n    [optionalFieldsToRequire],\n  )\n\n  const resolvedDefaults: ContractorAddressFormData = useMemo(\n    () => ({\n      street1: fetchedAddress?.street1 ?? partnerDefaults?.street1 ?? '',\n      street2: fetchedAddress?.street2 ?? partnerDefaults?.street2 ?? '',\n      city: fetchedAddress?.city ?? partnerDefaults?.city ?? '',\n      state: fetchedAddress?.state ?? partnerDefaults?.state ?? '',\n      zip: fetchedAddress?.zip ?? partnerDefaults?.zip ?? '',\n    }),\n    [fetchedAddress, partnerDefaults],\n  )\n\n  const formMethods = useForm<ContractorAddressFormData, unknown, ContractorAddressFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const updateAddressMutation = useContractorsUpdateAddressMutation()\n\n  const isPending = updateAddressMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('ContractorAddressForm')\n\n  const errorHandling = composeErrorHandler([contractorQuery, addressQuery], {\n    submitError,\n    setSubmitError,\n  })\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const fieldsMetadata = buildContractorAddressFieldsMetadata(baseMetadata)\n\n  const onSubmit = async (\n    options?: ContractorAddressSubmitOptions,\n  ): Promise<HookSubmitResult<ContractorAddress> | undefined> => {\n    let submitResult: HookSubmitResult<ContractorAddress> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: ContractorAddressFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const resolvedContractorId = options?.contractorId ?? contractorId\n\n            if (!fetchedAddress?.version) {\n              throw new SDKInternalError(\n                'Cannot update contractor address: no matching address on file',\n              )\n            }\n\n            const result = await updateAddressMutation.mutateAsync({\n              request: {\n                contractorUuid: resolvedContractorId,\n                contractorAddressUpdateBody: {\n                  version: fetchedAddress.version,\n                  street1: payload.street1,\n                  street2: payload.street2 || undefined,\n                  city: payload.city,\n                  state: payload.state,\n                  zip: payload.zip,\n                },\n              },\n            })\n\n            if (!result.contractorAddress) {\n              throw new SDKInternalError('Contractor address update failed')\n            }\n\n            submitResult = {\n              mode: 'update',\n              data: result.contractorAddress,\n            }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  if (!contractor || !fetchedAddress) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: {\n      contractorAddress: fetchedAddress,\n      contractor,\n      contractorType,\n    },\n    status: {\n      isPending,\n      mode: 'update' as const,\n    },\n    actions: { onSubmit },\n    errorHandling,\n    form: {\n      Fields: {\n        Street1: Street1Field,\n        Street2: Street2Field,\n        City: CityField,\n        State: StateField,\n        Zip: ZipField,\n      },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\n/**\n * Discriminated union returned by {@link useContractorAddressForm}.\n *\n * @public\n */\nexport type UseContractorAddressFormResult = HookLoadingResult | UseContractorAddressFormReady\n/**\n * Type of `form.fieldsMetadata` returned by {@link useContractorAddressForm}.\n *\n * @public\n */\nexport type ContractorAddressFieldsMetadata = ReturnType<\n  typeof buildContractorAddressFieldsMetadata\n>\n"],"names":["buildContractorAddressFieldsMetadata","base","stateOptions","STATES_ABBR","abbr","withOptions","useContractorAddressForm","contractorId","optionalFieldsToRequire","partnerDefaults","validationMode","shouldFocusError","contractorQuery","useContractorsGet","addressQuery","useContractorsGetAddress","contractor","contractorType","fetchedAddress","schema","metadataConfig","useMemo","createContractorAddressSchema","resolvedDefaults","formMethods","useForm","zodResolver","updateAddressMutation","useContractorsUpdateAddressMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","onSubmit","options","submitResult","resolve","data","payload","resolvedContractorId","SDKInternalError","result","hookFormInternals","useHookFormInternals","Street1Field","Street2Field","CityField","StateField","ZipField","createGetFormSubmissionValues"],"mappings":"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"}

package/dist/components/Contractor/ContractorList/index.js

@@ -1,6 +1,6 @@
 import { jsx as t, jsxs as l } from "react/jsx-runtime";
 import { useTranslation as d } from "react-i18next";
-import { useContractorsDeleteMutation as w } from "@gusto/embedded-api-v-2026-02-01/react-query/contractorsDelete";
+import { useContractorsDeleteMutation as w } from "@gusto/embedded-api/react-query/contractorsDelete";
 import { useContractors as H } from "./useContractorList.js";
 import { Flex as f } from "../../Common/Flex/Flex.js";
 import { EmptyData as k } from "../../Common/EmptyData/EmptyData.js";

package/dist/components/Contractor/ContractorList/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../src/components/Contractor/ContractorList/index.tsx"],"sourcesContent":["import { type Contractor } from '@gusto/embedded-api-v-2026-02-01/models/components/contractor'\nimport { useTranslation } from 'react-i18next'\nimport { useContractorsDeleteMutation } from '@gusto/embedded-api-v-2026-02-01/react-query/contractorsDelete'\nimport { useContractors } from './useContractorList'\nimport { ActionsLayout, DataView, EmptyData, Flex, useDataView } from '@/components/Common'\nimport { firstLastName } from '@/helpers/formattedStrings'\nimport { HamburgerMenu } from '@/components/Common/HamburgerMenu/HamburgerMenu'\nimport PencilSvg from '@/assets/icons/pencil.svg?react'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { ContractorOnboardingStatusBadge } from '@/components/Common/OnboardingStatusBadge'\nimport { useI18n, useComponentDictionary } from '@/i18n'\nimport { BaseComponent, useBase, type BaseComponentInterface } from '@/components/Base'\nimport { componentEvents, CONTRACTOR_TYPE } from '@/shared/constants'\nimport TrashCanSvg from '@/assets/icons/trashcan.svg?react'\n\ninterface HeadProps {\n  count: number\n  handleAdd: () => void\n}\nfunction Head({ count, handleAdd }: HeadProps) {\n  const { Button, Heading } = useComponentContext()\n  const { t } = useTranslation('Contractor.ContractorList')\n\n  return (\n    <Flex alignItems=\"center\" justifyContent=\"space-between\">\n      <Heading as=\"h2\">{t('title')}</Heading>\n\n      {count !== 0 && (\n        <Button variant=\"secondary\" onClick={handleAdd}>\n          {t('addAnotherCta')}\n        </Button>\n      )}\n    </Flex>\n  )\n}\n\ninterface EmptyDataContractorsListProps {\n  handleAdd: () => void\n}\nfunction EmptyDataContractorsList({ handleAdd }: EmptyDataContractorsListProps) {\n  const { Button } = useComponentContext()\n  const { t } = useTranslation('Contractor.ContractorList')\n\n  return (\n    <EmptyData title={t('emptyTableTitle')} description={t('emptyTableDescription')}>\n      <ActionsLayout justifyContent=\"center\">\n        <Button onClick={handleAdd}>{t('addContractorCta')}</Button>\n      </ActionsLayout>\n    </EmptyData>\n  )\n}\n\n/**\n * Props for {@link ContractorList}.\n *\n * @public\n */\nexport interface ContractorListProps extends BaseComponentInterface<'Contractor.ContractorList'> {\n  /** UUID of the company whose contractors should be listed. */\n  companyId: string\n  /** Success message to display in an alert above the list, typically after a create, update, or delete action. */\n  successMessage?: string\n}\n\n/**\n * Lists a company's contractors with controls to add, edit, delete, and continue onboarding.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `contractor/create` | The add-contractor action was triggered. | — |\n * | `contractor/update` | A contractor row's edit action was triggered. | `{ contractorId: string }` |\n * | `contractor/deleted` | A contractor was successfully deleted. | `{ contractorId: string }` |\n * | `contractor/onboarding/continue` | The continue action was triggered to advance onboarding. | — |\n *\n * @param props - See {@link ContractorListProps}.\n * @returns The rendered contractor list.\n * @public\n */\nexport function ContractorList(props: ContractorListProps) {\n  return (\n    <BaseComponent {...props}>\n      <Root {...props}>{props.children}</Root>\n    </BaseComponent>\n  )\n}\n\nfunction Root({ companyId, className, dictionary, successMessage }: ContractorListProps) {\n  useI18n('Contractor.ContractorList')\n  useComponentDictionary('Contractor.ContractorList', dictionary)\n  const { t } = useTranslation('Contractor.ContractorList')\n  const { onEvent, baseSubmitHandler } = useBase()\n  const { Alert, Button } = useComponentContext()\n  const {\n    contractors,\n    totalCount,\n    handleNextPage,\n    handleFirstPage,\n    handleLastPage,\n    handlePreviousPage,\n    handleItemsPerPageChange,\n    currentPage,\n    totalPages,\n    itemsPerPage,\n  } = useContractors({ companyUuid: companyId })\n  const { mutateAsync: deleteContractorMutation, isPending: isPendingDelete } =\n    useContractorsDeleteMutation()\n\n  const dataViewProps = useDataView<Contractor>({\n    columns: [\n      {\n        title: t('listHeaders.name'),\n        render: contractor =>\n          contractor.type === CONTRACTOR_TYPE.BUSINESS\n            ? contractor.businessName\n            : firstLastName({ first_name: contractor.firstName, last_name: contractor.lastName }),\n      },\n      {\n        title: t('listHeaders.status'),\n        render: ({ onboarded, onboardingStatus }) => (\n          <ContractorOnboardingStatusBadge\n            onboarded={onboarded}\n            onboardingStatus={onboardingStatus}\n          />\n        ),\n      },\n    ],\n    data: contractors,\n    itemMenu: contractor => (\n      <HamburgerMenu\n        items={[\n          {\n            label: t('editCta'),\n            icon: <PencilSvg aria-hidden />,\n            onClick: () => {\n              handleEdit(contractor.uuid)\n            },\n          },\n          {\n            label: t('deleteCta'),\n            icon: <TrashCanSvg aria-hidden />,\n            onClick: () => {\n              void handleDelete(contractor.uuid)\n            },\n          },\n        ]}\n        triggerLabel={t('editCta')}\n        isLoading={isPendingDelete}\n      />\n    ),\n    emptyState: () => <EmptyDataContractorsList handleAdd={handleAdd} />,\n    pagination: {\n      handleNextPage,\n      handleFirstPage,\n      handleLastPage,\n      handlePreviousPage,\n      handleItemsPerPageChange,\n      currentPage,\n      totalPages,\n      totalCount,\n      itemsPerPage,\n    },\n  })\n\n  const handleAdd = () => {\n    onEvent(componentEvents.CONTRACTOR_CREATE)\n  }\n\n  const handleEdit = (uuid: string) => {\n    onEvent(componentEvents.CONTRACTOR_UPDATE, { contractorId: uuid })\n  }\n\n  const handleContinue = () => {\n    onEvent(componentEvents.CONTRACTOR_ONBOARDING_CONTINUE)\n  }\n\n  const handleDelete = async (uuid: string) => {\n    await baseSubmitHandler(uuid, async payload => {\n      await deleteContractorMutation({\n        request: { contractorUuid: payload },\n      })\n\n      onEvent(componentEvents.CONTRACTOR_DELETED, { contractorId: payload })\n    })\n  }\n\n  return (\n    <section className={className}>\n      {successMessage && <Alert label={successMessage} status=\"success\" />}\n      <Flex flexDirection=\"column\">\n        <Head count={totalCount} handleAdd={handleAdd} />\n        <DataView label={t('contractorListLabel')} {...dataViewProps} />\n        <ActionsLayout>\n          <Button onClick={handleContinue} isLoading={false}>\n            {t('continueCta')}\n          </Button>\n        </ActionsLayout>\n      </Flex>\n    </section>\n  )\n}\n"],"names":["Head","count","handleAdd","Button","Heading","useComponentContext","t","useTranslation","jsxs","Flex","jsx","EmptyDataContractorsList","EmptyData","ActionsLayout","ContractorList","props","BaseComponent","Root","companyId","className","dictionary","successMessage","useI18n","useComponentDictionary","onEvent","baseSubmitHandler","useBase","Alert","contractors","totalCount","handleNextPage","handleFirstPage","handleLastPage","handlePreviousPage","handleItemsPerPageChange","currentPage","totalPages","itemsPerPage","useContractors","deleteContractorMutation","isPendingDelete","useContractorsDeleteMutation","dataViewProps","useDataView","contractor","CONTRACTOR_TYPE","firstLastName","onboarded","onboardingStatus","ContractorOnboardingStatusBadge","HamburgerMenu","PencilSvg","handleEdit","TrashCanSvg","handleDelete","componentEvents","uuid","handleContinue","payload","DataView"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../../../src/components/Contractor/ContractorList/index.tsx"],"sourcesContent":["import { type Contractor } from '@gusto/embedded-api/models/components/contractor'\nimport { useTranslation } from 'react-i18next'\nimport { useContractorsDeleteMutation } from '@gusto/embedded-api/react-query/contractorsDelete'\nimport { useContractors } from './useContractorList'\nimport { ActionsLayout, DataView, EmptyData, Flex, useDataView } from '@/components/Common'\nimport { firstLastName } from '@/helpers/formattedStrings'\nimport { HamburgerMenu } from '@/components/Common/HamburgerMenu/HamburgerMenu'\nimport PencilSvg from '@/assets/icons/pencil.svg?react'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { ContractorOnboardingStatusBadge } from '@/components/Common/OnboardingStatusBadge'\nimport { useI18n, useComponentDictionary } from '@/i18n'\nimport { BaseComponent, useBase, type BaseComponentInterface } from '@/components/Base'\nimport { componentEvents, CONTRACTOR_TYPE } from '@/shared/constants'\nimport TrashCanSvg from '@/assets/icons/trashcan.svg?react'\n\ninterface HeadProps {\n  count: number\n  handleAdd: () => void\n}\nfunction Head({ count, handleAdd }: HeadProps) {\n  const { Button, Heading } = useComponentContext()\n  const { t } = useTranslation('Contractor.ContractorList')\n\n  return (\n    <Flex alignItems=\"center\" justifyContent=\"space-between\">\n      <Heading as=\"h2\">{t('title')}</Heading>\n\n      {count !== 0 && (\n        <Button variant=\"secondary\" onClick={handleAdd}>\n          {t('addAnotherCta')}\n        </Button>\n      )}\n    </Flex>\n  )\n}\n\ninterface EmptyDataContractorsListProps {\n  handleAdd: () => void\n}\nfunction EmptyDataContractorsList({ handleAdd }: EmptyDataContractorsListProps) {\n  const { Button } = useComponentContext()\n  const { t } = useTranslation('Contractor.ContractorList')\n\n  return (\n    <EmptyData title={t('emptyTableTitle')} description={t('emptyTableDescription')}>\n      <ActionsLayout justifyContent=\"center\">\n        <Button onClick={handleAdd}>{t('addContractorCta')}</Button>\n      </ActionsLayout>\n    </EmptyData>\n  )\n}\n\n/**\n * Props for {@link ContractorList}.\n *\n * @public\n */\nexport interface ContractorListProps extends BaseComponentInterface<'Contractor.ContractorList'> {\n  /** UUID of the company whose contractors should be listed. */\n  companyId: string\n  /** Success message to display in an alert above the list, typically after a create, update, or delete action. */\n  successMessage?: string\n}\n\n/**\n * Lists a company's contractors with controls to add, edit, delete, and continue onboarding.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `contractor/create` | The add-contractor action was triggered. | — |\n * | `contractor/update` | A contractor row's edit action was triggered. | `{ contractorId: string }` |\n * | `contractor/deleted` | A contractor was successfully deleted. | `{ contractorId: string }` |\n * | `contractor/onboarding/continue` | The continue action was triggered to advance onboarding. | — |\n *\n * @param props - See {@link ContractorListProps}.\n * @returns The rendered contractor list.\n * @public\n */\nexport function ContractorList(props: ContractorListProps) {\n  return (\n    <BaseComponent {...props}>\n      <Root {...props}>{props.children}</Root>\n    </BaseComponent>\n  )\n}\n\nfunction Root({ companyId, className, dictionary, successMessage }: ContractorListProps) {\n  useI18n('Contractor.ContractorList')\n  useComponentDictionary('Contractor.ContractorList', dictionary)\n  const { t } = useTranslation('Contractor.ContractorList')\n  const { onEvent, baseSubmitHandler } = useBase()\n  const { Alert, Button } = useComponentContext()\n  const {\n    contractors,\n    totalCount,\n    handleNextPage,\n    handleFirstPage,\n    handleLastPage,\n    handlePreviousPage,\n    handleItemsPerPageChange,\n    currentPage,\n    totalPages,\n    itemsPerPage,\n  } = useContractors({ companyUuid: companyId })\n  const { mutateAsync: deleteContractorMutation, isPending: isPendingDelete } =\n    useContractorsDeleteMutation()\n\n  const dataViewProps = useDataView<Contractor>({\n    columns: [\n      {\n        title: t('listHeaders.name'),\n        render: contractor =>\n          contractor.type === CONTRACTOR_TYPE.BUSINESS\n            ? contractor.businessName\n            : firstLastName({ first_name: contractor.firstName, last_name: contractor.lastName }),\n      },\n      {\n        title: t('listHeaders.status'),\n        render: ({ onboarded, onboardingStatus }) => (\n          <ContractorOnboardingStatusBadge\n            onboarded={onboarded}\n            onboardingStatus={onboardingStatus}\n          />\n        ),\n      },\n    ],\n    data: contractors,\n    itemMenu: contractor => (\n      <HamburgerMenu\n        items={[\n          {\n            label: t('editCta'),\n            icon: <PencilSvg aria-hidden />,\n            onClick: () => {\n              handleEdit(contractor.uuid)\n            },\n          },\n          {\n            label: t('deleteCta'),\n            icon: <TrashCanSvg aria-hidden />,\n            onClick: () => {\n              void handleDelete(contractor.uuid)\n            },\n          },\n        ]}\n        triggerLabel={t('editCta')}\n        isLoading={isPendingDelete}\n      />\n    ),\n    emptyState: () => <EmptyDataContractorsList handleAdd={handleAdd} />,\n    pagination: {\n      handleNextPage,\n      handleFirstPage,\n      handleLastPage,\n      handlePreviousPage,\n      handleItemsPerPageChange,\n      currentPage,\n      totalPages,\n      totalCount,\n      itemsPerPage,\n    },\n  })\n\n  const handleAdd = () => {\n    onEvent(componentEvents.CONTRACTOR_CREATE)\n  }\n\n  const handleEdit = (uuid: string) => {\n    onEvent(componentEvents.CONTRACTOR_UPDATE, { contractorId: uuid })\n  }\n\n  const handleContinue = () => {\n    onEvent(componentEvents.CONTRACTOR_ONBOARDING_CONTINUE)\n  }\n\n  const handleDelete = async (uuid: string) => {\n    await baseSubmitHandler(uuid, async payload => {\n      await deleteContractorMutation({\n        request: { contractorUuid: payload },\n      })\n\n      onEvent(componentEvents.CONTRACTOR_DELETED, { contractorId: payload })\n    })\n  }\n\n  return (\n    <section className={className}>\n      {successMessage && <Alert label={successMessage} status=\"success\" />}\n      <Flex flexDirection=\"column\">\n        <Head count={totalCount} handleAdd={handleAdd} />\n        <DataView label={t('contractorListLabel')} {...dataViewProps} />\n        <ActionsLayout>\n          <Button onClick={handleContinue} isLoading={false}>\n            {t('continueCta')}\n          </Button>\n        </ActionsLayout>\n      </Flex>\n    </section>\n  )\n}\n"],"names":["Head","count","handleAdd","Button","Heading","useComponentContext","t","useTranslation","jsxs","Flex","jsx","EmptyDataContractorsList","EmptyData","ActionsLayout","ContractorList","props","BaseComponent","Root","companyId","className","dictionary","successMessage","useI18n","useComponentDictionary","onEvent","baseSubmitHandler","useBase","Alert","contractors","totalCount","handleNextPage","handleFirstPage","handleLastPage","handlePreviousPage","handleItemsPerPageChange","currentPage","totalPages","itemsPerPage","useContractors","deleteContractorMutation","isPendingDelete","useContractorsDeleteMutation","dataViewProps","useDataView","contractor","CONTRACTOR_TYPE","firstLastName","onboarded","onboardingStatus","ContractorOnboardingStatusBadge","HamburgerMenu","PencilSvg","handleEdit","TrashCanSvg","handleDelete","componentEvents","uuid","handleContinue","payload","DataView"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,SAASA,EAAK,EAAE,OAAAC,GAAO,WAAAC,KAAwB;AAC7C,QAAM,EAAE,QAAAC,GAAQ,SAAAC,EAAA,IAAYC,EAAA,GACtB,EAAE,GAAAC,EAAA,IAAMC,EAAe,2BAA2B;AAExD,SACE,gBAAAC,EAACC,GAAA,EAAK,YAAW,UAAS,gBAAe,iBACvC,UAAA;AAAA,IAAA,gBAAAC,EAACN,GAAA,EAAQ,IAAG,MAAM,UAAAE,EAAE,OAAO,GAAE;AAAA,IAE5BL,MAAU,KACT,gBAAAS,EAACP,GAAA,EAAO,SAAQ,aAAY,SAASD,GAClC,UAAAI,EAAE,eAAe,EAAA,CACpB;AAAA,EAAA,GAEJ;AAEJ;AAKA,SAASK,EAAyB,EAAE,WAAAT,KAA4C;AAC9E,QAAM,EAAE,QAAAC,EAAA,IAAWE,EAAA,GACb,EAAE,GAAAC,EAAA,IAAMC,EAAe,2BAA2B;AAExD,SACE,gBAAAG,EAACE,KAAU,OAAON,EAAE,iBAAiB,GAAG,aAAaA,EAAE,uBAAuB,GAC5E,UAAA,gBAAAI,EAACG,KAAc,gBAAe,UAC5B,4BAACV,GAAA,EAAO,SAASD,GAAY,UAAAI,EAAE,kBAAkB,EAAA,CAAE,EAAA,CACrD,EAAA,CACF;AAEJ;AA6BO,SAASQ,GAAeC,GAA4B;AACzD,SACE,gBAAAL,EAACM,GAAA,EAAe,GAAGD,GACjB,UAAA,gBAAAL,EAACO,KAAM,GAAGF,GAAQ,UAAAA,EAAM,SAAA,CAAS,EAAA,CACnC;AAEJ;AAEA,SAASE,EAAK,EAAE,WAAAC,GAAW,WAAAC,GAAW,YAAAC,GAAY,gBAAAC,KAAuC;AACvF,EAAAC,EAAQ,2BAA2B,GACnCC,EAAuB,6BAA6BH,CAAU;AAC9D,QAAM,EAAE,GAAAd,EAAA,IAAMC,EAAe,2BAA2B,GAClD,EAAE,SAAAiB,GAAS,mBAAAC,EAAA,IAAsBC,EAAA,GACjC,EAAE,OAAAC,GAAO,QAAAxB,EAAA,IAAWE,EAAA,GACpB;AAAA,IACJ,aAAAuB;AAAA,IACA,YAAAC;AAAA,IACA,gBAAAC;AAAA,IACA,iBAAAC;AAAA,IACA,gBAAAC;AAAA,IACA,oBAAAC;AAAA,IACA,0BAAAC;AAAA,IACA,aAAAC;AAAA,IACA,YAAAC;AAAA,IACA,cAAAC;AAAA,EAAA,IACEC,EAAe,EAAE,aAAapB,GAAW,GACvC,EAAE,aAAaqB,GAA0B,WAAWC,EAAA,IACxDC,EAAA,GAEIC,IAAgBC,EAAwB;AAAA,IAC5C,SAAS;AAAA,MACP;AAAA,QACE,OAAOrC,EAAE,kBAAkB;AAAA,QAC3B,QAAQ,CAAAsC,MACNA,EAAW,SAASC,EAAgB,WAChCD,EAAW,eACXE,EAAc,EAAE,YAAYF,EAAW,WAAW,WAAWA,EAAW,UAAU;AAAA,MAAA;AAAA,MAE1F;AAAA,QACE,OAAOtC,EAAE,oBAAoB;AAAA,QAC7B,QAAQ,CAAC,EAAE,WAAAyC,GAAW,kBAAAC,QACpB,gBAAAtC;AAAA,UAACuC;AAAA,UAAA;AAAA,YACC,WAAAF;AAAA,YACA,kBAAAC;AAAA,UAAA;AAAA,QAAA;AAAA,MACF;AAAA,IAEJ;AAAA,IAEF,MAAMpB;AAAA,IACN,UAAU,CAAAgB,MACR,gBAAAlC;AAAA,MAACwC;AAAA,MAAA;AAAA,QACC,OAAO;AAAA,UACL;AAAA,YACE,OAAO5C,EAAE,SAAS;AAAA,YAClB,MAAM,gBAAAI,EAACyC,GAAA,EAAU,eAAW,GAAA,CAAC;AAAA,YAC7B,SAAS,MAAM;AACb,cAAAC,EAAWR,EAAW,IAAI;AAAA,YAC5B;AAAA,UAAA;AAAA,UAEF;AAAA,YACE,OAAOtC,EAAE,WAAW;AAAA,YACpB,MAAM,gBAAAI,EAAC2C,GAAA,EAAY,eAAW,GAAA,CAAC;AAAA,YAC/B,SAAS,MAAM;AACb,cAAKC,EAAaV,EAAW,IAAI;AAAA,YACnC;AAAA,UAAA;AAAA,QACF;AAAA,QAEF,cAActC,EAAE,SAAS;AAAA,QACzB,WAAWkC;AAAA,MAAA;AAAA,IAAA;AAAA,IAGf,YAAY,MAAM,gBAAA9B,EAACC,GAAA,EAAyB,WAAAT,EAAA,CAAsB;AAAA,IAClE,YAAY;AAAA,MACV,gBAAA4B;AAAA,MACA,iBAAAC;AAAA,MACA,gBAAAC;AAAA,MACA,oBAAAC;AAAA,MACA,0BAAAC;AAAA,MACA,aAAAC;AAAA,MACA,YAAAC;AAAA,MACA,YAAAP;AAAA,MACA,cAAAQ;AAAA,IAAA;AAAA,EACF,CACD,GAEKnC,IAAY,MAAM;AACtB,IAAAsB,EAAQ+B,EAAgB,iBAAiB;AAAA,EAC3C,GAEMH,IAAa,CAACI,MAAiB;AACnC,IAAAhC,EAAQ+B,EAAgB,mBAAmB,EAAE,cAAcC,GAAM;AAAA,EACnE,GAEMC,IAAiB,MAAM;AAC3B,IAAAjC,EAAQ+B,EAAgB,8BAA8B;AAAA,EACxD,GAEMD,IAAe,OAAOE,MAAiB;AAC3C,UAAM/B,EAAkB+B,GAAM,OAAME,MAAW;AAC7C,YAAMnB,EAAyB;AAAA,QAC7B,SAAS,EAAE,gBAAgBmB,EAAA;AAAA,MAAQ,CACpC,GAEDlC,EAAQ+B,EAAgB,oBAAoB,EAAE,cAAcG,GAAS;AAAA,IACvE,CAAC;AAAA,EACH;AAEA,SACE,gBAAAlD,EAAC,aAAQ,WAAAW,GACN,UAAA;AAAA,IAAAE,KAAkB,gBAAAX,EAACiB,GAAA,EAAM,OAAON,GAAgB,QAAO,WAAU;AAAA,IAClE,gBAAAb,EAACC,GAAA,EAAK,eAAc,UAClB,UAAA;AAAA,MAAA,gBAAAC,EAACV,GAAA,EAAK,OAAO6B,GAAY,WAAA3B,EAAA,CAAsB;AAAA,wBAC9CyD,GAAA,EAAS,OAAOrD,EAAE,qBAAqB,GAAI,GAAGoC,GAAe;AAAA,MAC9D,gBAAAhC,EAACG,GAAA,EACC,UAAA,gBAAAH,EAACP,GAAA,EAAO,SAASsD,GAAgB,WAAW,IACzC,UAAAnD,EAAE,aAAa,EAAA,CAClB,EAAA,CACF;AAAA,IAAA,EAAA,CACF;AAAA,EAAA,GACF;AAEJ;"}

package/dist/components/Contractor/ContractorList/useContractorList.d.ts

@@ -14,5 +14,5 @@ export declare function useContractors({ companyUuid }: useContractorsArgs): {
     handleNextPage: () => void;
     handleLastPage: () => void;
     handleItemsPerPageChange: (n: import('../../..').PaginationItemsPerPage) => void;
-    contractors: import('@gusto/embedded-api-v-2026-02-01/models/components/contractor.js').Contractor[];
+    contractors: import('@gusto/embedded-api/models/components/contractor.js').Contractor[];
 };

package/dist/components/Contractor/ContractorList/useContractorList.js

@@ -1,4 +1,4 @@
-import { useContractorsListSuspense as a } from "@gusto/embedded-api-v-2026-02-01/react-query/contractorsList";
+import { useContractorsListSuspense as a } from "@gusto/embedded-api/react-query/contractorsList";
 import { usePagination as i } from "../../../hooks/usePagination/usePagination.js";
 function u({ companyUuid: t }) {
   const { currentPage: e, itemsPerPage: r, getPaginationProps: o } = i(), {

package/dist/components/Contractor/ContractorList/useContractorList.js.map

@@ -1 +1 @@
-{"version":3,"file":"useContractorList.js","sources":["../../../../src/components/Contractor/ContractorList/useContractorList.ts"],"sourcesContent":["import { useContractorsListSuspense } from '@gusto/embedded-api-v-2026-02-01/react-query/contractorsList'\nimport { usePagination } from '@/hooks/usePagination/usePagination'\n\n/** @internal */\nexport interface useContractorsArgs {\n  companyUuid: string\n}\n\n/** @internal */\nexport function useContractors({ companyUuid }: useContractorsArgs) {\n  const { currentPage, itemsPerPage, getPaginationProps } = usePagination()\n\n  const {\n    data: { httpMeta, contractors },\n  } = useContractorsListSuspense({ companyUuid, page: currentPage, per: itemsPerPage })\n\n  return {\n    contractors: contractors!,\n    ...getPaginationProps(httpMeta.response.headers),\n  }\n}\n"],"names":["useContractors","companyUuid","currentPage","itemsPerPage","getPaginationProps","usePagination","httpMeta","contractors","useContractorsListSuspense"],"mappings":";;AASO,SAASA,EAAe,EAAE,aAAAC,KAAmC;AAClE,QAAM,EAAE,aAAAC,GAAa,cAAAC,GAAc,oBAAAC,EAAA,IAAuBC,EAAA,GAEpD;AAAA,IACJ,MAAM,EAAE,UAAAC,GAAU,aAAAC,EAAA;AAAA,EAAY,IAC5BC,EAA2B,EAAE,aAAAP,GAAa,MAAMC,GAAa,KAAKC,GAAc;AAEpF,SAAO;AAAA,IACL,aAAAI;AAAA,IACA,GAAGH,EAAmBE,EAAS,SAAS,OAAO;AAAA,EAAA;AAEnD;"}
+{"version":3,"file":"useContractorList.js","sources":["../../../../src/components/Contractor/ContractorList/useContractorList.ts"],"sourcesContent":["import { useContractorsListSuspense } from '@gusto/embedded-api/react-query/contractorsList'\nimport { usePagination } from '@/hooks/usePagination/usePagination'\n\n/** @internal */\nexport interface useContractorsArgs {\n  companyUuid: string\n}\n\n/** @internal */\nexport function useContractors({ companyUuid }: useContractorsArgs) {\n  const { currentPage, itemsPerPage, getPaginationProps } = usePagination()\n\n  const {\n    data: { httpMeta, contractors },\n  } = useContractorsListSuspense({ companyUuid, page: currentPage, per: itemsPerPage })\n\n  return {\n    contractors: contractors!,\n    ...getPaginationProps(httpMeta.response.headers),\n  }\n}\n"],"names":["useContractors","companyUuid","currentPage","itemsPerPage","getPaginationProps","usePagination","httpMeta","contractors","useContractorsListSuspense"],"mappings":";;AASO,SAASA,EAAe,EAAE,aAAAC,KAAmC;AAClE,QAAM,EAAE,aAAAC,GAAa,cAAAC,GAAc,oBAAAC,EAAA,IAAuBC,EAAA,GAEpD;AAAA,IACJ,MAAM,EAAE,UAAAC,GAAU,aAAAC,EAAA;AAAA,EAAY,IAC5BC,EAA2B,EAAE,aAAAP,GAAa,MAAMC,GAAa,KAAKC,GAAc;AAEpF,SAAO;AAAA,IACL,aAAAI;AAAA,IACA,GAAGH,EAAmBE,EAAS,SAAS,OAAO;AAAA,EAAA;AAEnD;"}

package/dist/components/Contractor/Documents/DocumentSigner/documentSignerStateMachine.d.ts

@@ -1,4 +1,4 @@
-import { DocumentSigned } from '@gusto/embedded-api-v-2026-02-01/models/components/documentsigned';
+import { DocumentSigned } from '@gusto/embedded-api/models/components/documentsigned';
 import { FlowContextInterface } from '../../../Flow/useFlow';
 import { componentEvents } from '../../../../shared/constants';
 /** @internal */

package/dist/components/Contractor/Documents/DocumentSigner/documentSignerStateMachine.js.map

@@ -1 +1 @@
-{"version":3,"file":"documentSignerStateMachine.js","sources":["../../../../../src/components/Contractor/Documents/DocumentSigner/documentSignerStateMachine.tsx"],"sourcesContent":["import type { DocumentSigned } from '@gusto/embedded-api-v-2026-02-01/models/components/documentsigned'\nimport { DocumentsList } from '../DocumentsList/DocumentsList'\nimport { SignatureForm } from '../SignatureForm/SignatureForm'\nimport { useFlow, type FlowContextInterface } from '@/components/Flow/useFlow'\nimport type { componentEvents } from '@/shared/constants'\nimport { ensureRequired } from '@/helpers/ensureRequired'\n\n/** @internal */\nexport type EventPayloads = {\n  [componentEvents.CONTRACTOR_VIEW_DOCUMENT_TO_SIGN]: { uuid: string; title?: string }\n  [componentEvents.CONTRACTOR_SIGN_DOCUMENT]: DocumentSigned\n  [componentEvents.CONTRACTOR_DOCUMENTS_DONE]: undefined\n  [componentEvents.CANCEL]: undefined\n}\n\n/** @internal */\nexport interface DocumentSignerContextInterface extends FlowContextInterface {\n  contractorId: string\n  documentUuid?: string\n}\n\n/** @internal */\nexport function DocumentsListContextual() {\n  const { contractorId, onEvent } = useFlow<DocumentSignerContextInterface>()\n\n  return <DocumentsList contractorId={ensureRequired(contractorId)} onEvent={onEvent} />\n}\n\n/** @internal */\nexport function SignatureFormContextual() {\n  const { contractorId, documentUuid, onEvent } = useFlow<DocumentSignerContextInterface>()\n\n  return (\n    <SignatureForm\n      contractorId={ensureRequired(contractorId)}\n      documentUuid={ensureRequired(documentUuid)}\n      onEvent={onEvent}\n    />\n  )\n}\n"],"names":["DocumentsListContextual","contractorId","onEvent","useFlow","DocumentsList","ensureRequired","SignatureFormContextual","documentUuid","jsx","SignatureForm"],"mappings":";;;;;AAsBO,SAASA,IAA0B;AACxC,QAAM,EAAE,cAAAC,GAAc,SAAAC,EAAA,IAAYC,EAAA;AAElC,2BAAQC,GAAA,EAAc,cAAcC,EAAeJ,CAAY,GAAG,SAAAC,GAAkB;AACtF;AAGO,SAASI,IAA0B;AACxC,QAAM,EAAE,cAAAL,GAAc,cAAAM,GAAc,SAAAL,EAAA,IAAYC,EAAA;AAEhD,SACE,gBAAAK;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,cAAcJ,EAAeJ,CAAY;AAAA,MACzC,cAAcI,EAAeE,CAAY;AAAA,MACzC,SAAAL;AAAA,IAAA;AAAA,EAAA;AAGN;"}
+{"version":3,"file":"documentSignerStateMachine.js","sources":["../../../../../src/components/Contractor/Documents/DocumentSigner/documentSignerStateMachine.tsx"],"sourcesContent":["import type { DocumentSigned } from '@gusto/embedded-api/models/components/documentsigned'\nimport { DocumentsList } from '../DocumentsList/DocumentsList'\nimport { SignatureForm } from '../SignatureForm/SignatureForm'\nimport { useFlow, type FlowContextInterface } from '@/components/Flow/useFlow'\nimport type { componentEvents } from '@/shared/constants'\nimport { ensureRequired } from '@/helpers/ensureRequired'\n\n/** @internal */\nexport type EventPayloads = {\n  [componentEvents.CONTRACTOR_VIEW_DOCUMENT_TO_SIGN]: { uuid: string; title?: string }\n  [componentEvents.CONTRACTOR_SIGN_DOCUMENT]: DocumentSigned\n  [componentEvents.CONTRACTOR_DOCUMENTS_DONE]: undefined\n  [componentEvents.CANCEL]: undefined\n}\n\n/** @internal */\nexport interface DocumentSignerContextInterface extends FlowContextInterface {\n  contractorId: string\n  documentUuid?: string\n}\n\n/** @internal */\nexport function DocumentsListContextual() {\n  const { contractorId, onEvent } = useFlow<DocumentSignerContextInterface>()\n\n  return <DocumentsList contractorId={ensureRequired(contractorId)} onEvent={onEvent} />\n}\n\n/** @internal */\nexport function SignatureFormContextual() {\n  const { contractorId, documentUuid, onEvent } = useFlow<DocumentSignerContextInterface>()\n\n  return (\n    <SignatureForm\n      contractorId={ensureRequired(contractorId)}\n      documentUuid={ensureRequired(documentUuid)}\n      onEvent={onEvent}\n    />\n  )\n}\n"],"names":["DocumentsListContextual","contractorId","onEvent","useFlow","DocumentsList","ensureRequired","SignatureFormContextual","documentUuid","jsx","SignatureForm"],"mappings":";;;;;AAsBO,SAASA,IAA0B;AACxC,QAAM,EAAE,cAAAC,GAAc,SAAAC,EAAA,IAAYC,EAAA;AAElC,2BAAQC,GAAA,EAAc,cAAcC,EAAeJ,CAAY,GAAG,SAAAC,GAAkB;AACtF;AAGO,SAASI,IAA0B;AACxC,QAAM,EAAE,cAAAL,GAAc,cAAAM,GAAc,SAAAL,EAAA,IAAYC,EAAA;AAEhD,SACE,gBAAAK;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,cAAcJ,EAAeJ,CAAY;AAAA,MACzC,cAAcI,EAAeE,CAAY;AAAA,MACzC,SAAAL;AAAA,IAAA;AAAA,EAAA;AAGN;"}

package/dist/components/Contractor/Documents/DocumentsList/DocumentsList.d.ts

@@ -14,7 +14,9 @@ export interface DocumentsListProps extends BaseComponentInterface<'Contractor.D
  * @remarks
  * Fetches the contractor's documents via {@link useContractorDocumentsList} and
  * renders them in a table. The Continue action is disabled until every document
- * that requires signing has been signed.
+ * the contractor can sign has been signed; a document that isn't signable yet
+ * (e.g. a W-9 whose fields haven't been generated) surfaces a warning instead of
+ * blocking the flow.
  *
  * @events
  * | Event | Description | Data |

package/dist/components/Contractor/Documents/DocumentsList/DocumentsList.js

@@ -1,71 +1,84 @@
-import { jsx as n, jsxs as l } from "react/jsx-runtime";
-import { useTranslation as b } from "react-i18next";
-import { useContractorDocumentsList as S } from "./useContractorDocumentsList/useContractorDocumentsList.js";
-import { BaseComponent as x, BaseLayout as u } from "../../../Base/Base.js";
-import { useBase as E } from "../../../Base/useBase.js";
-import { useComponentDictionary as O, useI18n as R } from "../../../../i18n/I18n.js";
-import { Flex as a } from "../../../Common/Flex/Flex.js";
-import { ActionsLayout as _ } from "../../../Common/ActionsLayout/ActionsLayout.js";
-import { useComponentContext as y } from "../../../../contexts/ComponentAdapter/useComponentContext.js";
+import { jsx as e, jsxs as d } from "react/jsx-runtime";
+import { useTranslation as E } from "react-i18next";
+import { W9_DOCUMENT_NAME as O, getPresentFieldNames as x } from "../SignatureForm/useContractorSignatureForm/w9Fields.js";
+import { useContractorDocumentsList as N } from "./useContractorDocumentsList/useContractorDocumentsList.js";
+import { BaseComponent as R, BaseLayout as g } from "../../../Base/Base.js";
+import { useBase as _ } from "../../../Base/useBase.js";
+import { useComponentDictionary as y, useI18n as A } from "../../../../i18n/I18n.js";
+import { Flex as p } from "../../../Common/Flex/Flex.js";
+import { ActionsLayout as B } from "../../../Common/ActionsLayout/ActionsLayout.js";
+import { useComponentContext as q } from "../../../../contexts/ComponentAdapter/useComponentContext.js";
 import "react";
-import { contractorEvents as m } from "../../../../shared/constants.js";
-import { DocumentList as N } from "../../../Common/DocumentList/DocumentList.js";
-function d(e) {
-  return !!e.requiresSigning && !e.signedAt;
+import { contractorEvents as f } from "../../../../shared/constants.js";
+import { DocumentList as H } from "../../../Common/DocumentList/DocumentList.js";
+function c(r) {
+  return !r.signedAt;
 }
-function V(e) {
-  return /* @__PURE__ */ n(x, { ...e, children: /* @__PURE__ */ n(q, { ...e }) });
+function l(r) {
+  return r.name !== O ? !0 : x(r).size > 0;
 }
-function q({ contractorId: e, className: g, dictionary: p }) {
-  O("Contractor.DocumentsList", p), R("Contractor.DocumentsList");
-  const { t } = b("Contractor.DocumentsList"), { onEvent: c } = E(), i = y(), r = S({ contractorId: e });
-  if (r.isLoading)
-    return /* @__PURE__ */ n(u, { isLoading: !0, error: r.errorHandling.errors });
-  const { documents: s } = r.data, C = r.errorHandling.errors.length > 0, f = s.every((o) => !d(o)), L = (o) => {
-    const D = s.find((T) => T.uuid === o);
-    c(m.CONTRACTOR_VIEW_DOCUMENT_TO_SIGN, {
-      uuid: o,
-      title: D?.title
+function K(r) {
+  return /* @__PURE__ */ e(R, { ...r, children: /* @__PURE__ */ e(M, { ...r }) });
+}
+function M({ contractorId: r, className: C, dictionary: h }) {
+  y("Contractor.DocumentsList", h), A("Contractor.DocumentsList");
+  const { t: n } = E("Contractor.DocumentsList"), { onEvent: m } = _(), o = q(), i = N({ contractorId: r });
+  if (i.isLoading)
+    return /* @__PURE__ */ e(g, { isLoading: !0, error: i.errorHandling.errors });
+  const { documents: s } = i.data, L = i.errorHandling.errors.length > 0, D = s.some(
+    (t) => c(t) && l(t)
+  ), T = s.some(
+    (t) => c(t) && !l(t)
+  ), b = (t) => {
+    const u = s.find((a) => a.uuid === t);
+    m(f.CONTRACTOR_VIEW_DOCUMENT_TO_SIGN, {
+      uuid: t,
+      title: u?.title
     });
-  }, h = () => {
-    c(m.CONTRACTOR_DOCUMENTS_DONE);
+  }, S = () => {
+    m(f.CONTRACTOR_DOCUMENTS_DONE);
   };
-  return /* @__PURE__ */ n("section", { className: g, children: /* @__PURE__ */ n(u, { error: r.errorHandling.errors, children: /* @__PURE__ */ l(a, { flexDirection: "column", gap: 32, children: [
-    /* @__PURE__ */ l(a, { flexDirection: "column", gap: 4, children: [
-      /* @__PURE__ */ n(i.Heading, { as: "h2", children: t("title") }),
-      /* @__PURE__ */ n(i.Text, { children: t("subtitle") })
+  return /* @__PURE__ */ e("section", { className: C, children: /* @__PURE__ */ e(g, { error: i.errorHandling.errors, children: /* @__PURE__ */ d(p, { flexDirection: "column", gap: 32, children: [
+    /* @__PURE__ */ d(p, { flexDirection: "column", gap: 4, children: [
+      /* @__PURE__ */ e(o.Heading, { as: "h2", children: n("title") }),
+      /* @__PURE__ */ e(o.Text, { children: n("subtitle") })
     ] }),
-    /* @__PURE__ */ n(
-      N,
+    T && /* @__PURE__ */ e(o.Alert, { status: "warning", label: n("notReadyTitle"), children: /* @__PURE__ */ e(o.Text, { children: n("notReadyBody") }) }),
+    /* @__PURE__ */ e(
+      H,
       {
-        forms: s.map((o) => ({
-          uuid: o.uuid ?? "",
-          title: o.title,
-          description: o.description,
-          requires_signing: d(o)
+        forms: s.map((t) => ({
+          uuid: t.uuid ?? "",
+          title: t.title,
+          description: t.description,
+          requires_signing: c(t)
         })),
-        onRequestSign: (o) => {
-          L(o.uuid);
+        canSign: (t) => {
+          const u = s.find((a) => a.uuid === t.uuid);
+          return u ? l(u) : !0;
+        },
+        onRequestSign: (t) => {
+          b(t.uuid);
         },
-        withError: C,
-        label: t("documentListLabel"),
+        withError: L,
+        label: n("documentListLabel"),
         columnLabels: {
-          form: t("documentColumnLabel"),
-          action: t("statusColumnLabel")
+          form: n("documentColumnLabel"),
+          action: n("statusColumnLabel")
         },
         statusLabels: {
-          signCta: t("signDocumentCta"),
-          notSigned: t("notSigned"),
-          complete: t("signed")
+          signCta: n("signDocumentCta"),
+          notSigned: n("notSigned"),
+          complete: n("signed")
         },
-        emptyStateLabel: t("emptyTitle"),
-        errorLabel: t("errorTitle")
+        emptyStateLabel: n("emptyTitle"),
+        errorLabel: n("errorTitle")
       }
     ),
-    /* @__PURE__ */ n(_, { children: /* @__PURE__ */ n(i.Button, { onClick: h, isDisabled: !f, children: t("continueCta") }) })
+    /* @__PURE__ */ e(B, { children: /* @__PURE__ */ e(o.Button, { onClick: S, isDisabled: D, children: n("continueCta") }) })
   ] }) }) });
 }
 export {
-  V as DocumentsList
+  K as DocumentsList
 };
 //# sourceMappingURL=DocumentsList.js.map

package/dist/components/Contractor/Documents/DocumentsList/DocumentsList.js.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentsList.js","sources":["../../../../../src/components/Contractor/Documents/DocumentsList/DocumentsList.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport type { Document } from '@gusto/embedded-api-v-2026-02-01/models/components/document'\nimport { useContractorDocumentsList } from './useContractorDocumentsList'\nimport { BaseComponent, type BaseComponentInterface } from '@/components/Base/Base'\nimport { BaseLayout } from '@/components/Base'\nimport { useBase } from '@/components/Base/useBase'\nimport { useI18n, useComponentDictionary } from '@/i18n'\nimport { ActionsLayout, Flex } from '@/components/Common'\nimport { DocumentList } from '@/components/Common/DocumentList'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { contractorEvents } from '@/shared/constants'\n\n/**\n * Props for {@link DocumentsList}.\n *\n * @public\n */\nexport interface DocumentsListProps extends BaseComponentInterface<'Contractor.DocumentsList'> {\n  /** The associated contractor identifier. */\n  contractorId: string\n}\n\n/**\n * Returns whether a document still needs the contractor's signature.\n *\n * @remarks\n * A document is outstanding when it requires signing and has not yet been\n * signed (`signedAt` is unset).\n */\nfunction requiresSignature(document: Document): boolean {\n  return Boolean(document.requiresSigning) && !document.signedAt\n}\n\n/**\n * Lists a contractor's documents and lets the contractor open each one for signing.\n *\n * @remarks\n * Fetches the contractor's documents via {@link useContractorDocumentsList} and\n * renders them in a table. The Continue action is disabled until every document\n * that requires signing has been signed.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `contractor/documents/view` | Fired when a document's \"Sign\" action is selected | `{ uuid?: string; title?: string }` |\n * | `contractor/documents/done` | Fired when all required documents are signed and the user continues | — |\n *\n * @param props - See {@link DocumentsListProps}.\n * @returns The contractor documents list.\n * @public\n */\nexport function DocumentsList(props: DocumentsListProps) {\n  return (\n    <BaseComponent {...props}>\n      <Root {...props} />\n    </BaseComponent>\n  )\n}\n\nfunction Root({ contractorId, className, dictionary }: DocumentsListProps) {\n  useComponentDictionary('Contractor.DocumentsList', dictionary)\n  useI18n('Contractor.DocumentsList')\n  const { t } = useTranslation('Contractor.DocumentsList')\n  const { onEvent } = useBase()\n  const Components = useComponentContext()\n\n  const result = useContractorDocumentsList({ contractorId })\n\n  if (result.isLoading) {\n    return <BaseLayout isLoading error={result.errorHandling.errors} />\n  }\n\n  const { documents } = result.data\n  const hasError = result.errorHandling.errors.length > 0\n  const hasSignedAllDocuments = documents.every(document => !requiresSignature(document))\n\n  const handleRequestSign = (uuid: string) => {\n    const document = documents.find(candidate => candidate.uuid === uuid)\n    onEvent(contractorEvents.CONTRACTOR_VIEW_DOCUMENT_TO_SIGN, {\n      uuid,\n      title: document?.title,\n    })\n  }\n\n  const handleContinue = () => {\n    onEvent(contractorEvents.CONTRACTOR_DOCUMENTS_DONE)\n  }\n\n  return (\n    <section className={className}>\n      <BaseLayout error={result.errorHandling.errors}>\n        <Flex flexDirection=\"column\" gap={32}>\n          <Flex flexDirection=\"column\" gap={4}>\n            <Components.Heading as=\"h2\">{t('title')}</Components.Heading>\n            <Components.Text>{t('subtitle')}</Components.Text>\n          </Flex>\n\n          <DocumentList\n            forms={documents.map(document => ({\n              uuid: document.uuid ?? '',\n              title: document.title,\n              description: document.description,\n              requires_signing: requiresSignature(document),\n            }))}\n            onRequestSign={form => {\n              handleRequestSign(form.uuid)\n            }}\n            withError={hasError}\n            label={t('documentListLabel')}\n            columnLabels={{\n              form: t('documentColumnLabel'),\n              action: t('statusColumnLabel'),\n            }}\n            statusLabels={{\n              signCta: t('signDocumentCta'),\n              notSigned: t('notSigned'),\n              complete: t('signed'),\n            }}\n            emptyStateLabel={t('emptyTitle')}\n            errorLabel={t('errorTitle')}\n          />\n\n          <ActionsLayout>\n            <Components.Button onClick={handleContinue} isDisabled={!hasSignedAllDocuments}>\n              {t('continueCta')}\n            </Components.Button>\n          </ActionsLayout>\n        </Flex>\n      </BaseLayout>\n    </section>\n  )\n}\n"],"names":["requiresSignature","document","DocumentsList","props","jsx","BaseComponent","Root","contractorId","className","dictionary","useComponentDictionary","useI18n","useTranslation","onEvent","useBase","Components","useComponentContext","result","useContractorDocumentsList","BaseLayout","documents","hasError","hasSignedAllDocuments","handleRequestSign","uuid","candidate","contractorEvents","handleContinue","jsxs","Flex","DocumentList","form","ActionsLayout"],"mappings":";;;;;;;;;;;;AA6BA,SAASA,EAAkBC,GAA6B;AACtD,SAAO,EAAQA,EAAS,mBAAoB,CAACA,EAAS;AACxD;AAoBO,SAASC,EAAcC,GAA2B;AACvD,SACE,gBAAAC,EAACC,KAAe,GAAGF,GACjB,4BAACG,GAAA,EAAM,GAAGH,GAAO,EAAA,CACnB;AAEJ;AAEA,SAASG,EAAK,EAAE,cAAAC,GAAc,WAAAC,GAAW,YAAAC,KAAkC;AACzE,EAAAC,EAAuB,4BAA4BD,CAAU,GAC7DE,EAAQ,0BAA0B;AAClC,QAAM,EAAE,EAAA,IAAMC,EAAe,0BAA0B,GACjD,EAAE,SAAAC,EAAA,IAAYC,EAAA,GACdC,IAAaC,EAAA,GAEbC,IAASC,EAA2B,EAAE,cAAAX,GAAc;AAE1D,MAAIU,EAAO;AACT,6BAAQE,GAAA,EAAW,WAAS,IAAC,OAAOF,EAAO,cAAc,QAAQ;AAGnE,QAAM,EAAE,WAAAG,MAAcH,EAAO,MACvBI,IAAWJ,EAAO,cAAc,OAAO,SAAS,GAChDK,IAAwBF,EAAU,MAAM,OAAY,CAACpB,EAAkBC,CAAQ,CAAC,GAEhFsB,IAAoB,CAACC,MAAiB;AAC1C,UAAMvB,IAAWmB,EAAU,KAAK,CAAAK,MAAaA,EAAU,SAASD,CAAI;AACpE,IAAAX,EAAQa,EAAiB,kCAAkC;AAAA,MACzD,MAAAF;AAAA,MACA,OAAOvB,GAAU;AAAA,IAAA,CAClB;AAAA,EACH,GAEM0B,IAAiB,MAAM;AAC3B,IAAAd,EAAQa,EAAiB,yBAAyB;AAAA,EACpD;AAEA,SACE,gBAAAtB,EAAC,WAAA,EAAQ,WAAAI,GACP,UAAA,gBAAAJ,EAACe,KAAW,OAAOF,EAAO,cAAc,QACtC,UAAA,gBAAAW,EAACC,GAAA,EAAK,eAAc,UAAS,KAAK,IAChC,UAAA;AAAA,IAAA,gBAAAD,EAACC,GAAA,EAAK,eAAc,UAAS,KAAK,GAChC,UAAA;AAAA,MAAA,gBAAAzB,EAACW,EAAW,SAAX,EAAmB,IAAG,MAAM,UAAA,EAAE,OAAO,GAAE;AAAA,wBACvCA,EAAW,MAAX,EAAiB,UAAA,EAAE,UAAU,EAAA,CAAE;AAAA,IAAA,GAClC;AAAA,IAEA,gBAAAX;AAAA,MAAC0B;AAAA,MAAA;AAAA,QACC,OAAOV,EAAU,IAAI,CAAAnB,OAAa;AAAA,UAChC,MAAMA,EAAS,QAAQ;AAAA,UACvB,OAAOA,EAAS;AAAA,UAChB,aAAaA,EAAS;AAAA,UACtB,kBAAkBD,EAAkBC,CAAQ;AAAA,QAAA,EAC5C;AAAA,QACF,eAAe,CAAA8B,MAAQ;AACrB,UAAAR,EAAkBQ,EAAK,IAAI;AAAA,QAC7B;AAAA,QACA,WAAWV;AAAA,QACX,OAAO,EAAE,mBAAmB;AAAA,QAC5B,cAAc;AAAA,UACZ,MAAM,EAAE,qBAAqB;AAAA,UAC7B,QAAQ,EAAE,mBAAmB;AAAA,QAAA;AAAA,QAE/B,cAAc;AAAA,UACZ,SAAS,EAAE,iBAAiB;AAAA,UAC5B,WAAW,EAAE,WAAW;AAAA,UACxB,UAAU,EAAE,QAAQ;AAAA,QAAA;AAAA,QAEtB,iBAAiB,EAAE,YAAY;AAAA,QAC/B,YAAY,EAAE,YAAY;AAAA,MAAA;AAAA,IAAA;AAAA,IAG5B,gBAAAjB,EAAC4B,GAAA,EACC,UAAA,gBAAA5B,EAACW,EAAW,QAAX,EAAkB,SAASY,GAAgB,YAAY,CAACL,GACtD,UAAA,EAAE,aAAa,GAClB,EAAA,CACF;AAAA,EAAA,EAAA,CACF,GACF,GACF;AAEJ;"}
+{"version":3,"file":"DocumentsList.js","sources":["../../../../../src/components/Contractor/Documents/DocumentsList/DocumentsList.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport type { Document } from '@gusto/embedded-api/models/components/document'\nimport {\n  W9_DOCUMENT_NAME,\n  getPresentFieldNames,\n} from '../SignatureForm/useContractorSignatureForm/w9Fields'\nimport { useContractorDocumentsList } from './useContractorDocumentsList'\nimport { BaseComponent, type BaseComponentInterface } from '@/components/Base/Base'\nimport { BaseLayout } from '@/components/Base'\nimport { useBase } from '@/components/Base/useBase'\nimport { useI18n, useComponentDictionary } from '@/i18n'\nimport { ActionsLayout, Flex } from '@/components/Common'\nimport { DocumentList } from '@/components/Common/DocumentList'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { contractorEvents } from '@/shared/constants'\n\n/**\n * Props for {@link DocumentsList}.\n *\n * @public\n */\nexport interface DocumentsListProps extends BaseComponentInterface<'Contractor.DocumentsList'> {\n  /** The associated contractor identifier. */\n  contractorId: string\n}\n\n/**\n * Returns whether a document still needs the contractor's signature.\n *\n * @remarks\n * In the contractor onboarding flow every listed document must be signed, so a\n * document is outstanding whenever it has not yet been signed (`signedAt` is\n * unset). We intentionally do not defer to the API's `requiresSigning` flag\n * here: an unsigned document whose template is not yet prepared comes back with\n * `requiresSigning: false`, and treating that as \"complete\" would render an\n * unsigned document as signed and let the contractor skip it. Keying off\n * `signedAt` keeps \"complete\" meaning \"actually signed\" for this component.\n */\nfunction requiresSignature(document: Document): boolean {\n  return !document.signedAt\n}\n\n/**\n * Returns whether a document can be signed right now.\n *\n * @remarks\n * A W-9 whose template has not finished preparing comes back with no signable\n * fields (this is the same signal the signer keys its `hasFields` state off).\n * Signing it would submit an empty form, so we block the sign action until the\n * fields are present. Any non-W-9 document is treated as signable here.\n */\nfunction canSignDocument(document: Document): boolean {\n  if (document.name !== W9_DOCUMENT_NAME) return true\n  return getPresentFieldNames(document).size > 0\n}\n\n/**\n * Lists a contractor's documents and lets the contractor open each one for signing.\n *\n * @remarks\n * Fetches the contractor's documents via {@link useContractorDocumentsList} and\n * renders them in a table. The Continue action is disabled until every document\n * the contractor can sign has been signed; a document that isn't signable yet\n * (e.g. a W-9 whose fields haven't been generated) surfaces a warning instead of\n * blocking the flow.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `contractor/documents/view` | Fired when a document's \"Sign\" action is selected | `{ uuid?: string; title?: string }` |\n * | `contractor/documents/done` | Fired when all required documents are signed and the user continues | — |\n *\n * @param props - See {@link DocumentsListProps}.\n * @returns The contractor documents list.\n * @public\n */\nexport function DocumentsList(props: DocumentsListProps) {\n  return (\n    <BaseComponent {...props}>\n      <Root {...props} />\n    </BaseComponent>\n  )\n}\n\nfunction Root({ contractorId, className, dictionary }: DocumentsListProps) {\n  useComponentDictionary('Contractor.DocumentsList', dictionary)\n  useI18n('Contractor.DocumentsList')\n  const { t } = useTranslation('Contractor.DocumentsList')\n  const { onEvent } = useBase()\n  const Components = useComponentContext()\n\n  const result = useContractorDocumentsList({ contractorId })\n\n  if (result.isLoading) {\n    return <BaseLayout isLoading error={result.errorHandling.errors} />\n  }\n\n  const { documents } = result.data\n  const hasError = result.errorHandling.errors.length > 0\n  // Only a document the contractor can actually sign should gate the flow. A\n  // document that still needs signing but isn't signable yet (e.g. a W-9 whose\n  // fields haven't been generated) must not trap the user — it surfaces the\n  // \"not ready\" warning below instead of blocking Continue.\n  const hasOutstandingSignature = documents.some(\n    document => requiresSignature(document) && canSignDocument(document),\n  )\n  const hasUnpreparedDocument = documents.some(\n    document => requiresSignature(document) && !canSignDocument(document),\n  )\n\n  const handleRequestSign = (uuid: string) => {\n    const document = documents.find(candidate => candidate.uuid === uuid)\n    onEvent(contractorEvents.CONTRACTOR_VIEW_DOCUMENT_TO_SIGN, {\n      uuid,\n      title: document?.title,\n    })\n  }\n\n  const handleContinue = () => {\n    onEvent(contractorEvents.CONTRACTOR_DOCUMENTS_DONE)\n  }\n\n  return (\n    <section className={className}>\n      <BaseLayout error={result.errorHandling.errors}>\n        <Flex flexDirection=\"column\" gap={32}>\n          <Flex flexDirection=\"column\" gap={4}>\n            <Components.Heading as=\"h2\">{t('title')}</Components.Heading>\n            <Components.Text>{t('subtitle')}</Components.Text>\n          </Flex>\n\n          {hasUnpreparedDocument && (\n            <Components.Alert status=\"warning\" label={t('notReadyTitle')}>\n              <Components.Text>{t('notReadyBody')}</Components.Text>\n            </Components.Alert>\n          )}\n\n          <DocumentList\n            forms={documents.map(document => ({\n              uuid: document.uuid ?? '',\n              title: document.title,\n              description: document.description,\n              requires_signing: requiresSignature(document),\n            }))}\n            canSign={form => {\n              const document = documents.find(candidate => candidate.uuid === form.uuid)\n              return document ? canSignDocument(document) : true\n            }}\n            onRequestSign={form => {\n              handleRequestSign(form.uuid)\n            }}\n            withError={hasError}\n            label={t('documentListLabel')}\n            columnLabels={{\n              form: t('documentColumnLabel'),\n              action: t('statusColumnLabel'),\n            }}\n            statusLabels={{\n              signCta: t('signDocumentCta'),\n              notSigned: t('notSigned'),\n              complete: t('signed'),\n            }}\n            emptyStateLabel={t('emptyTitle')}\n            errorLabel={t('errorTitle')}\n          />\n\n          <ActionsLayout>\n            <Components.Button onClick={handleContinue} isDisabled={hasOutstandingSignature}>\n              {t('continueCta')}\n            </Components.Button>\n          </ActionsLayout>\n        </Flex>\n      </BaseLayout>\n    </section>\n  )\n}\n"],"names":["requiresSignature","document","canSignDocument","W9_DOCUMENT_NAME","getPresentFieldNames","DocumentsList","props","jsx","BaseComponent","Root","contractorId","className","dictionary","useComponentDictionary","useI18n","t","useTranslation","onEvent","useBase","Components","useComponentContext","result","useContractorDocumentsList","BaseLayout","documents","hasError","hasOutstandingSignature","hasUnpreparedDocument","handleRequestSign","uuid","candidate","contractorEvents","handleContinue","jsxs","Flex","DocumentList","form","ActionsLayout"],"mappings":"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"}

package/dist/components/Contractor/Documents/DocumentsList/useContractorDocumentsList/useContractorDocumentsList.d.ts

@@ -1,4 +1,4 @@
-import { Document } from '@gusto/embedded-api-v-2026-02-01/models/components/document';
+import { Document } from '@gusto/embedded-api/models/components/document';
 import { BaseHookReady, HookLoadingResult } from '../../../../../partner-hook-utils/types';
 /**
  * Parameters for {@link useContractorDocumentsList}.

package/dist/components/Contractor/Documents/DocumentsList/useContractorDocumentsList/useContractorDocumentsList.js

@@ -1,4 +1,4 @@
-import { useContractorDocumentsGetAll as r } from "@gusto/embedded-api-v-2026-02-01/react-query/contractorDocumentsGetAll";
+import { useContractorDocumentsGetAll as r } from "@gusto/embedded-api/react-query/contractorDocumentsGetAll";
 import { composeErrorHandler as e } from "../../../../../partner-hook-utils/composeErrorHandler.js";
 function a({
   contractorId: n

package/dist/components/Contractor/Documents/DocumentsList/useContractorDocumentsList/useContractorDocumentsList.js.map

@@ -1 +1 @@
-{"version":3,"file":"useContractorDocumentsList.js","sources":["../../../../../../src/components/Contractor/Documents/DocumentsList/useContractorDocumentsList/useContractorDocumentsList.tsx"],"sourcesContent":["import { useContractorDocumentsGetAll } from '@gusto/embedded-api-v-2026-02-01/react-query/contractorDocumentsGetAll'\nimport type { Document } from '@gusto/embedded-api-v-2026-02-01/models/components/document'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type { BaseHookReady, HookLoadingResult } from '@/partner-hook-utils/types'\n\n/**\n * Parameters for {@link useContractorDocumentsList}.\n *\n * @public\n */\nexport interface UseContractorDocumentsListParams {\n  /** The associated contractor identifier. */\n  contractorId: string\n}\n\n/**\n * Ready-state shape returned by {@link useContractorDocumentsList} once the documents have loaded.\n *\n * @public\n * @interface\n */\nexport type UseContractorDocumentsListReady = BaseHookReady<\n  { documents: Document[] },\n  { isFetching: boolean }\n>\n\n/**\n * Result of {@link useContractorDocumentsList} — a discriminated union of loading and ready states.\n *\n * @public\n */\nexport type UseContractorDocumentsListResult = HookLoadingResult | UseContractorDocumentsListReady\n\n/**\n * Standalone data hook for a contractor's documents.\n *\n * @remarks\n * Wraps the `contractorDocumentsGetAll` query in the standard\n * {@link BaseHookReady} shape. Read-only — viewing or signing a document is\n * handled by the screen the parent routes to, so this hook exposes no actions.\n *\n * @param params - See {@link UseContractorDocumentsListParams}.\n * @returns A {@link HookLoadingResult} while loading, or the ready state with `data.documents` once loaded.\n * @public\n *\n * @example\n * ```tsx\n * import { useContractorDocumentsList } from '@gusto/embedded-react-sdk'\n *\n * function ContractorDocuments({ contractorId }: { contractorId: string }) {\n *   const result = useContractorDocumentsList({ contractorId })\n *\n *   if (result.isLoading) return <div>Loading...</div>\n *\n *   return (\n *     <ul>\n *       {result.data.documents.map(doc => (\n *         <li key={doc.uuid}>{doc.title}</li>\n *       ))}\n *     </ul>\n *   )\n * }\n * ```\n */\nexport function useContractorDocumentsList({\n  contractorId,\n}: UseContractorDocumentsListParams): UseContractorDocumentsListResult {\n  // staleTime: Infinity — the SDK QueryClient invalidates on any mutation\n  // success, so a long stale time avoids redundant refetches on remount.\n  const documentsQuery = useContractorDocumentsGetAll(\n    { contractorUuid: contractorId },\n    { staleTime: Infinity },\n  )\n\n  const errorHandling = composeErrorHandler([documentsQuery])\n\n  if (documentsQuery.isLoading) {\n    return { isLoading: true, errorHandling }\n  }\n\n  return {\n    isLoading: false,\n    data: { documents: documentsQuery.data?.documents ?? [] },\n    status: { isFetching: documentsQuery.isFetching },\n    errorHandling,\n  }\n}\n"],"names":["useContractorDocumentsList","contractorId","documentsQuery","useContractorDocumentsGetAll","errorHandling","composeErrorHandler"],"mappings":";;AAgEO,SAASA,EAA2B;AAAA,EACzC,cAAAC;AACF,GAAuE;AAGrE,QAAMC,IAAiBC;AAAA,IACrB,EAAE,gBAAgBF,EAAA;AAAA,IAClB,EAAE,WAAW,MAAA;AAAA,EAAS,GAGlBG,IAAgBC,EAAoB,CAACH,CAAc,CAAC;AAE1D,SAAIA,EAAe,YACV,EAAE,WAAW,IAAM,eAAAE,EAAA,IAGrB;AAAA,IACL,WAAW;AAAA,IACX,MAAM,EAAE,WAAWF,EAAe,MAAM,aAAa,CAAA,EAAC;AAAA,IACtD,QAAQ,EAAE,YAAYA,EAAe,WAAA;AAAA,IACrC,eAAAE;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"useContractorDocumentsList.js","sources":["../../../../../../src/components/Contractor/Documents/DocumentsList/useContractorDocumentsList/useContractorDocumentsList.tsx"],"sourcesContent":["import { useContractorDocumentsGetAll } from '@gusto/embedded-api/react-query/contractorDocumentsGetAll'\nimport type { Document } from '@gusto/embedded-api/models/components/document'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type { BaseHookReady, HookLoadingResult } from '@/partner-hook-utils/types'\n\n/**\n * Parameters for {@link useContractorDocumentsList}.\n *\n * @public\n */\nexport interface UseContractorDocumentsListParams {\n  /** The associated contractor identifier. */\n  contractorId: string\n}\n\n/**\n * Ready-state shape returned by {@link useContractorDocumentsList} once the documents have loaded.\n *\n * @public\n * @interface\n */\nexport type UseContractorDocumentsListReady = BaseHookReady<\n  { documents: Document[] },\n  { isFetching: boolean }\n>\n\n/**\n * Result of {@link useContractorDocumentsList} — a discriminated union of loading and ready states.\n *\n * @public\n */\nexport type UseContractorDocumentsListResult = HookLoadingResult | UseContractorDocumentsListReady\n\n/**\n * Standalone data hook for a contractor's documents.\n *\n * @remarks\n * Wraps the `contractorDocumentsGetAll` query in the standard\n * {@link BaseHookReady} shape. Read-only — viewing or signing a document is\n * handled by the screen the parent routes to, so this hook exposes no actions.\n *\n * @param params - See {@link UseContractorDocumentsListParams}.\n * @returns A {@link HookLoadingResult} while loading, or the ready state with `data.documents` once loaded.\n * @public\n *\n * @example\n * ```tsx\n * import { useContractorDocumentsList } from '@gusto/embedded-react-sdk'\n *\n * function ContractorDocuments({ contractorId }: { contractorId: string }) {\n *   const result = useContractorDocumentsList({ contractorId })\n *\n *   if (result.isLoading) return <div>Loading...</div>\n *\n *   return (\n *     <ul>\n *       {result.data.documents.map(doc => (\n *         <li key={doc.uuid}>{doc.title}</li>\n *       ))}\n *     </ul>\n *   )\n * }\n * ```\n */\nexport function useContractorDocumentsList({\n  contractorId,\n}: UseContractorDocumentsListParams): UseContractorDocumentsListResult {\n  // staleTime: Infinity — the SDK QueryClient invalidates on any mutation\n  // success, so a long stale time avoids redundant refetches on remount.\n  const documentsQuery = useContractorDocumentsGetAll(\n    { contractorUuid: contractorId },\n    { staleTime: Infinity },\n  )\n\n  const errorHandling = composeErrorHandler([documentsQuery])\n\n  if (documentsQuery.isLoading) {\n    return { isLoading: true, errorHandling }\n  }\n\n  return {\n    isLoading: false,\n    data: { documents: documentsQuery.data?.documents ?? [] },\n    status: { isFetching: documentsQuery.isFetching },\n    errorHandling,\n  }\n}\n"],"names":["useContractorDocumentsList","contractorId","documentsQuery","useContractorDocumentsGetAll","errorHandling","composeErrorHandler"],"mappings":";;AAgEO,SAASA,EAA2B;AAAA,EACzC,cAAAC;AACF,GAAuE;AAGrE,QAAMC,IAAiBC;AAAA,IACrB,EAAE,gBAAgBF,EAAA;AAAA,IAClB,EAAE,WAAW,MAAA;AAAA,EAAS,GAGlBG,IAAgBC,EAAoB,CAACH,CAAc,CAAC;AAE1D,SAAIA,EAAe,YACV,EAAE,WAAW,IAAM,eAAAE,EAAA,IAGrB;AAAA,IACL,WAAW;AAAA,IACX,MAAM,EAAE,WAAWF,EAAe,MAAM,aAAa,CAAA,EAAC;AAAA,IACtD,QAAQ,EAAE,YAAYA,EAAe,WAAA;AAAA,IACrC,eAAAE;AAAA,EAAA;AAEJ;"}