@gusto/embedded-react-sdk 0.48.3 → 0.50.0

package/dist/components/Contractor/Profile/IndividualSelfOnboardingProfile.js

@@ -0,0 +1,96 @@
+import { jsx as e, jsxs as a, Fragment as p } from "react/jsx-runtime";
+import { useTranslation as g } from "react-i18next";
+import N from "classnames";
+import { useContractorDetailsForm as b } from "./shared/useContractorDetailsForm/useContractorDetailsForm.js";
+import I from "./ContractorProfile.module.scss.js";
+import { BaseLayout as d } from "../../Base/Base.js";
+import "../../Base/useBase.js";
+import { SDKFormProvider as D } from "../../../partner-hook-utils/form/SDKFormProvider.js";
+import { Form as h } from "../../Common/Form/Form.js";
+import { Flex as s } from "../../Common/Flex/Flex.js";
+import { Grid as v } from "../../Common/Grid/Grid.js";
+import { useComponentContext as F } from "../../../contexts/ComponentAdapter/useComponentContext.js";
+import "react";
+import { componentEvents as m } from "../../../shared/constants.js";
+const R = {
+  update: ["firstName", "lastName", "ssn"]
+};
+function H({
+  contractorId: f,
+  onEvent: l,
+  className: c
+}) {
+  const { t: i } = g("Contractor.Profile"), n = F(), r = b({
+    contractorId: f,
+    withSelfOnboardingField: !1,
+    defaultValues: { selfOnboarding: !0 },
+    optionalFieldsToRequire: R
+  });
+  if (r.isLoading)
+    return /* @__PURE__ */ e(d, { isLoading: !0, error: r.errorHandling.errors });
+  const { Fields: t } = r.form, u = async () => {
+    const o = await r.actions.onSubmit();
+    o && (l(m.CONTRACTOR_UPDATED, o.data), l(m.CONTRACTOR_PROFILE_DONE, {
+      contractorId: o.data.uuid,
+      selfOnboarding: !0
+    }));
+  };
+  return /* @__PURE__ */ e("section", { className: N(I.root, c), children: /* @__PURE__ */ e(d, { error: r.errorHandling.errors, children: /* @__PURE__ */ e(D, { formHookResult: r, children: /* @__PURE__ */ a(h, { onSubmit: () => {
+    u();
+  }, children: [
+    /* @__PURE__ */ a(s, { flexDirection: "column", gap: 20, alignItems: "stretch", children: [
+      /* @__PURE__ */ e("header", { children: /* @__PURE__ */ a(s, { flexDirection: "column", gap: 4, children: [
+        /* @__PURE__ */ e(n.Heading, { as: "h2", children: i("selfOnboarding.title") }),
+        /* @__PURE__ */ e(n.Text, { variant: "supporting", children: i("selfOnboarding.individualDescription") })
+      ] }) }),
+      t.FirstName && t.LastName && /* @__PURE__ */ a(p, { children: [
+        /* @__PURE__ */ a(v, { gridTemplateColumns: { base: "1fr", medium: "1fr 1fr" }, gap: 16, children: [
+          /* @__PURE__ */ e(
+            t.FirstName,
+            {
+              label: i("fields.firstName.label"),
+              validationMessages: {
+                REQUIRED: i("validations.firstName"),
+                INVALID_NAME: i("validations.firstNameFormat")
+              }
+            }
+          ),
+          t.MiddleInitial && /* @__PURE__ */ e(t.MiddleInitial, { label: i("fields.middleInitial.label") })
+        ] }),
+        /* @__PURE__ */ e(
+          t.LastName,
+          {
+            label: i("fields.lastName.label"),
+            validationMessages: {
+              REQUIRED: i("validations.lastName"),
+              INVALID_NAME: i("validations.lastNameFormat")
+            }
+          }
+        ),
+        t.Ssn && /* @__PURE__ */ e(
+          t.Ssn,
+          {
+            label: i("fields.ssn.label"),
+            validationMessages: {
+              INVALID_SSN: i("validations.ssnFormat"),
+              REQUIRED: i("validations.ssn")
+            }
+          }
+        )
+      ] })
+    ] }),
+    /* @__PURE__ */ e(s, { gap: 12, justifyContent: "flex-end", children: /* @__PURE__ */ e(
+      n.Button,
+      {
+        type: "submit",
+        variant: "primary",
+        isDisabled: r.status.isPending,
+        children: r.status.isPending ? i("selfOnboarding.submitting") : i("selfOnboarding.continue")
+      }
+    ) })
+  ] }) }) }) });
+}
+export {
+  H as IndividualSelfOnboardingProfile
+};
+//# sourceMappingURL=IndividualSelfOnboardingProfile.js.map

