@gusto/embedded-react-sdk 0.57.3 → 0.58.0

package/dist/components/Contractor/Profile/shared/useContractorDetailsForm/useContractorDetailsForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"useContractorDetailsForm.js","sources":["../../../../../../src/components/Contractor/Profile/shared/useContractorDetailsForm/useContractorDetailsForm.tsx"],"sourcesContent":["import { useMemo } from 'react'\nimport type { ComponentType } from 'react'\nimport { useForm, useWatch } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { Contractor } from '@gusto/embedded-api/models/components/contractor'\nimport type { ContractorCreateRequestBody } from '@gusto/embedded-api/models/components/contractorcreaterequestbody'\nimport type { ContractorUpdateRequestBody } from '@gusto/embedded-api/models/components/contractorupdaterequestbody'\nimport { useContractorsGet } from '@gusto/embedded-api/react-query/contractorsGet'\nimport { useContractorsCreateMutation } from '@gusto/embedded-api/react-query/contractorsCreate'\nimport { useContractorsUpdateMutation } from '@gusto/embedded-api/react-query/contractorsUpdate'\nimport {\n  ContractorType,\n  WageType,\n  createContractorDetailsSchema,\n  type ContractorDetailsOptionalFieldsToRequire,\n  type ContractorDetailsFormData,\n  type ContractorDetailsFormOutputs,\n} from './contractorDetailsSchema'\nimport {\n  TypeField,\n  WageTypeField,\n  StartDateField,\n  HourlyRateField,\n  SelfOnboardingField,\n  FileNewHireReportField,\n  EmailField,\n  FirstNameField,\n  LastNameField,\n  MiddleInitialField,\n  BusinessNameField,\n  SsnField,\n  EinField,\n  WorkStateField,\n} from './fields'\nimport type {\n  TypeFieldProps,\n  WageTypeFieldProps,\n  StartDateFieldProps,\n  HourlyRateFieldProps,\n  SelfOnboardingFieldProps,\n  FileNewHireReportFieldProps,\n  EmailFieldProps,\n  FirstNameFieldProps,\n  LastNameFieldProps,\n  MiddleInitialFieldProps,\n  BusinessNameFieldProps,\n  SsnFieldProps,\n  EinFieldProps,\n  WorkStateFieldProps,\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 {\n  ContractorSelfOnboardingStatuses,\n  ContractorOnboardingStatus,\n  STATES_ABBR,\n} from '@/shared/constants'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { SDKInternalError } from '@/types/sdkError'\nimport { removeNonDigits } from '@/helpers/formattedStrings'\n\nexport type { ContractorDetailsOptionalFieldsToRequire } from './contractorDetailsSchema'\n\n/**\n * Optional overrides passed to {@link UseContractorDetailsFormReady.actions.onSubmit | onSubmit}.\n *\n * @public\n */\nexport interface ContractorDetailsSubmitOptions {\n  /** Override the company identifier supplied to the hook (e.g. after creating the company in the same flow). Only used in create mode. */\n  companyId?: string\n}\n\n/**\n * Shared options merged into both branches of {@link UseContractorDetailsFormProps}.\n *\n * @public\n */\nexport type UseContractorDetailsFormSharedProps = {\n  /** Whether to expose the self-onboarding toggle as `form.Fields.SelfOnboarding`. Defaults to `true`. */\n  withSelfOnboardingField?: boolean\n  /**\n   * Whether `form.Fields.Email` is available regardless of the `selfOnboarding` value.\n   *\n   * @remarks\n   * By default `Email` is only exposed while `selfOnboarding` is `true`, since email is\n   * otherwise only collected to send a self-onboarding invite. Set this to `true` for\n   * surfaces that let an admin edit an already-onboarded contractor's email directly.\n   * Defaults to `false`.\n   */\n  showEmailField?: boolean\n  /** Fields that are optional by default but should be promoted to required for this form instance. */\n  optionalFieldsToRequire?: ContractorDetailsOptionalFieldsToRequire\n  /** Initial values applied before any contractor data loads. */\n  defaultValues?: Partial<ContractorDetailsFormData>\n  /** When validation runs. Forwarded to react-hook-form's `mode`. Defaults to `'onSubmit'`. */\n  validationMode?: UseFormProps['mode']\n  /** Whether react-hook-form should focus the first error on validation failure. Defaults to `true`. */\n  shouldFocusError?: boolean\n}\n\n/**\n * Options for {@link useContractorDetailsForm}.\n *\n * @remarks\n * Discriminated by mode: in create mode supply `companyId` and omit\n * `contractorId`; in update mode supply `contractorId` (and optionally\n * `companyId`).\n *\n * @public\n */\nexport type UseContractorDetailsFormProps =\n  | (UseContractorDetailsFormSharedProps & { companyId: string; contractorId?: never })\n  | (UseContractorDetailsFormSharedProps & { contractorId: string; companyId?: string })\n\n/**\n * The Field components exposed by {@link useContractorDetailsForm} as `form.Fields`.\n *\n * @remarks\n * Conditionally-visible fields are `undefined` when they do not apply to the\n * current `type`, `wageType`, or self-onboarding selection. Always null-check\n * before rendering.\n *\n * @public\n */\nexport interface ContractorDetailsFormFields {\n  /** Radio group bound to `type`. Always available. */\n  Type: ComponentType<TypeFieldProps>\n  /** Radio group bound to `wageType`. Always available. */\n  WageType: ComponentType<WageTypeFieldProps>\n  /** Date picker bound to `startDate`. Always available. */\n  StartDate: ComponentType<StartDateFieldProps>\n  /** Number input bound to `hourlyRate`; available only when `wageType` is `Hourly`. */\n  HourlyRate: ComponentType<HourlyRateFieldProps> | undefined\n  /** Switch bound to `selfOnboarding`; available only when toggleable. */\n  SelfOnboarding: ComponentType<SelfOnboardingFieldProps> | undefined\n  /** Switch bound to `fileNewHireReport`; available only for individual contractors. */\n  FileNewHireReport: ComponentType<FileNewHireReportFieldProps> | undefined\n  /** Text input bound to `email`; available only when self-onboarding is enabled. */\n  Email: ComponentType<EmailFieldProps> | undefined\n  /** Text input bound to `firstName`; available only for individual contractors. */\n  FirstName: ComponentType<FirstNameFieldProps> | undefined\n  /** Text input bound to `lastName`; available only for individual contractors. */\n  LastName: ComponentType<LastNameFieldProps> | undefined\n  /** Text input bound to `middleInitial`; available only for individual contractors. */\n  MiddleInitial: ComponentType<MiddleInitialFieldProps> | undefined\n  /** Text input bound to `businessName`; available only for business contractors. */\n  BusinessName: ComponentType<BusinessNameFieldProps> | undefined\n  /**\n   * Text input bound to `ssn`; available only for individual contractors.\n   * Auto-formats as `XXX-XX-XXXX`. When an SSN is already on file the field\n   * shows a masked placeholder and the required rule is waived.\n   */\n  Ssn: ComponentType<SsnFieldProps> | undefined\n  /**\n   * Text input bound to `ein`; available only for business contractors.\n   * Auto-formats as `XX-XXXXXXX`. When an EIN is already on file the field\n   * shows a masked placeholder and the required rule is waived.\n   */\n  Ein: ComponentType<EinFieldProps> | undefined\n  /** Select bound to `workState`; available only for individual contractors filing a new-hire report. */\n  WorkState: ComponentType<WorkStateFieldProps> | undefined\n}\n\n/**\n * The ready-state result returned by {@link useContractorDetailsForm} once data has loaded.\n *\n * @public\n */\nexport interface UseContractorDetailsFormReady extends BaseFormHookReady<\n  ContractorDetailsFieldsMetadata,\n  ContractorDetailsFormData,\n  ContractorDetailsFormFields\n> {\n  /** The loaded contractor data, or `null` in create mode. */\n  data: {\n    /** The contractor being edited, or `null` in create mode. */\n    contractor: Contractor | null\n  }\n  /** Submit status and form mode. */\n  status: {\n    /** `true` while the create or update mutation is in flight. */\n    isPending: boolean\n    /** `'create'` when no `contractorId` was supplied, `'update'` otherwise. */\n    mode: 'create' | 'update'\n  }\n  /** Submit and related actions. */\n  actions: {\n    /** Validates the form and submits the changes. Returns the created or updated contractor, or `undefined` when validation fails. */\n    onSubmit: (\n      options?: ContractorDetailsSubmitOptions,\n    ) => Promise<HookSubmitResult<Contractor> | undefined>\n  }\n}\n\nconst isCurrentlySelfOnboarding = (contractor?: Contractor) =>\n  !!contractor?.onboardingStatus &&\n  ContractorSelfOnboardingStatuses.has(contractor.onboardingStatus)\n\nconst canToggleSelfOnboarding = (contractor?: Contractor) => {\n  if (!contractor) return true\n  return (\n    contractor.onboardingStatus === ContractorOnboardingStatus.ADMIN_ONBOARDING_INCOMPLETE ||\n    contractor.onboardingStatus === ContractorOnboardingStatus.SELF_ONBOARDING_NOT_INVITED\n  )\n}\n\n/** @internal */\nfunction buildContractorDetailsFieldsMetadata(\n  base: Record<keyof ContractorDetailsFormData, FieldMetadata>,\n) {\n  const typeEntries = [ContractorType.Individual, ContractorType.Business]\n  const wageTypeEntries = [WageType.Hourly, WageType.Fixed]\n  return {\n    type: withOptions(\n      base.type,\n      typeEntries.map(value => ({ value, label: value })),\n      typeEntries,\n    ),\n    wageType: withOptions(\n      base.wageType,\n      wageTypeEntries.map(value => ({ value, label: value })),\n      wageTypeEntries,\n    ),\n    startDate: base.startDate,\n    hourlyRate: base.hourlyRate,\n    selfOnboarding: base.selfOnboarding,\n    fileNewHireReport: base.fileNewHireReport,\n    email: base.email,\n    firstName: base.firstName,\n    lastName: base.lastName,\n    middleInitial: base.middleInitial,\n    businessName: base.businessName,\n    ssn: base.ssn,\n    ein: base.ein,\n    workState: withOptions(\n      base.workState,\n      STATES_ABBR.map(abbr => ({ value: abbr, label: abbr })),\n      STATES_ABBR,\n    ),\n  } satisfies FieldsMetadata\n}\n\n/**\n * Headless hook for creating or updating a contractor's profile details —\n * individual vs. business type, wage type, names, SSN/EIN, work state, and the\n * self-onboarding preference.\n *\n * @remarks\n * Returns a discriminated union: a loading variant while the contractor fetch\n * resolves, and a ready variant exposing the form's data, pending status,\n * submit action, error handling, and bound `Fields`. Field visibility is\n * driven by the current `type` and `wageType` (self-onboarding toggles the\n * `Email` field unless `showEmailField` is set); fields that do not apply are `undefined` on `form.Fields`.\n * SSN/EIN are exposed by contractor type regardless of self-onboarding — each\n * consumer decides whether to render them. Self-onboarding is only toggleable\n * when the contractor's onboarding status allows it.\n *\n * @param input - See {@link UseContractorDetailsFormProps}.\n * @returns A {@link HookLoadingResult} while loading, or a {@link UseContractorDetailsFormReady} once ready.\n * @public\n *\n * @example\n * ```tsx\n * import {\n *   useContractorDetailsForm,\n *   SDKFormProvider,\n *   type UseContractorDetailsFormReady,\n * } from '@gusto/embedded-react-sdk'\n *\n * function ContractorDetailsPage({\n *   companyId,\n *   contractorId,\n * }: {\n *   companyId: string\n *   contractorId: string\n * }) {\n *   const contractorDetails = useContractorDetailsForm({ companyId, contractorId })\n *\n *   if (contractorDetails.isLoading) return <div>Loading...</div>\n *\n *   return <ContractorDetailsReady contractorDetails={contractorDetails} />\n * }\n *\n * function ContractorDetailsReady({\n *   contractorDetails,\n * }: {\n *   contractorDetails: UseContractorDetailsFormReady\n * }) {\n *   const { Fields } = contractorDetails.form\n *\n *   return (\n *     <SDKFormProvider formHookResult={contractorDetails}>\n *       <form onSubmit={e => { e.preventDefault(); void contractorDetails.actions.onSubmit() }}>\n *         <Fields.Type label=\"Contractor type\" />\n *         <Fields.WageType label=\"Wage type\" />\n *         {Fields.FirstName && <Fields.FirstName label=\"First name\" />}\n *         {Fields.LastName && <Fields.LastName label=\"Last name\" />}\n *         {Fields.BusinessName && <Fields.BusinessName label=\"Business name\" />}\n *         <Fields.StartDate label=\"Start date\" />\n *         <button type=\"submit\" disabled={contractorDetails.status.isPending}>Save</button>\n *       </form>\n *     </SDKFormProvider>\n *   )\n * }\n * ```\n */\nexport function useContractorDetailsForm({\n  companyId,\n  contractorId,\n  withSelfOnboardingField = true,\n  showEmailField = false,\n  optionalFieldsToRequire,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseContractorDetailsFormProps): HookLoadingResult | UseContractorDetailsFormReady {\n  const contractorQuery = useContractorsGet(\n    { contractorUuid: contractorId ?? '' },\n    { enabled: !!contractorId },\n  )\n\n  const contractor = contractorQuery.data?.contractorShow\n\n  const isCreateMode = !contractorId\n  const isSelfOnboardingToggleable = canToggleSelfOnboarding(contractor)\n\n  const mode = isCreateMode ? 'create' : 'update'\n  const hasSsn = contractor?.hasSsn ?? false\n  const hasEin = contractor?.hasEin ?? false\n\n  const [schema, metadataConfig] = useMemo(\n    () => createContractorDetailsSchema({ mode, optionalFieldsToRequire, hasSsn, hasEin }),\n    [mode, optionalFieldsToRequire, hasSsn, hasEin],\n  )\n\n  const parsedHourlyRate =\n    contractor?.hourlyRate != null ? parseFloat(contractor.hourlyRate) : undefined\n\n  const resolvedDefaults: ContractorDetailsFormData = useMemo(\n    () => ({\n      type: contractor?.type ?? partnerDefaults?.type ?? ContractorType.Individual,\n      wageType: contractor?.wageType ?? partnerDefaults?.wageType ?? WageType.Fixed,\n      startDate:\n        contractor?.startDate ??\n        partnerDefaults?.startDate ??\n        new Date().toISOString().split('T')[0]!,\n      hourlyRate: parsedHourlyRate ?? partnerDefaults?.hourlyRate ?? NaN,\n      selfOnboarding: partnerDefaults?.selfOnboarding ?? isCurrentlySelfOnboarding(contractor),\n      fileNewHireReport:\n        contractor?.fileNewHireReport ?? partnerDefaults?.fileNewHireReport ?? false,\n      email: contractor?.email ?? partnerDefaults?.email ?? '',\n      firstName: contractor?.firstName ?? partnerDefaults?.firstName ?? '',\n      lastName: contractor?.lastName ?? partnerDefaults?.lastName ?? '',\n      middleInitial: contractor?.middleInitial ?? partnerDefaults?.middleInitial ?? '',\n      businessName: contractor?.businessName ?? partnerDefaults?.businessName ?? '',\n      workState: contractor?.workState ?? partnerDefaults?.workState ?? '',\n      ssn: partnerDefaults?.ssn ?? '',\n      ein: partnerDefaults?.ein ?? '',\n    }),\n    [contractor, partnerDefaults, parsedHourlyRate],\n  )\n\n  const formMethods = useForm<ContractorDetailsFormData, unknown, ContractorDetailsFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const [watchedType, watchedWageType, watchedSelfOnboarding, watchedFileNewHireReport] = useWatch({\n    control: formMethods.control,\n    name: ['type', 'wageType', 'selfOnboarding', 'fileNewHireReport'],\n  })\n\n  // Render-gating: a field shows when it applies to the current selection. The\n  // schema mirrors this via `getExcludedContractorFields` so off-screen fields\n  // never trip a phantom required error.\n  const isIndividual = watchedType === ContractorType.Individual\n  const isBusiness = watchedType === ContractorType.Business\n  const isHourly = watchedWageType === WageType.Hourly\n\n  const createContractorMutation = useContractorsCreateMutation()\n  const updateContractorMutation = useContractorsUpdateMutation()\n\n  const isPending = createContractorMutation.isPending || updateContractorMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('ContractorDetailsForm')\n\n  const queries = contractorId ? [contractorQuery] : []\n  const errorHandling = composeErrorHandler(queries, { submitError, setSubmitError })\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const fieldsMetadata = buildContractorDetailsFieldsMetadata(baseMetadata)\n\n  const onSubmit = async (\n    options?: ContractorDetailsSubmitOptions,\n  ): Promise<HookSubmitResult<Contractor> | undefined> => {\n    let submitResult: HookSubmitResult<Contractor> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: ContractorDetailsFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const selfOnboardingEnabled = payload.selfOnboarding\n            const cleanedSsn = payload.ssn ? removeNonDigits(payload.ssn) : ''\n            const cleanedEin = payload.ein ? removeNonDigits(payload.ein) : ''\n\n            const requestBody: ContractorCreateRequestBody = {\n              type: payload.type,\n              wageType: payload.wageType,\n              startDate: payload.startDate,\n              selfOnboarding: selfOnboardingEnabled,\n              email:\n                showEmailField || selfOnboardingEnabled ? payload.email || undefined : undefined,\n              hourlyRate:\n                payload.wageType === WageType.Hourly ? String(payload.hourlyRate) : undefined,\n              ...(payload.type === ContractorType.Individual\n                ? {\n                    firstName: payload.firstName,\n                    lastName: payload.lastName,\n                    middleInitial: payload.middleInitial || undefined,\n                    fileNewHireReport: payload.fileNewHireReport,\n                    workState: payload.fileNewHireReport\n                      ? payload.workState || undefined\n                      : undefined,\n                    ssn: cleanedSsn || undefined,\n                  }\n                : {\n                    fileNewHireReport: false,\n                    businessName: payload.businessName,\n                    ein: cleanedEin || undefined,\n                  }),\n            }\n\n            let savedContractor: Contractor\n\n            if (isCreateMode) {\n              const resolvedCompanyId = options?.companyId ?? companyId\n              if (!resolvedCompanyId) {\n                throw new SDKInternalError('companyId is required to create a contractor')\n              }\n\n              const result = await createContractorMutation.mutateAsync({\n                request: {\n                  companyUuid: resolvedCompanyId,\n                  contractorCreateRequestBody: { ...requestBody, isActive: true },\n                },\n              })\n\n              if (!result.contractor) {\n                throw new SDKInternalError('Contractor creation failed')\n              }\n\n              savedContractor = result.contractor\n            } else {\n              if (!contractor?.version) {\n                throw new SDKInternalError('Contractor version is required for updates')\n              }\n\n              const updateBody: ContractorUpdateRequestBody = {\n                ...requestBody,\n                version: contractor.version,\n              }\n\n              const result = await updateContractorMutation.mutateAsync({\n                request: {\n                  contractorUuid: contractor.uuid,\n                  contractorUpdateRequestBody: updateBody,\n                },\n              })\n\n              if (!result.contractor) {\n                throw new SDKInternalError('Contractor update failed')\n              }\n\n              savedContractor = result.contractor\n            }\n\n            submitResult = {\n              mode: isCreateMode ? 'create' : 'update',\n              data: savedContractor,\n            }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  const isDataLoading = contractorId ? contractorQuery.isLoading : false\n\n  if (isDataLoading || (contractorId && !contractor)) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: {\n      contractor: contractor ?? null,\n    },\n    status: {\n      isPending,\n      mode: isCreateMode ? ('create' as const) : ('update' as const),\n    },\n    actions: { onSubmit },\n    errorHandling,\n    form: {\n      Fields: {\n        Type: TypeField,\n        WageType: WageTypeField,\n        StartDate: StartDateField,\n        HourlyRate: isHourly ? HourlyRateField : undefined,\n        SelfOnboarding:\n          withSelfOnboardingField && isSelfOnboardingToggleable ? SelfOnboardingField : undefined,\n        FileNewHireReport: isIndividual ? FileNewHireReportField : undefined,\n        Email: showEmailField || watchedSelfOnboarding ? EmailField : undefined,\n        FirstName: isIndividual ? FirstNameField : undefined,\n        LastName: isIndividual ? LastNameField : undefined,\n        MiddleInitial: isIndividual ? MiddleInitialField : undefined,\n        BusinessName: isBusiness ? BusinessNameField : undefined,\n        Ssn: isIndividual ? SsnField : undefined,\n        Ein: isBusiness ? EinField : undefined,\n        WorkState: isIndividual && watchedFileNewHireReport ? WorkStateField : undefined,\n      },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\n/**\n * Return type of {@link useContractorDetailsForm}.\n *\n * @public\n */\nexport type UseContractorDetailsFormResult = HookLoadingResult | UseContractorDetailsFormReady\n\n/**\n * Shape of `form.fieldsMetadata` returned by {@link useContractorDetailsForm}.\n *\n * @public\n */\nexport type ContractorDetailsFieldsMetadata = ReturnType<\n  typeof buildContractorDetailsFieldsMetadata\n>\n"],"names":["isCurrentlySelfOnboarding","contractor","ContractorSelfOnboardingStatuses","canToggleSelfOnboarding","ContractorOnboardingStatus","buildContractorDetailsFieldsMetadata","base","typeEntries","ContractorType","wageTypeEntries","WageType","withOptions","value","STATES_ABBR","abbr","useContractorDetailsForm","companyId","contractorId","withSelfOnboardingField","showEmailField","optionalFieldsToRequire","partnerDefaults","validationMode","shouldFocusError","contractorQuery","useContractorsGet","isCreateMode","isSelfOnboardingToggleable","mode","hasSsn","hasEin","schema","metadataConfig","useMemo","createContractorDetailsSchema","parsedHourlyRate","resolvedDefaults","formMethods","useForm","zodResolver","watchedType","watchedWageType","watchedSelfOnboarding","watchedFileNewHireReport","useWatch","isIndividual","isBusiness","isHourly","createContractorMutation","useContractorsCreateMutation","updateContractorMutation","useContractorsUpdateMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","onSubmit","options","submitResult","resolve","data","payload","selfOnboardingEnabled","cleanedSsn","removeNonDigits","cleanedEin","requestBody","savedContractor","resolvedCompanyId","SDKInternalError","result","updateBody","hookFormInternals","useHookFormInternals","TypeField","WageTypeField","StartDateField","HourlyRateField","SelfOnboardingField","FileNewHireReportField","EmailField","FirstNameField","LastNameField","MiddleInitialField","BusinessNameField","SsnField","EinField","WorkStateField","createGetFormSubmissionValues"],"mappings":"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"}
+{"version":3,"file":"useContractorDetailsForm.js","sources":["../../../../../../src/components/Contractor/Profile/shared/useContractorDetailsForm/useContractorDetailsForm.tsx"],"sourcesContent":["import { useMemo } from 'react'\nimport type { ComponentType } from 'react'\nimport { useForm, useWatch } from 'react-hook-form'\nimport type { UseFormProps } from 'react-hook-form'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport type { Contractor } from '@gusto/embedded-api/models/components/contractor'\nimport type { ContractorCreateRequestBody } from '@gusto/embedded-api/models/components/contractorcreaterequestbody'\nimport type { ContractorUpdateRequestBody } from '@gusto/embedded-api/models/components/contractorupdaterequestbody'\nimport { useContractorsGet } from '@gusto/embedded-api/react-query/contractorsGet'\nimport { useContractorsCreateMutation } from '@gusto/embedded-api/react-query/contractorsCreate'\nimport { useContractorsUpdateMutation } from '@gusto/embedded-api/react-query/contractorsUpdate'\nimport {\n  ContractorType,\n  WageType,\n  createContractorDetailsSchema,\n  type ContractorDetailsOptionalFieldsToRequire,\n  type ContractorDetailsFormData,\n  type ContractorDetailsFormOutputs,\n} from './contractorDetailsSchema'\nimport {\n  TypeField,\n  WageTypeField,\n  StartDateField,\n  HourlyRateField,\n  SelfOnboardingField,\n  FileNewHireReportField,\n  EmailField,\n  FirstNameField,\n  LastNameField,\n  MiddleInitialField,\n  BusinessNameField,\n  SsnField,\n  EinField,\n  WorkStateField,\n} from './fields'\nimport type {\n  TypeFieldProps,\n  WageTypeFieldProps,\n  StartDateFieldProps,\n  HourlyRateFieldProps,\n  SelfOnboardingFieldProps,\n  FileNewHireReportFieldProps,\n  EmailFieldProps,\n  FirstNameFieldProps,\n  LastNameFieldProps,\n  MiddleInitialFieldProps,\n  BusinessNameFieldProps,\n  SsnFieldProps,\n  EinFieldProps,\n  WorkStateFieldProps,\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 {\n  ContractorSelfOnboardingStatuses,\n  ContractorOnboardingStatus,\n  STATES_ABBR,\n} from '@/shared/constants'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { SDKInternalError } from '@/types/sdkError'\nimport { removeNonDigits } from '@/helpers/formattedStrings'\n\nexport type { ContractorDetailsOptionalFieldsToRequire } from './contractorDetailsSchema'\n\n/**\n * Optional overrides passed to {@link UseContractorDetailsFormReady.actions.onSubmit | onSubmit}.\n *\n * @public\n */\nexport interface ContractorDetailsSubmitOptions {\n  /** Override the company identifier supplied to the hook (e.g. after creating the company in the same flow). Only used in create mode. */\n  companyId?: string\n}\n\n/**\n * Shared options merged into both branches of {@link UseContractorDetailsFormProps}.\n *\n * @public\n */\nexport type UseContractorDetailsFormSharedProps = {\n  /** Whether to expose the self-onboarding toggle as `form.Fields.SelfOnboarding`. Defaults to `true`. */\n  withSelfOnboardingField?: boolean\n  /**\n   * Whether `form.Fields.Email` is available regardless of the `selfOnboarding` value.\n   *\n   * @remarks\n   * By default `Email` is only exposed while `selfOnboarding` is `true`, since email is\n   * otherwise only collected to send a self-onboarding invite. Set this to `true` for\n   * surfaces that let an admin edit an already-onboarded contractor's email directly.\n   * Defaults to `false`.\n   */\n  showEmailField?: boolean\n  /** Fields that are optional by default but should be promoted to required for this form instance. */\n  optionalFieldsToRequire?: ContractorDetailsOptionalFieldsToRequire\n  /** Initial values applied before any contractor data loads. */\n  defaultValues?: Partial<ContractorDetailsFormData>\n  /** When validation runs. Forwarded to react-hook-form's `mode`. Defaults to `'onSubmit'`. */\n  validationMode?: UseFormProps['mode']\n  /** Whether react-hook-form should focus the first error on validation failure. Defaults to `true`. */\n  shouldFocusError?: boolean\n}\n\n/**\n * Options for {@link useContractorDetailsForm}.\n *\n * @remarks\n * Discriminated by mode: in create mode supply `companyId` and omit\n * `contractorId`; in update mode supply `contractorId` (and optionally\n * `companyId`).\n *\n * @public\n */\nexport type UseContractorDetailsFormProps =\n  | (UseContractorDetailsFormSharedProps & { companyId: string; contractorId?: never })\n  | (UseContractorDetailsFormSharedProps & { contractorId: string; companyId?: string })\n\n/**\n * The Field components exposed by {@link useContractorDetailsForm} as `form.Fields`.\n *\n * @remarks\n * Conditionally-visible fields are `undefined` when they do not apply to the\n * current `type`, `wageType`, or self-onboarding selection. Always null-check\n * before rendering.\n *\n * @public\n */\nexport interface ContractorDetailsFormFields {\n  /** Radio group bound to `type`. Always available. */\n  Type: ComponentType<TypeFieldProps>\n  /** Radio group bound to `wageType`. Always available. */\n  WageType: ComponentType<WageTypeFieldProps>\n  /** Date picker bound to `startDate`. Always available. */\n  StartDate: ComponentType<StartDateFieldProps>\n  /** Number input bound to `hourlyRate`; available only when `wageType` is `Hourly`. */\n  HourlyRate: ComponentType<HourlyRateFieldProps> | undefined\n  /** Switch bound to `selfOnboarding`; available only when toggleable. */\n  SelfOnboarding: ComponentType<SelfOnboardingFieldProps> | undefined\n  /** Switch bound to `fileNewHireReport`; available only for individual contractors. */\n  FileNewHireReport: ComponentType<FileNewHireReportFieldProps> | undefined\n  /** Text input bound to `email`; available only when self-onboarding is enabled. */\n  Email: ComponentType<EmailFieldProps> | undefined\n  /** Text input bound to `firstName`; available only for individual contractors. */\n  FirstName: ComponentType<FirstNameFieldProps> | undefined\n  /** Text input bound to `lastName`; available only for individual contractors. */\n  LastName: ComponentType<LastNameFieldProps> | undefined\n  /** Text input bound to `middleInitial`; available only for individual contractors. */\n  MiddleInitial: ComponentType<MiddleInitialFieldProps> | undefined\n  /** Text input bound to `businessName`; available only for business contractors. */\n  BusinessName: ComponentType<BusinessNameFieldProps> | undefined\n  /**\n   * Text input bound to `ssn`; available only for individual contractors.\n   * Auto-formats as `XXX-XX-XXXX`. When an SSN is already on file the field\n   * shows a masked placeholder and the required rule is waived.\n   */\n  Ssn: ComponentType<SsnFieldProps> | undefined\n  /**\n   * Text input bound to `ein`; available only for business contractors.\n   * Auto-formats as `XX-XXXXXXX`. When an EIN is already on file the field\n   * shows a masked placeholder and the required rule is waived.\n   */\n  Ein: ComponentType<EinFieldProps> | undefined\n  /** Select bound to `workState`; available only for individual contractors filing a new-hire report. */\n  WorkState: ComponentType<WorkStateFieldProps> | undefined\n}\n\n/**\n * The ready-state result returned by {@link useContractorDetailsForm} once data has loaded.\n *\n * @public\n */\nexport interface UseContractorDetailsFormReady extends BaseFormHookReady<\n  ContractorDetailsFieldsMetadata,\n  ContractorDetailsFormData,\n  ContractorDetailsFormFields\n> {\n  /** The loaded contractor data, or `null` in create mode. */\n  data: {\n    /** The contractor being edited, or `null` in create mode. */\n    contractor: Contractor | null\n  }\n  /** Submit status and form mode. */\n  status: {\n    /** `true` while the create or update mutation is in flight. */\n    isPending: boolean\n    /** `'create'` when no `contractorId` was supplied, `'update'` otherwise. */\n    mode: 'create' | 'update'\n  }\n  /** Submit and related actions. */\n  actions: {\n    /** Validates the form and submits the changes. Returns the created or updated contractor, or `undefined` when validation fails. */\n    onSubmit: (\n      options?: ContractorDetailsSubmitOptions,\n    ) => Promise<HookSubmitResult<Contractor> | undefined>\n  }\n}\n\nconst isCurrentlySelfOnboarding = (contractor?: Contractor) =>\n  !!contractor?.onboardingStatus &&\n  ContractorSelfOnboardingStatuses.has(contractor.onboardingStatus)\n\nconst canToggleSelfOnboarding = (contractor?: Contractor) => {\n  if (!contractor) return true\n  return (\n    contractor.onboardingStatus === ContractorOnboardingStatus.ADMIN_ONBOARDING_INCOMPLETE ||\n    contractor.onboardingStatus === ContractorOnboardingStatus.SELF_ONBOARDING_NOT_INVITED\n  )\n}\n\n/** @internal */\nfunction buildContractorDetailsFieldsMetadata(\n  base: Record<keyof ContractorDetailsFormData, FieldMetadata>,\n) {\n  const typeEntries = [ContractorType.Individual, ContractorType.Business]\n  const wageTypeEntries = [WageType.Hourly, WageType.Fixed]\n  return {\n    type: withOptions(\n      base.type,\n      typeEntries.map(value => ({ value, label: value })),\n      typeEntries,\n    ),\n    wageType: withOptions(\n      base.wageType,\n      wageTypeEntries.map(value => ({ value, label: value })),\n      wageTypeEntries,\n    ),\n    startDate: base.startDate,\n    hourlyRate: base.hourlyRate,\n    selfOnboarding: base.selfOnboarding,\n    fileNewHireReport: base.fileNewHireReport,\n    email: base.email,\n    firstName: base.firstName,\n    lastName: base.lastName,\n    middleInitial: base.middleInitial,\n    businessName: base.businessName,\n    ssn: base.ssn,\n    ein: base.ein,\n    workState: withOptions(\n      base.workState,\n      STATES_ABBR.map(abbr => ({ value: abbr, label: abbr })),\n      STATES_ABBR,\n    ),\n  } satisfies FieldsMetadata\n}\n\n/**\n * Headless hook for creating or updating a contractor's profile details —\n * individual vs. business type, wage type, names, SSN/EIN, work state, and the\n * self-onboarding preference.\n *\n * @remarks\n * Returns a discriminated union: a loading variant while the contractor fetch\n * resolves, and a ready variant exposing the form's data, pending status,\n * submit action, error handling, and bound `Fields`. Field visibility is\n * driven by the current `type` and `wageType` (self-onboarding toggles the\n * `Email` field unless `showEmailField` is set); fields that do not apply are `undefined` on `form.Fields`.\n * SSN/EIN are exposed by contractor type regardless of self-onboarding — each\n * consumer decides whether to render them. Self-onboarding is only toggleable\n * when the contractor's onboarding status allows it.\n *\n * @param input - See {@link UseContractorDetailsFormProps}.\n * @returns A {@link HookLoadingResult} while loading, or a {@link UseContractorDetailsFormReady} once ready.\n * @public\n *\n * @example\n * ```tsx\n * import {\n *   useContractorDetailsForm,\n *   SDKFormProvider,\n *   type UseContractorDetailsFormReady,\n * } from '@gusto/embedded-react-sdk'\n *\n * function ContractorDetailsPage({\n *   companyId,\n *   contractorId,\n * }: {\n *   companyId: string\n *   contractorId: string\n * }) {\n *   const contractorDetails = useContractorDetailsForm({ companyId, contractorId })\n *\n *   if (contractorDetails.isLoading) return <div>Loading...</div>\n *\n *   return <ContractorDetailsReady contractorDetails={contractorDetails} />\n * }\n *\n * function ContractorDetailsReady({\n *   contractorDetails,\n * }: {\n *   contractorDetails: UseContractorDetailsFormReady\n * }) {\n *   const { Fields } = contractorDetails.form\n *\n *   return (\n *     <SDKFormProvider formHookResult={contractorDetails}>\n *       <form onSubmit={e => { e.preventDefault(); void contractorDetails.actions.onSubmit() }}>\n *         <Fields.Type label=\"Contractor type\" />\n *         <Fields.WageType label=\"Wage type\" />\n *         {Fields.FirstName && <Fields.FirstName label=\"First name\" />}\n *         {Fields.LastName && <Fields.LastName label=\"Last name\" />}\n *         {Fields.BusinessName && <Fields.BusinessName label=\"Business name\" />}\n *         <Fields.StartDate label=\"Start date\" />\n *         <button type=\"submit\" disabled={contractorDetails.status.isPending}>Save</button>\n *       </form>\n *     </SDKFormProvider>\n *   )\n * }\n * ```\n */\nexport function useContractorDetailsForm({\n  companyId,\n  contractorId,\n  withSelfOnboardingField = true,\n  showEmailField = false,\n  optionalFieldsToRequire,\n  defaultValues: partnerDefaults,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n}: UseContractorDetailsFormProps): HookLoadingResult | UseContractorDetailsFormReady {\n  const contractorQuery = useContractorsGet(\n    { contractorUuid: contractorId ?? '' },\n    { enabled: !!contractorId },\n  )\n\n  const contractor = contractorQuery.data?.contractorShow\n\n  const isCreateMode = !contractorId\n  const isSelfOnboardingToggleable = canToggleSelfOnboarding(contractor)\n\n  const mode = isCreateMode ? 'create' : 'update'\n  const hasSsn = contractor?.hasSsn ?? false\n  const hasEin = contractor?.hasEin ?? false\n\n  const [schema, metadataConfig] = useMemo(\n    () => createContractorDetailsSchema({ mode, optionalFieldsToRequire, hasSsn, hasEin }),\n    [mode, optionalFieldsToRequire, hasSsn, hasEin],\n  )\n\n  const parsedHourlyRate =\n    contractor?.hourlyRate != null ? parseFloat(contractor.hourlyRate) : undefined\n\n  const resolvedDefaults: ContractorDetailsFormData = useMemo(\n    () => ({\n      type: contractor?.type ?? partnerDefaults?.type ?? ContractorType.Individual,\n      wageType: contractor?.wageType ?? partnerDefaults?.wageType ?? WageType.Fixed,\n      startDate:\n        contractor?.startDate ??\n        partnerDefaults?.startDate ??\n        new Date().toISOString().split('T')[0]!,\n      hourlyRate: parsedHourlyRate ?? partnerDefaults?.hourlyRate ?? NaN,\n      selfOnboarding: partnerDefaults?.selfOnboarding ?? isCurrentlySelfOnboarding(contractor),\n      fileNewHireReport:\n        contractor?.fileNewHireReport ?? partnerDefaults?.fileNewHireReport ?? false,\n      email: contractor?.email ?? partnerDefaults?.email ?? '',\n      firstName: contractor?.firstName ?? partnerDefaults?.firstName ?? '',\n      lastName: contractor?.lastName ?? partnerDefaults?.lastName ?? '',\n      middleInitial: contractor?.middleInitial ?? partnerDefaults?.middleInitial ?? '',\n      businessName: contractor?.businessName ?? partnerDefaults?.businessName ?? '',\n      workState: contractor?.workState ?? partnerDefaults?.workState ?? '',\n      ssn: partnerDefaults?.ssn ?? '',\n      ein: partnerDefaults?.ein ?? '',\n    }),\n    [contractor, partnerDefaults, parsedHourlyRate],\n  )\n\n  const formMethods = useForm<ContractorDetailsFormData, unknown, ContractorDetailsFormOutputs>({\n    resolver: zodResolver(schema),\n    mode: validationMode,\n    shouldFocusError,\n    defaultValues: resolvedDefaults,\n    values: resolvedDefaults,\n    resetOptions: { keepDirtyValues: true },\n  })\n\n  const [watchedType, watchedWageType, watchedSelfOnboarding, watchedFileNewHireReport] = useWatch({\n    control: formMethods.control,\n    name: ['type', 'wageType', 'selfOnboarding', 'fileNewHireReport'],\n  })\n\n  // Render-gating: a field shows when it applies to the current selection. The\n  // schema mirrors this via `getExcludedContractorFields` so off-screen fields\n  // never trip a phantom required error.\n  const isIndividual = watchedType === ContractorType.Individual\n  const isBusiness = watchedType === ContractorType.Business\n  const isHourly = watchedWageType === WageType.Hourly\n\n  const createContractorMutation = useContractorsCreateMutation()\n  const updateContractorMutation = useContractorsUpdateMutation()\n\n  const isPending = createContractorMutation.isPending || updateContractorMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('ContractorDetailsForm')\n\n  const queries = contractorId ? [contractorQuery] : []\n  const errorHandling = composeErrorHandler(queries, { submitError, setSubmitError })\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n  const fieldsMetadata = buildContractorDetailsFieldsMetadata(baseMetadata)\n\n  const onSubmit = async (\n    options?: ContractorDetailsSubmitOptions,\n  ): Promise<HookSubmitResult<Contractor> | undefined> => {\n    let submitResult: HookSubmitResult<Contractor> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: ContractorDetailsFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            const selfOnboardingEnabled = payload.selfOnboarding\n            const cleanedSsn = payload.ssn ? removeNonDigits(payload.ssn) : ''\n            const cleanedEin = payload.ein ? removeNonDigits(payload.ein) : ''\n\n            const requestBody: ContractorCreateRequestBody = {\n              type: payload.type,\n              wageType: payload.wageType,\n              startDate: payload.startDate,\n              selfOnboarding: selfOnboardingEnabled,\n              email:\n                showEmailField || selfOnboardingEnabled ? payload.email || undefined : undefined,\n              // On update, an Hourly contractor with no stored rate has no `hourlyRate` value at\n              // all; the finite check keeps that from serializing as the string \"undefined\".\n              hourlyRate:\n                payload.wageType === WageType.Hourly && Number.isFinite(payload.hourlyRate)\n                  ? String(payload.hourlyRate)\n                  : undefined,\n              ...(payload.type === ContractorType.Individual\n                ? {\n                    firstName: payload.firstName,\n                    lastName: payload.lastName,\n                    middleInitial: payload.middleInitial || undefined,\n                    fileNewHireReport: payload.fileNewHireReport,\n                    workState: payload.fileNewHireReport\n                      ? payload.workState || undefined\n                      : undefined,\n                    ssn: cleanedSsn || undefined,\n                  }\n                : {\n                    fileNewHireReport: false,\n                    businessName: payload.businessName,\n                    ein: cleanedEin || undefined,\n                  }),\n            }\n\n            let savedContractor: Contractor\n\n            if (isCreateMode) {\n              const resolvedCompanyId = options?.companyId ?? companyId\n              if (!resolvedCompanyId) {\n                throw new SDKInternalError('companyId is required to create a contractor')\n              }\n\n              const result = await createContractorMutation.mutateAsync({\n                request: {\n                  companyUuid: resolvedCompanyId,\n                  contractorCreateRequestBody: { ...requestBody, isActive: true },\n                },\n              })\n\n              if (!result.contractor) {\n                throw new SDKInternalError('Contractor creation failed')\n              }\n\n              savedContractor = result.contractor\n            } else {\n              if (!contractor?.version) {\n                throw new SDKInternalError('Contractor version is required for updates')\n              }\n\n              const updateBody: ContractorUpdateRequestBody = {\n                ...requestBody,\n                version: contractor.version,\n              }\n\n              const result = await updateContractorMutation.mutateAsync({\n                request: {\n                  contractorUuid: contractor.uuid,\n                  contractorUpdateRequestBody: updateBody,\n                },\n              })\n\n              if (!result.contractor) {\n                throw new SDKInternalError('Contractor update failed')\n              }\n\n              savedContractor = result.contractor\n            }\n\n            submitResult = {\n              mode: isCreateMode ? 'create' : 'update',\n              data: savedContractor,\n            }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  const isDataLoading = contractorId ? contractorQuery.isLoading : false\n\n  if (isDataLoading || (contractorId && !contractor)) {\n    return { isLoading: true as const, errorHandling }\n  }\n\n  return {\n    isLoading: false as const,\n    data: {\n      contractor: contractor ?? null,\n    },\n    status: {\n      isPending,\n      mode: isCreateMode ? ('create' as const) : ('update' as const),\n    },\n    actions: { onSubmit },\n    errorHandling,\n    form: {\n      Fields: {\n        Type: TypeField,\n        WageType: WageTypeField,\n        StartDate: StartDateField,\n        HourlyRate: isHourly ? HourlyRateField : undefined,\n        SelfOnboarding:\n          withSelfOnboardingField && isSelfOnboardingToggleable ? SelfOnboardingField : undefined,\n        FileNewHireReport: isIndividual ? FileNewHireReportField : undefined,\n        Email: showEmailField || watchedSelfOnboarding ? EmailField : undefined,\n        FirstName: isIndividual ? FirstNameField : undefined,\n        LastName: isIndividual ? LastNameField : undefined,\n        MiddleInitial: isIndividual ? MiddleInitialField : undefined,\n        BusinessName: isBusiness ? BusinessNameField : undefined,\n        Ssn: isIndividual ? SsnField : undefined,\n        Ein: isBusiness ? EinField : undefined,\n        WorkState: isIndividual && watchedFileNewHireReport ? WorkStateField : undefined,\n      },\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n\n/**\n * Return type of {@link useContractorDetailsForm}.\n *\n * @public\n */\nexport type UseContractorDetailsFormResult = HookLoadingResult | UseContractorDetailsFormReady\n\n/**\n * Shape of `form.fieldsMetadata` returned by {@link useContractorDetailsForm}.\n *\n * @public\n */\nexport type ContractorDetailsFieldsMetadata = ReturnType<\n  typeof buildContractorDetailsFieldsMetadata\n>\n"],"names":["isCurrentlySelfOnboarding","contractor","ContractorSelfOnboardingStatuses","canToggleSelfOnboarding","ContractorOnboardingStatus","buildContractorDetailsFieldsMetadata","base","typeEntries","ContractorType","wageTypeEntries","WageType","withOptions","value","STATES_ABBR","abbr","useContractorDetailsForm","companyId","contractorId","withSelfOnboardingField","showEmailField","optionalFieldsToRequire","partnerDefaults","validationMode","shouldFocusError","contractorQuery","useContractorsGet","isCreateMode","isSelfOnboardingToggleable","mode","hasSsn","hasEin","schema","metadataConfig","useMemo","createContractorDetailsSchema","parsedHourlyRate","resolvedDefaults","formMethods","useForm","zodResolver","watchedType","watchedWageType","watchedSelfOnboarding","watchedFileNewHireReport","useWatch","isIndividual","isBusiness","isHourly","createContractorMutation","useContractorsCreateMutation","updateContractorMutation","useContractorsUpdateMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","onSubmit","options","submitResult","resolve","data","payload","selfOnboardingEnabled","cleanedSsn","removeNonDigits","cleanedEin","requestBody","savedContractor","resolvedCompanyId","SDKInternalError","result","updateBody","hookFormInternals","useHookFormInternals","TypeField","WageTypeField","StartDateField","HourlyRateField","SelfOnboardingField","FileNewHireReportField","EmailField","FirstNameField","LastNameField","MiddleInitialField","BusinessNameField","SsnField","EinField","WorkStateField","createGetFormSubmissionValues"],"mappings":"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"}

