@gusto/embedded-react-sdk 0.53.0 → 0.54.0

package/docs/guides/endpoint-inventory.json

@@ -2179,6 +2179,125 @@
         "contractorUuid"
       ]
     },
+    "ContractorManagement.DashboardFlow": {
+      "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/contractors/:contractorUuid",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-contractors-contractor_uuid"
+        }
+      ],
+      "variables": [
+        "contractorUuid"
+      ]
+    },
+    "ContractorManagement.Profile": {
+      "endpoints": [
+        {
+          "method": "POST",
+          "path": "/v1/companies/:companyUuid/contractors",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/post-v1-companies-company_uuid-contractors"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/contractors/:contractorUuid",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-contractors-contractor_uuid"
+        },
+        {
+          "method": "PUT",
+          "path": "/v1/contractors/:contractorUuid",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/put-v1-contractors-contractor_uuid"
+        }
+      ],
+      "variables": [
+        "companyUuid",
+        "contractorUuid"
+      ]
+    },
+    "ContractorManagement.Address": {
+      "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/contractors/:contractorUuid",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-contractors-contractor_uuid"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/contractors/:contractorUuid/address",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-contractors-contractor_uuid-address"
+        },
+        {
+          "method": "PUT",
+          "path": "/v1/contractors/:contractorUuid/address",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/put-v1-contractors-contractor_uuid-address"
+        }
+      ],
+      "variables": [
+        "contractorUuid"
+      ]
+    },
+    "ContractorManagement.PaymentMethod": {
+      "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/contractors/:contractorUuid/bank_accounts",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-contractors-contractor_uuid-bank_accounts"
+        },
+        {
+          "method": "POST",
+          "path": "/v1/contractors/:contractorUuid/bank_accounts",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/post-v1-contractors-contractor_uuid-bank_accounts"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/contractors/:contractorUuid/payment_method",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-contractors-contractor_uuid-payment_method"
+        },
+        {
+          "method": "PUT",
+          "path": "/v1/contractors/:contractorUuid/payment_method",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/put-v1-contractors-contractor_id-payment_method"
+        }
+      ],
+      "variables": [
+        "contractorUuid"
+      ]
+    },
+    "ContractorManagement.Compensation": {
+      "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/contractors/:contractorUuid",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-contractors-contractor_uuid"
+        },
+        {
+          "method": "PUT",
+          "path": "/v1/contractors/:contractorUuid",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/put-v1-contractors-contractor_uuid"
+        }
+      ],
+      "variables": [
+        "contractorUuid"
+      ]
+    },
+    "ContractorManagement.DocumentsCard": {
+      "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/contractors/:contractorUuid/documents",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-contractor-documents"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/documents/:documentUuid/pdf",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-contractor-document-pdf"
+        }
+      ],
+      "variables": [
+        "contractorUuid",
+        "documentUuid"
+      ]
+    },
     "ContractorManagement.PaymentsList": {
       "endpoints": [
         {
@@ -2230,6 +2349,18 @@
         "companyUuid"
       ]
     },
+    "ContractorManagement.HistoricalPaymentAmounts": {
+      "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/companies/:companyUuid/contractors",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-companies-company_uuid-contractors"
+        }
+      ],
+      "variables": [
+        "companyUuid"
+      ]
+    },
     "ContractorManagement.PaymentHistory": {
       "endpoints": [
         {
@@ -2318,16 +2449,35 @@
         "EmployeeOnboarding.OnboardingFlow"
       ]
     },
-    "ContractorManagement.PaymentFlow": {
+    "ContractorManagement.CreatePaymentFlow": {
       "blocks": [
         "ContractorManagement.CreatePayment",
-        "ContractorManagement.PaymentHistory",
-        "ContractorManagement.PaymentStatement",
-        "ContractorManagement.PaymentSummary",
+        "ContractorManagement.PaymentSummary"
+      ]
+    },
+    "ContractorManagement.DashboardFlow": {
+      "blocks": [
+        "ContractorManagement.Address",
+        "ContractorManagement.Compensation",
+        "ContractorManagement.DocumentsCard",
+        "ContractorManagement.PaymentMethod",
+        "ContractorManagement.Profile"
+      ]
+    },
+    "ContractorManagement.PaymentFlow": {
+      "blocks": [
+        "ContractorManagement.CreatePaymentFlow",
         "ContractorManagement.PaymentsList",
+        "ContractorManagement.ViewPaymentFlow",
         "InformationRequests.InformationRequestsFlow"
       ]
     },
+    "ContractorManagement.ViewPaymentFlow": {
+      "blocks": [
+        "ContractorManagement.PaymentHistory",
+        "ContractorManagement.PaymentStatement"
+      ]
+    },
     "ContractorOnboarding.OnboardingFlow": {
       "blocks": [
         "ContractorOnboarding.Address",
@@ -2576,6 +2726,11 @@
           "method": "POST",
           "path": "/v1/contractors/:contractorUuid/bank_accounts",
           "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/post-v1-contractors-contractor_uuid-bank_accounts"
+        },
+        {
+          "method": "GET",
+          "path": "/v1/contractors/:contractorUuid/payment_method",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-contractors-contractor_uuid-payment_method"
         }
       ],
       "variables": [
@@ -2617,6 +2772,23 @@
         "contractorUuid"
       ]
     },
+    "useContractorPayForm": {
+      "endpoints": [
+        {
+          "method": "GET",
+          "path": "/v1/contractors/:contractorUuid",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/get-v1-contractors-contractor_uuid"
+        },
+        {
+          "method": "PUT",
+          "path": "/v1/contractors/:contractorUuid",
+          "docsUrl": "https://docs.gusto.com/embedded-payroll/v2026-06-15/reference/put-v1-contractors-contractor_uuid"
+        }
+      ],
+      "variables": [
+        "contractorUuid"
+      ]
+    },
     "useContractorPaymentMethodForm": {
       "endpoints": [
         {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gusto/embedded-react-sdk",
-  "version": "0.53.0",
+  "version": "0.54.0",
   "homepage": "https://github.com/Gusto/embedded-react-sdk",
   "bugs": {
     "url": "https://github.com/Gusto/embedded-react-sdk/issues"
@@ -11,7 +11,7 @@
   },
   "module": "./dist/index.js",
   "type": "module",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
@@ -28,7 +28,8 @@
     "dist",
     "docs/guides/endpoint-inventory.json",
     "./README.md",
-    "./CHANGELOG.md"
+    "./CHANGELOG.md",
+    "./DISCLAIMER.md"
   ],
   "scripts": {
     "build": "npm run build:clean && vite build",
@@ -97,26 +98,27 @@
     "@commitlint/config-conventional": "^21.2.0",
     "@eslint/js": "^9.39.5",
     "@microsoft/api-extractor": "^7.58.12",
-    "@playwright/test": "^1.61.1",
-    "@release-it/conventional-changelog": "^11.0.1",
-    "@storybook/addon-a11y": "^10.5.3",
-    "@storybook/addon-docs": "^10.5.3",
-    "@storybook/addon-onboarding": "^10.5.3",
-    "@storybook/react-vite": "^10.5.3",
+    "@playwright/test": "^1.62.1",
+    "@release-it/conventional-changelog": "^12.0.0",
+    "@storybook/addon-a11y": "^10.5.5",
+    "@storybook/addon-docs": "^10.5.5",
+    "@storybook/addon-onboarding": "^10.5.5",
+    "@storybook/react-vite": "^10.5.5",
     "@storybook/test-runner": "^0.24.4",
-    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/jest-dom": "^7.0.0",
     "@testing-library/react": "^16.3.2",
     "@testing-library/user-event": "^14.6.1",
     "@types/eslint-plugin-jsx-a11y": "^6.10.1",
     "@types/jest": "^30.0.0",
     "@types/jest-axe": "^3.5.9",
     "@types/pngjs": "^6.0.5",
-    "@types/react": "^19.2.17",
-    "@types/react-dom": "^19.2.3",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.4",
     "@typescript-eslint/parser": "^8.64.0",
     "@typescript-eslint/rule-tester": "^8.65.0",
     "@typescript-eslint/utils": "^8.64.0",
-    "@vitejs/plugin-react-swc": "^4.3.1",
+    "@vitejs/plugin-react-swc": "^4.3.3",
     "@vitest/coverage-v8": "^4.1.9",
     "ajv": "^8.20.0",
     "axe-core": "^4.12.1",
@@ -128,17 +130,17 @@
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^7.1.1",
     "eslint-plugin-react-refresh": "^0.4.24",
-    "eslint-plugin-storybook": "^10.5.3",
+    "eslint-plugin-storybook": "^10.5.5",
     "eslint-plugin-tsdoc": "^0.5.2",
     "fuse.js": "^7.5.0",
-    "globals": "^17.7.0",
+    "globals": "^17.8.0",
     "husky": "^9.1.7",
-    "jest-axe": "^9.0.0",
+    "jest-axe": "^11.0.0",
     "jsdom": "^26.1.0",
     "jsdom-testing-mocks": "^1.16.0",
     "json-schema-to-typescript": "^15.0.4",
-    "lint-staged": "^17.0.8",
-    "markdownlint-cli2": "^0.23.1",
+    "lint-staged": "^17.3.0",
+    "markdownlint-cli2": "^0.23.2",
     "msw": "^2.15.0",
     "npm-run-all": "^4.1.5",
     "pixelmatch": "^7.2.0",
@@ -147,16 +149,16 @@
     "prism-react-renderer": "^2.4.1",
     "react-dnd": "^16.0.1",
     "react-dnd-html5-backend": "^16.0.1",
-    "react-router-dom": "^7.18.1",
-    "release-it": "^20.2.1",
+    "react-router-dom": "^7.18.2",
+    "release-it": "^21.0.1",
     "sass-embedded": "^1.100.0",
-    "storybook": "^10.5.0",
+    "storybook": "^10.5.5",
     "stylelint-config-standard": "^40.0.0",
     "ts-morph": "^28.0.0",
     "tsx": "^4.23.1",
     "typescript-eslint": "^8.65.0",
     "vite": "^6.4.3",
-    "vite-plugin-checker": "^0.14.4",
+    "vite-plugin-checker": "^0.14.5",
     "vite-plugin-circular-dependency": "^0.6.0",
     "vite-plugin-dts": "^4.5.3",
     "vite-plugin-externalize-deps": "^0.10.0",
@@ -183,8 +185,8 @@
   "dependencies": {
     "@gusto/embedded-api": "npm:@gusto/embedded-api-v-2026-06-15@^0.1.0",
     "@hookform/error-message": "^2.0.1",
-    "@hookform/resolvers": "^5.4.0",
-    "@internationalized/date": "^3.12.2",
+    "@hookform/resolvers": "^5.5.7",
+    "@internationalized/date": "^3.12.3",
     "@internationalized/number": "^3.6.7",
     "classnames": "^2.5.1",
     "deepmerge": "^4.3.1",
@@ -193,7 +195,7 @@
     "react-aria": "^3.47.0",
     "react-aria-components": "1.16.0",
     "react-error-boundary": "^6.1.2",
-    "react-hook-form": "^7.82.0",
+    "react-hook-form": "^7.84.0",
     "react-i18next": "^17.0.11",
     "react-robot": "^1.2.1",
     "robot3": "^1.2.0",

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

@@ -1,98 +0,0 @@
-import { jsx as t, jsxs as l } from "react/jsx-runtime";
-import { useTranslation as m } from "react-i18next";
-import R from "classnames";
-import b from "./Address.module.scss.js";
-import { useContractorAddressForm as E } from "./shared/useContractorAddressForm/useContractorAddressForm.js";
-import { BaseBoundaries as S, BaseLayout as p } from "../../Base/Base.js";
-import "../../Base/useBase.js";
-import { SDKFormProvider as v } from "../../../partner-hook-utils/form/SDKFormProvider.js";
-import { Form as T } from "../../Common/Form/Form.js";
-import { Flex as f } from "../../Common/Flex/Flex.js";
-import { Grid as y } from "../../Common/Grid/Grid.js";
-import { ActionsLayout as I } from "../../Common/ActionsLayout/ActionsLayout.js";
-import { useComponentContext as h } from "../../../contexts/ComponentAdapter/useComponentContext.js";
-import { useComponentDictionary as x, useI18n as _ } from "../../../i18n/I18n.js";
-import { contractorEvents as g } from "../../../shared/constants.js";
-import { useContractorHasSignedW9 as F } from "../shared/useContractorHasSignedW9.js";
-const L = {
-  update: ["street1", "city", "state", "zip"]
-};
-function $({ onEvent: o, FallbackComponent: i, ...s }) {
-  return /* @__PURE__ */ t(S, { componentName: "Contractor.Address", FallbackComponent: i, children: /* @__PURE__ */ t(B, { onEvent: o, ...s }) });
-}
-function N({ contractorId: o }) {
-  const i = F(o), { t: s } = m("Contractor.Address"), d = h();
-  return i ? /* @__PURE__ */ t(d.Alert, { status: "warning", disableScrollIntoView: !0, label: s("w9EditWarning.label"), children: /* @__PURE__ */ t(d.Text, { children: s("w9EditWarning.body") }) }) : null;
-}
-function B({
-  contractorId: o,
-  defaultValues: i,
-  onEvent: s,
-  dictionary: d,
-  className: D
-}) {
-  x("Contractor.Address", d), _("Contractor.Address");
-  const { t: r } = m("Contractor.Address"), { t: A } = m("common"), c = h(), e = E({
-    contractorId: o,
-    optionalFieldsToRequire: L,
-    defaultValues: i
-  });
-  if (e.isLoading)
-    return /* @__PURE__ */ t(p, { isLoading: !0, error: e.errorHandling.errors });
-  const { Fields: n } = e.form, u = e.data.contractorType === "Business", C = async () => {
-    const a = await e.actions.onSubmit();
-    a && (s(g.CONTRACTOR_ADDRESS_UPDATED, a.data), s(g.CONTRACTOR_ADDRESS_DONE));
-  };
-  return /* @__PURE__ */ t("section", { className: R(b.container, D), children: /* @__PURE__ */ t(p, { error: e.errorHandling.errors, children: /* @__PURE__ */ t(v, { formHookResult: e, children: /* @__PURE__ */ l(T, { onSubmit: () => {
-    C();
-  }, children: [
-    /* @__PURE__ */ t(N, { contractorId: o }),
-    /* @__PURE__ */ l(f, { flexDirection: "column", gap: 32, alignItems: "stretch", children: [
-      /* @__PURE__ */ t("header", { children: /* @__PURE__ */ l(f, { flexDirection: "column", gap: 4, children: [
-        /* @__PURE__ */ t(c.Heading, { as: "h2", children: r(u ? "businessAddressTitle" : "homeAddressTitle") }),
-        /* @__PURE__ */ t(c.Text, { variant: "supporting", children: r(u ? "businessAddressDescription" : "homeAddressDescription") })
-      ] }) }),
-      /* @__PURE__ */ l(y, { gridTemplateColumns: { base: "1fr", small: ["1fr", "1fr"] }, gap: 20, children: [
-        /* @__PURE__ */ t(
-          n.Street1,
-          {
-            label: r("street1"),
-            validationMessages: { REQUIRED: r("validations.street1") }
-          }
-        ),
-        /* @__PURE__ */ t(n.Street2, { label: r("street2") }),
-        /* @__PURE__ */ t(
-          n.City,
-          {
-            label: r("city"),
-            validationMessages: { REQUIRED: r("validations.city") }
-          }
-        ),
-        /* @__PURE__ */ t(
-          n.State,
-          {
-            label: r("state"),
-            placeholder: r("statePlaceholder"),
-            validationMessages: { REQUIRED: r("validations.state") },
-            getOptionLabel: (a) => A(`statesHash.${a}`, { defaultValue: a })
-          }
-        ),
-        /* @__PURE__ */ t(
-          n.Zip,
-          {
-            label: r("zip"),
-            validationMessages: {
-              REQUIRED: r("validations.zip"),
-              INVALID_ZIP: r("validations.zipInvalid")
-            }
-          }
-        )
-      ] }),
-      /* @__PURE__ */ t(I, { children: /* @__PURE__ */ t(c.Button, { type: "submit", isDisabled: e.status.isPending, children: e.status.isPending ? r("submitting") : r("submit") }) })
-    ] })
-  ] }) }) }) });
-}
-export {
-  $ as Address
-};
-//# sourceMappingURL=Address.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Address.js","sources":["../../../../src/components/Contractor/Address/Address.tsx"],"sourcesContent":["import type { JSX } from 'react'\nimport { useTranslation } from 'react-i18next'\nimport classNames from 'classnames'\nimport type { FallbackProps } from 'react-error-boundary'\nimport styles from './Address.module.scss'\nimport { useContractorAddressForm } from './shared/useContractorAddressForm'\nimport type { ContractorAddressOptionalFieldsToRequire } from './shared/useContractorAddressForm'\nimport type { AddressDefaultValues } from './types'\nimport { BaseBoundaries, BaseLayout } from '@/components/Base'\nimport { SDKFormProvider } from '@/partner-hook-utils/form/SDKFormProvider'\nimport { Form } from '@/components/Common/Form'\nimport { Flex, Grid, ActionsLayout } from '@/components/Common'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { useI18n, useComponentDictionary } from '@/i18n'\nimport type { ResourceDictionary } from '@/types/Helpers'\nimport { contractorEvents, type EventType } from '@/shared/constants'\nimport type { OnEventType } from '@/components/Base/useBase'\nimport { useContractorHasSignedW9 } from '@/components/Contractor/shared/useContractorHasSignedW9'\n\n// The hook defaults to the API contract, which treats every address field as\n// optional. The SDK's address form has always required a complete mailing\n// address, so it opts those fields back into being required here.\nconst SDK_REQUIRED_ADDRESS_FIELDS: ContractorAddressOptionalFieldsToRequire = {\n  update: ['street1', 'city', 'state', 'zip'],\n}\n\n/**\n * Props for {@link Address}.\n *\n * @public\n */\nexport interface AddressProps {\n  /** The associated contractor identifier. */\n  contractorId: string\n  /** Pre-fill values for address fields. Server data takes precedence when the contractor already has an address on file. */\n  defaultValues?: AddressDefaultValues\n  /** Callback invoked each time the component emits an event. */\n  onEvent: OnEventType<EventType, unknown>\n  /** Overrides for the component's i18n strings. */\n  dictionary?: ResourceDictionary<'Contractor.Address'>\n  /** Optional class applied to the wrapping `<section>`. */\n  className?: string\n  /** Custom React component rendered when an unhandled error is caught by the component-level error boundary. */\n  FallbackComponent?: (props: FallbackProps) => JSX.Element\n}\n\n/**\n * Form for collecting and updating a contractor's mailing address. Renders a business or home address title based on the contractor type.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `contractor/address/updated` | Fired after the address is saved | The updated `ContractorAddress` entity |\n * | `contractor/address/done` | Fired after a successful save so the parent flow can advance | — |\n *\n * @param props - See {@link AddressProps}.\n * @returns The contractor address form.\n * @public\n *\n * @example\n * ```tsx\n * import { ContractorOnboarding } from '@gusto/embedded-react-sdk'\n *\n * function MyComponent() {\n *   return (\n *     <ContractorOnboarding.Address\n *       contractorId=\"contractor-uuid\"\n *       onEvent={() => {}}\n *     />\n *   )\n * }\n * ```\n */\nexport function Address({ onEvent, FallbackComponent, ...rootProps }: AddressProps) {\n  return (\n    <BaseBoundaries componentName=\"Contractor.Address\" FallbackComponent={FallbackComponent}>\n      <AddressRoot onEvent={onEvent} {...rootProps} />\n    </BaseBoundaries>\n  )\n}\n\nfunction ContractorAddressW9Warning({ contractorId }: { contractorId: string }) {\n  const hasSignedW9 = useContractorHasSignedW9(contractorId)\n  const { t } = useTranslation('Contractor.Address')\n  const Components = useComponentContext()\n  if (!hasSignedW9) return null\n  return (\n    <Components.Alert status=\"warning\" disableScrollIntoView label={t('w9EditWarning.label')}>\n      <Components.Text>{t('w9EditWarning.body')}</Components.Text>\n    </Components.Alert>\n  )\n}\n\nfunction AddressRoot({\n  contractorId,\n  defaultValues,\n  onEvent,\n  dictionary,\n  className,\n}: Omit<AddressProps, 'FallbackComponent'>) {\n  useComponentDictionary('Contractor.Address', dictionary)\n  useI18n('Contractor.Address')\n  const { t } = useTranslation('Contractor.Address')\n  const { t: tCommon } = useTranslation('common')\n  const Components = useComponentContext()\n\n  const contractorAddress = useContractorAddressForm({\n    contractorId,\n    optionalFieldsToRequire: SDK_REQUIRED_ADDRESS_FIELDS,\n    defaultValues,\n  })\n\n  if (contractorAddress.isLoading) {\n    return <BaseLayout isLoading error={contractorAddress.errorHandling.errors} />\n  }\n\n  const { Fields } = contractorAddress.form\n  const isBusiness = contractorAddress.data.contractorType === 'Business'\n\n  const handleSubmit = async () => {\n    const result = await contractorAddress.actions.onSubmit()\n    if (result) {\n      onEvent(contractorEvents.CONTRACTOR_ADDRESS_UPDATED, result.data)\n      onEvent(contractorEvents.CONTRACTOR_ADDRESS_DONE)\n    }\n  }\n\n  return (\n    <section className={classNames(styles.container, className)}>\n      <BaseLayout error={contractorAddress.errorHandling.errors}>\n        <SDKFormProvider formHookResult={contractorAddress}>\n          <Form onSubmit={() => void handleSubmit()}>\n            <ContractorAddressW9Warning contractorId={contractorId} />\n\n            <Flex flexDirection=\"column\" gap={32} alignItems=\"stretch\">\n              <header>\n                <Flex flexDirection=\"column\" gap={4}>\n                  <Components.Heading as=\"h2\">\n                    {isBusiness ? t('businessAddressTitle') : t('homeAddressTitle')}\n                  </Components.Heading>\n                  <Components.Text variant=\"supporting\">\n                    {isBusiness ? t('businessAddressDescription') : t('homeAddressDescription')}\n                  </Components.Text>\n                </Flex>\n              </header>\n\n              <Grid gridTemplateColumns={{ base: '1fr', small: ['1fr', '1fr'] }} gap={20}>\n                <Fields.Street1\n                  label={t('street1')}\n                  validationMessages={{ REQUIRED: t('validations.street1') }}\n                />\n                <Fields.Street2 label={t('street2')} />\n                <Fields.City\n                  label={t('city')}\n                  validationMessages={{ REQUIRED: t('validations.city') }}\n                />\n                <Fields.State\n                  label={t('state')}\n                  placeholder={t('statePlaceholder')}\n                  validationMessages={{ REQUIRED: t('validations.state') }}\n                  getOptionLabel={(abbr: string) =>\n                    tCommon(`statesHash.${abbr}`, { defaultValue: abbr })\n                  }\n                />\n                <Fields.Zip\n                  label={t('zip')}\n                  validationMessages={{\n                    REQUIRED: t('validations.zip'),\n                    INVALID_ZIP: t('validations.zipInvalid'),\n                  }}\n                />\n              </Grid>\n\n              <ActionsLayout>\n                <Components.Button type=\"submit\" isDisabled={contractorAddress.status.isPending}>\n                  {contractorAddress.status.isPending ? t('submitting') : t('submit')}\n                </Components.Button>\n              </ActionsLayout>\n            </Flex>\n          </Form>\n        </SDKFormProvider>\n      </BaseLayout>\n    </section>\n  )\n}\n"],"names":["SDK_REQUIRED_ADDRESS_FIELDS","Address","onEvent","FallbackComponent","rootProps","jsx","BaseBoundaries","AddressRoot","ContractorAddressW9Warning","contractorId","hasSignedW9","useContractorHasSignedW9","t","useTranslation","Components","useComponentContext","defaultValues","dictionary","className","useComponentDictionary","useI18n","tCommon","contractorAddress","useContractorAddressForm","BaseLayout","Fields","isBusiness","handleSubmit","result","contractorEvents","classNames","styles","SDKFormProvider","jsxs","Form","Flex","Grid","abbr","ActionsLayout"],"mappings":"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"}

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

@@ -1,2 +0,0 @@
-export { Address, type AddressProps } from './Address';
-export type { AddressDefaultValues } from './types';

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

@@ -1 +0,0 @@
-{"version":3,"file":"DocumentSigner.js","sources":["../../../../../src/components/Contractor/Documents/DocumentSigner/DocumentSigner.tsx"],"sourcesContent":["import { createMachine } from 'robot3'\nimport { useMemo } from 'react'\nimport type { DocumentsListProps } from '../DocumentsList'\nimport {\n  DocumentsListContextual,\n  type DocumentSignerContextInterface,\n} from './documentSignerStateMachine'\nimport { documentSignerMachine } from './stateMachine'\nimport { Flow } from '@/components/Flow/Flow'\nimport { BaseComponent, type BaseComponentInterface } from '@/components/Base'\nimport { useComponentDictionary } from '@/i18n/I18n'\n\n/**\n * Props for {@link DocumentSigner}.\n *\n * @public\n */\nexport interface DocumentSignerProps extends Omit<\n  BaseComponentInterface<'Contractor.DocumentsList'>,\n  'dictionary'\n> {\n  /** The associated contractor identifier. */\n  contractorId: string\n  /** Overrides for the document list copy shown by the signing flow. */\n  dictionary?: DocumentsListProps['dictionary']\n}\n\nfunction DocumentSignerFlow({ contractorId, onEvent, dictionary }: DocumentSignerProps) {\n  useComponentDictionary('Contractor.DocumentsList', dictionary)\n\n  const machine = useMemo(\n    () =>\n      createMachine(\n        'index',\n        documentSignerMachine,\n        (initialContext: DocumentSignerContextInterface) => ({\n          ...initialContext,\n          component: DocumentsListContextual,\n          contractorId,\n        }),\n      ),\n    [contractorId],\n  )\n\n  return <Flow machine={machine} onEvent={onEvent} />\n}\n\n/**\n * Contractor onboarding step for reading and signing required contractor documents.\n *\n * @remarks\n * Composes the contractor {@link DocumentsList} and {@link SignatureForm} into a\n * single signing workflow: the document list is shown first, selecting a\n * document routes to its signature form, and signing (or navigating back)\n * returns to the list. The list refetches automatically once a document is\n * signed. The flow completes when every document that requires signing has been\n * signed and the user continues.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `contractor/documents/view` | Fired when a document's \"Sign\" action is selected from the document list | `{ uuid: string; title?: string }` |\n * | `contractor/documents/sign` | Fired after a document is successfully signed | The signed document |\n * | `contractor/documents/done` | Fired when all required documents have been signed and the parent flow can advance | — |\n * | `cancel` | Fired when the user navigates back from the signature form to the document list | — |\n *\n * @components\n * - {@link DocumentsList}\n * - {@link SignatureForm}\n *\n * @param props - See {@link DocumentSignerProps}.\n * @returns The document signer flow.\n * @public\n */\nexport function DocumentSigner(props: DocumentSignerProps) {\n  return (\n    <BaseComponent {...props}>\n      <DocumentSignerFlow {...props} />\n    </BaseComponent>\n  )\n}\n"],"names":["DocumentSignerFlow","contractorId","onEvent","dictionary","useComponentDictionary","machine","useMemo","createMachine","documentSignerMachine","initialContext","DocumentsListContextual","jsx","Flow","DocumentSigner","props","BaseComponent"],"mappings":";;;;;;;;;AA2BA,SAASA,EAAmB,EAAE,cAAAC,GAAc,SAAAC,GAAS,YAAAC,KAAmC;AACtF,EAAAC,EAAuB,4BAA4BD,CAAU;AAE7D,QAAME,IAAUC;AAAA,IACd,MACEC;AAAA,MACE;AAAA,MACAC;AAAA,MACA,CAACC,OAAoD;AAAA,QACnD,GAAGA;AAAA,QACH,WAAWC;AAAA,QACX,cAAAT;AAAA,MAAA;AAAA,IACF;AAAA,IAEJ,CAACA,CAAY;AAAA,EAAA;AAGf,SAAO,gBAAAU,EAACC,GAAA,EAAK,SAAAP,GAAkB,SAAAH,EAAA,CAAkB;AACnD;AA6BO,SAASW,EAAeC,GAA4B;AACzD,SACE,gBAAAH,EAACI,KAAe,GAAGD,GACjB,4BAACd,GAAA,EAAoB,GAAGc,GAAO,EAAA,CACjC;AAEJ;"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"documentSignerStateMachine.js","sources":["../../../../../src/components/Contractor/Documents/DocumentSigner/documentSignerStateMachine.tsx"],"sourcesContent":["import type { DocumentSigned } from '@gusto/embedded-api/models/components/documentsigned'\nimport { DocumentsList } from '../DocumentsList/DocumentsList'\nimport { SignatureForm } from '../SignatureForm/SignatureForm'\nimport { useFlow, type FlowContextInterface } from '@/components/Flow/useFlow'\nimport type { componentEvents } from '@/shared/constants'\nimport { ensureRequired } from '@/helpers/ensureRequired'\n\n/** @internal */\nexport type EventPayloads = {\n  [componentEvents.CONTRACTOR_VIEW_DOCUMENT_TO_SIGN]: { uuid: string; title?: string }\n  [componentEvents.CONTRACTOR_SIGN_DOCUMENT]: DocumentSigned\n  [componentEvents.CONTRACTOR_DOCUMENTS_DONE]: undefined\n  [componentEvents.CANCEL]: undefined\n}\n\n/** @internal */\nexport interface DocumentSignerContextInterface extends FlowContextInterface {\n  contractorId: string\n  documentUuid?: string\n}\n\n/** @internal */\nexport function DocumentsListContextual() {\n  const { contractorId, onEvent } = useFlow<DocumentSignerContextInterface>()\n\n  return <DocumentsList contractorId={ensureRequired(contractorId)} onEvent={onEvent} />\n}\n\n/** @internal */\nexport function SignatureFormContextual() {\n  const { contractorId, documentUuid, onEvent } = useFlow<DocumentSignerContextInterface>()\n\n  return (\n    <SignatureForm\n      contractorId={ensureRequired(contractorId)}\n      documentUuid={ensureRequired(documentUuid)}\n      onEvent={onEvent}\n    />\n  )\n}\n"],"names":["DocumentsListContextual","contractorId","onEvent","useFlow","DocumentsList","ensureRequired","SignatureFormContextual","documentUuid","jsx","SignatureForm"],"mappings":";;;;;AAsBO,SAASA,IAA0B;AACxC,QAAM,EAAE,cAAAC,GAAc,SAAAC,EAAA,IAAYC,EAAA;AAElC,2BAAQC,GAAA,EAAc,cAAcC,EAAeJ,CAAY,GAAG,SAAAC,GAAkB;AACtF;AAGO,SAASI,IAA0B;AACxC,QAAM,EAAE,cAAAL,GAAc,cAAAM,GAAc,SAAAL,EAAA,IAAYC,EAAA;AAEhD,SACE,gBAAAK;AAAA,IAACC;AAAA,IAAA;AAAA,MACC,cAAcJ,EAAeJ,CAAY;AAAA,MACzC,cAAcI,EAAeE,CAAY;AAAA,MACzC,SAAAL;AAAA,IAAA;AAAA,EAAA;AAGN;"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"stateMachine.js","sources":["../../../../../src/components/Contractor/Documents/DocumentSigner/stateMachine.ts"],"sourcesContent":["import { state, transition, reduce } from 'robot3'\nimport type { DocumentSignerContextInterface, EventPayloads } from './documentSignerStateMachine'\nimport { SignatureFormContextual, DocumentsListContextual } from './documentSignerStateMachine'\nimport { componentEvents } from '@/shared/constants'\nimport type { MachineEventType, MachineTransition } from '@/types/Helpers'\n\n/** @internal */\nexport const documentSignerMachine = {\n  index: state<MachineTransition>(\n    transition(\n      componentEvents.CONTRACTOR_VIEW_DOCUMENT_TO_SIGN,\n      'signatureForm',\n      reduce(\n        (\n          ctx: DocumentSignerContextInterface,\n          ev: MachineEventType<\n            EventPayloads,\n            typeof componentEvents.CONTRACTOR_VIEW_DOCUMENT_TO_SIGN\n          >,\n        ): DocumentSignerContextInterface => ({\n          ...ctx,\n          documentUuid: ev.payload.uuid,\n          component: SignatureFormContextual,\n        }),\n      ),\n    ),\n  ),\n  signatureForm: state<MachineTransition>(\n    transition(\n      componentEvents.CANCEL,\n      'index',\n      reduce((ctx: DocumentSignerContextInterface): DocumentSignerContextInterface => ({\n        ...ctx,\n        documentUuid: undefined,\n        component: DocumentsListContextual,\n      })),\n    ),\n    transition(\n      componentEvents.CONTRACTOR_SIGN_DOCUMENT,\n      'index',\n      reduce((ctx: DocumentSignerContextInterface): DocumentSignerContextInterface => ({\n        ...ctx,\n        documentUuid: undefined,\n        component: DocumentsListContextual,\n      })),\n    ),\n  ),\n}\n"],"names":["documentSignerMachine","state","transition","componentEvents","reduce","ctx","ev","SignatureFormContextual","DocumentsListContextual"],"mappings":";;;AAOO,MAAMA,IAAwB;AAAA,EACnC,OAAOC;AAAA,IACLC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC;AAAA,QACE,CACEC,GACAC,OAIoC;AAAA,UACpC,GAAGD;AAAA,UACH,cAAcC,EAAG,QAAQ;AAAA,UACzB,WAAWC;AAAA,QAAA;AAAA,MACb;AAAA,IACF;AAAA,EACF;AAAA,EAEF,eAAeN;AAAA,IACbC;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC,EAAO,CAACC,OAAyE;AAAA,QAC/E,GAAGA;AAAA,QACH,cAAc;AAAA,QACd,WAAWG;AAAA,MAAA,EACX;AAAA,IAAA;AAAA,IAEJN;AAAA,MACEC,EAAgB;AAAA,MAChB;AAAA,MACAC,EAAO,CAACC,OAAyE;AAAA,QAC/E,GAAGA;AAAA,QACH,cAAc;AAAA,QACd,WAAWG;AAAA,MAAA,EACX;AAAA,IAAA;AAAA,EACJ;AAEJ;"}

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

@@ -1,83 +0,0 @@
-import { jsx as e, jsxs as d } from "react/jsx-runtime";
-import { useTranslation as E } from "react-i18next";
-import { W9_DOCUMENT_NAME as O, getPresentFieldNames as x } from "../SignatureForm/useContractorSignatureForm/w9Fields.js";
-import { useContractorDocumentsList as N } from "./useContractorDocumentsList/useContractorDocumentsList.js";
-import { BaseComponent as R, BaseLayout as g } from "../../../Base/Base.js";
-import { useBase as _ } from "../../../Base/useBase.js";
-import { useComponentDictionary as y, useI18n as A } from "../../../../i18n/I18n.js";
-import { Flex as p } from "../../../Common/Flex/Flex.js";
-import { ActionsLayout as B } from "../../../Common/ActionsLayout/ActionsLayout.js";
-import { useComponentContext as q } from "../../../../contexts/ComponentAdapter/useComponentContext.js";
-import { contractorEvents as f } from "../../../../shared/constants.js";
-import { DocumentList as H } from "../../../Common/DocumentList/DocumentList.js";
-function c(r) {
-  return !r.signedAt;
-}
-function l(r) {
-  return r.name !== O ? !0 : x(r).size > 0;
-}
-function J(r) {
-  return /* @__PURE__ */ e(R, { ...r, children: /* @__PURE__ */ e(M, { ...r }) });
-}
-function M({ contractorId: r, className: C, dictionary: h }) {
-  y("Contractor.DocumentsList", h), A("Contractor.DocumentsList");
-  const { t: n } = E("Contractor.DocumentsList"), { onEvent: m } = _(), o = q(), i = N({ contractorId: r });
-  if (i.isLoading)
-    return /* @__PURE__ */ e(g, { isLoading: !0, error: i.errorHandling.errors });
-  const { documents: s } = i.data, L = i.errorHandling.errors.length > 0, D = s.some(
-    (t) => c(t) && l(t)
-  ), T = s.some(
-    (t) => c(t) && !l(t)
-  ), b = (t) => {
-    const u = s.find((a) => a.uuid === t);
-    m(f.CONTRACTOR_VIEW_DOCUMENT_TO_SIGN, {
-      uuid: t,
-      title: u?.title
-    });
-  }, S = () => {
-    m(f.CONTRACTOR_DOCUMENTS_DONE);
-  };
-  return /* @__PURE__ */ e("section", { className: C, children: /* @__PURE__ */ e(g, { error: i.errorHandling.errors, children: /* @__PURE__ */ d(p, { flexDirection: "column", gap: 32, children: [
-    /* @__PURE__ */ d(p, { flexDirection: "column", gap: 4, children: [
-      /* @__PURE__ */ e(o.Heading, { as: "h2", children: n("title") }),
-      /* @__PURE__ */ e(o.Text, { children: n("subtitle") })
-    ] }),
-    T && /* @__PURE__ */ e(o.Alert, { status: "warning", label: n("notReadyTitle"), children: /* @__PURE__ */ e(o.Text, { children: n("notReadyBody") }) }),
-    /* @__PURE__ */ e(
-      H,
-      {
-        forms: s.map((t) => ({
-          uuid: t.uuid ?? "",
-          title: t.title,
-          description: t.description,
-          requires_signing: c(t)
-        })),
-        canSign: (t) => {
-          const u = s.find((a) => a.uuid === t.uuid);
-          return u ? l(u) : !0;
-        },
-        onRequestSign: (t) => {
-          b(t.uuid);
-        },
-        withError: L,
-        label: n("documentListLabel"),
-        columnLabels: {
-          form: n("documentColumnLabel"),
-          action: n("statusColumnLabel")
-        },
-        statusLabels: {
-          signCta: n("signDocumentCta"),
-          notSigned: n("notSigned"),
-          complete: n("signed")
-        },
-        emptyStateLabel: n("emptyTitle"),
-        errorLabel: n("errorTitle")
-      }
-    ),
-    /* @__PURE__ */ e(B, { children: /* @__PURE__ */ e(o.Button, { onClick: S, isDisabled: D, children: n("continueCta") }) })
-  ] }) }) });
-}
-export {
-  J as DocumentsList
-};
-//# sourceMappingURL=DocumentsList.js.map

package/dist/components/Contractor/Documents/DocumentsList/DocumentsList.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"DocumentsList.js","sources":["../../../../../src/components/Contractor/Documents/DocumentsList/DocumentsList.tsx"],"sourcesContent":["import { useTranslation } from 'react-i18next'\nimport type { Document } from '@gusto/embedded-api/models/components/document'\nimport {\n  W9_DOCUMENT_NAME,\n  getPresentFieldNames,\n} from '../SignatureForm/useContractorSignatureForm/w9Fields'\nimport { useContractorDocumentsList } from './useContractorDocumentsList'\nimport { BaseComponent, type BaseComponentInterface } from '@/components/Base/Base'\nimport { BaseLayout } from '@/components/Base'\nimport { useBase } from '@/components/Base/useBase'\nimport { useI18n, useComponentDictionary } from '@/i18n'\nimport { ActionsLayout, Flex } from '@/components/Common'\nimport { DocumentList } from '@/components/Common/DocumentList'\nimport { useComponentContext } from '@/contexts/ComponentAdapter/useComponentContext'\nimport { contractorEvents } from '@/shared/constants'\n\n/**\n * Props for {@link DocumentsList}.\n *\n * @public\n */\nexport interface DocumentsListProps extends BaseComponentInterface<'Contractor.DocumentsList'> {\n  /** The associated contractor identifier. */\n  contractorId: string\n}\n\n/**\n * Returns whether a document still needs the contractor's signature.\n *\n * @remarks\n * In the contractor onboarding flow every listed document must be signed, so a\n * document is outstanding whenever it has not yet been signed (`signedAt` is\n * unset). We intentionally do not defer to the API's `requiresSigning` flag\n * here: an unsigned document whose template is not yet prepared comes back with\n * `requiresSigning: false`, and treating that as \"complete\" would render an\n * unsigned document as signed and let the contractor skip it. Keying off\n * `signedAt` keeps \"complete\" meaning \"actually signed\" for this component.\n */\nfunction requiresSignature(document: Document): boolean {\n  return !document.signedAt\n}\n\n/**\n * Returns whether a document can be signed right now.\n *\n * @remarks\n * A W-9 whose template has not finished preparing comes back with no signable\n * fields (this is the same signal the signer keys its `hasFields` state off).\n * Signing it would submit an empty form, so we block the sign action until the\n * fields are present. Any non-W-9 document is treated as signable here.\n */\nfunction canSignDocument(document: Document): boolean {\n  if (document.name !== W9_DOCUMENT_NAME) return true\n  return getPresentFieldNames(document).size > 0\n}\n\n/**\n * Lists a contractor's documents and lets the contractor open each one for signing.\n *\n * @remarks\n * Fetches the contractor's documents via {@link useContractorDocumentsList} and\n * renders them in a table. The Continue action is disabled until every document\n * the contractor can sign has been signed; a document that isn't signable yet\n * (e.g. a W-9 whose fields haven't been generated) surfaces a warning instead of\n * blocking the flow.\n *\n * @events\n * | Event | Description | Data |\n * | ----- | ----------- | ---- |\n * | `contractor/documents/view` | Fired when a document's \"Sign\" action is selected | `{ uuid?: string; title?: string }` |\n * | `contractor/documents/done` | Fired when all required documents are signed and the user continues | — |\n *\n * @param props - See {@link DocumentsListProps}.\n * @returns The contractor documents list.\n * @public\n */\nexport function DocumentsList(props: DocumentsListProps) {\n  return (\n    <BaseComponent {...props}>\n      <Root {...props} />\n    </BaseComponent>\n  )\n}\n\nfunction Root({ contractorId, className, dictionary }: DocumentsListProps) {\n  useComponentDictionary('Contractor.DocumentsList', dictionary)\n  useI18n('Contractor.DocumentsList')\n  const { t } = useTranslation('Contractor.DocumentsList')\n  const { onEvent } = useBase()\n  const Components = useComponentContext()\n\n  const result = useContractorDocumentsList({ contractorId })\n\n  if (result.isLoading) {\n    return <BaseLayout isLoading error={result.errorHandling.errors} />\n  }\n\n  const { documents } = result.data\n  const hasError = result.errorHandling.errors.length > 0\n  // Only a document the contractor can actually sign should gate the flow. A\n  // document that still needs signing but isn't signable yet (e.g. a W-9 whose\n  // fields haven't been generated) must not trap the user — it surfaces the\n  // \"not ready\" warning below instead of blocking Continue.\n  const hasOutstandingSignature = documents.some(\n    document => requiresSignature(document) && canSignDocument(document),\n  )\n  const hasUnpreparedDocument = documents.some(\n    document => requiresSignature(document) && !canSignDocument(document),\n  )\n\n  const handleRequestSign = (uuid: string) => {\n    const document = documents.find(candidate => candidate.uuid === uuid)\n    onEvent(contractorEvents.CONTRACTOR_VIEW_DOCUMENT_TO_SIGN, {\n      uuid,\n      title: document?.title,\n    })\n  }\n\n  const handleContinue = () => {\n    onEvent(contractorEvents.CONTRACTOR_DOCUMENTS_DONE)\n  }\n\n  return (\n    <section className={className}>\n      <BaseLayout error={result.errorHandling.errors}>\n        <Flex flexDirection=\"column\" gap={32}>\n          <Flex flexDirection=\"column\" gap={4}>\n            <Components.Heading as=\"h2\">{t('title')}</Components.Heading>\n            <Components.Text>{t('subtitle')}</Components.Text>\n          </Flex>\n\n          {hasUnpreparedDocument && (\n            <Components.Alert status=\"warning\" label={t('notReadyTitle')}>\n              <Components.Text>{t('notReadyBody')}</Components.Text>\n            </Components.Alert>\n          )}\n\n          <DocumentList\n            forms={documents.map(document => ({\n              uuid: document.uuid ?? '',\n              title: document.title,\n              description: document.description,\n              requires_signing: requiresSignature(document),\n            }))}\n            canSign={form => {\n              const document = documents.find(candidate => candidate.uuid === form.uuid)\n              return document ? canSignDocument(document) : true\n            }}\n            onRequestSign={form => {\n              handleRequestSign(form.uuid)\n            }}\n            withError={hasError}\n            label={t('documentListLabel')}\n            columnLabels={{\n              form: t('documentColumnLabel'),\n              action: t('statusColumnLabel'),\n            }}\n            statusLabels={{\n              signCta: t('signDocumentCta'),\n              notSigned: t('notSigned'),\n              complete: t('signed'),\n            }}\n            emptyStateLabel={t('emptyTitle')}\n            errorLabel={t('errorTitle')}\n          />\n\n          <ActionsLayout>\n            <Components.Button onClick={handleContinue} isDisabled={hasOutstandingSignature}>\n              {t('continueCta')}\n            </Components.Button>\n          </ActionsLayout>\n        </Flex>\n      </BaseLayout>\n    </section>\n  )\n}\n"],"names":["requiresSignature","document","canSignDocument","W9_DOCUMENT_NAME","getPresentFieldNames","DocumentsList","props","jsx","BaseComponent","Root","contractorId","className","dictionary","useComponentDictionary","useI18n","t","useTranslation","onEvent","useBase","Components","useComponentContext","result","useContractorDocumentsList","BaseLayout","documents","hasError","hasOutstandingSignature","hasUnpreparedDocument","handleRequestSign","uuid","candidate","contractorEvents","handleContinue","jsxs","Flex","DocumentList","form","ActionsLayout"],"mappings":"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"}

package/dist/components/Contractor/Documents/DocumentsList/index.d.ts

@@ -1,2 +0,0 @@
-export { DocumentsList, type DocumentsListProps } from './DocumentsList';
-export { useContractorDocumentsList, type UseContractorDocumentsListParams, type UseContractorDocumentsListReady, type UseContractorDocumentsListResult, } from './useContractorDocumentsList';

package/dist/components/Contractor/Documents/DocumentsList/useContractorDocumentsList/useContractorDocumentsList.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useContractorDocumentsList.js","sources":["../../../../../../src/components/Contractor/Documents/DocumentsList/useContractorDocumentsList/useContractorDocumentsList.tsx"],"sourcesContent":["import { useContractorDocumentsGetAll } from '@gusto/embedded-api/react-query/contractorDocumentsGetAll'\nimport type { Document } from '@gusto/embedded-api/models/components/document'\nimport { composeErrorHandler } from '@/partner-hook-utils/composeErrorHandler'\nimport type { BaseHookReady, HookLoadingResult } from '@/partner-hook-utils/types'\n\n/**\n * Parameters for {@link useContractorDocumentsList}.\n *\n * @public\n */\nexport interface UseContractorDocumentsListParams {\n  /** The associated contractor identifier. */\n  contractorId: string\n}\n\n/**\n * Ready-state shape returned by {@link useContractorDocumentsList} once the documents have loaded.\n *\n * @public\n * @interface\n */\nexport type UseContractorDocumentsListReady = BaseHookReady<\n  { documents: Document[] },\n  { isFetching: boolean }\n>\n\n/**\n * Result of {@link useContractorDocumentsList} — a discriminated union of loading and ready states.\n *\n * @public\n */\nexport type UseContractorDocumentsListResult = HookLoadingResult | UseContractorDocumentsListReady\n\n/**\n * Standalone data hook for a contractor's documents.\n *\n * @remarks\n * Wraps the `contractorDocumentsGetAll` query in the standard\n * {@link BaseHookReady} shape. Read-only — viewing or signing a document is\n * handled by the screen the parent routes to, so this hook exposes no actions.\n *\n * @param params - See {@link UseContractorDocumentsListParams}.\n * @returns A {@link HookLoadingResult} while loading, or the ready state with `data.documents` once loaded.\n * @public\n *\n * @example\n * ```tsx\n * import { useContractorDocumentsList } from '@gusto/embedded-react-sdk'\n *\n * function ContractorDocuments({ contractorId }: { contractorId: string }) {\n *   const result = useContractorDocumentsList({ contractorId })\n *\n *   if (result.isLoading) return <div>Loading...</div>\n *\n *   return (\n *     <ul>\n *       {result.data.documents.map(doc => (\n *         <li key={doc.uuid}>{doc.title}</li>\n *       ))}\n *     </ul>\n *   )\n * }\n * ```\n */\nexport function useContractorDocumentsList({\n  contractorId,\n}: UseContractorDocumentsListParams): UseContractorDocumentsListResult {\n  // staleTime: Infinity — the SDK QueryClient invalidates on any mutation\n  // success, so a long stale time avoids redundant refetches on remount.\n  const documentsQuery = useContractorDocumentsGetAll(\n    { contractorUuid: contractorId },\n    { staleTime: Infinity },\n  )\n\n  const errorHandling = composeErrorHandler([documentsQuery])\n\n  if (documentsQuery.isLoading) {\n    return { isLoading: true, errorHandling }\n  }\n\n  return {\n    isLoading: false,\n    data: { documents: documentsQuery.data?.documents ?? [] },\n    status: { isFetching: documentsQuery.isFetching },\n    errorHandling,\n  }\n}\n"],"names":["useContractorDocumentsList","contractorId","documentsQuery","useContractorDocumentsGetAll","errorHandling","composeErrorHandler"],"mappings":";;AAgEO,SAASA,EAA2B;AAAA,EACzC,cAAAC;AACF,GAAuE;AAGrE,QAAMC,IAAiBC;AAAA,IACrB,EAAE,gBAAgBF,EAAA;AAAA,IAClB,EAAE,WAAW,MAAA;AAAA,EAAS,GAGlBG,IAAgBC,EAAoB,CAACH,CAAc,CAAC;AAE1D,SAAIA,EAAe,YACV,EAAE,WAAW,IAAM,eAAAE,EAAA,IAGrB;AAAA,IACL,WAAW;AAAA,IACX,MAAM,EAAE,WAAWF,EAAe,MAAM,aAAa,CAAA,EAAC;AAAA,IACtD,QAAQ,EAAE,YAAYA,EAAe,WAAA;AAAA,IACrC,eAAAE;AAAA,EAAA;AAEJ;"}