@gusto/embedded-react-sdk 0.51.0 → 0.51.2

package/dist/components/Contractor/Documents/SignatureForm/useContractorSignatureForm/useContractorSignatureForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"useContractorSignatureForm.js","sources":["../../../../../../src/components/Contractor/Documents/SignatureForm/useContractorSignatureForm/useContractorSignatureForm.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 { Document } from '@gusto/embedded-api-v-2026-02-01/models/components/document'\nimport type { DocumentSigned } from '@gusto/embedded-api-v-2026-02-01/models/components/documentsigned'\nimport { useContractorDocumentsGet } from '@gusto/embedded-api-v-2026-02-01/react-query/contractorDocumentsGet'\nimport { useContractorDocumentsGetPdf } from '@gusto/embedded-api-v-2026-02-01/react-query/contractorDocumentsGetPdf'\nimport { useContractorDocumentsSignMutation } from '@gusto/embedded-api-v-2026-02-01/react-query/contractorDocumentsSign'\nimport {\n  buildW9Defaults,\n  getPresentFieldNames,\n  getRedactionState,\n  serializeW9Fields,\n  EMPTY_W9_DEFAULTS,\n  TAX_CLASSIFICATION_OPTION_KEYS,\n  LLC_CLASSIFICATION_CODES,\n  LLC_CLASSIFICATION_OPTION,\n  OTHER_CLASSIFICATION_OPTION,\n  type W9RedactionState,\n} from './w9Fields'\nimport {\n  createContractorSignatureFormSchema,\n  type ContractorSignatureFormData,\n  type ContractorSignatureFormOutputs,\n  type ContractorSignatureOptionalFieldsToRequire,\n} from './contractorSignatureFormSchema'\nimport {\n  NameField,\n  TaxClassificationField,\n  HomeAddressStreet1Field,\n  HomeAddressCityField,\n  HomeAddressStateField,\n  HomeAddressZipField,\n  SsnField,\n  EinField,\n  SignatureTextField,\n  AgreeField,\n  BusinessNameField,\n  LlcClassificationCodeField,\n  OtherTextField,\n  ForeignPartnersField,\n  ExemptPayeeCodeField,\n  ExemptionFromFatcaField,\n  HomeAddressStreet2Field,\n  AccountNumberField,\n  CompanyNameField,\n  type ContractorSignatureFormFieldComponents,\n} from './fields'\nimport { useDeriveFieldsMetadata } from '@/partner-hook-utils/form/useDeriveFieldsMetadata'\nimport { withOptions } from '@/partner-hook-utils/form/withOptions'\nimport { withFlags } from '@/partner-hook-utils/form/withFlags'\nimport { useHookFormInternals } from '@/partner-hook-utils/form/useHookFormInternals'\nimport { createGetFormSubmissionValues } from '@/partner-hook-utils/form/getFormSubmissionValues'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type {\n  BaseFormHookReady,\n  FieldMetadata,\n  FieldsMetadata,\n  HookLoadingResult,\n  HookSubmitResult,\n} from '@/partner-hook-utils/types'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { SDKInternalError } from '@/types/sdkError'\n\n/**\n * Props for {@link useContractorSignatureForm}.\n *\n * @public\n */\nexport interface UseContractorSignatureFormProps {\n  /** UUID of the contractor document to sign. */\n  documentUuid: string\n  /** When validation runs. Passed through to react-hook-form; defaults to `'onSubmit'`. */\n  validationMode?: UseFormProps['mode']\n  /** Auto-focus the first invalid field on submit. Defaults to `true`; set to `false` when using `composeSubmitHandler`. */\n  shouldFocusError?: boolean\n  /** Promote optional W-9 fields to required (e.g. `{ create: ['businessName'] }`). */\n  optionalFieldsToRequire?: ContractorSignatureOptionalFieldsToRequire\n}\n\n/**\n * Ready-state shape returned by {@link useContractorSignatureForm} once the\n * document metadata has loaded.\n *\n * @public\n */\nexport interface UseContractorSignatureFormReady extends BaseFormHookReady<\n  ContractorSignatureFieldsMetadata,\n  ContractorSignatureFormData,\n  ContractorSignatureFormFieldComponents\n> {\n  /** Loaded data — the document being signed and a downloadable PDF URL. */\n  data: {\n    /** The document entity fetched from the API. */\n    document: Document\n    /** URL to the document's PDF, or `null` when unavailable. */\n    pdfUrl: string | null\n    /** Whether the document carries signable fields (vs. acknowledge-only). */\n    hasFields: boolean\n  }\n  /** Submit-state flags. */\n  status: {\n    /** `true` while the sign mutation is in flight. */\n    isPending: boolean\n    /** Always `'create'`; the hook always submits as a signing operation. */\n    mode: 'create'\n  }\n  /** Imperative actions exposed by the hook. */\n  actions: {\n    /** Validates the form and submits the signature. Resolves with the signed document on success, or `undefined` on validation or API failure. */\n    onSubmit: () => Promise<HookSubmitResult<DocumentSigned> | undefined>\n  }\n}\n\n/**\n * Result of {@link useContractorSignatureForm} — a discriminated union on `isLoading`.\n *\n * @public\n */\nexport type UseContractorSignatureFormResult = HookLoadingResult | UseContractorSignatureFormReady\n\n/**\n * Per-field metadata exposed by {@link useContractorSignatureForm} as `form.fieldsMetadata`.\n *\n * @remarks\n * Extracted from the ready-state result for standalone use when a partner needs\n * to type-check or reference the metadata shape independently.\n *\n * @public\n */\nexport type ContractorSignatureFieldsMetadata = ReturnType<\n  typeof buildContractorSignatureFieldsMetadata\n>\n\nfunction buildFields(\n  presentFieldNames: Set<string>,\n  classification: string,\n): ContractorSignatureFormFieldComponents {\n  return {\n    // Every field is presence-gated to guard against the document API diverging\n    // (dropping or renaming a field) — only `Agree` is synthesized and always on.\n    Name: presentFieldNames.has('name') ? NameField : undefined,\n    TaxClassification: presentFieldNames.has('taxClassification')\n      ? TaxClassificationField\n      : undefined,\n    HomeAddressStreet1: presentFieldNames.has('homeAddressStreet1')\n      ? HomeAddressStreet1Field\n      : undefined,\n    HomeAddressCity: presentFieldNames.has('homeAddressCity') ? HomeAddressCityField : undefined,\n    HomeAddressState: presentFieldNames.has('homeAddressState') ? HomeAddressStateField : undefined,\n    HomeAddressZip: presentFieldNames.has('homeAddressZip') ? HomeAddressZipField : undefined,\n    Ssn: presentFieldNames.has('ssn') ? SsnField : undefined,\n    Ein: presentFieldNames.has('ein') ? EinField : undefined,\n    SignatureText: presentFieldNames.has('signatureText') ? SignatureTextField : undefined,\n    Agree: AgreeField,\n    BusinessName: presentFieldNames.has('businessName') ? BusinessNameField : undefined,\n    // Revealed only while the LLC classification is selected (and the document\n    // carries classification checkboxes).\n    LlcClassificationCode:\n      presentFieldNames.has('llcClassificationCode') && classification === LLC_CLASSIFICATION_OPTION\n        ? LlcClassificationCodeField\n        : undefined,\n    // Revealed only while the \"Other\" classification is selected.\n    OtherText:\n      presentFieldNames.has('otherText') && classification === OTHER_CLASSIFICATION_OPTION\n        ? OtherTextField\n        : undefined,\n    ForeignPartners: presentFieldNames.has('foreignPartners') ? ForeignPartnersField : undefined,\n    ExemptPayeeCode: presentFieldNames.has('exemptPayeeCode') ? ExemptPayeeCodeField : undefined,\n    ExemptionFromFatca: presentFieldNames.has('exemptionFromFatca')\n      ? ExemptionFromFatcaField\n      : undefined,\n    HomeAddressStreet2: presentFieldNames.has('homeAddressStreet2')\n      ? HomeAddressStreet2Field\n      : undefined,\n    AccountNumber: presentFieldNames.has('accountNumber') ? AccountNumberField : undefined,\n    CompanyName: presentFieldNames.has('companyName') ? CompanyNameField : undefined,\n  }\n}\n\n/** @internal */\nfunction buildContractorSignatureFieldsMetadata(\n  base: Record<keyof ContractorSignatureFormData, FieldMetadata>,\n  { ssnPlaceholder, einPlaceholder }: { ssnPlaceholder?: string; einPlaceholder?: string },\n) {\n  const taxClassificationOptions = TAX_CLASSIFICATION_OPTION_KEYS.map(key => ({\n    value: key,\n    label: key,\n  }))\n  const llcClassificationOptions = LLC_CLASSIFICATION_CODES.map(code => ({\n    value: code,\n    label: code,\n  }))\n\n  return {\n    name: base.name,\n    businessName: base.businessName,\n    taxClassification: withOptions(base.taxClassification, taxClassificationOptions, [\n      ...TAX_CLASSIFICATION_OPTION_KEYS,\n    ]),\n    llcClassificationCode: withOptions(base.llcClassificationCode, llcClassificationOptions, [\n      ...LLC_CLASSIFICATION_CODES,\n    ]),\n    otherText: base.otherText,\n    foreignPartners: base.foreignPartners,\n    exemptPayeeCode: base.exemptPayeeCode,\n    exemptionFromFatca: base.exemptionFromFatca,\n    homeAddressStreet1: base.homeAddressStreet1,\n    homeAddressStreet2: base.homeAddressStreet2,\n    homeAddressCity: base.homeAddressCity,\n    homeAddressState: base.homeAddressState,\n    homeAddressZip: base.homeAddressZip,\n    accountNumber: base.accountNumber,\n    companyName: base.companyName,\n    // The masked value drives the redacted SSN/EIN placeholder. `buildFormSchema`\n    // already set `hasRedactedValue` and exempted the field from required validation.\n    ssn: withFlags(base.ssn, ssnPlaceholder ? { placeholder: ssnPlaceholder } : {}),\n    ein: withFlags(base.ein, einPlaceholder ? { placeholder: einPlaceholder } : {}),\n    signatureText: base.signatureText,\n    agree: base.agree,\n  } satisfies FieldsMetadata\n}\n\n/**\n * Headless hook for signing a contractor document — collects the document's\n * fields plus a typed signature and consent.\n *\n * @remarks\n * This hook implements the W-9 — the only signable contractor document the API\n * exposes today (`taxpayer_identification_form_w_9`). The field surface is\n * declared statically (`form.Fields`), like the other SDK form hooks: core\n * fields are always present, while variable fields are exposed only when the API\n * returns them (otherwise `undefined`) — a presence-based safety check, so a\n * field the API drops is skipped rather than rendered as an orphan. The seven\n * federal tax-classification checkboxes are collapsed into a single required\n * radio group with conditional LLC-code and \"Other\" sub-fields, and on submit\n * the selection is mapped back to the W-9 wire format. Pre-filled values (name,\n * address, TIN, etc.) are editable inputs; the signing `date` is omitted so the\n * API auto-fills it. A document that returns no recognized W-9 fields renders\n * as acknowledge-only (`data.hasFields` is `false`). Consult\n * `form.fieldsMetadata` for per-field required flags and select/radio options.\n *\n * @param props - See {@link UseContractorSignatureFormProps}.\n * @returns A {@link HookLoadingResult} while loading, or a {@link UseContractorSignatureFormReady} once loaded.\n * @public\n *\n * @example\n * ```tsx\n * import {\n *   useContractorSignatureForm,\n *   SDKFormProvider,\n *   type UseContractorSignatureFormReady,\n * } from '@gusto/embedded-react-sdk'\n *\n * function SignDocumentPage({ documentId }: { documentId: string }) {\n *   const signatureForm = useContractorSignatureForm({ documentId })\n *\n *   if (signatureForm.isLoading) return <div>Loading...</div>\n *\n *   return <SignDocumentReady signatureForm={signatureForm} />\n * }\n *\n * function SignDocumentReady({\n *   signatureForm,\n * }: {\n *   signatureForm: UseContractorSignatureFormReady\n * }) {\n *   const { Fields } = signatureForm.form\n *\n *   const handleSubmit = async () => {\n *     await signatureForm.actions.onSubmit()\n *   }\n *\n *   return (\n *     <SDKFormProvider {...signatureForm.form.methods}>\n *       {Fields.Name ? <Fields.Name /> : null}\n *       {Fields.SignatureText ? <Fields.SignatureText /> : null}\n *       <Fields.Agree />\n *       <button onClick={handleSubmit}>Sign</button>\n *     </SDKFormProvider>\n *   )\n * }\n * ```\n */\nexport function useContractorSignatureForm({\n  documentUuid,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n  optionalFieldsToRequire,\n}: UseContractorSignatureFormProps): UseContractorSignatureFormResult {\n  const documentQuery = useContractorDocumentsGet({ documentUuid })\n  // PDF failures are intentionally excluded from the page error surface; the\n  // download link is simply hidden when the URL is unavailable.\n  const pdfQuery = useContractorDocumentsGetPdf({ documentUuid })\n\n  const document = documentQuery.data?.document\n\n  const presentFieldNames = useMemo(\n    () => (document ? getPresentFieldNames(document) : new Set<string>()),\n    [document],\n  )\n  const redaction = useMemo<W9RedactionState>(\n    () => (document ? getRedactionState(document) : { ssnRedacted: false, einRedacted: false }),\n    [document],\n  )\n\n  const [schema, metadataConfig] = useMemo(\n    () =>\n      createContractorSignatureFormSchema({\n        optionalFieldsToRequire,\n        ssnRedacted: redaction.ssnRedacted,\n        einRedacted: redaction.einRedacted,\n      }),\n    [optionalFieldsToRequire, redaction.ssnRedacted, redaction.einRedacted],\n  )\n\n  const defaultValues = useMemo<ContractorSignatureFormData>(\n    () => (document ? buildW9Defaults(document) : EMPTY_W9_DEFAULTS),\n    [document],\n  )\n\n  const formMethods = useForm<ContractorSignatureFormData, unknown, ContractorSignatureFormOutputs>(\n    {\n      resolver: zodResolver(schema),\n      mode: validationMode,\n      shouldFocusError,\n      defaultValues,\n      values: defaultValues,\n      resetOptions: { keepDirtyValues: true },\n    },\n  )\n\n  const watchedClassification = useWatch({\n    control: formMethods.control,\n    name: 'taxClassification',\n  })\n  const Fields = useMemo(\n    () => buildFields(presentFieldNames, watchedClassification),\n    [presentFieldNames, watchedClassification],\n  )\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n\n  const fieldsMetadata = useMemo(\n    () =>\n      buildContractorSignatureFieldsMetadata(baseMetadata, {\n        ssnPlaceholder: redaction.ssnPlaceholder,\n        einPlaceholder: redaction.einPlaceholder,\n      }),\n    [baseMetadata, redaction],\n  )\n\n  const signMutation = useContractorDocumentsSignMutation()\n  const isPending = signMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('ContractorSignatureForm')\n\n  const errorHandling = composeErrorHandler([documentQuery], { submitError, setSubmitError })\n\n  const onSubmit = async (): Promise<HookSubmitResult<DocumentSigned> | undefined> => {\n    let submitResult: HookSubmitResult<DocumentSigned> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: ContractorSignatureFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            if (!document) {\n              throw new SDKInternalError('Document must be loaded before signing')\n            }\n\n            const result = await signMutation.mutateAsync({\n              request: {\n                documentUuid,\n                requestBody: {\n                  fields: serializeW9Fields(document, payload, redaction),\n                  agree: payload.agree,\n                  // The signing IP is supplied by the partner proxy via the\n                  // `x-gusto-client-ip` header; send an empty body value to\n                  // match the employee/company sign flows.\n                  signedByIpAddress: '',\n                },\n              },\n            })\n\n            const signedDocument = result.documentSigned\n\n            if (!signedDocument) {\n              throw new SDKInternalError('Contractor document signing failed')\n            }\n\n            submitResult = { mode: 'create', data: signedDocument }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  if (documentQuery.isLoading || !document) {\n    return { isLoading: true, errorHandling }\n  }\n\n  return {\n    isLoading: false,\n    data: {\n      document,\n      pdfUrl: pdfQuery.data?.documentPdf?.documentUrl ?? null,\n      hasFields: presentFieldNames.size > 0,\n    },\n    status: { isPending, mode: 'create' },\n    actions: { onSubmit },\n    errorHandling,\n    form: {\n      Fields,\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n"],"names":["buildFields","presentFieldNames","classification","NameField","TaxClassificationField","HomeAddressStreet1Field","HomeAddressCityField","HomeAddressStateField","HomeAddressZipField","SsnField","EinField","SignatureTextField","AgreeField","BusinessNameField","LLC_CLASSIFICATION_OPTION","LlcClassificationCodeField","OTHER_CLASSIFICATION_OPTION","OtherTextField","ForeignPartnersField","ExemptPayeeCodeField","ExemptionFromFatcaField","HomeAddressStreet2Field","AccountNumberField","CompanyNameField","buildContractorSignatureFieldsMetadata","base","ssnPlaceholder","einPlaceholder","taxClassificationOptions","TAX_CLASSIFICATION_OPTION_KEYS","key","llcClassificationOptions","LLC_CLASSIFICATION_CODES","code","withOptions","withFlags","useContractorSignatureForm","documentUuid","validationMode","shouldFocusError","optionalFieldsToRequire","documentQuery","useContractorDocumentsGet","pdfQuery","useContractorDocumentsGetPdf","document","useMemo","getPresentFieldNames","redaction","getRedactionState","schema","metadataConfig","createContractorSignatureFormSchema","defaultValues","buildW9Defaults","EMPTY_W9_DEFAULTS","formMethods","useForm","zodResolver","watchedClassification","useWatch","Fields","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","signMutation","useContractorDocumentsSignMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","onSubmit","submitResult","resolve","data","payload","SDKInternalError","signedDocument","serializeW9Fields","hookFormInternals","useHookFormInternals","createGetFormSubmissionValues"],"mappings":";;;;;;;;;;;;;;;;;AAuIA,SAASA,GACPC,GACAC,GACwC;AACxC,SAAO;AAAA;AAAA;AAAA,IAGL,MAAMD,EAAkB,IAAI,MAAM,IAAIE,KAAY;AAAA,IAClD,mBAAmBF,EAAkB,IAAI,mBAAmB,IACxDG,KACA;AAAA,IACJ,oBAAoBH,EAAkB,IAAI,oBAAoB,IAC1DI,KACA;AAAA,IACJ,iBAAiBJ,EAAkB,IAAI,iBAAiB,IAAIK,KAAuB;AAAA,IACnF,kBAAkBL,EAAkB,IAAI,kBAAkB,IAAIM,KAAwB;AAAA,IACtF,gBAAgBN,EAAkB,IAAI,gBAAgB,IAAIO,KAAsB;AAAA,IAChF,KAAKP,EAAkB,IAAI,KAAK,IAAIQ,KAAW;AAAA,IAC/C,KAAKR,EAAkB,IAAI,KAAK,IAAIS,KAAW;AAAA,IAC/C,eAAeT,EAAkB,IAAI,eAAe,IAAIU,KAAqB;AAAA,IAC7E,OAAOC;AAAA,IACP,cAAcX,EAAkB,IAAI,cAAc,IAAIY,KAAoB;AAAA;AAAA;AAAA,IAG1E,uBACEZ,EAAkB,IAAI,uBAAuB,KAAKC,MAAmBY,IACjEC,KACA;AAAA;AAAA,IAEN,WACEd,EAAkB,IAAI,WAAW,KAAKC,MAAmBc,IACrDC,KACA;AAAA,IACN,iBAAiBhB,EAAkB,IAAI,iBAAiB,IAAIiB,KAAuB;AAAA,IACnF,iBAAiBjB,EAAkB,IAAI,iBAAiB,IAAIkB,KAAuB;AAAA,IACnF,oBAAoBlB,EAAkB,IAAI,oBAAoB,IAC1DmB,IACA;AAAA,IACJ,oBAAoBnB,EAAkB,IAAI,oBAAoB,IAC1DoB,IACA;AAAA,IACJ,eAAepB,EAAkB,IAAI,eAAe,IAAIqB,IAAqB;AAAA,IAC7E,aAAarB,EAAkB,IAAI,aAAa,IAAIsB,IAAmB;AAAA,EAAA;AAE3E;AAGA,SAASC,GACPC,GACA,EAAE,gBAAAC,GAAgB,gBAAAC,KAClB;AACA,QAAMC,IAA2BC,EAA+B,IAAI,CAAAC,OAAQ;AAAA,IAC1E,OAAOA;AAAA,IACP,OAAOA;AAAA,EAAA,EACP,GACIC,IAA2BC,EAAyB,IAAI,CAAAC,OAAS;AAAA,IACrE,OAAOA;AAAA,IACP,OAAOA;AAAA,EAAA,EACP;AAEF,SAAO;AAAA,IACL,MAAMR,EAAK;AAAA,IACX,cAAcA,EAAK;AAAA,IACnB,mBAAmBS,EAAYT,EAAK,mBAAmBG,GAA0B;AAAA,MAC/E,GAAGC;AAAA,IAAA,CACJ;AAAA,IACD,uBAAuBK,EAAYT,EAAK,uBAAuBM,GAA0B;AAAA,MACvF,GAAGC;AAAA,IAAA,CACJ;AAAA,IACD,WAAWP,EAAK;AAAA,IAChB,iBAAiBA,EAAK;AAAA,IACtB,iBAAiBA,EAAK;AAAA,IACtB,oBAAoBA,EAAK;AAAA,IACzB,oBAAoBA,EAAK;AAAA,IACzB,oBAAoBA,EAAK;AAAA,IACzB,iBAAiBA,EAAK;AAAA,IACtB,kBAAkBA,EAAK;AAAA,IACvB,gBAAgBA,EAAK;AAAA,IACrB,eAAeA,EAAK;AAAA,IACpB,aAAaA,EAAK;AAAA;AAAA;AAAA,IAGlB,KAAKU,EAAUV,EAAK,KAAKC,IAAiB,EAAE,aAAaA,EAAA,IAAmB,EAAE;AAAA,IAC9E,KAAKS,EAAUV,EAAK,KAAKE,IAAiB,EAAE,aAAaA,EAAA,IAAmB,EAAE;AAAA,IAC9E,eAAeF,EAAK;AAAA,IACpB,OAAOA,EAAK;AAAA,EAAA;AAEhB;AA+DO,SAASW,GAA2B;AAAA,EACzC,cAAAC;AAAA,EACA,gBAAAC,IAAiB;AAAA,EACjB,kBAAAC,IAAmB;AAAA,EACnB,yBAAAC;AACF,GAAsE;AACpE,QAAMC,IAAgBC,EAA0B,EAAE,cAAAL,GAAc,GAG1DM,IAAWC,EAA6B,EAAE,cAAAP,GAAc,GAExDQ,IAAWJ,EAAc,MAAM,UAE/BxC,IAAoB6C;AAAA,IACxB,MAAOD,IAAWE,EAAqBF,CAAQ,wBAAQ,IAAA;AAAA,IACvD,CAACA,CAAQ;AAAA,EAAA,GAELG,IAAYF;AAAA,IAChB,MAAOD,IAAWI,EAAkBJ,CAAQ,IAAI,EAAE,aAAa,IAAO,aAAa,GAAA;AAAA,IACnF,CAACA,CAAQ;AAAA,EAAA,GAGL,CAACK,GAAQC,CAAc,IAAIL;AAAA,IAC/B,MACEM,EAAoC;AAAA,MAClC,yBAAAZ;AAAA,MACA,aAAaQ,EAAU;AAAA,MACvB,aAAaA,EAAU;AAAA,IAAA,CACxB;AAAA,IACH,CAACR,GAAyBQ,EAAU,aAAaA,EAAU,WAAW;AAAA,EAAA,GAGlEK,IAAgBP;AAAA,IACpB,MAAOD,IAAWS,EAAgBT,CAAQ,IAAIU;AAAA,IAC9C,CAACV,CAAQ;AAAA,EAAA,GAGLW,IAAcC;AAAA,IAClB;AAAA,MACE,UAAUC,EAAYR,CAAM;AAAA,MAC5B,MAAMZ;AAAA,MACN,kBAAAC;AAAA,MACA,eAAAc;AAAA,MACA,QAAQA;AAAA,MACR,cAAc,EAAE,iBAAiB,GAAA;AAAA,IAAK;AAAA,EACxC,GAGIM,IAAwBC,EAAS;AAAA,IACrC,SAASJ,EAAY;AAAA,IACrB,MAAM;AAAA,EAAA,CACP,GACKK,IAASf;AAAA,IACb,MAAM9C,GAAYC,GAAmB0D,CAAqB;AAAA,IAC1D,CAAC1D,GAAmB0D,CAAqB;AAAA,EAAA,GAGrCG,IAAeC,GAAwBZ,GAAgBK,EAAY,OAAO,GAE1EQ,IAAiBlB;AAAA,IACrB,MACEtB,GAAuCsC,GAAc;AAAA,MACnD,gBAAgBd,EAAU;AAAA,MAC1B,gBAAgBA,EAAU;AAAA,IAAA,CAC3B;AAAA,IACH,CAACc,GAAcd,CAAS;AAAA,EAAA,GAGpBiB,IAAeC,EAAA,GACfC,IAAYF,EAAa,WAEzB;AAAA,IACJ,mBAAAG;AAAA,IACA,OAAOC;AAAA,IACP,UAAUC;AAAA,EAAA,IACRC,GAAc,yBAAyB,GAErCC,IAAgBC,GAAoB,CAAChC,CAAa,GAAG,EAAE,aAAA4B,GAAa,gBAAAC,GAAgB,GAEpFI,IAAW,YAAmE;AAClF,QAAIC;AAEJ,iBAAM,IAAI,QAAc,CAAAC,MAAW;AACjC,MAAKpB,EAAY;AAAA,QACf,OAAOqB,MAAyC;AAC9C,gBAAMT,EAAkBS,GAAM,OAAMC,MAAW;AAC7C,gBAAI,CAACjC;AACH,oBAAM,IAAIkC,EAAiB,wCAAwC;AAiBrE,kBAAMC,KAdS,MAAMf,EAAa,YAAY;AAAA,cAC5C,SAAS;AAAA,gBACP,cAAA5B;AAAA,gBACA,aAAa;AAAA,kBACX,QAAQ4C,EAAkBpC,GAAUiC,GAAS9B,CAAS;AAAA,kBACtD,OAAO8B,EAAQ;AAAA;AAAA;AAAA;AAAA,kBAIf,mBAAmB;AAAA,gBAAA;AAAA,cACrB;AAAA,YACF,CACD,GAE6B;AAE9B,gBAAI,CAACE;AACH,oBAAM,IAAID,EAAiB,oCAAoC;AAGjE,YAAAJ,IAAe,EAAE,MAAM,UAAU,MAAMK,EAAA;AAAA,UACzC,CAAC,GACDJ,EAAA;AAAA,QACF;AAAA,QACA,MAAM;AACJ,UAAAA,EAAA;AAAA,QACF;AAAA,MAAA,EACF;AAAA,IACF,CAAC,GAEMD;AAAA,EACT,GAEMO,IAAoBC,GAAqB3B,CAAW;AAE1D,SAAIf,EAAc,aAAa,CAACI,IACvB,EAAE,WAAW,IAAM,eAAA2B,EAAA,IAGrB;AAAA,IACL,WAAW;AAAA,IACX,MAAM;AAAA,MACJ,UAAA3B;AAAA,MACA,QAAQF,EAAS,MAAM,aAAa,eAAe;AAAA,MACnD,WAAW1C,EAAkB,OAAO;AAAA,IAAA;AAAA,IAEtC,QAAQ,EAAE,WAAAkE,GAAW,MAAM,SAAA;AAAA,IAC3B,SAAS,EAAE,UAAAO,EAAA;AAAA,IACX,eAAAF;AAAA,IACA,MAAM;AAAA,MACJ,QAAAX;AAAA,MACA,gBAAAG;AAAA,MACA,mBAAAkB;AAAA,MACA,yBAAyBE,GAA8B5B,GAAaN,CAAM;AAAA,IAAA;AAAA,EAC5E;AAEJ;"}
+{"version":3,"file":"useContractorSignatureForm.js","sources":["../../../../../../src/components/Contractor/Documents/SignatureForm/useContractorSignatureForm/useContractorSignatureForm.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 { Document } from '@gusto/embedded-api/models/components/document'\nimport type { DocumentSigned } from '@gusto/embedded-api/models/components/documentsigned'\nimport { useContractorDocumentsGet } from '@gusto/embedded-api/react-query/contractorDocumentsGet'\nimport { useContractorDocumentsGetPdf } from '@gusto/embedded-api/react-query/contractorDocumentsGetPdf'\nimport { useContractorDocumentsSignMutation } from '@gusto/embedded-api/react-query/contractorDocumentsSign'\nimport {\n  buildW9Defaults,\n  getPresentFieldNames,\n  getRedactionState,\n  serializeW9Fields,\n  EMPTY_W9_DEFAULTS,\n  TAX_CLASSIFICATION_OPTION_KEYS,\n  LLC_CLASSIFICATION_CODES,\n  LLC_CLASSIFICATION_OPTION,\n  OTHER_CLASSIFICATION_OPTION,\n  type W9RedactionState,\n} from './w9Fields'\nimport {\n  createContractorSignatureFormSchema,\n  type ContractorSignatureFormData,\n  type ContractorSignatureFormOutputs,\n  type ContractorSignatureOptionalFieldsToRequire,\n} from './contractorSignatureFormSchema'\nimport {\n  NameField,\n  TaxClassificationField,\n  HomeAddressStreet1Field,\n  HomeAddressCityField,\n  HomeAddressStateField,\n  HomeAddressZipField,\n  SsnField,\n  EinField,\n  SignatureTextField,\n  AgreeField,\n  BusinessNameField,\n  LlcClassificationCodeField,\n  OtherTextField,\n  ForeignPartnersField,\n  ExemptPayeeCodeField,\n  ExemptionFromFatcaField,\n  HomeAddressStreet2Field,\n  AccountNumberField,\n  CompanyNameField,\n  type ContractorSignatureFormFieldComponents,\n} from './fields'\nimport { useDeriveFieldsMetadata } from '@/partner-hook-utils/form/useDeriveFieldsMetadata'\nimport { withOptions } from '@/partner-hook-utils/form/withOptions'\nimport { withFlags } from '@/partner-hook-utils/form/withFlags'\nimport { useHookFormInternals } from '@/partner-hook-utils/form/useHookFormInternals'\nimport { createGetFormSubmissionValues } from '@/partner-hook-utils/form/getFormSubmissionValues'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type {\n  BaseFormHookReady,\n  FieldMetadata,\n  FieldsMetadata,\n  HookLoadingResult,\n  HookSubmitResult,\n} from '@/partner-hook-utils/types'\nimport { useBaseSubmit } from '@/components/Base/useBaseSubmit'\nimport { SDKInternalError } from '@/types/sdkError'\n\n/**\n * Props for {@link useContractorSignatureForm}.\n *\n * @public\n */\nexport interface UseContractorSignatureFormProps {\n  /** UUID of the contractor document to sign. */\n  documentUuid: string\n  /** When validation runs. Passed through to react-hook-form; defaults to `'onSubmit'`. */\n  validationMode?: UseFormProps['mode']\n  /** Auto-focus the first invalid field on submit. Defaults to `true`; set to `false` when using `composeSubmitHandler`. */\n  shouldFocusError?: boolean\n  /** Promote optional W-9 fields to required (e.g. `{ create: ['businessName'] }`). */\n  optionalFieldsToRequire?: ContractorSignatureOptionalFieldsToRequire\n}\n\n/**\n * Ready-state shape returned by {@link useContractorSignatureForm} once the\n * document metadata has loaded.\n *\n * @public\n */\nexport interface UseContractorSignatureFormReady extends BaseFormHookReady<\n  ContractorSignatureFieldsMetadata,\n  ContractorSignatureFormData,\n  ContractorSignatureFormFieldComponents\n> {\n  /** Loaded data — the document being signed and a downloadable PDF URL. */\n  data: {\n    /** The document entity fetched from the API. */\n    document: Document\n    /** URL to the document's PDF, or `null` when unavailable. */\n    pdfUrl: string | null\n    /** Whether the document carries signable fields (vs. acknowledge-only). */\n    hasFields: boolean\n  }\n  /** Submit-state flags. */\n  status: {\n    /** `true` while the sign mutation is in flight. */\n    isPending: boolean\n    /** Always `'create'`; the hook always submits as a signing operation. */\n    mode: 'create'\n  }\n  /** Imperative actions exposed by the hook. */\n  actions: {\n    /** Validates the form and submits the signature. Resolves with the signed document on success, or `undefined` on validation or API failure. */\n    onSubmit: () => Promise<HookSubmitResult<DocumentSigned> | undefined>\n  }\n}\n\n/**\n * Result of {@link useContractorSignatureForm} — a discriminated union on `isLoading`.\n *\n * @public\n */\nexport type UseContractorSignatureFormResult = HookLoadingResult | UseContractorSignatureFormReady\n\n/**\n * Per-field metadata exposed by {@link useContractorSignatureForm} as `form.fieldsMetadata`.\n *\n * @remarks\n * Extracted from the ready-state result for standalone use when a partner needs\n * to type-check or reference the metadata shape independently.\n *\n * @public\n */\nexport type ContractorSignatureFieldsMetadata = ReturnType<\n  typeof buildContractorSignatureFieldsMetadata\n>\n\nfunction buildFields(\n  presentFieldNames: Set<string>,\n  classification: string,\n): ContractorSignatureFormFieldComponents {\n  return {\n    // Every field is presence-gated to guard against the document API diverging\n    // (dropping or renaming a field) — only `Agree` is synthesized and always on.\n    Name: presentFieldNames.has('name') ? NameField : undefined,\n    TaxClassification: presentFieldNames.has('taxClassification')\n      ? TaxClassificationField\n      : undefined,\n    HomeAddressStreet1: presentFieldNames.has('homeAddressStreet1')\n      ? HomeAddressStreet1Field\n      : undefined,\n    HomeAddressCity: presentFieldNames.has('homeAddressCity') ? HomeAddressCityField : undefined,\n    HomeAddressState: presentFieldNames.has('homeAddressState') ? HomeAddressStateField : undefined,\n    HomeAddressZip: presentFieldNames.has('homeAddressZip') ? HomeAddressZipField : undefined,\n    Ssn: presentFieldNames.has('ssn') ? SsnField : undefined,\n    Ein: presentFieldNames.has('ein') ? EinField : undefined,\n    SignatureText: presentFieldNames.has('signatureText') ? SignatureTextField : undefined,\n    Agree: AgreeField,\n    BusinessName: presentFieldNames.has('businessName') ? BusinessNameField : undefined,\n    // Revealed only while the LLC classification is selected (and the document\n    // carries classification checkboxes).\n    LlcClassificationCode:\n      presentFieldNames.has('llcClassificationCode') && classification === LLC_CLASSIFICATION_OPTION\n        ? LlcClassificationCodeField\n        : undefined,\n    // Revealed only while the \"Other\" classification is selected.\n    OtherText:\n      presentFieldNames.has('otherText') && classification === OTHER_CLASSIFICATION_OPTION\n        ? OtherTextField\n        : undefined,\n    ForeignPartners: presentFieldNames.has('foreignPartners') ? ForeignPartnersField : undefined,\n    ExemptPayeeCode: presentFieldNames.has('exemptPayeeCode') ? ExemptPayeeCodeField : undefined,\n    ExemptionFromFatca: presentFieldNames.has('exemptionFromFatca')\n      ? ExemptionFromFatcaField\n      : undefined,\n    HomeAddressStreet2: presentFieldNames.has('homeAddressStreet2')\n      ? HomeAddressStreet2Field\n      : undefined,\n    AccountNumber: presentFieldNames.has('accountNumber') ? AccountNumberField : undefined,\n    CompanyName: presentFieldNames.has('companyName') ? CompanyNameField : undefined,\n  }\n}\n\n/** @internal */\nfunction buildContractorSignatureFieldsMetadata(\n  base: Record<keyof ContractorSignatureFormData, FieldMetadata>,\n  { ssnPlaceholder, einPlaceholder }: { ssnPlaceholder?: string; einPlaceholder?: string },\n) {\n  const taxClassificationOptions = TAX_CLASSIFICATION_OPTION_KEYS.map(key => ({\n    value: key,\n    label: key,\n  }))\n  const llcClassificationOptions = LLC_CLASSIFICATION_CODES.map(code => ({\n    value: code,\n    label: code,\n  }))\n\n  return {\n    name: base.name,\n    businessName: base.businessName,\n    taxClassification: withOptions(base.taxClassification, taxClassificationOptions, [\n      ...TAX_CLASSIFICATION_OPTION_KEYS,\n    ]),\n    llcClassificationCode: withOptions(base.llcClassificationCode, llcClassificationOptions, [\n      ...LLC_CLASSIFICATION_CODES,\n    ]),\n    otherText: base.otherText,\n    foreignPartners: base.foreignPartners,\n    exemptPayeeCode: base.exemptPayeeCode,\n    exemptionFromFatca: base.exemptionFromFatca,\n    homeAddressStreet1: base.homeAddressStreet1,\n    homeAddressStreet2: base.homeAddressStreet2,\n    homeAddressCity: base.homeAddressCity,\n    homeAddressState: base.homeAddressState,\n    homeAddressZip: base.homeAddressZip,\n    accountNumber: base.accountNumber,\n    companyName: base.companyName,\n    // The masked value drives the redacted SSN/EIN placeholder. `buildFormSchema`\n    // already set `hasRedactedValue` and exempted the field from required validation.\n    ssn: withFlags(base.ssn, ssnPlaceholder ? { placeholder: ssnPlaceholder } : {}),\n    ein: withFlags(base.ein, einPlaceholder ? { placeholder: einPlaceholder } : {}),\n    signatureText: base.signatureText,\n    agree: base.agree,\n  } satisfies FieldsMetadata\n}\n\n/**\n * Headless hook for signing a contractor document — collects the document's\n * fields plus a typed signature and consent.\n *\n * @remarks\n * This hook implements the W-9 — the only signable contractor document the API\n * exposes today (`taxpayer_identification_form_w_9`). The field surface is\n * declared statically (`form.Fields`), like the other SDK form hooks: core\n * fields are always present, while variable fields are exposed only when the API\n * returns them (otherwise `undefined`) — a presence-based safety check, so a\n * field the API drops is skipped rather than rendered as an orphan. The seven\n * federal tax-classification checkboxes are collapsed into a single required\n * radio group with conditional LLC-code and \"Other\" sub-fields, and on submit\n * the selection is mapped back to the W-9 wire format. Pre-filled values (name,\n * address, TIN, etc.) are editable inputs; the signing `date` is omitted so the\n * API auto-fills it. A document that returns no recognized W-9 fields renders\n * as acknowledge-only (`data.hasFields` is `false`). Consult\n * `form.fieldsMetadata` for per-field required flags and select/radio options.\n *\n * @param props - See {@link UseContractorSignatureFormProps}.\n * @returns A {@link HookLoadingResult} while loading, or a {@link UseContractorSignatureFormReady} once loaded.\n * @public\n *\n * @example\n * ```tsx\n * import {\n *   useContractorSignatureForm,\n *   SDKFormProvider,\n *   type UseContractorSignatureFormReady,\n * } from '@gusto/embedded-react-sdk'\n *\n * function SignDocumentPage({ documentId }: { documentId: string }) {\n *   const signatureForm = useContractorSignatureForm({ documentId })\n *\n *   if (signatureForm.isLoading) return <div>Loading...</div>\n *\n *   return <SignDocumentReady signatureForm={signatureForm} />\n * }\n *\n * function SignDocumentReady({\n *   signatureForm,\n * }: {\n *   signatureForm: UseContractorSignatureFormReady\n * }) {\n *   const { Fields } = signatureForm.form\n *\n *   const handleSubmit = async () => {\n *     await signatureForm.actions.onSubmit()\n *   }\n *\n *   return (\n *     <SDKFormProvider {...signatureForm.form.methods}>\n *       {Fields.Name ? <Fields.Name /> : null}\n *       {Fields.SignatureText ? <Fields.SignatureText /> : null}\n *       <Fields.Agree />\n *       <button onClick={handleSubmit}>Sign</button>\n *     </SDKFormProvider>\n *   )\n * }\n * ```\n */\nexport function useContractorSignatureForm({\n  documentUuid,\n  validationMode = 'onSubmit',\n  shouldFocusError = true,\n  optionalFieldsToRequire,\n}: UseContractorSignatureFormProps): UseContractorSignatureFormResult {\n  const documentQuery = useContractorDocumentsGet({ documentUuid })\n  // PDF failures are intentionally excluded from the page error surface; the\n  // download link is simply hidden when the URL is unavailable.\n  const pdfQuery = useContractorDocumentsGetPdf({ documentUuid })\n\n  const document = documentQuery.data?.document\n\n  const presentFieldNames = useMemo(\n    () => (document ? getPresentFieldNames(document) : new Set<string>()),\n    [document],\n  )\n  const redaction = useMemo<W9RedactionState>(\n    () => (document ? getRedactionState(document) : { ssnRedacted: false, einRedacted: false }),\n    [document],\n  )\n\n  const [schema, metadataConfig] = useMemo(\n    () =>\n      createContractorSignatureFormSchema({\n        optionalFieldsToRequire,\n        ssnRedacted: redaction.ssnRedacted,\n        einRedacted: redaction.einRedacted,\n      }),\n    [optionalFieldsToRequire, redaction.ssnRedacted, redaction.einRedacted],\n  )\n\n  const defaultValues = useMemo<ContractorSignatureFormData>(\n    () => (document ? buildW9Defaults(document) : EMPTY_W9_DEFAULTS),\n    [document],\n  )\n\n  const formMethods = useForm<ContractorSignatureFormData, unknown, ContractorSignatureFormOutputs>(\n    {\n      resolver: zodResolver(schema),\n      mode: validationMode,\n      shouldFocusError,\n      defaultValues,\n      values: defaultValues,\n      resetOptions: { keepDirtyValues: true },\n    },\n  )\n\n  const watchedClassification = useWatch({\n    control: formMethods.control,\n    name: 'taxClassification',\n  })\n  const Fields = useMemo(\n    () => buildFields(presentFieldNames, watchedClassification),\n    [presentFieldNames, watchedClassification],\n  )\n\n  const baseMetadata = useDeriveFieldsMetadata(metadataConfig, formMethods.control)\n\n  const fieldsMetadata = useMemo(\n    () =>\n      buildContractorSignatureFieldsMetadata(baseMetadata, {\n        ssnPlaceholder: redaction.ssnPlaceholder,\n        einPlaceholder: redaction.einPlaceholder,\n      }),\n    [baseMetadata, redaction],\n  )\n\n  const signMutation = useContractorDocumentsSignMutation()\n  const isPending = signMutation.isPending\n\n  const {\n    baseSubmitHandler,\n    error: submitError,\n    setError: setSubmitError,\n  } = useBaseSubmit('ContractorSignatureForm')\n\n  const errorHandling = composeErrorHandler([documentQuery], { submitError, setSubmitError })\n\n  const onSubmit = async (): Promise<HookSubmitResult<DocumentSigned> | undefined> => {\n    let submitResult: HookSubmitResult<DocumentSigned> | undefined\n\n    await new Promise<void>(resolve => {\n      void formMethods.handleSubmit(\n        async (data: ContractorSignatureFormOutputs) => {\n          await baseSubmitHandler(data, async payload => {\n            if (!document) {\n              throw new SDKInternalError('Document must be loaded before signing')\n            }\n\n            const result = await signMutation.mutateAsync({\n              request: {\n                documentUuid,\n                requestBody: {\n                  fields: serializeW9Fields(document, payload, redaction),\n                  agree: payload.agree,\n                  // The signing IP is supplied by the partner proxy via the\n                  // `x-gusto-client-ip` header; send an empty body value to\n                  // match the employee/company sign flows.\n                  signedByIpAddress: '',\n                },\n              },\n            })\n\n            const signedDocument = result.documentSigned\n\n            if (!signedDocument) {\n              throw new SDKInternalError('Contractor document signing failed')\n            }\n\n            submitResult = { mode: 'create', data: signedDocument }\n          })\n          resolve()\n        },\n        () => {\n          resolve()\n        },\n      )()\n    })\n\n    return submitResult\n  }\n\n  const hookFormInternals = useHookFormInternals(formMethods)\n\n  if (documentQuery.isLoading || !document) {\n    return { isLoading: true, errorHandling }\n  }\n\n  return {\n    isLoading: false,\n    data: {\n      document,\n      pdfUrl: pdfQuery.data?.documentPdf?.documentUrl ?? null,\n      hasFields: presentFieldNames.size > 0,\n    },\n    status: { isPending, mode: 'create' },\n    actions: { onSubmit },\n    errorHandling,\n    form: {\n      Fields,\n      fieldsMetadata,\n      hookFormInternals,\n      getFormSubmissionValues: createGetFormSubmissionValues(formMethods, schema),\n    },\n  }\n}\n"],"names":["buildFields","presentFieldNames","classification","NameField","TaxClassificationField","HomeAddressStreet1Field","HomeAddressCityField","HomeAddressStateField","HomeAddressZipField","SsnField","EinField","SignatureTextField","AgreeField","BusinessNameField","LLC_CLASSIFICATION_OPTION","LlcClassificationCodeField","OTHER_CLASSIFICATION_OPTION","OtherTextField","ForeignPartnersField","ExemptPayeeCodeField","ExemptionFromFatcaField","HomeAddressStreet2Field","AccountNumberField","CompanyNameField","buildContractorSignatureFieldsMetadata","base","ssnPlaceholder","einPlaceholder","taxClassificationOptions","TAX_CLASSIFICATION_OPTION_KEYS","key","llcClassificationOptions","LLC_CLASSIFICATION_CODES","code","withOptions","withFlags","useContractorSignatureForm","documentUuid","validationMode","shouldFocusError","optionalFieldsToRequire","documentQuery","useContractorDocumentsGet","pdfQuery","useContractorDocumentsGetPdf","document","useMemo","getPresentFieldNames","redaction","getRedactionState","schema","metadataConfig","createContractorSignatureFormSchema","defaultValues","buildW9Defaults","EMPTY_W9_DEFAULTS","formMethods","useForm","zodResolver","watchedClassification","useWatch","Fields","baseMetadata","useDeriveFieldsMetadata","fieldsMetadata","signMutation","useContractorDocumentsSignMutation","isPending","baseSubmitHandler","submitError","setSubmitError","useBaseSubmit","errorHandling","composeErrorHandler","onSubmit","submitResult","resolve","data","payload","SDKInternalError","signedDocument","serializeW9Fields","hookFormInternals","useHookFormInternals","createGetFormSubmissionValues"],"mappings":";;;;;;;;;;;;;;;;;AAuIA,SAASA,GACPC,GACAC,GACwC;AACxC,SAAO;AAAA;AAAA;AAAA,IAGL,MAAMD,EAAkB,IAAI,MAAM,IAAIE,KAAY;AAAA,IAClD,mBAAmBF,EAAkB,IAAI,mBAAmB,IACxDG,KACA;AAAA,IACJ,oBAAoBH,EAAkB,IAAI,oBAAoB,IAC1DI,KACA;AAAA,IACJ,iBAAiBJ,EAAkB,IAAI,iBAAiB,IAAIK,KAAuB;AAAA,IACnF,kBAAkBL,EAAkB,IAAI,kBAAkB,IAAIM,KAAwB;AAAA,IACtF,gBAAgBN,EAAkB,IAAI,gBAAgB,IAAIO,KAAsB;AAAA,IAChF,KAAKP,EAAkB,IAAI,KAAK,IAAIQ,KAAW;AAAA,IAC/C,KAAKR,EAAkB,IAAI,KAAK,IAAIS,KAAW;AAAA,IAC/C,eAAeT,EAAkB,IAAI,eAAe,IAAIU,KAAqB;AAAA,IAC7E,OAAOC;AAAA,IACP,cAAcX,EAAkB,IAAI,cAAc,IAAIY,KAAoB;AAAA;AAAA;AAAA,IAG1E,uBACEZ,EAAkB,IAAI,uBAAuB,KAAKC,MAAmBY,IACjEC,KACA;AAAA;AAAA,IAEN,WACEd,EAAkB,IAAI,WAAW,KAAKC,MAAmBc,IACrDC,KACA;AAAA,IACN,iBAAiBhB,EAAkB,IAAI,iBAAiB,IAAIiB,KAAuB;AAAA,IACnF,iBAAiBjB,EAAkB,IAAI,iBAAiB,IAAIkB,KAAuB;AAAA,IACnF,oBAAoBlB,EAAkB,IAAI,oBAAoB,IAC1DmB,IACA;AAAA,IACJ,oBAAoBnB,EAAkB,IAAI,oBAAoB,IAC1DoB,IACA;AAAA,IACJ,eAAepB,EAAkB,IAAI,eAAe,IAAIqB,IAAqB;AAAA,IAC7E,aAAarB,EAAkB,IAAI,aAAa,IAAIsB,IAAmB;AAAA,EAAA;AAE3E;AAGA,SAASC,GACPC,GACA,EAAE,gBAAAC,GAAgB,gBAAAC,KAClB;AACA,QAAMC,IAA2BC,EAA+B,IAAI,CAAAC,OAAQ;AAAA,IAC1E,OAAOA;AAAA,IACP,OAAOA;AAAA,EAAA,EACP,GACIC,IAA2BC,EAAyB,IAAI,CAAAC,OAAS;AAAA,IACrE,OAAOA;AAAA,IACP,OAAOA;AAAA,EAAA,EACP;AAEF,SAAO;AAAA,IACL,MAAMR,EAAK;AAAA,IACX,cAAcA,EAAK;AAAA,IACnB,mBAAmBS,EAAYT,EAAK,mBAAmBG,GAA0B;AAAA,MAC/E,GAAGC;AAAA,IAAA,CACJ;AAAA,IACD,uBAAuBK,EAAYT,EAAK,uBAAuBM,GAA0B;AAAA,MACvF,GAAGC;AAAA,IAAA,CACJ;AAAA,IACD,WAAWP,EAAK;AAAA,IAChB,iBAAiBA,EAAK;AAAA,IACtB,iBAAiBA,EAAK;AAAA,IACtB,oBAAoBA,EAAK;AAAA,IACzB,oBAAoBA,EAAK;AAAA,IACzB,oBAAoBA,EAAK;AAAA,IACzB,iBAAiBA,EAAK;AAAA,IACtB,kBAAkBA,EAAK;AAAA,IACvB,gBAAgBA,EAAK;AAAA,IACrB,eAAeA,EAAK;AAAA,IACpB,aAAaA,EAAK;AAAA;AAAA;AAAA,IAGlB,KAAKU,EAAUV,EAAK,KAAKC,IAAiB,EAAE,aAAaA,EAAA,IAAmB,EAAE;AAAA,IAC9E,KAAKS,EAAUV,EAAK,KAAKE,IAAiB,EAAE,aAAaA,EAAA,IAAmB,EAAE;AAAA,IAC9E,eAAeF,EAAK;AAAA,IACpB,OAAOA,EAAK;AAAA,EAAA;AAEhB;AA+DO,SAASW,GAA2B;AAAA,EACzC,cAAAC;AAAA,EACA,gBAAAC,IAAiB;AAAA,EACjB,kBAAAC,IAAmB;AAAA,EACnB,yBAAAC;AACF,GAAsE;AACpE,QAAMC,IAAgBC,EAA0B,EAAE,cAAAL,GAAc,GAG1DM,IAAWC,EAA6B,EAAE,cAAAP,GAAc,GAExDQ,IAAWJ,EAAc,MAAM,UAE/BxC,IAAoB6C;AAAA,IACxB,MAAOD,IAAWE,EAAqBF,CAAQ,wBAAQ,IAAA;AAAA,IACvD,CAACA,CAAQ;AAAA,EAAA,GAELG,IAAYF;AAAA,IAChB,MAAOD,IAAWI,EAAkBJ,CAAQ,IAAI,EAAE,aAAa,IAAO,aAAa,GAAA;AAAA,IACnF,CAACA,CAAQ;AAAA,EAAA,GAGL,CAACK,GAAQC,CAAc,IAAIL;AAAA,IAC/B,MACEM,EAAoC;AAAA,MAClC,yBAAAZ;AAAA,MACA,aAAaQ,EAAU;AAAA,MACvB,aAAaA,EAAU;AAAA,IAAA,CACxB;AAAA,IACH,CAACR,GAAyBQ,EAAU,aAAaA,EAAU,WAAW;AAAA,EAAA,GAGlEK,IAAgBP;AAAA,IACpB,MAAOD,IAAWS,EAAgBT,CAAQ,IAAIU;AAAA,IAC9C,CAACV,CAAQ;AAAA,EAAA,GAGLW,IAAcC;AAAA,IAClB;AAAA,MACE,UAAUC,EAAYR,CAAM;AAAA,MAC5B,MAAMZ;AAAA,MACN,kBAAAC;AAAA,MACA,eAAAc;AAAA,MACA,QAAQA;AAAA,MACR,cAAc,EAAE,iBAAiB,GAAA;AAAA,IAAK;AAAA,EACxC,GAGIM,IAAwBC,EAAS;AAAA,IACrC,SAASJ,EAAY;AAAA,IACrB,MAAM;AAAA,EAAA,CACP,GACKK,IAASf;AAAA,IACb,MAAM9C,GAAYC,GAAmB0D,CAAqB;AAAA,IAC1D,CAAC1D,GAAmB0D,CAAqB;AAAA,EAAA,GAGrCG,IAAeC,GAAwBZ,GAAgBK,EAAY,OAAO,GAE1EQ,IAAiBlB;AAAA,IACrB,MACEtB,GAAuCsC,GAAc;AAAA,MACnD,gBAAgBd,EAAU;AAAA,MAC1B,gBAAgBA,EAAU;AAAA,IAAA,CAC3B;AAAA,IACH,CAACc,GAAcd,CAAS;AAAA,EAAA,GAGpBiB,IAAeC,EAAA,GACfC,IAAYF,EAAa,WAEzB;AAAA,IACJ,mBAAAG;AAAA,IACA,OAAOC;AAAA,IACP,UAAUC;AAAA,EAAA,IACRC,GAAc,yBAAyB,GAErCC,IAAgBC,GAAoB,CAAChC,CAAa,GAAG,EAAE,aAAA4B,GAAa,gBAAAC,GAAgB,GAEpFI,IAAW,YAAmE;AAClF,QAAIC;AAEJ,iBAAM,IAAI,QAAc,CAAAC,MAAW;AACjC,MAAKpB,EAAY;AAAA,QACf,OAAOqB,MAAyC;AAC9C,gBAAMT,EAAkBS,GAAM,OAAMC,MAAW;AAC7C,gBAAI,CAACjC;AACH,oBAAM,IAAIkC,EAAiB,wCAAwC;AAiBrE,kBAAMC,KAdS,MAAMf,EAAa,YAAY;AAAA,cAC5C,SAAS;AAAA,gBACP,cAAA5B;AAAA,gBACA,aAAa;AAAA,kBACX,QAAQ4C,EAAkBpC,GAAUiC,GAAS9B,CAAS;AAAA,kBACtD,OAAO8B,EAAQ;AAAA;AAAA;AAAA;AAAA,kBAIf,mBAAmB;AAAA,gBAAA;AAAA,cACrB;AAAA,YACF,CACD,GAE6B;AAE9B,gBAAI,CAACE;AACH,oBAAM,IAAID,EAAiB,oCAAoC;AAGjE,YAAAJ,IAAe,EAAE,MAAM,UAAU,MAAMK,EAAA;AAAA,UACzC,CAAC,GACDJ,EAAA;AAAA,QACF;AAAA,QACA,MAAM;AACJ,UAAAA,EAAA;AAAA,QACF;AAAA,MAAA,EACF;AAAA,IACF,CAAC,GAEMD;AAAA,EACT,GAEMO,IAAoBC,GAAqB3B,CAAW;AAE1D,SAAIf,EAAc,aAAa,CAACI,IACvB,EAAE,WAAW,IAAM,eAAA2B,EAAA,IAGrB;AAAA,IACL,WAAW;AAAA,IACX,MAAM;AAAA,MACJ,UAAA3B;AAAA,MACA,QAAQF,EAAS,MAAM,aAAa,eAAe;AAAA,MACnD,WAAW1C,EAAkB,OAAO;AAAA,IAAA;AAAA,IAEtC,QAAQ,EAAE,WAAAkE,GAAW,MAAM,SAAA;AAAA,IAC3B,SAAS,EAAE,UAAAO,EAAA;AAAA,IACX,eAAAF;AAAA,IACA,MAAM;AAAA,MACJ,QAAAX;AAAA,MACA,gBAAAG;AAAA,MACA,mBAAAkB;AAAA,MACA,yBAAyBE,GAA8B5B,GAAaN,CAAM;AAAA,IAAA;AAAA,EAC5E;AAEJ;"}