package/dist/components/Contractor/shared/hourlyRate.js

@@ -0,0 +1,14 @@
+import { z as r } from "zod";
+import { coerceNaN as o } from "../../../partner-hook-utils/form/preprocessors.js";
+const t = 1e12;
+function c(e) {
+  return r.preprocess(
+    o(0),
+    r.number().min(0).max(t, { message: e })
+  );
+}
+export {
+  t as HOURLY_RATE_CAP,
+  c as createHourlyRateValidator
+};
+//# sourceMappingURL=hourlyRate.js.map

package/dist/components/Contractor/shared/hourlyRate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hourlyRate.js","sources":["../../../../src/components/Contractor/shared/hourlyRate.ts"],"sourcesContent":["import { z } from 'zod'\nimport { coerceNaN } from '@/partner-hook-utils/form/preprocessors'\n\n/**\n * Largest hourly rate the contractor create/update API accepts. Mirrored client-side so an\n * over-limit value is caught inline instead of round-tripping to an API error.\n *\n * @internal\n */\nexport const HOURLY_RATE_CAP = 1_000_000_000_000\n\n/**\n * Builds the `hourlyRate` validator shared by the contractor pay and contractor details forms.\n *\n * @remarks\n * Only bounded to non-negative, so a Fixed contractor's default of 0 stays valid while the field\n * doesn't apply to them. Each schema decides separately when an Hourly contractor must supply a\n * rate — `superRefine` in `contractorPaySchema`, `requiredFieldsConfig` + `excludeFields` in\n * `contractorDetailsSchema`.\n *\n * @param maxErrorCode - The calling schema's own \"rate too large\" error code, so validation types\n *   stay derived from that schema's error-codes constant.\n * @returns A `z.preprocess` validator producing a number between 0 and {@link HOURLY_RATE_CAP}.\n * @internal\n */\nexport function createHourlyRateValidator(maxErrorCode: string) {\n  return z.preprocess(\n    coerceNaN(0),\n    z.number().min(0).max(HOURLY_RATE_CAP, { message: maxErrorCode }),\n  )\n}\n"],"names":["HOURLY_RATE_CAP","createHourlyRateValidator","maxErrorCode","z","coerceNaN"],"mappings":";;AASO,MAAMA,IAAkB;AAgBxB,SAASC,EAA0BC,GAAsB;AAC9D,SAAOC,EAAE;AAAA,IACPC,EAAU,CAAC;AAAA,IACXD,EAAE,SAAS,IAAI,CAAC,EAAE,IAAIH,GAAiB,EAAE,SAASE,EAAA,CAAc;AAAA,EAAA;AAEpE;"}

