@gusto/embedded-react-sdk 0.50.0 → 0.51.0

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

@@ -1 +1 @@
-{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Contractor/Address/shared/useContractorAddressForm/fields.tsx"],"sourcesContent":["import type { ContractorAddressErrorCodes } from './contractorAddressSchema'\nimport type { TextInputHookFieldProps } from '@/partner-hook-utils/form/fields/TextInputHookField'\nimport type { SelectHookFieldProps } from '@/partner-hook-utils/form/fields/SelectHookField'\nimport { TextInputHookField, SelectHookField } from '@/partner-hook-utils/form/fields'\nimport type { HookFieldProps } from '@/partner-hook-utils/types'\n\n/**\n * The required-field error code produced by {@link useContractorAddressForm} fields that only emit `REQUIRED`.\n *\n * @remarks\n * Used as the `validationMessages` key for the street, city, and state fields.\n * See {@link ContractorAddressErrorCodes}.\n *\n * @public\n */\nexport type RequiredValidation = typeof ContractorAddressErrorCodes.REQUIRED\n\n/**\n * Validation error codes emitted by the `zip` field of {@link useContractorAddressForm}.\n *\n * @remarks\n * Use these as keys in `validationMessages` on `Fields.Zip`. See\n * {@link ContractorAddressErrorCodes}.\n *\n * @public\n */\nexport type ZipValidation = (typeof ContractorAddressErrorCodes)['REQUIRED' | 'INVALID_ZIP']\n\n/**\n * Props accepted by {@link useContractorAddressForm}'s `Fields.Street1` component.\n *\n * @public\n */\nexport type Street1FieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/**\n * Text input bound to the `street1` field of {@link useContractorAddressForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.Street1`. Required.\n *\n * @param props - {@link Street1FieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered text input bound to `street1`.\n * @public\n */\nexport function Street1Field(props: Street1FieldProps) {\n  return <TextInputHookField {...props} name=\"street1\" />\n}\n\n/**\n * Props accepted by {@link useContractorAddressForm}'s `Fields.Street2` component.\n *\n * @public\n */\nexport type Street2FieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/**\n * Text input bound to the `street2` field of {@link useContractorAddressForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.Street2`. Optional.\n *\n * @param props - {@link Street2FieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered text input bound to `street2`.\n * @public\n */\nexport function Street2Field(props: Street2FieldProps) {\n  return <TextInputHookField {...props} name=\"street2\" />\n}\n\n/**\n * Props accepted by {@link useContractorAddressForm}'s `Fields.City` component.\n *\n * @public\n */\nexport type CityFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/**\n * Text input bound to the `city` field of {@link useContractorAddressForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.City`. Required.\n *\n * @param props - {@link CityFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered text input bound to `city`.\n * @public\n */\nexport function CityField(props: CityFieldProps) {\n  return <TextInputHookField {...props} name=\"city\" />\n}\n\n/**\n * Props accepted by {@link useContractorAddressForm}'s `Fields.State` component.\n *\n * @public\n */\nexport type StateFieldProps = HookFieldProps<SelectHookFieldProps<RequiredValidation, string>>\n\n/**\n * Select bound to the `state` field of {@link useContractorAddressForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.State`. Options are the\n * standard two-letter US state abbreviations. Required.\n *\n * @param props - {@link StateFieldProps} — accepts the standard hook field props plus `getOptionLabel` to localize state names.\n * @returns The rendered select bound to `state`.\n * @public\n */\nexport function StateField(props: StateFieldProps) {\n  return <SelectHookField {...props} name=\"state\" />\n}\n\n/**\n * Props accepted by {@link useContractorAddressForm}'s `Fields.Zip` component.\n *\n * @public\n */\nexport type ZipFieldProps = HookFieldProps<TextInputHookFieldProps<ZipValidation>>\n\n/**\n * Text input bound to the `zip` field of {@link useContractorAddressForm}.\n *\n * @remarks\n * Available on the hook result as `form.Fields.Zip`. Required; also validates\n * ZIP code format and emits `INVALID_ZIP` when the value does not match.\n *\n * @param props - {@link ZipFieldProps} — accepts the standard hook field props (label, description, validationMessages, FieldComponent override).\n * @returns The rendered text input bound to `zip`.\n * @public\n */\nexport function ZipField(props: ZipFieldProps) {\n  return <TextInputHookField {...props} name=\"zip\" />\n}\n"],"names":["Street1Field","props","jsx","TextInputHookField","Street2Field","CityField","StateField","SelectHookField","ZipField"],"mappings":";;;AA6CO,SAASA,EAAaC,GAA0B;AACrD,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,WAAU;AACvD;AAmBO,SAASG,EAAaH,GAA0B;AACrD,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,WAAU;AACvD;AAmBO,SAASI,EAAUJ,GAAuB;AAC/C,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,QAAO;AACpD;AAoBO,SAASK,EAAWL,GAAwB;AACjD,SAAO,gBAAAC,EAACK,GAAA,EAAiB,GAAGN,GAAO,MAAK,SAAQ;AAClD;AAoBO,SAASO,EAASP,GAAsB;AAC7C,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,OAAM;AACnD;"}
+{"version":3,"file":"fields.js","sources":["../../../../../../src/components/Contractor/Address/shared/useContractorAddressForm/fields.tsx"],"sourcesContent":["import type { ContractorAddressErrorCodes } from './contractorAddressSchema'\nimport type { TextInputHookFieldProps } from '@/partner-hook-utils/form/fields/TextInputHookField'\nimport type { SelectHookFieldProps } from '@/partner-hook-utils/form/fields/SelectHookField'\nimport { TextInputHookField, SelectHookField } from '@/partner-hook-utils/form/fields'\nimport type { HookFieldProps } from '@/partner-hook-utils/types'\n\n/**\n * The required-field error code produced by {@link useContractorAddressForm} fields that only emit `REQUIRED`.\n *\n * @remarks\n * Used as the `validationMessages` key for the street, city, and state fields.\n * See {@link ContractorAddressErrorCodes}.\n *\n * @public\n */\nexport type RequiredValidation = typeof ContractorAddressErrorCodes.REQUIRED\n\n/**\n * Validation error codes emitted by the `zip` field of {@link useContractorAddressForm}.\n *\n * @remarks\n * Use these as keys in `validationMessages` on `Fields.Zip`. See\n * {@link ContractorAddressErrorCodes}.\n *\n * @public\n */\nexport type ZipValidation = (typeof ContractorAddressErrorCodes)['REQUIRED' | 'INVALID_ZIP']\n\n/**\n * Props accepted by {@link useContractorAddressForm}'s `Fields.Street1` component.\n *\n * @public\n */\nexport type Street1FieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/** @internal */\nexport function Street1Field(props: Street1FieldProps) {\n  return <TextInputHookField {...props} name=\"street1\" />\n}\n\n/**\n * Props accepted by {@link useContractorAddressForm}'s `Fields.Street2` component.\n *\n * @public\n */\nexport type Street2FieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/** @internal */\nexport function Street2Field(props: Street2FieldProps) {\n  return <TextInputHookField {...props} name=\"street2\" />\n}\n\n/**\n * Props accepted by {@link useContractorAddressForm}'s `Fields.City` component.\n *\n * @public\n */\nexport type CityFieldProps = HookFieldProps<TextInputHookFieldProps<RequiredValidation>>\n\n/** @internal */\nexport function CityField(props: CityFieldProps) {\n  return <TextInputHookField {...props} name=\"city\" />\n}\n\n/**\n * Props accepted by {@link useContractorAddressForm}'s `Fields.State` component.\n *\n * @public\n */\nexport type StateFieldProps = HookFieldProps<SelectHookFieldProps<RequiredValidation, string>>\n\n/** @internal */\nexport function StateField(props: StateFieldProps) {\n  return <SelectHookField {...props} name=\"state\" />\n}\n\n/**\n * Props accepted by {@link useContractorAddressForm}'s `Fields.Zip` component.\n *\n * @public\n */\nexport type ZipFieldProps = HookFieldProps<TextInputHookFieldProps<ZipValidation>>\n\n/** @internal */\nexport function ZipField(props: ZipFieldProps) {\n  return <TextInputHookField {...props} name=\"zip\" />\n}\n"],"names":["Street1Field","props","jsx","TextInputHookField","Street2Field","CityField","StateField","SelectHookField","ZipField"],"mappings":";;;AAoCO,SAASA,EAAaC,GAA0B;AACrD,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,WAAU;AACvD;AAUO,SAASG,EAAaH,GAA0B;AACrD,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,WAAU;AACvD;AAUO,SAASI,EAAUJ,GAAuB;AAC/C,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,QAAO;AACpD;AAUO,SAASK,EAAWL,GAAwB;AACjD,SAAO,gBAAAC,EAACK,GAAA,EAAiB,GAAGN,GAAO,MAAK,SAAQ;AAClD;AAUO,SAASO,EAASP,GAAsB;AAC7C,SAAO,gBAAAC,EAACC,GAAA,EAAoB,GAAGF,GAAO,MAAK,OAAM;AACnD;"}

