@gusto/embedded-react-sdk 0.49.0 → 0.50.0

package/dist/components/Payroll/usePreparedPayrollData.js.map

@@ -1 +1 @@
-{"version":3,"file":"usePreparedPayrollData.js","sources":["../../../src/components/Payroll/usePreparedPayrollData.ts"],"sourcesContent":["import { useState, useEffect, useCallback, useRef, useMemo } from 'react'\nimport { usePayrollsPrepareMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/payrollsPrepare'\nimport { usePaySchedulesGet } from '@gusto/embedded-api-v-2025-11-15/react-query/paySchedulesGet'\nimport type { PayrollPrepared } from '@gusto/embedded-api-v-2025-11-15/models/components/payroll'\nimport type { PayScheduleShow } from '@gusto/embedded-api-v-2025-11-15/models/components/payscheduleshow'\nimport type { QueryParamSortBy } from '@gusto/embedded-api-v-2025-11-15/models/operations/putv1companiescompanyidpayrollspayrollidprepare'\nimport { UnprocessableEntityError } from '@gusto/embedded-api-v-2025-11-15/models/errors/unprocessableentityerror'\nimport { useBase } from '../Base'\nimport { retryAsync } from '@/helpers/retryAsync'\n\ninterface UsePreparedPayrollDataParams {\n  companyId: string\n  payrollId: string\n  employeeUuids?: string[]\n  sortBy?: QueryParamSortBy\n  onDataReady?: (preparedPayroll: PayrollPrepared) => void\n}\n\ninterface UsePreparedPayrollDataReturn {\n  handlePreparePayroll: () => Promise<void>\n  preparedPayroll: PayrollPrepared | undefined\n  paySchedule: PayScheduleShow | undefined\n  isLoading: boolean\n  isPaginating: boolean\n  hasInitialData: boolean\n}\n\nconst PREPARE_MAX_ATTEMPTS = 4\nconst PREPARE_RETRY_DELAY_MS = 1500\n\nconst isPayrollBeingProcessedError = (error: unknown): boolean => {\n  if (!(error instanceof UnprocessableEntityError)) return false\n  return error.errors.some(e => e.category === 'invalid_operation')\n}\n\n/**\n * Wraps the prepare-payroll mutation and pay-schedule fetch, retrying while the payroll is still being processed.\n *\n * @remarks\n * Fires the prepare call once on mount, then exposes `handlePreparePayroll` for callers that need to re-prepare\n * (e.g. after sort or pagination changes). Distinguishes initial loading from subsequent pagination via\n * `isLoading` and `isPaginating`, and surfaces the pay schedule for the prepared payroll's pay period.\n *\n * @param params - The company and payroll identifiers, plus optional employee filter, sort, and ready callback.\n * @returns The prepared payroll, its pay schedule, loading flags, and a `handlePreparePayroll` callback to re-run.\n * @internal\n */\nexport const usePreparedPayrollData = ({\n  companyId,\n  payrollId,\n  employeeUuids,\n  sortBy,\n  onDataReady,\n}: UsePreparedPayrollDataParams): UsePreparedPayrollDataReturn => {\n  const { mutateAsync: preparePayroll, isPending: isPreparePayrollPending } =\n    usePayrollsPrepareMutation()\n  const [preparedPayroll, setPreparedPayroll] = useState<PayrollPrepared | undefined>()\n  const hasInitialDataRef = useRef(false)\n  const hasFiredRef = useRef(false)\n  const { baseSubmitHandler } = useBase()\n\n  const employeeUuidsKey = useMemo(() => employeeUuids?.join(',') ?? '', [employeeUuids])\n\n  const { data: payScheduleData, isLoading: isPayScheduleLoading } = usePaySchedulesGet(\n    {\n      companyId,\n      payScheduleId: preparedPayroll?.payPeriod?.payScheduleUuid || '',\n    },\n    {\n      enabled: !!preparedPayroll?.payPeriod?.payScheduleUuid,\n    },\n  )\n\n  const executePrepare = useCallback(async () => {\n    const result = await preparePayroll({\n      request: {\n        companyId,\n        payrollId,\n        sortBy,\n        requestBody: {\n          employeeUuids,\n        },\n      },\n    })\n    setPreparedPayroll(result.payrollPrepared)\n    if (result.payrollPrepared) {\n      hasInitialDataRef.current = true\n      onDataReady?.(result.payrollPrepared)\n    }\n  }, [companyId, payrollId, preparePayroll, employeeUuidsKey, sortBy, onDataReady])\n\n  const handlePreparePayroll = useCallback(async () => {\n    await baseSubmitHandler(null, () =>\n      retryAsync(executePrepare, {\n        maxAttempts: PREPARE_MAX_ATTEMPTS,\n        delayMs: PREPARE_RETRY_DELAY_MS,\n        shouldRetry: isPayrollBeingProcessedError,\n      }),\n    )\n  }, [baseSubmitHandler, executePrepare])\n\n  useEffect(() => {\n    if (hasFiredRef.current) return\n    hasFiredRef.current = true\n    void handlePreparePayroll()\n  }, [handlePreparePayroll])\n\n  const isInitialLoading = isPreparePayrollPending && !hasInitialDataRef.current\n  const isPaginating = isPreparePayrollPending && hasInitialDataRef.current\n  const isLoading = isInitialLoading || isPayScheduleLoading\n\n  return {\n    handlePreparePayroll,\n    preparedPayroll,\n    paySchedule: payScheduleData?.payScheduleShow,\n    isLoading,\n    isPaginating,\n    hasInitialData: hasInitialDataRef.current,\n  }\n}\n"],"names":["PREPARE_MAX_ATTEMPTS","PREPARE_RETRY_DELAY_MS","isPayrollBeingProcessedError","error","UnprocessableEntityError","e","usePreparedPayrollData","companyId","payrollId","employeeUuids","sortBy","onDataReady","preparePayroll","isPreparePayrollPending","usePayrollsPrepareMutation","preparedPayroll","setPreparedPayroll","useState","hasInitialDataRef","useRef","hasFiredRef","baseSubmitHandler","useBase","employeeUuidsKey","useMemo","payScheduleData","isPayScheduleLoading","usePaySchedulesGet","executePrepare","useCallback","result","handlePreparePayroll","retryAsync","useEffect","isInitialLoading","isPaginating","isLoading"],"mappings":";;;;;;;;;;;;;;;;AA2BA,MAAMA,IAAuB,GACvBC,IAAyB,MAEzBC,IAA+B,CAACC,MAC9BA,aAAiBC,IAChBD,EAAM,OAAO,KAAK,CAAAE,MAAKA,EAAE,aAAa,mBAAmB,IADP,IAgB9CC,IAAyB,CAAC;AAAA,EACrC,WAAAC;AAAA,EACA,WAAAC;AAAA,EACA,eAAAC;AAAA,EACA,QAAAC;AAAA,EACA,aAAAC;AACF,MAAkE;AAChE,QAAM,EAAE,aAAaC,GAAgB,WAAWC,EAAA,IAC9CC,EAAA,GACI,CAACC,GAAiBC,CAAkB,IAAIC,EAAA,GACxCC,IAAoBC,EAAO,EAAK,GAChCC,IAAcD,EAAO,EAAK,GAC1B,EAAE,mBAAAE,EAAA,IAAsBC,EAAA,GAExBC,IAAmBC,EAAQ,MAAMf,GAAe,KAAK,GAAG,KAAK,IAAI,CAACA,CAAa,CAAC,GAEhF,EAAE,MAAMgB,GAAiB,WAAWC,MAAyBC;AAAA,IACjE;AAAA,MACE,WAAApB;AAAA,MACA,eAAeQ,GAAiB,WAAW,mBAAmB;AAAA,IAAA;AAAA,IAEhE;AAAA,MACE,SAAS,CAAC,CAACA,GAAiB,WAAW;AAAA,IAAA;AAAA,EACzC,GAGIa,IAAiBC,EAAY,YAAY;AAC7C,UAAMC,IAAS,MAAMlB,EAAe;AAAA,MAClC,SAAS;AAAA,QACP,WAAAL;AAAA,QACA,WAAAC;AAAA,QACA,QAAAE;AAAA,QACA,aAAa;AAAA,UACX,eAAAD;AAAA,QAAA;AAAA,MACF;AAAA,IACF,CACD;AACD,IAAAO,EAAmBc,EAAO,eAAe,GACrCA,EAAO,oBACTZ,EAAkB,UAAU,IAC5BP,IAAcmB,EAAO,eAAe;AAAA,EAExC,GAAG,CAACvB,GAAWC,GAAWI,GAAgBW,GAAkBb,GAAQC,CAAW,CAAC,GAE1EoB,IAAuBF,EAAY,YAAY;AACnD,UAAMR;AAAA,MAAkB;AAAA,MAAM,MAC5BW,EAAWJ,GAAgB;AAAA,QACzB,aAAa5B;AAAA,QACb,SAASC;AAAA,QACT,aAAaC;AAAA,MAAA,CACd;AAAA,IAAA;AAAA,EAEL,GAAG,CAACmB,GAAmBO,CAAc,CAAC;AAEtC,EAAAK,EAAU,MAAM;AACd,IAAIb,EAAY,YAChBA,EAAY,UAAU,IACjBW,EAAA;AAAA,EACP,GAAG,CAACA,CAAoB,CAAC;AAEzB,QAAMG,IAAmBrB,KAA2B,CAACK,EAAkB,SACjEiB,IAAetB,KAA2BK,EAAkB,SAC5DkB,IAAYF,KAAoBR;AAEtC,SAAO;AAAA,IACL,sBAAAK;AAAA,IACA,iBAAAhB;AAAA,IACA,aAAaU,GAAiB;AAAA,IAC9B,WAAAW;AAAA,IACA,cAAAD;AAAA,IACA,gBAAgBjB,EAAkB;AAAA,EAAA;AAEtC;"}
+{"version":3,"file":"usePreparedPayrollData.js","sources":["../../../src/components/Payroll/usePreparedPayrollData.ts"],"sourcesContent":["import { useState, useEffect, useCallback, useRef, useMemo } from 'react'\nimport { usePayrollsPrepareMutation } from '@gusto/embedded-api-v-2025-11-15/react-query/payrollsPrepare'\nimport { usePaySchedulesGet } from '@gusto/embedded-api-v-2025-11-15/react-query/paySchedulesGet'\nimport type { PayrollPrepared } from '@gusto/embedded-api-v-2025-11-15/models/components/payroll'\nimport type { PayScheduleShow } from '@gusto/embedded-api-v-2025-11-15/models/components/payscheduleshow'\nimport type { QueryParamSortBy } from '@gusto/embedded-api-v-2025-11-15/models/operations/putv1companiescompanyidpayrollspayrollidprepare'\nimport { UnprocessableEntityError } from '@gusto/embedded-api-v-2025-11-15/models/errors/unprocessableentityerror'\nimport { useBase } from '../Base'\nimport { retryAsync } from '@/helpers/retryAsync'\n\ninterface UsePreparedPayrollDataParams {\n  companyId: string\n  payrollId: string\n  employeeUuids?: string[]\n  sortBy?: QueryParamSortBy\n  onDataReady?: (preparedPayroll: PayrollPrepared) => void\n}\n\ninterface UsePreparedPayrollDataReturn {\n  handlePreparePayroll: () => Promise<void>\n  preparedPayroll: PayrollPrepared | undefined\n  paySchedule: PayScheduleShow | undefined\n  isLoading: boolean\n  isPaginating: boolean\n  hasInitialData: boolean\n}\n\nconst PREPARE_MAX_ATTEMPTS = 4\nconst PREPARE_RETRY_DELAY_MS = 1500\n\nconst isPayrollBeingProcessedError = (error: unknown): boolean => {\n  if (!(error instanceof UnprocessableEntityError)) return false\n  return error.errors.some(e => e.category === 'invalid_operation')\n}\n\n/**\n * Wraps the prepare-payroll mutation and pay-schedule fetch, retrying while the payroll is still being processed.\n *\n * @remarks\n * Fires the prepare call once on mount, then exposes `handlePreparePayroll` for callers that need to re-prepare\n * (e.g. after sort or pagination changes). Distinguishes initial loading from subsequent pagination via\n * `isLoading` and `isPaginating`, and surfaces the pay schedule for the prepared payroll's pay period.\n *\n * @param params - The company and payroll identifiers, plus optional employee filter, sort, and ready callback.\n * @returns The prepared payroll, its pay schedule, loading flags, and a `handlePreparePayroll` callback to re-run.\n * @internal\n */\nexport const usePreparedPayrollData = ({\n  companyId,\n  payrollId,\n  employeeUuids,\n  sortBy,\n  onDataReady,\n}: UsePreparedPayrollDataParams): UsePreparedPayrollDataReturn => {\n  const { mutateAsync: preparePayroll, isPending: isPreparePayrollPending } =\n    usePayrollsPrepareMutation()\n  const [preparedPayroll, setPreparedPayroll] = useState<PayrollPrepared | undefined>()\n  const hasInitialDataRef = useRef(false)\n  const hasFiredRef = useRef(false)\n  const { baseSubmitHandler } = useBase()\n\n  const employeeUuidsKey = useMemo(() => employeeUuids?.join(',') ?? '', [employeeUuids])\n\n  const { data: payScheduleData, isLoading: isPayScheduleLoading } = usePaySchedulesGet(\n    {\n      companyId,\n      payScheduleId: preparedPayroll?.payPeriod?.payScheduleUuid || '',\n    },\n    {\n      enabled: !!preparedPayroll?.payPeriod?.payScheduleUuid,\n    },\n  )\n\n  const executePrepare = useCallback(async () => {\n    const result = await preparePayroll({\n      request: {\n        companyId,\n        payrollId,\n        sortBy,\n        requestBody: {\n          employeeUuids,\n        },\n      },\n    })\n    setPreparedPayroll(result.payrollPrepared)\n    if (result.payrollPrepared) {\n      hasInitialDataRef.current = true\n      onDataReady?.(result.payrollPrepared)\n    }\n  }, [companyId, payrollId, preparePayroll, employeeUuidsKey, sortBy, onDataReady])\n\n  const handlePreparePayroll = useCallback(async () => {\n    await baseSubmitHandler(null, () =>\n      retryAsync(executePrepare, {\n        maxAttempts: PREPARE_MAX_ATTEMPTS,\n        delayMs: PREPARE_RETRY_DELAY_MS,\n        shouldRetry: isPayrollBeingProcessedError,\n      }),\n    )\n  }, [baseSubmitHandler, executePrepare])\n\n  useEffect(() => {\n    if (hasFiredRef.current) return\n    hasFiredRef.current = true\n    void handlePreparePayroll()\n  }, [handlePreparePayroll])\n\n  const isInitialLoading = isPreparePayrollPending && !hasInitialDataRef.current\n  const isPaginating = isPreparePayrollPending && hasInitialDataRef.current\n  const isLoading = isInitialLoading || isPayScheduleLoading\n\n  return {\n    handlePreparePayroll,\n    preparedPayroll,\n    paySchedule: payScheduleData?.payScheduleShow,\n    isLoading,\n    isPaginating,\n    hasInitialData: hasInitialDataRef.current,\n  }\n}\n"],"names":["PREPARE_MAX_ATTEMPTS","PREPARE_RETRY_DELAY_MS","isPayrollBeingProcessedError","error","UnprocessableEntityError","e","usePreparedPayrollData","companyId","payrollId","employeeUuids","sortBy","onDataReady","preparePayroll","isPreparePayrollPending","usePayrollsPrepareMutation","preparedPayroll","setPreparedPayroll","useState","hasInitialDataRef","useRef","hasFiredRef","baseSubmitHandler","useBase","employeeUuidsKey","useMemo","payScheduleData","isPayScheduleLoading","usePaySchedulesGet","executePrepare","useCallback","result","handlePreparePayroll","retryAsync","useEffect","isInitialLoading","isPaginating","isLoading"],"mappings":";;;;;;;;;;;;;;;;;;AA2BA,MAAMA,IAAuB,GACvBC,IAAyB,MAEzBC,IAA+B,CAACC,MAC9BA,aAAiBC,IAChBD,EAAM,OAAO,KAAK,CAAAE,MAAKA,EAAE,aAAa,mBAAmB,IADP,IAgB9CC,IAAyB,CAAC;AAAA,EACrC,WAAAC;AAAA,EACA,WAAAC;AAAA,EACA,eAAAC;AAAA,EACA,QAAAC;AAAA,EACA,aAAAC;AACF,MAAkE;AAChE,QAAM,EAAE,aAAaC,GAAgB,WAAWC,EAAA,IAC9CC,EAAA,GACI,CAACC,GAAiBC,CAAkB,IAAIC,EAAA,GACxCC,IAAoBC,EAAO,EAAK,GAChCC,IAAcD,EAAO,EAAK,GAC1B,EAAE,mBAAAE,EAAA,IAAsBC,EAAA,GAExBC,IAAmBC,EAAQ,MAAMf,GAAe,KAAK,GAAG,KAAK,IAAI,CAACA,CAAa,CAAC,GAEhF,EAAE,MAAMgB,GAAiB,WAAWC,MAAyBC;AAAA,IACjE;AAAA,MACE,WAAApB;AAAA,MACA,eAAeQ,GAAiB,WAAW,mBAAmB;AAAA,IAAA;AAAA,IAEhE;AAAA,MACE,SAAS,CAAC,CAACA,GAAiB,WAAW;AAAA,IAAA;AAAA,EACzC,GAGIa,IAAiBC,EAAY,YAAY;AAC7C,UAAMC,IAAS,MAAMlB,EAAe;AAAA,MAClC,SAAS;AAAA,QACP,WAAAL;AAAA,QACA,WAAAC;AAAA,QACA,QAAAE;AAAA,QACA,aAAa;AAAA,UACX,eAAAD;AAAA,QAAA;AAAA,MACF;AAAA,IACF,CACD;AACD,IAAAO,EAAmBc,EAAO,eAAe,GACrCA,EAAO,oBACTZ,EAAkB,UAAU,IAC5BP,IAAcmB,EAAO,eAAe;AAAA,EAExC,GAAG,CAACvB,GAAWC,GAAWI,GAAgBW,GAAkBb,GAAQC,CAAW,CAAC,GAE1EoB,IAAuBF,EAAY,YAAY;AACnD,UAAMR;AAAA,MAAkB;AAAA,MAAM,MAC5BW,EAAWJ,GAAgB;AAAA,QACzB,aAAa5B;AAAA,QACb,SAASC;AAAA,QACT,aAAaC;AAAA,MAAA,CACd;AAAA,IAAA;AAAA,EAEL,GAAG,CAACmB,GAAmBO,CAAc,CAAC;AAEtC,EAAAK,EAAU,MAAM;AACd,IAAIb,EAAY,YAChBA,EAAY,UAAU,IACjBW,EAAA;AAAA,EACP,GAAG,CAACA,CAAoB,CAAC;AAEzB,QAAMG,IAAmBrB,KAA2B,CAACK,EAAkB,SACjEiB,IAAetB,KAA2BK,EAAkB,SAC5DkB,IAAYF,KAAoBR;AAEtC,SAAO;AAAA,IACL,sBAAAK;AAAA,IACA,iBAAAhB;AAAA,IACA,aAAaU,GAAiB;AAAA,IAC9B,WAAAW;AAAA,IACA,cAAAD;AAAA,IACA,gBAAgBjB,EAAkB;AAAA,EAAA;AAEtC;"}

