@gusto/embedded-react-sdk 0.36.0 → 0.37.0

package/dist/types/sdkError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdkError.js","sources":["../../src/types/sdkError.ts"],"sourcesContent":["import type { EntityErrorObject } from '@gusto/embedded-api/models/components/entityerrorobject'\nimport { GustoEmbeddedError } from '@gusto/embedded-api/models/errors/gustoembeddederror'\nimport { HTTPClientError } from '@gusto/embedded-api/models/errors/httpclienterrors'\nimport { SDKValidationError } from '@gusto/embedded-api/models/errors/sdkvalidationerror'\nimport { getFieldErrors } from '@/helpers/apiErrorToList'\n\n/**\n * High-level classification of where/how the error originated.\n *\n * - `api_error` — HTTP error response from the Gusto API (422, 404, 409, 500, etc.)\n * - `validation_error` — Client-side Zod schema validation before the request was sent\n * - `network_error` — Network connectivity failure (connection refused, timeout, abort)\n * - `internal_error` — Unexpected runtime error (unhandled exception, initialization failure)\n */\nexport const SDKErrorCategories = {\n  API_ERROR: 'api_error',\n  VALIDATION_ERROR: 'validation_error',\n  NETWORK_ERROR: 'network_error',\n  INTERNAL_ERROR: 'internal_error',\n} as const\n\nexport type SDKErrorCategory = (typeof SDKErrorCategories)[keyof typeof SDKErrorCategories]\n\n/**\n * An error thrown by internal SDK logic that should be caught and normalized\n * by `baseSubmitHandler` rather than propagating to the ErrorBoundary.\n *\n * Use this for guard clauses and data integrity checks inside submit handler\n * callbacks where the error should surface as an inline banner, not a crash.\n *\n * @example\n * ```typescript\n * await baseSubmitHandler(data, async () => {\n *   const response = await createPayroll({ ... })\n *   if (!response.payrollId) {\n *     throw new SDKInternalError('Missing payroll ID in response')\n *   }\n * })\n * ```\n */\nexport class SDKInternalError extends Error {\n  readonly category: SDKErrorCategory\n\n  constructor(message: string, category: SDKErrorCategory = 'internal_error') {\n    super(message)\n    this.name = 'SDKInternalError'\n    this.category = category\n  }\n}\n\n/**\n * A flattened, field-level error extracted from an API response.\n *\n * For API errors with `errors[]`, nested structures are recursively flattened\n * into leaf entries. The `field` property is the dot-separated camelCase path\n * (e.g. `\"states.CA.filingStatus.value\"`).\n */\nexport interface SDKFieldError {\n  /** Dot-separated camelCase field path (e.g. \"firstName\", \"states.CA.filingStatus.value\") */\n  field: string\n  /** API error category (e.g. \"invalid_attribute_value\", \"invalid_operation\", \"payroll_blocker\") */\n  category: string\n  /** Human-readable error message from the API */\n  message: string\n  /** Additional metadata from the API (e.g. `{ key: \"missing_bank_info\" }` for payroll blockers) */\n  metadata?: Record<string, unknown>\n}\n\n/**\n * The unified SDK error type for all error scenarios.\n *\n * This is the core error shape exposed through partner-facing hooks. For\n * observability telemetry (which includes component context), see\n * `ObservabilityError` in `@/types/observability`.\n *\n * @example\n * ```tsx\n * const { error } = useEmployeeForm({ employeeId })\n *\n * if (error) {\n *   console.log(error.category)    // 'api_error'\n *   console.log(error.httpStatus)  // 422\n *   console.log(error.fieldErrors) // [{ field: 'firstName', ... }]\n * }\n * ```\n */\nexport interface SDKError {\n  /** High-level error classification */\n  category: SDKErrorCategory\n\n  /** Human-readable error summary */\n  message: string\n\n  /** HTTP status code (undefined for non-HTTP errors like network or validation) */\n  httpStatus?: number\n\n  /** Flattened field-level errors from API responses. Empty array for non-field errors. */\n  fieldErrors: SDKFieldError[]\n\n  /**\n   * The original error object for advanced use cases.\n   * May be stripped by sanitization (controlled by `sanitization.includeRawError`).\n   */\n  raw?: unknown\n}\n\ninterface ErrorWithErrors {\n  errors: EntityErrorObject[]\n}\n\nfunction hasErrorsArray(error: unknown): error is ErrorWithErrors {\n  return (\n    error !== null &&\n    typeof error === 'object' &&\n    'errors' in error &&\n    Array.isArray((error as ErrorWithErrors).errors)\n  )\n}\n\nfunction toSDKFieldError(entityError: EntityErrorObject): SDKFieldError {\n  return {\n    field: entityError.errorKey,\n    message: entityError.message ?? '',\n    category: entityError.category,\n    metadata: entityError.metadata as Record<string, unknown> | undefined,\n  }\n}\n\n/**\n * Extracts and flattens field errors from an API error's `errors[]` array.\n *\n * Uses the existing `getFieldErrors` recursive traversal for nested errors,\n * with a fallback for errors in categories that `getFieldErrors` doesn't handle.\n */\nfunction extractFieldErrors(errors: EntityErrorObject[]): SDKFieldError[] {\n  const flattened = errors.flatMap(err => getFieldErrors(err))\n  if (flattened.length > 0) {\n    return flattened.map(toSDKFieldError)\n  }\n\n  return errors.filter(err => err.message).map(toSDKFieldError)\n}\n\ninterface RawAPIFieldError {\n  error_key?: string\n  errorKey?: string\n  category: string\n  message?: string\n  metadata?: Record<string, unknown>\n}\n\nfunction rawToEntityError(raw: RawAPIFieldError): EntityErrorObject {\n  return {\n    errorKey: raw.errorKey ?? raw.error_key ?? '',\n    category: raw.category,\n    message: raw.message,\n    metadata: raw.metadata,\n  }\n}\n\nfunction tryExtractFieldErrorsFromBody(body: string | undefined): SDKFieldError[] {\n  if (!body) return []\n  try {\n    const parsed: unknown = JSON.parse(body)\n    if (\n      parsed !== null &&\n      typeof parsed === 'object' &&\n      'errors' in parsed &&\n      Array.isArray((parsed as { errors: unknown }).errors)\n    ) {\n      const errors = (parsed as { errors: RawAPIFieldError[] }).errors\n      return errors\n        .filter(err => err.message)\n        .map(rawToEntityError)\n        .map(toSDKFieldError)\n    }\n  } catch {\n    // Body isn't valid JSON\n  }\n  return []\n}\n\nfunction buildApiErrorMessage(fieldErrors: SDKFieldError[], fallbackMessage: string): string {\n  if (fieldErrors.length === 0) {\n    return fallbackMessage\n  }\n  return fieldErrors.length === 1\n    ? '1 field has issues'\n    : `${fieldErrors.length} fields have issues`\n}\n\n/**\n * Normalizes any caught error into a unified `SDKError`.\n *\n * Classification is based purely on the error type:\n * - `SDKInternalError` → uses the error's own `category` (default: `internal_error`)\n * - `GustoEmbeddedError` subclasses → `api_error`\n * - `SDKValidationError` → `validation_error`\n * - `HTTPClientError` subclasses → `network_error`\n * - Everything else → `internal_error`\n */\nexport function normalizeToSDKError(error: unknown): SDKError {\n  if (error instanceof SDKInternalError) {\n    return {\n      category: error.category,\n      message: error.message,\n      fieldErrors: [],\n      raw: error,\n    }\n  }\n\n  if (error instanceof SDKValidationError) {\n    return {\n      category: 'validation_error',\n      message: typeof error.rawMessage === 'string' ? error.rawMessage : error.message,\n      fieldErrors: [],\n      raw: error,\n    }\n  }\n\n  if (error instanceof HTTPClientError) {\n    return {\n      category: 'network_error',\n      message: error.message,\n      fieldErrors: [],\n      raw: error,\n    }\n  }\n\n  if (error instanceof GustoEmbeddedError) {\n    const httpStatus = error.httpMeta.response.status\n    const fieldErrors = hasErrorsArray(error)\n      ? extractFieldErrors(error.errors)\n      : tryExtractFieldErrorsFromBody(error.httpMeta.body)\n\n    return {\n      category: 'api_error',\n      message: buildApiErrorMessage(fieldErrors, error.message),\n      httpStatus,\n      fieldErrors,\n      raw: error,\n    }\n  }\n\n  if (error instanceof Error) {\n    return {\n      category: 'internal_error',\n      message: error.message,\n      fieldErrors: [],\n      raw: error,\n    }\n  }\n\n  return {\n    category: 'internal_error',\n    message: 'An unknown error occurred',\n    fieldErrors: [],\n    raw: error,\n  }\n}\n"],"names":["SDKInternalError","message","category","hasErrorsArray","error","toSDKFieldError","entityError","extractFieldErrors","errors","flattened","err","getFieldErrors","rawToEntityError","raw","tryExtractFieldErrorsFromBody","body","parsed","buildApiErrorMessage","fieldErrors","fallbackMessage","normalizeToSDKError","SDKValidationError","HTTPClientError","GustoEmbeddedError","httpStatus"],"mappings":"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"}

package/dist/types/sdkError.test.d.ts

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

package/docs/reference/endpoint-inventory.json

@@ -718,6 +718,55 @@
         "employeeUuid"
       ]
     },