package/dist/components/Contractor/Documents/SignatureForm/useContractorSignatureForm/w9Fields.d.ts

@@ -1,4 +1,4 @@
-import { Document } from '@gusto/embedded-api-v-2026-02-01/models/components/document';
+import { Document } from '@gusto/embedded-api/models/components/document';
 import { ContractorSignatureFormData } from './contractorSignatureFormSchema';
 /**
  * The `name` of the W-9 document — the only contractor document type that

package/dist/components/Contractor/Documents/SignatureForm/useContractorSignatureForm/w9Fields.js

@@ -1,13 +1,13 @@
 import { normalizeEin as S } from "../../../../../helpers/federalEin.js";
 import { normalizeSSN as N } from "../../../../../helpers/ssn.js";
-const _ = "N/A";
-function R(e) {
-  const s = e.replace(/\s/g, "").toUpperCase();
-  return s === "NA" ? _ : s === "N" || s === "N/" || s === _ ? s : S(e);
-}
+const R = "taxpayer_identification_form_w_9", _ = "N/A";
 function D(e) {
-  const s = e.replace(/\s/g, "").toUpperCase();
-  return s === "NA" ? _ : s === "N" || s === "N/" || s === _ ? s : N(e);
+  const t = e.replace(/\s/g, "").toUpperCase();
+  return t === "NA" ? _ : t === "N" || t === "N/" || t === _ ? t : S(e);
+}
+function k(e) {
+  const t = e.replace(/\s/g, "").toUpperCase();
+  return t === "NA" ? _ : t === "N" || t === "N/" || t === _ ? t : N(e);
 }
 const x = "taxClassification", T = "llcClassificationCode", F = "otherText", C = [
   "individual_proprietor",
@@ -17,7 +17,7 @@ const x = "taxClassification", T = "llcClassificationCode", F = "otherText", C =
   "trust_estate",
   "limited_liability_company",
   "other"
-], y = "limited_liability_company", I = "other", k = ["c", "s", "p"], l = {
+], y = "limited_liability_company", I = "other", K = ["c", "s", "p"], l = {
   name: "name",
   businessName: "business_name",
   otherText: "other_text",
@@ -35,63 +35,63 @@ const x = "taxClassification", T = "llcClassificationCode", F = "otherText", C =
   ein: "ein",
   signatureText: "signature_text"
 }, g = /* @__PURE__ */ new Set(["ssn", "ein"]);