package/dist/components/Contractor/Profile/IndividualSelfOnboardingProfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndividualSelfOnboardingProfile.js","sources":["../../../../src/components/Contractor/Profile/IndividualSelfOnboardingProfile.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport classNames from 'classnames'\nimport {\n  useContractorDetailsForm,\n  type ContractorDetailsOptionalFieldsToRequire,\n} from './shared/useContractorDetailsForm'\nimport type { ContractorSelfOnboardingProfileProps } from './SelfOnboardingContractorProfile'\nimport styles from './ContractorProfile.module.scss'\nimport { BaseLayout } from '@/components/Base'\nimport { SDKFormProvider } from '@/partner-hook-utils/form/SDKFormProvider'\nimport { Form } from '@/components/Common/Form'\nimport { Flex, Grid } from '@/components/Common'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { componentEvents } from '@/shared/constants'\n\nconst INDIVIDUAL_REQUIRED_FIELDS: ContractorDetailsOptionalFieldsToRequire = {\n  update: ['firstName', 'lastName', 'ssn'],\n}\n\n/**\n * Self-onboarding profile for an individual contractor — collects legal name\n * and SSN.\n *\n * @internal\n */\nexport function IndividualSelfOnboardingProfile({\n  contractorId,\n  onEvent,\n  className,\n}: ContractorSelfOnboardingProfileProps) {\n  const { t } = useTranslation('Contractor.Profile')\n  const Components = useComponentContext()\n\n  const contractor = useContractorDetailsForm({\n    contractorId,\n    withSelfOnboardingField: false,\n    defaultValues: { selfOnboarding: true },\n    optionalFieldsToRequire: INDIVIDUAL_REQUIRED_FIELDS,\n  })\n\n  if (contractor.isLoading) {\n    return <BaseLayout isLoading error={contractor.errorHandling.errors} />\n  }\n\n  const { Fields } = contractor.form\n\n  const handleSubmit = async () => {\n    const result = await contractor.actions.onSubmit()\n    if (!result) return\n\n    onEvent(componentEvents.CONTRACTOR_UPDATED, result.data)\n    onEvent(componentEvents.CONTRACTOR_PROFILE_DONE, {\n      contractorId: result.data.uuid,\n      selfOnboarding: true,\n    })\n  }\n\n  return (\n    <section className={classNames(styles.root, className)}>\n      <BaseLayout error={contractor.errorHandling.errors}>\n        <SDKFormProvider formHookResult={contractor}>\n          <Form onSubmit={() => void handleSubmit()}>\n            <Flex flexDirection=\"column\" gap={20} alignItems=\"stretch\">\n              <header>\n                <Flex flexDirection=\"column\" gap={4}>\n                  <Components.Heading as=\"h2\">{t('selfOnboarding.title')}</Components.Heading>\n                  <Components.Text variant=\"supporting\">\n                    {t('selfOnboarding.individualDescription')}\n                  </Components.Text>\n                </Flex>\n              </header>\n\n              {Fields.FirstName && Fields.LastName && (\n                <>\n                  <Grid gridTemplateColumns={{ base: '1fr', medium: '1fr 1fr' }} gap={16}>\n                    <Fields.FirstName\n                      label={t('fields.firstName.label')}\n                      validationMessages={{\n                        REQUIRED: t('validations.firstName'),\n                        INVALID_NAME: t('validations.firstNameFormat'),\n                      }}\n                    />\n                    {Fields.MiddleInitial && (\n                      <Fields.MiddleInitial label={t('fields.middleInitial.label')} />\n                    )}\n                  </Grid>\n                  <Fields.LastName\n                    label={t('fields.lastName.label')}\n                    validationMessages={{\n                      REQUIRED: t('validations.lastName'),\n                      INVALID_NAME: t('validations.lastNameFormat'),\n                    }}\n                  />\n                  {Fields.Ssn && (\n                    <Fields.Ssn\n                      label={t('fields.ssn.label')}\n                      validationMessages={{\n                        INVALID_SSN: t('validations.ssnFormat'),\n                        REQUIRED: t('validations.ssn'),\n                      }}\n                    />\n                  )}\n                </>\n              )}\n            </Flex>\n\n            <Flex gap={12} justifyContent=\"flex-end\">\n              <Components.Button\n                type=\"submit\"\n                variant=\"primary\"\n                isDisabled={contractor.status.isPending}\n              >\n                {contractor.status.isPending\n                  ? t('selfOnboarding.submitting')\n                  : t('selfOnboarding.continue')}\n              </Components.Button>\n            </Flex>\n          </Form>\n        </SDKFormProvider>\n      </BaseLayout>\n    </section>\n  )\n}\n"],"names":["INDIVIDUAL_REQUIRED_FIELDS","IndividualSelfOnboardingProfile","contractorId","onEvent","className","t","useTranslation","Components","useComponentContext","contractor","useContractorDetailsForm","BaseLayout","Fields","handleSubmit","result","componentEvents","jsx","classNames","styles","SDKFormProvider","jsxs","Form","Flex","Fragment","Grid"],"mappings":"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"}

package/dist/components/Contractor/Profile/SelfOnboardingContractorProfile.d.ts