+    "Employee.TerminationFlow": {
+      "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/employees/:employeeId"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/employees/:employeeId/terminations"
+        },
+        {
+          "method": "POST",
+          "path": "/v1/employees/:employeeId/terminations"
+        },
+        {
+          "method": "PUT",
+          "path": "/v1/terminations/:employeeId"
+        },
+        {
+          "method": "POST",
+          "path": "/v1/companies/:companyId/payrolls"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/pay_periods/unprocessed_termination_pay_periods"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/payrolls"
+        },
+        {
+          "method": "DELETE",
+          "path": "/v1/employees/:employeeId/terminations"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/employees"
+        },
+        {
+          "method": "PUT",
+          "path": "/v1/companies/:companyId/payrolls/:payrollId/prepare"
+        }
+      ],
+      "variables": [
+        "companyId",
+        "employeeId",
+        "payrollId"
+      ]
+    },
     "InformationRequests": {
       "endpoints": [
         {
@@ -759,6 +808,26 @@
         "wireInRequestUuid"
       ]
     },
+    "Payroll.DismissalFlow": {
+      "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/payrolls/:payrollId"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/pay_periods/unprocessed_termination_pay_periods"
+        },
+        {
+          "method": "POST",
+          "path": "/v1/companies/:companyId/payrolls"
+        }
+      ],
+      "variables": [
+        "companyId",
+        "payrollId"
+      ]
+    },
     "Payroll.OffCycleFlow": {
       "endpoints": [
         {
@@ -811,10 +880,6 @@
           "method": "GET",
           "path": "/v1/companies/:companyId/payrolls/:payrollId"
         },
-        {
-          "method": "PUT",
-          "path": "/v1/companies/:companyId/payrolls/:payrollId/calculate"
-        },
         {
           "method": "PUT",
           "path": "/v1/companies/:companyId/payrolls/:payrollId"
@@ -827,6 +892,10 @@
           "method": "GET",
           "path": "/v1/companies/:companyUuid/payrolls/blockers"
         },
+        {
+          "method": "PUT",
+          "path": "/v1/companies/:companyId/payrolls/:payrollId/calculate"
+        },
         {
           "method": "GET",
           "path": "/v1/companies/:companyId/employees"
@@ -1003,7 +1072,7 @@
         "recoveryCaseUuid"
       ]
     },
-    "Payroll.UNSTABLE_PayrollHooks": {
+    "Payroll.TransitionFlow": {
       "endpoints": [
         {
           "method": "GET",
@@ -1014,6 +1083,133 @@
         "companyId",
         "payrollId"
       ]
+    },
+    "Payroll.TransitionCreation": {
+      "endpoints": [
+        {
+          "method": "POST",
+          "path": "/v1/companies/:companyId/payrolls"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/pay_schedules"
+        }
+      ],
+      "variables": [
+        "companyId"
+      ]
+    },
+    "Payroll.TransitionPayrollAlert": {
+      "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/pay_periods"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/pay_schedules"
+        },
+        {
+          "method": "POST",
+          "path": "/v1/companies/:companyUuid/payrolls/skip"
+        }
+      ],
+      "variables": [
+        "companyId",
+        "companyUuid"
+      ]
+    },
+    "UNSTABLE_Hooks.hooks.useCompensationForm": {
+      "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/employees/:employeeId/jobs"
+        },
+        {
+          "method": "POST",
+          "path": "/v1/employees/:employeeId/jobs"
+        },
+        {
+          "method": "PUT",
+          "path": "/v1/jobs/:jobId"
+        },
+        {
+          "method": "PUT",
+          "path": "/v1/compensations/:compensationId"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/locations/:locationUuid/minimum_wages"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/employees/:employeeId/work_addresses"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/employees/:employeeId"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/federal_tax_details"
+        }
+      ],
+      "variables": [
+        "companyId",
+        "compensationId",
+        "employeeId",
+        "jobId",
+        "locationUuid"
+      ]
+    },
+    "UNSTABLE_Hooks.hooks.useEmployeeDetailsForm": {
+      "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/employees/:employeeId"
+        },
+        {
+          "method": "POST",
+          "path": "/v1/companies/:companyId/employees"
+        },
+        {
+          "method": "PUT",
+          "path": "/v1/employees/:employeeId"
+        },
+        {
+          "method": "PUT",
+          "path": "/v1/employees/:employeeId/onboarding_status"
+        }
+      ],
+      "variables": [
+        "companyId",
+        "employeeId"
+      ]
+    },
+    "UNSTABLE_Hooks.hooks.useWorkAddressForm": {
+      "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyId/locations"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/employees/:employeeId/work_addresses"
+        },
+        {
+          "method": "POST",
+          "path": "/v1/employees/:employeeId/work_addresses"
+        },
+        {
+          "method": "PUT",
+          "path": "/v1/work_addresses/:workAddressUuid"
+        }
+      ],
+      "variables": [
+        "companyId",
+        "employeeId",
+        "workAddressUuid"
+      ]
     }
   },
   "flows": {
@@ -1608,12 +1804,14 @@
     "Payroll.PayrollFlow": {
       "blocks": [
         "Payroll.ConfirmWireDetails",
+        "Payroll.OffCycleFlow",
         "Payroll.PayrollBlocker",
         "Payroll.PayrollConfiguration",
         "Payroll.PayrollEditEmployee",
         "Payroll.PayrollLanding",
         "Payroll.PayrollOverview",
-        "Payroll.PayrollReceipts"
+        "Payroll.PayrollReceipts",
+        "Payroll.TransitionFlow"
       ],
       "endpoints": [
         {
@@ -1634,23 +1832,19 @@
         },
         {
           "method": "GET",
-          "path": "/v1/companies/:companyUuid/payrolls/blockers"
+          "path": "/v1/companies/:companyId/payrolls/:payrollId"
         },
         {
           "method": "GET",
-          "path": "/v1/companies/:companyUuid/recovery_cases"
+          "path": "/v1/companies/:companyUuid/payrolls/blockers"
         },
         {
           "method": "GET",
-          "path": "/v1/companies/:companyUuid/information_requests"
+          "path": "/v1/companies/:companyUuid/recovery_cases"
         },
         {
           "method": "GET",
-          "path": "/v1/companies/:companyId/payrolls/:payrollId"
-        },
-        {
-          "method": "PUT",
-          "path": "/v1/companies/:companyId/payrolls/:payrollId/calculate"
+          "path": "/v1/companies/:companyUuid/information_requests"
         },
         {
           "method": "PUT",
@@ -1660,6 +1854,10 @@
           "method": "POST",
           "path": "/v1/payrolls/:payrollUuid/gross_up"
         },
+        {
+          "method": "PUT",
+          "path": "/v1/companies/:companyId/payrolls/:payrollId/calculate"
+        },
         {
           "method": "GET",
           "path": "/v1/companies/:companyId/employees"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gusto/embedded-react-sdk",
-  "version": "0.36.0",
+  "version": "0.37.0",
   "homepage": "https://github.com/Gusto/embedded-react-sdk",
   "bugs": {
     "url": "https://github.com/Gusto/embedded-react-sdk/issues"
@@ -81,11 +81,11 @@
     "@commitlint/config-conventional": "^20.5.0",
     "@eslint/js": "^9.39.2",
     "@playwright/test": "^1.58.2",
-    "@storybook/addon-a11y": "^10.2.19",
-    "@storybook/addon-docs": "^10.2.19",
-    "@storybook/addon-onboarding": "^10.2.19",
-    "@storybook/react-vite": "^10.2.19",
-    "@storybook/test-runner": "^0.24.2",
+    "@storybook/addon-a11y": "^10.3.3",
+    "@storybook/addon-docs": "^10.3.3",
+    "@storybook/addon-onboarding": "^10.3.3",
+    "@storybook/react-vite": "^10.3.1",
+    "@storybook/test-runner": "^0.24.3",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
     "@testing-library/user-event": "^14.6.1",
@@ -95,7 +95,7 @@
     "@types/pngjs": "^6.0.5",
     "@types/react": "^19.2.14",
     "@vitejs/plugin-react-swc": "^4.3.0",
-    "@vitest/coverage-v8": "^4.1.0",
+    "@vitest/coverage-v8": "^4.1.1",
     "axe-core": "^4.11.1",
     "dotenv": "^17.3.1",
     "eslint": "^9.39.4",
@@ -104,7 +104,7 @@
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^6.1.1",
     "eslint-plugin-react-refresh": "^0.4.24",
-    "eslint-plugin-storybook": "^10.2.19",
+    "eslint-plugin-storybook": "^10.3.3",
     "globals": "^17.4.0",
     "husky": "^9.1.7",
     "jest-axe": "^9.0.0",
@@ -112,7 +112,7 @@
     "jsdom": "^26.1.0",
     "jsdom-testing-mocks": "^1.16.0",
     "lint-staged": "^16.4.0",
-    "msw": "^2.12.12",
+    "msw": "^2.12.14",
     "npm-run-all": "^4.1.5",
     "pixelmatch": "^7.1.0",
     "pngjs": "^7.0.0",
@@ -120,7 +120,7 @@
     "react-dnd": "^16.0.1",
     "react-dnd-html5-backend": "^16.0.1",
     "sass-embedded": "^1.98.0",
-    "storybook": "^10.2.19",
+    "storybook": "^10.3.1",
     "stylelint-config-standard": "^40.0.0",
     "ts-morph": "^27.0.2",
     "tsx": "^4.21.0",
@@ -130,7 +130,7 @@
     "vite-plugin-circular-dependency": "^0.5.0",
     "vite-plugin-dts": "^4.5.3",
     "vite-plugin-externalize-deps": "^0.10.0",
-    "vite-plugin-stylelint": "^6.0.4",
+    "vite-plugin-stylelint": "^6.1.0",
     "vite-plugin-svgr": "^4.3.0",
     "vitest": "^4.1.0"
   },
@@ -141,7 +141,7 @@
     "typescript": "^5.8.3"
   },
   "dependencies": {
-    "@gusto/embedded-api": "^0.12.4",
+    "@gusto/embedded-api": "0.12.4",
     "@hookform/error-message": "^2.0.1",
     "@hookform/resolvers": "^5.2.2",
     "@internationalized/date": "^3.12.0",
@@ -149,13 +149,13 @@
     "classnames": "^2.5.1",
     "deepmerge": "^4.3.1",
     "dompurify": "^3.3.3",
-    "i18next": "^25.8.18",
+    "i18next": "^25.10.4",
     "react-aria": "^3.44.0",
     "react-aria-components": "1.13.0",
     "react-error-boundary": "^6.1.1",
-    "react-hook-form": "^7.71.2",
-    "react-i18next": "^16.5.8",
-    "react-robot": "^1.2.0",
+    "react-hook-form": "^7.72.0",
+    "react-i18next": "^16.6.6",
+    "react-robot": "^1.2.1",
     "robot3": "^1.2.0",
     "zod": "^4.3.6"
   },

package/dist/components/Payroll/UNSTABLE_PayrollHooks/PayrollConfiguration/PayrollConfiguration.d.ts

@@ -1,6 +0,0 @@
-interface PayrollConfigurationProps {
-    companyId: string;
-    payrollId: string;
-}
-declare function ComposedPayrollConfiguration({ companyId, payrollId }: PayrollConfigurationProps): import("react/jsx-runtime").JSX.Element;
-export { ComposedPayrollConfiguration as PayrollConfiguration };

package/dist/components/Payroll/UNSTABLE_PayrollHooks/PayrollConfiguration/PayrollConfiguration.js

@@ -1,70 +0,0 @@
-import { jsx as r, jsxs as o } from "react/jsx-runtime";
-import { PayrollConfigurationProvider as c } from "./PayrollConfigurationProvider.js";
-import { usePayrollConfiguration as s } from "./usePayrollConfiguration.js";
-import { useDateFormatter as h } from "../../../../hooks/useDateFormatter.js";
-import m from "../../../../hooks/useNumberFormatter.js";
-import { useComponentContext as y } from "../../../../contexts/ComponentAdapter/useComponentContext.js";
-function u() {
-  const { payrollData: l } = s(), a = h(), n = m("currency"), { Heading: i, Text: t } = y(), e = l.payrollShow, d = a.formatWithTime(e?.payrollDeadline);
-  return /* @__PURE__ */ o("div", { children: [
-    /* @__PURE__ */ r(i, { as: "h1", children: "Payroll Configuration (Experimental)" }),
-    e && /* @__PURE__ */ o("div", { children: [
-      /* @__PURE__ */ r(i, { as: "h2", children: "Payroll Details" }),
-      /* @__PURE__ */ o(t, { children: [
-        /* @__PURE__ */ r("strong", { children: "Check Date:" }),
-        " ",
-        a.formatShortWithWeekday(e.checkDate)
-      ] }),
-      /* @__PURE__ */ o(t, { children: [
-        /* @__PURE__ */ r("strong", { children: "Pay Period:" }),
-        " ",
-        a.formatPayPeriodRange(
-          e.payPeriod?.startDate,
-          e.payPeriod?.endDate
-        )
-      ] }),
-      /* @__PURE__ */ o(t, { children: [
-        /* @__PURE__ */ r("strong", { children: "Payroll Deadline:" }),
-        " ",
-        d.date,
-        " at ",
-        d.time
-      ] }),
-      /* @__PURE__ */ o(t, { children: [
-        /* @__PURE__ */ r("strong", { children: "Calculated At:" }),
-        " ",
-        e.calculatedAt ? a.formatShortWithWeekday(e.calculatedAt) : "Not yet calculated"
-      ] }),
-      /* @__PURE__ */ o(t, { children: [
-        /* @__PURE__ */ r("strong", { children: "Off Cycle:" }),
-        " ",
-        e.offCycle ? "Yes" : "No"
-      ] }),
-      e.totals && /* @__PURE__ */ o("div", { children: [
-        /* @__PURE__ */ r(i, { as: "h3", children: "Totals" }),
-        /* @__PURE__ */ o(t, { children: [
-          /* @__PURE__ */ r("strong", { children: "Net Pay Debit:" }),
-          " ",
-          n(Number(e.totals.netPayDebit ?? 0))
-        ] }),
-        /* @__PURE__ */ o(t, { children: [
-          /* @__PURE__ */ r("strong", { children: "Employee Taxes:" }),
-          " ",
-          n(Number(e.totals.employeeTaxes ?? 0))
-        ] }),
-        /* @__PURE__ */ o(t, { children: [
-          /* @__PURE__ */ r("strong", { children: "Employer Taxes:" }),
-          " ",
-          n(Number(e.totals.employerTaxes ?? 0))
-        ] })
-      ] })
-    ] })
-  ] });
-}
-function x({ companyId: l, payrollId: a }) {
-  return /* @__PURE__ */ r(c, { companyId: l, payrollId: a, children: /* @__PURE__ */ r(u, {}) });
-}
-export {
-  x as PayrollConfiguration
-};
-//# sourceMappingURL=PayrollConfiguration.js.map

package/dist/components/Payroll/UNSTABLE_PayrollHooks/PayrollConfiguration/PayrollConfiguration.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"PayrollConfiguration.js","sources":["../../../../../src/components/Payroll/UNSTABLE_PayrollHooks/PayrollConfiguration/PayrollConfiguration.tsx"],"sourcesContent":["import { PayrollConfigurationProvider } from './PayrollConfigurationProvider'\nimport { usePayrollConfiguration } from './usePayrollConfiguration'\nimport { useDateFormatter } from '@/hooks/useDateFormatter'\nimport useNumberFormatter from '@/hooks/useNumberFormatter'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\n\ninterface PayrollConfigurationProps {\n  companyId: string\n  payrollId: string\n}\n\nfunction PayrollConfiguration() {\n  const { payrollData } = usePayrollConfiguration()\n  const dateFormatter = useDateFormatter()\n  const formatCurrency = useNumberFormatter('currency')\n  const { Heading, Text } = useComponentContext()\n\n  const payroll = payrollData.payrollShow\n\n  const payrollDeadline = dateFormatter.formatWithTime(payroll?.payrollDeadline)\n\n  return (\n    <div>\n      <Heading as=\"h1\">Payroll Configuration (Experimental)</Heading>\n      {payroll && (\n        <div>\n          <Heading as=\"h2\">Payroll Details</Heading>\n          <Text>\n            <strong>Check Date:</strong> {dateFormatter.formatShortWithWeekday(payroll.checkDate)}\n          </Text>\n          <Text>\n            <strong>Pay Period:</strong>{' '}\n            {dateFormatter.formatPayPeriodRange(\n              payroll.payPeriod?.startDate,\n              payroll.payPeriod?.endDate,\n            )}\n          </Text>\n          <Text>\n            <strong>Payroll Deadline:</strong> {payrollDeadline.date} at {payrollDeadline.time}\n          </Text>\n          <Text>\n            <strong>Calculated At:</strong>{' '}\n            {payroll.calculatedAt\n              ? dateFormatter.formatShortWithWeekday(payroll.calculatedAt)\n              : 'Not yet calculated'}\n          </Text>\n          <Text>\n            <strong>Off Cycle:</strong> {payroll.offCycle ? 'Yes' : 'No'}\n          </Text>\n          {payroll.totals && (\n            <div>\n              <Heading as=\"h3\">Totals</Heading>\n              <Text>\n                <strong>Net Pay Debit:</strong>{' '}\n                {formatCurrency(Number(payroll.totals.netPayDebit ?? 0))}\n              </Text>\n              <Text>\n                <strong>Employee Taxes:</strong>{' '}\n                {formatCurrency(Number(payroll.totals.employeeTaxes ?? 0))}\n              </Text>\n              <Text>\n                <strong>Employer Taxes:</strong>{' '}\n                {formatCurrency(Number(payroll.totals.employerTaxes ?? 0))}\n              </Text>\n            </div>\n          )}\n        </div>\n      )}\n    </div>\n  )\n}\n\nfunction ComposedPayrollConfiguration({ companyId, payrollId }: PayrollConfigurationProps) {\n  return (\n    <PayrollConfigurationProvider companyId={companyId} payrollId={payrollId}>\n      <PayrollConfiguration />\n    </PayrollConfigurationProvider>\n  )\n}\n\nexport { ComposedPayrollConfiguration as PayrollConfiguration }\n"],"names":["PayrollConfiguration","payrollData","usePayrollConfiguration","dateFormatter","useDateFormatter","formatCurrency","useNumberFormatter","Heading","Text","useComponentContext","payroll","payrollDeadline","jsx","jsxs","ComposedPayrollConfiguration","companyId","payrollId","PayrollConfigurationProvider"],"mappings":";;;;;;AAWA,SAASA,IAAuB;AAC9B,QAAM,EAAE,aAAAC,EAAA,IAAgBC,EAAA,GAClBC,IAAgBC,EAAA,GAChBC,IAAiBC,EAAmB,UAAU,GAC9C,EAAE,SAAAC,GAAS,MAAAC,EAAA,IAASC,EAAA,GAEpBC,IAAUT,EAAY,aAEtBU,IAAkBR,EAAc,eAAeO,GAAS,eAAe;AAE7E,2BACG,OAAA,EACC,UAAA;AAAA,IAAA,gBAAAE,EAACL,GAAA,EAAQ,IAAG,MAAK,UAAA,wCAAoC;AAAA,IACpDG,uBACE,OAAA,EACC,UAAA;AAAA,MAAA,gBAAAE,EAACL,GAAA,EAAQ,IAAG,MAAK,UAAA,mBAAe;AAAA,wBAC/BC,GAAA,EACC,UAAA;AAAA,QAAA,gBAAAI,EAAC,YAAO,UAAA,cAAA,CAAW;AAAA,QAAS;AAAA,QAAET,EAAc,uBAAuBO,EAAQ,SAAS;AAAA,MAAA,GACtF;AAAA,wBACCF,GAAA,EACC,UAAA;AAAA,QAAA,gBAAAI,EAAC,YAAO,UAAA,cAAA,CAAW;AAAA,QAAU;AAAA,QAC5BT,EAAc;AAAA,UACbO,EAAQ,WAAW;AAAA,UACnBA,EAAQ,WAAW;AAAA,QAAA;AAAA,MACrB,GACF;AAAA,wBACCF,GAAA,EACC,UAAA;AAAA,QAAA,gBAAAI,EAAC,YAAO,UAAA,oBAAA,CAAiB;AAAA,QAAS;AAAA,QAAED,EAAgB;AAAA,QAAK;AAAA,QAAKA,EAAgB;AAAA,MAAA,GAChF;AAAA,wBACCH,GAAA,EACC,UAAA;AAAA,QAAA,gBAAAI,EAAC,YAAO,UAAA,iBAAA,CAAc;AAAA,QAAU;AAAA,QAC/BF,EAAQ,eACLP,EAAc,uBAAuBO,EAAQ,YAAY,IACzD;AAAA,MAAA,GACN;AAAA,wBACCF,GAAA,EACC,UAAA;AAAA,QAAA,gBAAAI,EAAC,YAAO,UAAA,aAAA,CAAU;AAAA,QAAS;AAAA,QAAEF,EAAQ,WAAW,QAAQ;AAAA,MAAA,GAC1D;AAAA,MACCA,EAAQ,UACP,gBAAAG,EAAC,OAAA,EACC,UAAA;AAAA,QAAA,gBAAAD,EAACL,GAAA,EAAQ,IAAG,MAAK,UAAA,UAAM;AAAA,0BACtBC,GAAA,EACC,UAAA;AAAA,UAAA,gBAAAI,EAAC,YAAO,UAAA,iBAAA,CAAc;AAAA,UAAU;AAAA,UAC/BP,EAAe,OAAOK,EAAQ,OAAO,eAAe,CAAC,CAAC;AAAA,QAAA,GACzD;AAAA,0BACCF,GAAA,EACC,UAAA;AAAA,UAAA,gBAAAI,EAAC,YAAO,UAAA,kBAAA,CAAe;AAAA,UAAU;AAAA,UAChCP,EAAe,OAAOK,EAAQ,OAAO,iBAAiB,CAAC,CAAC;AAAA,QAAA,GAC3D;AAAA,0BACCF,GAAA,EACC,UAAA;AAAA,UAAA,gBAAAI,EAAC,YAAO,UAAA,kBAAA,CAAe;AAAA,UAAU;AAAA,UAChCP,EAAe,OAAOK,EAAQ,OAAO,iBAAiB,CAAC,CAAC;AAAA,QAAA,EAAA,CAC3D;AAAA,MAAA,EAAA,CACF;AAAA,IAAA,EAAA,CAEJ;AAAA,EAAA,GAEJ;AAEJ;AAEA,SAASI,EAA6B,EAAE,WAAAC,GAAW,WAAAC,KAAwC;AACzF,2BACGC,GAAA,EAA6B,WAAAF,GAAsB,WAAAC,GAClD,UAAA,gBAAAJ,EAACZ,KAAqB,GACxB;AAEJ;"}

package/dist/components/Payroll/UNSTABLE_PayrollHooks/PayrollConfiguration/PayrollConfigurationContext.d.ts

@@ -1,7 +0,0 @@
-import { PayrollShow } from '@gusto/embedded-api/models/components/payroll';
-export interface PayrollConfigurationContextValue {
-    payrollData: {
-        payrollShow?: PayrollShow | null;
-    };
-}
-export declare const PayrollConfigurationContext: import('react').Context<PayrollConfigurationContextValue | undefined>;

package/dist/components/Payroll/UNSTABLE_PayrollHooks/PayrollConfiguration/PayrollConfigurationContext.js

@@ -1,6 +0,0 @@
-import { createContext as o } from "react";
-const r = o(void 0);
-export {
-  r as PayrollConfigurationContext
-};
-//# sourceMappingURL=PayrollConfigurationContext.js.map

package/dist/components/Payroll/UNSTABLE_PayrollHooks/PayrollConfiguration/PayrollConfigurationContext.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"PayrollConfigurationContext.js","sources":["../../../../../src/components/Payroll/UNSTABLE_PayrollHooks/PayrollConfiguration/PayrollConfigurationContext.ts"],"sourcesContent":["import { createContext } from 'react'\nimport type { PayrollShow } from '@gusto/embedded-api/models/components/payroll'\n\nexport interface PayrollConfigurationContextValue {\n  payrollData: {\n    payrollShow?: PayrollShow | null\n  }\n}\n\nexport const PayrollConfigurationContext = createContext<\n  PayrollConfigurationContextValue | undefined\n>(undefined)\n"],"names":["PayrollConfigurationContext","createContext"],"mappings":";AASO,MAAMA,IAA8BC,EAEzC,MAAS;"}

package/dist/components/Payroll/UNSTABLE_PayrollHooks/PayrollConfiguration/PayrollConfigurationProvider.d.ts

@@ -1,9 +0,0 @@
-import { ReactNode } from 'react';
-import { BaseBoundariesProps } from '../../../Base/Base';
-export interface PayrollConfigurationProviderProps extends BaseBoundariesProps {
-    companyId: string;
-    payrollId: string;
-    children: ReactNode;
-}
-declare function ComposedPayrollConfigurationProvider({ companyId, payrollId, children, FallbackComponent, LoaderComponent, onErrorBoundaryError, }: PayrollConfigurationProviderProps): import("react/jsx-runtime").JSX.Element;
-export { ComposedPayrollConfigurationProvider as PayrollConfigurationProvider };

package/dist/components/Payroll/UNSTABLE_PayrollHooks/PayrollConfiguration/PayrollConfigurationProvider.js

@@ -1,40 +0,0 @@
-import { jsx as i } from "react/jsx-runtime";
-import { usePayrollsGetSuspense as l } from "@gusto/embedded-api/react-query/payrollsGet";
-import { PayrollConfigurationContext as u } from "./PayrollConfigurationContext.js";
-import { BaseBoundaries as s } from "../../../Base/Base.js";
-function d({
-  companyId: o,
-  payrollId: r,
-  children: t
-}) {
-  const { data: e } = l({
-    companyId: o,
-    payrollId: r,
-    include: ["taxes", "benefits", "deductions"]
-  }), n = {
-    payrollData: e
-  };
-  return /* @__PURE__ */ i(u.Provider, { value: n, children: t });
-}
-function p({
-  companyId: o,
-  payrollId: r,
-  children: t,
-  FallbackComponent: e,
-  LoaderComponent: n,
-  onErrorBoundaryError: a
-}) {
-  return /* @__PURE__ */ i(
-    s,
-    {
-      FallbackComponent: e,
-      LoaderComponent: n,
-      onErrorBoundaryError: a,
-      children: /* @__PURE__ */ i(d, { companyId: o, payrollId: r, children: t })
-    }
-  );
-}
-export {
-  p as PayrollConfigurationProvider
-};
-//# sourceMappingURL=PayrollConfigurationProvider.js.map

package/dist/components/Payroll/UNSTABLE_PayrollHooks/PayrollConfiguration/PayrollConfigurationProvider.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"PayrollConfigurationProvider.js","sources":["../../../../../src/components/Payroll/UNSTABLE_PayrollHooks/PayrollConfiguration/PayrollConfigurationProvider.tsx"],"sourcesContent":["import type { ReactNode } from 'react'\nimport { usePayrollsGetSuspense } from '@gusto/embedded-api/react-query/payrollsGet'\nimport {\n  PayrollConfigurationContext,\n  type PayrollConfigurationContextValue,\n} from './PayrollConfigurationContext'\nimport { BaseBoundaries, type BaseBoundariesProps } from '@/components/Base/Base'\n\nexport interface PayrollConfigurationProviderProps extends BaseBoundariesProps {\n  companyId: string\n  payrollId: string\n  children: ReactNode\n}\n\nfunction PayrollConfigurationProvider({\n  companyId,\n  payrollId,\n  children,\n}: PayrollConfigurationProviderProps) {\n  const { data: payrollData } = usePayrollsGetSuspense({\n    companyId,\n    payrollId,\n    include: ['taxes', 'benefits', 'deductions'],\n  })\n\n  const contextValue: PayrollConfigurationContextValue = {\n    payrollData,\n  }\n\n  return (\n    <PayrollConfigurationContext.Provider value={contextValue}>\n      {children}\n    </PayrollConfigurationContext.Provider>\n  )\n}\n\nfunction ComposedPayrollConfigurationProvider({\n  companyId,\n  payrollId,\n  children,\n  FallbackComponent,\n  LoaderComponent,\n  onErrorBoundaryError,\n}: PayrollConfigurationProviderProps) {\n  return (\n    <BaseBoundaries\n      FallbackComponent={FallbackComponent}\n      LoaderComponent={LoaderComponent}\n      onErrorBoundaryError={onErrorBoundaryError}\n    >\n      <PayrollConfigurationProvider companyId={companyId} payrollId={payrollId}>\n        {children}\n      </PayrollConfigurationProvider>\n    </BaseBoundaries>\n  )\n}\n\nexport { ComposedPayrollConfigurationProvider as PayrollConfigurationProvider }\n"],"names":["PayrollConfigurationProvider","companyId","payrollId","children","payrollData","usePayrollsGetSuspense","contextValue","PayrollConfigurationContext","ComposedPayrollConfigurationProvider","FallbackComponent","LoaderComponent","onErrorBoundaryError","jsx","BaseBoundaries"],"mappings":";;;;AAcA,SAASA,EAA6B;AAAA,EACpC,WAAAC;AAAA,EACA,WAAAC;AAAA,EACA,UAAAC;AACF,GAAsC;AACpC,QAAM,EAAE,MAAMC,EAAA,IAAgBC,EAAuB;AAAA,IACnD,WAAAJ;AAAA,IACA,WAAAC;AAAA,IACA,SAAS,CAAC,SAAS,YAAY,YAAY;AAAA,EAAA,CAC5C,GAEKI,IAAiD;AAAA,IACrD,aAAAF;AAAA,EAAA;AAGF,2BACGG,EAA4B,UAA5B,EAAqC,OAAOD,GAC1C,UAAAH,GACH;AAEJ;AAEA,SAASK,EAAqC;AAAA,EAC5C,WAAAP;AAAA,EACA,WAAAC;AAAA,EACA,UAAAC;AAAA,EACA,mBAAAM;AAAA,EACA,iBAAAC;AAAA,EACA,sBAAAC;AACF,GAAsC;AACpC,SACE,gBAAAC;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,mBAAAJ;AAAA,MACA,iBAAAC;AAAA,MACA,sBAAAC;AAAA,MAEA,UAAA,gBAAAC,EAACZ,GAAA,EAA6B,WAAAC,GAAsB,WAAAC,GACjD,UAAAC,EAAA,CACH;AAAA,IAAA;AAAA,EAAA;AAGN;"}

