@gusto/embedded-react-sdk 0.52.2 → 0.54.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sources":["../../../../../../../src/components/Contractor/Documents/shared/SignatureForm/useContractorSignatureForm/fields.tsx"],"sourcesContent":["import type { ComponentType } from 'react'\nimport type { ContractorSignatureFormErrorCodes } from './contractorSignatureFormSchema'\nimport type { TextInputHookFieldProps } from '@/partner-hook-utils/form/fields/TextInputHookField'\nimport type { CheckboxHookFieldProps } from '@/partner-hook-utils/form/fields/CheckboxHookField'\nimport type { RadioGroupHookFieldProps } from '@/partner-hook-utils/form/fields/RadioGroupHookField'\nimport type { SelectHookFieldProps } from '@/partner-hook-utils/form/fields/SelectHookField'\nimport {\n  TextInputHookField,\n  CheckboxHookField,\n  RadioGroupHookField,\n  SelectHookField,\n} from '@/partner-hook-utils/form/fields'\nimport type { HookFieldProps } from '@/partner-hook-utils/types'\nimport { normalizeSSN } from '@/helpers/ssn'\nimport { normalizeEin } from '@/helpers/federalEin'\n\n/**\n * The form-field name of the electronic-signature consent checkbox.\n *\n * @internal\n */\nexport const AGREE_FIELD = 'agree'\n\n// ── Shared prop types ─────────────────────────────────────────────────\n\n/**\n * The required-field error code emitted by most {@link useContractorSignatureForm} fields.\n *\n * @remarks\n * Use as a key in `validationMessages` for text inputs, selects, and radio groups\n * that only emit the `REQUIRED` error. See {@link ContractorSignatureFormErrorCodes}.\n *\n * @public\n */\nexport type RequiredValidation = typeof ContractorSignatureFormErrorCodes.REQUIRED\n\n/**\n * Validation error code emitted by the `Agree` consent checkbox.\n *\n * @remarks\n * Use as a key in `validationMessages` on `Fields.Agree`. See\n * {@link ContractorSignatureFormErrorCodes}.\n *\n * @public\n */\nexport type AgreeValidation = typeof ContractorSignatureFormErrorCodes.AGREE_REQUIRED\n\n/**\n * The format-validation error code emitted by the `ssn` field of {@link useContractorSignatureForm}.\n *\n * @remarks\n * Use as a key in `validationMessages` on `Fields.Ssn`. See\n * {@link ContractorSignatureFormErrorCodes}.\n *\n * @public\n */\nexport type SsnValidation = typeof ContractorSignatureFormErrorCodes.INVALID_SSN\n\n/**\n * The format-validation error code emitted by the `ein` field of {@link useContractorSignatureForm}.\n *\n * @remarks\n * Use as a key in `validationMessages` on `Fields.Ein`. See\n * {@link ContractorSignatureFormErrorCodes}.\n *\n * @public\n */\nexport type EinValidation = typeof ContractorSignatureFormErrorCodes.INVALID_EIN\n\n// ── Field prop types ──────────────────────────────────────────────────\n\n/**\n * Props accepted by {@link useContractorSignatureForm}'s `Fields.Name` component.\n *\n * @public\n */\nexport type NameFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/**\n * Props accepted by {@link useContractorSignatureForm}'s `Fields.TaxClassification` component.\n *\n * @public\n */\nexport type TaxClassificationFieldProps = HookFieldProps<\n  RadioGroupHookFieldProps<RequiredValidation, string>\n>\n\n/**\n * Props accepted by {@link useContractorSignatureForm}'s `Fields.HomeAddressStreet1` component.\n *\n * @public\n */\nexport type HomeAddressStreet1FieldProps = HookFieldProps<\n  TextInputHookFieldProps<RequiredValidation>\n>\n\n/**\n * Props accepted by {@link useContractorSignatureForm}'s `Fields.HomeAddressCity` component.\n *\n * @public\n */\nexport type HomeAddressCityFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/**\n * Props accepted by {@link useContractorSignatureForm}'s `Fields.HomeAddressState` component.\n *\n * @public\n */\nexport type HomeAddressStateFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/**\n * Props accepted by {@link useContractorSignatureForm}'s `Fields.HomeAddressZip` component.\n *\n * @public\n */\nexport type HomeAddressZipFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/**\n * Props accepted by {@link useContractorSignatureForm}'s `Fields.Ssn` component.\n *\n * @public\n */\nexport type SsnFieldProps = HookFieldProps<\n  TextInputHookFieldProps<SsnValidation, RequiredValidation>\n>\n\n/**\n * Props accepted by {@link useContractorSignatureForm}'s `Fields.Ein` component.\n *\n * @public\n */\nexport type EinFieldProps = HookFieldProps<\n  TextInputHookFieldProps<EinValidation, RequiredValidation>\n>\n\n/**\n * Props accepted by {@link useContractorSignatureForm}'s `Fields.SignatureText` component.\n *\n * @public\n */\nexport type SignatureTextFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/**\n * Props accepted by {@link useContractorSignatureForm}'s `Fields.Agree` component.\n *\n * @public\n */\nexport type AgreeFieldProps = HookFieldProps<CheckboxHookFieldProps<AgreeValidation>>\n\n/**\n * Props accepted by {@link useContractorSignatureForm}'s `Fields.BusinessName` component.\n *\n * @public\n */\nexport type BusinessNameFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/**\n * Props accepted by {@link useContractorSignatureForm}'s `Fields.LlcClassificationCode` component.\n *\n * @public\n */\nexport type LlcClassificationCodeFieldProps = HookFieldProps<\n  SelectHookFieldProps<RequiredValidation, string>\n>\n\n/**\n * Props accepted by {@link useContractorSignatureForm}'s `Fields.OtherText` component.\n *\n * @public\n */\nexport type OtherTextFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/**\n * Props accepted by {@link useContractorSignatureForm}'s `Fields.ForeignPartners` component.\n *\n * @public\n */\nexport type ForeignPartnersFieldProps = HookFieldProps<CheckboxHookFieldProps>\n\n/**\n * Props accepted by {@link useContractorSignatureForm}'s `Fields.ExemptPayeeCode` component.\n *\n * @public\n */\nexport type ExemptPayeeCodeFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/**\n * Props accepted by {@link useContractorSignatureForm}'s `Fields.ExemptionFromFatca` component.\n *\n * @public\n */\nexport type ExemptionFromFatcaFieldProps = HookFieldProps<\n  TextInputHookFieldProps<RequiredValidation>\n>\n\n/**\n * Props accepted by {@link useContractorSignatureForm}'s `Fields.HomeAddressStreet2` component.\n *\n * @public\n */\nexport type HomeAddressStreet2FieldProps = HookFieldProps<\n  TextInputHookFieldProps<RequiredValidation>\n>\n\n/**\n * Props accepted by {@link useContractorSignatureForm}'s `Fields.AccountNumber` component.\n *\n * @public\n */\nexport type AccountNumberFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/**\n * Props accepted by {@link useContractorSignatureForm}'s `Fields.CompanyName` component.\n *\n * @public\n */\nexport type CompanyNameFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n// ── Core fields (always present) ──────────────────────────────────────\n\n/** @internal */\nexport function NameField(props: NameFieldProps) {\n  return <TextInputHookField {...props} name=\"name\" />\n}\n\n/** @internal */\nexport function TaxClassificationField(props: TaxClassificationFieldProps) {\n  return <RadioGroupHookField {...props} name=\"taxClassification\" />\n}\n\n/** @internal */\nexport function HomeAddressStreet1Field(props: HomeAddressStreet1FieldProps) {\n  return <TextInputHookField {...props} name=\"homeAddressStreet1\" />\n}\n\n/** @internal */\nexport function HomeAddressCityField(props: HomeAddressCityFieldProps) {\n  return <TextInputHookField {...props} name=\"homeAddressCity\" />\n}\n\n/** @internal */\nexport function HomeAddressStateField(props: HomeAddressStateFieldProps) {\n  return <TextInputHookField {...props} name=\"homeAddressState\" />\n}\n\n/** @internal */\nexport function HomeAddressZipField(props: HomeAddressZipFieldProps) {\n  return <TextInputHookField {...props} name=\"homeAddressZip\" />\n}\n\n/** @internal */\nexport function SsnField(props: SsnFieldProps) {\n  return <TextInputHookField {...props} name=\"ssn\" transform={normalizeSSN} />\n}\n\n/** @internal */\nexport function EinField(props: EinFieldProps) {\n  return <TextInputHookField {...props} name=\"ein\" transform={normalizeEin} />\n}\n\n/** @internal */\nexport function SignatureTextField(props: SignatureTextFieldProps) {\n  return <TextInputHookField {...props} name=\"signatureText\" />\n}\n\n/** @internal */\nexport function AgreeField(props: AgreeFieldProps) {\n  return <CheckboxHookField {...props} name=\"agree\" />\n}\n\n// ── Variable fields (rendered only when the API returns them) ─────────\n\n/** @internal */\nexport function BusinessNameField(props: BusinessNameFieldProps) {\n  return <TextInputHookField {...props} name=\"businessName\" />\n}\n\n/** @internal */\nexport function LlcClassificationCodeField(props: LlcClassificationCodeFieldProps) {\n  return <SelectHookField {...props} name=\"llcClassificationCode\" />\n}\n\n/** @internal */\nexport function OtherTextField(props: OtherTextFieldProps) {\n  return <TextInputHookField {...props} name=\"otherText\" />\n}\n\n/** @internal */\nexport function ForeignPartnersField(props: ForeignPartnersFieldProps) {\n  return <CheckboxHookField {...props} name=\"foreignPartners\" />\n}\n\n/** @internal */\nexport function ExemptPayeeCodeField(props: ExemptPayeeCodeFieldProps) {\n  return <TextInputHookField {...props} name=\"exemptPayeeCode\" />\n}\n\n/** @internal */\nexport function ExemptionFromFatcaField(props: ExemptionFromFatcaFieldProps) {\n  return <TextInputHookField {...props} name=\"exemptionFromFatca\" />\n}\n\n/** @internal */\nexport function HomeAddressStreet2Field(props: HomeAddressStreet2FieldProps) {\n  return <TextInputHookField {...props} name=\"homeAddressStreet2\" />\n}\n\n/** @internal */\nexport function AccountNumberField(props: AccountNumberFieldProps) {\n  return <TextInputHookField {...props} name=\"accountNumber\" />\n}\n\n/** @internal */\nexport function CompanyNameField(props: CompanyNameFieldProps) {\n  return <TextInputHookField {...props} name=\"companyName\" />\n}\n\n/**\n * Field components exposed by {@link useContractorSignatureForm} on `form.Fields`.\n *\n * @remarks\n * Every field is presence-gated against the API response and is `undefined`\n * when the document didn't return its backing field — always null-check before\n * rendering. This guards against the document API diverging (dropping or\n * renaming a field) by skipping fields it no longer returns, mirroring the\n * stable signing flow. `Agree` is the sole exception: it's a synthesized\n * electronic-signature consent checkbox with no API field, so it's always\n * present.\n *\n * @public\n */\nexport interface ContractorSignatureFormFieldComponents {\n  /** Entity or individual name; defined only when the API returns `name`. */\n  Name: ComponentType<NameFieldProps> | undefined\n  /** Federal tax classification radio group; defined only when the document carries classification checkboxes. */\n  TaxClassification: ComponentType<TaxClassificationFieldProps> | undefined\n  /** Street address line 1; defined only when the API returns `home_address_street_1`. */\n  HomeAddressStreet1: ComponentType<HomeAddressStreet1FieldProps> | undefined\n  /** City; defined only when the API returns `home_address_city`. */\n  HomeAddressCity: ComponentType<HomeAddressCityFieldProps> | undefined\n  /** State; defined only when the API returns `home_address_state`. */\n  HomeAddressState: ComponentType<HomeAddressStateFieldProps> | undefined\n  /** ZIP code; defined only when the API returns `home_address_zip`. */\n  HomeAddressZip: ComponentType<HomeAddressZipFieldProps> | undefined\n  /** Social Security Number; defined only when the API returns `ssn`. */\n  Ssn: ComponentType<SsnFieldProps> | undefined\n  /** Employer Identification Number; defined only when the API returns `ein`. */\n  Ein: ComponentType<EinFieldProps> | undefined\n  /** Typed signature; defined only when the API returns `signature_text`. */\n  SignatureText: ComponentType<SignatureTextFieldProps> | undefined\n  /** Electronic-signature consent checkbox; always present (synthesized, not an API field). */\n  Agree: ComponentType<AgreeFieldProps>\n  /** Business name; defined only when the API returns `business_name`. */\n  BusinessName: ComponentType<BusinessNameFieldProps> | undefined\n  /** LLC tax classification code select; defined only when classification checkboxes are present. */\n  LlcClassificationCode: ComponentType<LlcClassificationCodeFieldProps> | undefined\n  /** \"Other\" free-text classification; defined only when the API returns `other_text`. */\n  OtherText: ComponentType<OtherTextFieldProps> | undefined\n  /** Foreign partners checkbox; defined only when the API returns `foreign_partners`. */\n  ForeignPartners: ComponentType<ForeignPartnersFieldProps> | undefined\n  /** Exempt payee code; defined only when the API returns `exempt_payee_code`. */\n  ExemptPayeeCode: ComponentType<ExemptPayeeCodeFieldProps> | undefined\n  /** FATCA exemption code; defined only when the API returns `exemption_from_FATCA`. */\n  ExemptionFromFatca: ComponentType<ExemptionFromFatcaFieldProps> | undefined\n  /** Street address line 2; defined only when the API returns `home_address_street_2`. */\n  HomeAddressStreet2: ComponentType<HomeAddressStreet2FieldProps> | undefined\n  /** Account number(s); defined only when the API returns `account_number`. */\n  AccountNumber: ComponentType<AccountNumberFieldProps> | undefined\n  /** Requester's name and address; defined only when the API returns `company_name`. */\n  CompanyName: ComponentType<CompanyNameFieldProps> | undefined\n}\n"],"names":["NameField","props","jsx","TextInputHookField","TaxClassificationField","RadioGroupHookField","HomeAddressStreet1Field","HomeAddressCityField","HomeAddressStateField","HomeAddressZipField","SsnField","normalizeSSN","EinField","normalizeEin","SignatureTextField","AgreeField","CheckboxHookField","BusinessNameField","LlcClassificationCodeField","SelectHookField","OtherTextField","ForeignPartnersField","ExemptPayeeCodeField","ExemptionFromFatcaField","HomeAddressStreet2Field","AccountNumberField","CompanyNameField"],"mappings":";;;;;;;AA6NO,SAASA,EAAUC,GAAuB;AAC/C,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,QAAO;AACpD;AAGO,SAASG,EAAuBH,GAAoC;AACzE,SAAO,gBAAAC,EAACG,GAAA,EAAqB,GAAGJ,GAAO,MAAK,qBAAoB;AAClE;AAGO,SAASK,EAAwBL,GAAqC;AAC3E,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,sBAAqB;AAClE;AAGO,SAASM,EAAqBN,GAAkC;AACrE,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,mBAAkB;AAC/D;AAGO,SAASO,EAAsBP,GAAmC;AACvE,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,oBAAmB;AAChE;AAGO,SAASQ,EAAoBR,GAAiC;AACnE,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,kBAAiB;AAC9D;AAGO,SAASS,EAAST,GAAsB;AAC7C,2BAAQE,GAAA,EAAoB,GAAGF,GAAO,MAAK,OAAM,WAAWU,GAAc;AAC5E;AAGO,SAASC,EAASX,GAAsB;AAC7C,2BAAQE,GAAA,EAAoB,GAAGF,GAAO,MAAK,OAAM,WAAWY,GAAc;AAC5E;AAGO,SAASC,EAAmBb,GAAgC;AACjE,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,iBAAgB;AAC7D;AAGO,SAASc,EAAWd,GAAwB;AACjD,SAAO,gBAAAC,EAACc,GAAA,EAAmB,GAAGf,GAAO,MAAK,SAAQ;AACpD;AAKO,SAASgB,EAAkBhB,GAA+B;AAC/D,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,gBAAe;AAC5D;AAGO,SAASiB,EAA2BjB,GAAwC;AACjF,SAAO,gBAAAC,EAACiB,GAAA,EAAiB,GAAGlB,GAAO,MAAK,yBAAwB;AAClE;AAGO,SAASmB,EAAenB,GAA4B;AACzD,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,aAAY;AACzD;AAGO,SAASoB,EAAqBpB,GAAkC;AACrE,SAAO,gBAAAC,EAACc,GAAA,EAAmB,GAAGf,GAAO,MAAK,mBAAkB;AAC9D;AAGO,SAASqB,EAAqBrB,GAAkC;AACrE,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,mBAAkB;AAC/D;AAGO,SAASsB,EAAwBtB,GAAqC;AAC3E,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,sBAAqB;AAClE;AAGO,SAASuB,EAAwBvB,GAAqC;AAC3E,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,sBAAqB;AAClE;AAGO,SAASwB,EAAmBxB,GAAgC;AACjE,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,iBAAgB;AAC7D;AAGO,SAASyB,EAAiBzB,GAA8B;AAC7D,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,eAAc;AAC3D;"}

