@gusto/embedded-react-sdk 0.51.0 → 0.52.0

package/dist/contexts/GustoProvider/GustoProvider.js

@@ -2,20 +2,20 @@ import { jsx as r } from "react/jsx-runtime";
 import { I18nProvider as p } from "react-aria-components";
 import { createComponents as s } from "../ComponentAdapter/createComponentsWithDefaults.js";
 import { GustoProviderCustomUIAdapter as c } from "./GustoProviderCustomUIAdapter.js";
-const f = (e) => {
-  const { children: t, components: n = {}, locale: o, queryClient: m, ...i } = e;
+function a(e) {
+  const { children: t, components: n = {}, locale: o, queryClient: i, ...m } = e;
   return /* @__PURE__ */ r(
     c,
     {
       locale: o,
-      queryClient: m,
-      ...i,
+      queryClient: i,
+      ...m,
       components: s(n),
       children: /* @__PURE__ */ r(p, { locale: o, children: t })
     }
   );
-};
+}
 export {
-  f as GustoProvider
+  a as GustoProvider
 };
 //# sourceMappingURL=GustoProvider.js.map

package/dist/contexts/GustoProvider/GustoProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"GustoProvider.js","sources":["../../../src/contexts/GustoProvider/GustoProvider.tsx"],"sourcesContent":["import type React from 'react'\n// GustoProvider uses react-aria as the default components so we need to include the react-aria I18nProvider here.\n// For use without react-aria, the GustoProviderCustomUIAdapter can be used which does not includes it.\n// eslint-disable-next-line no-restricted-imports\nimport { I18nProvider } from 'react-aria-components'\nimport type { QueryClient } from '@tanstack/react-query'\nimport { createComponents } from '../ComponentAdapter/createComponentsWithDefaults'\nimport type { ComponentsContextType } from '../ComponentAdapter/useComponentContext'\nimport {\n  GustoProviderCustomUIAdapter,\n  type GustoProviderProps,\n} from './GustoProviderCustomUIAdapter'\n\n/**\n * Props for {@link GustoProvider}.\n *\n * @remarks\n * Extends {@link GustoProviderProps} but makes `components` optional and partial: any components\n * you do not supply fall back to the SDK's built-in React Aria implementations.\n *\n * @public\n */\nexport interface GustoApiProps extends Omit<GustoProviderProps, 'components'> {\n  /** Optional TanStack Query `QueryClient` to share with the rest of your app. When omitted, the SDK creates its own client configured for Gusto's API. */\n  queryClient?: QueryClient\n  /** Partial component overrides. Any component you do not supply uses the SDK's default React Aria implementation. */\n  components?: Partial<ComponentsContextType>\n  /** The application tree that should have access to the SDK. */\n  children?: React.ReactNode\n}\n\n/**\n * Top-level provider that configures the SDK at the application level.\n *\n * @remarks\n * Wrap your application's component tree with `GustoProvider` so that any SDK component below it\n * has access to the API client, theme, locale, translations, and UI components. Components you\n * provide via the `components` prop override the SDK's React Aria defaults; any component you do\n * not supply uses the default.\n *\n * For full UI control without the bundled React Aria defaults, use {@link GustoProviderCustomUIAdapter}\n * instead and supply a complete component map.\n *\n * @param props - See {@link GustoApiProps}.\n * @returns The configured provider tree wrapping `children`.\n * @public\n */\nconst GustoProvider: React.FC<GustoApiProps> = props => {\n  const { children, components = {}, locale, queryClient, ...remainingProps } = props\n\n  return (\n    <GustoProviderCustomUIAdapter\n      locale={locale}\n      queryClient={queryClient}\n      {...remainingProps}\n      components={createComponents(components)}\n    >\n      {/* react-aria locale provider that exposes correct locale to number formatters */}\n      <I18nProvider locale={locale}>{children}</I18nProvider>\n    </GustoProviderCustomUIAdapter>\n  )\n}\n\nexport { GustoProvider }\n"],"names":["GustoProvider","props","children","components","locale","queryClient","remainingProps","jsx","GustoProviderCustomUIAdapter","createComponents","I18nProvider"],"mappings":";;;;AA+CA,MAAMA,IAAyC,CAAAC,MAAS;AACtD,QAAM,EAAE,UAAAC,GAAU,YAAAC,IAAa,CAAA,GAAI,QAAAC,GAAQ,aAAAC,GAAa,GAAGC,EAAA,IAAmBL;AAE9E,SACE,gBAAAM;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,QAAAJ;AAAA,MACA,aAAAC;AAAA,MACC,GAAGC;AAAA,MACJ,YAAYG,EAAiBN,CAAU;AAAA,MAGvC,UAAA,gBAAAI,EAACG,GAAA,EAAa,QAAAN,GAAiB,UAAAF,EAAA,CAAS;AAAA,IAAA;AAAA,EAAA;AAG9C;"}
+{"version":3,"file":"GustoProvider.js","sources":["../../../src/contexts/GustoProvider/GustoProvider.tsx"],"sourcesContent":["import type React from 'react'\n// GustoProvider uses react-aria as the default components so we need to include the react-aria I18nProvider here.\n// For use without react-aria, the GustoProviderCustomUIAdapter can be used which does not includes it.\n// eslint-disable-next-line no-restricted-imports\nimport { I18nProvider } from 'react-aria-components'\nimport type { QueryClient } from '@tanstack/react-query'\nimport { createComponents } from '../ComponentAdapter/createComponentsWithDefaults'\nimport type { ComponentsContextType } from '../ComponentAdapter/useComponentContext'\nimport type { GustoBaseProviderProps } from './GustoProviderCustomUIAdapter'\nimport { GustoProviderCustomUIAdapter } from './GustoProviderCustomUIAdapter'\n\n/**\n * Props for {@link GustoProvider}.\n *\n * @remarks\n * Extends {@link GustoProviderProps} but makes `components` optional and partial: any components\n * you do not supply fall back to the SDK's built-in React Aria implementations.\n *\n * @public\n */\nexport interface GustoProviderProps extends Omit<GustoBaseProviderProps, 'components'> {\n  /** Optional TanStack Query `QueryClient` to share with the rest of your app. When omitted, the SDK creates its own client configured for Gusto's API. */\n  queryClient?: QueryClient\n  /** Partial component overrides. Any component you do not supply uses the SDK's default React Aria implementation. */\n  components?: Partial<ComponentsContextType>\n  /** The application tree that should have access to the SDK. */\n  children?: React.ReactNode\n}\n\n/**\n * Top-level provider that configures the SDK at the application level.\n *\n * @remarks\n * Wrap your application's component tree with `GustoProvider` so that any SDK component below it\n * has access to the API client, theme, locale, translations, and UI components. Components you\n * provide via the `components` prop override the SDK's React Aria defaults; any component you do\n * not supply uses the default.\n *\n * For full UI control without the bundled React Aria defaults, use {@link GustoProviderCustomUIAdapter}\n * instead and supply a complete component map.\n *\n * @param props - See {@link GustoProviderProps}.\n * @returns The configured provider tree wrapping `children`.\n * @public\n */\nexport function GustoProvider(props: GustoProviderProps) {\n  const { children, components = {}, locale, queryClient, ...remainingProps } = props\n\n  return (\n    <GustoProviderCustomUIAdapter\n      locale={locale}\n      queryClient={queryClient}\n      {...remainingProps}\n      components={createComponents(components)}\n    >\n      {/* react-aria locale provider that exposes correct locale to number formatters */}\n      <I18nProvider locale={locale}>{children}</I18nProvider>\n    </GustoProviderCustomUIAdapter>\n  )\n}\n"],"names":["GustoProvider","props","children","components","locale","queryClient","remainingProps","jsx","GustoProviderCustomUIAdapter","createComponents","I18nProvider"],"mappings":";;;;AA6CO,SAASA,EAAcC,GAA2B;AACvD,QAAM,EAAE,UAAAC,GAAU,YAAAC,IAAa,CAAA,GAAI,QAAAC,GAAQ,aAAAC,GAAa,GAAGC,EAAA,IAAmBL;AAE9E,SACE,gBAAAM;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,QAAAJ;AAAA,MACA,aAAAC;AAAA,MACC,GAAGC;AAAA,MACJ,YAAYG,EAAiBN,CAAU;AAAA,MAGvC,UAAA,gBAAAI,EAACG,GAAA,EAAa,QAAAN,GAAiB,UAAAF,EAAA,CAAS;AAAA,IAAA;AAAA,EAAA;AAG9C;"}

package/dist/contexts/GustoProvider/GustoProviderCustomUIAdapter.d.ts

@@ -1,7 +1,6 @@
-import { default as React } from 'react';
+import { default as React, JSX, ReactNode } from 'react';
 import { QueryClient } from '@tanstack/react-query';
 import { ComponentsContextType } from '../ComponentAdapter/useComponentContext';
-import { LoadingIndicatorContextProps } from '../LoadingIndicatorProvider/useLoadingIndicator';
 import { GustoSDKTheme } from '../ThemeProvider/theme';
 import { GlobalResourceDictionary } from '../../types/Helpers';
 import { SDKHooks } from '../../types/hooks';