package/dist/components/Payroll/UNSTABLE_PayrollHooks/PayrollConfiguration/index.d.ts

@@ -1,5 +0,0 @@
-import "./types/i18next.d.ts"
-export { PayrollConfiguration } from './PayrollConfiguration';
-export { PayrollConfigurationProvider } from './PayrollConfigurationProvider';
-export { usePayrollConfiguration } from './usePayrollConfiguration';
-export type { PayrollConfigurationContextValue } from './PayrollConfigurationContext';

package/dist/components/Payroll/UNSTABLE_PayrollHooks/PayrollConfiguration/usePayrollConfiguration.d.ts

@@ -1,2 +0,0 @@
-import { PayrollConfigurationContextValue } from './PayrollConfigurationContext';
-export declare function usePayrollConfiguration(): PayrollConfigurationContextValue;

package/dist/components/Payroll/UNSTABLE_PayrollHooks/PayrollConfiguration/usePayrollConfiguration.js

@@ -1,12 +0,0 @@
-import { useContext as r } from "react";
-import { PayrollConfigurationContext as t } from "./PayrollConfigurationContext.js";
-function e() {
-  const o = r(t);
-  if (o === void 0)
-    throw new Error("usePayrollConfiguration must be used within a PayrollConfigurationProvider");
-  return o;
-}
-export {
-  e as usePayrollConfiguration
-};
-//# sourceMappingURL=usePayrollConfiguration.js.map