-function b(e) {
+function E(e) {
   return typeof e == "string" && /[X•*]/.test(e);
 }
 function h(e) {
-  return e ? (g.has(e.key ?? "") || e.dataType === "ssn" || e.dataType === "ein") && b(e.value) : !1;
+  return e ? (g.has(e.key ?? "") || e.dataType === "ssn" || e.dataType === "ein") && E(e.value) : !1;
 }
 function u(e) {
-  const s = /* @__PURE__ */ new Map();
+  const t = /* @__PURE__ */ new Map();
   for (const n of e.fields ?? [])
-    n.key && s.set(n.key, n);
-  return s;
+    n.key && t.set(n.key, n);
+  return t;
 }
 function A(e) {
   return e === "1" || e === "true";
 }
-function E(e) {
-  const s = u(e), n = s.get("ssn"), t = s.get("ein"), o = h(n), a = h(t);
+function b(e) {
+  const t = u(e), n = t.get("ssn"), s = t.get("ein"), o = h(n), a = h(s);
   return {
     ssnRedacted: o,
     einRedacted: a,
     ssnPlaceholder: o ? n?.value ?? void 0 : void 0,
-    einPlaceholder: a ? t?.value ?? void 0 : void 0
+    einPlaceholder: a ? s?.value ?? void 0 : void 0
   };
 }
 function L(e) {
-  const s = u(e), n = /* @__PURE__ */ new Set();
+  const t = u(e), n = /* @__PURE__ */ new Set();
   for (const [o, a] of Object.entries(l))
-    s.has(a) && n.add(o);
-  return C.some((o) => s.has(o)) && (n.add(x), n.add(T)), n;
+    t.has(a) && n.add(o);
+  return C.some((o) => t.has(o)) && (n.add(x), n.add(T)), n;
 }
-function K(e) {
-  const s = u(e), n = E(e), t = (a) => s.get(a)?.value ?? "", o = C.find((a) => A(s.get(a)?.value)) ?? "";
+function z(e) {
+  const t = u(e), n = b(e), s = (a) => t.get(a)?.value ?? "", o = C.find((a) => A(t.get(a)?.value)) ?? "";
   return {
-    name: t("name"),
-    businessName: t("business_name"),
+    name: s("name"),
+    businessName: s("business_name"),
     taxClassification: o,
     // The LLC code serializes into the `tax_classification` field, so seed it
     // back from there when the LLC classification is the selected one.
-    llcClassificationCode: o === y ? t("tax_classification") : "",
-    otherText: t("other_text"),
-    foreignPartners: A(s.get("foreign_partners")?.value),
-    exemptPayeeCode: t("exempt_payee_code"),
-    exemptionFromFatca: t("exemption_from_FATCA"),
-    homeAddressStreet1: t("home_address_street_1"),
-    homeAddressStreet2: t("home_address_street_2"),
-    homeAddressCity: t("home_address_city"),
-    homeAddressState: t("home_address_state"),
-    homeAddressZip: t("home_address_zip"),
-    accountNumber: t("account_number"),
-    companyName: t("company_name"),
-    ssn: n.ssnRedacted ? "" : t("ssn"),
-    ein: n.einRedacted ? "" : t("ein"),
-    signatureText: t("signature_text"),
+    llcClassificationCode: o === y ? s("tax_classification") : "",
+    otherText: s("other_text"),
+    foreignPartners: A(t.get("foreign_partners")?.value),
+    exemptPayeeCode: s("exempt_payee_code"),
+    exemptionFromFatca: s("exemption_from_FATCA"),
+    homeAddressStreet1: s("home_address_street_1"),
+    homeAddressStreet2: s("home_address_street_2"),
+    homeAddressCity: s("home_address_city"),
+    homeAddressState: s("home_address_state"),
+    homeAddressZip: s("home_address_zip"),
+    accountNumber: s("account_number"),
+    companyName: s("company_name"),
+    ssn: n.ssnRedacted ? "" : s("ssn"),
+    ein: n.einRedacted ? "" : s("ein"),
+    signatureText: s("signature_text"),
     agree: !1
   };
 }
-const z = {
+const V = {
   name: "",
   businessName: "",
   taxClassification: "",
@@ -111,7 +111,7 @@ const z = {
   ein: "",
   signatureText: "",
   agree: !1
-}, P = [
+}, O = [
   "name",
   "businessName",
   "exemptPayeeCode",
@@ -125,25 +125,25 @@ const z = {
   "companyName",
   "signatureText"
 ];
-function V(e, s, n) {
-  const t = L(e), o = [], a = s, r = (i) => {
+function U(e, t, n) {
+  const s = L(e), o = [], a = t, r = (i) => {
     const m = a[i];
     return typeof m == "string" ? m : "";
   }, c = r("taxClassification"), d = (i, m) => {
     o.push({ key: l[i], value: m });
   };
-  for (const i of P)
-    t.has(i) && d(i, r(i));
-  t.has(F) && c === I && d("otherText", r("otherText")), t.has("foreignPartners") && o.push({
+  for (const i of O)
+    s.has(i) && d(i, r(i));
+  s.has(F) && c === I && d("otherText", r("otherText")), s.has("foreignPartners") && o.push({
     key: l.foreignPartners,
-    value: s.foreignPartners ? "1" : "0"
+    value: t.foreignPartners ? "1" : "0"
   });
   const f = r("ssn"), p = r("ein");
-  return t.has("ssn") && !(n.ssnRedacted && f === "") && d("ssn", f), t.has("ein") && !(n.einRedacted && p === "") && d("ein", p), c && (o.push({ key: c, value: "1" }), c === y && o.push({ key: "tax_classification", value: r("llcClassificationCode") })), o;
+  return s.has("ssn") && !(n.ssnRedacted && f === "") && d("ssn", f), s.has("ein") && !(n.einRedacted && p === "") && d("ein", p), c && (o.push({ key: c, value: "1" }), c === y && o.push({ key: "tax_classification", value: r("llcClassificationCode") })), o;
 }
 export {
-  z as EMPTY_W9_DEFAULTS,
-  k as LLC_CLASSIFICATION_CODES,
+  V as EMPTY_W9_DEFAULTS,
+  K as LLC_CLASSIFICATION_CODES,
   T as LLC_CLASSIFICATION_FIELD,
   y as LLC_CLASSIFICATION_OPTION,
   _ as NOT_APPLICABLE_VALUE,
@@ -151,12 +151,13 @@ export {
   F as OTHER_TEXT_FIELD,
   x as TAX_CLASSIFICATION_FIELD,
   C as TAX_CLASSIFICATION_OPTION_KEYS,
+  R as W9_DOCUMENT_NAME,
   l as W9_FIELD_API_KEYS,
-  K as buildW9Defaults,
+  z as buildW9Defaults,
   L as getPresentFieldNames,
-  E as getRedactionState,
-  R as normalizeEinOrNotApplicable,
-  D as normalizeSsnOrNotApplicable,
-  V as serializeW9Fields
+  b as getRedactionState,
+  D as normalizeEinOrNotApplicable,
+  k as normalizeSsnOrNotApplicable,
+  U as serializeW9Fields
 };
 //# sourceMappingURL=w9Fields.js.map

package/dist/components/Contractor/Documents/SignatureForm/useContractorSignatureForm/w9Fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"w9Fields.js","sources":["../../../../../../src/components/Contractor/Documents/SignatureForm/useContractorSignatureForm/w9Fields.ts"],"sourcesContent":["import type {\n  Document,\n  Fields as DocumentField,\n} from '@gusto/embedded-api-v-2026-02-01/models/components/document'\nimport type { ContractorSignatureFormData } from './contractorSignatureFormSchema'\nimport { normalizeEin } from '@/helpers/federalEin'\nimport { normalizeSSN } from '@/helpers/ssn'\n\n/**\n * The `name` of the W-9 document — the only contractor document type that\n * supports signing today.\n *\n * @internal\n */\nexport const W9_DOCUMENT_NAME = 'taxpayer_identification_form_w_9'\n\n/**\n * Sentinel the API returns (and accepts) for a taxpayer-ID field that doesn't\n * apply to the signer — e.g. the EIN of an individual contractor, or the SSN of\n * a business contractor. The sign endpoint stamps this verbatim, so the form\n * both prefills it and treats it as a valid submission.\n *\n * @internal\n */\nexport const NOT_APPLICABLE_VALUE = 'N/A'\n\n/**\n * EIN input transform that preserves the `N/A` sentinel (and the in-progress\n * prefixes a user types toward it) while formatting numeric input as a standard\n * EIN (`NN-NNNNNNN`).\n *\n * @remarks\n * The W-9 accepts `N/A` for a taxpayer who supplies an SSN instead of an EIN,\n * but the plain `normalizeEin` formatter strips every non-digit on each\n * keystroke — making the sentinel impossible to type. This wrapper lets the\n * sentinel through (normalized to uppercase) and defers to `normalizeEin` for\n * everything else.\n *\n * @param value - Raw user input.\n * @returns The `N/A` sentinel (or an in-progress prefix), otherwise the EIN-formatted value.\n * @internal\n */\nexport function normalizeEinOrNotApplicable(value: string): string {\n  const sentinel = value.replace(/\\s/g, '').toUpperCase()\n  if (sentinel === 'NA') return NOT_APPLICABLE_VALUE\n  if (sentinel === 'N' || sentinel === 'N/' || sentinel === NOT_APPLICABLE_VALUE) return sentinel\n  return normalizeEin(value)\n}\n\n/**\n * SSN input transform that preserves the `N/A` sentinel (and the in-progress\n * prefixes `N` and `N/`) while otherwise deferring to {@link normalizeSSN}.\n *\n * @remarks\n * The W-9 accepts `N/A` for a taxpayer who supplies an EIN instead of an SSN,\n * but the plain `normalizeSSN` formatter strips every non-digit on each\n * keystroke — making the sentinel impossible to type. This wrapper lets the\n * sentinel through (normalized to uppercase) and defers to `normalizeSSN` for\n * everything else.\n *\n * @param value - Raw user input.\n * @returns The `N/A` sentinel (or an in-progress prefix), otherwise the SSN-formatted value.\n * @internal\n */\nexport function normalizeSsnOrNotApplicable(value: string): string {\n  const sentinel = value.replace(/\\s/g, '').toUpperCase()\n  if (sentinel === 'NA') return NOT_APPLICABLE_VALUE\n  if (sentinel === 'N' || sentinel === 'N/' || sentinel === NOT_APPLICABLE_VALUE) return sentinel\n  return normalizeSSN(value)\n}\n\n/**\n * Form-field name for the synthesized federal tax classification radio group.\n *\n * @internal\n */\nexport const TAX_CLASSIFICATION_FIELD = 'taxClassification'\n\n/**\n * Form-field name for the synthesized LLC tax classification code select.\n *\n * @internal\n */\nexport const LLC_CLASSIFICATION_FIELD = 'llcClassificationCode'\n\n/**\n * Form-field name for the \"Other\" free-text classification field.\n *\n * @internal\n */\nexport const OTHER_TEXT_FIELD = 'otherText'\n\n/**\n * Ordered classification option keys backing the {@link TAX_CLASSIFICATION_FIELD}\n * radio group. Each maps to a W-9 checkbox field on the underlying document.\n *\n * @internal\n */\nexport const TAX_CLASSIFICATION_OPTION_KEYS = [\n  'individual_proprietor',\n  'c_corporation',\n  's_corporation',\n  'partnership',\n  'trust_estate',\n  'limited_liability_company',\n  'other',\n] as const\n\n/**\n * A single federal tax classification option key.\n *\n * @internal\n */\nexport type TaxClassificationOptionKey = (typeof TAX_CLASSIFICATION_OPTION_KEYS)[number]\n\n/**\n * The classification option that reveals the LLC tax classification select.\n *\n * @internal\n */\nexport const LLC_CLASSIFICATION_OPTION: TaxClassificationOptionKey = 'limited_liability_company'\n\n/**\n * The classification option that reveals the \"Other\" free-text field.\n *\n * @internal\n */\nexport const OTHER_CLASSIFICATION_OPTION: TaxClassificationOptionKey = 'other'\n\n/**\n * Ordered LLC tax classification code options.\n *\n * @internal\n */\nexport const LLC_CLASSIFICATION_CODES = ['c', 's', 'p'] as const\n\n/**\n * Maps each pass-through {@link ContractorSignatureFormData} field to its W-9\n * API field key. Synthesized fields (`taxClassification`,\n * `llcClassificationCode`) and `agree` are intentionally absent.\n *\n * @internal\n */\nexport const W9_FIELD_API_KEYS = {\n  name: 'name',\n  businessName: 'business_name',\n  otherText: 'other_text',\n  foreignPartners: 'foreign_partners',\n  exemptPayeeCode: 'exempt_payee_code',\n  exemptionFromFatca: 'exemption_from_FATCA',\n  homeAddressStreet1: 'home_address_street_1',\n  homeAddressStreet2: 'home_address_street_2',\n  homeAddressCity: 'home_address_city',\n  homeAddressState: 'home_address_state',\n  homeAddressZip: 'home_address_zip',\n  accountNumber: 'account_number',\n  companyName: 'company_name',\n  ssn: 'ssn',\n  ein: 'ein',\n  signatureText: 'signature_text',\n} as const satisfies Record<string, string>\n\n/** A pass-through W-9 field name (one with a single backing API key). */\ntype PassThroughFieldName = keyof typeof W9_FIELD_API_KEYS\n\n/** API field keys whose values are sensitive and arrive masked when on file. */\nconst SENSITIVE_FIELD_KEYS = new Set(['ssn', 'ein'])\n\n/** Whether a value is a server-side mask (e.g. `XXX-XX-1111`) rather than real input. */\nfunction isMaskedValue(value: string | null | undefined): boolean {\n  return typeof value === 'string' && /[X•*]/.test(value)\n}\n\n/** Whether a document field carries a redacted (masked) sensitive value. */\nfunction hasRedactedValue(field: DocumentField | undefined): boolean {\n  if (!field) return false\n  const isSensitive =\n    SENSITIVE_FIELD_KEYS.has(field.key ?? '') ||\n    field.dataType === 'ssn' ||\n    field.dataType === 'ein'\n  return isSensitive && isMaskedValue(field.value)\n}\n\nfunction indexFields(document: Document): Map<string, DocumentField> {\n  const byKey = new Map<string, DocumentField>()\n  for (const field of document.fields ?? []) {\n    if (field.key) byKey.set(field.key, field)\n  }\n  return byKey\n}\n\n/** Coerces an API checkbox value (`'1'`, `'true'`) to a boolean. */\nfunction toBoolean(value: string | null | undefined): boolean {\n  return value === '1' || value === 'true'\n}\n\n/**\n * Whether the document is a W-9 (the only signable contractor document type).\n *\n * @internal\n */\nexport function isW9Document(document: Document): boolean {\n  return document.name === W9_DOCUMENT_NAME\n}\n\n/**\n * Redaction state for the sensitive W-9 fields, derived from the API response.\n *\n * @internal\n */\nexport interface W9RedactionState {\n  /** Whether the API returned a masked SSN value. */\n  ssnRedacted: boolean\n  /** Whether the API returned a masked EIN value. */\n  einRedacted: boolean\n  /** The masked SSN to surface as a placeholder, when redacted. */\n  ssnPlaceholder?: string\n  /** The masked EIN to surface as a placeholder, when redacted. */\n  einPlaceholder?: string\n}\n\n/**\n * Computes the redaction state of the SSN/EIN fields from the document.\n *\n * @param document - The W-9 document returned by the API.\n * @returns The redaction flags and masked placeholders.\n * @internal\n */\nexport function getRedactionState(document: Document): W9RedactionState {\n  const byKey = indexFields(document)\n  const ssnField = byKey.get('ssn')\n  const einField = byKey.get('ein')\n  const ssnRedacted = hasRedactedValue(ssnField)\n  const einRedacted = hasRedactedValue(einField)\n  return {\n    ssnRedacted,\n    einRedacted,\n    ssnPlaceholder: ssnRedacted ? (ssnField?.value ?? undefined) : undefined,\n    einPlaceholder: einRedacted ? (einField?.value ?? undefined) : undefined,\n  }\n}\n\n/**\n * Computes which W-9 form fields the API actually returned — the safety check\n * that drives presence-gating in {@link useContractorSignatureForm}.\n *\n * @remarks\n * A pass-through field is present when its API key is in `document.fields`. The\n * synthesized classification fields (`taxClassification`,\n * `llcClassificationCode`) are present when the document carries any of the\n * federal tax classification checkbox fields.\n *\n * @param document - The W-9 document returned by the API.\n * @returns The set of present camelCase field names.\n * @internal\n */\nexport function getPresentFieldNames(document: Document): Set<string> {\n  const byKey = indexFields(document)\n  const presentFieldNames = new Set<string>()\n\n  for (const [fieldName, apiKey] of Object.entries(W9_FIELD_API_KEYS)) {\n    if (byKey.has(apiKey)) presentFieldNames.add(fieldName)\n  }\n\n  const hasClassification = TAX_CLASSIFICATION_OPTION_KEYS.some(key => byKey.has(key))\n  if (hasClassification) {\n    presentFieldNames.add(TAX_CLASSIFICATION_FIELD)\n    presentFieldNames.add(LLC_CLASSIFICATION_FIELD)\n  }\n\n  return presentFieldNames\n}\n\n/**\n * Builds default form values from a document's fields.\n *\n * @remarks\n * Pass-through values are seeded from the API `value`. The classification radio\n * defaults to whichever classification checkbox is already set (`'1'`/`'true'`),\n * and when that is the LLC classification the LLC code select is seeded from the\n * `tax_classification` field it serializes into. A masked SSN/EIN seeds an empty\n * input (the mask is surfaced as a placeholder instead) so it is never echoed\n * back as the new value on submit.\n *\n * @param document - The W-9 document returned by the API.\n * @returns The default form values.\n * @internal\n */\nexport function buildW9Defaults(document: Document): ContractorSignatureFormData {\n  const byKey = indexFields(document)\n  const redaction = getRedactionState(document)\n  const textValue = (apiKey: string): string => byKey.get(apiKey)?.value ?? ''\n  const selectedClassification =\n    TAX_CLASSIFICATION_OPTION_KEYS.find(key => toBoolean(byKey.get(key)?.value)) ?? ''\n\n  return {\n    name: textValue('name'),\n    businessName: textValue('business_name'),\n    taxClassification: selectedClassification,\n    // The LLC code serializes into the `tax_classification` field, so seed it\n    // back from there when the LLC classification is the selected one.\n    llcClassificationCode:\n      selectedClassification === LLC_CLASSIFICATION_OPTION ? textValue('tax_classification') : '',\n    otherText: textValue('other_text'),\n    foreignPartners: toBoolean(byKey.get('foreign_partners')?.value),\n    exemptPayeeCode: textValue('exempt_payee_code'),\n    exemptionFromFatca: textValue('exemption_from_FATCA'),\n    homeAddressStreet1: textValue('home_address_street_1'),\n    homeAddressStreet2: textValue('home_address_street_2'),\n    homeAddressCity: textValue('home_address_city'),\n    homeAddressState: textValue('home_address_state'),\n    homeAddressZip: textValue('home_address_zip'),\n    accountNumber: textValue('account_number'),\n    companyName: textValue('company_name'),\n    ssn: redaction.ssnRedacted ? '' : textValue('ssn'),\n    ein: redaction.einRedacted ? '' : textValue('ein'),\n    signatureText: textValue('signature_text'),\n    agree: false,\n  }\n}\n\n/**\n * The empty default form values, used while the document is still loading.\n *\n * @internal\n */\nexport const EMPTY_W9_DEFAULTS: ContractorSignatureFormData = {\n  name: '',\n  businessName: '',\n  taxClassification: '',\n  llcClassificationCode: '',\n  otherText: '',\n  foreignPartners: false,\n  exemptPayeeCode: '',\n  exemptionFromFatca: '',\n  homeAddressStreet1: '',\n  homeAddressStreet2: '',\n  homeAddressCity: '',\n  homeAddressState: '',\n  homeAddressZip: '',\n  accountNumber: '',\n  companyName: '',\n  ssn: '',\n  ein: '',\n  signatureText: '',\n  agree: false,\n}\n\n/**\n * A single `{ key, value }` pair sent in the sign request.\n *\n * @internal\n */\nexport interface SignFieldValue {\n  /** The API field key. */\n  key: string\n  /** The serialized field value. */\n  value: string\n}\n\n/** Pass-through text fields serialized verbatim (everything except the checkbox and TIN fields). */\nconst TEXT_PASS_THROUGH_FIELDS: PassThroughFieldName[] = [\n  'name',\n  'businessName',\n  'exemptPayeeCode',\n  'exemptionFromFatca',\n  'homeAddressStreet1',\n  'homeAddressStreet2',\n  'homeAddressCity',\n  'homeAddressState',\n  'homeAddressZip',\n  'accountNumber',\n  'companyName',\n  'signatureText',\n]\n\n/**\n * Serializes W-9 form values into the `{ key, value }` field array expected by\n * the sign API.\n *\n * @remarks\n * Only fields the API returned (see {@link getPresentFieldNames}) are sent.\n * Applies the W-9 mapping: the chosen classification key is sent with value\n * `'1'`; when the LLC classification is chosen, the selected LLC code is sent\n * under the `tax_classification` key. `foreignPartners` serializes to\n * `'1'`/`'0'`. The `otherText` value is only included for the \"Other\"\n * classification. An untouched redacted SSN/EIN is omitted so the mask is never\n * sent back. The `date` field is intentionally omitted so the API auto-fills the\n * signing date in its own locale-correct format.\n *\n * @param document - The W-9 document being signed.\n * @param values - The validated form values.\n * @param redaction - The redaction state from {@link getRedactionState}.\n * @returns The ordered field array for the sign request body.\n * @internal\n */\nexport function serializeW9Fields(\n  document: Document,\n  values: ContractorSignatureFormData,\n  redaction: W9RedactionState,\n): SignFieldValue[] {\n  const presentFieldNames = getPresentFieldNames(document)\n  const fields: SignFieldValue[] = []\n  // The schema preprocesses empty inputs to `undefined`, so read through an\n  // `unknown` view and coalesce missing values to an empty string.\n  const raw = values as Record<string, unknown>\n  const text = (name: string): string => {\n    const value = raw[name]\n    return typeof value === 'string' ? value : ''\n  }\n  const classification = text('taxClassification')\n\n  const pushField = (fieldName: PassThroughFieldName, value: string) => {\n    fields.push({ key: W9_FIELD_API_KEYS[fieldName], value })\n  }\n\n  for (const fieldName of TEXT_PASS_THROUGH_FIELDS) {\n    if (!presentFieldNames.has(fieldName)) continue\n    pushField(fieldName, text(fieldName))\n  }\n\n  if (presentFieldNames.has(OTHER_TEXT_FIELD) && classification === OTHER_CLASSIFICATION_OPTION) {\n    pushField('otherText', text('otherText'))\n  }\n\n  if (presentFieldNames.has('foreignPartners')) {\n    fields.push({\n      key: W9_FIELD_API_KEYS.foreignPartners,\n      value: values.foreignPartners ? '1' : '0',\n    })\n  }\n\n  // A redacted field left untouched is omitted so the masked value isn't sent\n  // back as a replacement; the server keeps the value already on file.\n  const ssnValue = text('ssn')\n  const einValue = text('ein')\n  if (presentFieldNames.has('ssn') && !(redaction.ssnRedacted && ssnValue === '')) {\n    pushField('ssn', ssnValue)\n  }\n  if (presentFieldNames.has('ein') && !(redaction.einRedacted && einValue === '')) {\n    pushField('ein', einValue)\n  }\n\n  if (classification) {\n    fields.push({ key: classification, value: '1' })\n    if (classification === LLC_CLASSIFICATION_OPTION) {\n      fields.push({ key: 'tax_classification', value: text('llcClassificationCode') })\n    }\n  }\n\n  return fields\n}\n"],"names":["NOT_APPLICABLE_VALUE","normalizeEinOrNotApplicable","value","sentinel","normalizeEin","normalizeSsnOrNotApplicable","normalizeSSN","TAX_CLASSIFICATION_FIELD","LLC_CLASSIFICATION_FIELD","OTHER_TEXT_FIELD","TAX_CLASSIFICATION_OPTION_KEYS","LLC_CLASSIFICATION_OPTION","OTHER_CLASSIFICATION_OPTION","LLC_CLASSIFICATION_CODES","W9_FIELD_API_KEYS","SENSITIVE_FIELD_KEYS","isMaskedValue","hasRedactedValue","field","indexFields","document","byKey","toBoolean","getRedactionState","ssnField","einField","ssnRedacted","einRedacted","getPresentFieldNames","presentFieldNames","fieldName","apiKey","key","buildW9Defaults","redaction","textValue","selectedClassification","EMPTY_W9_DEFAULTS","TEXT_PASS_THROUGH_FIELDS","serializeW9Fields","values","fields","raw","text","name","classification","pushField","ssnValue","einValue"],"mappings":"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"}
+{"version":3,"file":"w9Fields.js","sources":["../../../../../../src/components/Contractor/Documents/SignatureForm/useContractorSignatureForm/w9Fields.ts"],"sourcesContent":["import type {\n  Document,\n  Fields as DocumentField,\n} from '@gusto/embedded-api/models/components/document'\nimport type { ContractorSignatureFormData } from './contractorSignatureFormSchema'\nimport { normalizeEin } from '@/helpers/federalEin'\nimport { normalizeSSN } from '@/helpers/ssn'\n\n/**\n * The `name` of the W-9 document — the only contractor document type that\n * supports signing today.\n *\n * @internal\n */\nexport const W9_DOCUMENT_NAME = 'taxpayer_identification_form_w_9'\n\n/**\n * Sentinel the API returns (and accepts) for a taxpayer-ID field that doesn't\n * apply to the signer — e.g. the EIN of an individual contractor, or the SSN of\n * a business contractor. The sign endpoint stamps this verbatim, so the form\n * both prefills it and treats it as a valid submission.\n *\n * @internal\n */\nexport const NOT_APPLICABLE_VALUE = 'N/A'\n\n/**\n * EIN input transform that preserves the `N/A` sentinel (and the in-progress\n * prefixes a user types toward it) while formatting numeric input as a standard\n * EIN (`NN-NNNNNNN`).\n *\n * @remarks\n * The W-9 accepts `N/A` for a taxpayer who supplies an SSN instead of an EIN,\n * but the plain `normalizeEin` formatter strips every non-digit on each\n * keystroke — making the sentinel impossible to type. This wrapper lets the\n * sentinel through (normalized to uppercase) and defers to `normalizeEin` for\n * everything else.\n *\n * @param value - Raw user input.\n * @returns The `N/A` sentinel (or an in-progress prefix), otherwise the EIN-formatted value.\n * @internal\n */\nexport function normalizeEinOrNotApplicable(value: string): string {\n  const sentinel = value.replace(/\\s/g, '').toUpperCase()\n  if (sentinel === 'NA') return NOT_APPLICABLE_VALUE\n  if (sentinel === 'N' || sentinel === 'N/' || sentinel === NOT_APPLICABLE_VALUE) return sentinel\n  return normalizeEin(value)\n}\n\n/**\n * SSN input transform that preserves the `N/A` sentinel (and the in-progress\n * prefixes `N` and `N/`) while otherwise deferring to {@link normalizeSSN}.\n *\n * @remarks\n * The W-9 accepts `N/A` for a taxpayer who supplies an EIN instead of an SSN,\n * but the plain `normalizeSSN` formatter strips every non-digit on each\n * keystroke — making the sentinel impossible to type. This wrapper lets the\n * sentinel through (normalized to uppercase) and defers to `normalizeSSN` for\n * everything else.\n *\n * @param value - Raw user input.\n * @returns The `N/A` sentinel (or an in-progress prefix), otherwise the SSN-formatted value.\n * @internal\n */\nexport function normalizeSsnOrNotApplicable(value: string): string {\n  const sentinel = value.replace(/\\s/g, '').toUpperCase()\n  if (sentinel === 'NA') return NOT_APPLICABLE_VALUE\n  if (sentinel === 'N' || sentinel === 'N/' || sentinel === NOT_APPLICABLE_VALUE) return sentinel\n  return normalizeSSN(value)\n}\n\n/**\n * Form-field name for the synthesized federal tax classification radio group.\n *\n * @internal\n */\nexport const TAX_CLASSIFICATION_FIELD = 'taxClassification'\n\n/**\n * Form-field name for the synthesized LLC tax classification code select.\n *\n * @internal\n */\nexport const LLC_CLASSIFICATION_FIELD = 'llcClassificationCode'\n\n/**\n * Form-field name for the \"Other\" free-text classification field.\n *\n * @internal\n */\nexport const OTHER_TEXT_FIELD = 'otherText'\n\n/**\n * Ordered classification option keys backing the {@link TAX_CLASSIFICATION_FIELD}\n * radio group. Each maps to a W-9 checkbox field on the underlying document.\n *\n * @internal\n */\nexport const TAX_CLASSIFICATION_OPTION_KEYS = [\n  'individual_proprietor',\n  'c_corporation',\n  's_corporation',\n  'partnership',\n  'trust_estate',\n  'limited_liability_company',\n  'other',\n] as const\n\n/**\n * A single federal tax classification option key.\n *\n * @internal\n */\nexport type TaxClassificationOptionKey = (typeof TAX_CLASSIFICATION_OPTION_KEYS)[number]\n\n/**\n * The classification option that reveals the LLC tax classification select.\n *\n * @internal\n */\nexport const LLC_CLASSIFICATION_OPTION: TaxClassificationOptionKey = 'limited_liability_company'\n\n/**\n * The classification option that reveals the \"Other\" free-text field.\n *\n * @internal\n */\nexport const OTHER_CLASSIFICATION_OPTION: TaxClassificationOptionKey = 'other'\n\n/**\n * Ordered LLC tax classification code options.\n *\n * @internal\n */\nexport const LLC_CLASSIFICATION_CODES = ['c', 's', 'p'] as const\n\n/**\n * Maps each pass-through {@link ContractorSignatureFormData} field to its W-9\n * API field key. Synthesized fields (`taxClassification`,\n * `llcClassificationCode`) and `agree` are intentionally absent.\n *\n * @internal\n */\nexport const W9_FIELD_API_KEYS = {\n  name: 'name',\n  businessName: 'business_name',\n  otherText: 'other_text',\n  foreignPartners: 'foreign_partners',\n  exemptPayeeCode: 'exempt_payee_code',\n  exemptionFromFatca: 'exemption_from_FATCA',\n  homeAddressStreet1: 'home_address_street_1',\n  homeAddressStreet2: 'home_address_street_2',\n  homeAddressCity: 'home_address_city',\n  homeAddressState: 'home_address_state',\n  homeAddressZip: 'home_address_zip',\n  accountNumber: 'account_number',\n  companyName: 'company_name',\n  ssn: 'ssn',\n  ein: 'ein',\n  signatureText: 'signature_text',\n} as const satisfies Record<string, string>\n\n/** A pass-through W-9 field name (one with a single backing API key). */\ntype PassThroughFieldName = keyof typeof W9_FIELD_API_KEYS\n\n/** API field keys whose values are sensitive and arrive masked when on file. */\nconst SENSITIVE_FIELD_KEYS = new Set(['ssn', 'ein'])\n\n/** Whether a value is a server-side mask (e.g. `XXX-XX-1111`) rather than real input. */\nfunction isMaskedValue(value: string | null | undefined): boolean {\n  return typeof value === 'string' && /[X•*]/.test(value)\n}\n\n/** Whether a document field carries a redacted (masked) sensitive value. */\nfunction hasRedactedValue(field: DocumentField | undefined): boolean {\n  if (!field) return false\n  const isSensitive =\n    SENSITIVE_FIELD_KEYS.has(field.key ?? '') ||\n    field.dataType === 'ssn' ||\n    field.dataType === 'ein'\n  return isSensitive && isMaskedValue(field.value)\n}\n\nfunction indexFields(document: Document): Map<string, DocumentField> {\n  const byKey = new Map<string, DocumentField>()\n  for (const field of document.fields ?? []) {\n    if (field.key) byKey.set(field.key, field)\n  }\n  return byKey\n}\n\n/** Coerces an API checkbox value (`'1'`, `'true'`) to a boolean. */\nfunction toBoolean(value: string | null | undefined): boolean {\n  return value === '1' || value === 'true'\n}\n\n/**\n * Whether the document is a W-9 (the only signable contractor document type).\n *\n * @internal\n */\nexport function isW9Document(document: Document): boolean {\n  return document.name === W9_DOCUMENT_NAME\n}\n\n/**\n * Redaction state for the sensitive W-9 fields, derived from the API response.\n *\n * @internal\n */\nexport interface W9RedactionState {\n  /** Whether the API returned a masked SSN value. */\n  ssnRedacted: boolean\n  /** Whether the API returned a masked EIN value. */\n  einRedacted: boolean\n  /** The masked SSN to surface as a placeholder, when redacted. */\n  ssnPlaceholder?: string\n  /** The masked EIN to surface as a placeholder, when redacted. */\n  einPlaceholder?: string\n}\n\n/**\n * Computes the redaction state of the SSN/EIN fields from the document.\n *\n * @param document - The W-9 document returned by the API.\n * @returns The redaction flags and masked placeholders.\n * @internal\n */\nexport function getRedactionState(document: Document): W9RedactionState {\n  const byKey = indexFields(document)\n  const ssnField = byKey.get('ssn')\n  const einField = byKey.get('ein')\n  const ssnRedacted = hasRedactedValue(ssnField)\n  const einRedacted = hasRedactedValue(einField)\n  return {\n    ssnRedacted,\n    einRedacted,\n    ssnPlaceholder: ssnRedacted ? (ssnField?.value ?? undefined) : undefined,\n    einPlaceholder: einRedacted ? (einField?.value ?? undefined) : undefined,\n  }\n}\n\n/**\n * Computes which W-9 form fields the API actually returned — the safety check\n * that drives presence-gating in {@link useContractorSignatureForm}.\n *\n * @remarks\n * A pass-through field is present when its API key is in `document.fields`. The\n * synthesized classification fields (`taxClassification`,\n * `llcClassificationCode`) are present when the document carries any of the\n * federal tax classification checkbox fields.\n *\n * @param document - The W-9 document returned by the API.\n * @returns The set of present camelCase field names.\n * @internal\n */\nexport function getPresentFieldNames(document: Document): Set<string> {\n  const byKey = indexFields(document)\n  const presentFieldNames = new Set<string>()\n\n  for (const [fieldName, apiKey] of Object.entries(W9_FIELD_API_KEYS)) {\n    if (byKey.has(apiKey)) presentFieldNames.add(fieldName)\n  }\n\n  const hasClassification = TAX_CLASSIFICATION_OPTION_KEYS.some(key => byKey.has(key))\n  if (hasClassification) {\n    presentFieldNames.add(TAX_CLASSIFICATION_FIELD)\n    presentFieldNames.add(LLC_CLASSIFICATION_FIELD)\n  }\n\n  return presentFieldNames\n}\n\n/**\n * Builds default form values from a document's fields.\n *\n * @remarks\n * Pass-through values are seeded from the API `value`. The classification radio\n * defaults to whichever classification checkbox is already set (`'1'`/`'true'`),\n * and when that is the LLC classification the LLC code select is seeded from the\n * `tax_classification` field it serializes into. A masked SSN/EIN seeds an empty\n * input (the mask is surfaced as a placeholder instead) so it is never echoed\n * back as the new value on submit.\n *\n * @param document - The W-9 document returned by the API.\n * @returns The default form values.\n * @internal\n */\nexport function buildW9Defaults(document: Document): ContractorSignatureFormData {\n  const byKey = indexFields(document)\n  const redaction = getRedactionState(document)\n  const textValue = (apiKey: string): string => byKey.get(apiKey)?.value ?? ''\n  const selectedClassification =\n    TAX_CLASSIFICATION_OPTION_KEYS.find(key => toBoolean(byKey.get(key)?.value)) ?? ''\n\n  return {\n    name: textValue('name'),\n    businessName: textValue('business_name'),\n    taxClassification: selectedClassification,\n    // The LLC code serializes into the `tax_classification` field, so seed it\n    // back from there when the LLC classification is the selected one.\n    llcClassificationCode:\n      selectedClassification === LLC_CLASSIFICATION_OPTION ? textValue('tax_classification') : '',\n    otherText: textValue('other_text'),\n    foreignPartners: toBoolean(byKey.get('foreign_partners')?.value),\n    exemptPayeeCode: textValue('exempt_payee_code'),\n    exemptionFromFatca: textValue('exemption_from_FATCA'),\n    homeAddressStreet1: textValue('home_address_street_1'),\n    homeAddressStreet2: textValue('home_address_street_2'),\n    homeAddressCity: textValue('home_address_city'),\n    homeAddressState: textValue('home_address_state'),\n    homeAddressZip: textValue('home_address_zip'),\n    accountNumber: textValue('account_number'),\n    companyName: textValue('company_name'),\n    ssn: redaction.ssnRedacted ? '' : textValue('ssn'),\n    ein: redaction.einRedacted ? '' : textValue('ein'),\n    signatureText: textValue('signature_text'),\n    agree: false,\n  }\n}\n\n/**\n * The empty default form values, used while the document is still loading.\n *\n * @internal\n */\nexport const EMPTY_W9_DEFAULTS: ContractorSignatureFormData = {\n  name: '',\n  businessName: '',\n  taxClassification: '',\n  llcClassificationCode: '',\n  otherText: '',\n  foreignPartners: false,\n  exemptPayeeCode: '',\n  exemptionFromFatca: '',\n  homeAddressStreet1: '',\n  homeAddressStreet2: '',\n  homeAddressCity: '',\n  homeAddressState: '',\n  homeAddressZip: '',\n  accountNumber: '',\n  companyName: '',\n  ssn: '',\n  ein: '',\n  signatureText: '',\n  agree: false,\n}\n\n/**\n * A single `{ key, value }` pair sent in the sign request.\n *\n * @internal\n */\nexport interface SignFieldValue {\n  /** The API field key. */\n  key: string\n  /** The serialized field value. */\n  value: string\n}\n\n/** Pass-through text fields serialized verbatim (everything except the checkbox and TIN fields). */\nconst TEXT_PASS_THROUGH_FIELDS: PassThroughFieldName[] = [\n  'name',\n  'businessName',\n  'exemptPayeeCode',\n  'exemptionFromFatca',\n  'homeAddressStreet1',\n  'homeAddressStreet2',\n  'homeAddressCity',\n  'homeAddressState',\n  'homeAddressZip',\n  'accountNumber',\n  'companyName',\n  'signatureText',\n]\n\n/**\n * Serializes W-9 form values into the `{ key, value }` field array expected by\n * the sign API.\n *\n * @remarks\n * Only fields the API returned (see {@link getPresentFieldNames}) are sent.\n * Applies the W-9 mapping: the chosen classification key is sent with value\n * `'1'`; when the LLC classification is chosen, the selected LLC code is sent\n * under the `tax_classification` key. `foreignPartners` serializes to\n * `'1'`/`'0'`. The `otherText` value is only included for the \"Other\"\n * classification. An untouched redacted SSN/EIN is omitted so the mask is never\n * sent back. The `date` field is intentionally omitted so the API auto-fills the\n * signing date in its own locale-correct format.\n *\n * @param document - The W-9 document being signed.\n * @param values - The validated form values.\n * @param redaction - The redaction state from {@link getRedactionState}.\n * @returns The ordered field array for the sign request body.\n * @internal\n */\nexport function serializeW9Fields(\n  document: Document,\n  values: ContractorSignatureFormData,\n  redaction: W9RedactionState,\n): SignFieldValue[] {\n  const presentFieldNames = getPresentFieldNames(document)\n  const fields: SignFieldValue[] = []\n  // The schema preprocesses empty inputs to `undefined`, so read through an\n  // `unknown` view and coalesce missing values to an empty string.\n  const raw = values as Record<string, unknown>\n  const text = (name: string): string => {\n    const value = raw[name]\n    return typeof value === 'string' ? value : ''\n  }\n  const classification = text('taxClassification')\n\n  const pushField = (fieldName: PassThroughFieldName, value: string) => {\n    fields.push({ key: W9_FIELD_API_KEYS[fieldName], value })\n  }\n\n  for (const fieldName of TEXT_PASS_THROUGH_FIELDS) {\n    if (!presentFieldNames.has(fieldName)) continue\n    pushField(fieldName, text(fieldName))\n  }\n\n  if (presentFieldNames.has(OTHER_TEXT_FIELD) && classification === OTHER_CLASSIFICATION_OPTION) {\n    pushField('otherText', text('otherText'))\n  }\n\n  if (presentFieldNames.has('foreignPartners')) {\n    fields.push({\n      key: W9_FIELD_API_KEYS.foreignPartners,\n      value: values.foreignPartners ? '1' : '0',\n    })\n  }\n\n  // A redacted field left untouched is omitted so the masked value isn't sent\n  // back as a replacement; the server keeps the value already on file.\n  const ssnValue = text('ssn')\n  const einValue = text('ein')\n  if (presentFieldNames.has('ssn') && !(redaction.ssnRedacted && ssnValue === '')) {\n    pushField('ssn', ssnValue)\n  }\n  if (presentFieldNames.has('ein') && !(redaction.einRedacted && einValue === '')) {\n    pushField('ein', einValue)\n  }\n\n  if (classification) {\n    fields.push({ key: classification, value: '1' })\n    if (classification === LLC_CLASSIFICATION_OPTION) {\n      fields.push({ key: 'tax_classification', value: text('llcClassificationCode') })\n    }\n  }\n\n  return fields\n}\n"],"names":["W9_DOCUMENT_NAME","NOT_APPLICABLE_VALUE","normalizeEinOrNotApplicable","value","sentinel","normalizeEin","normalizeSsnOrNotApplicable","normalizeSSN","TAX_CLASSIFICATION_FIELD","LLC_CLASSIFICATION_FIELD","OTHER_TEXT_FIELD","TAX_CLASSIFICATION_OPTION_KEYS","LLC_CLASSIFICATION_OPTION","OTHER_CLASSIFICATION_OPTION","LLC_CLASSIFICATION_CODES","W9_FIELD_API_KEYS","SENSITIVE_FIELD_KEYS","isMaskedValue","hasRedactedValue","field","indexFields","document","byKey","toBoolean","getRedactionState","ssnField","einField","ssnRedacted","einRedacted","getPresentFieldNames","presentFieldNames","fieldName","apiKey","key","buildW9Defaults","redaction","textValue","selectedClassification","EMPTY_W9_DEFAULTS","TEXT_PASS_THROUGH_FIELDS","serializeW9Fields","values","fields","raw","text","name","classification","pushField","ssnValue","einValue"],"mappings":"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"}

package/dist/components/Contractor/Landing/Landing.js

@@ -1,7 +1,7 @@
 import { jsx as n, jsxs as r } from "react/jsx-runtime";
 import { useTranslation as h } from "react-i18next";
-import { useContractorsGetSuspense as g } from "@gusto/embedded-api-v-2026-02-01/react-query/contractorsGet";
-import { useCompaniesGetSuspense as C } from "@gusto/embedded-api-v-2026-02-01/react-query/companiesGet";
+import { useContractorsGetSuspense as g } from "@gusto/embedded-api/react-query/contractorsGet";
+import { useCompaniesGetSuspense as C } from "@gusto/embedded-api/react-query/companiesGet";
 import c from "dompurify";
 import { useMemo as m } from "react";
 import { BaseComponent as x } from "../../Base/Base.js";

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

@@ -1 +1 @@
-{"version":3,"file":"Landing.js","sources":["../../../../src/components/Contractor/Landing/Landing.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport { useContractorsGetSuspense } from '@gusto/embedded-api-v-2026-02-01/react-query/contractorsGet'\nimport { useCompaniesGetSuspense } from '@gusto/embedded-api-v-2026-02-01/react-query/companiesGet'\nimport DOMPurify from 'dompurify'\nimport { useMemo } from 'react'\nimport { BaseComponent, useBase, type BaseComponentInterface } from '@/components/Base'\nimport { Flex, ActionsLayout } from '@/components/Common'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { useI18n } from '@/i18n'\nimport { componentEvents } from '@/shared/constants'\nimport { useComponentDictionary } from '@/i18n/I18n'\nimport ArrowRightIcon from '@/assets/icons/icon-arrow-right.svg?react'\n\n/**\n * Props for the {@link Landing} component.\n *\n * @public\n */\nexport interface LandingProps extends BaseComponentInterface<'Contractor.Landing'> {\n  /** UUID of the contractor entering the self-onboarding flow. */\n  contractorId: string\n  /** UUID of the company the contractor belongs to. */\n  companyId: string\n}\n\n/**\n * Landing page for the contractor self-onboarding flow. Displays a welcome\n * message and the list of onboarding steps the contractor needs to complete.\n *\n * @public\n */\nexport function Landing(props: LandingProps) {\n  useI18n('Contractor.Landing')\n  useComponentDictionary('Contractor.Landing', props.dictionary)\n\n  return (\n    <BaseComponent {...props}>\n      <Root {...props}>{props.children}</Root>\n    </BaseComponent>\n  )\n}\n\nconst Root = ({ contractorId, companyId, className }: LandingProps) => {\n  const { onEvent } = useBase()\n  const Components = useComponentContext()\n\n  const { t } = useTranslation('Contractor.Landing')\n\n  const {\n    data: { contractor },\n  } = useContractorsGetSuspense({ contractorUuid: contractorId })\n  const sanitizedContractorName = useMemo(\n    () =>\n      DOMPurify.sanitize(contractor?.firstName ?? contractor?.businessName ?? t('fallbackName')),\n    [contractor, t],\n  )\n\n  const {\n    data: { company },\n  } = useCompaniesGetSuspense({ companyId })\n  const sanitizedCompanyName = useMemo(() => DOMPurify.sanitize(company?.name ?? ''), [company])\n\n  return (\n    <section className={className}>\n      <Components.Box\n        footer={\n          <ActionsLayout>\n            <Components.Button\n              variant=\"secondary\"\n              onClick={() => {\n                onEvent(componentEvents.CONTRACTOR_SELF_ONBOARDING_START)\n              }}\n            >\n              {t('getStartedCta')}\n              <ArrowRightIcon aria-hidden />\n            </Components.Button>\n          </ActionsLayout>\n        }\n      >\n        <Flex alignItems=\"center\" flexDirection=\"column\" gap={32}>\n          <Flex flexDirection=\"column\" gap={4}>\n            <Components.Heading as=\"h2\">\n              {t('landingSubtitle', {\n                contractorName: sanitizedContractorName,\n                companyName: sanitizedCompanyName,\n                interpolation: { escapeValue: false },\n              })}\n            </Components.Heading>\n            <Components.Text variant=\"supporting\">{t('landingDescription')}</Components.Text>\n          </Flex>\n          <Flex flexDirection=\"column\" gap={8}>\n            <Components.Heading as=\"h3\">{t('stepsSubtitle')}</Components.Heading>\n            <Components.UnorderedList\n              items={[\n                t('steps.profile'),\n                t('steps.address'),\n                t('steps.paymentMethod'),\n                t('steps.documents'),\n              ]}\n            />\n          </Flex>\n        </Flex>\n      </Components.Box>\n    </section>\n  )\n}\n"],"names":["Landing","props","useI18n","useComponentDictionary","jsx","BaseComponent","Root","contractorId","companyId","className","onEvent","useBase","Components","useComponentContext","useTranslation","contractor","useContractorsGetSuspense","sanitizedContractorName","useMemo","DOMPurify","company","useCompaniesGetSuspense","sanitizedCompanyName","ActionsLayout","jsxs","componentEvents","ArrowRightIcon","Flex"],"mappings":";;;;;;;;;;;;;;AA+BO,SAASA,EAAQC,GAAqB;AAC3C,SAAAC,EAAQ,oBAAoB,GAC5BC,EAAuB,sBAAsBF,EAAM,UAAU,GAG3D,gBAAAG,EAACC,GAAA,EAAe,GAAGJ,GACjB,UAAA,gBAAAG,EAACE,KAAM,GAAGL,GAAQ,UAAAA,EAAM,SAAA,CAAS,EAAA,CACnC;AAEJ;AAEA,MAAMK,IAAO,CAAC,EAAE,cAAAC,GAAc,WAAAC,GAAW,WAAAC,QAA8B;AACrE,QAAM,EAAE,SAAAC,EAAA,IAAYC,EAAA,GACdC,IAAaC,EAAA,GAEb,EAAE,EAAA,IAAMC,EAAe,oBAAoB,GAE3C;AAAA,IACJ,MAAM,EAAE,YAAAC,EAAA;AAAA,EAAW,IACjBC,EAA0B,EAAE,gBAAgBT,GAAc,GACxDU,IAA0BC;AAAA,IAC9B,MACEC,EAAU,SAASJ,GAAY,aAAaA,GAAY,gBAAgB,EAAE,cAAc,CAAC;AAAA,IAC3F,CAACA,GAAY,CAAC;AAAA,EAAA,GAGV;AAAA,IACJ,MAAM,EAAE,SAAAK,EAAA;AAAA,EAAQ,IACdC,EAAwB,EAAE,WAAAb,GAAW,GACnCc,IAAuBJ,EAAQ,MAAMC,EAAU,SAASC,GAAS,QAAQ,EAAE,GAAG,CAACA,CAAO,CAAC;AAE7F,SACE,gBAAAhB,EAAC,aAAQ,WAAAK,GACP,UAAA,gBAAAL;AAAA,IAACQ,EAAW;AAAA,IAAX;AAAA,MACC,0BACGW,GAAA,EACC,UAAA,gBAAAC;AAAA,QAACZ,EAAW;AAAA,QAAX;AAAA,UACC,SAAQ;AAAA,UACR,SAAS,MAAM;AACb,YAAAF,EAAQe,EAAgB,gCAAgC;AAAA,UAC1D;AAAA,UAEC,UAAA;AAAA,YAAA,EAAE,eAAe;AAAA,YAClB,gBAAArB,EAACsB,GAAA,EAAe,eAAW,GAAA,CAAC;AAAA,UAAA;AAAA,QAAA;AAAA,MAAA,GAEhC;AAAA,MAGF,4BAACC,GAAA,EAAK,YAAW,UAAS,eAAc,UAAS,KAAK,IACpD,UAAA;AAAA,QAAA,gBAAAH,EAACG,GAAA,EAAK,eAAc,UAAS,KAAK,GAChC,UAAA;AAAA,UAAA,gBAAAvB,EAACQ,EAAW,SAAX,EAAmB,IAAG,MACpB,YAAE,mBAAmB;AAAA,YACpB,gBAAgBK;AAAA,YAChB,aAAaK;AAAA,YACb,eAAe,EAAE,aAAa,GAAA;AAAA,UAAM,CACrC,GACH;AAAA,UACA,gBAAAlB,EAACQ,EAAW,MAAX,EAAgB,SAAQ,cAAc,UAAA,EAAE,oBAAoB,EAAA,CAAE;AAAA,QAAA,GACjE;AAAA,QACA,gBAAAY,EAACG,GAAA,EAAK,eAAc,UAAS,KAAK,GAChC,UAAA;AAAA,UAAA,gBAAAvB,EAACQ,EAAW,SAAX,EAAmB,IAAG,MAAM,UAAA,EAAE,eAAe,GAAE;AAAA,UAChD,gBAAAR;AAAA,YAACQ,EAAW;AAAA,YAAX;AAAA,cACC,OAAO;AAAA,gBACL,EAAE,eAAe;AAAA,gBACjB,EAAE,eAAe;AAAA,gBACjB,EAAE,qBAAqB;AAAA,gBACvB,EAAE,iBAAiB;AAAA,cAAA;AAAA,YACrB;AAAA,UAAA;AAAA,QACF,EAAA,CACF;AAAA,MAAA,EAAA,CACF;AAAA,IAAA;AAAA,EAAA,GAEJ;AAEJ;"}
+{"version":3,"file":"Landing.js","sources":["../../../../src/components/Contractor/Landing/Landing.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport { useContractorsGetSuspense } from '@gusto/embedded-api/react-query/contractorsGet'\nimport { useCompaniesGetSuspense } from '@gusto/embedded-api/react-query/companiesGet'\nimport DOMPurify from 'dompurify'\nimport { useMemo } from 'react'\nimport { BaseComponent, useBase, type BaseComponentInterface } from '@/components/Base'\nimport { Flex, ActionsLayout } from '@/components/Common'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { useI18n } from '@/i18n'\nimport { componentEvents } from '@/shared/constants'\nimport { useComponentDictionary } from '@/i18n/I18n'\nimport ArrowRightIcon from '@/assets/icons/icon-arrow-right.svg?react'\n\n/**\n * Props for the {@link Landing} component.\n *\n * @public\n */\nexport interface LandingProps extends BaseComponentInterface<'Contractor.Landing'> {\n  /** UUID of the contractor entering the self-onboarding flow. */\n  contractorId: string\n  /** UUID of the company the contractor belongs to. */\n  companyId: string\n}\n\n/**\n * Landing page for the contractor self-onboarding flow. Displays a welcome\n * message and the list of onboarding steps the contractor needs to complete.\n *\n * @public\n */\nexport function Landing(props: LandingProps) {\n  useI18n('Contractor.Landing')\n  useComponentDictionary('Contractor.Landing', props.dictionary)\n\n  return (\n    <BaseComponent {...props}>\n      <Root {...props}>{props.children}</Root>\n    </BaseComponent>\n  )\n}\n\nconst Root = ({ contractorId, companyId, className }: LandingProps) => {\n  const { onEvent } = useBase()\n  const Components = useComponentContext()\n\n  const { t } = useTranslation('Contractor.Landing')\n\n  const {\n    data: { contractor },\n  } = useContractorsGetSuspense({ contractorUuid: contractorId })\n  const sanitizedContractorName = useMemo(\n    () =>\n      DOMPurify.sanitize(contractor?.firstName ?? contractor?.businessName ?? t('fallbackName')),\n    [contractor, t],\n  )\n\n  const {\n    data: { company },\n  } = useCompaniesGetSuspense({ companyId })\n  const sanitizedCompanyName = useMemo(() => DOMPurify.sanitize(company?.name ?? ''), [company])\n\n  return (\n    <section className={className}>\n      <Components.Box\n        footer={\n          <ActionsLayout>\n            <Components.Button\n              variant=\"secondary\"\n              onClick={() => {\n                onEvent(componentEvents.CONTRACTOR_SELF_ONBOARDING_START)\n              }}\n            >\n              {t('getStartedCta')}\n              <ArrowRightIcon aria-hidden />\n            </Components.Button>\n          </ActionsLayout>\n        }\n      >\n        <Flex alignItems=\"center\" flexDirection=\"column\" gap={32}>\n          <Flex flexDirection=\"column\" gap={4}>\n            <Components.Heading as=\"h2\">\n              {t('landingSubtitle', {\n                contractorName: sanitizedContractorName,\n                companyName: sanitizedCompanyName,\n                interpolation: { escapeValue: false },\n              })}\n            </Components.Heading>\n            <Components.Text variant=\"supporting\">{t('landingDescription')}</Components.Text>\n          </Flex>\n          <Flex flexDirection=\"column\" gap={8}>\n            <Components.Heading as=\"h3\">{t('stepsSubtitle')}</Components.Heading>\n            <Components.UnorderedList\n              items={[\n                t('steps.profile'),\n                t('steps.address'),\n                t('steps.paymentMethod'),\n                t('steps.documents'),\n              ]}\n            />\n          </Flex>\n        </Flex>\n      </Components.Box>\n    </section>\n  )\n}\n"],"names":["Landing","props","useI18n","useComponentDictionary","jsx","BaseComponent","Root","contractorId","companyId","className","onEvent","useBase","Components","useComponentContext","useTranslation","contractor","useContractorsGetSuspense","sanitizedContractorName","useMemo","DOMPurify","company","useCompaniesGetSuspense","sanitizedCompanyName","ActionsLayout","jsxs","componentEvents","ArrowRightIcon","Flex"],"mappings":";;;;;;;;;;;;;;AA+BO,SAASA,EAAQC,GAAqB;AAC3C,SAAAC,EAAQ,oBAAoB,GAC5BC,EAAuB,sBAAsBF,EAAM,UAAU,GAG3D,gBAAAG,EAACC,GAAA,EAAe,GAAGJ,GACjB,UAAA,gBAAAG,EAACE,KAAM,GAAGL,GAAQ,UAAAA,EAAM,SAAA,CAAS,EAAA,CACnC;AAEJ;AAEA,MAAMK,IAAO,CAAC,EAAE,cAAAC,GAAc,WAAAC,GAAW,WAAAC,QAA8B;AACrE,QAAM,EAAE,SAAAC,EAAA,IAAYC,EAAA,GACdC,IAAaC,EAAA,GAEb,EAAE,EAAA,IAAMC,EAAe,oBAAoB,GAE3C;AAAA,IACJ,MAAM,EAAE,YAAAC,EAAA;AAAA,EAAW,IACjBC,EAA0B,EAAE,gBAAgBT,GAAc,GACxDU,IAA0BC;AAAA,IAC9B,MACEC,EAAU,SAASJ,GAAY,aAAaA,GAAY,gBAAgB,EAAE,cAAc,CAAC;AAAA,IAC3F,CAACA,GAAY,CAAC;AAAA,EAAA,GAGV;AAAA,IACJ,MAAM,EAAE,SAAAK,EAAA;AAAA,EAAQ,IACdC,EAAwB,EAAE,WAAAb,GAAW,GACnCc,IAAuBJ,EAAQ,MAAMC,EAAU,SAASC,GAAS,QAAQ,EAAE,GAAG,CAACA,CAAO,CAAC;AAE7F,SACE,gBAAAhB,EAAC,aAAQ,WAAAK,GACP,UAAA,gBAAAL;AAAA,IAACQ,EAAW;AAAA,IAAX;AAAA,MACC,0BACGW,GAAA,EACC,UAAA,gBAAAC;AAAA,QAACZ,EAAW;AAAA,QAAX;AAAA,UACC,SAAQ;AAAA,UACR,SAAS,MAAM;AACb,YAAAF,EAAQe,EAAgB,gCAAgC;AAAA,UAC1D;AAAA,UAEC,UAAA;AAAA,YAAA,EAAE,eAAe;AAAA,YAClB,gBAAArB,EAACsB,GAAA,EAAe,eAAW,GAAA,CAAC;AAAA,UAAA;AAAA,QAAA;AAAA,MAAA,GAEhC;AAAA,MAGF,4BAACC,GAAA,EAAK,YAAW,UAAS,eAAc,UAAS,KAAK,IACpD,UAAA;AAAA,QAAA,gBAAAH,EAACG,GAAA,EAAK,eAAc,UAAS,KAAK,GAChC,UAAA;AAAA,UAAA,gBAAAvB,EAACQ,EAAW,SAAX,EAAmB,IAAG,MACpB,YAAE,mBAAmB;AAAA,YACpB,gBAAgBK;AAAA,YAChB,aAAaK;AAAA,YACb,eAAe,EAAE,aAAa,GAAA;AAAA,UAAM,CACrC,GACH;AAAA,UACA,gBAAAlB,EAACQ,EAAW,MAAX,EAAgB,SAAQ,cAAc,UAAA,EAAE,oBAAoB,EAAA,CAAE;AAAA,QAAA,GACjE;AAAA,QACA,gBAAAY,EAACG,GAAA,EAAK,eAAc,UAAS,KAAK,GAChC,UAAA;AAAA,UAAA,gBAAAvB,EAACQ,EAAW,SAAX,EAAmB,IAAG,MAAM,UAAA,EAAE,eAAe,GAAE;AAAA,UAChD,gBAAAR;AAAA,YAACQ,EAAW;AAAA,YAAX;AAAA,cACC,OAAO;AAAA,gBACL,EAAE,eAAe;AAAA,gBACjB,EAAE,eAAe;AAAA,gBACjB,EAAE,qBAAqB;AAAA,gBACvB,EAAE,iBAAiB;AAAA,cAAA;AAAA,YACrB;AAAA,UAAA;AAAA,QACF,EAAA,CACF;AAAA,MAAA,EAAA,CACF;AAAA,IAAA;AAAA,EAAA,GAEJ;AAEJ;"}

package/dist/components/Contractor/NewHireReport/NewHireReport.js

@@ -4,8 +4,8 @@ import { useForm as T, useWatch as y, FormProvider as g } from "react-hook-form"
 import { useMemo as D } from "react";
 import r from "zod";
 import { zodResolver as O } from "@hookform/resolvers/zod";
-import { useContractorsGetSuspense as _ } from "@gusto/embedded-api-v-2026-02-01/react-query/contractorsGet";
-import { useContractorsUpdateMutation as x } from "@gusto/embedded-api-v-2026-02-01/react-query/contractorsUpdate";
+import { useContractorsGetSuspense as _ } from "@gusto/embedded-api/react-query/contractorsGet";
+import { useContractorsUpdateMutation as x } from "@gusto/embedded-api/react-query/contractorsUpdate";
 import { useComponentDictionary as F, useI18n as P } from "../../../i18n/I18n.js";
 import { BaseComponent as A } from "../../Base/Base.js";
 import { useBase as B } from "../../Base/useBase.js";

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

@@ -1 +1 @@
-{"version":3,"file":"NewHireReport.js","sources":["../../../../src/components/Contractor/NewHireReport/NewHireReport.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport type { SubmitHandler } from 'react-hook-form'\nimport { FormProvider, useForm, useWatch } from 'react-hook-form'\nimport { useMemo } from 'react'\nimport z from 'zod'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport { useContractorsGetSuspense } from '@gusto/embedded-api-v-2026-02-01/react-query/contractorsGet'\nimport { useContractorsUpdateMutation } from '@gusto/embedded-api-v-2026-02-01/react-query/contractorsUpdate'\nimport type { NewHireReportProps } from './types'\nimport { useI18n } from '@/i18n'\nimport { BaseComponent, useBase } from '@/components/Base'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { Form } from '@/components/Common/Form'\nimport { useComponentDictionary } from '@/i18n/I18n'\nimport { componentEvents, STATES_ABBR } from '@/shared/constants'\nimport { ActionsLayout } from '@/components/Common/ActionsLayout'\nimport { Flex, RadioGroupField, SelectField } from '@/components/Common'\n\nconst NewHireReportSchema = z.union([\n  z.object({\n    fileNewHireReport: z.boolean().refine(v => v),\n    state: z.string().min(1),\n  }),\n  z.object({\n    fileNewHireReport: z.boolean().refine(v => !v),\n  }),\n])\n\ntype NewHireReportSchemaInputs = z.input<typeof NewHireReportSchema>\n\n/**\n * Collects new hire reporting information for a contractor and persists it to the contractor record.\n *\n * Asks whether a new hire report should be filed and, when the answer is yes, captures the\n * work state used for filing. Submitting writes both values back to the contractor.\n *\n * @remarks\n * Set `selfOnboarding` to `true` when this component is rendered as part of the contractor's\n * own self-onboarding flow rather than admin onboarding.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `contractor/newHireReport/updated` | Fired when the new hire report is saved | The API response object; access the updated contractor at `.contractor` |\n * | `contractor/newHireReport/done` | Fired after the new hire report step completes | — |\n *\n * @param props - Component configuration; see {@link NewHireReportProps}.\n * @returns The rendered new hire report form.\n * @public\n *\n * @example\n * ```tsx\n * import { ContractorOnboarding } from '@gusto/embedded-react-sdk'\n *\n * function NewHireReportStep() {\n *   return (\n *     <ContractorOnboarding.NewHireReport\n *       contractorId=\"contractor-uuid\"\n *       onEvent={() => {}}\n *     />\n *   )\n * }\n * ```\n */\nexport function NewHireReport(props: NewHireReportProps) {\n  return (\n    <BaseComponent {...props}>\n      <Root {...props}>{props.children}</Root>\n    </BaseComponent>\n  )\n}\n\nfunction Root({ contractorId, className, dictionary, selfOnboarding = false }: NewHireReportProps) {\n  useComponentDictionary('Contractor.NewHireReport', dictionary)\n  useI18n('Contractor.NewHireReport')\n  const { t } = useTranslation('Contractor.NewHireReport')\n  const { onEvent, baseSubmitHandler } = useBase()\n  const Components = useComponentContext()\n\n  const {\n    data: { contractor },\n  } = useContractorsGetSuspense({ contractorUuid: contractorId })\n  const contractorDetails = contractor!\n\n  const { mutateAsync: updateContractor, isPending: updateContractorPending } =\n    useContractorsUpdateMutation()\n\n  const defaultValues = useMemo(\n    () => ({\n      fileNewHireReport: contractorDetails.fileNewHireReport || false,\n      state: contractorDetails.workState || null,\n    }),\n    [contractorDetails],\n  )\n\n  const formMethods = useForm({\n    resolver: zodResolver(NewHireReportSchema),\n    defaultValues: defaultValues,\n  })\n\n  const watchedDoFile = useWatch({ control: formMethods.control, name: 'fileNewHireReport' })\n  const onSubmit: SubmitHandler<NewHireReportSchemaInputs> = async data => {\n    await baseSubmitHandler(data, async payload => {\n      const contractorResponse = await updateContractor({\n        request: {\n          contractorUuid: contractorId,\n          contractorUpdateRequestBody: {\n            type: contractorDetails.type,\n            selfOnboarding: selfOnboarding,\n            fileNewHireReport: payload.fileNewHireReport,\n            workState: 'state' in payload ? payload.state : null,\n            version: contractorDetails.version!,\n          },\n        },\n      })\n      onEvent(componentEvents.CONTRACTOR_NEW_HIRE_REPORT_UPDATED, contractorResponse)\n      onEvent(componentEvents.CONTRACTOR_NEW_HIRE_REPORT_DONE)\n    })\n  }\n\n  return (\n    <section className={className}>\n      <FormProvider {...formMethods}>\n        <Form onSubmit={formMethods.handleSubmit(onSubmit)}>\n          <Flex flexDirection=\"column\" alignItems=\"stretch\">\n            <header>\n              <Flex flexDirection=\"column\" gap={4}>\n                <Components.Heading as=\"h2\">{t('title')}</Components.Heading>\n                <Components.Text variant=\"supporting\">{t('description')}</Components.Text>\n              </Flex>\n            </header>\n            <RadioGroupField\n              name=\"fileNewHireReport\"\n              label={t('doFileLegend')}\n              shouldVisuallyHideLabel\n              options={[\n                {\n                  value: true,\n                  label: t('yesOption'),\n                },\n                {\n                  value: false,\n                  label: t('noOption'),\n                },\n              ]}\n            />\n            {watchedDoFile && (\n              <SelectField\n                name=\"state\"\n                options={STATES_ABBR.map((stateAbbr: (typeof STATES_ABBR)[number]) => ({\n                  label: t(`statesHash.${stateAbbr}`, { ns: 'common' }),\n                  value: stateAbbr,\n                }))}\n                label={t('stateSelectionLabel')}\n                placeholder={t('statePlaceholder')}\n                errorMessage={t('validations.state')}\n                isRequired\n              />\n            )}\n            <ActionsLayout>\n              <Components.Button\n                type=\"submit\"\n                variant=\"primary\"\n                isDisabled={updateContractorPending}\n              >\n                {t('submitCta')}\n              </Components.Button>\n            </ActionsLayout>\n          </Flex>\n        </Form>\n      </FormProvider>\n    </section>\n  )\n}\n"],"names":["NewHireReportSchema","z","v","NewHireReport","props","jsx","BaseComponent","Root","contractorId","className","dictionary","selfOnboarding","useComponentDictionary","useI18n","t","useTranslation","onEvent","baseSubmitHandler","useBase","Components","useComponentContext","contractor","useContractorsGetSuspense","contractorDetails","updateContractor","updateContractorPending","useContractorsUpdateMutation","defaultValues","useMemo","formMethods","useForm","zodResolver","watchedDoFile","useWatch","onSubmit","data","payload","contractorResponse","componentEvents","FormProvider","Form","jsxs","Flex","RadioGroupField","SelectField","STATES_ABBR","stateAbbr","ActionsLayout"],"mappings":"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"}
+{"version":3,"file":"NewHireReport.js","sources":["../../../../src/components/Contractor/NewHireReport/NewHireReport.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport type { SubmitHandler } from 'react-hook-form'\nimport { FormProvider, useForm, useWatch } from 'react-hook-form'\nimport { useMemo } from 'react'\nimport z from 'zod'\nimport { zodResolver } from '@hookform/resolvers/zod'\nimport { useContractorsGetSuspense } from '@gusto/embedded-api/react-query/contractorsGet'\nimport { useContractorsUpdateMutation } from '@gusto/embedded-api/react-query/contractorsUpdate'\nimport type { NewHireReportProps } from './types'\nimport { useI18n } from '@/i18n'\nimport { BaseComponent, useBase } from '@/components/Base'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { Form } from '@/components/Common/Form'\nimport { useComponentDictionary } from '@/i18n/I18n'\nimport { componentEvents, STATES_ABBR } from '@/shared/constants'\nimport { ActionsLayout } from '@/components/Common/ActionsLayout'\nimport { Flex, RadioGroupField, SelectField } from '@/components/Common'\n\nconst NewHireReportSchema = z.union([\n  z.object({\n    fileNewHireReport: z.boolean().refine(v => v),\n    state: z.string().min(1),\n  }),\n  z.object({\n    fileNewHireReport: z.boolean().refine(v => !v),\n  }),\n])\n\ntype NewHireReportSchemaInputs = z.input<typeof NewHireReportSchema>\n\n/**\n * Collects new hire reporting information for a contractor and persists it to the contractor record.\n *\n * Asks whether a new hire report should be filed and, when the answer is yes, captures the\n * work state used for filing. Submitting writes both values back to the contractor.\n *\n * @remarks\n * Set `selfOnboarding` to `true` when this component is rendered as part of the contractor's\n * own self-onboarding flow rather than admin onboarding.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `contractor/newHireReport/updated` | Fired when the new hire report is saved | The API response object; access the updated contractor at `.contractor` |\n * | `contractor/newHireReport/done` | Fired after the new hire report step completes | — |\n *\n * @param props - Component configuration; see {@link NewHireReportProps}.\n * @returns The rendered new hire report form.\n * @public\n *\n * @example\n * ```tsx\n * import { ContractorOnboarding } from '@gusto/embedded-react-sdk'\n *\n * function NewHireReportStep() {\n *   return (\n *     <ContractorOnboarding.NewHireReport\n *       contractorId=\"contractor-uuid\"\n *       onEvent={() => {}}\n *     />\n *   )\n * }\n * ```\n */\nexport function NewHireReport(props: NewHireReportProps) {\n  return (\n    <BaseComponent {...props}>\n      <Root {...props}>{props.children}</Root>\n    </BaseComponent>\n  )\n}\n\nfunction Root({ contractorId, className, dictionary, selfOnboarding = false }: NewHireReportProps) {\n  useComponentDictionary('Contractor.NewHireReport', dictionary)\n  useI18n('Contractor.NewHireReport')\n  const { t } = useTranslation('Contractor.NewHireReport')\n  const { onEvent, baseSubmitHandler } = useBase()\n  const Components = useComponentContext()\n\n  const {\n    data: { contractor },\n  } = useContractorsGetSuspense({ contractorUuid: contractorId })\n  const contractorDetails = contractor!\n\n  const { mutateAsync: updateContractor, isPending: updateContractorPending } =\n    useContractorsUpdateMutation()\n\n  const defaultValues = useMemo(\n    () => ({\n      fileNewHireReport: contractorDetails.fileNewHireReport || false,\n      state: contractorDetails.workState || null,\n    }),\n    [contractorDetails],\n  )\n\n  const formMethods = useForm({\n    resolver: zodResolver(NewHireReportSchema),\n    defaultValues: defaultValues,\n  })\n\n  const watchedDoFile = useWatch({ control: formMethods.control, name: 'fileNewHireReport' })\n  const onSubmit: SubmitHandler<NewHireReportSchemaInputs> = async data => {\n    await baseSubmitHandler(data, async payload => {\n      const contractorResponse = await updateContractor({\n        request: {\n          contractorUuid: contractorId,\n          contractorUpdateRequestBody: {\n            type: contractorDetails.type,\n            selfOnboarding: selfOnboarding,\n            fileNewHireReport: payload.fileNewHireReport,\n            workState: 'state' in payload ? payload.state : null,\n            version: contractorDetails.version!,\n          },\n        },\n      })\n      onEvent(componentEvents.CONTRACTOR_NEW_HIRE_REPORT_UPDATED, contractorResponse)\n      onEvent(componentEvents.CONTRACTOR_NEW_HIRE_REPORT_DONE)\n    })\n  }\n\n  return (\n    <section className={className}>\n      <FormProvider {...formMethods}>\n        <Form onSubmit={formMethods.handleSubmit(onSubmit)}>\n          <Flex flexDirection=\"column\" alignItems=\"stretch\">\n            <header>\n              <Flex flexDirection=\"column\" gap={4}>\n                <Components.Heading as=\"h2\">{t('title')}</Components.Heading>\n                <Components.Text variant=\"supporting\">{t('description')}</Components.Text>\n              </Flex>\n            </header>\n            <RadioGroupField\n              name=\"fileNewHireReport\"\n              label={t('doFileLegend')}\n              shouldVisuallyHideLabel\n              options={[\n                {\n                  value: true,\n                  label: t('yesOption'),\n                },\n                {\n                  value: false,\n                  label: t('noOption'),\n                },\n              ]}\n            />\n            {watchedDoFile && (\n              <SelectField\n                name=\"state\"\n                options={STATES_ABBR.map((stateAbbr: (typeof STATES_ABBR)[number]) => ({\n                  label: t(`statesHash.${stateAbbr}`, { ns: 'common' }),\n                  value: stateAbbr,\n                }))}\n                label={t('stateSelectionLabel')}\n                placeholder={t('statePlaceholder')}\n                errorMessage={t('validations.state')}\n                isRequired\n              />\n            )}\n            <ActionsLayout>\n              <Components.Button\n                type=\"submit\"\n                variant=\"primary\"\n                isDisabled={updateContractorPending}\n              >\n                {t('submitCta')}\n              </Components.Button>\n            </ActionsLayout>\n          </Flex>\n        </Form>\n      </FormProvider>\n    </section>\n  )\n}\n"],"names":["NewHireReportSchema","z","v","NewHireReport","props","jsx","BaseComponent","Root","contractorId","className","dictionary","selfOnboarding","useComponentDictionary","useI18n","t","useTranslation","onEvent","baseSubmitHandler","useBase","Components","useComponentContext","contractor","useContractorsGetSuspense","contractorDetails","updateContractor","updateContractorPending","useContractorsUpdateMutation","defaultValues","useMemo","formMethods","useForm","zodResolver","watchedDoFile","useWatch","onSubmit","data","payload","contractorResponse","componentEvents","FormProvider","Form","jsxs","Flex","RadioGroupField","SelectField","STATES_ABBR","stateAbbr","ActionsLayout"],"mappings":"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"}

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

@@ -1,6 +1,6 @@
 import { ComponentType } from 'react';
 import { UseFormProps } from 'react-hook-form';
-import { ContractorBankAccount } from '@gusto/embedded-api-v-2026-02-01/models/components/contractorbankaccount';
+import { ContractorBankAccount } from '@gusto/embedded-api/models/components/contractorbankaccount';
 import { ContractorBankAccountFormData, ContractorBankAccountOptionalFieldsToRequire } from './useContractorBankAccountFormSchema';
 import { AccountNumberFieldProps, AccountTypeFieldProps, NameFieldProps, RoutingNumberFieldProps } from './fields';
 import { BaseFormHookReady, FieldMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';

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

@@ -1,8 +1,8 @@
 import { useMemo as f } from "react";
 import { useForm as v } from "react-hook-form";
 import { zodResolver as E } from "@hookform/resolvers/zod";
-import { useContractorPaymentMethodGetBankAccounts as P } from "@gusto/embedded-api-v-2026-02-01/react-query/contractorPaymentMethodGetBankAccounts";
-import { useContractorPaymentMethodsCreateBankAccountMutation as V } from "@gusto/embedded-api-v-2026-02-01/react-query/contractorPaymentMethodsCreateBankAccount";
+import { useContractorPaymentMethodGetBankAccounts as P } from "@gusto/embedded-api/react-query/contractorPaymentMethodGetBankAccounts";
+import { useContractorPaymentMethodsCreateBankAccountMutation as V } from "@gusto/embedded-api/react-query/contractorPaymentMethodsCreateBankAccount";
 import { createContractorBankAccountSchema as H, ACCOUNT_TYPES as N } from "./useContractorBankAccountFormSchema.js";
 import { AccountTypeField as L, AccountNumberField as O, RoutingNumberField as R, NameField as U } from "./fields.js";
 import { useDeriveFieldsMetadata as x } from "../../../../../partner-hook-utils/form/useDeriveFieldsMetadata.js";