package/dist/components/Contractor/Address/shared/useContractorAddressForm/index.d.ts

@@ -1,6 +1,4 @@
-import "./types/i18next.d.ts"
 export { useContractorAddressForm } from './useContractorAddressForm';
-export type { ContractorAddressSubmitOptions, ContractorAddressOptionalFieldsToRequire, UseContractorAddressFormProps, UseContractorAddressFormResult, UseContractorAddressFormReady, ContractorAddressFieldsMetadata, ContractorAddressFormFields, ContractorAddressFields, } from './useContractorAddressForm';
-export { createContractorAddressSchema, ContractorAddressErrorCodes, type ContractorAddressErrorCode, type ContractorAddressFormData, type ContractorAddressFormOutputs, type ContractorAddressField, } from './contractorAddressSchema';
-export { Street1Field, Street2Field, CityField, StateField, ZipField } from './fields';
+export type { ContractorAddressSubmitOptions, ContractorAddressOptionalFieldsToRequire, UseContractorAddressFormProps, UseContractorAddressFormResult, UseContractorAddressFormReady, ContractorAddressFieldsMetadata, ContractorAddressFormFields, } from './useContractorAddressForm';
+export { ContractorAddressErrorCodes, type ContractorAddressErrorCode, type ContractorAddressFormData, type ContractorAddressField, } from './contractorAddressSchema';
 export type { RequiredValidation as ContractorAddressRequiredValidation, ZipValidation as ContractorAddressZipValidation, Street1FieldProps as ContractorAddressStreet1FieldProps, Street2FieldProps as ContractorAddressStreet2FieldProps, CityFieldProps as ContractorAddressCityFieldProps, StateFieldProps as ContractorAddressStateFieldProps, ZipFieldProps as ContractorAddressZipFieldProps, } from './fields';

package/dist/components/Contractor/Address/shared/useContractorAddressForm/useContractorAddressForm.d.ts

@@ -1,9 +1,10 @@
+import { ComponentType } from 'react';
 import { UseFormProps } from 'react-hook-form';