@@ -26,7 +25,7 @@ export interface APIConfig {
  *
  * @public
  */
-export interface GustoProviderProps {
+export interface GustoBaseProviderProps {
     /** API client configuration, including the proxy `baseUrl`, request hooks, and observability. See {@link APIConfig}. */
     config: APIConfig;
     /** Translation overrides keyed by language and i18next namespace. Strings supplied here replace the SDK defaults for the matching keys. */
@@ -46,14 +45,16 @@ export interface GustoProviderProps {
     /** Complete map of UI components the SDK renders. Required because this adapter ships no defaults. */
     components: ComponentsContextType;
     /** Loading indicator rendered while SDK queries are pending. Overrides the SDK default spinner. */
-    LoaderComponent?: LoadingIndicatorContextProps['LoadingIndicator'];
+    LoaderComponent?: ({ children }: {
+        children?: ReactNode;
+    }) => JSX.Element;
 }
 /**
  * Props for {@link GustoProviderCustomUIAdapter}.
  *
  * @public
  */
-export interface GustoProviderCustomUIAdapterProps extends GustoProviderProps {
+export interface GustoProviderCustomUIAdapterProps extends GustoBaseProviderProps {
     /** The application tree that should have access to the SDK. */
     children?: React.ReactNode;
 }
@@ -70,5 +71,4 @@ export interface GustoProviderCustomUIAdapterProps extends GustoProviderProps {
  * @returns The configured provider tree wrapping `children`.
  * @public
  */
-declare const GustoProviderCustomUIAdapter: React.FC<GustoProviderCustomUIAdapterProps>;
-export { GustoProviderCustomUIAdapter };
+export declare function GustoProviderCustomUIAdapter(props: GustoProviderCustomUIAdapterProps): JSX.Element;

package/dist/contexts/GustoProvider/GustoProviderCustomUIAdapter.js

@@ -14,7 +14,7 @@ import "../LocaleProvider/useLocale.js";
 import { ThemeProvider as U } from "../ThemeProvider/ThemeProvider.js";
 import { normalizeToSDKError as T } from "../../types/sdkError.js";
 import { ObservabilityProvider as w } from "../ObservabilityProvider/ObservabilityProvider.js";
-const X = (s) => {
+function X(s) {
   const {
     children: l,
     config: r,
@@ -23,10 +23,10 @@ const X = (s) => {
     locale: c = "en-US",
     currency: d = "USD",
     theme: p,
-    portalContainer: v,
-    components: f,
-    LoaderComponent: b,
-    queryClient: u
+    portalContainer: f,
+    components: v,
+    LoaderComponent: u,
+    queryClient: b
   } = s;
   if (i)
     for (const t in i) {
@@ -55,17 +55,17 @@ const X = (s) => {
         r.observability.onError(E);
       };
   }, [r.observability]);
-  return /* @__PURE__ */ o(S, { value: f, children: /* @__PURE__ */ o(L, { value: b, children: /* @__PURE__ */ o(w, { observability: r.observability, children: /* @__PURE__ */ o(g, { FallbackComponent: z, onError: h, children: /* @__PURE__ */ o(U, { theme: p, portalContainer: v, children: /* @__PURE__ */ o(D, { locale: c, currency: d, children: /* @__PURE__ */ o(P, { i18n: m, children: /* @__PURE__ */ o(
+  return /* @__PURE__ */ o(S, { value: v, children: /* @__PURE__ */ o(L, { value: u, children: /* @__PURE__ */ o(w, { observability: r.observability, children: /* @__PURE__ */ o(g, { FallbackComponent: z, onError: h, children: /* @__PURE__ */ o(U, { theme: p, portalContainer: f, children: /* @__PURE__ */ o(D, { locale: c, currency: d, children: /* @__PURE__ */ o(P, { i18n: m, children: /* @__PURE__ */ o(
     I,
     {
       url: r.baseUrl,
       headers: r.headers,
       hooks: r.hooks,
-      queryClient: u,
+      queryClient: b,
       children: l
     }
   ) }, n) }) }) }) }) }) });
-};
+}
 export {
   X as GustoProviderCustomUIAdapter
 };

package/dist/contexts/GustoProvider/GustoProviderCustomUIAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"GustoProviderCustomUIAdapter.js","sources":["../../../src/contexts/GustoProvider/GustoProviderCustomUIAdapter.tsx"],"sourcesContent":["import type React from 'react'\nimport type { ErrorInfo } from 'react'\nimport { ErrorBoundary } from 'react-error-boundary'\nimport { I18nextProvider } from 'react-i18next'\nimport type { QueryClient } from '@tanstack/react-query'\nimport { useEffect, useMemo } from 'react'\nimport { ComponentsProvider } from '../ComponentAdapter/ComponentsProvider'\nimport type { ComponentsContextType } from '../ComponentAdapter/useComponentContext'\nimport { ApiProvider } from '../ApiProvider/ApiProvider'\nimport { LoadingIndicatorProvider } from '../LoadingIndicatorProvider/LoadingIndicatorProvider'\nimport type { LoadingIndicatorContextProps } from '../LoadingIndicatorProvider/useLoadingIndicator'\nimport { ObservabilityProvider } from '../ObservabilityProvider'\nimport { sanitizeError } from '../ObservabilityProvider/sanitization'\nimport { SDKI18next } from './SDKI18next'\nimport { InternalError } from '@/components/Common'\nimport { LocaleProvider } from '@/contexts/LocaleProvider'\nimport { ThemeProvider } from '@/contexts/ThemeProvider'\nimport type { GustoSDKTheme } from '@/contexts/ThemeProvider/theme'\nimport type { GlobalResourceDictionary, SupportedLanguages } from '@/types/Helpers'\nimport type { SDKHooks } from '@/types/hooks'\nimport type { ObservabilityHook } from '@/types/observability'\nimport { normalizeToSDKError } from '@/types/sdkError'\n\n/**\n * API client configuration passed to {@link GustoProvider} (and {@link GustoProviderCustomUIAdapter}).\n *\n * @public\n */\nexport interface APIConfig {\n  /** URL of your backend proxy that forwards SDK requests to the Gusto Embedded API. SDK components never call Gusto directly. */\n  baseUrl: string\n  /** Extra headers applied to every API request. Combined with any headers your proxy adds. */\n  headers?: HeadersInit\n  /** Request interceptor hooks. Use these to inspect, modify, or react to requests and responses. See {@link SDKHooks}. */\n  hooks?: SDKHooks\n  /** Observability hook for surfacing errors and metrics from the SDK to your monitoring stack. See {@link ObservabilityHook}. */\n  observability?: ObservabilityHook\n}\n\n/**\n * Shared configuration props accepted by {@link GustoProvider} and {@link GustoProviderCustomUIAdapter}.\n *\n * @public\n */\nexport interface GustoProviderProps {\n  /** API client configuration, including the proxy `baseUrl`, request hooks, and observability. See {@link APIConfig}. */\n  config: APIConfig\n  /** Translation overrides keyed by language and i18next namespace. Strings supplied here replace the SDK defaults for the matching keys. */\n  dictionary?: GlobalResourceDictionary\n  /** Active i18next language. Defaults to `'en'`. */\n  lng?: string\n  /** BCP 47 locale used for number, date, and currency formatting throughout the SDK. Defaults to `'en-US'`. */\n  locale?: string\n  /** ISO 4217 currency code used for monetary formatting. Defaults to `'USD'`. */\n  currency?: string\n  /** Theme overrides applied to SDK components. See {@link GustoSDKTheme}. */\n  theme?: Partial<GustoSDKTheme>\n  /** Element to use as the portal container for SDK popovers and dropdowns. Useful when rendering inside a modal or shadow root. */\n  portalContainer?: HTMLElement\n  /** Optional TanStack Query `QueryClient`. When omitted, the SDK creates its own client configured for Gusto's API. */\n  queryClient?: QueryClient\n  /** Complete map of UI components the SDK renders. Required because this adapter ships no defaults. */\n  components: ComponentsContextType\n  /** Loading indicator rendered while SDK queries are pending. Overrides the SDK default spinner. */\n  LoaderComponent?: LoadingIndicatorContextProps['LoadingIndicator']\n}\n\n/**\n * Props for {@link GustoProviderCustomUIAdapter}.\n *\n * @public\n */\nexport interface GustoProviderCustomUIAdapterProps extends GustoProviderProps {\n  /** The application tree that should have access to the SDK. */\n  children?: React.ReactNode\n}\n\n/**\n * Top-level provider that requires a complete component map and ships no UI defaults.\n *\n * @remarks\n * Use this adapter when you want full control over every UI primitive the SDK renders, or when\n * you want to avoid the React Aria dependency for tree-shaking. Unlike {@link GustoProvider}, the\n * `components` prop on {@link GustoProviderProps} is required and must supply every component the\n * SDK renders.\n *\n * @param props - See {@link GustoProviderCustomUIAdapterProps}.\n * @returns The configured provider tree wrapping `children`.\n * @public\n */\nconst GustoProviderCustomUIAdapter: React.FC<GustoProviderCustomUIAdapterProps> = props => {\n  const {\n    children,\n    config,\n    dictionary,\n    lng = 'en',\n    locale = 'en-US',\n    currency = 'USD',\n    theme,\n    portalContainer,\n    components,\n    LoaderComponent,\n    queryClient,\n  } = props\n\n  if (dictionary) {\n    for (const language in dictionary) {\n      const lang = language as SupportedLanguages\n      for (const ns in dictionary[lang]) {\n        SDKI18next.addResourceBundle(\n          lang,\n          ns,\n          (dictionary[lang] as Record<string, unknown>)[ns],\n          true,\n          true,\n        )\n      }\n    }\n  }\n\n  useEffect(() => {\n    void (async () => {\n      await SDKI18next.changeLanguage(lng)\n    })()\n  }, [lng])\n\n  const handleTopLevelError = useMemo(() => {\n    if (!config.observability?.onError) return undefined\n\n    return (error: unknown, errorInfo: ErrorInfo) => {\n      if (!config.observability?.onError) return\n\n      const sdkError = normalizeToSDKError(error)\n\n      const observabilityError = {\n        ...sdkError,\n        timestamp: Date.now(),\n        componentStack: errorInfo.componentStack ?? undefined,\n      }\n\n      const sanitizedError = sanitizeError(observabilityError, config.observability.sanitization)\n\n      config.observability.onError(sanitizedError)\n    }\n  }, [config.observability])\n  return (\n    <ComponentsProvider value={components}>\n      <LoadingIndicatorProvider value={LoaderComponent}>\n        <ObservabilityProvider observability={config.observability}>\n          <ErrorBoundary FallbackComponent={InternalError} onError={handleTopLevelError}>\n            <ThemeProvider theme={theme} portalContainer={portalContainer}>\n              <LocaleProvider locale={locale} currency={currency}>\n                <I18nextProvider i18n={SDKI18next} key={lng}>\n                  <ApiProvider\n                    url={config.baseUrl}\n                    headers={config.headers}\n                    hooks={config.hooks}\n                    queryClient={queryClient}\n                  >\n                    {children}\n                  </ApiProvider>\n                </I18nextProvider>\n              </LocaleProvider>\n            </ThemeProvider>\n          </ErrorBoundary>\n        </ObservabilityProvider>\n      </LoadingIndicatorProvider>\n    </ComponentsProvider>\n  )\n}\n\nexport { GustoProviderCustomUIAdapter }\n"],"names":["GustoProviderCustomUIAdapter","props","children","config","dictionary","lng","locale","currency","theme","portalContainer","components","LoaderComponent","queryClient","language","lang","ns","SDKI18next","useEffect","handleTopLevelError","useMemo","error","errorInfo","observabilityError","normalizeToSDKError","sanitizedError","sanitizeError","jsx","ComponentsProvider","LoadingIndicatorProvider","ObservabilityProvider","ErrorBoundary","InternalError","ThemeProvider","LocaleProvider","I18nextProvider","ApiProvider"],"mappings":";;;;;;;;;;;;;;;;AA0FA,MAAMA,IAA4E,CAAAC,MAAS;AACzF,QAAM;AAAA,IACJ,UAAAC;AAAA,IACA,QAAAC;AAAA,IACA,YAAAC;AAAA,IACA,KAAAC,IAAM;AAAA,IACN,QAAAC,IAAS;AAAA,IACT,UAAAC,IAAW;AAAA,IACX,OAAAC;AAAA,IACA,iBAAAC;AAAA,IACA,YAAAC;AAAA,IACA,iBAAAC;AAAA,IACA,aAAAC;AAAA,EAAA,IACEX;AAEJ,MAAIG;AACF,eAAWS,KAAYT,GAAY;AACjC,YAAMU,IAAOD;AACb,iBAAWE,KAAMX,EAAWU,CAAI;AAC9B,QAAAE,EAAW;AAAA,UACTF;AAAA,UACAC;AAAA,UACCX,EAAWU,CAAI,EAA8BC,CAAE;AAAA,UAChD;AAAA,UACA;AAAA,QAAA;AAAA,IAGN;AAGF,EAAAE,EAAU,MAAM;AACd,KAAM,YACJ,MAAMD,EAAW,eAAeX,CAAG;AAAA,EAEvC,GAAG,CAACA,CAAG,CAAC;AAER,QAAMa,IAAsBC,EAAQ,MAAM;AACxC,QAAKhB,EAAO,eAAe;AAE3B,aAAO,CAACiB,GAAgBC,MAAyB;AAC/C,YAAI,CAAClB,EAAO,eAAe,QAAS;AAIpC,cAAMmB,IAAqB;AAAA,UACzB,GAHeC,EAAoBH,CAAK;AAAA,UAIxC,WAAW,KAAK,IAAA;AAAA,UAChB,gBAAgBC,EAAU,kBAAkB;AAAA,QAAA,GAGxCG,IAAiBC,EAAcH,GAAoBnB,EAAO,cAAc,YAAY;AAE1F,QAAAA,EAAO,cAAc,QAAQqB,CAAc;AAAA,MAC7C;AAAA,EACF,GAAG,CAACrB,EAAO,aAAa,CAAC;AACzB,SACE,gBAAAuB,EAACC,GAAA,EAAmB,OAAOjB,GACzB,UAAA,gBAAAgB,EAACE,GAAA,EAAyB,OAAOjB,GAC/B,UAAA,gBAAAe,EAACG,GAAA,EAAsB,eAAe1B,EAAO,eAC3C,UAAA,gBAAAuB,EAACI,GAAA,EAAc,mBAAmBC,GAAe,SAASb,GACxD,UAAA,gBAAAQ,EAACM,GAAA,EAAc,OAAAxB,GAAc,iBAAAC,GAC3B,UAAA,gBAAAiB,EAACO,GAAA,EAAe,QAAA3B,GAAgB,UAAAC,GAC9B,UAAA,gBAAAmB,EAACQ,GAAA,EAAgB,MAAMlB,GACrB,UAAA,gBAAAU;AAAA,IAACS;AAAA,IAAA;AAAA,MACC,KAAKhC,EAAO;AAAA,MACZ,SAASA,EAAO;AAAA,MAChB,OAAOA,EAAO;AAAA,MACd,aAAAS;AAAA,MAEC,UAAAV;AAAA,IAAA;AAAA,EAAA,KAPmCG,CASxC,GACF,GACF,EAAA,CACF,EAAA,CACF,GACF,GACF;AAEJ;"}
+{"version":3,"file":"GustoProviderCustomUIAdapter.js","sources":["../../../src/contexts/GustoProvider/GustoProviderCustomUIAdapter.tsx"],"sourcesContent":["import type React from 'react'\nimport type { ErrorInfo, JSX, ReactNode } from 'react'\nimport { ErrorBoundary } from 'react-error-boundary'\nimport { I18nextProvider } from 'react-i18next'\nimport type { QueryClient } from '@tanstack/react-query'\nimport { useEffect, useMemo } from 'react'\nimport { ComponentsProvider } from '../ComponentAdapter/ComponentsProvider'\nimport type { ComponentsContextType } from '../ComponentAdapter/useComponentContext'\nimport { ApiProvider } from '../ApiProvider/ApiProvider'\nimport { LoadingIndicatorProvider } from '../LoadingIndicatorProvider/LoadingIndicatorProvider'\nimport { ObservabilityProvider } from '../ObservabilityProvider'\nimport { sanitizeError } from '../ObservabilityProvider/sanitization'\nimport { SDKI18next } from './SDKI18next'\nimport { InternalError } from '@/components/Common'\nimport { LocaleProvider } from '@/contexts/LocaleProvider'\nimport { ThemeProvider } from '@/contexts/ThemeProvider'\nimport type { GustoSDKTheme } from '@/contexts/ThemeProvider/theme'\nimport type { GlobalResourceDictionary, SupportedLanguages } from '@/types/Helpers'\nimport type { SDKHooks } from '@/types/hooks'\nimport type { ObservabilityHook } from '@/types/observability'\nimport { normalizeToSDKError } from '@/types/sdkError'\n\n/**\n * API client configuration passed to {@link GustoProvider} (and {@link GustoProviderCustomUIAdapter}).\n *\n * @public\n */\nexport interface APIConfig {\n  /** URL of your backend proxy that forwards SDK requests to the Gusto Embedded API. SDK components never call Gusto directly. */\n  baseUrl: string\n  /** Extra headers applied to every API request. Combined with any headers your proxy adds. */\n  headers?: HeadersInit\n  /** Request interceptor hooks. Use these to inspect, modify, or react to requests and responses. See {@link SDKHooks}. */\n  hooks?: SDKHooks\n  /** Observability hook for surfacing errors and metrics from the SDK to your monitoring stack. See {@link ObservabilityHook}. */\n  observability?: ObservabilityHook\n}\n\n/**\n * Shared configuration props accepted by {@link GustoProvider} and {@link GustoProviderCustomUIAdapter}.\n *\n * @public\n */\nexport interface GustoBaseProviderProps {\n  /** API client configuration, including the proxy `baseUrl`, request hooks, and observability. See {@link APIConfig}. */\n  config: APIConfig\n  /** Translation overrides keyed by language and i18next namespace. Strings supplied here replace the SDK defaults for the matching keys. */\n  dictionary?: GlobalResourceDictionary\n  /** Active i18next language. Defaults to `'en'`. */\n  lng?: string\n  /** BCP 47 locale used for number, date, and currency formatting throughout the SDK. Defaults to `'en-US'`. */\n  locale?: string\n  /** ISO 4217 currency code used for monetary formatting. Defaults to `'USD'`. */\n  currency?: string\n  /** Theme overrides applied to SDK components. See {@link GustoSDKTheme}. */\n  theme?: Partial<GustoSDKTheme>\n  /** Element to use as the portal container for SDK popovers and dropdowns. Useful when rendering inside a modal or shadow root. */\n  portalContainer?: HTMLElement\n  /** Optional TanStack Query `QueryClient`. When omitted, the SDK creates its own client configured for Gusto's API. */\n  queryClient?: QueryClient\n  /** Complete map of UI components the SDK renders. Required because this adapter ships no defaults. */\n  components: ComponentsContextType\n  /** Loading indicator rendered while SDK queries are pending. Overrides the SDK default spinner. */\n  LoaderComponent?: ({ children }: { children?: ReactNode }) => JSX.Element\n}\n\n/**\n * Props for {@link GustoProviderCustomUIAdapter}.\n *\n * @public\n */\nexport interface GustoProviderCustomUIAdapterProps extends GustoBaseProviderProps {\n  /** The application tree that should have access to the SDK. */\n  children?: React.ReactNode\n}\n\n/**\n * Top-level provider that requires a complete component map and ships no UI defaults.\n *\n * @remarks\n * Use this adapter when you want full control over every UI primitive the SDK renders, or when\n * you want to avoid the React Aria dependency for tree-shaking. Unlike {@link GustoProvider}, the\n * `components` prop on {@link GustoProviderProps} is required and must supply every component the\n * SDK renders.\n *\n * @param props - See {@link GustoProviderCustomUIAdapterProps}.\n * @returns The configured provider tree wrapping `children`.\n * @public\n */\nexport function GustoProviderCustomUIAdapter(props: GustoProviderCustomUIAdapterProps) {\n  const {\n    children,\n    config,\n    dictionary,\n    lng = 'en',\n    locale = 'en-US',\n    currency = 'USD',\n    theme,\n    portalContainer,\n    components,\n    LoaderComponent,\n    queryClient,\n  } = props\n\n  if (dictionary) {\n    for (const language in dictionary) {\n      const lang = language as SupportedLanguages\n      for (const ns in dictionary[lang]) {\n        SDKI18next.addResourceBundle(\n          lang,\n          ns,\n          (dictionary[lang] as Record<string, unknown>)[ns],\n          true,\n          true,\n        )\n      }\n    }\n  }\n\n  useEffect(() => {\n    void (async () => {\n      await SDKI18next.changeLanguage(lng)\n    })()\n  }, [lng])\n\n  const handleTopLevelError = useMemo(() => {\n    if (!config.observability?.onError) return undefined\n\n    return (error: unknown, errorInfo: ErrorInfo) => {\n      if (!config.observability?.onError) return\n\n      const sdkError = normalizeToSDKError(error)\n\n      const observabilityError = {\n        ...sdkError,\n        timestamp: Date.now(),\n        componentStack: errorInfo.componentStack ?? undefined,\n      }\n\n      const sanitizedError = sanitizeError(observabilityError, config.observability.sanitization)\n\n      config.observability.onError(sanitizedError)\n    }\n  }, [config.observability])\n  return (\n    <ComponentsProvider value={components}>\n      <LoadingIndicatorProvider value={LoaderComponent}>\n        <ObservabilityProvider observability={config.observability}>\n          <ErrorBoundary FallbackComponent={InternalError} onError={handleTopLevelError}>\n            <ThemeProvider theme={theme} portalContainer={portalContainer}>\n              <LocaleProvider locale={locale} currency={currency}>\n                <I18nextProvider i18n={SDKI18next} key={lng}>\n                  <ApiProvider\n                    url={config.baseUrl}\n                    headers={config.headers}\n                    hooks={config.hooks}\n                    queryClient={queryClient}\n                  >\n                    {children}\n                  </ApiProvider>\n                </I18nextProvider>\n              </LocaleProvider>\n            </ThemeProvider>\n          </ErrorBoundary>\n        </ObservabilityProvider>\n      </LoadingIndicatorProvider>\n    </ComponentsProvider>\n  )\n}\n"],"names":["GustoProviderCustomUIAdapter","props","children","config","dictionary","lng","locale","currency","theme","portalContainer","components","LoaderComponent","queryClient","language","lang","ns","SDKI18next","useEffect","handleTopLevelError","useMemo","error","errorInfo","observabilityError","normalizeToSDKError","sanitizedError","sanitizeError","jsx","ComponentsProvider","LoadingIndicatorProvider","ObservabilityProvider","ErrorBoundary","InternalError","ThemeProvider","LocaleProvider","I18nextProvider","ApiProvider"],"mappings":";;;;;;;;;;;;;;;;AAyFO,SAASA,EAA6BC,GAA0C;AACrF,QAAM;AAAA,IACJ,UAAAC;AAAA,IACA,QAAAC;AAAA,IACA,YAAAC;AAAA,IACA,KAAAC,IAAM;AAAA,IACN,QAAAC,IAAS;AAAA,IACT,UAAAC,IAAW;AAAA,IACX,OAAAC;AAAA,IACA,iBAAAC;AAAA,IACA,YAAAC;AAAA,IACA,iBAAAC;AAAA,IACA,aAAAC;AAAA,EAAA,IACEX;AAEJ,MAAIG;AACF,eAAWS,KAAYT,GAAY;AACjC,YAAMU,IAAOD;AACb,iBAAWE,KAAMX,EAAWU,CAAI;AAC9B,QAAAE,EAAW;AAAA,UACTF;AAAA,UACAC;AAAA,UACCX,EAAWU,CAAI,EAA8BC,CAAE;AAAA,UAChD;AAAA,UACA;AAAA,QAAA;AAAA,IAGN;AAGF,EAAAE,EAAU,MAAM;AACd,KAAM,YACJ,MAAMD,EAAW,eAAeX,CAAG;AAAA,EAEvC,GAAG,CAACA,CAAG,CAAC;AAER,QAAMa,IAAsBC,EAAQ,MAAM;AACxC,QAAKhB,EAAO,eAAe;AAE3B,aAAO,CAACiB,GAAgBC,MAAyB;AAC/C,YAAI,CAAClB,EAAO,eAAe,QAAS;AAIpC,cAAMmB,IAAqB;AAAA,UACzB,GAHeC,EAAoBH,CAAK;AAAA,UAIxC,WAAW,KAAK,IAAA;AAAA,UAChB,gBAAgBC,EAAU,kBAAkB;AAAA,QAAA,GAGxCG,IAAiBC,EAAcH,GAAoBnB,EAAO,cAAc,YAAY;AAE1F,QAAAA,EAAO,cAAc,QAAQqB,CAAc;AAAA,MAC7C;AAAA,EACF,GAAG,CAACrB,EAAO,aAAa,CAAC;AACzB,SACE,gBAAAuB,EAACC,GAAA,EAAmB,OAAOjB,GACzB,UAAA,gBAAAgB,EAACE,GAAA,EAAyB,OAAOjB,GAC/B,UAAA,gBAAAe,EAACG,GAAA,EAAsB,eAAe1B,EAAO,eAC3C,UAAA,gBAAAuB,EAACI,GAAA,EAAc,mBAAmBC,GAAe,SAASb,GACxD,UAAA,gBAAAQ,EAACM,GAAA,EAAc,OAAAxB,GAAc,iBAAAC,GAC3B,UAAA,gBAAAiB,EAACO,GAAA,EAAe,QAAA3B,GAAgB,UAAAC,GAC9B,UAAA,gBAAAmB,EAACQ,GAAA,EAAgB,MAAMlB,GACrB,UAAA,gBAAAU;AAAA,IAACS;AAAA,IAAA;AAAA,MACC,KAAKhC,EAAO;AAAA,MACZ,SAASA,EAAO;AAAA,MAChB,OAAOA,EAAO;AAAA,MACd,aAAAS;AAAA,MAEC,UAAAV;AAAA,IAAA;AAAA,EAAA,KAPmCG,CASxC,GACF,GACF,EAAA,CACF,EAAA,CACF,GACF,GACF;AAEJ;"}

package/dist/contexts/GustoProvider/index.d.ts

@@ -1,3 +1,3 @@
 export { GustoProvider } from './GustoProvider';
-export type { GustoApiProps } from './GustoProvider';
+export type { GustoProviderProps } from './GustoProvider';
 export { GustoProviderCustomUIAdapter } from './GustoProviderCustomUIAdapter';

package/dist/contexts/index.d.ts

@@ -1,10 +1,6 @@
 export { GustoProvider, GustoProviderCustomUIAdapter } from './GustoProvider';
-export type { GustoProviderProps, GustoProviderCustomUIAdapterProps, APIConfig, } from './GustoProvider/GustoProviderCustomUIAdapter';
-export type { GustoApiProps } from './GustoProvider';
-export { ApiProvider } from './ApiProvider/ApiProvider';
-export type { ApiProviderProps } from './ApiProvider/ApiProvider';
+export type { GustoBaseProviderProps, GustoProviderCustomUIAdapterProps, APIConfig, } from './GustoProvider/GustoProviderCustomUIAdapter';
+export type { GustoProviderProps } from './GustoProvider';
 export type { ComponentsContextType } from './ComponentAdapter/useComponentContext';
 export * from './ComponentAdapter/componentAdapterTypes';
-export { ObservabilityProvider, useObservability } from './ObservabilityProvider';
-export type { ObservabilityProviderProps, ObservabilityContextValue } from './ObservabilityProvider';
 export type { GustoSDKTheme, GustoSDKThemeColors } from './ThemeProvider/theme';

package/dist/helpers/apiErrorToList.d.ts

@@ -1,4 +1,4 @@
-import { EntityErrorObject } from '@gusto/embedded-api-v-2026-02-01/models/components/entityerrorobject';
+import { EntityErrorObject } from '@gusto/embedded-api/models/components/entityerrorobject';
 /**
  * Renders each error in the list that carries a `message` as a `<span>` keyed by `errorKey`.
  *

package/dist/helpers/apiErrorToList.js.map

@@ -1 +1 @@
-{"version":3,"file":"apiErrorToList.js","sources":["../../src/helpers/apiErrorToList.tsx"],"sourcesContent":["import type { EntityErrorObject } from '@gusto/embedded-api-v-2026-02-01/models/components/entityerrorobject'\nimport { snakeCaseToCamelCase } from './formattedStrings'\n\n/**\n * Renders each error in the list that carries a `message` as a `<span>` keyed by `errorKey`.\n *\n * @param errorList - Flat list of entity errors returned by the API.\n * @returns React nodes for messaged entries; entries without a message yield `null`.\n * @internal\n */\nexport const renderErrorList = (errorList: Array<EntityErrorObject>): React.ReactNode[] => {\n  return errorList.map(errorFromList => {\n    if (errorFromList.message) {\n      return <span key={errorFromList.errorKey}>{errorFromList.message}</span>\n    }\n    return null\n  })\n}\n/**\n * Recursively flattens a nested API error tree into a list keyed for form-field display.\n *\n * @remarks Builds dot-separated `errorKey` paths from nested errors and converts each segment\n * from snake_case to camelCase so the resulting keys match react-hook-form field names.\n * `metadata.key` is used as the path segment for nested errors when present; `metadata.state`\n * is a special case for state-tax validation errors, falling back to the node's own `errorKey`.\n *\n * @param error - The root entity error to flatten.\n * @param parentKey - Accumulated dot-path prefix used during recursion. Omit at the top level.\n * @returns A flat list of `{ errorKey, message, category }` entries ready to bind to form fields.\n * @internal\n */\nexport const getFieldErrors = (\n  error: EntityErrorObject,\n  parentKey?: string,\n): Array<EntityErrorObject> => {\n  const keyPrefix = parentKey ? parentKey + '.' : ''\n  if (error.category === 'invalid_attribute_value' || error.category === 'invalid_operation') {\n    return [\n      {\n        errorKey: snakeCaseToCamelCase(keyPrefix + error.errorKey),\n        message: error.message ?? '',\n        category: error.category,\n      },\n    ]\n  }\n  if (error.category === 'nested_errors' && error.errors !== undefined) {\n    //TODO: clean this up once Metadata type is fixed in openapi spec\n    let keySuffix = ''\n    //@ts-expect-error: Metadata in speakeasy is incorrectly typed\n    if (error.metadata?.key && typeof error.metadata.key === 'string') {\n      //@ts-expect-error: Metadata in speakeasy is incorrectly typed\n      keySuffix = error.metadata.key as string\n      //@ts-expect-error: Metadata in speakeasy is incorrectly typed\n    } else if (error.metadata?.state && typeof error.metadata.state === 'string') {\n      //@ts-expect-error: Metadata in speakeasy is incorrectly typed\n      keySuffix = error.metadata.state as string\n    } else if (error.errorKey) {\n      keySuffix = error.errorKey\n    }\n    return error.errors.flatMap(err => getFieldErrors(err, keyPrefix + keySuffix))\n  }\n  if (error.message) {\n    return [\n      {\n        errorKey: snakeCaseToCamelCase(keyPrefix + error.errorKey),\n        message: error.message,\n        category: error.category,\n      },\n    ]\n  }\n  return []\n}\n"],"names":["renderErrorList","errorList","errorFromList","jsx","getFieldErrors","error","parentKey","keyPrefix","snakeCaseToCamelCase","keySuffix","err"],"mappings":";;AAUO,MAAMA,IAAkB,CAACC,MACvBA,EAAU,IAAI,CAAAC,MACfA,EAAc,UACT,gBAAAC,EAAC,QAAA,EAAmC,UAAAD,EAAc,QAAA,GAAvCA,EAAc,QAAiC,IAE5D,IACR,GAeUE,IAAiB,CAC5BC,GACAC,MAC6B;AAC7B,QAAMC,IAAYD,IAAYA,IAAY,MAAM;AAChD,MAAID,EAAM,aAAa,6BAA6BA,EAAM,aAAa;AACrE,WAAO;AAAA,MACL;AAAA,QACE,UAAUG,EAAqBD,IAAYF,EAAM,QAAQ;AAAA,QACzD,SAASA,EAAM,WAAW;AAAA,QAC1B,UAAUA,EAAM;AAAA,MAAA;AAAA,IAClB;AAGJ,MAAIA,EAAM,aAAa,mBAAmBA,EAAM,WAAW,QAAW;AAEpE,QAAII,IAAY;AAEhB,WAAIJ,EAAM,UAAU,OAAO,OAAOA,EAAM,SAAS,OAAQ,WAEvDI,IAAYJ,EAAM,SAAS,MAElBA,EAAM,UAAU,SAAS,OAAOA,EAAM,SAAS,SAAU,WAElEI,IAAYJ,EAAM,SAAS,QAClBA,EAAM,aACfI,IAAYJ,EAAM,WAEbA,EAAM,OAAO,QAAQ,CAAAK,MAAON,EAAeM,GAAKH,IAAYE,CAAS,CAAC;AAAA,EAC/E;AACA,SAAIJ,EAAM,UACD;AAAA,IACL;AAAA,MACE,UAAUG,EAAqBD,IAAYF,EAAM,QAAQ;AAAA,MACzD,SAASA,EAAM;AAAA,MACf,UAAUA,EAAM;AAAA,IAAA;AAAA,EAClB,IAGG,CAAA;AACT;"}
+{"version":3,"file":"apiErrorToList.js","sources":["../../src/helpers/apiErrorToList.tsx"],"sourcesContent":["import type { EntityErrorObject } from '@gusto/embedded-api/models/components/entityerrorobject'\nimport { snakeCaseToCamelCase } from './formattedStrings'\n\n/**\n * Renders each error in the list that carries a `message` as a `<span>` keyed by `errorKey`.\n *\n * @param errorList - Flat list of entity errors returned by the API.\n * @returns React nodes for messaged entries; entries without a message yield `null`.\n * @internal\n */\nexport const renderErrorList = (errorList: Array<EntityErrorObject>): React.ReactNode[] => {\n  return errorList.map(errorFromList => {\n    if (errorFromList.message) {\n      return <span key={errorFromList.errorKey}>{errorFromList.message}</span>\n    }\n    return null\n  })\n}\n/**\n * Recursively flattens a nested API error tree into a list keyed for form-field display.\n *\n * @remarks Builds dot-separated `errorKey` paths from nested errors and converts each segment\n * from snake_case to camelCase so the resulting keys match react-hook-form field names.\n * `metadata.key` is used as the path segment for nested errors when present; `metadata.state`\n * is a special case for state-tax validation errors, falling back to the node's own `errorKey`.\n *\n * @param error - The root entity error to flatten.\n * @param parentKey - Accumulated dot-path prefix used during recursion. Omit at the top level.\n * @returns A flat list of `{ errorKey, message, category }` entries ready to bind to form fields.\n * @internal\n */\nexport const getFieldErrors = (\n  error: EntityErrorObject,\n  parentKey?: string,\n): Array<EntityErrorObject> => {\n  const keyPrefix = parentKey ? parentKey + '.' : ''\n  if (error.category === 'invalid_attribute_value' || error.category === 'invalid_operation') {\n    return [\n      {\n        errorKey: snakeCaseToCamelCase(keyPrefix + error.errorKey),\n        message: error.message ?? '',\n        category: error.category,\n      },\n    ]\n  }\n  if (error.category === 'nested_errors' && error.errors !== undefined) {\n    //TODO: clean this up once Metadata type is fixed in openapi spec\n    let keySuffix = ''\n    //@ts-expect-error: Metadata in speakeasy is incorrectly typed\n    if (error.metadata?.key && typeof error.metadata.key === 'string') {\n      //@ts-expect-error: Metadata in speakeasy is incorrectly typed\n      keySuffix = error.metadata.key as string\n      //@ts-expect-error: Metadata in speakeasy is incorrectly typed\n    } else if (error.metadata?.state && typeof error.metadata.state === 'string') {\n      //@ts-expect-error: Metadata in speakeasy is incorrectly typed\n      keySuffix = error.metadata.state as string\n    } else if (error.errorKey) {\n      keySuffix = error.errorKey\n    }\n    return error.errors.flatMap(err => getFieldErrors(err, keyPrefix + keySuffix))\n  }\n  if (error.message) {\n    return [\n      {\n        errorKey: snakeCaseToCamelCase(keyPrefix + error.errorKey),\n        message: error.message,\n        category: error.category,\n      },\n    ]\n  }\n  return []\n}\n"],"names":["renderErrorList","errorList","errorFromList","jsx","getFieldErrors","error","parentKey","keyPrefix","snakeCaseToCamelCase","keySuffix","err"],"mappings":";;AAUO,MAAMA,IAAkB,CAACC,MACvBA,EAAU,IAAI,CAAAC,MACfA,EAAc,UACT,gBAAAC,EAAC,QAAA,EAAmC,UAAAD,EAAc,QAAA,GAAvCA,EAAc,QAAiC,IAE5D,IACR,GAeUE,IAAiB,CAC5BC,GACAC,MAC6B;AAC7B,QAAMC,IAAYD,IAAYA,IAAY,MAAM;AAChD,MAAID,EAAM,aAAa,6BAA6BA,EAAM,aAAa;AACrE,WAAO;AAAA,MACL;AAAA,QACE,UAAUG,EAAqBD,IAAYF,EAAM,QAAQ;AAAA,QACzD,SAASA,EAAM,WAAW;AAAA,QAC1B,UAAUA,EAAM;AAAA,MAAA;AAAA,IAClB;AAGJ,MAAIA,EAAM,aAAa,mBAAmBA,EAAM,WAAW,QAAW;AAEpE,QAAII,IAAY;AAEhB,WAAIJ,EAAM,UAAU,OAAO,OAAOA,EAAM,SAAS,OAAQ,WAEvDI,IAAYJ,EAAM,SAAS,MAElBA,EAAM,UAAU,SAAS,OAAOA,EAAM,SAAS,SAAU,WAElEI,IAAYJ,EAAM,SAAS,QAClBA,EAAM,aACfI,IAAYJ,EAAM,WAEbA,EAAM,OAAO,QAAQ,CAAAK,MAAON,EAAeM,GAAKH,IAAYE,CAAS,CAAC;AAAA,EAC/E;AACA,SAAIJ,EAAM,UACD;AAAA,IACL;AAAA,MACE,UAAUG,EAAqBD,IAAYF,EAAM,QAAQ;AAAA,MACzD,SAASA,EAAM;AAAA,MACf,UAAUA,EAAM;AAAA,IAAA;AAAA,EAClB,IAGG,CAAA;AACT;"}

package/dist/helpers/formattedStrings.d.ts

@@ -1,5 +1,5 @@
-import { Location } from '@gusto/embedded-api-v-2026-02-01/models/components/location';
-import { EmployeeAddress } from '@gusto/embedded-api-v-2026-02-01/models/components/employeeaddress';
+import { Location } from '@gusto/embedded-api/models/components/location';
+import { EmployeeAddress } from '@gusto/embedded-api/models/components/employeeaddress';
 import { TFunction } from 'i18next';
 /**
  * Joins a first and last name into a single capitalized display string.

package/dist/helpers/formattedStrings.js.map

@@ -1 +1 @@
-{"version":3,"file":"formattedStrings.js","sources":["../../src/helpers/formattedStrings.ts"],"sourcesContent":["import DOMPurify from 'dompurify'\nimport { type Location } from '@gusto/embedded-api-v-2026-02-01/models/components/location'\nimport { type EmployeeAddress } from '@gusto/embedded-api-v-2026-02-01/models/components/employeeaddress'\nimport { type TFunction } from 'i18next'\nimport { useTranslation } from 'react-i18next'\nimport { useCallback } from 'react'\nimport { useLocale } from '@/contexts/LocaleProvider/useLocale'\n\nconst capitalize = (word: string) => word.charAt(0).toLocaleUpperCase() + word.slice(1)\n\n/**\n * Joins a first and last name into a single capitalized display string.\n *\n * @remarks Each name part is capitalized at its first character. A space is\n * inserted between the parts only when the last name is present. Missing\n * parts are treated as empty.\n *\n * @param name - Object with optional `first_name` and `last_name` fields.\n * @returns The combined name, e.g. `Jane Doe`, `Jane`, or `''`.\n * @internal\n */\nexport const firstLastName = ({\n  first_name,\n  last_name,\n}: {\n  first_name?: string | null\n  last_name?: string | null\n}) =>\n  `${first_name ? capitalize(first_name) : ''}${last_name ? maybeString(capitalize(last_name)) : ''}`\n\nconst maybeString = (str: string | null | undefined) => {\n  return str ? ` ${str}` : ''\n}\n\n/**\n * Combines an address's two street lines with a comma separator.\n *\n * @remarks Each line is prefixed with a leading space when present, producing\n * a string like ` 123 Main St, Apt 4`. Prefer {@link formatStreetForDisplay}\n * for new display code; this function is retained for legacy callers.\n *\n * @param address - Address whose `street1` and `street2` are joined.\n * @returns The joined street string.\n * @internal\n */\nexport const getStreet = (address: EmployeeAddress | Location) => {\n  const street1 = maybeString(address.street1)\n  const street2 = maybeString(address.street2)\n\n  return `${street1},${street2}`\n}\n\n/**\n * Joins an address's street lines with a comma for display.\n *\n * @remarks Trims each line and skips empty values, avoiding the leading-space\n * and trailing-comma artifacts of {@link getStreet}.\n *\n * @param address - Address whose `street1` and `street2` are joined.\n * @returns The display-formatted street string, e.g. `123 Main St, Apt 4`.\n * @internal\n */\nexport const formatStreetForDisplay = (address: EmployeeAddress | Location) => {\n  const parts = [address.street1?.trim(), address.street2?.trim()].filter((part): part is string =>\n    Boolean(part),\n  )\n  return parts.join(', ')\n}\n\n/**\n * Formats an address's city, state, and zip into a single display string.\n *\n * @param address - Address whose `city`, `state`, and `zip` are joined.\n * @returns A `City, State Zip` string. Empty fields are skipped.\n * @internal\n */\nexport const getCityStateZip = (address: EmployeeAddress | Location) =>\n  `${maybeString(address.city)}, ${maybeString(address.state)} ${maybeString(address.zip)}`\n\n/**\n * Formats a full address as a single inline string.\n *\n * @param address - The address to format.\n * @returns The combined street and city/state/zip string.\n * @internal\n */\nexport const addressInline = (address: EmployeeAddress | Location) =>\n  `${getStreet(address)} ${getCityStateZip(address)}`\n\n/**\n * Wraps an amount string with a currency or percent symbol.\n *\n * @param amount - Pre-formatted numeric string.\n * @param isPercentage - When `true`, appends `%`; otherwise prepends `$`.\n * @returns The amount with the appropriate symbol.\n * @internal\n */\nconst amountStr = (amount: string, isPercentage: boolean) =>\n  isPercentage ? `${amount}%` : `$${amount}`\n\n/**\n * Formats a number as a USD currency string with two decimal places.\n *\n * @param amount - The numeric value to format.\n * @param locale - Optional BCP 47 locale tag passed to `toLocaleString`.\n * Defaults to `en-US`.\n * @returns A `$1,234.56` style currency string.\n * @internal\n */\nexport const formatNumberAsCurrency = (amount: number, locale: string = 'en-US') => {\n  const formattedNumber = amount.toLocaleString(locale, {\n    minimumFractionDigits: 2,\n    maximumFractionDigits: 2,\n  })\n  return amountStr(formattedNumber, false)\n}\n\n/**\n * Formats a pay rate with its payment unit, annualizing weekly and monthly values.\n *\n * @remarks Hourly, yearly, and paycheck rates are displayed at the input\n * value. Weekly rates are multiplied by 52 and monthly rates by 12 to express\n * an annualized amount. Unknown payment units render as the currency value\n * alone.\n *\n * @param args - Formatting inputs: `rate` (numeric value), `paymentUnit`\n * (`Hour`, `Week`, `Month`, `Year`, or `Paycheck`), `t` (i18next translation\n * function), and optional `locale` (BCP 47 tag, default `en-US`).\n * @returns The translated, formatted pay rate string.\n * @internal\n */\nexport const formatPayRate = ({\n  rate,\n  paymentUnit,\n  t,\n  locale = 'en-US',\n}: {\n  rate: number\n  paymentUnit: string\n  t: TFunction\n  locale?: string\n}) => {\n  const amount = formatNumberAsCurrency(rate, locale)\n\n  switch (paymentUnit) {\n    case 'Hour':\n      return t('payRateFormats.hourly', { amount, ns: 'common' })\n    case 'Week':\n      return t('payRateFormats.weekly', {\n        amount: formatNumberAsCurrency(rate * 52, locale),\n        ns: 'common',\n      })\n    case 'Month':\n      return t('payRateFormats.monthly', {\n        amount: formatNumberAsCurrency(rate * 12, locale),\n        ns: 'common',\n      })\n    case 'Year':\n      return t('payRateFormats.yearly', { amount, ns: 'common' })\n    case 'Paycheck':\n      return t('payRateFormats.paycheck', { amount, ns: 'common' })\n    default:\n      return amount\n  }\n}\n\n/**\n * Formats a compensation rate as-is, without annualizing weekly or monthly values.\n *\n * @remarks Use for displaying compensation card data where the stored rate\n * should be shown directly (e.g. `$950 per week`, `$3,500 per month`).\n * Unknown payment units render as the currency value alone.\n *\n * @param args - Formatting inputs: `rate` (numeric value), `paymentUnit`\n * (`Hour`, `Week`, `Month`, `Year`, or `Paycheck`), `t` (i18next translation\n * function), and optional `locale` (BCP 47 tag, default `en-US`).\n * @returns The translated, formatted compensation rate string.\n * @internal\n */\nexport const formatCompensationRate = ({\n  rate,\n  paymentUnit,\n  t,\n  locale = 'en-US',\n}: {\n  rate: number\n  paymentUnit: string\n  t: TFunction\n  locale?: string\n}) => {\n  const amount = formatNumberAsCurrency(rate, locale)\n\n  switch (paymentUnit) {\n    case 'Hour':\n      return t('compensationRateFormats.hourly', { amount, ns: 'common' })\n    case 'Week':\n      return t('compensationRateFormats.weekly', { amount, ns: 'common' })\n    case 'Month':\n      return t('compensationRateFormats.monthly', { amount, ns: 'common' })\n    case 'Year':\n      return t('compensationRateFormats.yearly', { amount, ns: 'common' })\n    case 'Paycheck':\n      return t('compensationRateFormats.paycheck', { amount, ns: 'common' })\n    default:\n      return amount\n  }\n}\n\n/**\n * Hook that returns a memoized {@link formatCompensationRate} bound to the active locale.\n *\n * @returns A callback `(rate, paymentUnit) => string`.\n * @internal\n */\nexport const useFormatCompensationRate = () => {\n  const { t } = useTranslation('common')\n  const { locale } = useLocale()\n\n  return useCallback(\n    (rate: number, paymentUnit: string) => {\n      return formatCompensationRate({ rate, paymentUnit, t, locale })\n    },\n    [t, locale],\n  )\n}\n\nconst dompurifyConfig = { ALLOWED_TAGS: ['a', 'b', 'strong'], ALLOWED_ATTR: ['href', 'target'] }\n/**\n * Sanitizes an HTML string for use with React's `dangerouslySetInnerHTML`.\n *\n * @remarks Only `<a>`, `<b>`, and `<strong>` tags are allowed, and `<a>`\n * elements may retain only `href` and `target` attributes. All other markup\n * is stripped via DOMPurify.\n *\n * @param dirty - The raw HTML string to sanitize.\n * @returns An object shaped for `dangerouslySetInnerHTML`. The `__html`\n * field is `''` when the input is empty.\n * @internal\n */\nexport function createMarkup(dirty: string) {\n  if (!dirty) return { __html: '' }\n  return { __html: DOMPurify.sanitize(dirty, dompurifyConfig) }\n}\n\n/**\n * Removes all non-digit characters from a string.\n *\n * @param value - The string to filter.\n * @returns The input with only the digit characters `0`–`9` retained.\n * @internal\n */\nexport const removeNonDigits = (value: string): string => {\n  return value.replace(/\\D/g, '')\n}\n\n/**\n * Strips the trailing `.value` segment from an API error path.\n *\n * @remarks API validation errors target a `.value` field on the inner\n * object, but react-hook-form registers the field under its bare name.\n * Stripping `.value` aligns the error path with the form field name.\n *\n * @param errorKey - The dotted error path returned by the API.\n * @returns The error key without a trailing `.value`.\n * @internal\n */\nexport const normalizeErrorKeyForForm = (errorKey: string): string =>\n  errorKey.replace(/\\.value$/, '')\n\n/**\n * Converts a `snake_case` string to `camelCase`.\n *\n * @param s - The snake_case string to convert.\n * @returns The camelCase equivalent.\n * @internal\n */\nexport const snakeCaseToCamelCase = (s: string) => {\n  return s.replace(/_([a-z])/g, (_: string, char: string) => char.toUpperCase())\n}\n\n/**\n * Converts a `camelCase` or `PascalCase` string to `snake_case`.\n *\n * @remarks Handles consecutive uppercase letters by inserting a separator\n * before the final letter of a run that is followed by a lowercase letter\n * (e.g. `HTMLParser` becomes `html_parser`).\n *\n * @param s - The camelCase or PascalCase string to convert.\n * @returns The snake_case equivalent in lower case.\n * @internal\n */\nexport const camelCaseToSnakeCase = (s: string) => {\n  return s\n    .replace(\n      /([a-z0-9])([A-Z])/g,\n      (_: string, group1: string, group2: string) => `${group1}_${group2.toLowerCase()}`,\n    )\n    .replace(\n      /([A-Z])([A-Z])(?=[a-z])/g,\n      (_: string, group1: string, group2: string) =>\n        `${group1.toLowerCase()}_${group2.toLowerCase()}`,\n    )\n    .toLowerCase()\n}\n\n/**\n * Formats a US phone number as `NNN-NNN-NNNN` for display.\n *\n * @remarks Strips non-digit characters before formatting. A leading `1`\n * country code on 11-digit inputs is dropped. Inputs that are not 10 or 11\n * digits are returned as the raw digit string. Returns an empty string for\n * nullish input.\n *\n * @param phoneNumber - The phone number to format.\n * @returns The formatted phone number, the digit-only fallback, or `''`.\n * @internal\n */\nexport const formatPhoneNumber = (phoneNumber: string | number | null | undefined): string => {\n  if (!phoneNumber) return ''\n\n  const digits = removeNonDigits(String(phoneNumber))\n\n  if (digits.length === 10) {\n    return `${digits.slice(0, 3)}-${digits.slice(3, 6)}-${digits.slice(6)}`\n  }\n\n  if (digits.length === 11 && digits.startsWith('1')) {\n    return `${digits.slice(1, 4)}-${digits.slice(4, 7)}-${digits.slice(7)}`\n  }\n\n  return digits || ''\n}\n"],"names":["capitalize","word","firstLastName","first_name","last_name","maybeString","str","getStreet","address","street1","street2","formatStreetForDisplay","part","getCityStateZip","addressInline","amountStr","amount","isPercentage","formatNumberAsCurrency","locale","formattedNumber","formatPayRate","rate","paymentUnit","t","formatCompensationRate","useFormatCompensationRate","useTranslation","useLocale","useCallback","dompurifyConfig","createMarkup","dirty","DOMPurify","removeNonDigits","value","normalizeErrorKeyForForm","errorKey","snakeCaseToCamelCase","s","_","char","formatPhoneNumber","phoneNumber","digits"],"mappings":"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"}
+{"version":3,"file":"formattedStrings.js","sources":["../../src/helpers/formattedStrings.ts"],"sourcesContent":["import DOMPurify from 'dompurify'\nimport { type Location } from '@gusto/embedded-api/models/components/location'\nimport { type EmployeeAddress } from '@gusto/embedded-api/models/components/employeeaddress'\nimport { type TFunction } from 'i18next'\nimport { useTranslation } from 'react-i18next'\nimport { useCallback } from 'react'\nimport { useLocale } from '@/contexts/LocaleProvider/useLocale'\n\nconst capitalize = (word: string) => word.charAt(0).toLocaleUpperCase() + word.slice(1)\n\n/**\n * Joins a first and last name into a single capitalized display string.\n *\n * @remarks Each name part is capitalized at its first character. A space is\n * inserted between the parts only when the last name is present. Missing\n * parts are treated as empty.\n *\n * @param name - Object with optional `first_name` and `last_name` fields.\n * @returns The combined name, e.g. `Jane Doe`, `Jane`, or `''`.\n * @internal\n */\nexport const firstLastName = ({\n  first_name,\n  last_name,\n}: {\n  first_name?: string | null\n  last_name?: string | null\n}) =>\n  `${first_name ? capitalize(first_name) : ''}${last_name ? maybeString(capitalize(last_name)) : ''}`\n\nconst maybeString = (str: string | null | undefined) => {\n  return str ? ` ${str}` : ''\n}\n\n/**\n * Combines an address's two street lines with a comma separator.\n *\n * @remarks Each line is prefixed with a leading space when present, producing\n * a string like ` 123 Main St, Apt 4`. Prefer {@link formatStreetForDisplay}\n * for new display code; this function is retained for legacy callers.\n *\n * @param address - Address whose `street1` and `street2` are joined.\n * @returns The joined street string.\n * @internal\n */\nexport const getStreet = (address: EmployeeAddress | Location) => {\n  const street1 = maybeString(address.street1)\n  const street2 = maybeString(address.street2)\n\n  return `${street1},${street2}`\n}\n\n/**\n * Joins an address's street lines with a comma for display.\n *\n * @remarks Trims each line and skips empty values, avoiding the leading-space\n * and trailing-comma artifacts of {@link getStreet}.\n *\n * @param address - Address whose `street1` and `street2` are joined.\n * @returns The display-formatted street string, e.g. `123 Main St, Apt 4`.\n * @internal\n */\nexport const formatStreetForDisplay = (address: EmployeeAddress | Location) => {\n  const parts = [address.street1?.trim(), address.street2?.trim()].filter((part): part is string =>\n    Boolean(part),\n  )\n  return parts.join(', ')\n}\n\n/**\n * Formats an address's city, state, and zip into a single display string.\n *\n * @param address - Address whose `city`, `state`, and `zip` are joined.\n * @returns A `City, State Zip` string. Empty fields are skipped.\n * @internal\n */\nexport const getCityStateZip = (address: EmployeeAddress | Location) =>\n  `${maybeString(address.city)}, ${maybeString(address.state)} ${maybeString(address.zip)}`\n\n/**\n * Formats a full address as a single inline string.\n *\n * @param address - The address to format.\n * @returns The combined street and city/state/zip string.\n * @internal\n */\nexport const addressInline = (address: EmployeeAddress | Location) =>\n  `${getStreet(address)} ${getCityStateZip(address)}`\n\n/**\n * Wraps an amount string with a currency or percent symbol.\n *\n * @param amount - Pre-formatted numeric string.\n * @param isPercentage - When `true`, appends `%`; otherwise prepends `$`.\n * @returns The amount with the appropriate symbol.\n * @internal\n */\nconst amountStr = (amount: string, isPercentage: boolean) =>\n  isPercentage ? `${amount}%` : `$${amount}`\n\n/**\n * Formats a number as a USD currency string with two decimal places.\n *\n * @param amount - The numeric value to format.\n * @param locale - Optional BCP 47 locale tag passed to `toLocaleString`.\n * Defaults to `en-US`.\n * @returns A `$1,234.56` style currency string.\n * @internal\n */\nexport const formatNumberAsCurrency = (amount: number, locale: string = 'en-US') => {\n  const formattedNumber = amount.toLocaleString(locale, {\n    minimumFractionDigits: 2,\n    maximumFractionDigits: 2,\n  })\n  return amountStr(formattedNumber, false)\n}\n\n/**\n * Formats a pay rate with its payment unit, annualizing weekly and monthly values.\n *\n * @remarks Hourly, yearly, and paycheck rates are displayed at the input\n * value. Weekly rates are multiplied by 52 and monthly rates by 12 to express\n * an annualized amount. Unknown payment units render as the currency value\n * alone.\n *\n * @param args - Formatting inputs: `rate` (numeric value), `paymentUnit`\n * (`Hour`, `Week`, `Month`, `Year`, or `Paycheck`), `t` (i18next translation\n * function), and optional `locale` (BCP 47 tag, default `en-US`).\n * @returns The translated, formatted pay rate string.\n * @internal\n */\nexport const formatPayRate = ({\n  rate,\n  paymentUnit,\n  t,\n  locale = 'en-US',\n}: {\n  rate: number\n  paymentUnit: string\n  t: TFunction\n  locale?: string\n}) => {\n  const amount = formatNumberAsCurrency(rate, locale)\n\n  switch (paymentUnit) {\n    case 'Hour':\n      return t('payRateFormats.hourly', { amount, ns: 'common' })\n    case 'Week':\n      return t('payRateFormats.weekly', {\n        amount: formatNumberAsCurrency(rate * 52, locale),\n        ns: 'common',\n      })\n    case 'Month':\n      return t('payRateFormats.monthly', {\n        amount: formatNumberAsCurrency(rate * 12, locale),\n        ns: 'common',\n      })\n    case 'Year':\n      return t('payRateFormats.yearly', { amount, ns: 'common' })\n    case 'Paycheck':\n      return t('payRateFormats.paycheck', { amount, ns: 'common' })\n    default:\n      return amount\n  }\n}\n\n/**\n * Formats a compensation rate as-is, without annualizing weekly or monthly values.\n *\n * @remarks Use for displaying compensation card data where the stored rate\n * should be shown directly (e.g. `$950 per week`, `$3,500 per month`).\n * Unknown payment units render as the currency value alone.\n *\n * @param args - Formatting inputs: `rate` (numeric value), `paymentUnit`\n * (`Hour`, `Week`, `Month`, `Year`, or `Paycheck`), `t` (i18next translation\n * function), and optional `locale` (BCP 47 tag, default `en-US`).\n * @returns The translated, formatted compensation rate string.\n * @internal\n */\nexport const formatCompensationRate = ({\n  rate,\n  paymentUnit,\n  t,\n  locale = 'en-US',\n}: {\n  rate: number\n  paymentUnit: string\n  t: TFunction\n  locale?: string\n}) => {\n  const amount = formatNumberAsCurrency(rate, locale)\n\n  switch (paymentUnit) {\n    case 'Hour':\n      return t('compensationRateFormats.hourly', { amount, ns: 'common' })\n    case 'Week':\n      return t('compensationRateFormats.weekly', { amount, ns: 'common' })\n    case 'Month':\n      return t('compensationRateFormats.monthly', { amount, ns: 'common' })\n    case 'Year':\n      return t('compensationRateFormats.yearly', { amount, ns: 'common' })\n    case 'Paycheck':\n      return t('compensationRateFormats.paycheck', { amount, ns: 'common' })\n    default:\n      return amount\n  }\n}\n\n/**\n * Hook that returns a memoized {@link formatCompensationRate} bound to the active locale.\n *\n * @returns A callback `(rate, paymentUnit) => string`.\n * @internal\n */\nexport const useFormatCompensationRate = () => {\n  const { t } = useTranslation('common')\n  const { locale } = useLocale()\n\n  return useCallback(\n    (rate: number, paymentUnit: string) => {\n      return formatCompensationRate({ rate, paymentUnit, t, locale })\n    },\n    [t, locale],\n  )\n}\n\nconst dompurifyConfig = { ALLOWED_TAGS: ['a', 'b', 'strong'], ALLOWED_ATTR: ['href', 'target'] }\n/**\n * Sanitizes an HTML string for use with React's `dangerouslySetInnerHTML`.\n *\n * @remarks Only `<a>`, `<b>`, and `<strong>` tags are allowed, and `<a>`\n * elements may retain only `href` and `target` attributes. All other markup\n * is stripped via DOMPurify.\n *\n * @param dirty - The raw HTML string to sanitize.\n * @returns An object shaped for `dangerouslySetInnerHTML`. The `__html`\n * field is `''` when the input is empty.\n * @internal\n */\nexport function createMarkup(dirty: string) {\n  if (!dirty) return { __html: '' }\n  return { __html: DOMPurify.sanitize(dirty, dompurifyConfig) }\n}\n\n/**\n * Removes all non-digit characters from a string.\n *\n * @param value - The string to filter.\n * @returns The input with only the digit characters `0`–`9` retained.\n * @internal\n */\nexport const removeNonDigits = (value: string): string => {\n  return value.replace(/\\D/g, '')\n}\n\n/**\n * Strips the trailing `.value` segment from an API error path.\n *\n * @remarks API validation errors target a `.value` field on the inner\n * object, but react-hook-form registers the field under its bare name.\n * Stripping `.value` aligns the error path with the form field name.\n *\n * @param errorKey - The dotted error path returned by the API.\n * @returns The error key without a trailing `.value`.\n * @internal\n */\nexport const normalizeErrorKeyForForm = (errorKey: string): string =>\n  errorKey.replace(/\\.value$/, '')\n\n/**\n * Converts a `snake_case` string to `camelCase`.\n *\n * @param s - The snake_case string to convert.\n * @returns The camelCase equivalent.\n * @internal\n */\nexport const snakeCaseToCamelCase = (s: string) => {\n  return s.replace(/_([a-z])/g, (_: string, char: string) => char.toUpperCase())\n}\n\n/**\n * Converts a `camelCase` or `PascalCase` string to `snake_case`.\n *\n * @remarks Handles consecutive uppercase letters by inserting a separator\n * before the final letter of a run that is followed by a lowercase letter\n * (e.g. `HTMLParser` becomes `html_parser`).\n *\n * @param s - The camelCase or PascalCase string to convert.\n * @returns The snake_case equivalent in lower case.\n * @internal\n */\nexport const camelCaseToSnakeCase = (s: string) => {\n  return s\n    .replace(\n      /([a-z0-9])([A-Z])/g,\n      (_: string, group1: string, group2: string) => `${group1}_${group2.toLowerCase()}`,\n    )\n    .replace(\n      /([A-Z])([A-Z])(?=[a-z])/g,\n      (_: string, group1: string, group2: string) =>\n        `${group1.toLowerCase()}_${group2.toLowerCase()}`,\n    )\n    .toLowerCase()\n}\n\n/**\n * Formats a US phone number as `NNN-NNN-NNNN` for display.\n *\n * @remarks Strips non-digit characters before formatting. A leading `1`\n * country code on 11-digit inputs is dropped. Inputs that are not 10 or 11\n * digits are returned as the raw digit string. Returns an empty string for\n * nullish input.\n *\n * @param phoneNumber - The phone number to format.\n * @returns The formatted phone number, the digit-only fallback, or `''`.\n * @internal\n */\nexport const formatPhoneNumber = (phoneNumber: string | number | null | undefined): string => {\n  if (!phoneNumber) return ''\n\n  const digits = removeNonDigits(String(phoneNumber))\n\n  if (digits.length === 10) {\n    return `${digits.slice(0, 3)}-${digits.slice(3, 6)}-${digits.slice(6)}`\n  }\n\n  if (digits.length === 11 && digits.startsWith('1')) {\n    return `${digits.slice(1, 4)}-${digits.slice(4, 7)}-${digits.slice(7)}`\n  }\n\n  return digits || ''\n}\n"],"names":["capitalize","word","firstLastName","first_name","last_name","maybeString","str","getStreet","address","street1","street2","formatStreetForDisplay","part","getCityStateZip","addressInline","amountStr","amount","isPercentage","formatNumberAsCurrency","locale","formattedNumber","formatPayRate","rate","paymentUnit","t","formatCompensationRate","useFormatCompensationRate","useTranslation","useLocale","useCallback","dompurifyConfig","createMarkup","dirty","DOMPurify","removeNonDigits","value","normalizeErrorKeyForForm","errorKey","snakeCaseToCamelCase","s","_","char","formatPhoneNumber","phoneNumber","digits"],"mappings":"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"}

package/dist/hooks/useCompanyPaymentSpeed.d.ts

@@ -1,4 +1,4 @@
-import { PaymentSpeed } from '@gusto/embedded-api-v-2026-02-01/models/components/paymentconfigs';
+import { PaymentSpeed } from '@gusto/embedded-api/models/components/paymentconfigs';
 /**
  * Extracts the leading day count from a {@link PaymentSpeed} value (e.g. `"2-day"` returns `2`).
  *

package/dist/hooks/useCompanyPaymentSpeed.js

@@ -1,4 +1,4 @@
-import { usePaymentConfigsGet as p } from "@gusto/embedded-api-v-2026-02-01/react-query/paymentConfigsGet";
+import { usePaymentConfigsGet as p } from "@gusto/embedded-api/react-query/paymentConfigsGet";
 const s = 2;
 function a(n) {
   if (!n) return s;

package/dist/hooks/useCompanyPaymentSpeed.js.map

@@ -1 +1 @@
-{"version":3,"file":"useCompanyPaymentSpeed.js","sources":["../../src/hooks/useCompanyPaymentSpeed.ts"],"sourcesContent":["import { usePaymentConfigsGet } from '@gusto/embedded-api-v-2026-02-01/react-query/paymentConfigsGet'\nimport type { PaymentSpeed } from '@gusto/embedded-api-v-2026-02-01/models/components/paymentconfigs'\n\nconst DEFAULT_PAYMENT_SPEED_DAYS = 2\n\n/**\n * Extracts the leading day count from a {@link PaymentSpeed} value (e.g. `\"2-day\"` returns `2`).\n *\n * @remarks\n * Falls back to `2` when the value is missing or cannot be parsed as a positive finite number.\n *\n * @param paymentSpeed - The company's configured payment speed string.\n * @returns The number of payment days as an integer.\n * @internal\n */\nexport function parsePaymentSpeedDays(paymentSpeed?: PaymentSpeed): number {\n  if (!paymentSpeed) return DEFAULT_PAYMENT_SPEED_DAYS\n  const parsed = Number(paymentSpeed.split('-')[0])\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_PAYMENT_SPEED_DAYS\n}\n\n/**\n * Reads a company's configured payment speed and returns it alongside the parsed day count.\n *\n * @param companyUuid - The UUID of the company whose payment configuration to fetch.\n * @returns The raw `paymentSpeed` value from the API and `paymentSpeedDays` parsed via {@link parsePaymentSpeedDays}.\n * @internal\n */\nexport function useCompanyPaymentSpeed(companyUuid: string) {\n  const { data: paymentConfigsResponse } = usePaymentConfigsGet({ companyUuid })\n  const paymentSpeed = paymentConfigsResponse?.paymentConfigs?.paymentSpeed\n  const paymentSpeedDays = parsePaymentSpeedDays(paymentSpeed)\n\n  return {\n    paymentSpeed,\n    paymentSpeedDays,\n  }\n}\n"],"names":["DEFAULT_PAYMENT_SPEED_DAYS","parsePaymentSpeedDays","paymentSpeed","parsed","useCompanyPaymentSpeed","companyUuid","paymentConfigsResponse","usePaymentConfigsGet","paymentSpeedDays"],"mappings":";AAGA,MAAMA,IAA6B;AAY5B,SAASC,EAAsBC,GAAqC;AACzE,MAAI,CAACA,EAAc,QAAOF;AAC1B,QAAMG,IAAS,OAAOD,EAAa,MAAM,GAAG,EAAE,CAAC,CAAC;AAChD,SAAO,OAAO,SAASC,CAAM,KAAKA,IAAS,IAAIA,IAASH;AAC1D;AASO,SAASI,EAAuBC,GAAqB;AAC1D,QAAM,EAAE,MAAMC,EAAA,IAA2BC,EAAqB,EAAE,aAAAF,GAAa,GACvEH,IAAeI,GAAwB,gBAAgB,cACvDE,IAAmBP,EAAsBC,CAAY;AAE3D,SAAO;AAAA,IACL,cAAAA;AAAA,IACA,kBAAAM;AAAA,EAAA;AAEJ;"}
+{"version":3,"file":"useCompanyPaymentSpeed.js","sources":["../../src/hooks/useCompanyPaymentSpeed.ts"],"sourcesContent":["import { usePaymentConfigsGet } from '@gusto/embedded-api/react-query/paymentConfigsGet'\nimport type { PaymentSpeed } from '@gusto/embedded-api/models/components/paymentconfigs'\n\nconst DEFAULT_PAYMENT_SPEED_DAYS = 2\n\n/**\n * Extracts the leading day count from a {@link PaymentSpeed} value (e.g. `\"2-day\"` returns `2`).\n *\n * @remarks\n * Falls back to `2` when the value is missing or cannot be parsed as a positive finite number.\n *\n * @param paymentSpeed - The company's configured payment speed string.\n * @returns The number of payment days as an integer.\n * @internal\n */\nexport function parsePaymentSpeedDays(paymentSpeed?: PaymentSpeed): number {\n  if (!paymentSpeed) return DEFAULT_PAYMENT_SPEED_DAYS\n  const parsed = Number(paymentSpeed.split('-')[0])\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_PAYMENT_SPEED_DAYS\n}\n\n/**\n * Reads a company's configured payment speed and returns it alongside the parsed day count.\n *\n * @param companyUuid - The UUID of the company whose payment configuration to fetch.\n * @returns The raw `paymentSpeed` value from the API and `paymentSpeedDays` parsed via {@link parsePaymentSpeedDays}.\n * @internal\n */\nexport function useCompanyPaymentSpeed(companyUuid: string) {\n  const { data: paymentConfigsResponse } = usePaymentConfigsGet({ companyUuid })\n  const paymentSpeed = paymentConfigsResponse?.paymentConfigs?.paymentSpeed\n  const paymentSpeedDays = parsePaymentSpeedDays(paymentSpeed)\n\n  return {\n    paymentSpeed,\n    paymentSpeedDays,\n  }\n}\n"],"names":["DEFAULT_PAYMENT_SPEED_DAYS","parsePaymentSpeedDays","paymentSpeed","parsed","useCompanyPaymentSpeed","companyUuid","paymentConfigsResponse","usePaymentConfigsGet","paymentSpeedDays"],"mappings":";AAGA,MAAMA,IAA6B;AAY5B,SAASC,EAAsBC,GAAqC;AACzE,MAAI,CAACA,EAAc,QAAOF;AAC1B,QAAMG,IAAS,OAAOD,EAAa,MAAM,GAAG,EAAE,CAAC,CAAC;AAChD,SAAO,OAAO,SAASC,CAAM,KAAKA,IAAS,IAAIA,IAASH;AAC1D;AASO,SAASI,EAAuBC,GAAqB;AAC1D,QAAM,EAAE,MAAMC,EAAA,IAA2BC,EAAqB,EAAE,aAAAF,GAAa,GACvEH,IAAeI,GAAwB,gBAAgB,cACvDE,IAAmBP,EAAsBC,CAAY;AAE3D,SAAO;AAAA,IACL,cAAAA;AAAA,IACA,kBAAAM;AAAA,EAAA;AAEJ;"}

package/dist/i18n/en/Contractor.ContractorList.json.js

@@ -1,28 +1,30 @@
-const t = "Add a contractor", o = "+ Add another contractor", a = "A list of contractors", c = "Edit", n = "Delete", e = "Add contractors to get them setup for payroll.", r = "You haven't added any contractors yet", s = { name: "Name", status: "Status" }, d = "Contractors", i = "Continue", l = "Back to contractors", C = {
+const t = "Add a contractor", o = "+ Add another contractor", a = "A list of contractors", e = "Edit", c = "Review", n = "Delete", r = "Add contractors to get them setup for payroll.", s = "You haven't added any contractors yet", d = { name: "Name", status: "Status" }, i = "Contractors", l = "Continue", C = "Back to contractors", p = {
   addContractorCta: t,
   addAnotherCta: o,
   contractorListLabel: a,
-  editCta: c,
+  editCta: e,
+  reviewCta: c,
   deleteCta: n,
-  emptyTableDescription: e,
-  emptyTableTitle: r,
-  listHeaders: s,
-  title: d,
-  continueCta: i,
-  progressBarCta: l
+  emptyTableDescription: r,
+  emptyTableTitle: s,
+  listHeaders: d,
+  title: i,
+  continueCta: l,
+  progressBarCta: C
 };
 export {
   o as addAnotherCta,
   t as addContractorCta,
-  i as continueCta,
+  l as continueCta,
   a as contractorListLabel,
-  C as default,
+  p as default,
   n as deleteCta,
-  c as editCta,
-  e as emptyTableDescription,
-  r as emptyTableTitle,
-  s as listHeaders,
-  l as progressBarCta,
-  d as title
+  e as editCta,
+  r as emptyTableDescription,
+  s as emptyTableTitle,
+  d as listHeaders,
+  C as progressBarCta,
+  c as reviewCta,
+  i as title
 };
 //# sourceMappingURL=Contractor.ContractorList.json.js.map

package/dist/i18n/en/Contractor.ContractorList.json.js.map

@@ -1 +1 @@
-{"version":3,"file":"Contractor.ContractorList.json.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;"}
+{"version":3,"file":"Contractor.ContractorList.json.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;"}

package/dist/i18n/en/Contractor.DocumentsList.json.js

@@ -1,28 +1,32 @@
-const t = "Documents", n = "Please review and sign your documents.", o = "Documents", e = "Name", s = "Status", c = "Sign document", u = "Not signed", a = "Complete", i = "No documents found", l = "Could not load your documents, try again later.", m = "Continue", d = {
+const t = "Documents", e = "Please review and sign your documents.", n = "Documents", o = "Name", s = "Status", c = "Sign document", a = "Not signed", u = "Complete", i = "W-9 isn't ready to sign yet", l = "The W-9 form hasn't been fully generated yet. Please check back later, or contact support if the problem continues.", d = "No documents found", r = "Could not load your documents, try again later.", m = "Continue", y = {
   title: t,
-  subtitle: n,
-  documentListLabel: o,
-  documentColumnLabel: e,
+  subtitle: e,
+  documentListLabel: n,
+  documentColumnLabel: o,
   statusColumnLabel: s,
   signDocumentCta: c,
-  notSigned: u,
-  signed: a,
-  emptyTitle: i,
-  errorTitle: l,
+  notSigned: a,
+  signed: u,
+  notReadyTitle: i,
+  notReadyBody: l,
+  emptyTitle: d,
+  errorTitle: r,
   continueCta: m
 };
 export {
   m as continueCta,
-  d as default,
-  e as documentColumnLabel,
-  o as documentListLabel,
-  i as emptyTitle,
-  l as errorTitle,
-  u as notSigned,
+  y as default,
+  o as documentColumnLabel,
+  n as documentListLabel,
+  d as emptyTitle,
+  r as errorTitle,
+  l as notReadyBody,
+  i as notReadyTitle,
+  a as notSigned,
   c as signDocumentCta,
-  a as signed,
+  u as signed,
   s as statusColumnLabel,
-  n as subtitle,
+  e as subtitle,
   t as title
 };
 //# sourceMappingURL=Contractor.DocumentsList.json.js.map

package/dist/i18n/en/Contractor.DocumentsList.json.js.map

@@ -1 +1 @@
-{"version":3,"file":"Contractor.DocumentsList.json.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;"}
+{"version":3,"file":"Contractor.DocumentsList.json.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;"}

package/dist/i18n/en/Contractor.SignatureForm.json.js

@@ -1,4 +1,4 @@
-const e = "Signature required", t = "See the IRS Form W-9 for instructions on completing this form", i = "<downloadLink>Download document</downloadLink>", o = { exemptions: "Exemptions", address: "Address", tin: "Taxpayer Identification Number (TIN)", certification: "Certification" }, n = { exemptions: "See section 4 of IRS Form W-9 for instructions.", address: "See sections 5-7 of IRS Form W-9 for instructions.", tin: "For individuals, this is generally your social security number (SSN). For other entities, this will be your employer identification number (EIN).", tinSecondary: "See Part 1 of the IRS Form W-9 for instructions.", certification: "See Part 2 of the IRS Form W-9 for instructions." }, r = "Under penalties of perjury, I certify that:", a = { taxpayerId: "The number shown on this form is my correct taxpayer identification number (or I am waiting for a number to be issued to me);", backupWithholding: "I am not subject to backup withholding because (a) I am exempt from backup withholding, or (b) I have not been notified by the Internal Revenue Service (IRS) that I am subject to backup withholding as a result of a failure to report all interest or dividends, or (c) the IRS has notified me that I am no longer subject to backup withholding;", usPerson: "I am a U.S. citizen or other U.S. person (defined below);", fatca: "The FATCA code(s) entered on this form (if any) indicating that I am exempt from FATCA reporting is correct." }, s = { name: { label: "Entity or individual name (1)", description: "Your individual or business name. For a sole proprietor or disregarded entity, enter the owner's name here, and enter the business/disregarded entity's name in the Business name field below." }, business_name: { label: "Business name (2)", description: "The name of your business, if different than above." }, taxClassification: { label: "Federal tax classification (3)", description: "Select the type of business you are." }, llcClassificationCode: { label: "LLC tax classification code", description: "Select the appropriate code for the LLC, unless it is a disregarded entity. A disregarded entity should instead check the appropriate selection for the tax classification of its owner." }, other_text: { label: "Other" }, foreign_partners: { label: "Foreign partners/owners/beneficiaries (3b)", description: "If you selected “Partnership”, “Trust/Estate” or checked “LLC” and entered “P” as the tax classification, and you are providing this form to a partnership, trust, or estate in which you have an ownership interest, check this box if you have any foreign partners, owners, or beneficiaries." }, exempt_payee_code: { label: "Exempt payee code" }, exemption_from_FATCA: { label: "Exemption from FATCA reporting code (4b)", description: "Enter the code (if any) indicating you are exempt from reporting under the Foreign Account Tax Compliance Act." }, home_address_street_1: { label: "Street 1" }, home_address_street_2: { label: "Street 2" }, home_address_city: { label: "City" }, home_address_state: { label: "State" }, home_address_zip: { label: "Zip code" }, account_number: { label: "Account numbers" }, company_name: { label: "Requester's name and address" }, ssn: { label: "Social Security Number (SSN)" }, ein: { label: "Employer Identification Number (EIN)" }, signature_text: { label: "Signature" } }, c = { taxClassification: { individual_proprietor: "Individual/sole proprietor", c_corporation: "C-Corporation", s_corporation: "S-Corporation", partnership: "Partnership", trust_estate: "Trust/estate", limited_liability_company: "LLC", other: "Other" }, llcClassificationCode: { placeholder: "Select...", c: "C = C-Corporation", s: "S = S-Corporation", p: "P = Partnership" } }, d = "I agree to electronically sign this form.", l = { required: "This field is required.", agreeRequired: "You must agree to electronically sign this form.", invalidSsn: "Enter a valid Social Security Number.", invalidEin: "Enter a valid Employer Identification Number." }, u = "Back", p = "Sign", m = "Signing…", h = "Acknowledge", f = "Acknowledging…", b = {
+const e = "Signature required", t = "See the IRS Form W-9 for instructions on completing this form", i = "<downloadLink>Download document</downloadLink>", o = { exemptions: "Exemptions", address: "Address", tin: "Taxpayer Identification Number (TIN)", certification: "Certification" }, n = { exemptions: "See section 4 of IRS Form W-9 for instructions.", address: "See sections 5-7 of IRS Form W-9 for instructions.", tin: "For individuals, this is generally your social security number (SSN). For other entities, this will be your employer identification number (EIN).", tinSecondary: "See Part 1 of the IRS Form W-9 for instructions.", certification: "See Part 2 of the IRS Form W-9 for instructions." }, r = "Under penalties of perjury, I certify that:", a = { taxpayerId: "The number shown on this form is my correct taxpayer identification number (or I am waiting for a number to be issued to me);", backupWithholding: "I am not subject to backup withholding because (a) I am exempt from backup withholding, or (b) I have not been notified by the Internal Revenue Service (IRS) that I am subject to backup withholding as a result of a failure to report all interest or dividends, or (c) the IRS has notified me that I am no longer subject to backup withholding;", usPerson: "I am a U.S. citizen or other U.S. person (defined below);", usPersonDefinition: "For federal tax purposes, you are considered a U.S. person if you are: an individual who is a U.S. citizen or U.S. resident alien; a partnership, corporation, company, or association created or organized in the United States or under the laws of the United States; an estate (other than a foreign estate); or a domestic trust (as defined in Regulations section 301.7701-7).", fatca: "The FATCA code(s) entered on this form (if any) indicating that I am exempt from FATCA reporting is correct." }, s = { name: { label: "Entity or individual name (1)", description: "Your individual or business name. For a sole proprietor or disregarded entity, enter the owner's name here, and enter the business/disregarded entity's name in the Business name field below." }, business_name: { label: "Business name (2)", description: "The name of your business, if different than above." }, taxClassification: { label: "Federal tax classification (3)", description: "Select the type of business you are." }, llcClassificationCode: { label: "LLC tax classification code", description: "Select the appropriate code for the LLC, unless it is a disregarded entity. A disregarded entity should instead check the appropriate selection for the tax classification of its owner." }, other_text: { label: "Other" }, foreign_partners: { label: "Foreign partners/owners/beneficiaries (3b)", description: "If you selected “Partnership”, “Trust/Estate” or checked “LLC” and entered “P” as the tax classification, and you are providing this form to a partnership, trust, or estate in which you have an ownership interest, check this box if you have any foreign partners, owners, or beneficiaries." }, exempt_payee_code: { label: "Exempt payee code" }, exemption_from_FATCA: { label: "Exemption from FATCA reporting code (4b)", description: "Enter the code (if any) indicating you are exempt from reporting under the Foreign Account Tax Compliance Act." }, home_address_street_1: { label: "Street 1" }, home_address_street_2: { label: "Street 2" }, home_address_city: { label: "City" }, home_address_state: { label: "State" }, home_address_zip: { label: "Zip code" }, account_number: { label: "Account numbers" }, company_name: { label: "Requester's name and address" }, ssn: { label: "Social Security Number (SSN)" }, ein: { label: "Employer Identification Number (EIN)" }, signature_text: { label: "Signature" } }, c = { taxClassification: { individual_proprietor: "Individual/sole proprietor", c_corporation: "C-Corporation", s_corporation: "S-Corporation", partnership: "Partnership", trust_estate: "Trust/estate", limited_liability_company: "LLC", other: "Other" }, llcClassificationCode: { placeholder: "Select...", c: "C = C-Corporation", s: "S = S-Corporation", p: "P = Partnership" } }, d = "I agree to electronically sign this form.", l = { required: "This field is required.", agreeRequired: "You must agree to electronically sign this form.", invalidSsn: "Enter a valid Social Security Number.", invalidEin: "Enter a valid Employer Identification Number." }, u = "Back", p = "Sign", h = "Signing…", m = "Acknowledge", f = "Acknowledging…", b = {
   signatureRequired: e,
   instructions: t,
   downloadPrompt: i,
@@ -12,12 +12,12 @@ const e = "Signature required", t = "See the IRS Form W-9 for instructions on co
   validation: l,
   backCta: u,
   signCta: p,
-  signingCta: m,
-  acknowledgeCta: h,
+  signingCta: h,
+  acknowledgeCta: m,
   acknowledgingCta: f
 };
 export {
-  h as acknowledgeCta,
+  m as acknowledgeCta,
   f as acknowledgingCta,
   d as agreeLabel,
   u as backCta,
@@ -32,7 +32,7 @@ export {
   o as sections,
   p as signCta,
   e as signatureRequired,
-  m as signingCta,
+  h as signingCta,
   l as validation
 };
 //# sourceMappingURL=Contractor.SignatureForm.json.js.map

package/dist/i18n/en/Employee.OnboardingSummary.json.js

@@ -1,30 +1,34 @@
-const e = "Missing Requirements", t = "Please complete the following steps in order to continue.", i = "That's it! {{name}} is ready to get paid!", o = "We'll begin withholding and reporting their taxes.", s = "You've completed setup!", n = "Your account will now be reviewed by your company admin.", r = "Done", d = "New Hire report", a = "Missing requirements", l = "Please complete the following steps in order to continue.", p = { personal_details: "Personal details", compensation_details: "Job and compensation", add_work_address: "Work address", add_home_address: "Home address", federal_tax_setup: "Federal tax details", state_tax_setup: "State tax details", direct_deposit_setup: "Payment method", employee_form_signing: "Employee form signing", file_new_hire_report: "File new hire report", admin_review: "Admin review" }, m = { personal_details: "Basic employee information and their home address.", compensation_details: " What the employee’s role(s) will be and their compensation.", add_work_address: "Work address", add_home_address: "Home address", federal_tax_setup: "Federal tax withholdings.", state_tax_setup: "State tax withholdings", direct_deposit_setup: "How the employee will be paid.", employee_form_signing: "Documents requiring employee signature", file_new_hire_report: "Indicate if new hire report needs to be filed", admin_review: "Admin review" }, _ = {
+const e = "Missing Requirements", t = "Please complete the following steps in order to continue.", i = "That's it! {{name}} is ready to get paid!", s = "We'll begin withholding and reporting their taxes.", o = "{{name}}'s invite is on its way", n = "They'll complete the remaining setup steps on their own.", d = "You've completed setup!", r = "Your account will now be reviewed by your company admin.", a = "Done", l = "New Hire report", p = "Missing requirements", m = "Please complete the following steps in order to continue.", c = { personal_details: "Personal details", compensation_details: "Job and compensation", add_work_address: "Work address", add_home_address: "Home address", federal_tax_setup: "Federal tax details", state_tax_setup: "State tax details", direct_deposit_setup: "Payment method", employee_form_signing: "Employee form signing", file_new_hire_report: "File new hire report", admin_review: "Admin review" }, _ = { personal_details: "Basic employee information and their home address.", compensation_details: " What the employee’s role(s) will be and their compensation.", add_work_address: "Work address", add_home_address: "Home address", federal_tax_setup: "Federal tax withholdings.", state_tax_setup: "State tax withholdings", direct_deposit_setup: "How the employee will be paid.", employee_form_signing: "Documents requiring employee signature", file_new_hire_report: "Indicate if new hire report needs to be filed", admin_review: "Admin review" }, h = {
   subTitle: e,
   description: t,
   onboardedAdminSubtitle: i,
-  onboardedAdminDescription: o,
-  onboardedSelfSubtitle: s,
-  onboardedSelfDescription: n,
-  doneCta: r,
-  newHireReportCta: d,
-  missingRequirementsSubtitle: a,
-  missingRequirementsDescription: l,
-  steps: p,
-  stepsDescriptions: m
+  onboardedAdminDescription: s,
+  handedOffAdminSubtitle: o,
+  handedOffAdminDescription: n,
+  onboardedSelfSubtitle: d,
+  onboardedSelfDescription: r,
+  doneCta: a,
+  newHireReportCta: l,
+  missingRequirementsSubtitle: p,
+  missingRequirementsDescription: m,
+  steps: c,
+  stepsDescriptions: _
 };
 export {
-  _ as default,
+  h as default,
   t as description,
-  r as doneCta,
-  l as missingRequirementsDescription,
-  a as missingRequirementsSubtitle,
-  d as newHireReportCta,
-  o as onboardedAdminDescription,
+  a as doneCta,
+  n as handedOffAdminDescription,
+  o as handedOffAdminSubtitle,
+  m as missingRequirementsDescription,
+  p as missingRequirementsSubtitle,
+  l as newHireReportCta,
+  s as onboardedAdminDescription,
   i as onboardedAdminSubtitle,
-  n as onboardedSelfDescription,
-  s as onboardedSelfSubtitle,
-  p as steps,
-  m as stepsDescriptions,
+  r as onboardedSelfDescription,
+  d as onboardedSelfSubtitle,
+  c as steps,
+  _ as stepsDescriptions,
   e as subTitle
 };
 //# sourceMappingURL=Employee.OnboardingSummary.json.js.map

package/dist/i18n/en/Employee.OnboardingSummary.json.js.map

@@ -1 +1 @@
-{"version":3,"file":"Employee.OnboardingSummary.json.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;"}
+{"version":3,"file":"Employee.OnboardingSummary.json.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;"}