package/dist/components/Contractor/Documents/{SignatureForm → shared/SignatureForm}/useContractorSignatureForm/useContractorSignatureForm.d.ts

@@ -3,7 +3,7 @@ import { Document } from '@gusto/embedded-api/models/components/document';
 import { DocumentSigned } from '@gusto/embedded-api/models/components/documentsigned';
 import { ContractorSignatureFormData, ContractorSignatureOptionalFieldsToRequire } from './contractorSignatureFormSchema';
 import { ContractorSignatureFormFieldComponents } from './fields';
-import { BaseFormHookReady, FieldMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
+import { BaseFormHookReady, FieldMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../../partner-hook-utils/types';
 /**
  * Props for {@link useContractorSignatureForm}.
  *
@@ -63,7 +63,7 @@ export type UseContractorSignatureFormResult = HookLoadingResult | UseContractor
  *
  * @public
  */
-export type ContractorSignatureFieldsMetadata = { name: FieldMetadata; businessName: FieldMetadata; taxClassification: import("../../../../../partner-hook-utils/types").FieldMetadataWithOptions<"c_corporation" | "individual_proprietor" | "limited_liability_company" | "other" | "partnership" | "s_corporation" | "trust_estate">; llcClassificationCode: import("../../../../../partner-hook-utils/types").FieldMetadataWithOptions<"c" | "p" | "s">; otherText: FieldMetadata; foreignPartners: FieldMetadata; exemptPayeeCode: FieldMetadata; exemptionFromFatca: FieldMetadata; homeAddressStreet1: FieldMetadata; homeAddressStreet2: FieldMetadata; homeAddressCity: FieldMetadata; homeAddressState: FieldMetadata; homeAddressZip: FieldMetadata; accountNumber: FieldMetadata; companyName: FieldMetadata; ssn: FieldMetadata; ein: FieldMetadata; signatureText: FieldMetadata; agree: FieldMetadata; };
+export type ContractorSignatureFieldsMetadata = { name: FieldMetadata; businessName: FieldMetadata; taxClassification: import("../../../../../../partner-hook-utils/types").FieldMetadataWithOptions<"c_corporation" | "individual_proprietor" | "limited_liability_company" | "other" | "partnership" | "s_corporation" | "trust_estate">; llcClassificationCode: import("../../../../../../partner-hook-utils/types").FieldMetadataWithOptions<"c" | "p" | "s">; otherText: FieldMetadata; foreignPartners: FieldMetadata; exemptPayeeCode: FieldMetadata; exemptionFromFatca: FieldMetadata; homeAddressStreet1: FieldMetadata; homeAddressStreet2: FieldMetadata; homeAddressCity: FieldMetadata; homeAddressState: FieldMetadata; homeAddressZip: FieldMetadata; accountNumber: FieldMetadata; companyName: FieldMetadata; ssn: FieldMetadata; ein: FieldMetadata; signatureText: FieldMetadata; agree: FieldMetadata; };
 /**
  * Headless hook for signing a contractor document — collects the document's
  * fields plus a typed signature and consent.

package/dist/components/Contractor/Documents/{SignatureForm → shared/SignatureForm}/useContractorSignatureForm/useContractorSignatureForm.js

@@ -7,14 +7,14 @@ import { useContractorDocumentsSignMutation as z } from "@gusto/embedded-api/rea
 import { getPresentFieldNames as G, getRedactionState as k, EMPTY_W9_DEFAULTS as K, buildW9Defaults as Q, OTHER_CLASSIFICATION_OPTION as U, LLC_CLASSIFICATION_OPTION as Y, NOT_APPLICABLE_VALUE as x, serializeW9Fields as q, LLC_CLASSIFICATION_CODES as v, TAX_CLASSIFICATION_OPTION_KEYS as P } from "./w9Fields.js";
 import { createContractorSignatureFormSchema as X } from "./contractorSignatureFormSchema.js";
 import { CompanyNameField as j, AccountNumberField as J, HomeAddressStreet2Field as $, ExemptionFromFatcaField as ee, ExemptPayeeCodeField as te, ForeignPartnersField as oe, OtherTextField as re, LlcClassificationCodeField as se, BusinessNameField as ie, AgreeField as ae, SignatureTextField as ne, EinField as de, SsnField as me, HomeAddressZipField as ce, HomeAddressStateField as ue, HomeAddressCityField as le, HomeAddressStreet1Field as fe, TaxClassificationField as he, NameField as Ce } from "./fields.js";
-import { useDeriveFieldsMetadata as Se } from "../../../../../partner-hook-utils/form/useDeriveFieldsMetadata.js";
-import { withOptions as T } from "../../../../../partner-hook-utils/form/withOptions.js";
-import { withFlags as y } from "../../../../../partner-hook-utils/form/withFlags.js";
-import { useHookFormInternals as Ae } from "../../../../../partner-hook-utils/form/useHookFormInternals.js";
-import { createGetFormSubmissionValues as ge } from "../../../../../partner-hook-utils/form/getFormSubmissionValues.js";
-import { composeErrorHandler as Fe } from "../../../../../partner-hook-utils/composeErrorHandler.js";
-import { useBaseSubmit as pe } from "../../../../Base/useBaseSubmit.js";
-import { SDKInternalError as I } from "../../../../../types/sdkError.js";
+import { useDeriveFieldsMetadata as Se } from "../../../../../../partner-hook-utils/form/useDeriveFieldsMetadata.js";
+import { withOptions as T } from "../../../../../../partner-hook-utils/form/withOptions.js";
+import { withFlags as y } from "../../../../../../partner-hook-utils/form/withFlags.js";
+import { useHookFormInternals as Ae } from "../../../../../../partner-hook-utils/form/useHookFormInternals.js";
+import { createGetFormSubmissionValues as ge } from "../../../../../../partner-hook-utils/form/getFormSubmissionValues.js";
+import { composeErrorHandler as Fe } from "../../../../../../partner-hook-utils/composeErrorHandler.js";
+import { useBaseSubmit as pe } from "../../../../../Base/useBaseSubmit.js";
+import { SDKInternalError as I } from "../../../../../../types/sdkError.js";
 function xe(e, r, s) {
   return {
     // Every field is presence-gated to guard against the document API diverging

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

@@ -0,0 +1 @@
+{"version":3,"file":"useContractorSignatureForm.js","sources":["../../../../../../../src/components/Contractor/Documents/shared/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  NOT_APPLICABLE_VALUE,\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  defaultValues: ContractorSignatureFormData,\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    // The non-applicable TIN (an individual's EIN, a business's SSN) arrives as\n    // the `N/A` sentinel and is never rendered, while its `N/A` default stays in\n    // form state and still serializes onto the W-9.\n    Ssn:\n      presentFieldNames.has('ssn') && defaultValues.ssn !== NOT_APPLICABLE_VALUE\n        ? SsnField\n        : undefined,\n    Ein:\n      presentFieldNames.has('ein') && defaultValues.ein !== NOT_APPLICABLE_VALUE\n        ? EinField\n        : 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  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, defaultValues),\n    [presentFieldNames, watchedClassification, defaultValues],\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","defaultValues","NameField","TaxClassificationField","HomeAddressStreet1Field","HomeAddressCityField","HomeAddressStateField","HomeAddressZipField","NOT_APPLICABLE_VALUE","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","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":"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"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"w9Fields.js","sources":["../../../../../../../src/components/Contractor/Documents/shared/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'\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 * 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","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","value","hasRedactedValue","field","indexFields","document","byKey","toBoolean","isW9Document","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":"AAYO,MAAMA,IAAmB,oCAUnBC,IAAuB,OAOvBC,IAA2B,qBAO3BC,IAA2B,yBAO3BC,IAAmB,aAQnBC,IAAiC;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAcaC,IAAwD,6BAOxDC,IAA0D,SAO1DC,IAA2B,CAAC,KAAK,KAAK,GAAG,GASzCC,IAAoB;AAAA,EAC/B,MAAM;AAAA,EACN,cAAc;AAAA,EACd,WAAW;AAAA,EACX,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,oBAAoB;AAAA,EACpB,oBAAoB;AAAA,EACpB,oBAAoB;AAAA,EACpB,iBAAiB;AAAA,EACjB,kBAAkB;AAAA,EAClB,gBAAgB;AAAA,EAChB,eAAe;AAAA,EACf,aAAa;AAAA,EACb,KAAK;AAAA,EACL,KAAK;AAAA,EACL,eAAe;AACjB,GAMMC,IAAuB,oBAAI,IAAI,CAAC,OAAO,KAAK,CAAC;AAGnD,SAASC,EAAcC,GAA2C;AAChE,SAAO,OAAOA,KAAU,YAAY,QAAQ,KAAKA,CAAK;AACxD;AAGA,SAASC,EAAiBC,GAA2C;AACnE,SAAKA,KAEHJ,EAAqB,IAAII,EAAM,OAAO,EAAE,KACxCA,EAAM,aAAa,SACnBA,EAAM,aAAa,UACCH,EAAcG,EAAM,KAAK,IAL5B;AAMrB;AAEA,SAASC,EAAYC,GAAgD;AACnE,QAAMC,wBAAY,IAAA;AAClB,aAAWH,KAASE,EAAS,UAAU,CAAA;AACrC,IAAIF,EAAM,OAAKG,EAAM,IAAIH,EAAM,KAAKA,CAAK;AAE3C,SAAOG;AACT;AAGA,SAASC,EAAUN,GAA2C;AAC5D,SAAOA,MAAU,OAAOA,MAAU;AACpC;AAOO,SAASO,EAAaH,GAA6B;AACxD,SAAOA,EAAS,SAAShB;AAC3B;AAyBO,SAASoB,EAAkBJ,GAAsC;AACtE,QAAMC,IAAQF,EAAYC,CAAQ,GAC5BK,IAAWJ,EAAM,IAAI,KAAK,GAC1BK,IAAWL,EAAM,IAAI,KAAK,GAC1BM,IAAcV,EAAiBQ,CAAQ,GACvCG,IAAcX,EAAiBS,CAAQ;AAC7C,SAAO;AAAA,IACL,aAAAC;AAAA,IACA,aAAAC;AAAA,IACA,gBAAgBD,IAAeF,GAAU,SAAS,SAAa;AAAA,IAC/D,gBAAgBG,IAAeF,GAAU,SAAS,SAAa;AAAA,EAAA;AAEnE;AAgBO,SAASG,EAAqBT,GAAiC;AACpE,QAAMC,IAAQF,EAAYC,CAAQ,GAC5BU,wBAAwB,IAAA;AAE9B,aAAW,CAACC,GAAWC,CAAM,KAAK,OAAO,QAAQnB,CAAiB;AAChE,IAAIQ,EAAM,IAAIW,CAAM,KAAGF,EAAkB,IAAIC,CAAS;AAIxD,SAD0BtB,EAA+B,KAAK,OAAOY,EAAM,IAAIY,CAAG,CAAC,MAEjFH,EAAkB,IAAIxB,CAAwB,GAC9CwB,EAAkB,IAAIvB,CAAwB,IAGzCuB;AACT;AAiBO,SAASI,EAAgBd,GAAiD;AAC/E,QAAMC,IAAQF,EAAYC,CAAQ,GAC5Be,IAAYX,EAAkBJ,CAAQ,GACtCgB,IAAY,CAACJ,MAA2BX,EAAM,IAAIW,CAAM,GAAG,SAAS,IACpEK,IACJ5B,EAA+B,KAAK,CAAAwB,MAAOX,EAAUD,EAAM,IAAIY,CAAG,GAAG,KAAK,CAAC,KAAK;AAElF,SAAO;AAAA,IACL,MAAMG,EAAU,MAAM;AAAA,IACtB,cAAcA,EAAU,eAAe;AAAA,IACvC,mBAAmBC;AAAA;AAAA;AAAA,IAGnB,uBACEA,MAA2B3B,IAA4B0B,EAAU,oBAAoB,IAAI;AAAA,IAC3F,WAAWA,EAAU,YAAY;AAAA,IACjC,iBAAiBd,EAAUD,EAAM,IAAI,kBAAkB,GAAG,KAAK;AAAA,IAC/D,iBAAiBe,EAAU,mBAAmB;AAAA,IAC9C,oBAAoBA,EAAU,sBAAsB;AAAA,IACpD,oBAAoBA,EAAU,uBAAuB;AAAA,IACrD,oBAAoBA,EAAU,uBAAuB;AAAA,IACrD,iBAAiBA,EAAU,mBAAmB;AAAA,IAC9C,kBAAkBA,EAAU,oBAAoB;AAAA,IAChD,gBAAgBA,EAAU,kBAAkB;AAAA,IAC5C,eAAeA,EAAU,gBAAgB;AAAA,IACzC,aAAaA,EAAU,cAAc;AAAA,IACrC,KAAKD,EAAU,cAAc,KAAKC,EAAU,KAAK;AAAA,IACjD,KAAKD,EAAU,cAAc,KAAKC,EAAU,KAAK;AAAA,IACjD,eAAeA,EAAU,gBAAgB;AAAA,IACzC,OAAO;AAAA,EAAA;AAEX;AAOO,MAAME,IAAiD;AAAA,EAC5D,MAAM;AAAA,EACN,cAAc;AAAA,EACd,mBAAmB;AAAA,EACnB,uBAAuB;AAAA,EACvB,WAAW;AAAA,EACX,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,oBAAoB;AAAA,EACpB,oBAAoB;AAAA,EACpB,oBAAoB;AAAA,EACpB,iBAAiB;AAAA,EACjB,kBAAkB;AAAA,EAClB,gBAAgB;AAAA,EAChB,eAAe;AAAA,EACf,aAAa;AAAA,EACb,KAAK;AAAA,EACL,KAAK;AAAA,EACL,eAAe;AAAA,EACf,OAAO;AACT,GAeMC,IAAmD;AAAA,EACvD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAsBO,SAASC,EACdpB,GACAqB,GACAN,GACkB;AAClB,QAAML,IAAoBD,EAAqBT,CAAQ,GACjDsB,IAA2B,CAAA,GAG3BC,IAAMF,GACNG,IAAO,CAACC,MAAyB;AACrC,UAAM7B,IAAQ2B,EAAIE,CAAI;AACtB,WAAO,OAAO7B,KAAU,WAAWA,IAAQ;AAAA,EAC7C,GACM8B,IAAiBF,EAAK,mBAAmB,GAEzCG,IAAY,CAAChB,GAAiCf,MAAkB;AACpE,IAAA0B,EAAO,KAAK,EAAE,KAAK7B,EAAkBkB,CAAS,GAAG,OAAAf,GAAO;AAAA,EAC1D;AAEA,aAAWe,KAAaQ;AACtB,IAAKT,EAAkB,IAAIC,CAAS,KACpCgB,EAAUhB,GAAWa,EAAKb,CAAS,CAAC;AAGtC,EAAID,EAAkB,IAAItB,CAAgB,KAAKsC,MAAmBnC,KAChEoC,EAAU,aAAaH,EAAK,WAAW,CAAC,GAGtCd,EAAkB,IAAI,iBAAiB,KACzCY,EAAO,KAAK;AAAA,IACV,KAAK7B,EAAkB;AAAA,IACvB,OAAO4B,EAAO,kBAAkB,MAAM;AAAA,EAAA,CACvC;AAKH,QAAMO,IAAWJ,EAAK,KAAK,GACrBK,IAAWL,EAAK,KAAK;AAC3B,SAAId,EAAkB,IAAI,KAAK,KAAK,EAAEK,EAAU,eAAea,MAAa,OAC1ED,EAAU,OAAOC,CAAQ,GAEvBlB,EAAkB,IAAI,KAAK,KAAK,EAAEK,EAAU,eAAec,MAAa,OAC1EF,EAAU,OAAOE,CAAQ,GAGvBH,MACFJ,EAAO,KAAK,EAAE,KAAKI,GAAgB,OAAO,KAAK,GAC3CA,MAAmBpC,KACrBgC,EAAO,KAAK,EAAE,KAAK,sBAAsB,OAAOE,EAAK,uBAAuB,GAAG,IAI5EF;AACT;"}

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

@@ -0,0 +1 @@
+export {};

package/dist/components/Contractor/Documents/shared/documentSigningStatus.d.ts

@@ -0,0 +1,15 @@
+import { Document } from '@gusto/embedded-api/models/components/document';
+/**
+ * Returns whether a document still needs the contractor's signature.
+ *
+ * @remarks
+ * We intentionally do not defer to the API's `requiresSigning` flag here: an
+ * unsigned document whose template is not yet prepared comes back with
+ * `requiresSigning: false`, and treating that as "complete" would render an
+ * unsigned document as signed. Keying off `signedAt` keeps "complete" meaning
+ * "actually signed" everywhere this is used — the contractor onboarding
+ * document list and the management documents card.
+ *
+ * @internal
+ */
+export declare function requiresSignature(document: Document): boolean;

package/dist/components/Contractor/Documents/shared/documentSigningStatus.js

@@ -0,0 +1,7 @@
+function r(e) {
+  return !e.signedAt;
+}
+export {
+  r as requiresSignature
+};
+//# sourceMappingURL=documentSigningStatus.js.map

package/dist/components/Contractor/Documents/shared/documentSigningStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentSigningStatus.js","sources":["../../../../../src/components/Contractor/Documents/shared/documentSigningStatus.ts"],"sourcesContent":["import type { Document } from '@gusto/embedded-api/models/components/document'\n\n/**\n * Returns whether a document still needs the contractor's signature.\n *\n * @remarks\n * We intentionally do not defer to the API's `requiresSigning` flag here: an\n * unsigned document whose template is not yet prepared comes back with\n * `requiresSigning: false`, and treating that as \"complete\" would render an\n * unsigned document as signed. Keying off `signedAt` keeps \"complete\" meaning\n * \"actually signed\" everywhere this is used — the contractor onboarding\n * document list and the management documents card.\n *\n * @internal\n */\nexport function requiresSignature(document: Document): boolean {\n  return !document.signedAt\n}\n"],"names":["requiresSignature","document"],"mappings":"AAeO,SAASA,EAAkBC,GAA6B;AAC7D,SAAO,CAACA,EAAS;AACnB;"}

package/dist/components/Contractor/Documents/shared/documentSigningStatus.test.d.ts

@@ -0,0 +1 @@
+export {};

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

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

package/dist/components/Contractor/OnboardingFlow/OnboardingFlowComponents.d.ts

@@ -1,5 +1,5 @@
 import { ContractorDetailsFormData } from '../Profile/shared';
-import { AddressDefaultValues } from '../Address';
+import { AddressDefaultValues } from '../Address/onboarding/types';
 import { FlowContextInterface } from '../../Flow/useFlow';
 import { RequireAtLeastOne } from '../../../types/Helpers';
 import { BaseComponentInterface } from '../../Base';

package/dist/components/Contractor/OnboardingFlow/OnboardingFlowComponents.js

@@ -1,16 +1,16 @@
 import { jsx as n } from "react/jsx-runtime";
 import { useTranslation as s } from "react-i18next";
-import { ContractorList as i } from "../ContractorList/index.js";
-import { PaymentMethod as u } from "../PaymentMethod/PaymentMethod.js";
-import { NewHireReport as m } from "../NewHireReport/NewHireReport.js";
-import { ContractorSubmit as d } from "../Submit/Submit.js";
+import { ContractorList as i } from "../ContractorList/onboarding/ContractorList.js";
+import { ContractorProfile as u } from "../Profile/onboarding/ContractorProfile.js";
+import { Address as m } from "../Address/onboarding/Address.js";
+import { PaymentMethod as d } from "../PaymentMethod/onboarding/PaymentMethod.js";
+import { NewHireReport as f } from "../NewHireReport/NewHireReport.js";
+import { ContractorSubmit as p } from "../Submit/Submit.js";
 import { useFlow as e } from "../../Flow/useFlow.js";
 import { ensureRequired as c } from "../../../helpers/ensureRequired.js";
-import { useComponentContext as f } from "../../../contexts/ComponentAdapter/useComponentContext.js";
-import { useI18n as p } from "../../../i18n/I18n.js";
-import { componentEvents as l } from "../../../shared/constants.js";
-import { Address as C } from "../Address/Address.js";
-import { ContractorProfile as I } from "../Profile/ContractorProfile.js";
+import { useComponentContext as l } from "../../../contexts/ComponentAdapter/useComponentContext.js";
+import { useI18n as C } from "../../../i18n/I18n.js";
+import { componentEvents as I } from "../../../shared/constants.js";
 function M() {
   const { companyId: t, onEvent: o, successMessage: r } = e();
   return /* @__PURE__ */ n(
@@ -25,7 +25,7 @@ function M() {
 function N() {
   const { companyId: t, onEvent: o, contractorId: r, defaultValues: a } = e();
   return /* @__PURE__ */ n(
-    I,
+    u,
     {
       onEvent: o,
       companyId: c(t),
@@ -37,7 +37,7 @@ function N() {
 function R() {
   const { onEvent: t, contractorId: o, defaultValues: r } = e();
   return /* @__PURE__ */ n(
-    C,
+    m,
     {
       onEvent: t,
       contractorId: c(o),
@@ -47,12 +47,12 @@ function R() {
 }
 function H() {
   const { onEvent: t, contractorId: o } = e();
-  return /* @__PURE__ */ n(u, { onEvent: t, contractorId: c(o) });
+  return /* @__PURE__ */ n(d, { onEvent: t, contractorId: c(o) });
 }
 function O() {
   const { onEvent: t, contractorId: o, selfOnboarding: r } = e();
   return /* @__PURE__ */ n(
-    m,
+    f,
     {
       onEvent: t,
       contractorId: c(o),
@@ -63,7 +63,7 @@ function O() {
 function S() {
   const { onEvent: t, contractorId: o, selfOnboarding: r } = e();
   return /* @__PURE__ */ n(
-    d,
+    p,
     {
       onEvent: t,
       contractorId: c(o),
@@ -72,14 +72,14 @@ function S() {
   );
 }
 function j() {
-  const { onEvent: t } = e(), { Button: o } = f();
-  p("Contractor.ContractorList");
+  const { onEvent: t } = e(), { Button: o } = l();
+  C("Contractor.ContractorList");
   const { t: r } = s("Contractor.ContractorList");
   return /* @__PURE__ */ n(
     o,
     {
       onClick: () => {
-        t(l.CANCEL);
+        t(I.CANCEL);
       },
       variant: "secondary",
       children: r("progressBarCta")

package/dist/components/Contractor/OnboardingFlow/OnboardingFlowComponents.js.map

@@ -1 +1 @@
-{"version":3,"file":"OnboardingFlowComponents.js","sources":["../../../../src/components/Contractor/OnboardingFlow/OnboardingFlowComponents.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport { ContractorList } from '../ContractorList'\nimport { ContractorProfile } from '../Profile'\nimport { Address } from '../Address'\nimport { PaymentMethod } from '../PaymentMethod/PaymentMethod'\nimport { NewHireReport } from '../NewHireReport/NewHireReport'\nimport { ContractorSubmit } from '../Submit/Submit'\nimport type { ContractorDetailsFormData } from '../Profile/shared'\nimport type { AddressDefaultValues } from '../Address'\nimport { useFlow, type FlowContextInterface } from '@/components/Flow/useFlow'\nimport type { RequireAtLeastOne } from '@/types/Helpers'\nimport type { BaseComponentInterface } from '@/components/Base'\nimport { ensureRequired } from '@/helpers/ensureRequired'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { useI18n } from '@/i18n'\nimport { componentEvents } from '@/shared/constants'\n\n/**\n * Default pre-fill values for the contractor onboarding flow.\n * At least one of `profile` or `address` must be provided.\n *\n * @public\n */\nexport type OnboardingFlowDefaultValues = RequireAtLeastOne<{\n  profile?: Partial<ContractorDetailsFormData>\n  address?: AddressDefaultValues\n}>\n/**\n * Props for {@link OnboardingFlow}.\n *\n * @public\n */\nexport interface OnboardingFlowProps extends BaseComponentInterface<never> {\n  /** The associated company identifier. */\n  companyId: string\n  /** Default values for individual flow step components — `profile` and/or `address` sub-objects. */\n  defaultValues?: RequireAtLeastOne<OnboardingFlowDefaultValues>\n}\n/** @internal */\nexport interface OnboardingFlowContextInterface extends FlowContextInterface {\n  /** The associated company identifier. */\n  companyId: string\n  /** The contractor currently being onboarded; populated once the profile step creates or selects one. */\n  contractorId?: string\n  /** Default values for individual flow step components. */\n  defaultValues?: OnboardingFlowDefaultValues\n  /** True when the contractor will be self-onboarding; switches the flow to the shorter self-onboarding path. */\n  selfOnboarding?: boolean\n  /** True while the new hire report step should be shown; false once the contractor has advanced past the admin's initial onboarding pass. */\n  showNewHireReport?: boolean\n  /** Success message to display on the contractor list when returning from a completed sub-flow. */\n  successMessage?: string\n}\n\n/** @internal */\nexport function ContractorListContextual() {\n  const { companyId, onEvent, successMessage } = useFlow<OnboardingFlowContextInterface>()\n  return (\n    <ContractorList\n      onEvent={onEvent}\n      companyId={ensureRequired(companyId)}\n      successMessage={successMessage}\n    />\n  )\n}\n\n/** @internal */\nexport function ProfileContextual() {\n  const { companyId, onEvent, contractorId, defaultValues } =\n    useFlow<OnboardingFlowContextInterface>()\n  return (\n    <ContractorProfile\n      onEvent={onEvent}\n      companyId={ensureRequired(companyId)}\n      contractorId={contractorId}\n      defaultValues={defaultValues?.profile}\n    />\n  )\n}\n\n/** @internal */\nexport function AddressContextual() {\n  const { onEvent, contractorId, defaultValues } = useFlow<OnboardingFlowContextInterface>()\n  return (\n    <Address\n      onEvent={onEvent}\n      contractorId={ensureRequired(contractorId)}\n      defaultValues={defaultValues?.address}\n    />\n  )\n}\n/** @internal */\nexport function PaymentMethodContextual() {\n  const { onEvent, contractorId } = useFlow<OnboardingFlowContextInterface>()\n  return <PaymentMethod onEvent={onEvent} contractorId={ensureRequired(contractorId)} />\n}\n/** @internal */\nexport function NewHireReportContextual() {\n  const { onEvent, contractorId, selfOnboarding } = useFlow<OnboardingFlowContextInterface>()\n  return (\n    <NewHireReport\n      onEvent={onEvent}\n      contractorId={ensureRequired(contractorId)}\n      selfOnboarding={selfOnboarding}\n    />\n  )\n}\n/** @internal */\nexport function SubmitContextual() {\n  const { onEvent, contractorId, selfOnboarding } = useFlow<OnboardingFlowContextInterface>()\n  return (\n    <ContractorSubmit\n      onEvent={onEvent}\n      contractorId={ensureRequired(contractorId)}\n      selfOnboarding={selfOnboarding}\n    />\n  )\n}\n\n/** @internal */\nexport function ProgressBarCta() {\n  const { onEvent } = useFlow<OnboardingFlowContextInterface>()\n  const { Button } = useComponentContext()\n  useI18n('Contractor.ContractorList')\n  const { t } = useTranslation('Contractor.ContractorList')\n  return (\n    <Button\n      onClick={() => {\n        onEvent(componentEvents.CANCEL)\n      }}\n      variant=\"secondary\"\n    >\n      {t('progressBarCta')}\n    </Button>\n  )\n}\n"],"names":["ContractorListContextual","companyId","onEvent","successMessage","useFlow","jsx","ContractorList","ensureRequired","ProfileContextual","contractorId","defaultValues","ContractorProfile","AddressContextual","Address","PaymentMethodContextual","PaymentMethod","NewHireReportContextual","selfOnboarding","NewHireReport","SubmitContextual","ContractorSubmit","ProgressBarCta","Button","useComponentContext","useI18n","t","useTranslation","componentEvents"],"mappings":";;;;;;;;;;;;;AAuDO,SAASA,IAA2B;AACzC,QAAM,EAAE,WAAAC,GAAW,SAAAC,GAAS,gBAAAC,EAAA,IAAmBC,EAAA;AAC/C,SACE,gBAAAC;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,SAAAJ;AAAA,MACA,WAAWK,EAAeN,CAAS;AAAA,MACnC,gBAAAE;AAAA,IAAA;AAAA,EAAA;AAGN;AAGO,SAASK,IAAoB;AAClC,QAAM,EAAE,WAAAP,GAAW,SAAAC,GAAS,cAAAO,GAAc,eAAAC,EAAA,IACxCN,EAAA;AACF,SACE,gBAAAC;AAAA,IAACM;AAAA,IAAA;AAAA,MACC,SAAAT;AAAA,MACA,WAAWK,EAAeN,CAAS;AAAA,MACnC,cAAAQ;AAAA,MACA,eAAeC,GAAe;AAAA,IAAA;AAAA,EAAA;AAGpC;AAGO,SAASE,IAAoB;AAClC,QAAM,EAAE,SAAAV,GAAS,cAAAO,GAAc,eAAAC,EAAA,IAAkBN,EAAA;AACjD,SACE,gBAAAC;AAAA,IAACQ;AAAA,IAAA;AAAA,MACC,SAAAX;AAAA,MACA,cAAcK,EAAeE,CAAY;AAAA,MACzC,eAAeC,GAAe;AAAA,IAAA;AAAA,EAAA;AAGpC;AAEO,SAASI,IAA0B;AACxC,QAAM,EAAE,SAAAZ,GAAS,cAAAO,EAAA,IAAiBL,EAAA;AAClC,2BAAQW,GAAA,EAAc,SAAAb,GAAkB,cAAcK,EAAeE,CAAY,GAAG;AACtF;AAEO,SAASO,IAA0B;AACxC,QAAM,EAAE,SAAAd,GAAS,cAAAO,GAAc,gBAAAQ,EAAA,IAAmBb,EAAA;AAClD,SACE,gBAAAC;AAAA,IAACa;AAAA,IAAA;AAAA,MACC,SAAAhB;AAAA,MACA,cAAcK,EAAeE,CAAY;AAAA,MACzC,gBAAAQ;AAAA,IAAA;AAAA,EAAA;AAGN;AAEO,SAASE,IAAmB;AACjC,QAAM,EAAE,SAAAjB,GAAS,cAAAO,GAAc,gBAAAQ,EAAA,IAAmBb,EAAA;AAClD,SACE,gBAAAC;AAAA,IAACe;AAAA,IAAA;AAAA,MACC,SAAAlB;AAAA,MACA,cAAcK,EAAeE,CAAY;AAAA,MACzC,gBAAAQ;AAAA,IAAA;AAAA,EAAA;AAGN;AAGO,SAASI,IAAiB;AAC/B,QAAM,EAAE,SAAAnB,EAAA,IAAYE,EAAA,GACd,EAAE,QAAAkB,EAAA,IAAWC,EAAA;AACnB,EAAAC,EAAQ,2BAA2B;AACnC,QAAM,EAAE,GAAAC,EAAA,IAAMC,EAAe,2BAA2B;AACxD,SACE,gBAAArB;AAAA,IAACiB;AAAA,IAAA;AAAA,MACC,SAAS,MAAM;AACb,QAAApB,EAAQyB,EAAgB,MAAM;AAAA,MAChC;AAAA,MACA,SAAQ;AAAA,MAEP,YAAE,gBAAgB;AAAA,IAAA;AAAA,EAAA;AAGzB;"}
+{"version":3,"file":"OnboardingFlowComponents.js","sources":["../../../../src/components/Contractor/OnboardingFlow/OnboardingFlowComponents.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport { ContractorList } from '../ContractorList/onboarding/ContractorList'\nimport { ContractorProfile } from '../Profile/onboarding/ContractorProfile'\nimport { Address } from '../Address/onboarding/Address'\nimport { PaymentMethod } from '../PaymentMethod/onboarding/PaymentMethod'\nimport { NewHireReport } from '../NewHireReport/NewHireReport'\nimport { ContractorSubmit } from '../Submit/Submit'\nimport type { ContractorDetailsFormData } from '../Profile/shared'\nimport type { AddressDefaultValues } from '../Address/onboarding/types'\nimport { useFlow, type FlowContextInterface } from '@/components/Flow/useFlow'\nimport type { RequireAtLeastOne } from '@/types/Helpers'\nimport type { BaseComponentInterface } from '@/components/Base'\nimport { ensureRequired } from '@/helpers/ensureRequired'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { useI18n } from '@/i18n'\nimport { componentEvents } from '@/shared/constants'\n\n/**\n * Default pre-fill values for the contractor onboarding flow.\n * At least one of `profile` or `address` must be provided.\n *\n * @public\n */\nexport type OnboardingFlowDefaultValues = RequireAtLeastOne<{\n  profile?: Partial<ContractorDetailsFormData>\n  address?: AddressDefaultValues\n}>\n/**\n * Props for {@link OnboardingFlow}.\n *\n * @public\n */\nexport interface OnboardingFlowProps extends BaseComponentInterface<never> {\n  /** The associated company identifier. */\n  companyId: string\n  /** Default values for individual flow step components — `profile` and/or `address` sub-objects. */\n  defaultValues?: RequireAtLeastOne<OnboardingFlowDefaultValues>\n}\n/** @internal */\nexport interface OnboardingFlowContextInterface extends FlowContextInterface {\n  /** The associated company identifier. */\n  companyId: string\n  /** The contractor currently being onboarded; populated once the profile step creates or selects one. */\n  contractorId?: string\n  /** Default values for individual flow step components. */\n  defaultValues?: OnboardingFlowDefaultValues\n  /** True when the contractor will be self-onboarding; switches the flow to the shorter self-onboarding path. */\n  selfOnboarding?: boolean\n  /** True while the new hire report step should be shown; false once the contractor has advanced past the admin's initial onboarding pass. */\n  showNewHireReport?: boolean\n  /** Success message to display on the contractor list when returning from a completed sub-flow. */\n  successMessage?: string\n}\n\n/** @internal */\nexport function ContractorListContextual() {\n  const { companyId, onEvent, successMessage } = useFlow<OnboardingFlowContextInterface>()\n  return (\n    <ContractorList\n      onEvent={onEvent}\n      companyId={ensureRequired(companyId)}\n      successMessage={successMessage}\n    />\n  )\n}\n\n/** @internal */\nexport function ProfileContextual() {\n  const { companyId, onEvent, contractorId, defaultValues } =\n    useFlow<OnboardingFlowContextInterface>()\n  return (\n    <ContractorProfile\n      onEvent={onEvent}\n      companyId={ensureRequired(companyId)}\n      contractorId={contractorId}\n      defaultValues={defaultValues?.profile}\n    />\n  )\n}\n\n/** @internal */\nexport function AddressContextual() {\n  const { onEvent, contractorId, defaultValues } = useFlow<OnboardingFlowContextInterface>()\n  return (\n    <Address\n      onEvent={onEvent}\n      contractorId={ensureRequired(contractorId)}\n      defaultValues={defaultValues?.address}\n    />\n  )\n}\n/** @internal */\nexport function PaymentMethodContextual() {\n  const { onEvent, contractorId } = useFlow<OnboardingFlowContextInterface>()\n  return <PaymentMethod onEvent={onEvent} contractorId={ensureRequired(contractorId)} />\n}\n/** @internal */\nexport function NewHireReportContextual() {\n  const { onEvent, contractorId, selfOnboarding } = useFlow<OnboardingFlowContextInterface>()\n  return (\n    <NewHireReport\n      onEvent={onEvent}\n      contractorId={ensureRequired(contractorId)}\n      selfOnboarding={selfOnboarding}\n    />\n  )\n}\n/** @internal */\nexport function SubmitContextual() {\n  const { onEvent, contractorId, selfOnboarding } = useFlow<OnboardingFlowContextInterface>()\n  return (\n    <ContractorSubmit\n      onEvent={onEvent}\n      contractorId={ensureRequired(contractorId)}\n      selfOnboarding={selfOnboarding}\n    />\n  )\n}\n\n/** @internal */\nexport function ProgressBarCta() {\n  const { onEvent } = useFlow<OnboardingFlowContextInterface>()\n  const { Button } = useComponentContext()\n  useI18n('Contractor.ContractorList')\n  const { t } = useTranslation('Contractor.ContractorList')\n  return (\n    <Button\n      onClick={() => {\n        onEvent(componentEvents.CANCEL)\n      }}\n      variant=\"secondary\"\n    >\n      {t('progressBarCta')}\n    </Button>\n  )\n}\n"],"names":["ContractorListContextual","companyId","onEvent","successMessage","useFlow","jsx","ContractorList","ensureRequired","ProfileContextual","contractorId","defaultValues","ContractorProfile","AddressContextual","Address","PaymentMethodContextual","PaymentMethod","NewHireReportContextual","selfOnboarding","NewHireReport","SubmitContextual","ContractorSubmit","ProgressBarCta","Button","useComponentContext","useI18n","t","useTranslation","componentEvents"],"mappings":";;;;;;;;;;;;;AAuDO,SAASA,IAA2B;AACzC,QAAM,EAAE,WAAAC,GAAW,SAAAC,GAAS,gBAAAC,EAAA,IAAmBC,EAAA;AAC/C,SACE,gBAAAC;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,SAAAJ;AAAA,MACA,WAAWK,EAAeN,CAAS;AAAA,MACnC,gBAAAE;AAAA,IAAA;AAAA,EAAA;AAGN;AAGO,SAASK,IAAoB;AAClC,QAAM,EAAE,WAAAP,GAAW,SAAAC,GAAS,cAAAO,GAAc,eAAAC,EAAA,IACxCN,EAAA;AACF,SACE,gBAAAC;AAAA,IAACM;AAAA,IAAA;AAAA,MACC,SAAAT;AAAA,MACA,WAAWK,EAAeN,CAAS;AAAA,MACnC,cAAAQ;AAAA,MACA,eAAeC,GAAe;AAAA,IAAA;AAAA,EAAA;AAGpC;AAGO,SAASE,IAAoB;AAClC,QAAM,EAAE,SAAAV,GAAS,cAAAO,GAAc,eAAAC,EAAA,IAAkBN,EAAA;AACjD,SACE,gBAAAC;AAAA,IAACQ;AAAA,IAAA;AAAA,MACC,SAAAX;AAAA,MACA,cAAcK,EAAeE,CAAY;AAAA,MACzC,eAAeC,GAAe;AAAA,IAAA;AAAA,EAAA;AAGpC;AAEO,SAASI,IAA0B;AACxC,QAAM,EAAE,SAAAZ,GAAS,cAAAO,EAAA,IAAiBL,EAAA;AAClC,2BAAQW,GAAA,EAAc,SAAAb,GAAkB,cAAcK,EAAeE,CAAY,GAAG;AACtF;AAEO,SAASO,IAA0B;AACxC,QAAM,EAAE,SAAAd,GAAS,cAAAO,GAAc,gBAAAQ,EAAA,IAAmBb,EAAA;AAClD,SACE,gBAAAC;AAAA,IAACa;AAAA,IAAA;AAAA,MACC,SAAAhB;AAAA,MACA,cAAcK,EAAeE,CAAY;AAAA,MACzC,gBAAAQ;AAAA,IAAA;AAAA,EAAA;AAGN;AAEO,SAASE,IAAmB;AACjC,QAAM,EAAE,SAAAjB,GAAS,cAAAO,GAAc,gBAAAQ,EAAA,IAAmBb,EAAA;AAClD,SACE,gBAAAC;AAAA,IAACe;AAAA,IAAA;AAAA,MACC,SAAAlB;AAAA,MACA,cAAcK,EAAeE,CAAY;AAAA,MACzC,gBAAAQ;AAAA,IAAA;AAAA,EAAA;AAGN;AAGO,SAASI,IAAiB;AAC/B,QAAM,EAAE,SAAAnB,EAAA,IAAYE,EAAA,GACd,EAAE,QAAAkB,EAAA,IAAWC,EAAA;AACnB,EAAAC,EAAQ,2BAA2B;AACnC,QAAM,EAAE,GAAAC,EAAA,IAAMC,EAAe,2BAA2B;AACxD,SACE,gBAAArB;AAAA,IAACiB;AAAA,IAAA;AAAA,MACC,SAAS,MAAM;AACb,QAAApB,EAAQyB,EAAgB,MAAM;AAAA,MAChC;AAAA,MACA,SAAQ;AAAA,MAEP,YAAE,gBAAgB;AAAA,IAAA;AAAA,EAAA;AAGzB;"}

package/dist/components/Contractor/OnboardingSummary/OnboardingSummary.js

@@ -5,15 +5,14 @@ import { useBase as l } from "../../Base/useBase.js";
 import { Flex as i } from "../../Common/Flex/Flex.js";
 import { ActionsLayout as d } from "../../Common/ActionsLayout/ActionsLayout.js";
 import { useComponentContext as u } from "../../../contexts/ComponentAdapter/useComponentContext.js";
-import "react";
-import { useI18n as f, useComponentDictionary as p } from "../../../i18n/I18n.js";
-import { componentEvents as C } from "../../../shared/constants.js";
-function N(t) {
-  return f("Contractor.OnboardingSummary"), p("Contractor.OnboardingSummary", t.dictionary), /* @__PURE__ */ n(s, { ...t, children: /* @__PURE__ */ n(h, { ...t, children: t.children }) });
+import { useI18n as f, useComponentDictionary as C } from "../../../i18n/I18n.js";
+import { componentEvents as p } from "../../../shared/constants.js";
+function E(t) {
+  return f("Contractor.OnboardingSummary"), C("Contractor.OnboardingSummary", t.dictionary), /* @__PURE__ */ n(s, { ...t, children: /* @__PURE__ */ n(h, { ...t, children: t.children }) });
 }
-const h = ({ contractorId: t, className: m }) => {
-  const { onEvent: c } = l(), { t: o } = a("Contractor.OnboardingSummary"), r = u();
-  return /* @__PURE__ */ n("section", { className: m, children: /* @__PURE__ */ e(i, { flexDirection: "column", gap: 32, children: [
+const h = ({ contractorId: t, className: c }) => {
+  const { onEvent: m } = l(), { t: o } = a("Contractor.OnboardingSummary"), r = u();
+  return /* @__PURE__ */ n("section", { className: c, children: /* @__PURE__ */ e(i, { flexDirection: "column", gap: 32, children: [
     /* @__PURE__ */ e(i, { alignItems: "center", flexDirection: "column", gap: 8, children: [
       /* @__PURE__ */ n(r.Heading, { as: "h2", textAlign: "center", children: o("subtitle") }),
       /* @__PURE__ */ n(r.Text, { textAlign: "center", children: o("description") })
@@ -23,7 +22,7 @@ const h = ({ contractorId: t, className: m }) => {
       {
         variant: "secondary",
         onClick: () => {
-          c(C.CONTRACTOR_SELF_ONBOARDING_DONE, { contractorId: t });
+          m(p.CONTRACTOR_SELF_ONBOARDING_DONE, { contractorId: t });
         },
         children: o("doneCta")
       }
@@ -31,6 +30,6 @@ const h = ({ contractorId: t, className: m }) => {
   ] }) });
 };
 export {
-  N as OnboardingSummary
+  E as OnboardingSummary
 };
 //# sourceMappingURL=OnboardingSummary.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"OnboardingSummary.js","sources":["../../../../src/components/Contractor/OnboardingSummary/OnboardingSummary.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\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'\n\n/**\n * Props for {@link OnboardingSummary}.\n *\n * @public\n */\nexport interface OnboardingSummaryProps extends BaseComponentInterface<'Contractor.OnboardingSummary'> {\n  /** UUID of the contractor who completed self-onboarding. */\n  contractorId: string\n}\n\n/**\n * Confirmation screen shown at the end of the contractor self-onboarding flow.\n * Lets the contractor know their information has been submitted and emits\n * `contractor/selfOnboarding/done` when they acknowledge it.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `contractor/selfOnboarding/done` | Fired when the contractor acknowledges completion and clicks the Done button | `{ contractorId: string }` |\n *\n * @public\n */\nexport function OnboardingSummary(props: OnboardingSummaryProps) {\n  useI18n('Contractor.OnboardingSummary')\n  useComponentDictionary('Contractor.OnboardingSummary', props.dictionary)\n\n  return (\n    <BaseComponent {...props}>\n      <Root {...props}>{props.children}</Root>\n    </BaseComponent>\n  )\n}\n\nconst Root = ({ contractorId, className }: OnboardingSummaryProps) => {\n  const { onEvent } = useBase()\n  const { t } = useTranslation('Contractor.OnboardingSummary')\n  const Components = useComponentContext()\n\n  return (\n    <section className={className}>\n      <Flex flexDirection=\"column\" gap={32}>\n        <Flex alignItems=\"center\" flexDirection=\"column\" gap={8}>\n          <Components.Heading as=\"h2\" textAlign=\"center\">\n            {t('subtitle')}\n          </Components.Heading>\n          <Components.Text textAlign=\"center\">{t('description')}</Components.Text>\n        </Flex>\n        <ActionsLayout justifyContent=\"center\">\n          <Components.Button\n            variant=\"secondary\"\n            onClick={() => {\n              onEvent(componentEvents.CONTRACTOR_SELF_ONBOARDING_DONE, { contractorId })\n            }}\n          >\n            {t('doneCta')}\n          </Components.Button>\n        </ActionsLayout>\n      </Flex>\n    </section>\n  )\n}\n"],"names":["OnboardingSummary","props","useI18n","useComponentDictionary","jsx","BaseComponent","Root","contractorId","className","onEvent","useBase","t","useTranslation","Components","useComponentContext","jsxs","Flex","ActionsLayout","componentEvents"],"mappings":";;;;;;;;;;AA8BO,SAASA,EAAkBC,GAA+B;AAC/D,SAAAC,EAAQ,8BAA8B,GACtCC,EAAuB,gCAAgCF,EAAM,UAAU,GAGrE,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,QAAwC;AACpE,QAAM,EAAE,SAAAC,EAAA,IAAYC,EAAA,GACd,EAAE,GAAAC,EAAA,IAAMC,EAAe,8BAA8B,GACrDC,IAAaC,EAAA;AAEnB,SACE,gBAAAV,EAAC,aAAQ,WAAAI,GACP,UAAA,gBAAAO,EAACC,KAAK,eAAc,UAAS,KAAK,IAChC,UAAA;AAAA,IAAA,gBAAAD,EAACC,KAAK,YAAW,UAAS,eAAc,UAAS,KAAK,GACpD,UAAA;AAAA,MAAA,gBAAAZ,EAACS,EAAW,SAAX,EAAmB,IAAG,MAAK,WAAU,UACnC,UAAAF,EAAE,UAAU,EAAA,CACf;AAAA,MACA,gBAAAP,EAACS,EAAW,MAAX,EAAgB,WAAU,UAAU,UAAAF,EAAE,aAAa,EAAA,CAAE;AAAA,IAAA,GACxD;AAAA,IACA,gBAAAP,EAACa,GAAA,EAAc,gBAAe,UAC5B,UAAA,gBAAAb;AAAA,MAACS,EAAW;AAAA,MAAX;AAAA,QACC,SAAQ;AAAA,QACR,SAAS,MAAM;AACb,UAAAJ,EAAQS,EAAgB,iCAAiC,EAAE,cAAAX,EAAA,CAAc;AAAA,QAC3E;AAAA,QAEC,YAAE,SAAS;AAAA,MAAA;AAAA,IAAA,EACd,CACF;AAAA,EAAA,EAAA,CACF,EAAA,CACF;AAEJ;"}
+{"version":3,"file":"OnboardingSummary.js","sources":["../../../../src/components/Contractor/OnboardingSummary/OnboardingSummary.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\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'\n\n/**\n * Props for {@link OnboardingSummary}.\n *\n * @public\n */\nexport interface OnboardingSummaryProps extends BaseComponentInterface<'Contractor.OnboardingSummary'> {\n  /** UUID of the contractor who completed self-onboarding. */\n  contractorId: string\n}\n\n/**\n * Confirmation screen shown at the end of the contractor self-onboarding flow.\n * Lets the contractor know their information has been submitted and emits\n * `contractor/selfOnboarding/done` when they acknowledge it.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `contractor/selfOnboarding/done` | Fired when the contractor acknowledges completion and clicks the Done button | `{ contractorId: string }` |\n *\n * @public\n */\nexport function OnboardingSummary(props: OnboardingSummaryProps) {\n  useI18n('Contractor.OnboardingSummary')\n  useComponentDictionary('Contractor.OnboardingSummary', props.dictionary)\n\n  return (\n    <BaseComponent {...props}>\n      <Root {...props}>{props.children}</Root>\n    </BaseComponent>\n  )\n}\n\nconst Root = ({ contractorId, className }: OnboardingSummaryProps) => {\n  const { onEvent } = useBase()\n  const { t } = useTranslation('Contractor.OnboardingSummary')\n  const Components = useComponentContext()\n\n  return (\n    <section className={className}>\n      <Flex flexDirection=\"column\" gap={32}>\n        <Flex alignItems=\"center\" flexDirection=\"column\" gap={8}>\n          <Components.Heading as=\"h2\" textAlign=\"center\">\n            {t('subtitle')}\n          </Components.Heading>\n          <Components.Text textAlign=\"center\">{t('description')}</Components.Text>\n        </Flex>\n        <ActionsLayout justifyContent=\"center\">\n          <Components.Button\n            variant=\"secondary\"\n            onClick={() => {\n              onEvent(componentEvents.CONTRACTOR_SELF_ONBOARDING_DONE, { contractorId })\n            }}\n          >\n            {t('doneCta')}\n          </Components.Button>\n        </ActionsLayout>\n      </Flex>\n    </section>\n  )\n}\n"],"names":["OnboardingSummary","props","useI18n","useComponentDictionary","jsx","BaseComponent","Root","contractorId","className","onEvent","useBase","t","useTranslation","Components","useComponentContext","jsxs","Flex","ActionsLayout","componentEvents"],"mappings":";;;;;;;;;AA8BO,SAASA,EAAkBC,GAA+B;AAC/D,SAAAC,EAAQ,8BAA8B,GACtCC,EAAuB,gCAAgCF,EAAM,UAAU,GAGrE,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,QAAwC;AACpE,QAAM,EAAE,SAAAC,EAAA,IAAYC,EAAA,GACd,EAAE,GAAAC,EAAA,IAAMC,EAAe,8BAA8B,GACrDC,IAAaC,EAAA;AAEnB,SACE,gBAAAV,EAAC,aAAQ,WAAAI,GACP,UAAA,gBAAAO,EAACC,KAAK,eAAc,UAAS,KAAK,IAChC,UAAA;AAAA,IAAA,gBAAAD,EAACC,KAAK,YAAW,UAAS,eAAc,UAAS,KAAK,GACpD,UAAA;AAAA,MAAA,gBAAAZ,EAACS,EAAW,SAAX,EAAmB,IAAG,MAAK,WAAU,UACnC,UAAAF,EAAE,UAAU,EAAA,CACf;AAAA,MACA,gBAAAP,EAACS,EAAW,MAAX,EAAgB,WAAU,UAAU,UAAAF,EAAE,aAAa,EAAA,CAAE;AAAA,IAAA,GACxD;AAAA,IACA,gBAAAP,EAACa,GAAA,EAAc,gBAAe,UAC5B,UAAA,gBAAAb;AAAA,MAACS,EAAW;AAAA,MAAX;AAAA,QACC,SAAQ;AAAA,QACR,SAAS,MAAM;AACb,UAAAJ,EAAQS,EAAgB,iCAAiC,EAAE,cAAAX,EAAA,CAAc;AAAA,QAC3E;AAAA,QAEC,YAAE,SAAS;AAAA,MAAA;AAAA,IAAA,EACd,CACF;AAAA,EAAA,EAAA,CACF,EAAA,CACF;AAEJ;"}

package/dist/components/Contractor/PaymentMethod/management/PaymentMethod.d.ts

@@ -0,0 +1,32 @@
+import { BaseComponentInterface } from '../../../Base';
+/**
+ * Props for {@link PaymentMethod}.
+ *
+ * @public
+ */
+export interface PaymentMethodProps extends BaseComponentInterface<'Contractor.Management.PaymentMethod'> {
+    /** The associated contractor identifier. */
+    contractorId: string;
+}
+/**
+ * Management surface for viewing and editing a contractor's payment method after onboarding.
+ *
+ * @remarks
+ * Drives the read-view card and bank-account form via an internal state
+ * machine. Emits events on the supplied `onEvent` handler when the user
+ * requests to add or edit a bank account, saves changes, or cancels.
+ *
+ * @events
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `contractor/management/paymentMethod/card/addRequested` | Fired when the user clicks "Add bank account" on the read-view card | `{ contractorId: string }` |
+ * | `contractor/management/paymentMethod/card/editRequested` | Fired when the user chooses "Edit" from the bank account row menu | `{ contractorId: string }` |
+ * | `contractor/management/paymentMethod/card/removed` | Fired after the bank account is removed and the payment method reverts to Check | {@link APIModels.ContractorPaymentMethod} |
+ * | `contractor/management/paymentMethod/bankForm/submitted` | Fired after the bank-account form is successfully saved | {@link APIModels.ContractorBankAccount} |
+ * | `contractor/management/paymentMethod/bankForm/cancelled` | Fired when the user cancels the bank-account form | — |
+ *
+ * @param props - See {@link PaymentMethodProps}.
+ * @returns The contractor payment method management surface.
+ * @public
+ */
+export declare function PaymentMethod({ dictionary, FallbackComponent, LoaderComponent, ...props }: PaymentMethodProps): import("react").JSX.Element;

package/dist/components/Contractor/PaymentMethod/management/PaymentMethod.js

@@ -0,0 +1,43 @@
+import { jsx as r } from "react/jsx-runtime";
+import { createMachine as a } from "robot3";
+import { useMemo as i } from "react";
+import { CardContextual as c } from "./PaymentMethodComponents.js";
+import { paymentMethodStateMachine as p } from "./paymentMethodStateMachine.js";
+import { Flow as M } from "../../../Flow/Flow.js";
+import { BaseBoundaries as u } from "../../../Base/Base.js";
+import "../../../Base/useBase.js";
+import { useComponentDictionary as f, useI18n as h } from "../../../../i18n/I18n.js";
+function s({ contractorId: e, onEvent: o, LoaderComponent: t }) {
+  h("Contractor.Management.PaymentMethod");
+  const n = i(
+    () => a("card", p, (m) => ({
+      ...m,
+      component: c,
+      contractorId: e,
+      successAlert: null,
+      LoaderComponent: t
+    })),
+    [e, t]
+  );
+  return /* @__PURE__ */ r(M, { machine: n, onEvent: o });
+}
+function F({
+  dictionary: e,
+  FallbackComponent: o,
+  LoaderComponent: t,
+  ...n
+}) {
+  return f("Contractor.Management.PaymentMethod", e), /* @__PURE__ */ r(
+    u,
+    {
+      componentName: "Contractor.Management.PaymentMethod",
+      FallbackComponent: o,
+      LoaderComponent: t,
+      children: /* @__PURE__ */ r(s, { LoaderComponent: t, ...n })
+    }
+  );
+}
+export {
+  F as PaymentMethod
+};
+//# sourceMappingURL=PaymentMethod.js.map

package/dist/components/Contractor/PaymentMethod/management/PaymentMethod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PaymentMethod.js","sources":["../../../../../src/components/Contractor/PaymentMethod/management/PaymentMethod.tsx"],"sourcesContent":["import { createMachine } from 'robot3'\nimport { useMemo } from 'react'\nimport { CardContextual, type PaymentMethodContextInterface } from './PaymentMethodComponents'\nimport { paymentMethodStateMachine } from './paymentMethodStateMachine'\nimport { Flow } from '@/components/Flow/Flow'\nimport { BaseBoundaries, type BaseComponentInterface } from '@/components/Base'\nimport { useComponentDictionary } from '@/i18n/I18n'\nimport { useI18n } from '@/i18n'\n\n/**\n * Props for {@link PaymentMethod}.\n *\n * @public\n */\nexport interface PaymentMethodProps extends BaseComponentInterface<'Contractor.Management.PaymentMethod'> {\n  /** The associated contractor identifier. */\n  contractorId: string\n}\n\nfunction PaymentMethodFlow({ contractorId, onEvent, LoaderComponent }: PaymentMethodProps) {\n  useI18n('Contractor.Management.PaymentMethod')\n\n  const machine = useMemo(\n    () =>\n      createMachine('card', paymentMethodStateMachine, (ctx: PaymentMethodContextInterface) => ({\n        ...ctx,\n        component: CardContextual,\n        contractorId,\n        successAlert: null,\n        LoaderComponent,\n      })),\n    [contractorId, LoaderComponent],\n  )\n\n  return <Flow machine={machine} onEvent={onEvent} />\n}\n\n/**\n * Management surface for viewing and editing a contractor's payment method after onboarding.\n *\n * @remarks\n * Drives the read-view card and bank-account form via an internal state\n * machine. Emits events on the supplied `onEvent` handler when the user\n * requests to add or edit a bank account, saves changes, or cancels.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `contractor/management/paymentMethod/card/addRequested` | Fired when the user clicks \"Add bank account\" on the read-view card | `{ contractorId: string }` |\n * | `contractor/management/paymentMethod/card/editRequested` | Fired when the user chooses \"Edit\" from the bank account row menu | `{ contractorId: string }` |\n * | `contractor/management/paymentMethod/card/removed` | Fired after the bank account is removed and the payment method reverts to Check | {@link APIModels.ContractorPaymentMethod} |\n * | `contractor/management/paymentMethod/bankForm/submitted` | Fired after the bank-account form is successfully saved | {@link APIModels.ContractorBankAccount} |\n * | `contractor/management/paymentMethod/bankForm/cancelled` | Fired when the user cancels the bank-account form | — |\n *\n * @param props - See {@link PaymentMethodProps}.\n * @returns The contractor payment method management surface.\n * @public\n */\nexport function PaymentMethod({\n  dictionary,\n  FallbackComponent,\n  LoaderComponent,\n  ...props\n}: PaymentMethodProps) {\n  useComponentDictionary('Contractor.Management.PaymentMethod', dictionary)\n  return (\n    <BaseBoundaries\n      componentName=\"Contractor.Management.PaymentMethod\"\n      FallbackComponent={FallbackComponent}\n      LoaderComponent={LoaderComponent}\n    >\n      <PaymentMethodFlow LoaderComponent={LoaderComponent} {...props} />\n    </BaseBoundaries>\n  )\n}\n"],"names":["PaymentMethodFlow","contractorId","onEvent","LoaderComponent","useI18n","machine","useMemo","createMachine","paymentMethodStateMachine","ctx","CardContextual","jsx","Flow","PaymentMethod","dictionary","FallbackComponent","props","useComponentDictionary","BaseBoundaries"],"mappings":";;;;;;;;;AAmBA,SAASA,EAAkB,EAAE,cAAAC,GAAc,SAAAC,GAAS,iBAAAC,KAAuC;AACzF,EAAAC,EAAQ,qCAAqC;AAE7C,QAAMC,IAAUC;AAAA,IACd,MACEC,EAAc,QAAQC,GAA2B,CAACC,OAAwC;AAAA,MACxF,GAAGA;AAAA,MACH,WAAWC;AAAA,MACX,cAAAT;AAAA,MACA,cAAc;AAAA,MACd,iBAAAE;AAAA,IAAA,EACA;AAAA,IACJ,CAACF,GAAcE,CAAe;AAAA,EAAA;AAGhC,SAAO,gBAAAQ,EAACC,GAAA,EAAK,SAAAP,GAAkB,SAAAH,EAAA,CAAkB;AACnD;AAuBO,SAASW,EAAc;AAAA,EAC5B,YAAAC;AAAA,EACA,mBAAAC;AAAA,EACA,iBAAAZ;AAAA,EACA,GAAGa;AACL,GAAuB;AACrB,SAAAC,EAAuB,uCAAuCH,CAAU,GAEtE,gBAAAH;AAAA,IAACO;AAAA,IAAA;AAAA,MACC,eAAc;AAAA,MACd,mBAAAH;AAAA,MACA,iBAAAZ;AAAA,MAEA,UAAA,gBAAAQ,EAACX,GAAA,EAAkB,iBAAAG,GAAmC,GAAGa,EAAA,CAAO;AAAA,IAAA;AAAA,EAAA;AAGtE;"}

package/dist/components/Contractor/PaymentMethod/management/PaymentMethodCard/PaymentMethodCard.d.ts

@@ -0,0 +1,37 @@
+import { EventType } from '../../../../../shared/constants';
+import { OnEventType } from '../../../../Base/useBase';
+import { LoaderComponentType } from '../../../../Base';
+/**
+ * Props for {@link PaymentMethodCard}.
+ *
+ * @public
+ */
+export interface PaymentMethodCardProps {
+    /** The associated contractor identifier. */
+    contractorId: string;
+    /** Event handler fired on card interactions. */
+    onEvent: OnEventType<EventType, unknown>;
+    /** Custom loading indicator rendered while this component's async data is fetching. Overrides the indicator configured on `GustoProvider` for this instance only. */
+    LoaderComponent?: LoaderComponentType;
+}
+/**
+ * Standalone "Payment" card showing a contractor's payment method.
+ *
+ * @remarks
+ * Fetches its own data and emits the management block's scoped events when
+ * the user clicks the card's CTAs or confirms removing the bank account. The
+ * card has no alert API — alert rendering is the orchestrator's
+ * responsibility.
+ *
+ * @events
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `contractor/management/paymentMethod/card/addRequested` | Fired when the user clicks "Add bank account" | `{ contractorId: string }` |
+ * | `contractor/management/paymentMethod/card/editRequested` | Fired when the user chooses "Edit" from the bank account row menu | `{ contractorId: string }` |
+ * | `contractor/management/paymentMethod/card/removed` | Fired after the bank account is removed and the payment method reverts to Check | The updated `ContractorPaymentMethod` entity |
+ *
+ * @param props - See {@link PaymentMethodCardProps}.
+ * @returns The "Payment" card.
+ * @public
+ */
+export declare function PaymentMethodCard({ LoaderComponent, ...props }: PaymentMethodCardProps): import("react").JSX.Element;