@@ -0,0 +1,22 @@
+import { OnEventType } from '../../Base/useBase';
+import { EventType } from '../../../shared/constants';
+/**
+ * Props shared by the contractor self-onboarding profile components.
+ *
+ * @internal
+ */
+export interface ContractorSelfOnboardingProfileProps {
+    /** UUID of the existing contractor completing self-onboarding. */
+    contractorId: string;
+    /** Callback invoked when the component emits an event. */
+    onEvent: OnEventType<EventType, unknown>;
+    /** Optional class name applied to the root element. */
+    className?: string;
+}
+/**
+ * Resolves the contractor's type and renders the matching self-onboarding
+ * profile — individual or business.
+ *
+ * @internal
+ */
+export declare function SelfOnboardingContractorProfile({ contractorId, onEvent, className, }: ContractorSelfOnboardingProfileProps): import("react").JSX.Element;

package/dist/components/Contractor/Profile/SelfOnboardingContractorProfile.js

@@ -0,0 +1,40 @@
+import { jsx as t } from "react/jsx-runtime";
+import { useContractorsGet as m } from "@gusto/embedded-api-v-2025-11-15/react-query/contractorsGet";
+import { ContractorType as a } from "./shared/useContractorDetailsForm/contractorDetailsSchema.js";
+import { IndividualSelfOnboardingProfile as s } from "./IndividualSelfOnboardingProfile.js";
+import { BusinessSelfOnboardingProfile as p } from "./BusinessSelfOnboardingProfile.js";
+import { BaseLayout as c } from "../../Base/Base.js";
+import "../../Base/useBase.js";
+import { composeErrorHandler as u } from "../../../partner-hook-utils/composeErrorHandler.js";
+import { useI18n as d } from "../../../i18n/I18n.js";
+function S({
+  contractorId: r,
+  onEvent: i,
+  className: n
+}) {
+  d("Contractor.Profile");
+  const o = m({ contractorUuid: r }), e = o.data?.contractor;
+  if (o.isLoading || !e) {
+    const f = u([o]);
+    return /* @__PURE__ */ t(c, { isLoading: !0, error: f.errors });
+  }
+  return e.type === a.Business ? /* @__PURE__ */ t(
+    p,
+    {
+      contractorId: r,
+      onEvent: i,
+      className: n
+    }
+  ) : /* @__PURE__ */ t(
+    s,
+    {
+      contractorId: r,
+      onEvent: i,
+      className: n
+    }
+  );
+}
+export {
+  S as SelfOnboardingContractorProfile
+};
+//# sourceMappingURL=SelfOnboardingContractorProfile.js.map

package/dist/components/Contractor/Profile/SelfOnboardingContractorProfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelfOnboardingContractorProfile.js","sources":["../../../../src/components/Contractor/Profile/SelfOnboardingContractorProfile.tsx"],"sourcesContent":["import { useContractorsGet } from '@gusto/embedded-api-v-2025-11-15/react-query/contractorsGet'\nimport { ContractorType } from './shared/useContractorDetailsForm'\nimport { IndividualSelfOnboardingProfile } from './IndividualSelfOnboardingProfile'\nimport { BusinessSelfOnboardingProfile } from './BusinessSelfOnboardingProfile'\nimport { BaseLayout } from '@/components/Base'\nimport type { OnEventType } from '@/components/Base/useBase'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport { useI18n } from '@/i18n'\nimport type { EventType } from '@/shared/constants'\n\n/**\n * Props shared by the contractor self-onboarding profile components.\n *\n * @internal\n */\nexport interface ContractorSelfOnboardingProfileProps {\n  /** UUID of the existing contractor completing self-onboarding. */\n  contractorId: string\n  /** Callback invoked when the component emits an event. */\n  onEvent: OnEventType<EventType, unknown>\n  /** Optional class name applied to the root element. */\n  className?: string\n}\n\n/**\n * Resolves the contractor's type and renders the matching self-onboarding\n * profile — individual or business.\n *\n * @internal\n */\nexport function SelfOnboardingContractorProfile({\n  contractorId,\n  onEvent,\n  className,\n}: ContractorSelfOnboardingProfileProps) {\n  useI18n('Contractor.Profile')\n\n  const contractorQuery = useContractorsGet({ contractorUuid: contractorId })\n  const contractor = contractorQuery.data?.contractor\n\n  if (contractorQuery.isLoading || !contractor) {\n    const errorHandling = composeErrorHandler([contractorQuery])\n    return <BaseLayout isLoading error={errorHandling.errors} />\n  }\n\n  return contractor.type === ContractorType.Business ? (\n    <BusinessSelfOnboardingProfile\n      contractorId={contractorId}\n      onEvent={onEvent}\n      className={className}\n    />\n  ) : (\n    <IndividualSelfOnboardingProfile\n      contractorId={contractorId}\n      onEvent={onEvent}\n      className={className}\n    />\n  )\n}\n"],"names":["SelfOnboardingContractorProfile","contractorId","onEvent","className","useI18n","contractorQuery","useContractorsGet","contractor","errorHandling","composeErrorHandler","BaseLayout","ContractorType","jsx","BusinessSelfOnboardingProfile","IndividualSelfOnboardingProfile"],"mappings":";;;;;;;;;AA8BO,SAASA,EAAgC;AAAA,EAC9C,cAAAC;AAAA,EACA,SAAAC;AAAA,EACA,WAAAC;AACF,GAAyC;AACvC,EAAAC,EAAQ,oBAAoB;AAE5B,QAAMC,IAAkBC,EAAkB,EAAE,gBAAgBL,GAAc,GACpEM,IAAaF,EAAgB,MAAM;AAEzC,MAAIA,EAAgB,aAAa,CAACE,GAAY;AAC5C,UAAMC,IAAgBC,EAAoB,CAACJ,CAAe,CAAC;AAC3D,6BAAQK,GAAA,EAAW,WAAS,IAAC,OAAOF,EAAc,QAAQ;AAAA,EAC5D;AAEA,SAAOD,EAAW,SAASI,EAAe,WACxC,gBAAAC;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,cAAAZ;AAAA,MACA,SAAAC;AAAA,MACA,WAAAC;AAAA,IAAA;AAAA,EAAA,IAGF,gBAAAS;AAAA,IAACE;AAAA,IAAA;AAAA,MACC,cAAAb;AAAA,MACA,SAAAC;AAAA,MACA,WAAAC;AAAA,IAAA;AAAA,EAAA;AAGN;"}

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