package/dist/components/Employee/Compensation/management/CompensationCard/CompensationCard.js

@@ -5,14 +5,14 @@ import { useJobsAndCompensationsDeleteMutation as pe } from "@gusto/embedded-api
 import { usePendingChangeDetailRenderer as ge } from "../../shared/usePendingChangeDetailRenderer.js";
 import { PendingChangesReviewModal as fe } from "../../shared/PendingChangesReviewModal.js";
 import k from "./CompensationCard.module.scss.js";
-import { Flex as P } from "../../../../Common/Flex/Flex.js";
-import { useComponentContext as Y } from "../../../../../contexts/ComponentAdapter/useComponentContext.js";
+import { Flex as T } from "../../../../Common/Flex/Flex.js";
+import { useComponentContext as G } from "../../../../../contexts/ComponentAdapter/useComponentContext.js";
 import { Loading as Ce } from "../../../../Common/Loading/Loading.js";
 import { EmptyData as he } from "../../../../Common/EmptyData/EmptyData.js";
 import { HamburgerMenu as be } from "../../../../Common/HamburgerMenu/HamburgerMenu.js";
-import { BaseBoundaries as Ee, BaseLayout as G } from "../../../../Base/Base.js";
-import { formatDateToStringDate as ye, formatDateLongWithYear as b } from "../../../../../helpers/dateFormatting.js";
-import { useFormatCompensationRate as De } from "../../../../../helpers/formattedStrings.js";
+import { BaseBoundaries as Ee, BaseLayout as V } from "../../../../Base/Base.js";
+import { formatDateToStringDate as De, formatDateLongWithYear as E } from "../../../../../helpers/dateFormatting.js";
+import { useFormatCompensationRate as ye } from "../../../../../helpers/formattedStrings.js";
 import { useI18n as Ae } from "../../../../../i18n/I18n.js";
 import { componentEvents as C, FlsaStatus as H } from "../../../../../shared/constants.js";
 import I from "../../../../../assets/icons/plus-circle.svg.js";
