@gusto/embedded-react-sdk 0.50.0 → 0.51.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 { 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-v-2025-11-15/models/components/contractor'\nimport type { ContractorCreateRequestBody } from '@gusto/embedded-api-v-2025-11-15/models/components/contractorcreaterequestbody'\nimport type { ContractorUpdateRequestBody } from '@gusto/embedded-api-v-2025-11-15/models/components/contractorupdaterequestbody'\nimport { useContractorsGet } from '@gusto/embedded-api-v-2025-11-15/react-query/contractorsGet'\nimport { useContractorsCreateMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/contractorsCreate'\nimport { useContractorsUpdateMutation } from '@gusto/embedded-api-v-2025-11-15/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 { useDeriveFieldsMetadata } from '@/partner-hook-utils/form/useDeriveFieldsMetadata'\nimport { useHookFormInternals } from '@/partner-hook-utils/form/useHookFormInternals'\nimport { createGetFormSubmissionValues } from '@/partner-hook-utils/form/getFormSubmissionValues'\nimport { withOptions } from '@/partner-hook-utils/form/withOptions'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type {\n  BaseFormHookReady,\n  FieldsMetadata,\n  HookLoadingResult,\n  HookSubmitResult,\n} from '@/partner-hook-utils/types'\nimport {\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  /** 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 ContractorDetailsFields {\n  /** Radio group bound to `type`. Always available. */\n  Type: typeof TypeField\n  /** Radio group bound to `wageType`. Always available. */\n  WageType: typeof WageTypeField\n  /** Date picker bound to `startDate`. Always available. */\n  StartDate: typeof StartDateField\n  /** Number input bound to `hourlyRate`; available only when `wageType` is `Hourly`. */\n  HourlyRate: typeof HourlyRateField | undefined\n  /** Switch bound to `selfOnboarding`; available only when toggleable. */\n  SelfOnboarding: typeof SelfOnboardingField | undefined\n  /** Switch bound to `fileNewHireReport`; available only for individual contractors. */\n  FileNewHireReport: typeof FileNewHireReportField | undefined\n  /** Text input bound to `email`; available only when self-onboarding is enabled. */\n  Email: typeof EmailField | undefined\n  /** Text input bound to `firstName`; available only for individual contractors. */\n  FirstName: typeof FirstNameField | undefined\n  /** Text input bound to `lastName`; available only for individual contractors. */\n  LastName: typeof LastNameField | undefined\n  /** Text input bound to `middleInitial`; available only for individual contractors. */\n  MiddleInitial: typeof MiddleInitialField | undefined\n  /** Text input bound to `businessName`; available only for business contractors. */\n  BusinessName: typeof BusinessNameField | undefined\n  /** Text input bound to `ssn`; available only for individual contractors. */\n  Ssn: typeof SsnField | undefined\n  /** Text input bound to `ein`; available only for business contractors. */\n  Ein: typeof EinField | undefined\n  /** Select bound to `workState`; available only for individual contractors filing a new-hire report. */\n  WorkState: typeof WorkStateField | 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  FieldsMetadata,\n  ContractorDetailsFormData,\n  ContractorDetailsFields\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/**\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 only toggles the\n * `Email` field); 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  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?.contractor\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\n  const typeEntries = [ContractorType.Individual, ContractorType.Business]\n  const wageTypeEntries = [WageType.Hourly, WageType.Fixed]\n  const fieldsMetadata = {\n    ...baseMetadata,\n    type: withOptions(\n      baseMetadata.type,\n      typeEntries.map(value => ({ value, label: value })),\n      typeEntries,\n    ),\n    wageType: withOptions(\n      baseMetadata.wageType,\n      wageTypeEntries.map(value => ({ value, label: value })),\n      wageTypeEntries,\n    ),\n    workState: withOptions(\n      baseMetadata.workState,\n      STATES_ABBR.map(abbr => ({ value: abbr, label: abbr })),\n      STATES_ABBR,\n    ),\n  }\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: 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: 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 =\n  UseContractorDetailsFormReady['form']['fieldsMetadata']\n\n/**\n * Shape of `form.Fields` returned by {@link useContractorDetailsForm}.\n *\n * @public\n */\nexport type ContractorDetailsFormFields = UseContractorDetailsFormReady['form']['Fields']\n"],"names":["isCurrentlySelfOnboarding","contractor","ContractorSelfOnboardingStatuses","canToggleSelfOnboarding","ContractorOnboardingStatus","useContractorDetailsForm","companyId","contractorId","withSelfOnboardingField","optionalFieldsToRequire","partnerDefaults","validationMode","shouldFocusError","contractorQuery","useContractorsGet","isCreateMode","isSelfOnboardingToggleable","mode","hasSsn","hasEin","schema","metadataConfig","useMemo","createContractorDetailsSchema","parsedHourlyRate","resolvedDefaults","ContractorType","WageType","formMethods","useForm","zodResolver","watchedType","watchedWageType","watchedSelfOnboarding","watchedFileNewHireReport","useWatch","isIndividual","isBusiness","isHourly","createContractorMutation","useContractorsCreateMutation","updateContractorMutation","useContractorsUpdateMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","baseMetadata","useDeriveFieldsMetadata","typeEntries","wageTypeEntries","fieldsMetadata","withOptions","value","STATES_ABBR","abbr","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-v-2026-02-01/models/components/contractor'\nimport type { ContractorCreateRequestBody } from '@gusto/embedded-api-v-2026-02-01/models/components/contractorcreaterequestbody'\nimport type { ContractorUpdateRequestBody } from '@gusto/embedded-api-v-2026-02-01/models/components/contractorupdaterequestbody'\nimport { useContractorsGet } from '@gusto/embedded-api-v-2026-02-01/react-query/contractorsGet'\nimport { useContractorsCreateMutation } from '@gusto/embedded-api-v-2026-02-01/react-query/contractorsCreate'\nimport { useContractorsUpdateMutation } from '@gusto/embedded-api-v-2026-02-01/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  /** 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 only toggles the\n * `Email` field); 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  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?.contractor\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: 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: 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","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/SelfOnboardingFlow/SelfOnboardingComponents.d.ts

@@ -0,0 +1,30 @@
+import { FlowContextInterface } from '../../Flow/useFlow';
+import { BaseComponentInterface } from '../../Base';
+/**
+ * Props for {@link SelfOnboardingFlow}.
+ *
+ * @public
+ */
+export interface SelfOnboardingFlowProps extends BaseComponentInterface<never> {
+    /** The associated company identifier. */
+    companyId: string;
+    /** The associated contractor identifier. */
+    contractorId: string;
+}
+/** @internal */
+export interface SelfOnboardingContextInterface extends FlowContextInterface {
+    companyId: string;
+    contractorId: string;
+}
+/** @internal */
+export declare function Landing(): import("react").JSX.Element;
+/** @internal */
+export declare function Profile(): import("react").JSX.Element;
+/** @internal */
+export declare function Address(): import("react").JSX.Element;
+/** @internal */
+export declare function PaymentMethod(): import("react").JSX.Element;
+/** @internal */
+export declare function DocumentSigner(): import("react").JSX.Element;
+/** @internal */
+export declare function OnboardingSummary(): import("react").JSX.Element;

package/dist/components/Contractor/SelfOnboardingFlow/SelfOnboardingComponents.js

@@ -0,0 +1,57 @@
+import { jsx as t } from "react/jsx-runtime";
+import { ensureRequired as r } from "../../../helpers/ensureRequired.js";
+import { useFlow as c } from "../../Flow/useFlow.js";
+import { PaymentMethod as a } from "../PaymentMethod/PaymentMethod.js";
+import { Landing as m } from "../Landing/Landing.js";
+import { OnboardingSummary as d } from "../OnboardingSummary/OnboardingSummary.js";
+import { DocumentSigner as i } from "../Documents/DocumentSigner/DocumentSigner.js";
+import { Address as s } from "../Address/Address.js";
+import { ContractorProfile as u } from "../Profile/ContractorProfile.js";
+function $() {
+  const { companyId: o, contractorId: n, onEvent: e } = c();
+  return /* @__PURE__ */ t(
+    m,
+    {
+      companyId: r(o),
+      contractorId: r(n),
+      onEvent: e
+    }
+  );
+}
+function l() {
+  const { companyId: o, contractorId: n, onEvent: e } = c();
+  return /* @__PURE__ */ t(
+    u,
+    {
+      companyId: r(o),
+      contractorId: r(n),
+      onEvent: e,
+      isAdmin: !1
+    }
+  );
+}
+function A() {
+  const { contractorId: o, onEvent: n } = c();
+  return /* @__PURE__ */ t(s, { contractorId: r(o), onEvent: n });
+}
+function b() {
+  const { contractorId: o, onEvent: n } = c();
+  return /* @__PURE__ */ t(a, { contractorId: r(o), onEvent: n });
+}
+function h() {
+  const { contractorId: o, onEvent: n } = c();
+  return /* @__PURE__ */ t(i, { contractorId: r(o), onEvent: n });
+}
+function D() {
+  const { contractorId: o, onEvent: n } = c();
+  return /* @__PURE__ */ t(d, { contractorId: r(o), onEvent: n });
+}
+export {
+  A as Address,
+  h as DocumentSigner,
+  $ as Landing,
+  D as OnboardingSummary,
+  b as PaymentMethod,
+  l as Profile
+};
+//# sourceMappingURL=SelfOnboardingComponents.js.map

package/dist/components/Contractor/SelfOnboardingFlow/SelfOnboardingComponents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelfOnboardingComponents.js","sources":["../../../../src/components/Contractor/SelfOnboardingFlow/SelfOnboardingComponents.tsx"],"sourcesContent":["import { ensureRequired } from '@/helpers/ensureRequired'\nimport type { FlowContextInterface } from '@/components/Flow/useFlow'\nimport { useFlow } from '@/components/Flow/useFlow'\nimport type { BaseComponentInterface } from '@/components/Base'\nimport { Landing as LandingComponent } from '@/components/Contractor/Landing'\nimport { ContractorProfile as ProfileComponent } from '@/components/Contractor/Profile'\nimport { Address as AddressComponent } from '@/components/Contractor/Address'\nimport { PaymentMethod as PaymentMethodComponent } from '@/components/Contractor/PaymentMethod/PaymentMethod'\nimport { DocumentSigner as DocumentSignerComponent } from '@/components/Contractor/Documents/DocumentSigner'\nimport { OnboardingSummary as OnboardingSummaryComponent } from '@/components/Contractor/OnboardingSummary'\n\n/**\n * Props for {@link SelfOnboardingFlow}.\n *\n * @public\n */\nexport interface SelfOnboardingFlowProps extends BaseComponentInterface<never> {\n  /** The associated company identifier. */\n  companyId: string\n  /** The associated contractor identifier. */\n  contractorId: string\n}\n\n/** @internal */\nexport interface SelfOnboardingContextInterface extends FlowContextInterface {\n  companyId: string\n  contractorId: string\n}\n\n/** @internal */\nexport function Landing() {\n  const { companyId, contractorId, onEvent } = useFlow<SelfOnboardingContextInterface>()\n  return (\n    <LandingComponent\n      companyId={ensureRequired(companyId)}\n      contractorId={ensureRequired(contractorId)}\n      onEvent={onEvent}\n    />\n  )\n}\n\n/** @internal */\nexport function Profile() {\n  const { companyId, contractorId, onEvent } = useFlow<SelfOnboardingContextInterface>()\n  return (\n    <ProfileComponent\n      companyId={ensureRequired(companyId)}\n      contractorId={ensureRequired(contractorId)}\n      onEvent={onEvent}\n      isAdmin={false}\n    />\n  )\n}\n\n/** @internal */\nexport function Address() {\n  const { contractorId, onEvent } = useFlow<SelfOnboardingContextInterface>()\n  return <AddressComponent contractorId={ensureRequired(contractorId)} onEvent={onEvent} />\n}\n\n/** @internal */\nexport function PaymentMethod() {\n  const { contractorId, onEvent } = useFlow<SelfOnboardingContextInterface>()\n  return <PaymentMethodComponent contractorId={ensureRequired(contractorId)} onEvent={onEvent} />\n}\n\n/** @internal */\nexport function DocumentSigner() {\n  const { contractorId, onEvent } = useFlow<SelfOnboardingContextInterface>()\n  return <DocumentSignerComponent contractorId={ensureRequired(contractorId)} onEvent={onEvent} />\n}\n\n/** @internal */\nexport function OnboardingSummary() {\n  const { contractorId, onEvent } = useFlow<SelfOnboardingContextInterface>()\n  return (\n    <OnboardingSummaryComponent contractorId={ensureRequired(contractorId)} onEvent={onEvent} />\n  )\n}\n"],"names":["Landing","companyId","contractorId","onEvent","useFlow","jsx","LandingComponent","ensureRequired","Profile","ProfileComponent","Address","AddressComponent","PaymentMethod","PaymentMethodComponent","DocumentSigner","DocumentSignerComponent","OnboardingSummary","OnboardingSummaryComponent"],"mappings":";;;;;;;;;AA8BO,SAASA,IAAU;AACxB,QAAM,EAAE,WAAAC,GAAW,cAAAC,GAAc,SAAAC,EAAA,IAAYC,EAAA;AAC7C,SACE,gBAAAC;AAAA,IAACC;AAAAA,IAAA;AAAA,MACC,WAAWC,EAAeN,CAAS;AAAA,MACnC,cAAcM,EAAeL,CAAY;AAAA,MACzC,SAAAC;AAAA,IAAA;AAAA,EAAA;AAGN;AAGO,SAASK,IAAU;AACxB,QAAM,EAAE,WAAAP,GAAW,cAAAC,GAAc,SAAAC,EAAA,IAAYC,EAAA;AAC7C,SACE,gBAAAC;AAAA,IAACI;AAAAA,IAAA;AAAA,MACC,WAAWF,EAAeN,CAAS;AAAA,MACnC,cAAcM,EAAeL,CAAY;AAAA,MACzC,SAAAC;AAAA,MACA,SAAS;AAAA,IAAA;AAAA,EAAA;AAGf;AAGO,SAASO,IAAU;AACxB,QAAM,EAAE,cAAAR,GAAc,SAAAC,EAAA,IAAYC,EAAA;AAClC,2BAAQO,GAAA,EAAiB,cAAcJ,EAAeL,CAAY,GAAG,SAAAC,GAAkB;AACzF;AAGO,SAASS,IAAgB;AAC9B,QAAM,EAAE,cAAAV,GAAc,SAAAC,EAAA,IAAYC,EAAA;AAClC,2BAAQS,GAAA,EAAuB,cAAcN,EAAeL,CAAY,GAAG,SAAAC,GAAkB;AAC/F;AAGO,SAASW,IAAiB;AAC/B,QAAM,EAAE,cAAAZ,GAAc,SAAAC,EAAA,IAAYC,EAAA;AAClC,2BAAQW,GAAA,EAAwB,cAAcR,EAAeL,CAAY,GAAG,SAAAC,GAAkB;AAChG;AAGO,SAASa,IAAoB;AAClC,QAAM,EAAE,cAAAd,GAAc,SAAAC,EAAA,IAAYC,EAAA;AAClC,2BACGa,GAAA,EAA2B,cAAcV,EAAeL,CAAY,GAAG,SAAAC,GAAkB;AAE9F;"}

package/dist/components/Contractor/SelfOnboardingFlow/SelfOnboardingFlow.d.ts

@@ -0,0 +1,45 @@
+import { SelfOnboardingFlowProps } from './SelfOnboardingComponents';
+export type { SelfOnboardingFlowProps } from './SelfOnboardingComponents';
+/**
+ * Guided flow for contractors to complete their own onboarding.
+ *
+ * @remarks
+ * Hands the contractor responsibility for submitting their own profile, address, payment, and document-signing information. Drives a multi-step flow keyed to the contractor being self-onboarded, starting from the self-onboarding landing page and ending on a confirmation summary.
+ *
+ * Each step is also exported as a standalone block (see the Blocks table) for composing a custom workflow when this orchestration is the wrong fit.
+ *
+ * The flow forwards every event emitted by its blocks to `onEvent`; see the events table on each block for the full set of events and payloads observable from this flow.
+ *
+ * @components
+ * - {@link Landing}
+ * - {@link ContractorProfile}
+ * - {@link Address}
+ * - {@link PaymentMethod}
+ * - {@link DocumentSigner}
+ * - {@link OnboardingSummary}
+ *
+ * @param props - See {@link SelfOnboardingFlowProps}.
+ * @returns The multi-step self-onboarding flow.
+ * @public
+ * @group Flow components
+ *
+ * @example
+ * ```tsx title="App.tsx"
+ * import { ContractorOnboarding, type EventType } from '@gusto/embedded-react-sdk'
+ *
+ * function MyApp() {
+ *   return (
+ *     <ContractorOnboarding.SelfOnboardingFlow
+ *       companyId="a007e1ab-3595-43c2-ab4b-af7a5af2e365"
+ *       contractorId="4b3f930f-82cd-48a8-b797-798686e12e5e"
+ *       onEvent={(eventType: EventType) => {
+ *         if (eventType === 'contractor/selfOnboarding/done') {
+ *           // Onboarding complete — navigate to your next screen
+ *         }
+ *       }}
+ *     />
+ *   )
+ * }
+ * ```
+ */
+export declare const SelfOnboardingFlow: ({ companyId, contractorId, onEvent, }: SelfOnboardingFlowProps) => import("react").JSX.Element;

package/dist/components/Contractor/SelfOnboardingFlow/SelfOnboardingFlow.js

@@ -0,0 +1,30 @@
+import { jsx as i } from "react/jsx-runtime";
+import { createMachine as t } from "robot3";
+import { useMemo as f } from "react";
+import { Landing as p } from "./SelfOnboardingComponents.js";
+import { contractorSelfOnboardingMachine as a } from "./selfOnboardingMachine.js";
+import { Flow as c } from "../../Flow/Flow.js";
+const b = ({
+  companyId: o,
+  contractorId: r,
+  onEvent: m
+}) => {
+  const n = f(
+    () => t(
+      "index",
+      a,
+      (e) => ({
+        ...e,
+        component: p,
+        companyId: o,
+        contractorId: r
+      })
+    ),
+    [o, r]
+  );
+  return /* @__PURE__ */ i(c, { machine: n, onEvent: m });
+};
+export {
+  b as SelfOnboardingFlow
+};
+//# sourceMappingURL=SelfOnboardingFlow.js.map

package/dist/components/Contractor/SelfOnboardingFlow/SelfOnboardingFlow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelfOnboardingFlow.js","sources":["../../../../src/components/Contractor/SelfOnboardingFlow/SelfOnboardingFlow.tsx"],"sourcesContent":["import { createMachine } from 'robot3'\nimport { useMemo } from 'react'\nimport type {\n  SelfOnboardingContextInterface,\n  SelfOnboardingFlowProps,\n} from './SelfOnboardingComponents'\nimport { Landing } from './SelfOnboardingComponents'\nimport { contractorSelfOnboardingMachine } from './selfOnboardingMachine'\nimport { Flow } from '@/components/Flow/Flow'\n\nexport type { SelfOnboardingFlowProps } from './SelfOnboardingComponents'\n\n/**\n * Guided flow for contractors to complete their own onboarding.\n *\n * @remarks\n * Hands the contractor responsibility for submitting their own profile, address, payment, and document-signing information. Drives a multi-step flow keyed to the contractor being self-onboarded, starting from the self-onboarding landing page and ending on a confirmation summary.\n *\n * Each step is also exported as a standalone block (see the Blocks table) for composing a custom workflow when this orchestration is the wrong fit.\n *\n * The flow forwards every event emitted by its blocks to `onEvent`; see the events table on each block for the full set of events and payloads observable from this flow.\n *\n * @components\n * - {@link Landing}\n * - {@link ContractorProfile}\n * - {@link Address}\n * - {@link PaymentMethod}\n * - {@link DocumentSigner}\n * - {@link OnboardingSummary}\n *\n * @param props - See {@link SelfOnboardingFlowProps}.\n * @returns The multi-step self-onboarding flow.\n * @public\n * @group Flow components\n *\n * @example\n * ```tsx title=\"App.tsx\"\n * import { ContractorOnboarding, type EventType } from '@gusto/embedded-react-sdk'\n *\n * function MyApp() {\n *   return (\n *     <ContractorOnboarding.SelfOnboardingFlow\n *       companyId=\"a007e1ab-3595-43c2-ab4b-af7a5af2e365\"\n *       contractorId=\"4b3f930f-82cd-48a8-b797-798686e12e5e\"\n *       onEvent={(eventType: EventType) => {\n *         if (eventType === 'contractor/selfOnboarding/done') {\n *           // Onboarding complete — navigate to your next screen\n *         }\n *       }}\n *     />\n *   )\n * }\n * ```\n */\nexport const SelfOnboardingFlow = ({\n  companyId,\n  contractorId,\n  onEvent,\n}: SelfOnboardingFlowProps) => {\n  const machine = useMemo(\n    () =>\n      createMachine(\n        'index',\n        contractorSelfOnboardingMachine,\n        (initialContext: SelfOnboardingContextInterface) => ({\n          ...initialContext,\n          component: Landing,\n          companyId,\n          contractorId,\n        }),\n      ),\n    [companyId, contractorId],\n  )\n  return <Flow machine={machine} onEvent={onEvent} />\n}\n"],"names":["SelfOnboardingFlow","companyId","contractorId","onEvent","machine","useMemo","createMachine","contractorSelfOnboardingMachine","initialContext","Landing","jsx","Flow"],"mappings":";;;;;;AAsDO,MAAMA,IAAqB,CAAC;AAAA,EACjC,WAAAC;AAAA,EACA,cAAAC;AAAA,EACA,SAAAC;AACF,MAA+B;AAC7B,QAAMC,IAAUC;AAAA,IACd,MACEC;AAAA,MACE;AAAA,MACAC;AAAA,MACA,CAACC,OAAoD;AAAA,QACnD,GAAGA;AAAA,QACH,WAAWC;AAAA,QACX,WAAAR;AAAA,QACA,cAAAC;AAAA,MAAA;AAAA,IACF;AAAA,IAEJ,CAACD,GAAWC,CAAY;AAAA,EAAA;AAE1B,SAAO,gBAAAQ,EAACC,GAAA,EAAK,SAAAP,GAAkB,SAAAD,EAAA,CAAkB;AACnD;"}

package/dist/components/Contractor/SelfOnboardingFlow/selfOnboardingMachine.d.ts

@@ -0,0 +1,8 @@
+/** @internal */
+export declare const contractorSelfOnboardingMachine: {
+    index: import('robot3').MachineState<any>;
+    contractorProfile: import('robot3').MachineState<any>;
+    contractorAddress: import('robot3').MachineState<any>;
+    contractorPaymentMethod: import('robot3').MachineState<any>;
+    contractorDocumentSigner: import('robot3').MachineState<any>;
+};

package/dist/components/Contractor/SelfOnboardingFlow/selfOnboardingMachine.js

@@ -0,0 +1,59 @@
+import { state as t, transition as n, reduce as r } from "robot3";
+import { OnboardingSummary as c, DocumentSigner as O, PaymentMethod as m, Address as a, Profile as i } from "./SelfOnboardingComponents.js";
+import { componentEvents as e } from "../../../shared/constants.js";
+const N = {
+  index: t(
+    n(
+      e.CONTRACTOR_SELF_ONBOARDING_START,
+      "contractorProfile",
+      r((o) => ({
+        ...o,
+        component: i
+      }))
+    )
+  ),
+  contractorProfile: t(
+    n(
+      e.CONTRACTOR_PROFILE_DONE,
+      "contractorAddress",
+      r((o) => ({
+        ...o,
+        component: a
+      }))
+    )
+  ),
+  contractorAddress: t(
+    n(
+      e.CONTRACTOR_ADDRESS_DONE,
+      "contractorPaymentMethod",
+      r((o) => ({
+        ...o,
+        component: m
+      }))
+    )
+  ),
+  contractorPaymentMethod: t(
+    n(
+      e.CONTRACTOR_PAYMENT_METHOD_DONE,
+      "contractorDocumentSigner",
+      r((o) => ({
+        ...o,
+        component: O
+      }))
+    )
+  ),
+  contractorDocumentSigner: t(
+    n(
+      e.CONTRACTOR_DOCUMENTS_DONE,
+      "index",
+      r((o) => ({
+        ...o,
+        component: c
+      }))
+    )
+  )
+};
+export {
+  N as contractorSelfOnboardingMachine
+};
+//# sourceMappingURL=selfOnboardingMachine.js.map

package/dist/components/Contractor/SelfOnboardingFlow/selfOnboardingMachine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selfOnboardingMachine.js","sources":["../../../../src/components/Contractor/SelfOnboardingFlow/selfOnboardingMachine.ts"],"sourcesContent":["import { transition, reduce, state } from 'robot3'\nimport type { SelfOnboardingContextInterface } from './SelfOnboardingComponents'\nimport {\n  Profile,\n  Address,\n  PaymentMethod,\n  DocumentSigner,\n  OnboardingSummary,\n} from './SelfOnboardingComponents'\nimport { componentEvents } from '@/shared/constants'\nimport type { MachineTransition } from '@/types/Helpers'\n\n/** @internal */\nexport const contractorSelfOnboardingMachine = {\n  index: state<MachineTransition>(\n    transition(\n      componentEvents.CONTRACTOR_SELF_ONBOARDING_START,\n      'contractorProfile',\n      reduce((ctx: SelfOnboardingContextInterface): SelfOnboardingContextInterface => ({\n        ...ctx,\n        component: Profile,\n      })),\n    ),\n  ),\n  contractorProfile: state<MachineTransition>(\n    transition(\n      componentEvents.CONTRACTOR_PROFILE_DONE,\n      'contractorAddress',\n      reduce((ctx: SelfOnboardingContextInterface): SelfOnboardingContextInterface => ({\n        ...ctx,\n        component: Address,\n      })),\n    ),\n  ),\n  contractorAddress: state<MachineTransition>(\n    transition(\n      componentEvents.CONTRACTOR_ADDRESS_DONE,\n      'contractorPaymentMethod',\n      reduce((ctx: SelfOnboardingContextInterface): SelfOnboardingContextInterface => ({\n        ...ctx,\n        component: PaymentMethod,\n      })),\n    ),\n  ),\n  contractorPaymentMethod: state<MachineTransition>(\n    transition(\n      componentEvents.CONTRACTOR_PAYMENT_METHOD_DONE,\n      'contractorDocumentSigner',\n      reduce((ctx: SelfOnboardingContextInterface): SelfOnboardingContextInterface => ({\n        ...ctx,\n        component: DocumentSigner,\n      })),\n    ),\n  ),\n  contractorDocumentSigner: state<MachineTransition>(\n    transition(\n      componentEvents.CONTRACTOR_DOCUMENTS_DONE,\n      'index',\n      reduce((ctx: SelfOnboardingContextInterface): SelfOnboardingContextInterface => ({\n        ...ctx,\n        component: OnboardingSummary,\n      })),\n    ),\n  ),\n}\n"],"names":["contractorSelfOnboardingMachine","state","transition","componentEvents","reduce","ctx","Profile","Address","PaymentMethod","DocumentSigner","OnboardingSummary"],"mappings":";;;AAaO,MAAMA,IAAkC;AAAA,EAC7C,OAAOC;AAAA,IACLC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC,EAAO,CAACC,OAAyE;AAAA,QAC/E,GAAGA;AAAA,QACH,WAAWC;AAAA,MAAA,EACX;AAAA,IAAA;AAAA,EACJ;AAAA,EAEF,mBAAmBL;AAAA,IACjBC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC,EAAO,CAACC,OAAyE;AAAA,QAC/E,GAAGA;AAAA,QACH,WAAWE;AAAA,MAAA,EACX;AAAA,IAAA;AAAA,EACJ;AAAA,EAEF,mBAAmBN;AAAA,IACjBC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC,EAAO,CAACC,OAAyE;AAAA,QAC/E,GAAGA;AAAA,QACH,WAAWG;AAAA,MAAA,EACX;AAAA,IAAA;AAAA,EACJ;AAAA,EAEF,yBAAyBP;AAAA,IACvBC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC,EAAO,CAACC,OAAyE;AAAA,QAC/E,GAAGA;AAAA,QACH,WAAWI;AAAA,MAAA,EACX;AAAA,IAAA;AAAA,EACJ;AAAA,EAEF,0BAA0BR;AAAA,IACxBC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC,EAAO,CAACC,OAAyE;AAAA,QAC/E,GAAGA;AAAA,QACH,WAAWK;AAAA,MAAA,EACX;AAAA,IAAA;AAAA,EACJ;AAEJ;"}

package/dist/components/Contractor/Submit/Submit.js

@@ -1,8 +1,8 @@
 import { jsx as t, jsxs as o } from "react/jsx-runtime";
 import { useTranslation as p } from "react-i18next";
-import { useContractorsUpdateOnboardingStatusMutation as v } from "@gusto/embedded-api-v-2025-11-15/react-query/contractorsUpdateOnboardingStatus";
-import { useContractorsGetOnboardingStatusSuspense as B } from "@gusto/embedded-api-v-2025-11-15/react-query/contractorsGetOnboardingStatus";
-import { useContractorsGetSuspense as E } from "@gusto/embedded-api-v-2025-11-15/react-query/contractorsGet";
+import { useContractorsUpdateOnboardingStatusMutation as v } from "@gusto/embedded-api-v-2026-02-01/react-query/contractorsUpdateOnboardingStatus";
+import { useContractorsGetOnboardingStatusSuspense as B } from "@gusto/embedded-api-v-2026-02-01/react-query/contractorsGetOnboardingStatus";
+import { useContractorsGetSuspense as E } from "@gusto/embedded-api-v-2026-02-01/react-query/contractorsGet";
 import { SubmitDone as I } from "./SubmitDone.js";
 import { Flex as m, FlexItem as U } from "../../Common/Flex/Flex.js";
 import { ActionsLayout as M } from "../../Common/ActionsLayout/ActionsLayout.js";

package/dist/components/Contractor/Submit/Submit.js.map

@@ -1 +1 @@
-{"version":3,"file":"Submit.js","sources":["../../../../src/components/Contractor/Submit/Submit.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport { useContractorsUpdateOnboardingStatusMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/contractorsUpdateOnboardingStatus'\nimport { useContractorsGetOnboardingStatusSuspense } from '@gusto/embedded-api-v-2025-11-15/react-query/contractorsGetOnboardingStatus'\nimport { useContractorsGetSuspense } from '@gusto/embedded-api-v-2025-11-15/react-query/contractorsGet'\nimport { SubmitDone } from './SubmitDone'\nimport { ActionsLayout, Flex, FlexItem } from '@/components/Common'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { useI18n, useComponentDictionary } from '@/i18n'\nimport { BaseComponent, useBase, type BaseComponentInterface } from '@/components/Base'\nimport { componentEvents, ContractorOnboardingStatus } from '@/shared/constants'\nimport { firstLastName } from '@/helpers/formattedStrings'\n\n/**\n * Props for {@link ContractorSubmit}.\n *\n * @public\n */\nexport interface ContractorSubmitProps extends BaseComponentInterface<'Contractor.Submit'> {\n  /** UUID of the contractor being submitted. */\n  contractorId: string\n  /** When true, adjusts the submission for the self-onboarding flow, surfacing the invite step before the contractor's onboarding status is finalized. */\n  selfOnboarding?: boolean\n}\n\n/**\n * Finalizes contractor onboarding by updating the onboarding status, and in the self-onboarding flow can trigger an invitation to the contractor.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `contractor/onboardingStatus/updated` | The contractor's onboarding status was successfully updated. | The updated `contractorOnboardingStatus` returned by the API. |\n * | `contractor/invite/selfOnboarding` | The invite action was triggered for a self-onboarding contractor. | `{ contractorId: string }` |\n * | `contractor/submit/done` | The submission step finished — fired after a successful status update, after an invite, or when the contractor was already onboarded. | `{ message: string }`, optionally with `onboardingStatus` when the contractor was already completed. |\n *\n * @param props - See {@link ContractorSubmitProps}.\n * @returns The rendered submission step.\n * @public\n */\nexport function ContractorSubmit(props: ContractorSubmitProps) {\n  return (\n    <BaseComponent {...props}>\n      <Root {...props}>{props.children}</Root>\n    </BaseComponent>\n  )\n}\n\nconst Root = ({ contractorId, selfOnboarding, dictionary }: ContractorSubmitProps) => {\n  useI18n('Contractor.Submit')\n  useComponentDictionary('Contractor.Submit', dictionary)\n  const { Alert, Box, BoxHeader, Button, Text, Heading, UnorderedList } = useComponentContext()\n  const { t } = useTranslation('Contractor.Submit')\n  const { onEvent, baseSubmitHandler } = useBase()\n  const items = Object.values(t('warningItems', { returnObjects: true }))\n\n  const { data } = useContractorsGetOnboardingStatusSuspense({\n    contractorUuid: contractorId,\n  })\n  const onboardingStatus = data.contractorOnboardingStatus?.onboardingStatus\n\n  const { mutateAsync } = useContractorsUpdateOnboardingStatusMutation()\n\n  const onSubmit = async () => {\n    await baseSubmitHandler(null, async () => {\n      const response = await mutateAsync({\n        request: {\n          contractorUuid: contractorId,\n          contractorOnboardingStatusUpdateRequestBody: {\n            onboardingStatus: ContractorOnboardingStatus.ONBOARDING_COMPLETED,\n          },\n        },\n      })\n      onEvent(\n        componentEvents.CONTRACTOR_ONBOARDING_STATUS_UPDATED,\n        response.contractorOnboardingStatus,\n      )\n      onEvent(componentEvents.CONTRACTOR_SUBMIT_DONE, { message: t('submitDone.successMessage') })\n    })\n  }\n  const handleInviteContractor = () => {\n    onEvent(componentEvents.CONTRACTOR_INVITE_CONTRACTOR, { contractorId })\n    onEvent(componentEvents.CONTRACTOR_SUBMIT_DONE, {\n      message: t('inviteContractor.successMessage'),\n    })\n  }\n\n  const handleSubmitDone = () => {\n    onEvent(componentEvents.CONTRACTOR_SUBMIT_DONE, {\n      onboardingStatus,\n      message: t('submitDone.successMessage'),\n    })\n  }\n\n  if (onboardingStatus === ContractorOnboardingStatus.ONBOARDING_COMPLETED) {\n    return <SubmitDone onDone={handleSubmitDone} />\n  }\n  if (\n    onboardingStatus === ContractorOnboardingStatus.SELF_ONBOARDING_NOT_INVITED &&\n    selfOnboarding\n  ) {\n    return <InviteContractor onSubmit={handleInviteContractor} contractorId={contractorId} />\n  }\n\n  return (\n    <Flex flexDirection=\"column\" gap={24}>\n      <FlexItem>\n        <Heading as=\"h2\">{t('heading')}</Heading>\n      </FlexItem>\n\n      <Box\n        header={\n          <BoxHeader\n            title={t('documentRequirements.title')}\n            description={t('documentRequirements.description')}\n          />\n        }\n      >\n        <Flex flexDirection=\"column\" gap={16}>\n          {Object.values(t('documentRequirements.items', { returnObjects: true })).map(item => (\n            <div key={item.title}>\n              <Text weight=\"medium\">{item.title}</Text>\n              <Text variant=\"supporting\">{item.description}</Text>\n            </div>\n          ))}\n          <Alert status=\"info\" label={t('documentRequirements.alertLabel')}></Alert>\n        </Flex>\n      </Box>\n      <Flex flexDirection=\"column\" gap={8}>\n        <Alert status=\"warning\" label={t('title')}>\n          <UnorderedList items={items} />\n        </Alert>\n        <ActionsLayout justifyContent=\"end\">\n          <Button title={t('submitCta')} onClick={onSubmit}>\n            {t('submitCta')}\n          </Button>\n        </ActionsLayout>\n      </Flex>\n    </Flex>\n  )\n}\n\nconst InviteContractor = ({\n  onSubmit,\n  contractorId,\n}: {\n  onSubmit: () => void\n  contractorId: string\n}) => {\n  const { t } = useTranslation('Contractor.Submit', { keyPrefix: 'inviteContractor' })\n  const { Button, Heading, Text } = useComponentContext()\n\n  const { data: contractorData } = useContractorsGetSuspense({ contractorUuid: contractorId })\n  const contractor = contractorData.contractor\n\n  return (\n    <Flex flexDirection=\"column\">\n      <Heading as=\"h2\">{t('title')}</Heading>\n      <Text>{t('description')}</Text>\n      <Flex flexDirection=\"column\">\n        <div>\n          <Text>\n            {firstLastName({\n              first_name: contractor?.firstName,\n              last_name: contractor?.lastName,\n            })}\n          </Text>\n          <Text>{contractor?.email}</Text>\n        </div>\n        <div>\n          <Text>{t('startDateLabel')}</Text>\n          <Text>{contractor?.startDate}</Text>\n        </div>\n      </Flex>\n      <Button title={t('inviteCta')} onClick={onSubmit}>\n        {t('inviteCta')}\n      </Button>\n    </Flex>\n  )\n}\n"],"names":["ContractorSubmit","props","jsx","BaseComponent","Root","contractorId","selfOnboarding","dictionary","useI18n","useComponentDictionary","Alert","Box","BoxHeader","Button","Text","Heading","UnorderedList","useComponentContext","t","useTranslation","onEvent","baseSubmitHandler","useBase","items","data","useContractorsGetOnboardingStatusSuspense","onboardingStatus","mutateAsync","useContractorsUpdateOnboardingStatusMutation","onSubmit","response","ContractorOnboardingStatus","componentEvents","handleInviteContractor","handleSubmitDone","SubmitDone","InviteContractor","jsxs","Flex","FlexItem","item","ActionsLayout","contractorData","useContractorsGetSuspense","contractor","firstLastName"],"mappings":"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"}
+{"version":3,"file":"Submit.js","sources":["../../../../src/components/Contractor/Submit/Submit.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport { useContractorsUpdateOnboardingStatusMutation } from '@gusto/embedded-api-v-2026-02-01/react-query/contractorsUpdateOnboardingStatus'\nimport { useContractorsGetOnboardingStatusSuspense } from '@gusto/embedded-api-v-2026-02-01/react-query/contractorsGetOnboardingStatus'\nimport { useContractorsGetSuspense } from '@gusto/embedded-api-v-2026-02-01/react-query/contractorsGet'\nimport { SubmitDone } from './SubmitDone'\nimport { ActionsLayout, Flex, FlexItem } from '@/components/Common'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { useI18n, useComponentDictionary } from '@/i18n'\nimport { BaseComponent, useBase, type BaseComponentInterface } from '@/components/Base'\nimport { componentEvents, ContractorOnboardingStatus } from '@/shared/constants'\nimport { firstLastName } from '@/helpers/formattedStrings'\n\n/**\n * Props for {@link ContractorSubmit}.\n *\n * @public\n */\nexport interface ContractorSubmitProps extends BaseComponentInterface<'Contractor.Submit'> {\n  /** UUID of the contractor being submitted. */\n  contractorId: string\n  /** When true, adjusts the submission for the self-onboarding flow, surfacing the invite step before the contractor's onboarding status is finalized. */\n  selfOnboarding?: boolean\n}\n\n/**\n * Finalizes contractor onboarding by updating the onboarding status, and in the self-onboarding flow can trigger an invitation to the contractor.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `contractor/onboardingStatus/updated` | The contractor's onboarding status was successfully updated. | The updated `contractorOnboardingStatus` returned by the API. |\n * | `contractor/invite/selfOnboarding` | The invite action was triggered for a self-onboarding contractor. | `{ contractorId: string }` |\n * | `contractor/submit/done` | The submission step finished — fired after a successful status update, after an invite, or when the contractor was already onboarded. | `{ message: string }`, optionally with `onboardingStatus` when the contractor was already completed. |\n *\n * @param props - See {@link ContractorSubmitProps}.\n * @returns The rendered submission step.\n * @public\n */\nexport function ContractorSubmit(props: ContractorSubmitProps) {\n  return (\n    <BaseComponent {...props}>\n      <Root {...props}>{props.children}</Root>\n    </BaseComponent>\n  )\n}\n\nconst Root = ({ contractorId, selfOnboarding, dictionary }: ContractorSubmitProps) => {\n  useI18n('Contractor.Submit')\n  useComponentDictionary('Contractor.Submit', dictionary)\n  const { Alert, Box, BoxHeader, Button, Text, Heading, UnorderedList } = useComponentContext()\n  const { t } = useTranslation('Contractor.Submit')\n  const { onEvent, baseSubmitHandler } = useBase()\n  const items = Object.values(t('warningItems', { returnObjects: true }))\n\n  const { data } = useContractorsGetOnboardingStatusSuspense({\n    contractorUuid: contractorId,\n  })\n  const onboardingStatus = data.contractorOnboardingStatus?.onboardingStatus\n\n  const { mutateAsync } = useContractorsUpdateOnboardingStatusMutation()\n\n  const onSubmit = async () => {\n    await baseSubmitHandler(null, async () => {\n      const response = await mutateAsync({\n        request: {\n          contractorUuid: contractorId,\n          contractorOnboardingStatusUpdateRequestBody: {\n            onboardingStatus: ContractorOnboardingStatus.ONBOARDING_COMPLETED,\n          },\n        },\n      })\n      onEvent(\n        componentEvents.CONTRACTOR_ONBOARDING_STATUS_UPDATED,\n        response.contractorOnboardingStatus,\n      )\n      onEvent(componentEvents.CONTRACTOR_SUBMIT_DONE, { message: t('submitDone.successMessage') })\n    })\n  }\n  const handleInviteContractor = () => {\n    onEvent(componentEvents.CONTRACTOR_INVITE_CONTRACTOR, { contractorId })\n    onEvent(componentEvents.CONTRACTOR_SUBMIT_DONE, {\n      message: t('inviteContractor.successMessage'),\n    })\n  }\n\n  const handleSubmitDone = () => {\n    onEvent(componentEvents.CONTRACTOR_SUBMIT_DONE, {\n      onboardingStatus,\n      message: t('submitDone.successMessage'),\n    })\n  }\n\n  if (onboardingStatus === ContractorOnboardingStatus.ONBOARDING_COMPLETED) {\n    return <SubmitDone onDone={handleSubmitDone} />\n  }\n  if (\n    onboardingStatus === ContractorOnboardingStatus.SELF_ONBOARDING_NOT_INVITED &&\n    selfOnboarding\n  ) {\n    return <InviteContractor onSubmit={handleInviteContractor} contractorId={contractorId} />\n  }\n\n  return (\n    <Flex flexDirection=\"column\" gap={24}>\n      <FlexItem>\n        <Heading as=\"h2\">{t('heading')}</Heading>\n      </FlexItem>\n\n      <Box\n        header={\n          <BoxHeader\n            title={t('documentRequirements.title')}\n            description={t('documentRequirements.description')}\n          />\n        }\n      >\n        <Flex flexDirection=\"column\" gap={16}>\n          {Object.values(t('documentRequirements.items', { returnObjects: true })).map(item => (\n            <div key={item.title}>\n              <Text weight=\"medium\">{item.title}</Text>\n              <Text variant=\"supporting\">{item.description}</Text>\n            </div>\n          ))}\n          <Alert status=\"info\" label={t('documentRequirements.alertLabel')}></Alert>\n        </Flex>\n      </Box>\n      <Flex flexDirection=\"column\" gap={8}>\n        <Alert status=\"warning\" label={t('title')}>\n          <UnorderedList items={items} />\n        </Alert>\n        <ActionsLayout justifyContent=\"end\">\n          <Button title={t('submitCta')} onClick={onSubmit}>\n            {t('submitCta')}\n          </Button>\n        </ActionsLayout>\n      </Flex>\n    </Flex>\n  )\n}\n\nconst InviteContractor = ({\n  onSubmit,\n  contractorId,\n}: {\n  onSubmit: () => void\n  contractorId: string\n}) => {\n  const { t } = useTranslation('Contractor.Submit', { keyPrefix: 'inviteContractor' })\n  const { Button, Heading, Text } = useComponentContext()\n\n  const { data: contractorData } = useContractorsGetSuspense({ contractorUuid: contractorId })\n  const contractor = contractorData.contractor\n\n  return (\n    <Flex flexDirection=\"column\">\n      <Heading as=\"h2\">{t('title')}</Heading>\n      <Text>{t('description')}</Text>\n      <Flex flexDirection=\"column\">\n        <div>\n          <Text>\n            {firstLastName({\n              first_name: contractor?.firstName,\n              last_name: contractor?.lastName,\n            })}\n          </Text>\n          <Text>{contractor?.email}</Text>\n        </div>\n        <div>\n          <Text>{t('startDateLabel')}</Text>\n          <Text>{contractor?.startDate}</Text>\n        </div>\n      </Flex>\n      <Button title={t('inviteCta')} onClick={onSubmit}>\n        {t('inviteCta')}\n      </Button>\n    </Flex>\n  )\n}\n"],"names":["ContractorSubmit","props","jsx","BaseComponent","Root","contractorId","selfOnboarding","dictionary","useI18n","useComponentDictionary","Alert","Box","BoxHeader","Button","Text","Heading","UnorderedList","useComponentContext","t","useTranslation","onEvent","baseSubmitHandler","useBase","items","data","useContractorsGetOnboardingStatusSuspense","onboardingStatus","mutateAsync","useContractorsUpdateOnboardingStatusMutation","onSubmit","response","ContractorOnboardingStatus","componentEvents","handleInviteContractor","handleSubmitDone","SubmitDone","InviteContractor","jsxs","Flex","FlexItem","item","ActionsLayout","contractorData","useContractorsGetSuspense","contractor","firstLastName"],"mappings":"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"}

package/dist/components/Contractor/exports/contractorOnboarding.d.ts

@@ -1,5 +1,6 @@
 export { OnboardingFlow } from '../OnboardingFlow/OnboardingFlow';
 export type { OnboardingFlowProps, OnboardingFlowDefaultValues, } from '../OnboardingFlow/OnboardingFlowComponents';
+export { SelfOnboardingFlow, type SelfOnboardingFlowProps, } from '../SelfOnboardingFlow/SelfOnboardingFlow';
 export { Landing, type LandingProps } from '../Landing';
 export { OnboardingSummary, type OnboardingSummaryProps } from '../OnboardingSummary';
 export { ContractorList, type ContractorListProps } from '../ContractorList';
@@ -12,4 +13,6 @@ export type { PaymentMethodProps } from '../PaymentMethod/types';
 export { NewHireReport } from '../NewHireReport/NewHireReport';
 export type { NewHireReportProps } from '../NewHireReport/types';
 export { ContractorSubmit, type ContractorSubmitProps } from '../Submit/Submit';
+export { DocumentSigner, type DocumentSignerProps } from '../Documents/DocumentSigner';
 export { DocumentsList, type DocumentsListProps } from '../Documents/DocumentsList';
+export { SignatureForm, type SignatureFormProps } from '../Documents/SignatureForm';

package/dist/components/Contractor/exports/contractorOnboarding.js

@@ -1,23 +1,29 @@
 import { OnboardingFlow as t } from "../OnboardingFlow/OnboardingFlow.js";
-import { ContractorList as m } from "../ContractorList/index.js";
-import { PaymentMethod as n } from "../PaymentMethod/PaymentMethod.js";
-import { NewHireReport as x } from "../NewHireReport/NewHireReport.js";
-import { ContractorSubmit as i } from "../Submit/Submit.js";
+import { SelfOnboardingFlow as m } from "../SelfOnboardingFlow/SelfOnboardingFlow.js";
+import { ContractorList as f } from "../ContractorList/index.js";
+import { PaymentMethod as x } from "../PaymentMethod/PaymentMethod.js";
+import { NewHireReport as a } from "../NewHireReport/NewHireReport.js";
+import { ContractorSubmit as g } from "../Submit/Submit.js";
 import { Address as s } from "../Address/Address.js";
-import { ContractorProfile as b } from "../Profile/ContractorProfile.js";
-import { DocumentsList as u } from "../Documents/DocumentsList/DocumentsList.js";
+import { ContractorProfile as S } from "../Profile/ContractorProfile.js";
+import { DocumentSigner as l } from "../Documents/DocumentSigner/DocumentSigner.js";
+import { DocumentsList as C } from "../Documents/DocumentsList/DocumentsList.js";
 import { Landing as L } from "../Landing/Landing.js";
-import { OnboardingSummary as w } from "../OnboardingSummary/OnboardingSummary.js";
+import { OnboardingSummary as y } from "../OnboardingSummary/OnboardingSummary.js";
+import { SignatureForm as P } from "../Documents/SignatureForm/SignatureForm.js";
 export {
   s as Address,
-  m as ContractorList,
-  b as ContractorProfile,
-  i as ContractorSubmit,
-  u as DocumentsList,
+  f as ContractorList,
+  S as ContractorProfile,
+  g as ContractorSubmit,
+  l as DocumentSigner,
+  C as DocumentsList,
   L as Landing,
-  x as NewHireReport,
+  a as NewHireReport,
   t as OnboardingFlow,
-  w as OnboardingSummary,
-  n as PaymentMethod
+  y as OnboardingSummary,
+  x as PaymentMethod,
+  m as SelfOnboardingFlow,
+  P as SignatureForm
 };
 //# sourceMappingURL=contractorOnboarding.js.map

package/dist/components/Contractor/exports/contractorOnboarding.js.map

@@ -1 +1 @@
-{"version":3,"file":"contractorOnboarding.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;"}
+{"version":3,"file":"contractorOnboarding.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;"}

package/dist/components/Employee/Compensation/index.d.ts

@@ -1,2 +1 @@
-import "./types/i18next.d.ts"
 export * from './onboarding';

package/dist/components/Employee/Compensation/management/Compensation.d.ts

@@ -35,6 +35,6 @@ export interface CompensationProps extends BaseComponentInterface<'Employee.Mana
  * @param props - See {@link CompensationProps}.
  * @returns The rendered compensation block.
  * @public
- * @group Block Components
+ * @group Block components
  */
 export declare function Compensation({ dictionary, FallbackComponent, ...props }: CompensationProps): import("react").JSX.Element;

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

@@ -1 +1 @@
-{"version":3,"file":"Compensation.js","sources":["../../../../../src/components/Employee/Compensation/management/Compensation.tsx"],"sourcesContent":["import { createMachine } from 'robot3'\nimport { useMemo } from 'react'\nimport {\n  CompensationCardContextual,\n  type CompensationContextInterface,\n} from './CompensationComponents'\nimport { compensationStateMachine } from './compensationStateMachine'\nimport { Flow } from '@/components/Flow/Flow'\nimport { BaseBoundaries, type BaseComponentInterface } from '@/components/Base'\nimport { useComponentDictionary } from '@/i18n/I18n'\nimport { useI18n } from '@/i18n'\n\n/**\n * Props for {@link Compensation}.\n *\n * @public\n */\nexport interface CompensationProps extends BaseComponentInterface<'Employee.Management.Compensation'> {\n  /** The associated employee identifier. */\n  employeeId: string\n}\n\nfunction CompensationFlow({ employeeId, onEvent }: CompensationProps) {\n  useI18n('Employee.Management.Compensation')\n\n  const machine = useMemo(\n    () =>\n      createMachine('card', compensationStateMachine, (ctx: CompensationContextInterface) => ({\n        ...ctx,\n        component: CompensationCardContextual,\n        employeeId,\n        successAlert: null,\n      })),\n    [employeeId],\n  )\n\n  return <Flow machine={machine} onEvent={onEvent} />\n}\n\n/**\n * Self-contained block for viewing and managing an employee's jobs and compensation — the same experience the dashboard surfaces, but as a drop-in component that doesn't require the surrounding dashboard chrome.\n *\n * @remarks\n * Renders a read-only card showing the employee's job(s), pay type, wage, and effective date, along with affordances to edit a job's compensation, add a first job from the empty state, add another job (when the primary job is Nonexempt), delete a non-primary job, and cancel a scheduled future-dated change. Choosing to edit or add a job swaps the card for the corresponding form; a successful add returns to the card with a dismissible \"Job successfully added.\" alert, an edit returns to the card without an alert, and cancelling returns without saving. Wraps everything in error and suspense boundaries.\n *\n * The card and form surfaces ({@link CompensationCard}, {@link CompensationEditForm}, {@link CompensationAddJobForm}, {@link CompensationAddAnotherJobForm}) are also exported individually for cases where that orchestration is the wrong fit — for example, when a form needs to render in a modal or drawer, when the card needs to appear read-only with no edit/add affordances, or when the swap is driven by a router. Using them directly means owning the swap, the alert, and any cross-component state yourself.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `employee/management/compensation/card/editRequested` | Fired when an \"Edit\" CTA is clicked for a job; the block opens the edit form for that job | `{ employeeId: string, jobId: string }` |\n * | `employee/management/compensation/card/addRequested` | Fired when the \"Add job\" CTA is clicked from the card's empty state; the block opens the add-first-job form | `{ employeeId: string }` |\n * | `employee/management/compensation/card/addAnotherRequested` | Fired when the \"Add another job\" CTA is clicked; the block opens the add-another-job form | `{ employeeId: string }` |\n * | `employee/management/compensation/card/jobDeleted` | Fired after a non-primary job is deleted via the card's confirm dialog; the block stays on the card | `{ employeeId: string, jobId: string }` |\n * | `employee/management/compensation/card/changeCancelled` | Fired after a scheduled future-dated change is cancelled from the card; the block stays on the card | `{ employeeId: string, compensationId: string }` |\n * | `employee/management/compensation/editForm/submitted` | Fired after an edit-compensation save completes; the block returns to the card view | Updated `Compensation` entity |\n * | `employee/management/compensation/editForm/cancelled` | Fired when the user cancels the edit form; the block returns to the card view | — |\n * | `employee/management/compensation/addJobForm/submitted` | Fired after the first job + compensation are saved; the block returns to the card and surfaces the \"Job added\" alert | Updated `Compensation` entity |\n * | `employee/management/compensation/addJobForm/cancelled` | Fired when the user cancels the add-job form; the block returns to the card view | — |\n * | `employee/management/compensation/addAnotherJobForm/submitted` | Fired after a secondary job + compensation are saved; the block returns to the card and surfaces the \"Job added\" alert | Updated `Compensation` entity |\n * | `employee/management/compensation/addAnotherJobForm/cancelled` | Fired when the user cancels the add-another-job form; the block returns to the card view | — |\n * | `employee/management/compensation/alertDismissed` | Fired when the user dismisses the \"Job added\" success alert above the card | `null` |\n *\n * @param props - See {@link CompensationProps}.\n * @returns The rendered compensation block.\n * @public\n * @group Block Components\n */\nexport function Compensation({ dictionary, FallbackComponent, ...props }: CompensationProps) {\n  useComponentDictionary('Employee.Management.Compensation', dictionary)\n  return (\n    <BaseBoundaries\n      componentName=\"Employee.Management.Compensation\"\n      FallbackComponent={FallbackComponent}\n    >\n      <CompensationFlow {...props} />\n    </BaseBoundaries>\n  )\n}\n"],"names":["CompensationFlow","employeeId","onEvent","useI18n","machine","useMemo","createMachine","compensationStateMachine","ctx","CompensationCardContextual","jsx","Flow","Compensation","dictionary","FallbackComponent","props","useComponentDictionary","BaseBoundaries"],"mappings":";;;;;;;;;AAsBA,SAASA,EAAiB,EAAE,YAAAC,GAAY,SAAAC,KAA8B;AACpE,EAAAC,EAAQ,kCAAkC;AAE1C,QAAMC,IAAUC;AAAA,IACd,MACEC,EAAc,QAAQC,GAA0B,CAACC,OAAuC;AAAA,MACtF,GAAGA;AAAA,MACH,WAAWC;AAAA,MACX,YAAAR;AAAA,MACA,cAAc;AAAA,IAAA,EACd;AAAA,IACJ,CAACA,CAAU;AAAA,EAAA;AAGb,SAAO,gBAAAS,EAACC,GAAA,EAAK,SAAAP,GAAkB,SAAAF,EAAA,CAAkB;AACnD;AA+BO,SAASU,EAAa,EAAE,YAAAC,GAAY,mBAAAC,GAAmB,GAAGC,KAA4B;AAC3F,SAAAC,EAAuB,oCAAoCH,CAAU,GAEnE,gBAAAH;AAAA,IAACO;AAAA,IAAA;AAAA,MACC,eAAc;AAAA,MACd,mBAAAH;AAAA,MAEA,UAAA,gBAAAJ,EAACV,GAAA,EAAkB,GAAGe,EAAA,CAAO;AAAA,IAAA;AAAA,EAAA;AAGnC;"}
+{"version":3,"file":"Compensation.js","sources":["../../../../../src/components/Employee/Compensation/management/Compensation.tsx"],"sourcesContent":["import { createMachine } from 'robot3'\nimport { useMemo } from 'react'\nimport {\n  CompensationCardContextual,\n  type CompensationContextInterface,\n} from './CompensationComponents'\nimport { compensationStateMachine } from './compensationStateMachine'\nimport { Flow } from '@/components/Flow/Flow'\nimport { BaseBoundaries, type BaseComponentInterface } from '@/components/Base'\nimport { useComponentDictionary } from '@/i18n/I18n'\nimport { useI18n } from '@/i18n'\n\n/**\n * Props for {@link Compensation}.\n *\n * @public\n */\nexport interface CompensationProps extends BaseComponentInterface<'Employee.Management.Compensation'> {\n  /** The associated employee identifier. */\n  employeeId: string\n}\n\nfunction CompensationFlow({ employeeId, onEvent }: CompensationProps) {\n  useI18n('Employee.Management.Compensation')\n\n  const machine = useMemo(\n    () =>\n      createMachine('card', compensationStateMachine, (ctx: CompensationContextInterface) => ({\n        ...ctx,\n        component: CompensationCardContextual,\n        employeeId,\n        successAlert: null,\n      })),\n    [employeeId],\n  )\n\n  return <Flow machine={machine} onEvent={onEvent} />\n}\n\n/**\n * Self-contained block for viewing and managing an employee's jobs and compensation — the same experience the dashboard surfaces, but as a drop-in component that doesn't require the surrounding dashboard chrome.\n *\n * @remarks\n * Renders a read-only card showing the employee's job(s), pay type, wage, and effective date, along with affordances to edit a job's compensation, add a first job from the empty state, add another job (when the primary job is Nonexempt), delete a non-primary job, and cancel a scheduled future-dated change. Choosing to edit or add a job swaps the card for the corresponding form; a successful add returns to the card with a dismissible \"Job successfully added.\" alert, an edit returns to the card without an alert, and cancelling returns without saving. Wraps everything in error and suspense boundaries.\n *\n * The card and form surfaces ({@link CompensationCard}, {@link CompensationEditForm}, {@link CompensationAddJobForm}, {@link CompensationAddAnotherJobForm}) are also exported individually for cases where that orchestration is the wrong fit — for example, when a form needs to render in a modal or drawer, when the card needs to appear read-only with no edit/add affordances, or when the swap is driven by a router. Using them directly means owning the swap, the alert, and any cross-component state yourself.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `employee/management/compensation/card/editRequested` | Fired when an \"Edit\" CTA is clicked for a job; the block opens the edit form for that job | `{ employeeId: string, jobId: string }` |\n * | `employee/management/compensation/card/addRequested` | Fired when the \"Add job\" CTA is clicked from the card's empty state; the block opens the add-first-job form | `{ employeeId: string }` |\n * | `employee/management/compensation/card/addAnotherRequested` | Fired when the \"Add another job\" CTA is clicked; the block opens the add-another-job form | `{ employeeId: string }` |\n * | `employee/management/compensation/card/jobDeleted` | Fired after a non-primary job is deleted via the card's confirm dialog; the block stays on the card | `{ employeeId: string, jobId: string }` |\n * | `employee/management/compensation/card/changeCancelled` | Fired after a scheduled future-dated change is cancelled from the card; the block stays on the card | `{ employeeId: string, compensationId: string }` |\n * | `employee/management/compensation/editForm/submitted` | Fired after an edit-compensation save completes; the block returns to the card view | Updated `Compensation` entity |\n * | `employee/management/compensation/editForm/cancelled` | Fired when the user cancels the edit form; the block returns to the card view | — |\n * | `employee/management/compensation/addJobForm/submitted` | Fired after the first job + compensation are saved; the block returns to the card and surfaces the \"Job added\" alert | Updated `Compensation` entity |\n * | `employee/management/compensation/addJobForm/cancelled` | Fired when the user cancels the add-job form; the block returns to the card view | — |\n * | `employee/management/compensation/addAnotherJobForm/submitted` | Fired after a secondary job + compensation are saved; the block returns to the card and surfaces the \"Job added\" alert | Updated `Compensation` entity |\n * | `employee/management/compensation/addAnotherJobForm/cancelled` | Fired when the user cancels the add-another-job form; the block returns to the card view | — |\n * | `employee/management/compensation/alertDismissed` | Fired when the user dismisses the \"Job added\" success alert above the card | `null` |\n *\n * @param props - See {@link CompensationProps}.\n * @returns The rendered compensation block.\n * @public\n * @group Block components\n */\nexport function Compensation({ dictionary, FallbackComponent, ...props }: CompensationProps) {\n  useComponentDictionary('Employee.Management.Compensation', dictionary)\n  return (\n    <BaseBoundaries\n      componentName=\"Employee.Management.Compensation\"\n      FallbackComponent={FallbackComponent}\n    >\n      <CompensationFlow {...props} />\n    </BaseBoundaries>\n  )\n}\n"],"names":["CompensationFlow","employeeId","onEvent","useI18n","machine","useMemo","createMachine","compensationStateMachine","ctx","CompensationCardContextual","jsx","Flow","Compensation","dictionary","FallbackComponent","props","useComponentDictionary","BaseBoundaries"],"mappings":";;;;;;;;;AAsBA,SAASA,EAAiB,EAAE,YAAAC,GAAY,SAAAC,KAA8B;AACpE,EAAAC,EAAQ,kCAAkC;AAE1C,QAAMC,IAAUC;AAAA,IACd,MACEC,EAAc,QAAQC,GAA0B,CAACC,OAAuC;AAAA,MACtF,GAAGA;AAAA,MACH,WAAWC;AAAA,MACX,YAAAR;AAAA,MACA,cAAc;AAAA,IAAA,EACd;AAAA,IACJ,CAACA,CAAU;AAAA,EAAA;AAGb,SAAO,gBAAAS,EAACC,GAAA,EAAK,SAAAP,GAAkB,SAAAF,EAAA,CAAkB;AACnD;AA+BO,SAASU,EAAa,EAAE,YAAAC,GAAY,mBAAAC,GAAmB,GAAGC,KAA4B;AAC3F,SAAAC,EAAuB,oCAAoCH,CAAU,GAEnE,gBAAAH;AAAA,IAACO;AAAA,IAAA;AAAA,MACC,eAAc;AAAA,MACd,mBAAAH;AAAA,MAEA,UAAA,gBAAAJ,EAACV,GAAA,EAAkB,GAAGe,EAAA,CAAO;AAAA,IAAA;AAAA,EAAA;AAGnC;"}

package/dist/components/Employee/Compensation/management/CompensationAddAnotherJobForm/CompensationAddAnotherJobForm.d.ts

@@ -27,6 +27,6 @@ export interface CompensationAddAnotherJobFormProps extends CommonComponentInter
  * @param props - See {@link CompensationAddAnotherJobFormProps}.
  * @returns The rendered add-another-job form.
  * @public
- * @group Block Components
+ * @group Block components
  */
 export declare function CompensationAddAnotherJobForm({ dictionary, ...props }: CompensationAddAnotherJobFormProps): import("react").JSX.Element;