@@ -1,2 +1,2 @@
 import "./types/i18next.d.ts"
-export { ContractorProfile, type ContractorProfileProps } from './ContractorProfile';
+export { ContractorProfile, type ContractorProfileProps, type ContractorProfileAdminProps, type ContractorProfileSelfOnboardingProps, } from './ContractorProfile';

package/dist/components/Contractor/Profile/shared/index.d.ts

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

package/dist/components/Contractor/Profile/shared/useContractorDetailsForm/contractorDetailsSchema.d.ts

@@ -0,0 +1,126 @@
+import { z } from 'zod';
+import { OptionalFieldsToRequire } from '../../../../../partner-hook-utils/form/buildFormSchema';
+/**
+ * Contractor type enum (`Individual` / `Business`) re-exported from the API model.
+ *
+ * @public
+ */
+export declare const ContractorType: {
+    readonly Individual: "Individual";
+    readonly Business: "Business";
+};
+/**
+ * Contractor wage type enum (`Fixed` / `Hourly`) re-exported from the API model.
+ *
+ * @public
+ */
+export declare const WageType: {
+    readonly Fixed: "Fixed";
+    readonly Hourly: "Hourly";
+};
+/**
+ * Validation error codes emitted by the contractor details form schema. Map
+ * these codes to localized copy in `validationMessages` when composing the
+ * hook.
+ *
+ * @public
+ */
+export declare const ContractorDetailsErrorCodes: {
+    readonly REQUIRED: "REQUIRED";
+    readonly INVALID_NAME: "INVALID_NAME";
+    readonly INVALID_EMAIL: "INVALID_EMAIL";
+    readonly INVALID_SSN: "INVALID_SSN";
+    readonly INVALID_EIN: "INVALID_EIN";
+};
+/**
+ * Union of validation error code strings emitted by the contractor details
+ * form schema.
+ *
+ * @public
+ */
+export type ContractorDetailsErrorCode = (typeof ContractorDetailsErrorCodes)[keyof typeof ContractorDetailsErrorCodes];
+declare const fieldValidators: {
+    type: z.ZodEnum<{
+        Business: "Business";
+        Individual: "Individual";
+    }>;
+    wageType: z.ZodEnum<{
+        Fixed: "Fixed";
+        Hourly: "Hourly";
+    }>;
+    startDate: z.ZodPipe<z.ZodTransform<string | null, unknown>, z.ZodISODate>;
+    hourlyRate: z.ZodPipe<z.ZodTransform<number, unknown>, z.ZodNumber>;
+    selfOnboarding: z.ZodBoolean;
+    fileNewHireReport: z.ZodBoolean;
+    email: z.ZodEmail;
+    firstName: z.ZodString;
+    lastName: z.ZodString;
+    middleInitial: z.ZodString;
+    businessName: z.ZodString;
+    workState: z.ZodString;
+    ssn: z.ZodString;
+    ein: z.ZodString;
+};
+/**
+ * Shape of the values managed by the contractor details form.
+ *
+ * @public
+ * @interface
+ */
+export type ContractorDetailsFormData = { type: "Business" | "Individual"; wageType: "Fixed" | "Hourly"; startDate: string; hourlyRate: number; selfOnboarding: boolean; fileNewHireReport: boolean; email: string; firstName: string; lastName: string; middleInitial: string; businessName: string; workState: string; ssn: string; ein: string; };
+/**
+ * Shape of the validated values produced by the contractor details form on
+ * submit.
+ *
+ * @public
+ */
+export type ContractorDetailsFormOutputs = ContractorDetailsFormData;
+/**
+ * Keys of optional contractor details fields that can be promoted to required
+ * via the hook's `optionalFieldsToRequire` option.
+ *
+ * @public
+ */
+export type ContractorDetailsOptionalFieldsToRequire = { create?: ("middleInitial" | "ssn" | "ein")[] | undefined; update?: ("hourlyRate" | "startDate" | "firstName" | "lastName" | "middleInitial" | "businessName" | "workState" | "ssn" | "ein")[] | undefined; };
+/** @internal */
+interface ContractorDetailsSchemaOptions {
+    mode?: 'create' | 'update';
+    optionalFieldsToRequire?: ContractorDetailsOptionalFieldsToRequire;
+    hasSsn?: boolean;
+    hasEin?: boolean;
+}
+/** @internal */
+export declare function createContractorDetailsSchema(options?: ContractorDetailsSchemaOptions): import('../../../../../partner-hook-utils/form/buildFormSchema').BuildFormSchemaResult<{
+    type: z.ZodEnum<{
+        Business: "Business";
+        Individual: "Individual";
+    }>;
+    wageType: z.ZodEnum<{
+        Fixed: "Fixed";
+        Hourly: "Hourly";
+    }>;
+    startDate: z.ZodPipe<z.ZodTransform<string | null, unknown>, z.ZodISODate>;
+    hourlyRate: z.ZodPipe<z.ZodTransform<number, unknown>, z.ZodNumber>;
+    selfOnboarding: z.ZodBoolean;
+    fileNewHireReport: z.ZodBoolean;
+    email: z.ZodEmail;
+    firstName: z.ZodString;
+    lastName: z.ZodString;
+    middleInitial: z.ZodString;
+    businessName: z.ZodString;
+    workState: z.ZodString;
+    ssn: z.ZodString;
+    ein: z.ZodString;
+}>;
+/** @internal */
+export type ContractorDiscriminators = Partial<Pick<ContractorDetailsFormData, 'type' | 'wageType' | 'fileNewHireReport'>>;
+/**
+ * Fields that don't apply to the given contractor selection. Their required
+ * check is skipped at validation time and they're never rendered. `email` is
+ * never excluded — it always applies and its requiredness is governed by the
+ * `selfOnboarding` predicate.
+ *
+ * @internal
+ */
+export declare function getExcludedContractorFields(values: ContractorDiscriminators): Array<keyof typeof fieldValidators>;
+export {};

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