package/dist/helpers/validations.d.ts

@@ -32,12 +32,24 @@ export declare const SSN_REGEX: RegExp;
  * @internal
  */
 export declare const phoneValidation: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+/**
+ * Regex matching a bank routing number (exactly nine digits).
+ *
+ * @internal
+ */
+export declare const ROUTING_NUMBER_REGEX: RegExp;
 /**
  * Zod schema validating a bank routing number (exactly nine digits).
  *
  * @internal
  */
 export declare const routingNumberValidation: z.ZodString;
+/**
+ * Regex matching a bank account number (one to seventeen digits).
+ *
+ * @internal
+ */
+export declare const ACCOUNT_NUMBER_REGEX: RegExp;
 /**
  * Zod schema validating a bank account number (one to seventeen digits).
  *

package/dist/helpers/validations.js

@@ -1,14 +1,16 @@
 import { z as n } from "zod";
-import { formatWithMask as i, commonMasks as o } from "./mask.js";
+import { formatWithMask as o, commonMasks as i } from "./mask.js";
 import { removeNonDigits as r } from "./formattedStrings.js";
-const s = /^([a-zA-Z\xC0-\uFFFF]+([ \-']{0,1}[a-zA-Z\xC0-\uFFFF]+)*[.]{0,1}){1,2}$/, g = n.string().min(1).regex(s), c = n.string().refine((t) => /(^\d{5}$)|(^\d{5}-\d{4}$)/.test(t)), F = /^(?!(000|666|9))\d{3}(?!00)\d{2}(?!0000)\d{4}$/, f = n.string().transform((t) => i(t, o.phoneMask)).refine((t) => r(t).length === 10), p = n.string().regex(/^[0-9]{9}$/), u = n.string().regex(/^[0-9]{1,17}$/);
+const s = /^([a-zA-Z\xC0-\uFFFF]+([ \-']{0,1}[a-zA-Z\xC0-\uFFFF]+)*[.]{0,1}){1,2}$/, E = n.string().min(1).regex(s), N = n.string().refine((t) => /(^\d{5}$)|(^\d{5}-\d{4}$)/.test(t)), F = /^(?!(000|666|9))\d{3}(?!00)\d{2}(?!0000)\d{4}$/, f = n.string().transform((t) => o(t, i.phoneMask)).refine((t) => r(t).length === 10), e = /^[0-9]{9}$/, p = n.string().regex(e), a = /^[0-9]{1,17}$/, u = n.string().regex(a);
 export {
+  a as ACCOUNT_NUMBER_REGEX,
   s as NAME_REGEX,
+  e as ROUTING_NUMBER_REGEX,
   F as SSN_REGEX,
   u as accountNumberValidation,
-  g as nameValidation,
+  E as nameValidation,
   f as phoneValidation,
   p as routingNumberValidation,
-  c as zipValidation
+  N as zipValidation
 };
 //# sourceMappingURL=validations.js.map

package/dist/helpers/validations.js.map

@@ -1 +1 @@
-{"version":3,"file":"validations.js","sources":["../../src/helpers/validations.ts"],"sourcesContent":["import { z } from 'zod'\nimport { commonMasks, formatWithMask } from './mask'\nimport { removeNonDigits } from '@/helpers/formattedStrings'\n\n/**\n * Regex matching personal names: one or two words composed of Latin or extended-Latin letters,\n * with optional internal spaces, hyphens, or apostrophes, and an optional trailing period.\n *\n * @internal\n */\nexport const NAME_REGEX = /^([a-zA-Z\\xC0-\\uFFFF]+([ \\-']{0,1}[a-zA-Z\\xC0-\\uFFFF]+)*[.]{0,1}){1,2}$/\n\n/**\n * Zod schema validating a non-empty personal name against {@link NAME_REGEX}.\n *\n * @internal\n */\nexport const nameValidation = z.string().min(1).regex(NAME_REGEX)\n\n/**\n * Zod schema validating a US ZIP code in either 5-digit (`12345`) or ZIP+4 (`12345-6789`) form.\n *\n * @internal\n */\nexport const zipValidation = z.string().refine(zip => /(^\\d{5}$)|(^\\d{5}-\\d{4}$)/.test(zip))\n\n/**\n * Regex matching a valid US Social Security Number. Rejects reserved area numbers (000, 666, 9xx),\n * a group number of 00, and a serial number of 0000.\n *\n * @internal\n */\nexport const SSN_REGEX = /^(?!(000|666|9))\\d{3}(?!00)\\d{2}(?!0000)\\d{4}$/\n\n/**\n * Zod schema validating a US phone number. Formats the input with the phone mask and accepts it\n * only when the digit-only form is exactly ten digits.\n *\n * @internal\n */\nexport const phoneValidation = z\n  .string()\n  .transform(value => formatWithMask(value, commonMasks.phoneMask))\n  .refine(phone => {\n    const digits = removeNonDigits(phone)\n    return digits.length === 10\n  })\n\n/**\n * Zod schema validating a bank routing number (exactly nine digits).\n *\n * @internal\n */\nexport const routingNumberValidation = z.string().regex(/^[0-9]{9}$/)\n/**\n * Zod schema validating a bank account number (one to seventeen digits).\n *\n * @internal\n */\nexport const accountNumberValidation = z.string().regex(/^[0-9]{1,17}$/)\n"],"names":["NAME_REGEX","nameValidation","z","zipValidation","zip","SSN_REGEX","phoneValidation","value","formatWithMask","commonMasks","phone","removeNonDigits","routingNumberValidation","accountNumberValidation"],"mappings":";;;AAUO,MAAMA,IAAa,2EAObC,IAAiBC,EAAE,OAAA,EAAS,IAAI,CAAC,EAAE,MAAMF,CAAU,GAOnDG,IAAgBD,EAAE,SAAS,OAAO,CAAAE,MAAO,4BAA4B,KAAKA,CAAG,CAAC,GAQ9EC,IAAY,kDAQZC,IAAkBJ,EAC5B,OAAA,EACA,UAAU,CAAAK,MAASC,EAAeD,GAAOE,EAAY,SAAS,CAAC,EAC/D,OAAO,CAAAC,MACSC,EAAgBD,CAAK,EACtB,WAAW,EAC1B,GAOUE,IAA0BV,EAAE,OAAA,EAAS,MAAM,YAAY,GAMvDW,IAA0BX,EAAE,OAAA,EAAS,MAAM,eAAe;"}
+{"version":3,"file":"validations.js","sources":["../../src/helpers/validations.ts"],"sourcesContent":["import { z } from 'zod'\nimport { commonMasks, formatWithMask } from './mask'\nimport { removeNonDigits } from '@/helpers/formattedStrings'\n\n/**\n * Regex matching personal names: one or two words composed of Latin or extended-Latin letters,\n * with optional internal spaces, hyphens, or apostrophes, and an optional trailing period.\n *\n * @internal\n */\nexport const NAME_REGEX = /^([a-zA-Z\\xC0-\\uFFFF]+([ \\-']{0,1}[a-zA-Z\\xC0-\\uFFFF]+)*[.]{0,1}){1,2}$/\n\n/**\n * Zod schema validating a non-empty personal name against {@link NAME_REGEX}.\n *\n * @internal\n */\nexport const nameValidation = z.string().min(1).regex(NAME_REGEX)\n\n/**\n * Zod schema validating a US ZIP code in either 5-digit (`12345`) or ZIP+4 (`12345-6789`) form.\n *\n * @internal\n */\nexport const zipValidation = z.string().refine(zip => /(^\\d{5}$)|(^\\d{5}-\\d{4}$)/.test(zip))\n\n/**\n * Regex matching a valid US Social Security Number. Rejects reserved area numbers (000, 666, 9xx),\n * a group number of 00, and a serial number of 0000.\n *\n * @internal\n */\nexport const SSN_REGEX = /^(?!(000|666|9))\\d{3}(?!00)\\d{2}(?!0000)\\d{4}$/\n\n/**\n * Zod schema validating a US phone number. Formats the input with the phone mask and accepts it\n * only when the digit-only form is exactly ten digits.\n *\n * @internal\n */\nexport const phoneValidation = z\n  .string()\n  .transform(value => formatWithMask(value, commonMasks.phoneMask))\n  .refine(phone => {\n    const digits = removeNonDigits(phone)\n    return digits.length === 10\n  })\n\n/**\n * Regex matching a bank routing number (exactly nine digits).\n *\n * @internal\n */\nexport const ROUTING_NUMBER_REGEX = /^[0-9]{9}$/\n\n/**\n * Zod schema validating a bank routing number (exactly nine digits).\n *\n * @internal\n */\nexport const routingNumberValidation = z.string().regex(ROUTING_NUMBER_REGEX)\n\n/**\n * Regex matching a bank account number (one to seventeen digits).\n *\n * @internal\n */\nexport const ACCOUNT_NUMBER_REGEX = /^[0-9]{1,17}$/\n\n/**\n * Zod schema validating a bank account number (one to seventeen digits).\n *\n * @internal\n */\nexport const accountNumberValidation = z.string().regex(ACCOUNT_NUMBER_REGEX)\n"],"names":["NAME_REGEX","nameValidation","z","zipValidation","zip","SSN_REGEX","phoneValidation","value","formatWithMask","commonMasks","phone","removeNonDigits","ROUTING_NUMBER_REGEX","routingNumberValidation","ACCOUNT_NUMBER_REGEX","accountNumberValidation"],"mappings":";;;AAUO,MAAMA,IAAa,2EAObC,IAAiBC,EAAE,OAAA,EAAS,IAAI,CAAC,EAAE,MAAMF,CAAU,GAOnDG,IAAgBD,EAAE,SAAS,OAAO,CAAAE,MAAO,4BAA4B,KAAKA,CAAG,CAAC,GAQ9EC,IAAY,kDAQZC,IAAkBJ,EAC5B,OAAA,EACA,UAAU,CAAAK,MAASC,EAAeD,GAAOE,EAAY,SAAS,CAAC,EAC/D,OAAO,CAAAC,MACSC,EAAgBD,CAAK,EACtB,WAAW,EAC1B,GAOUE,IAAuB,cAOvBC,IAA0BX,EAAE,OAAA,EAAS,MAAMU,CAAoB,GAO/DE,IAAuB,iBAOvBC,IAA0Bb,EAAE,OAAA,EAAS,MAAMY,CAAoB;"}

package/dist/index.d.ts

@@ -14,7 +14,7 @@ export { componentEvents, EmployeeOnboardingStatus, EmployeeSelfOnboardingStatus
 export type { EventType } from './shared/constants';
 export type { BeforeCreateRequestHook, BeforeRequestHook, AfterSuccessHook, AfterErrorHook, BeforeCreateRequestContext, BeforeRequestContext, AfterSuccessContext, AfterErrorContext, SDKHooks, } from './types/hooks';
 export type { SDKError, SDKErrorCategory, SDKFieldError } from './types/sdkError';
-export { normalizeToSDKError, SDKInternalError } from './types/sdkError';
+export { SDKErrorCategories, normalizeToSDKError, SDKInternalError } from './types/sdkError';
 export type { ObservabilityHook, ObservabilityError, ObservabilityMetric, ObservabilityMetricUnit, SanitizationConfig, } from './types/observability';
 export type { BaseComponentInterface, CommonComponentInterface, OnEventType, } from './components/Base';
 export type { ResourceDictionary, Resources, DeepPartial, SupportedLanguages, } from './types/Helpers';
@@ -32,6 +32,10 @@ export { useEmployeeDetailsForm, EmployeeDetailsErrorCodes, createEmployeeDetail
 export type { EmployeeDetailsSubmitCallbacks, EmployeeDetailsOptionalFieldsToRequire, UseEmployeeDetailsFormSharedProps, UseEmployeeDetailsFormProps, UseEmployeeDetailsFormResult, UseEmployeeDetailsFormReady, EmployeeDetailsFieldsMetadata, EmployeeDetailsFormFields, EmployeeDetailsErrorCode, EmployeeDetailsFormData, EmployeeDetailsFormOutputs, EmployeeDetailsField, EmployeeDetailsRequiredValidation, NameValidation, EmailValidation, SsnValidation, FirstNameFieldProps, MiddleInitialFieldProps, LastNameFieldProps, EmailFieldProps, DateOfBirthFieldProps, SsnFieldProps, SelfOnboardingFieldProps, SsnRequiredValidation, EmployeeDetailsFields, } from './components/Employee/Profile/shared/useEmployeeDetailsForm';
 export { useContractorDetailsForm, ContractorType, WageType, ContractorDetailsErrorCodes, TypeField as ContractorTypeField, WageTypeField as ContractorWageTypeField, StartDateField as ContractorStartDateField, HourlyRateField as ContractorHourlyRateField, SelfOnboardingField as ContractorSelfOnboardingField, FileNewHireReportField as ContractorFileNewHireReportField, EmailField as ContractorEmailField, FirstNameField as ContractorFirstNameField, LastNameField as ContractorLastNameField, MiddleInitialField as ContractorMiddleInitialField, BusinessNameField as ContractorBusinessNameField, SsnField as ContractorSsnField, EinField as ContractorEinField, WorkStateField as ContractorWorkStateField, } from './components/Contractor/Profile/shared/useContractorDetailsForm';
 export type { ContractorDetailsSubmitOptions, ContractorDetailsOptionalFieldsToRequire, UseContractorDetailsFormSharedProps, UseContractorDetailsFormProps, UseContractorDetailsFormResult, UseContractorDetailsFormReady, ContractorDetailsFieldsMetadata, ContractorDetailsFormFields, ContractorDetailsFields, ContractorDetailsErrorCode, ContractorDetailsFormData, ContractorDetailsFormOutputs, ContractorDetailsRequiredValidation, ContractorDetailsNameValidation, ContractorDetailsEmailValidation, ContractorDetailsSsnValidation, ContractorDetailsSsnRequiredValidation, ContractorDetailsEinValidation, ContractorDetailsEinRequiredValidation, TypeFieldProps as ContractorTypeFieldProps, WageTypeFieldProps as ContractorWageTypeFieldProps, StartDateFieldProps as ContractorStartDateFieldProps, HourlyRateFieldProps as ContractorHourlyRateFieldProps, SelfOnboardingFieldProps as ContractorSelfOnboardingFieldProps, FileNewHireReportFieldProps as ContractorFileNewHireReportFieldProps, EmailFieldProps as ContractorEmailFieldProps, FirstNameFieldProps as ContractorFirstNameFieldProps, LastNameFieldProps as ContractorLastNameFieldProps, MiddleInitialFieldProps as ContractorMiddleInitialFieldProps, BusinessNameFieldProps as ContractorBusinessNameFieldProps, SsnFieldProps as ContractorSsnFieldProps, EinFieldProps as ContractorEinFieldProps, WorkStateFieldProps as ContractorWorkStateFieldProps, } from './components/Contractor/Profile/shared/useContractorDetailsForm';
+export { useContractorBankAccountForm, ContractorBankAccountErrorCodes, ACCOUNT_TYPES as ContractorBankAccountTypes, } from './components/Contractor/PaymentMethod/shared/useContractorBankAccountForm';
+export type { UseContractorBankAccountFormProps, UseContractorBankAccountFormResult, UseContractorBankAccountFormReady, ContractorBankAccountFormFields, ContractorBankAccountFieldsMetadata, ContractorBankAccountErrorCode, ContractorAccountType, ContractorBankAccountFormData, ContractorBankAccountFormOutputs, ContractorBankAccountFormField, ContractorBankAccountOptionalFieldsToRequire, ContractorBankAccountRequiredValidation, ContractorBankAccountRoutingNumberValidation, ContractorBankAccountAccountNumberValidation, NameFieldProps as ContractorBankAccountNameFieldProps, RoutingNumberFieldProps as ContractorBankAccountRoutingNumberFieldProps, AccountNumberFieldProps as ContractorBankAccountAccountNumberFieldProps, AccountTypeFieldProps as ContractorBankAccountAccountTypeFieldProps, } from './components/Contractor/PaymentMethod/shared/useContractorBankAccountForm';
+export { useContractorPaymentMethodForm, ContractorPaymentMethodErrorCodes, } from './components/Contractor/PaymentMethod/shared/useContractorPaymentMethodForm';
+export type { UseContractorPaymentMethodFormProps, UseContractorPaymentMethodFormResult, UseContractorPaymentMethodFormReady, ContractorPaymentMethodFormFields, ContractorPaymentMethodFieldsMetadata, ContractorPaymentMethodErrorCode, ContractorPaymentMethodFormType, ContractorPaymentMethodFormData, ContractorPaymentMethodFormOutputs, ContractorPaymentMethodFormField, TypeFieldProps as ContractorPaymentMethodTypeFieldProps, } from './components/Contractor/PaymentMethod/shared/useContractorPaymentMethodForm';
 export { useWorkAddressForm, useCurrentWorkAddressForm, WorkAddressErrorCodes, createWorkAddressSchema, LocationField as WorkAddressLocationField, EffectiveDateField as WorkAddressEffectiveDateField, } from './components/Employee/Profile/shared/useWorkAddressForm';
 export type { WorkAddressSubmitCallbacks, WorkAddressSubmitOptions, WorkAddressOptionalFieldsToRequire, UseCurrentWorkAddressFormProps, UseWorkAddressFormProps, UseWorkAddressFormResult, UseWorkAddressFormReady, WorkAddressFieldsMetadata, WorkAddressFormFields, WorkAddressErrorCode, WorkAddressFormData, WorkAddressFormOutputs, WorkAddressField, WorkAddressRequiredValidation, LocationFieldProps, EffectiveDateFieldProps, WorkAddressFields, } from './components/Employee/Profile/shared/useWorkAddressForm';
 export { useHomeAddressForm, useCurrentHomeAddressForm, HomeAddressErrorCodes, createHomeAddressSchema, Street1Field, Street2Field, CityField, StateField as HomeAddressStateField, ZipField, CourtesyWithholdingField, EffectiveDateField as HomeAddressEffectiveDateField, } from './components/Employee/Profile/shared/useHomeAddressForm';
@@ -46,7 +50,7 @@ export { useSplitPaymentsForm, SplitPaymentsFormErrorCodes, createSplitPaymentsF
 export type { UseSplitPaymentsFormProps, UseSplitPaymentsFormResult, UseSplitPaymentsFormReady, SplitPaymentsFormFields, SplitPaymentsFormFieldsMetadata, SplitPaymentsFormErrorCode, SplitPaymentsFormData, SplitPaymentsFormOutputs, SplitPaymentsFormField, SplitPaymentsFormOptionalFieldsToRequire, SplitByValue, SplitPaymentsFormRequiredValidation, SplitByFieldProps, SplitFieldEntry, SplitFieldProps, SplitFieldValidation, WorkingSplit, } from './components/Employee/PaymentMethod/shared/useSplitPaymentsForm';
 export { useFederalTaxesForm, FederalTaxesErrorCodes, createFederalTaxesSchema, FILING_STATUS_VALUES, FilingStatusField, TwoJobsField, DependentsAmountField, OtherIncomeField, DeductionsField, ExtraWithholdingField, } from './components/Employee/FederalTaxes/shared/useFederalTaxesForm';
 export { useEmployeeStateTaxesForm, createEmployeeStateTaxesSchema, EmployeeStateTaxesErrorCodes, createStateFields, useStateFields, getQuestionVariant, } from './components/Employee/StateTaxes/shared';
-export type { UseEmployeeStateTaxesFormProps, UseEmployeeStateTaxesFormResult, UseEmployeeStateTaxesFormReady, EmployeeStateTaxesFieldsMetadata, EmployeeStateTaxesFormFields, EmployeeStateTaxesErrorCode, EmployeeStateTaxesFormData, EmployeeStateTaxesFormOutputs, EmployeeStateTaxesSchemaOptions, EmployeeStateTaxesQuestionMeta, EmployeeStateTaxesMetadataConfig, StateTaxValue, StateTaxQuestionVariant, StateTaxFieldsGroup, StateTaxQuestionFieldEntry, CreateStateFieldsOptions, SelectStateTaxFieldProps, RadioStateTaxFieldProps, TextStateTaxFieldProps, NumberStateTaxFieldProps, CurrencyStateTaxFieldProps, DateStateTaxFieldProps, } from './components/Employee/StateTaxes/shared';
+export type { UseEmployeeStateTaxesFormProps, UseEmployeeStateTaxesFormResult, UseEmployeeStateTaxesFormReady, EmployeeStateTaxesFieldsMetadata, EmployeeStateTaxesFormFields, EmployeeStateTaxesErrorCode, EmployeeStateTaxesFormData, EmployeeStateTaxesFormOutputs, EmployeeStateTaxesSchemaOptions, EmployeeStateTaxesQuestionMeta, EmployeeStateTaxesMetadataConfig, StateTaxValue, StateTaxQuestionVariant, StateTaxFieldsGroup, StateTaxFields, StateTaxQuestionFieldEntry, SharedQuestionMetadata, SelectStateTaxQuestion, RadioStateTaxQuestion, TextStateTaxQuestion, NumberStateTaxQuestion, CurrencyStateTaxQuestion, DateStateTaxQuestion, CreateStateFieldsOptions, BaseStateTaxFieldProps, StateTaxValidationMessages, SelectStateTaxFieldProps, RadioStateTaxFieldProps, TextStateTaxFieldProps, NumberStateTaxFieldProps, CurrencyStateTaxFieldProps, DateStateTaxFieldProps, } from './components/Employee/StateTaxes/shared';
 export type { FederalTaxesOptionalFieldsToRequire, UseFederalTaxesFormProps, UseFederalTaxesFormResult, UseFederalTaxesFormReady, FederalTaxesFieldsMetadata, FederalTaxesFormFields, FederalTaxesFields, FederalTaxesErrorCode, FederalTaxesFormData, FederalTaxesFormOutputs, FederalTaxesField, FilingStatusValue, FederalTaxesRequiredValidation, FilingStatusFieldProps, TwoJobsFieldProps, DependentsAmountFieldProps, OtherIncomeFieldProps, DeductionsFieldProps, ExtraWithholdingFieldProps, } from './components/Employee/FederalTaxes/shared/useFederalTaxesForm';
 export { useSignEmployeeForm, SignEmployeeFormErrorCodes, createSignEmployeeFormSchema, MAX_PREPARERS, PREPARER_FIELDS_BY_INDEX, preparerFieldName, SignatureField, ConfirmSignatureField, UsedPreparerField, } from './components/Employee/Documents/shared/useSignEmployeeForm';
 export type { UseSignEmployeeFormProps, UseSignEmployeeFormResult, UseSignEmployeeFormReady, SignEmployeeFormFieldComponents, SignEmployeeFormFieldsMetadata, SignEmployeeFormFields, PreparerFieldGroup, SignEmployeeFormErrorCode, SignEmployeeFormData, SignEmployeeFormOutputs, SignEmployeeFormField, PreparerIndex, PreparerFieldSuffix, SignEmployeeFormRequiredValidation, SignatureFieldProps as SignEmployeeFormSignatureFieldProps, ConfirmSignatureFieldProps as SignEmployeeFormConfirmSignatureFieldProps, UsedPreparerFieldProps, PreparerTextFieldProps, PreparerSelectFieldProps, PreparerCheckboxFieldProps, } from './components/Employee/Documents/shared/useSignEmployeeForm';