package/dist/components/Payroll/UNSTABLE_PayrollHooks/PayrollConfiguration/usePayrollConfiguration.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"usePayrollConfiguration.js","sources":["../../../../../src/components/Payroll/UNSTABLE_PayrollHooks/PayrollConfiguration/usePayrollConfiguration.ts"],"sourcesContent":["import { useContext } from 'react'\nimport {\n  PayrollConfigurationContext,\n  type PayrollConfigurationContextValue,\n} from './PayrollConfigurationContext'\n\nexport function usePayrollConfiguration(): PayrollConfigurationContextValue {\n  const context = useContext(PayrollConfigurationContext)\n  if (context === undefined) {\n    throw new Error('usePayrollConfiguration must be used within a PayrollConfigurationProvider')\n  }\n  return context\n}\n"],"names":["usePayrollConfiguration","context","useContext","PayrollConfigurationContext"],"mappings":";;AAMO,SAASA,IAA4D;AAC1E,QAAMC,IAAUC,EAAWC,CAA2B;AACtD,MAAIF,MAAY;AACd,UAAM,IAAI,MAAM,4EAA4E;AAE9F,SAAOA;AACT;"}

package/dist/components/Payroll/UNSTABLE_PayrollHooks/index.d.ts

@@ -1,2 +0,0 @@
-import "./types/i18next.d.ts"
-export { PayrollConfiguration, PayrollConfigurationProvider, usePayrollConfiguration, type PayrollConfigurationContextValue, } from './PayrollConfiguration';

package/dist/contexts/ObservabilityProvider/observabilityUtils.d.ts

@@ -1,5 +0,0 @@
-import { ObservabilityError, ObservabilityErrorType } from '../../types/observability';
-/**
- * Converts SDK errors into structured ObservabilityError objects
- */
-export declare function createObservabilityError(error: unknown, type?: ObservabilityErrorType): ObservabilityError | null;