@@ -0,0 +1,73 @@
+import { z as e } from "zod";
+import { ContractorType as N, WageType as c } from "@gusto/embedded-api-v-2025-11-15/models/components/contractor";
+import { buildFormSchema as E } from "../../../../../partner-hook-utils/form/buildFormSchema.js";
+import { coerceNaN as d, coerceToISODate as p } from "../../../../../partner-hook-utils/form/preprocessors.js";
+import { SSN_REGEX as u, NAME_REGEX as I } from "../../../../../helpers/validations.js";
+import { normalizeEin as f } from "../../../../../helpers/federalEin.js";
+const o = N, n = c, t = {
+  REQUIRED: "REQUIRED",
+  INVALID_NAME: "INVALID_NAME",
+  INVALID_EMAIL: "INVALID_EMAIL",
+  INVALID_SSN: "INVALID_SSN",
+  INVALID_EIN: "INVALID_EIN"
+}, R = /^\d{2}-\d{7}$/, D = {
+  type: e.enum([o.Individual, o.Business]),
+  wageType: e.enum([n.Hourly, n.Fixed]),
+  startDate: e.preprocess(
+    p,
+    e.iso.date({ error: () => t.REQUIRED })
+  ),
+  hourlyRate: e.preprocess(d(0), e.number().min(0)),
+  selfOnboarding: e.boolean(),
+  fileNewHireReport: e.boolean(),
+  email: e.email({ error: () => t.INVALID_EMAIL }),
+  firstName: e.string().min(1, { message: t.REQUIRED }).regex(I, { message: t.INVALID_NAME }),
+  lastName: e.string().min(1, { message: t.REQUIRED }).regex(I, { message: t.INVALID_NAME }),
+  middleInitial: e.string(),
+  businessName: e.string(),
+  workState: e.string(),
+  ssn: e.string({ error: () => t.REQUIRED }).refine((r) => u.test(r.replace(/\D/g, "")), {
+    message: t.INVALID_SSN
+  }),
+  ein: e.string({ error: () => t.REQUIRED }).refine((r) => R.test(f(r)), {
+    message: t.INVALID_EIN
+  })
+}, g = {
+  startDate: "create",
+  firstName: "create",
+  lastName: "create",
+  businessName: "create",
+  hourlyRate: "create",
+  workState: "create",
+  middleInitial: "never",
+  ssn: "never",
+  ein: "never",
+  email: (r) => r.selfOnboarding
+};
+function T(r = {}) {
+  const { mode: i = "create", optionalFieldsToRequire: s, hasSsn: l = !1, hasEin: m = !1 } = r, a = [];
+  return l && a.push("ssn"), m && a.push("ein"), E(D, {
+    requiredFieldsConfig: g,
+    requiredErrorCode: t.REQUIRED,
+    mode: i,
+    optionalFieldsToRequire: s,
+    fieldsWithRedactedValues: a,
+    // Applicability gating: evaluated per-validation so a field's required
+    // check is skipped while it doesn't apply to the current selection. The
+    // field stays in the schema (validated as optional), keeping requiredness
+    // static and fully promotable via `optionalFieldsToRequire`.
+    excludeFields: A
+  });
+}
+function A(r) {
+  const i = r.type === o.Individual, s = [];
+  return r.wageType !== n.Hourly && s.push("hourlyRate"), i ? (s.push("businessName", "ein"), r.fileNewHireReport || s.push("workState")) : s.push("firstName", "lastName", "middleInitial", "fileNewHireReport", "ssn", "workState"), s;
+}
+export {
+  t as ContractorDetailsErrorCodes,
+  o as ContractorType,
+  n as WageType,
+  T as createContractorDetailsSchema,
+  A as getExcludedContractorFields
+};
+//# sourceMappingURL=contractorDetailsSchema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contractorDetailsSchema.js","sources":["../../../../../../src/components/Contractor/Profile/shared/useContractorDetailsForm/contractorDetailsSchema.ts"],"sourcesContent":["import { z } from 'zod'\nimport {\n  WageType as ApiWageType,\n  ContractorType as ApiContractorType,\n} from '@gusto/embedded-api-v-2025-11-15/models/components/contractor'\nimport {\n  buildFormSchema,\n  type RequiredFieldConfig,\n  type OptionalFieldsToRequire,\n} from '@/partner-hook-utils/form/buildFormSchema'\nimport { coerceNaN, coerceToISODate } from '@/partner-hook-utils/form/preprocessors'\nimport { SSN_REGEX, NAME_REGEX } from '@/helpers/validations'\nimport { normalizeEin } from '@/helpers/federalEin'\n\n/**\n * Contractor type enum (`Individual` / `Business`) re-exported from the API model.\n *\n * @public\n */\nexport const ContractorType = ApiContractorType\n/**\n * Contractor wage type enum (`Fixed` / `Hourly`) re-exported from the API model.\n *\n * @public\n */\nexport const WageType = ApiWageType\n\n// ── Error codes ────────────────────────────────────────────────────────\n\n/**\n * Validation error codes emitted by the contractor details form schema. Map\n * these codes to localized copy in `validationMessages` when composing the\n * hook.\n *\n * @public\n */\nexport const ContractorDetailsErrorCodes = {\n  REQUIRED: 'REQUIRED',\n  INVALID_NAME: 'INVALID_NAME',\n  INVALID_EMAIL: 'INVALID_EMAIL',\n  INVALID_SSN: 'INVALID_SSN',\n  INVALID_EIN: 'INVALID_EIN',\n} as const\n\n/**\n * Union of validation error code strings emitted by the contractor details\n * form schema.\n *\n * @public\n */\nexport type ContractorDetailsErrorCode =\n  (typeof ContractorDetailsErrorCodes)[keyof typeof ContractorDetailsErrorCodes]\n\nconst EIN_FORMAT_REGEX = /^\\d{2}-\\d{7}$/\n\n// ── Field validators ───────────────────────────────────────────────────\n\nconst fieldValidators = {\n  type: z.enum([ContractorType.Individual, ContractorType.Business]),\n  wageType: z.enum([WageType.Hourly, WageType.Fixed]),\n  startDate: z.preprocess(\n    coerceToISODate,\n    z.iso.date({ error: () => ContractorDetailsErrorCodes.REQUIRED }),\n  ),\n  hourlyRate: z.preprocess(coerceNaN(0), z.number().min(0)),\n  selfOnboarding: z.boolean(),\n  fileNewHireReport: z.boolean(),\n  email: z.email({ error: () => ContractorDetailsErrorCodes.INVALID_EMAIL }),\n  firstName: z\n    .string()\n    .min(1, { message: ContractorDetailsErrorCodes.REQUIRED })\n    .regex(NAME_REGEX, { message: ContractorDetailsErrorCodes.INVALID_NAME }),\n  lastName: z\n    .string()\n    .min(1, { message: ContractorDetailsErrorCodes.REQUIRED })\n    .regex(NAME_REGEX, { message: ContractorDetailsErrorCodes.INVALID_NAME }),\n  middleInitial: z.string(),\n  businessName: z.string(),\n  workState: z.string(),\n  ssn: z\n    .string({ error: () => ContractorDetailsErrorCodes.REQUIRED })\n    .refine((v: string) => SSN_REGEX.test(v.replace(/\\D/g, '')), {\n      message: ContractorDetailsErrorCodes.INVALID_SSN,\n    }),\n  ein: z\n    .string({ error: () => ContractorDetailsErrorCodes.REQUIRED })\n    .refine((v: string) => EIN_FORMAT_REGEX.test(normalizeEin(v)), {\n      message: ContractorDetailsErrorCodes.INVALID_EIN,\n    }),\n}\n\n/**\n * Shape of the values managed by the contractor details form.\n *\n * @public\n * @interface\n */\nexport type ContractorDetailsFormData = {\n  [K in keyof typeof fieldValidators]: z.infer<(typeof fieldValidators)[K]>\n}\n\n/**\n * Shape of the validated values produced by the contractor details form on\n * submit.\n *\n * @public\n */\nexport type ContractorDetailsFormOutputs = ContractorDetailsFormData\n\n// ── Required fields config ─────────────────────────────────────────────\n//\n// Requiredness mirrors the contractor create/update API contract: fields the\n// API requires on create are `'create'` (optional on update), and fields the\n// API treats as optional are `'never'`. Type/wage *applicability* (does a field\n// apply to this contractor at all?) is handled separately by `excludeFields` —\n// see `getExcludedContractorFields` — not by requiredness. SSN/EIN are never\n// gated by `selfOnboarding`: each consumer decides whether to render and require\n// them (admins hide them when inviting; self-onboarding profiles collect them).\n//\n// `email` is the one genuinely value-conditional rule: it always applies but is\n// only required when self-onboarding is on (create and update, matching the\n// API's \"if self_onboarding is true, then email is required\"). A single-operand\n// predicate keeps `buildFormSchema`'s dependency-detecting Proxy accurate.\n\nconst requiredFieldsConfig = {\n  startDate: 'create',\n  firstName: 'create',\n  lastName: 'create',\n  businessName: 'create',\n  hourlyRate: 'create',\n  workState: 'create',\n  middleInitial: 'never',\n  ssn: 'never',\n  ein: 'never',\n  email: data => data.selfOnboarding,\n} satisfies RequiredFieldConfig<typeof fieldValidators>\n\n// ── Schema factory ─────────────────────────────────────────────────────\n\n/**\n * Keys of optional contractor details fields that can be promoted to required\n * via the hook's `optionalFieldsToRequire` option.\n *\n * @public\n */\nexport type ContractorDetailsOptionalFieldsToRequire = OptionalFieldsToRequire<\n  typeof requiredFieldsConfig\n>\n\n/** @internal */\ninterface ContractorDetailsSchemaOptions {\n  mode?: 'create' | 'update'\n  optionalFieldsToRequire?: ContractorDetailsOptionalFieldsToRequire\n  hasSsn?: boolean\n  hasEin?: boolean\n}\n\n/** @internal */\nexport function createContractorDetailsSchema(options: ContractorDetailsSchemaOptions = {}) {\n  const { mode = 'create', optionalFieldsToRequire, hasSsn = false, hasEin = false } = options\n\n  const fieldsWithRedactedValues: Array<keyof typeof fieldValidators> = []\n  if (hasSsn) fieldsWithRedactedValues.push('ssn')\n  if (hasEin) fieldsWithRedactedValues.push('ein')\n\n  return buildFormSchema(fieldValidators, {\n    requiredFieldsConfig,\n    requiredErrorCode: ContractorDetailsErrorCodes.REQUIRED,\n    mode,\n    optionalFieldsToRequire,\n    fieldsWithRedactedValues,\n    // Applicability gating: evaluated per-validation so a field's required\n    // check is skipped while it doesn't apply to the current selection. The\n    // field stays in the schema (validated as optional), keeping requiredness\n    // static and fully promotable via `optionalFieldsToRequire`.\n    excludeFields: getExcludedContractorFields,\n  })\n}\n\n/** @internal */\nexport type ContractorDiscriminators = Partial<\n  Pick<ContractorDetailsFormData, 'type' | 'wageType' | 'fileNewHireReport'>\n>\n\n/**\n * Fields that don't apply to the given contractor selection. Their required\n * check is skipped at validation time and they're never rendered. `email` is\n * never excluded — it always applies and its requiredness is governed by the\n * `selfOnboarding` predicate.\n *\n * @internal\n */\nexport function getExcludedContractorFields(\n  values: ContractorDiscriminators,\n): Array<keyof typeof fieldValidators> {\n  const isIndividual = values.type === ContractorType.Individual\n  const excluded: Array<keyof typeof fieldValidators> = []\n\n  if (values.wageType !== WageType.Hourly) excluded.push('hourlyRate')\n\n  if (isIndividual) {\n    excluded.push('businessName', 'ein')\n    if (!values.fileNewHireReport) excluded.push('workState')\n  } else {\n    excluded.push('firstName', 'lastName', 'middleInitial', 'fileNewHireReport', 'ssn', 'workState')\n  }\n\n  return excluded\n}\n"],"names":["ContractorType","ApiContractorType","WageType","ApiWageType","ContractorDetailsErrorCodes","EIN_FORMAT_REGEX","fieldValidators","z","coerceToISODate","coerceNaN","NAME_REGEX","v","SSN_REGEX","normalizeEin","requiredFieldsConfig","data","createContractorDetailsSchema","options","mode","optionalFieldsToRequire","hasSsn","hasEin","fieldsWithRedactedValues","buildFormSchema","getExcludedContractorFields","values","isIndividual","excluded"],"mappings":";;;;;;AAmBO,MAAMA,IAAiBC,GAMjBC,IAAWC,GAWXC,IAA8B;AAAA,EACzC,UAAU;AAAA,EACV,cAAc;AAAA,EACd,eAAe;AAAA,EACf,aAAa;AAAA,EACb,aAAa;AACf,GAWMC,IAAmB,iBAInBC,IAAkB;AAAA,EACtB,MAAMC,EAAE,KAAK,CAACP,EAAe,YAAYA,EAAe,QAAQ,CAAC;AAAA,EACjE,UAAUO,EAAE,KAAK,CAACL,EAAS,QAAQA,EAAS,KAAK,CAAC;AAAA,EAClD,WAAWK,EAAE;AAAA,IACXC;AAAA,IACAD,EAAE,IAAI,KAAK,EAAE,OAAO,MAAMH,EAA4B,UAAU;AAAA,EAAA;AAAA,EAElE,YAAYG,EAAE,WAAWE,EAAU,CAAC,GAAGF,EAAE,OAAA,EAAS,IAAI,CAAC,CAAC;AAAA,EACxD,gBAAgBA,EAAE,QAAA;AAAA,EAClB,mBAAmBA,EAAE,QAAA;AAAA,EACrB,OAAOA,EAAE,MAAM,EAAE,OAAO,MAAMH,EAA4B,eAAe;AAAA,EACzE,WAAWG,EACR,OAAA,EACA,IAAI,GAAG,EAAE,SAASH,EAA4B,SAAA,CAAU,EACxD,MAAMM,GAAY,EAAE,SAASN,EAA4B,cAAc;AAAA,EAC1E,UAAUG,EACP,OAAA,EACA,IAAI,GAAG,EAAE,SAASH,EAA4B,SAAA,CAAU,EACxD,MAAMM,GAAY,EAAE,SAASN,EAA4B,cAAc;AAAA,EAC1E,eAAeG,EAAE,OAAA;AAAA,EACjB,cAAcA,EAAE,OAAA;AAAA,EAChB,WAAWA,EAAE,OAAA;AAAA,EACb,KAAKA,EACF,OAAO,EAAE,OAAO,MAAMH,EAA4B,UAAU,EAC5D,OAAO,CAACO,MAAcC,EAAU,KAAKD,EAAE,QAAQ,OAAO,EAAE,CAAC,GAAG;AAAA,IAC3D,SAASP,EAA4B;AAAA,EAAA,CACtC;AAAA,EACH,KAAKG,EACF,OAAO,EAAE,OAAO,MAAMH,EAA4B,SAAA,CAAU,EAC5D,OAAO,CAACO,MAAcN,EAAiB,KAAKQ,EAAaF,CAAC,CAAC,GAAG;AAAA,IAC7D,SAASP,EAA4B;AAAA,EAAA,CACtC;AACL,GAmCMU,IAAuB;AAAA,EAC3B,WAAW;AAAA,EACX,WAAW;AAAA,EACX,UAAU;AAAA,EACV,cAAc;AAAA,EACd,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,eAAe;AAAA,EACf,KAAK;AAAA,EACL,KAAK;AAAA,EACL,OAAO,OAAQC,EAAK;AACtB;AAuBO,SAASC,EAA8BC,IAA0C,IAAI;AAC1F,QAAM,EAAE,MAAAC,IAAO,UAAU,yBAAAC,GAAyB,QAAAC,IAAS,IAAO,QAAAC,IAAS,OAAUJ,GAE/EK,IAAgE,CAAA;AACtE,SAAIF,KAAQE,EAAyB,KAAK,KAAK,GAC3CD,KAAQC,EAAyB,KAAK,KAAK,GAExCC,EAAgBjB,GAAiB;AAAA,IACtC,sBAAAQ;AAAA,IACA,mBAAmBV,EAA4B;AAAA,IAC/C,MAAAc;AAAA,IACA,yBAAAC;AAAA,IACA,0BAAAG;AAAA;AAAA;AAAA;AAAA;AAAA,IAKA,eAAeE;AAAA,EAAA,CAChB;AACH;AAeO,SAASA,EACdC,GACqC;AACrC,QAAMC,IAAeD,EAAO,SAASzB,EAAe,YAC9C2B,IAAgD,CAAA;AAEtD,SAAIF,EAAO,aAAavB,EAAS,UAAQyB,EAAS,KAAK,YAAY,GAE/DD,KACFC,EAAS,KAAK,gBAAgB,KAAK,GAC9BF,EAAO,qBAAmBE,EAAS,KAAK,WAAW,KAExDA,EAAS,KAAK,aAAa,YAAY,iBAAiB,qBAAqB,OAAO,WAAW,GAG1FA;AACT;"}

package/dist/components/Contractor/Profile/shared/useContractorDetailsForm/contractorDetailsSchema.test.d.ts

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