@@ -21,84 +21,84 @@ import Je from "../../../../../assets/icons/pencil.svg.js";
 import { useCompensationManagement as Pe } from "../../shared/useCompensationManagement/useCompensationManagement.js";
 import { VisuallyHidden as Te } from "../../../../Common/VisuallyHidden/VisuallyHidden.js";
 import { useDataView as Me } from "../../../../Common/DataView/useDataView.js";
-import { DataView as ve } from "../../../../Common/DataView/DataView.js";
-function F(o) {
-  if (o === void 0) return null;
-  const r = parseFloat(o);
+import { DataView as Se } from "../../../../Common/DataView/DataView.js";
+function F(a) {
+  if (a === void 0) return null;
+  const r = parseFloat(a);
   return Number.isFinite(r) ? r : null;
 }
-function nt({ LoaderComponent: o, ...r }) {
+function nt({ LoaderComponent: a, ...r }) {
   return /* @__PURE__ */ n(
     Ee,
     {
       componentName: "Employee.Management.Compensation",
-      LoaderComponent: o,
-      children: /* @__PURE__ */ n(Se, { LoaderComponent: o, ...r })
+      LoaderComponent: a,
+      children: /* @__PURE__ */ n(ve, { LoaderComponent: a, ...r })
     }
   );
 }
-function Se({ employeeId: o, onEvent: r, LoaderComponent: c }) {
+function ve({ employeeId: a, onEvent: r, LoaderComponent: c }) {
   Ae("Employee.Management.Compensation");
-  const { t: E } = j("Employee.Management.Compensation"), t = Y(), i = Pe({ employeeId: o });
-  return i.isLoading ? /* @__PURE__ */ n(G, { error: i.errorHandling.errors, LoaderComponent: c, children: /* @__PURE__ */ n(t.Box, { header: /* @__PURE__ */ n(t.BoxHeader, { title: E("card.title") }), children: /* @__PURE__ */ n(Ce, {}) }) }) : /* @__PURE__ */ n(
-    Ue,
+  const { t: D } = j("Employee.Management.Compensation"), t = G(), i = Pe({ employeeId: a });
+  return i.isLoading ? /* @__PURE__ */ n(V, { error: i.errorHandling.errors, LoaderComponent: c, children: /* @__PURE__ */ n(t.Box, { header: /* @__PURE__ */ n(t.BoxHeader, { title: D("card.title") }), children: /* @__PURE__ */ n(Ce, {}) }) }) : /* @__PURE__ */ n(
+    we,
     {
-      employeeId: o,
+      employeeId: a,
       onEvent: r,
       compensation: i,
       LoaderComponent: c
     }
   );
 }
-function Ue({
-  employeeId: o,
+function we({
+  employeeId: a,
   onEvent: r,
   compensation: c,
-  LoaderComponent: E
+  LoaderComponent: D
 }) {
-  const { t } = j("Employee.Management.Compensation"), i = Y(), T = De(), { jobs: p, primaryFlsaStatus: V, pendingChanges: M, hasMultipleJobs: m, employeeFirstName: y } = c.data, { cancellingCompensationUuid: v } = c.status, S = ue(
+  const { t } = j("Employee.Management.Compensation"), i = G(), M = ye(), { jobs: p, primaryFlsaStatus: Y, pendingChanges: S, hasMultipleJobs: m, employeeFirstName: y } = c.data, { cancellingCompensationUuid: v } = c.status, w = ue(
     async (e) => {
       await c.actions.cancelPendingChange(e) && r(C.EMPLOYEE_MANAGEMENT_COMPENSATION_CARD_CHANGE_CANCELLED, {
-        employeeId: o,
+        employeeId: a,
         compensationId: e.compensationUuid
       });
     },
-    [c, r, o]
-  ), [g, D] = x(null), { mutateAsync: W, isPending: U } = pe(), Q = async () => {
+    [c, r, a]
+  ), [g, A] = x(null), { mutateAsync: W, isPending: _ } = pe(), Q = async () => {
     if (!g) return;
     const e = g.uuid;
     await W({ request: { jobId: e } }), r(C.EMPLOYEE_MANAGEMENT_COMPENSATION_CARD_JOB_DELETED, {
-      employeeId: o,
+      employeeId: a,
       jobId: e
-    }), D(null);
-  }, a = p.length === 1 ? p[0] : void 0, z = ye(/* @__PURE__ */ new Date()) ?? "", X = p.find((e) => e.primary)?.compensations?.some(
+    }), A(null);
+  }, o = p.length === 1 ? p[0] : void 0, z = De(/* @__PURE__ */ new Date()) ?? "", X = p.find((e) => e.primary)?.compensations?.some(
     (e) => e.effectiveDate !== void 0 && e.effectiveDate > z && e.flsaStatus !== H.NONEXEMPT
-  ) ?? !1, q = p.length >= 1 && V === H.NONEXEMPT && !X, w = a ? F(a.rate) : null, _ = a?.compensations?.find(
-    (e) => e.uuid === a.currentCompensationUuid
-  ), h = /* @__PURE__ */ n("span", { "aria-label": t("card.listEmptyPlaceholder"), children: "–" }), $ = a?.paymentUnit ? a.paymentUnit === "Hour" ? t("card.types.hourly") : a.paymentUnit === "Salary" || a.paymentUnit === "Year" ? t("card.types.salary") : a.paymentUnit : null, [K, A] = x(!1), Z = ge(y), ee = M.filter((e) => e.isNewJob), d = M.filter((e) => !e.isNewJob);
+  ) ?? !1, $ = p.length >= 1 && Y === H.NONEXEMPT && !X, L = o ? F(o.rate) : null, h = o?.compensations?.find(
+    (e) => e.uuid === o.currentCompensationUuid
+  ), b = /* @__PURE__ */ n("span", { "aria-label": t("card.listEmptyPlaceholder"), children: "–" }), q = h?.flsaStatus ? t(`flsaStatusLabels.${h.flsaStatus}`) : null, [K, N] = x(!1), Z = ge(y), ee = S.filter((e) => e.isNewJob), d = S.filter((e) => !e.isNewJob);
   me(() => {
-    d.length === 0 && A(!1);
+    d.length === 0 && N(!1);
   }, [d.length]);
-  const N = new Set(ee.map((e) => e.jobUuid)), te = a ? N.has(a.uuid) : !1, ne = N.size > 0, L = new Set(d.map((e) => e.jobUuid)), ie = a ? L.has(a.uuid) : !1, O = d.length > 0, R = m && d.length > 1, ae = O && !R, u = d[0], B = (e) => {
+  const J = new Set(ee.map((e) => e.jobUuid)), te = o ? J.has(o.uuid) : !1, ne = J.size > 0, U = new Set(d.map((e) => e.jobUuid)), ie = o ? U.has(o.uuid) : !1, O = d.length > 0, R = m && d.length > 1, ae = O && !R, u = d[0], B = (e) => {
     r(C.EMPLOYEE_MANAGEMENT_COMPENSATION_CARD_EDIT_REQUESTED, {
-      employeeId: o,
+      employeeId: a,
       jobId: e.uuid
     });
   }, oe = () => {
-    r(C.EMPLOYEE_MANAGEMENT_COMPENSATION_CARD_ADD_REQUESTED, { employeeId: o });
+    r(C.EMPLOYEE_MANAGEMENT_COMPENSATION_CARD_ADD_REQUESTED, { employeeId: a });
   }, re = () => {
     r(C.EMPLOYEE_MANAGEMENT_COMPENSATION_CARD_ADD_ANOTHER_REQUESTED, {
-      employeeId: o
+      employeeId: a
     });
   }, se = [
     {
       key: "jobTitle",
       title: t("card.columns.jobTitle"),
       render: (e) => {
-        const s = e.compensations?.find((J) => J.uuid === e.currentCompensationUuid), l = F(e.rate);
+        const s = e.compensations?.find((P) => P.uuid === e.currentCompensationUuid), l = F(e.rate);
         return /* @__PURE__ */ f(de, { children: [
           s?.title || "-",
-          l !== null && e.paymentUnit ? /* @__PURE__ */ n(i.Text, { variant: "supporting", size: "sm", children: T(l, e.paymentUnit) }) : null
+          l !== null && e.paymentUnit ? /* @__PURE__ */ n(i.Text, { variant: "supporting", size: "sm", children: M(l, e.paymentUnit) }) : null
         ] });
       }
     },
@@ -117,14 +117,14 @@ function Ue({
       title: t("card.columns.effectiveDate"),
       render: (e) => {
         const s = e.compensations?.find((l) => l.uuid === e.currentCompensationUuid);
-        return s?.effectiveDate ? b(s.effectiveDate) : "-";
+        return s?.effectiveDate ? E(s.effectiveDate) : "-";
       }
     },
     ...ne ? [
       {
         key: "status",
         title: /* @__PURE__ */ n(Te, { children: t("card.columns.status") }),
-        render: (e) => N.has(e.uuid) ? /* @__PURE__ */ n(i.Badge, { status: "warning", children: t("card.pendingStatus") }) : null
+        render: (e) => J.has(e.uuid) ? /* @__PURE__ */ n(i.Badge, { status: "warning", children: t("card.pendingStatus") }) : null
       }
     ] : []
   ], le = Me({
@@ -132,7 +132,7 @@ function Ue({
     columns: se,
     itemMenu: (e) => {
       const l = [
-        ...L.has(e.uuid) ? [] : [
+        ...U.has(e.uuid) ? [] : [
           {
             label: t("card.editJobCta"),
             icon: /* @__PURE__ */ n(Je, { "aria-hidden": !0 }),
@@ -146,10 +146,10 @@ function Ue({
             label: t("card.deleteJobCta"),
             icon: /* @__PURE__ */ n(Ne, { "aria-hidden": !0 }),
             onClick: () => {
-              const J = e.compensations?.find(
+              const P = e.compensations?.find(
                 (ce) => ce.uuid === e.currentCompensationUuid
               );
-              D({ uuid: e.uuid, title: J?.title ?? "" });
+              A({ uuid: e.uuid, title: P?.title ?? "" });
             }
           }
         ]
@@ -158,13 +158,13 @@ function Ue({
         be,
         {
           triggerLabel: t("card.hamburgerTitle"),
-          isLoading: U,
+          isLoading: _,
           items: l
         }
       );
     }
   });
-  return /* @__PURE__ */ f(G, { error: c.errorHandling.errors, LoaderComponent: E, children: [
+  return /* @__PURE__ */ f(V, { error: c.errorHandling.errors, LoaderComponent: D, children: [
     /* @__PURE__ */ n(
       i.Box,
       {
@@ -173,12 +173,12 @@ function Ue({
           i.BoxHeader,
           {
             title: t("card.title"),
-            action: m ? null : a ? ie ? null : /* @__PURE__ */ n(
+            action: m ? null : o ? ie ? null : /* @__PURE__ */ n(
               i.Button,
               {
                 variant: "secondary",
                 onClick: () => {
-                  B(a);
+                  B(o);
                 },
                 children: t("card.editCta")
               }
@@ -193,7 +193,7 @@ function Ue({
             )
           }
         ),
-        footer: q ? /* @__PURE__ */ n(
+        footer: $ ? /* @__PURE__ */ n(
           i.Button,
           {
             variant: "secondary",
@@ -202,12 +202,12 @@ function Ue({
             children: t("card.addAnotherJobCta")
           }
         ) : void 0,
-        children: /* @__PURE__ */ f(P, { flexDirection: "column", gap: 16, children: [
+        children: /* @__PURE__ */ f(T, { flexDirection: "column", gap: 16, children: [
           O && /* @__PURE__ */ n(
             "div",
             {
               className: [k.alertWrapper, m && k.alertWrapperPadded].filter(Boolean).join(" "),
-              children: /* @__PURE__ */ f(P, { flexDirection: "column", gap: 16, children: [
+              children: /* @__PURE__ */ f(T, { flexDirection: "column", gap: 16, children: [
                 ae && u && /* @__PURE__ */ n(
                   i.Alert,
                   {
@@ -215,11 +215,11 @@ function Ue({
                     disableScrollIntoView: !0,
                     label: m ? t("card.pendingChange.alertLabelWithJob", {
                       jobTitle: u.jobTitle,
-                      date: b(u.effectiveDate)
+                      date: E(u.effectiveDate)
                     }) : t("card.pendingChange.alertLabel", {
-                      date: b(u.effectiveDate)
+                      date: E(u.effectiveDate)
                     }),
-                    children: /* @__PURE__ */ f(P, { flexDirection: "column", gap: 12, children: [
+                    children: /* @__PURE__ */ f(T, { flexDirection: "column", gap: 12, children: [
                       /* @__PURE__ */ n(
                         i.UnorderedList,
                         {
@@ -232,7 +232,7 @@ function Ue({
                           variant: "secondary",
                           isLoading: v === u.compensationUuid,
                           onClick: () => {
-                            S(u);
+                            w(u);
                           },
                           children: t("card.pendingChange.cancelCta")
                         }
@@ -253,7 +253,7 @@ function Ue({
                       {
                         variant: "secondary",
                         onClick: () => {
-                          A(!0);
+                          N(!0);
                         },
                         children: t("card.pendingChange.reviewCta")
                       }
@@ -263,25 +263,25 @@ function Ue({
               ] })
             }
           ),
-          m ? /* @__PURE__ */ n(ve, { label: t("card.tableLabel"), isWithinBox: !0, ...le }) : a ? /* @__PURE__ */ n(
+          m ? /* @__PURE__ */ n(Se, { label: t("card.tableLabel"), isWithinBox: !0, ...le }) : o ? /* @__PURE__ */ n(
             i.DescriptionList,
             {
               items: [
                 {
                   term: t("card.jobTitle"),
-                  description: a.title || h
+                  description: o.title || b
                 },
                 {
                   term: t("card.type"),
-                  description: $ || h
+                  description: q || b
                 },
                 {
                   term: t("card.wage"),
-                  description: w !== null && a.paymentUnit ? T(w, a.paymentUnit) : h
+                  description: L !== null && o.paymentUnit ? M(L, o.paymentUnit) : b
                 },
                 {
                   term: t("card.effectiveDate"),
-                  description: _?.effectiveDate ? b(_.effectiveDate) : h
+                  description: h?.effectiveDate ? E(h.effectiveDate) : b
                 },
                 ...te ? [
                   {
@@ -309,10 +309,10 @@ function Ue({
         employeeFirstName: y,
         cancellingCompensationUuid: v,
         onClose: () => {
-          A(!1);
+          N(!1);
         },
         onCancelChange: (e) => {
-          S(e);
+          w(e);
         }
       }
     ),
@@ -321,12 +321,12 @@ function Ue({
       {
         isOpen: g !== null,
         onClose: () => {
-          D(null);
+          A(null);
         },
         onPrimaryActionClick: () => {
           Q();
         },
-        isPrimaryActionLoading: U,
+        isPrimaryActionLoading: _,
         isDestructive: !0,
         title: t("card.deleteJobDialog.title"),
         primaryActionLabel: t("card.deleteJobDialog.confirmCta"),