-import { Contractor, ContractorType } from '@gusto/embedded-api-v-2025-11-15/models/components/contractor';
-import { ContractorAddress } from '@gusto/embedded-api-v-2025-11-15/models/components/contractoraddress';
+import { Contractor, ContractorType } from '@gusto/embedded-api-v-2026-02-01/models/components/contractor';
+import { ContractorAddress } from '@gusto/embedded-api-v-2026-02-01/models/components/contractoraddress';
 import { ContractorAddressOptionalFieldsToRequire, ContractorAddressFormData } from './contractorAddressSchema';
-import { Street1Field, Street2Field, CityField, StateField, ZipField } from './fields';
-import { BaseFormHookReady, FieldsMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
+import { Street1FieldProps, Street2FieldProps, CityFieldProps, StateFieldProps, ZipFieldProps } from './fields';
+import { BaseFormHookReady, FieldMetadata, HookLoadingResult, HookSubmitResult } from '../../../../../partner-hook-utils/types';
 export type { ContractorAddressOptionalFieldsToRequire } from './contractorAddressSchema';
 /**
  * Optional overrides passed to {@link UseContractorAddressFormReady.actions.onSubmit | onSubmit}.
@@ -32,21 +33,27 @@ export interface UseContractorAddressFormProps {
     shouldFocusError?: boolean;
 }
 /**
- * Pre-bound field components exposed on `useContractorAddressForm().form.Fields`.
+ * Field components exposed by {@link useContractorAddressForm} on `form.Fields`.
  *
  * @public
  */
-export interface ContractorAddressFields {
-    /** Street address line 1 text input. Required. */
-    Street1: typeof Street1Field;
-    /** Street address line 2 text input. Optional. */
-    Street2: typeof Street2Field;
-    /** City text input. Required. */
-    City: typeof CityField;
-    /** State selector. Required. */
-    State: typeof StateField;
-    /** ZIP code text input. Required. */
-    Zip: typeof ZipField;
+export interface ContractorAddressFormFields {
+    /** Bound to `street1`. Text input for the first street address line. Required. */
+    Street1: ComponentType<Street1FieldProps>;
+    /** Bound to `street2`. Text input for the second street address line. Optional. */
+    Street2: ComponentType<Street2FieldProps>;
+    /** Bound to `city`. Text input for the city. Required. */
+    City: ComponentType<CityFieldProps>;
+    /**
+     * Bound to `state`. Select whose options are the standard two-letter US state
+     * abbreviations. Supply `getOptionLabel` to localize the option labels. Required.
+     */
+    State: ComponentType<StateFieldProps>;
+    /**
+     * Bound to `zip`. Text input for the ZIP code. Required; also validates ZIP
+     * format and emits `INVALID_ZIP` when the value does not match.
+     */
+    Zip: ComponentType<ZipFieldProps>;
 }
 /**
  * Ready-state shape returned by {@link useContractorAddressForm} once data has loaded.
@@ -57,7 +64,7 @@ export interface ContractorAddressFields {
  *
  * @public
  */
-export interface UseContractorAddressFormReady extends BaseFormHookReady<FieldsMetadata, ContractorAddressFormData, ContractorAddressFields> {
+export interface UseContractorAddressFormReady extends BaseFormHookReady<ContractorAddressFieldsMetadata, ContractorAddressFormData, ContractorAddressFormFields> {
     /** Static entity data resolved from the API. */
     data: {
         /** The contractor address row loaded for update. */
@@ -141,10 +148,4 @@ export type UseContractorAddressFormResult = HookLoadingResult | UseContractorAd
  *
  * @public
  */
-export type ContractorAddressFieldsMetadata = UseContractorAddressFormReady['form']['fieldsMetadata'];
-/**
- * Type of `form.Fields` returned by {@link useContractorAddressForm}.
- *
- * @public
- */
-export type ContractorAddressFormFields = UseContractorAddressFormReady['form']['Fields'];
+export type ContractorAddressFieldsMetadata = { street1: FieldMetadata; street2: FieldMetadata; city: FieldMetadata; state: import("../../../../../partner-hook-utils/types").FieldMetadataWithOptions<"AL" | "AK" | "AZ" | "AR" | "CA" | "CO" | "CT" | "DE" | "DC" | "FL" | "GA" | "HI" | "ID" | "IL" | "IN" | "IA" | "KS" | "KY" | "LA" | "ME" | "MD" | "MA" | "MI" | "MN" | "MS" | "MO" | "MT" | "NE" | "NV" | "NH" | "NJ" | "NM" | "NY" | "NC" | "ND" | "OH" | "OK" | "OR" | "PA" | "RI" | "SC" | "SD" | "TN" | "TX" | "UT" | "VT" | "VA" | "WA" | "WV" | "WI" | "WY">; zip: FieldMetadata; };

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

@@ -1,129 +1,133 @@
-import { useMemo as b } from "react";
-import { useForm as P } from "react-hook-form";
-import { zodResolver as L } from "@hookform/resolvers/zod";
-import { useContractorsGet as Q } from "@gusto/embedded-api-v-2025-11-15/react-query/contractorsGet";
-import { useContractorsGetAddress as R } from "@gusto/embedded-api-v-2025-11-15/react-query/contractorsGetAddress";
-import { useContractorsUpdateAddressMutation as T } from "@gusto/embedded-api-v-2025-11-15/react-query/contractorsUpdateAddress";
-import { createContractorAddressSchema as Z } from "./contractorAddressSchema.js";
-import { ZipField as x, StateField as I, CityField as K, Street2Field as _, Street1Field as j } from "./fields.js";
-import { useDeriveFieldsMetadata as q } from "../../../../../partner-hook-utils/form/useDeriveFieldsMetadata.js";
-import { useHookFormInternals as J } from "../../../../../partner-hook-utils/form/useHookFormInternals.js";
-import { createGetFormSubmissionValues as N } from "../../../../../partner-hook-utils/form/getFormSubmissionValues.js";
-import { withOptions as W } from "../../../../../partner-hook-utils/form/withOptions.js";
-import { composeErrorHandler as X } from "../../../../../partner-hook-utils/composeErrorHandler.js";
-import { useBaseSubmit as Y } from "../../../../Base/useBaseSubmit.js";
-import { SDKInternalError as F } from "../../../../../types/sdkError.js";
-import { STATES_ABBR as C } from "../../../../../shared/constants.js";
+import { useMemo as A } from "react";
+import { useForm as O } from "react-hook-form";
+import { zodResolver as P } from "@hookform/resolvers/zod";
+import { useContractorsGet as L } from "@gusto/embedded-api-v-2026-02-01/react-query/contractorsGet";
+import { useContractorsGetAddress as Q } from "@gusto/embedded-api-v-2026-02-01/react-query/contractorsGetAddress";
+import { useContractorsUpdateAddressMutation as R } from "@gusto/embedded-api-v-2026-02-01/react-query/contractorsUpdateAddress";
+import { createContractorAddressSchema as T } from "./contractorAddressSchema.js";
+import { ZipField as Z, StateField as x, CityField as I, Street2Field as K, Street1Field as _ } from "./fields.js";
+import { useDeriveFieldsMetadata as j } from "../../../../../partner-hook-utils/form/useDeriveFieldsMetadata.js";
+import { useHookFormInternals as q } from "../../../../../partner-hook-utils/form/useHookFormInternals.js";
+import { createGetFormSubmissionValues as J } from "../../../../../partner-hook-utils/form/getFormSubmissionValues.js";
+import { withOptions as N } from "../../../../../partner-hook-utils/form/withOptions.js";
+import { composeErrorHandler as W } from "../../../../../partner-hook-utils/composeErrorHandler.js";
+import { useBaseSubmit as X } from "../../../../Base/useBaseSubmit.js";
+import { SDKInternalError as y } from "../../../../../types/sdkError.js";
+import { STATES_ABBR as F } from "../../../../../shared/constants.js";
+function Y(t) {
+  const s = F.map((r) => ({
+    value: r,
+    label: r
+  }));
+  return {
+    street1: t.street1,
+    street2: t.street2,
+    city: t.city,
+    state: N(t.state, s, F),
+    zip: t.zip
+  };
+}
 function ft({
-  contractorId: r,
-  optionalFieldsToRequire: d,
-  defaultValues: e,
-  validationMode: v = "onSubmit",
-  shouldFocusError: h = !0
+  contractorId: t,
+  optionalFieldsToRequire: s,
+  defaultValues: r,
+  validationMode: C = "onSubmit",
+  shouldFocusError: v = !0
 }) {
-  const c = Q(
-    { contractorUuid: r },
-    { enabled: !!r }
-  ), m = R(
-    { contractorUuid: r },
-    { enabled: !!r }
-  ), n = c.data?.contractor, w = n?.type, t = m.data?.contractorAddress, [u, g] = b(
-    () => Z({ optionalFieldsToRequire: d }),
-    [d]
-  ), p = b(
+  const n = L(
+    { contractorUuid: t },
+    { enabled: !!t }
+  ), d = Q(
+    { contractorUuid: t },
+    { enabled: !!t }
+  ), a = n.data?.contractor, b = a?.type, e = d.data?.contractorAddress, [c, h] = A(
+    () => T({ optionalFieldsToRequire: s }),
+    [s]
+  ), m = A(
     () => ({
-      street1: t?.street1 ?? e?.street1 ?? "",
-      street2: t?.street2 ?? e?.street2 ?? "",
-      city: t?.city ?? e?.city ?? "",
-      state: t?.state ?? e?.state ?? "",
-      zip: t?.zip ?? e?.zip ?? ""
+      street1: e?.street1 ?? r?.street1 ?? "",
+      street2: e?.street2 ?? r?.street2 ?? "",
+      city: e?.city ?? r?.city ?? "",
+      state: e?.state ?? r?.state ?? "",
+      zip: e?.zip ?? r?.zip ?? ""
     }),
-    [t, e]
-  ), i = P({
-    resolver: L(u),
-    mode: v,
-    shouldFocusError: h,
-    defaultValues: p,
-    values: p,
+    [e, r]
+  ), i = O({
+    resolver: P(c),
+    mode: C,
+    shouldFocusError: v,
+    defaultValues: m,
+    values: m,
     resetOptions: { keepDirtyValues: !0 }
-  }), l = T(), z = l.isPending, {
-    baseSubmitHandler: M,
-    error: E,
-    setError: U
-  } = Y("ContractorAddressForm"), f = X([c, m], {
-    submitError: E,
-    setSubmitError: U
-  }), V = C.map((a) => ({
-    value: a,
-    label: a
-  })), o = q(g, i.control), B = {
-    street1: o.street1,
-    street2: o.street2,
-    city: o.city,
-    state: W(o.state, V, C),
-    zip: o.zip
-  }, H = async (a) => {
-    let S;
-    return await new Promise((y) => {
+  }), u = R(), w = u.isPending, {
+    baseSubmitHandler: g,
+    error: z,
+    setError: M
+  } = X("ContractorAddressForm"), p = W([n, d], {
+    submitError: z,
+    setSubmitError: M
+  }), E = j(h, i.control), U = Y(E), V = async (H) => {
+    let l;
+    return await new Promise((f) => {
       i.handleSubmit(
-        async (G) => {
-          await M(G, async (s) => {
-            const O = a?.contractorId ?? r;
-            if (!t?.version)
-              throw new F(
+        async (k) => {
+          await g(k, async (o) => {
+            const G = H?.contractorId ?? t;
+            if (!e?.version)
+              throw new y(
                 "Cannot update contractor address: no matching address on file"
               );
-            const A = await l.mutateAsync({
+            const S = await u.mutateAsync({
               request: {
-                contractorUuid: O,
+                contractorUuid: G,
                 contractorAddressUpdateBody: {
-                  version: t.version,
-                  street1: s.street1,
-                  street2: s.street2 || void 0,
-                  city: s.city,
-                  state: s.state,
-                  zip: s.zip
+                  version: e.version,
+                  street1: o.street1,
+                  street2: o.street2 || void 0,
+                  city: o.city,
+                  state: o.state,
+                  zip: o.zip
                 }
               }
             });
-            if (!A.contractorAddress)
-              throw new F("Contractor address update failed");
-            S = {
+            if (!S.contractorAddress)
+              throw new y("Contractor address update failed");
+            l = {
               mode: "update",
-              data: A.contractorAddress
+              data: S.contractorAddress
             };
-          }), y();
+          }), f();
         },
         () => {
-          y();
+          f();
         }
       )();
-    }), S;
-  }, k = J(i);
-  return !n || !t ? { isLoading: !0, errorHandling: f } : {
+    }), l;
+  }, B = q(i);
+  return !a || !e ? { isLoading: !0, errorHandling: p } : {
     isLoading: !1,
     data: {
-      contractorAddress: t,
-      contractor: n,
-      contractorType: w
+      contractorAddress: e,
+      contractor: a,
+      contractorType: b
     },
     status: {
-      isPending: z,
+      isPending: w,
       mode: "update"
     },
-    actions: { onSubmit: H },
-    errorHandling: f,
+    actions: { onSubmit: V },
+    errorHandling: p,
     form: {
       Fields: {
-        Street1: j,
-        Street2: _,
-        City: K,
-        State: I,
-        Zip: x
+        Street1: _,
+        Street2: K,
+        City: I,
+        State: x,
+        Zip: Z
       },
-      fieldsMetadata: B,
-      hookFormInternals: k,
-      getFormSubmissionValues: N(i, u)
+      fieldsMetadata: U,
+      hookFormInternals: B,
+      getFormSubmissionValues: J(i, c)
     }
   };
 }

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

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

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

@@ -1,4 +1,3 @@
-import "./types/i18next.d.ts"
 import { BaseComponentInterface } from '../../Base';
 /**
  * Props for {@link ContractorList}.

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../src/components/Contractor/ContractorList/index.tsx"],"sourcesContent":["import { type Contractor } from '@gusto/embedded-api-v-2025-11-15/models/components/contractor'\nimport { useTranslation } from 'react-i18next'\nimport { useContractorsDeleteMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/contractorsDelete'\nimport { useContractors } from './useContractorList'\nimport { ActionsLayout, DataView, EmptyData, Flex, useDataView } from '@/components/Common'\nimport { firstLastName } from '@/helpers/formattedStrings'\nimport { HamburgerMenu } from '@/components/Common/HamburgerMenu/HamburgerMenu'\nimport PencilSvg from '@/assets/icons/pencil.svg?react'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { ContractorOnboardingStatusBadge } from '@/components/Common/OnboardingStatusBadge'\nimport { useI18n, useComponentDictionary } from '@/i18n'\nimport { BaseComponent, useBase, type BaseComponentInterface } from '@/components/Base'\nimport { componentEvents, CONTRACTOR_TYPE } from '@/shared/constants'\nimport TrashCanSvg from '@/assets/icons/trashcan.svg?react'\n\ninterface HeadProps {\n  count: number\n  handleAdd: () => void\n}\nfunction Head({ count, handleAdd }: HeadProps) {\n  const { Button, Heading } = useComponentContext()\n  const { t } = useTranslation('Contractor.ContractorList')\n\n  return (\n    <Flex alignItems=\"center\" justifyContent=\"space-between\">\n      <Heading as=\"h2\">{t('title')}</Heading>\n\n      {count !== 0 && (\n        <Button variant=\"secondary\" onClick={handleAdd}>\n          {t('addAnotherCta')}\n        </Button>\n      )}\n    </Flex>\n  )\n}\n\ninterface EmptyDataContractorsListProps {\n  handleAdd: () => void\n}\nfunction EmptyDataContractorsList({ handleAdd }: EmptyDataContractorsListProps) {\n  const { Button } = useComponentContext()\n  const { t } = useTranslation('Contractor.ContractorList')\n\n  return (\n    <EmptyData title={t('emptyTableTitle')} description={t('emptyTableDescription')}>\n      <ActionsLayout justifyContent=\"center\">\n        <Button onClick={handleAdd}>{t('addContractorCta')}</Button>\n      </ActionsLayout>\n    </EmptyData>\n  )\n}\n\n/**\n * Props for {@link ContractorList}.\n *\n * @public\n */\nexport interface ContractorListProps extends BaseComponentInterface<'Contractor.ContractorList'> {\n  /** UUID of the company whose contractors should be listed. */\n  companyId: string\n  /** Success message to display in an alert above the list, typically after a create, update, or delete action. */\n  successMessage?: string\n}\n\n/**\n * Lists a company's contractors with controls to add, edit, delete, and continue onboarding.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `contractor/create` | The add-contractor action was triggered. | — |\n * | `contractor/update` | A contractor row's edit action was triggered. | `{ contractorId: string }` |\n * | `contractor/deleted` | A contractor was successfully deleted. | `{ contractorId: string }` |\n * | `contractor/onboarding/continue` | The continue action was triggered to advance onboarding. | — |\n *\n * @param props - See {@link ContractorListProps}.\n * @returns The rendered contractor list.\n * @public\n */\nexport function ContractorList(props: ContractorListProps) {\n  return (\n    <BaseComponent {...props}>\n      <Root {...props}>{props.children}</Root>\n    </BaseComponent>\n  )\n}\n\nfunction Root({ companyId, className, dictionary, successMessage }: ContractorListProps) {\n  useI18n('Contractor.ContractorList')\n  useComponentDictionary('Contractor.ContractorList', dictionary)\n  const { t } = useTranslation('Contractor.ContractorList')\n  const { onEvent, baseSubmitHandler } = useBase()\n  const { Alert, Button } = useComponentContext()\n  const {\n    contractors,\n    totalCount,\n    handleNextPage,\n    handleFirstPage,\n    handleLastPage,\n    handlePreviousPage,\n    handleItemsPerPageChange,\n    currentPage,\n    totalPages,\n    itemsPerPage,\n  } = useContractors({ companyUuid: companyId })\n  const { mutateAsync: deleteContractorMutation, isPending: isPendingDelete } =\n    useContractorsDeleteMutation()\n\n  const dataViewProps = useDataView<Contractor>({\n    columns: [\n      {\n        title: t('listHeaders.name'),\n        render: contractor =>\n          contractor.type === CONTRACTOR_TYPE.BUSINESS\n            ? contractor.businessName\n            : firstLastName({ first_name: contractor.firstName, last_name: contractor.lastName }),\n      },\n      {\n        title: t('listHeaders.status'),\n        render: ({ onboarded, onboardingStatus }) => (\n          <ContractorOnboardingStatusBadge\n            onboarded={onboarded}\n            onboardingStatus={onboardingStatus}\n          />\n        ),\n      },\n    ],\n    data: contractors,\n    itemMenu: contractor => (\n      <HamburgerMenu\n        items={[\n          {\n            label: t('editCta'),\n            icon: <PencilSvg aria-hidden />,\n            onClick: () => {\n              handleEdit(contractor.uuid)\n            },\n          },\n          {\n            label: t('deleteCta'),\n            icon: <TrashCanSvg aria-hidden />,\n            onClick: () => {\n              void handleDelete(contractor.uuid)\n            },\n          },\n        ]}\n        triggerLabel={t('editCta')}\n        isLoading={isPendingDelete}\n      />\n    ),\n    emptyState: () => <EmptyDataContractorsList handleAdd={handleAdd} />,\n    pagination: {\n      handleNextPage,\n      handleFirstPage,\n      handleLastPage,\n      handlePreviousPage,\n      handleItemsPerPageChange,\n      currentPage,\n      totalPages,\n      totalCount,\n      itemsPerPage,\n    },\n  })\n\n  const handleAdd = () => {\n    onEvent(componentEvents.CONTRACTOR_CREATE)\n  }\n\n  const handleEdit = (uuid: string) => {\n    onEvent(componentEvents.CONTRACTOR_UPDATE, { contractorId: uuid })\n  }\n\n  const handleContinue = () => {\n    onEvent(componentEvents.CONTRACTOR_ONBOARDING_CONTINUE)\n  }\n\n  const handleDelete = async (uuid: string) => {\n    await baseSubmitHandler(uuid, async payload => {\n      await deleteContractorMutation({\n        request: { contractorUuid: payload },\n      })\n\n      onEvent(componentEvents.CONTRACTOR_DELETED, { contractorId: payload })\n    })\n  }\n\n  return (\n    <section className={className}>\n      {successMessage && <Alert label={successMessage} status=\"success\" />}\n      <Flex flexDirection=\"column\">\n        <Head count={totalCount} handleAdd={handleAdd} />\n        <DataView label={t('contractorListLabel')} {...dataViewProps} />\n        <ActionsLayout>\n          <Button onClick={handleContinue} isLoading={false}>\n            {t('continueCta')}\n          </Button>\n        </ActionsLayout>\n      </Flex>\n    </section>\n  )\n}\n"],"names":["Head","count","handleAdd","Button","Heading","useComponentContext","t","useTranslation","jsxs","Flex","jsx","EmptyDataContractorsList","EmptyData","ActionsLayout","ContractorList","props","BaseComponent","Root","companyId","className","dictionary","successMessage","useI18n","useComponentDictionary","onEvent","baseSubmitHandler","useBase","Alert","contractors","totalCount","handleNextPage","handleFirstPage","handleLastPage","handlePreviousPage","handleItemsPerPageChange","currentPage","totalPages","itemsPerPage","useContractors","deleteContractorMutation","isPendingDelete","useContractorsDeleteMutation","dataViewProps","useDataView","contractor","CONTRACTOR_TYPE","firstLastName","onboarded","onboardingStatus","ContractorOnboardingStatusBadge","HamburgerMenu","PencilSvg","handleEdit","TrashCanSvg","handleDelete","componentEvents","uuid","handleContinue","payload","DataView"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../../../src/components/Contractor/ContractorList/index.tsx"],"sourcesContent":["import { type Contractor } from '@gusto/embedded-api-v-2026-02-01/models/components/contractor'\nimport { useTranslation } from 'react-i18next'\nimport { useContractorsDeleteMutation } from '@gusto/embedded-api-v-2026-02-01/react-query/contractorsDelete'\nimport { useContractors } from './useContractorList'\nimport { ActionsLayout, DataView, EmptyData, Flex, useDataView } from '@/components/Common'\nimport { firstLastName } from '@/helpers/formattedStrings'\nimport { HamburgerMenu } from '@/components/Common/HamburgerMenu/HamburgerMenu'\nimport PencilSvg from '@/assets/icons/pencil.svg?react'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { ContractorOnboardingStatusBadge } from '@/components/Common/OnboardingStatusBadge'\nimport { useI18n, useComponentDictionary } from '@/i18n'\nimport { BaseComponent, useBase, type BaseComponentInterface } from '@/components/Base'\nimport { componentEvents, CONTRACTOR_TYPE } from '@/shared/constants'\nimport TrashCanSvg from '@/assets/icons/trashcan.svg?react'\n\ninterface HeadProps {\n  count: number\n  handleAdd: () => void\n}\nfunction Head({ count, handleAdd }: HeadProps) {\n  const { Button, Heading } = useComponentContext()\n  const { t } = useTranslation('Contractor.ContractorList')\n\n  return (\n    <Flex alignItems=\"center\" justifyContent=\"space-between\">\n      <Heading as=\"h2\">{t('title')}</Heading>\n\n      {count !== 0 && (\n        <Button variant=\"secondary\" onClick={handleAdd}>\n          {t('addAnotherCta')}\n        </Button>\n      )}\n    </Flex>\n  )\n}\n\ninterface EmptyDataContractorsListProps {\n  handleAdd: () => void\n}\nfunction EmptyDataContractorsList({ handleAdd }: EmptyDataContractorsListProps) {\n  const { Button } = useComponentContext()\n  const { t } = useTranslation('Contractor.ContractorList')\n\n  return (\n    <EmptyData title={t('emptyTableTitle')} description={t('emptyTableDescription')}>\n      <ActionsLayout justifyContent=\"center\">\n        <Button onClick={handleAdd}>{t('addContractorCta')}</Button>\n      </ActionsLayout>\n    </EmptyData>\n  )\n}\n\n/**\n * Props for {@link ContractorList}.\n *\n * @public\n */\nexport interface ContractorListProps extends BaseComponentInterface<'Contractor.ContractorList'> {\n  /** UUID of the company whose contractors should be listed. */\n  companyId: string\n  /** Success message to display in an alert above the list, typically after a create, update, or delete action. */\n  successMessage?: string\n}\n\n/**\n * Lists a company's contractors with controls to add, edit, delete, and continue onboarding.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `contractor/create` | The add-contractor action was triggered. | — |\n * | `contractor/update` | A contractor row's edit action was triggered. | `{ contractorId: string }` |\n * | `contractor/deleted` | A contractor was successfully deleted. | `{ contractorId: string }` |\n * | `contractor/onboarding/continue` | The continue action was triggered to advance onboarding. | — |\n *\n * @param props - See {@link ContractorListProps}.\n * @returns The rendered contractor list.\n * @public\n */\nexport function ContractorList(props: ContractorListProps) {\n  return (\n    <BaseComponent {...props}>\n      <Root {...props}>{props.children}</Root>\n    </BaseComponent>\n  )\n}\n\nfunction Root({ companyId, className, dictionary, successMessage }: ContractorListProps) {\n  useI18n('Contractor.ContractorList')\n  useComponentDictionary('Contractor.ContractorList', dictionary)\n  const { t } = useTranslation('Contractor.ContractorList')\n  const { onEvent, baseSubmitHandler } = useBase()\n  const { Alert, Button } = useComponentContext()\n  const {\n    contractors,\n    totalCount,\n    handleNextPage,\n    handleFirstPage,\n    handleLastPage,\n    handlePreviousPage,\n    handleItemsPerPageChange,\n    currentPage,\n    totalPages,\n    itemsPerPage,\n  } = useContractors({ companyUuid: companyId })\n  const { mutateAsync: deleteContractorMutation, isPending: isPendingDelete } =\n    useContractorsDeleteMutation()\n\n  const dataViewProps = useDataView<Contractor>({\n    columns: [\n      {\n        title: t('listHeaders.name'),\n        render: contractor =>\n          contractor.type === CONTRACTOR_TYPE.BUSINESS\n            ? contractor.businessName\n            : firstLastName({ first_name: contractor.firstName, last_name: contractor.lastName }),\n      },\n      {\n        title: t('listHeaders.status'),\n        render: ({ onboarded, onboardingStatus }) => (\n          <ContractorOnboardingStatusBadge\n            onboarded={onboarded}\n            onboardingStatus={onboardingStatus}\n          />\n        ),\n      },\n    ],\n    data: contractors,\n    itemMenu: contractor => (\n      <HamburgerMenu\n        items={[\n          {\n            label: t('editCta'),\n            icon: <PencilSvg aria-hidden />,\n            onClick: () => {\n              handleEdit(contractor.uuid)\n            },\n          },\n          {\n            label: t('deleteCta'),\n            icon: <TrashCanSvg aria-hidden />,\n            onClick: () => {\n              void handleDelete(contractor.uuid)\n            },\n          },\n        ]}\n        triggerLabel={t('editCta')}\n        isLoading={isPendingDelete}\n      />\n    ),\n    emptyState: () => <EmptyDataContractorsList handleAdd={handleAdd} />,\n    pagination: {\n      handleNextPage,\n      handleFirstPage,\n      handleLastPage,\n      handlePreviousPage,\n      handleItemsPerPageChange,\n      currentPage,\n      totalPages,\n      totalCount,\n      itemsPerPage,\n    },\n  })\n\n  const handleAdd = () => {\n    onEvent(componentEvents.CONTRACTOR_CREATE)\n  }\n\n  const handleEdit = (uuid: string) => {\n    onEvent(componentEvents.CONTRACTOR_UPDATE, { contractorId: uuid })\n  }\n\n  const handleContinue = () => {\n    onEvent(componentEvents.CONTRACTOR_ONBOARDING_CONTINUE)\n  }\n\n  const handleDelete = async (uuid: string) => {\n    await baseSubmitHandler(uuid, async payload => {\n      await deleteContractorMutation({\n        request: { contractorUuid: payload },\n      })\n\n      onEvent(componentEvents.CONTRACTOR_DELETED, { contractorId: payload })\n    })\n  }\n\n  return (\n    <section className={className}>\n      {successMessage && <Alert label={successMessage} status=\"success\" />}\n      <Flex flexDirection=\"column\">\n        <Head count={totalCount} handleAdd={handleAdd} />\n        <DataView label={t('contractorListLabel')} {...dataViewProps} />\n        <ActionsLayout>\n          <Button onClick={handleContinue} isLoading={false}>\n            {t('continueCta')}\n          </Button>\n        </ActionsLayout>\n      </Flex>\n    </section>\n  )\n}\n"],"names":["Head","count","handleAdd","Button","Heading","useComponentContext","t","useTranslation","jsxs","Flex","jsx","EmptyDataContractorsList","EmptyData","ActionsLayout","ContractorList","props","BaseComponent","Root","companyId","className","dictionary","successMessage","useI18n","useComponentDictionary","onEvent","baseSubmitHandler","useBase","Alert","contractors","totalCount","handleNextPage","handleFirstPage","handleLastPage","handlePreviousPage","handleItemsPerPageChange","currentPage","totalPages","itemsPerPage","useContractors","deleteContractorMutation","isPendingDelete","useContractorsDeleteMutation","dataViewProps","useDataView","contractor","CONTRACTOR_TYPE","firstLastName","onboarded","onboardingStatus","ContractorOnboardingStatusBadge","HamburgerMenu","PencilSvg","handleEdit","TrashCanSvg","handleDelete","componentEvents","uuid","handleContinue","payload","DataView"],"mappings":"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"}

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

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

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

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

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

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

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

@@ -0,0 +1,41 @@
+import { DocumentsListProps } from '../DocumentsList';
+import { BaseComponentInterface } from '../../../Base';
+/**
+ * Props for {@link DocumentSigner}.
+ *
+ * @public
+ */
+export interface DocumentSignerProps extends Omit<BaseComponentInterface<'Contractor.DocumentsList'>, 'dictionary'> {
+    /** The associated contractor identifier. */
+    contractorId: string;
+    /** Overrides for the document list copy shown by the signing flow. */
+    dictionary?: DocumentsListProps['dictionary'];
+}
+/**
+ * Contractor onboarding step for reading and signing required contractor documents.
+ *
+ * @remarks
+ * Composes the contractor {@link DocumentsList} and {@link SignatureForm} into a
+ * single signing workflow: the document list is shown first, selecting a
+ * document routes to its signature form, and signing (or navigating back)
+ * returns to the list. The list refetches automatically once a document is
+ * signed. The flow completes when every document that requires signing has been
+ * signed and the user continues.
+ *
+ * @events
+ * | Event | Description | Data |
+ * | ----- | ----------- | ---- |
+ * | `contractor/documents/view` | Fired when a document's "Sign" action is selected from the document list | `{ uuid: string; title?: string }` |
+ * | `contractor/documents/sign` | Fired after a document is successfully signed | The signed document |
+ * | `contractor/documents/done` | Fired when all required documents have been signed and the parent flow can advance | — |
+ * | `cancel` | Fired when the user navigates back from the signature form to the document list | — |
+ *
+ * @components
+ * - {@link DocumentsList}
+ * - {@link SignatureForm}
+ *
+ * @param props - See {@link DocumentSignerProps}.
+ * @returns The document signer flow.
+ * @public
+ */
+export declare function DocumentSigner(props: DocumentSignerProps): import("react").JSX.Element;

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

@@ -0,0 +1,32 @@
+import { jsx as t } from "react/jsx-runtime";
+import { createMachine as i } from "robot3";
+import { useMemo as c } from "react";
+import { DocumentsListContextual as u } from "./documentSignerStateMachine.js";
+import { documentSignerMachine as p } from "./stateMachine.js";
+import { Flow as f } from "../../../Flow/Flow.js";
+import { BaseComponent as s } from "../../../Base/Base.js";
+import "../../../Base/useBase.js";
+import { useComponentDictionary as a } from "../../../../i18n/I18n.js";
+function D({ contractorId: o, onEvent: n, dictionary: m }) {
+  a("Contractor.DocumentsList", m);
+  const r = c(
+    () => i(
+      "index",
+      p,
+      (e) => ({
+        ...e,
+        component: u,
+        contractorId: o
+      })
+    ),
+    [o]
+  );
+  return /* @__PURE__ */ t(f, { machine: r, onEvent: n });
+}
+function F(o) {
+  return /* @__PURE__ */ t(s, { ...o, children: /* @__PURE__ */ t(D, { ...o }) });
+}
+export {
+  F as DocumentSigner
+};
+//# sourceMappingURL=DocumentSigner.js.map