@gusto/embedded-react-sdk 0.55.8 → 0.56.0

package/dist/components/Payroll/PrintChecks/PrintChecksForm/useGenerationPoll.js

@@ -1,55 +1,70 @@
-import { useRef as d, useCallback as m } from "react";
-import { buildGeneratedDocumentsGetQuery as f } from "@gusto/embedded-api/react-query/generatedDocumentsGet";
-import { useGustoEmbeddedContext as p } from "@gusto/embedded-api/react-query/_context";
-import { useQueryClient as y } from "@tanstack/react-query";
-import { DocumentType as h } from "@gusto/embedded-api/models/operations/getv1generateddocumentsdocumenttyperequestuuid";
-import { GeneratedDocumentStatus as n } from "@gusto/embedded-api/models/components/generateddocument";
-import { usePollingTask as D } from "../../../../hooks/usePollingTask/usePollingTask.js";
-const g = (t) => {
-  const r = t.generatedDocument?.status;
-  return r === n.Succeeded ? {
-    done: !0,
-    value: { type: "succeeded", url: t.generatedDocument?.documentUrls?.[0] ?? null }
-  } : r === n.Failed ? { done: !0, value: { type: "failed" } } : { done: !1 };
-}, C = (t) => t?.generatedDocument?.status === n.Succeeded ? { type: "succeeded", url: t?.generatedDocument?.documentUrls?.[0] ?? null } : { type: "failed" };
-function w({
-  onSucceeded: t,
+import { useRef as m, useCallback as f } from "react";
+import { buildGeneratedDocumentsGetQuery as p } from "@gusto/embedded-api/react-query/generatedDocumentsGet";
+import { useGustoEmbeddedContext as y } from "@gusto/embedded-api/react-query/_context";
+import { useQueryClient as h } from "@tanstack/react-query";
+import { DocumentType as P } from "@gusto/embedded-api/models/operations/getv1generateddocumentsdocumenttyperequestuuid";
+import { GeneratedDocumentStatus as o } from "@gusto/embedded-api/models/components/generateddocument";
+import { usePollingTask as D, isNonRetryablePollError as g } from "../../../../hooks/usePollingTask/usePollingTask.js";
+import { useObservability as C } from "../../../../contexts/ObservabilityProvider/useObservability.js";
+import { normalizeToSDKError as b } from "../../../../types/sdkError.js";
+const k = "Payroll.PrintChecksForm", E = (e) => e?.generatedDocument?.status === o.Succeeded ? { type: "succeeded", url: e?.generatedDocument?.documentUrls?.[0] ?? null } : { type: "failed" }, v = (e) => {
+  if (!e.success)
+    return g(e.error) ? { status: "error", error: e.error } : { status: "polling" };
+  const r = e.data.generatedDocument?.status;
+  return r === o.Succeeded ? {
+    status: "done",
+    value: { type: "succeeded", url: e.data.generatedDocument?.documentUrls?.[0] ?? null }
+  } : r === o.Failed ? { status: "done", value: { type: "failed" } } : { status: "polling" };
+};
+function x({
+  onSucceeded: e,
   onFailed: r
 }) {
-  const l = p(), a = y(), u = d(null), i = (e) => {
-    const c = u.current;
-    if (!c)
+  const l = y(), i = h(), s = m(null), { observability: c } = C(), d = (t) => {
+    const n = s.current;
+    if (!n)
       throw new Error("usePollingTask started without a print-checks request in flight");
-    return a.fetchQuery({
-      ...f(
+    return i.fetchQuery({
+      ...p(
         l,
-        { documentType: h.PrintablePayrollChecks, requestUuid: c },
-        { signal: e }
+        { documentType: P.PrintablePayrollChecks, requestUuid: n },
+        { signal: t }
       ),
       staleTime: 0
     });
-  }, o = (e) => {
-    if (e.type === "failed") {
+  }, u = (t) => {
+    if (t.type === "failed") {
       r();
       return;
     }
-    t(e.url);
-  }, { start: s } = D({
-    fetch: i,
-    evaluate: g,
-    onDone: o,
-    onDeadline: (e) => {
-      o(C(e));
+    e(t.url);
+  }, { start: a } = D({
+    fetch: d,
+    evaluate: v,
+    onDone: u,
+    // Unlike the payroll polls, print-checks generation has no equivalent to prepare/resubmit to
+    // guard against, so a non-retryable read error can safely reuse the same failure path as a
+    // real generation failure — same screen, same retry CTA.
+    onError: (t) => {
+      const n = b(t);
+      c?.onError?.({
+        ...n,
+        timestamp: Date.now(),
+        componentName: k
+      }), r();
+    },
+    onDeadline: (t) => {
+      u(E(t));
     }
   });
-  return { start: m(
-    (e) => {
-      u.current = e, s();
+  return { start: f(
+    (t) => {
+      s.current = t, a();
     },
-    [s]
+    [a]
   ) };
 }
 export {
-  w as useGenerationPoll
+  x as useGenerationPoll
 };
 //# sourceMappingURL=useGenerationPoll.js.map

package/dist/components/Payroll/PrintChecks/PrintChecksForm/useGenerationPoll.js.map

@@ -1 +1 @@
-{"version":3,"file":"useGenerationPoll.js","sources":["../../../../../src/components/Payroll/PrintChecks/PrintChecksForm/useGenerationPoll.ts"],"sourcesContent":["import { useCallback, useRef } from 'react'\nimport {\n  buildGeneratedDocumentsGetQuery,\n  type GeneratedDocumentsGetQueryData,\n} from '@gusto/embedded-api/react-query/generatedDocumentsGet'\nimport { useGustoEmbeddedContext } from '@gusto/embedded-api/react-query/_context'\nimport { useQueryClient } from '@tanstack/react-query'\nimport { DocumentType } from '@gusto/embedded-api/models/operations/getv1generateddocumentsdocumenttyperequestuuid'\nimport { GeneratedDocumentStatus } from '@gusto/embedded-api/models/components/generateddocument'\nimport { usePollingTask, type PollTickResult } from '@/hooks/usePollingTask/usePollingTask'\n\ntype PrintChecksOutcome = { type: 'succeeded'; url: string | null } | { type: 'failed' }\n\nconst evaluatePrintChecksOutcome = (\n  data: GeneratedDocumentsGetQueryData,\n): PollTickResult<PrintChecksOutcome> => {\n  const status = data.generatedDocument?.status\n  if (status === GeneratedDocumentStatus.Succeeded) {\n    return {\n      done: true,\n      value: { type: 'succeeded', url: data.generatedDocument?.documentUrls?.[0] ?? null },\n    }\n  }\n  if (status === GeneratedDocumentStatus.Failed) {\n    return { done: true, value: { type: 'failed' } }\n  }\n  return { done: false }\n}\n\nconst deadlinePrintChecksOutcome = (\n  lastData: GeneratedDocumentsGetQueryData | null,\n): PrintChecksOutcome => {\n  const status = lastData?.generatedDocument?.status\n  if (status === GeneratedDocumentStatus.Succeeded) {\n    return { type: 'succeeded', url: lastData?.generatedDocument?.documentUrls?.[0] ?? null }\n  }\n  return { type: 'failed' }\n}\n\n/** @internal */\nexport interface UseGenerationPollOptions {\n  onSucceeded: (url: string | null) => void\n  onFailed: () => void\n}\n\n/** @internal */\nexport interface GenerationPoll {\n  /** Starts polling the generated-document status for `requestUuid`. */\n  start: (requestUuid: string) => void\n}\n\n/**\n * Polls a generated print-checks document until it reaches a terminal state, via\n * {@link usePollingTask}.\n *\n * @internal\n */\nexport function useGenerationPoll({\n  onSucceeded,\n  onFailed,\n}: UseGenerationPollOptions): GenerationPoll {\n  const gustoClient = useGustoEmbeddedContext()\n  const queryClient = useQueryClient()\n  const requestUuidRef = useRef<string | null>(null)\n\n  // Unlike the payroll polls, there's no sibling `useGeneratedDocumentsGet` rendering this data —\n  // the result is only ever downloaded, never displayed — so there's no other observer of this\n  // queryKey for this fetchQuery call to race against, and no `refetch` to reuse instead.\n  const fetchGeneratedDocument = (signal: AbortSignal) => {\n    const requestUuid = requestUuidRef.current\n    if (!requestUuid) {\n      throw new Error('usePollingTask started without a print-checks request in flight')\n    }\n    return queryClient.fetchQuery({\n      ...buildGeneratedDocumentsGetQuery(\n        gustoClient,\n        { documentType: DocumentType.PrintablePayrollChecks, requestUuid },\n        { signal },\n      ),\n      staleTime: 0,\n    })\n  }\n\n  const handleOutcome = (outcome: PrintChecksOutcome) => {\n    if (outcome.type === 'failed') {\n      onFailed()\n      return\n    }\n    onSucceeded(outcome.url)\n  }\n\n  const { start: startPoll } = usePollingTask<GeneratedDocumentsGetQueryData, PrintChecksOutcome>({\n    fetch: fetchGeneratedDocument,\n    evaluate: evaluatePrintChecksOutcome,\n    onDone: handleOutcome,\n    onDeadline: lastData => {\n      handleOutcome(deadlinePrintChecksOutcome(lastData))\n    },\n  })\n\n  const start = useCallback(\n    (requestUuid: string) => {\n      requestUuidRef.current = requestUuid\n      startPoll()\n    },\n    [startPoll],\n  )\n\n  return { start }\n}\n"],"names":["evaluatePrintChecksOutcome","data","status","GeneratedDocumentStatus","deadlinePrintChecksOutcome","lastData","useGenerationPoll","onSucceeded","onFailed","gustoClient","useGustoEmbeddedContext","queryClient","useQueryClient","requestUuidRef","useRef","fetchGeneratedDocument","signal","requestUuid","buildGeneratedDocumentsGetQuery","DocumentType","handleOutcome","outcome","startPoll","usePollingTask","useCallback"],"mappings":";;;;;;;AAaA,MAAMA,IAA6B,CACjCC,MACuC;AACvC,QAAMC,IAASD,EAAK,mBAAmB;AACvC,SAAIC,MAAWC,EAAwB,YAC9B;AAAA,IACL,MAAM;AAAA,IACN,OAAO,EAAE,MAAM,aAAa,KAAKF,EAAK,mBAAmB,eAAe,CAAC,KAAK,KAAA;AAAA,EAAK,IAGnFC,MAAWC,EAAwB,SAC9B,EAAE,MAAM,IAAM,OAAO,EAAE,MAAM,WAAS,IAExC,EAAE,MAAM,GAAA;AACjB,GAEMC,IAA6B,CACjCC,MAEeA,GAAU,mBAAmB,WAC7BF,EAAwB,YAC9B,EAAE,MAAM,aAAa,KAAKE,GAAU,mBAAmB,eAAe,CAAC,KAAK,KAAA,IAE9E,EAAE,MAAM,SAAA;AAqBV,SAASC,EAAkB;AAAA,EAChC,aAAAC;AAAA,EACA,UAAAC;AACF,GAA6C;AAC3C,QAAMC,IAAcC,EAAA,GACdC,IAAcC,EAAA,GACdC,IAAiBC,EAAsB,IAAI,GAK3CC,IAAyB,CAACC,MAAwB;AACtD,UAAMC,IAAcJ,EAAe;AACnC,QAAI,CAACI;AACH,YAAM,IAAI,MAAM,iEAAiE;AAEnF,WAAON,EAAY,WAAW;AAAA,MAC5B,GAAGO;AAAA,QACDT;AAAA,QACA,EAAE,cAAcU,EAAa,wBAAwB,aAAAF,EAAA;AAAA,QACrD,EAAE,QAAAD,EAAA;AAAA,MAAO;AAAA,MAEX,WAAW;AAAA,IAAA,CACZ;AAAA,EACH,GAEMI,IAAgB,CAACC,MAAgC;AACrD,QAAIA,EAAQ,SAAS,UAAU;AAC7B,MAAAb,EAAA;AACA;AAAA,IACF;AACA,IAAAD,EAAYc,EAAQ,GAAG;AAAA,EACzB,GAEM,EAAE,OAAOC,EAAA,IAAcC,EAAmE;AAAA,IAC9F,OAAOR;AAAA,IACP,UAAUf;AAAA,IACV,QAAQoB;AAAA,IACR,YAAY,CAAAf,MAAY;AACtB,MAAAe,EAAchB,EAA2BC,CAAQ,CAAC;AAAA,IACpD;AAAA,EAAA,CACD;AAUD,SAAO,EAAE,OARKmB;AAAA,IACZ,CAACP,MAAwB;AACvB,MAAAJ,EAAe,UAAUI,GACzBK,EAAA;AAAA,IACF;AAAA,IACA,CAACA,CAAS;AAAA,EAAA,EAGH;AACX;"}
+{"version":3,"file":"useGenerationPoll.js","sources":["../../../../../src/components/Payroll/PrintChecks/PrintChecksForm/useGenerationPoll.ts"],"sourcesContent":["import { useCallback, useRef } from 'react'\nimport {\n  buildGeneratedDocumentsGetQuery,\n  type GeneratedDocumentsGetQueryData,\n} from '@gusto/embedded-api/react-query/generatedDocumentsGet'\nimport { useGustoEmbeddedContext } from '@gusto/embedded-api/react-query/_context'\nimport { useQueryClient } from '@tanstack/react-query'\nimport { DocumentType } from '@gusto/embedded-api/models/operations/getv1generateddocumentsdocumenttyperequestuuid'\nimport { GeneratedDocumentStatus } from '@gusto/embedded-api/models/components/generateddocument'\nimport {\n  usePollingTask,\n  isNonRetryablePollError,\n  type PollReadOutcome,\n  type PollTickResult,\n} from '@/hooks/usePollingTask/usePollingTask'\nimport { useObservability } from '@/contexts/ObservabilityProvider/useObservability'\nimport { normalizeToSDKError } from '@/types/sdkError'\n\nconst COMPONENT_NAME = 'Payroll.PrintChecksForm'\n\ntype PrintChecksOutcome = { type: 'succeeded'; url: string | null } | { type: 'failed' }\n\n// Verify against the last-known data before reporting failure: a document that already\n// finished generating must never be reported as a failure just because the deadline hit first.\nconst verifiedPrintChecksOutcome = (\n  lastData: GeneratedDocumentsGetQueryData | null,\n): PrintChecksOutcome => {\n  const status = lastData?.generatedDocument?.status\n  if (status === GeneratedDocumentStatus.Succeeded) {\n    return { type: 'succeeded', url: lastData?.generatedDocument?.documentUrls?.[0] ?? null }\n  }\n  return { type: 'failed' }\n}\n\nconst evaluatePrintChecksOutcome = (\n  outcome: PollReadOutcome<GeneratedDocumentsGetQueryData>,\n): PollTickResult<PrintChecksOutcome> => {\n  if (!outcome.success) {\n    return isNonRetryablePollError(outcome.error)\n      ? { status: 'error', error: outcome.error }\n      : { status: 'polling' }\n  }\n\n  const status = outcome.data.generatedDocument?.status\n  if (status === GeneratedDocumentStatus.Succeeded) {\n    return {\n      status: 'done',\n      value: { type: 'succeeded', url: outcome.data.generatedDocument?.documentUrls?.[0] ?? null },\n    }\n  }\n  if (status === GeneratedDocumentStatus.Failed) {\n    return { status: 'done', value: { type: 'failed' } }\n  }\n  return { status: 'polling' }\n}\n\n/** @internal */\nexport interface UseGenerationPollOptions {\n  onSucceeded: (url: string | null) => void\n  onFailed: () => void\n}\n\n/** @internal */\nexport interface GenerationPoll {\n  /** Starts polling the generated-document status for `requestUuid`. */\n  start: (requestUuid: string) => void\n}\n\n/**\n * Polls a generated print-checks document until it reaches a terminal state, via\n * {@link usePollingTask}.\n *\n * @internal\n */\nexport function useGenerationPoll({\n  onSucceeded,\n  onFailed,\n}: UseGenerationPollOptions): GenerationPoll {\n  const gustoClient = useGustoEmbeddedContext()\n  const queryClient = useQueryClient()\n  const requestUuidRef = useRef<string | null>(null)\n  const { observability } = useObservability()\n\n  // Unlike the payroll polls, there's no sibling `useGeneratedDocumentsGet` rendering this data —\n  // the result is only ever downloaded, never displayed — so there's no other observer of this\n  // queryKey for this fetchQuery call to race against, and no `refetch` to reuse instead.\n  const fetchGeneratedDocument = (signal: AbortSignal) => {\n    const requestUuid = requestUuidRef.current\n    if (!requestUuid) {\n      throw new Error('usePollingTask started without a print-checks request in flight')\n    }\n    return queryClient.fetchQuery({\n      ...buildGeneratedDocumentsGetQuery(\n        gustoClient,\n        { documentType: DocumentType.PrintablePayrollChecks, requestUuid },\n        { signal },\n      ),\n      staleTime: 0,\n    })\n  }\n\n  const handleOutcome = (outcome: PrintChecksOutcome) => {\n    if (outcome.type === 'failed') {\n      onFailed()\n      return\n    }\n    onSucceeded(outcome.url)\n  }\n\n  const { start: startPoll } = usePollingTask<GeneratedDocumentsGetQueryData, PrintChecksOutcome>({\n    fetch: fetchGeneratedDocument,\n    evaluate: evaluatePrintChecksOutcome,\n    onDone: handleOutcome,\n    // Unlike the payroll polls, print-checks generation has no equivalent to prepare/resubmit to\n    // guard against, so a non-retryable read error can safely reuse the same failure path as a\n    // real generation failure — same screen, same retry CTA.\n    onError: error => {\n      const sdkError = normalizeToSDKError(error)\n      observability?.onError?.({\n        ...sdkError,\n        timestamp: Date.now(),\n        componentName: COMPONENT_NAME,\n      })\n      onFailed()\n    },\n    onDeadline: lastData => {\n      handleOutcome(verifiedPrintChecksOutcome(lastData))\n    },\n  })\n\n  const start = useCallback(\n    (requestUuid: string) => {\n      requestUuidRef.current = requestUuid\n      startPoll()\n    },\n    [startPoll],\n  )\n\n  return { start }\n}\n"],"names":["COMPONENT_NAME","verifiedPrintChecksOutcome","lastData","GeneratedDocumentStatus","evaluatePrintChecksOutcome","outcome","isNonRetryablePollError","status","useGenerationPoll","onSucceeded","onFailed","gustoClient","useGustoEmbeddedContext","queryClient","useQueryClient","requestUuidRef","useRef","observability","useObservability","fetchGeneratedDocument","signal","requestUuid","buildGeneratedDocumentsGetQuery","DocumentType","handleOutcome","startPoll","usePollingTask","error","sdkError","normalizeToSDKError","useCallback"],"mappings":";;;;;;;;;AAkBA,MAAMA,IAAiB,2BAMjBC,IAA6B,CACjCC,MAEeA,GAAU,mBAAmB,WAC7BC,EAAwB,YAC9B,EAAE,MAAM,aAAa,KAAKD,GAAU,mBAAmB,eAAe,CAAC,KAAK,KAAA,IAE9E,EAAE,MAAM,SAAA,GAGXE,IAA6B,CACjCC,MACuC;AACvC,MAAI,CAACA,EAAQ;AACX,WAAOC,EAAwBD,EAAQ,KAAK,IACxC,EAAE,QAAQ,SAAS,OAAOA,EAAQ,MAAA,IAClC,EAAE,QAAQ,UAAA;AAGhB,QAAME,IAASF,EAAQ,KAAK,mBAAmB;AAC/C,SAAIE,MAAWJ,EAAwB,YAC9B;AAAA,IACL,QAAQ;AAAA,IACR,OAAO,EAAE,MAAM,aAAa,KAAKE,EAAQ,KAAK,mBAAmB,eAAe,CAAC,KAAK,KAAA;AAAA,EAAK,IAG3FE,MAAWJ,EAAwB,SAC9B,EAAE,QAAQ,QAAQ,OAAO,EAAE,MAAM,WAAS,IAE5C,EAAE,QAAQ,UAAA;AACnB;AAoBO,SAASK,EAAkB;AAAA,EAChC,aAAAC;AAAA,EACA,UAAAC;AACF,GAA6C;AAC3C,QAAMC,IAAcC,EAAA,GACdC,IAAcC,EAAA,GACdC,IAAiBC,EAAsB,IAAI,GAC3C,EAAE,eAAAC,EAAA,IAAkBC,EAAA,GAKpBC,IAAyB,CAACC,MAAwB;AACtD,UAAMC,IAAcN,EAAe;AACnC,QAAI,CAACM;AACH,YAAM,IAAI,MAAM,iEAAiE;AAEnF,WAAOR,EAAY,WAAW;AAAA,MAC5B,GAAGS;AAAA,QACDX;AAAA,QACA,EAAE,cAAcY,EAAa,wBAAwB,aAAAF,EAAA;AAAA,QACrD,EAAE,QAAAD,EAAA;AAAA,MAAO;AAAA,MAEX,WAAW;AAAA,IAAA,CACZ;AAAA,EACH,GAEMI,IAAgB,CAACnB,MAAgC;AACrD,QAAIA,EAAQ,SAAS,UAAU;AAC7B,MAAAK,EAAA;AACA;AAAA,IACF;AACA,IAAAD,EAAYJ,EAAQ,GAAG;AAAA,EACzB,GAEM,EAAE,OAAOoB,EAAA,IAAcC,EAAmE;AAAA,IAC9F,OAAOP;AAAA,IACP,UAAUf;AAAA,IACV,QAAQoB;AAAA;AAAA;AAAA;AAAA,IAIR,SAAS,CAAAG,MAAS;AAChB,YAAMC,IAAWC,EAAoBF,CAAK;AAC1C,MAAAV,GAAe,UAAU;AAAA,QACvB,GAAGW;AAAA,QACH,WAAW,KAAK,IAAA;AAAA,QAChB,eAAe5B;AAAA,MAAA,CAChB,GACDU,EAAA;AAAA,IACF;AAAA,IACA,YAAY,CAAAR,MAAY;AACtB,MAAAsB,EAAcvB,EAA2BC,CAAQ,CAAC;AAAA,IACpD;AAAA,EAAA,CACD;AAUD,SAAO,EAAE,OARK4B;AAAA,IACZ,CAACT,MAAwB;AACvB,MAAAN,EAAe,UAAUM,GACzBI,EAAA;AAAA,IACF;AAAA,IACA,CAACA,CAAS;AAAA,EAAA,EAGH;AACX;"}

package/dist/components/Payroll/usePreparedPayrollData.js

@@ -15,8 +15,9 @@ import "dompurify";
 import "../../contexts/LocaleProvider/useLocale.js";
 import "../../shared/constants.js";
 import "../../contexts/ComponentAdapter/useComponentContext.js";
+import "../../contexts/LoadingIndicatorProvider/useLoadingIndicator.js";
 import { retryAsync as x } from "../../helpers/retryAsync.js";
-const q = 4, v = 1500, B = (e) => e instanceof T ? e.errors.some((r) => r.category === "invalid_operation") : !1, Z = ({
+const q = 4, v = 1500, B = (e) => e instanceof T ? e.errors.some((r) => r.category === "invalid_operation") : !1, $ = ({
   companyId: e,
   payrollId: r,
   employeeUuids: a,
@@ -32,7 +33,7 @@ const q = 4, v = 1500, B = (e) => e instanceof T ? e.errors.some((r) => r.catego
       enabled: !!o?.payPeriod?.payScheduleUuid
     }
   ), P = y(async () => {
-    const i = await p({
+    const s = await p({
       request: {
         companyId: e,
         payrollId: r,
@@ -42,8 +43,8 @@ const q = 4, v = 1500, B = (e) => e instanceof T ? e.errors.some((r) => r.catego
         }
       }
     });
-    f(i.payrollPrepared), i.payrollPrepared && (t.current = !0, l?.(i.payrollPrepared));
-  }, [e, r, p, h, n, l]), s = y(async () => {
+    f(s.payrollPrepared), s.payrollPrepared && (t.current = !0, l?.(s.payrollPrepared));
+  }, [e, r, p, h, n, l]), i = y(async () => {
     await d(
       null,
       () => x(P, {
@@ -54,11 +55,11 @@ const q = 4, v = 1500, B = (e) => e instanceof T ? e.errors.some((r) => r.catego
     );
   }, [d, P]);
   b(() => {
-    u.current || (u.current = !0, s());
-  }, [s]);
+    u.current || (u.current = !0, i());
+  }, [i]);
   const g = c && !t.current, R = c && t.current, A = g || E;
   return {
-    handlePreparePayroll: s,
+    handlePreparePayroll: i,
     preparedPayroll: o,
     paySchedule: S?.payScheduleShow,
     isLoading: A,
@@ -67,6 +68,6 @@ const q = 4, v = 1500, B = (e) => e instanceof T ? e.errors.some((r) => r.catego
   };
 };
 export {
-  Z as usePreparedPayrollData
+  $ as usePreparedPayrollData
 };
 //# sourceMappingURL=usePreparedPayrollData.js.map

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

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

package/dist/contexts/ApiProvider/ApiProvider.js

@@ -1,43 +1,44 @@
 import { jsx as u } from "react/jsx-runtime";
-import { QueryClientProvider as E } from "@tanstack/react-query";
+import { QueryClientProvider as k } from "@tanstack/react-query";
 import { GustoEmbeddedProvider as R } from "@gusto/embedded-api/react-query/_context";
-import { GustoEmbeddedCore as q } from "@gusto/embedded-api/core";
-import { SDKHooks as C } from "@gusto/embedded-api/hooks/hooks";
-import { useMemo as a } from "react";
-import { apiVersionHook as b } from "./apiVersionHook.js";
-import { createSdkQueryClient as g } from "./createSdkQueryClient.js";
-function G({
+import { GustoEmbeddedCore as g } from "@gusto/embedded-api/core";
+import { SDKHooks as q } from "@gusto/embedded-api/hooks/hooks";
+import { useMemo as m } from "react";
+import { apiVersionHook as C } from "./apiVersionHook.js";
+import { apiVersionMismatchHook as a } from "./apiVersionMismatchHook.js";
+import { createSdkQueryClient as b } from "./createSdkQueryClient.js";
+function I({
   url: s,
   headers: i,
   hooks: e,
-  children: m,
+  children: d,
   queryClient: f
 }) {
-  const d = a(() => {
-    const t = new q({
+  const p = m(() => {
+    const t = new g({
       serverURL: s
-    }), o = t._options.hooks || new C();
-    if (o.registerBeforeRequestHook(b), i) {
-      const r = {
-        beforeRequest: (k, n) => (new Headers(i).forEach((c, H) => {
-          c && n.headers.set(H, c);
+    }), r = t._options.hooks || new q();
+    if (r.registerBeforeRequestHook(C), r.registerAfterSuccessHook(a), r.registerAfterErrorHook(a), i) {
+      const o = {
+        beforeRequest: (l, n) => (new Headers(i).forEach((c, E) => {
+          c && n.headers.set(E, c);
         }), n)
       };
-      o.registerBeforeRequestHook(r);
+      r.registerBeforeRequestHook(o);
     }
-    return e?.beforeCreateRequest && e.beforeCreateRequest.forEach((r) => {
-      o.registerBeforeCreateRequestHook(r);
-    }), e?.beforeRequest && e.beforeRequest.forEach((r) => {
-      o.registerBeforeRequestHook(r);
-    }), e?.afterSuccess && e.afterSuccess.forEach((r) => {
-      o.registerAfterSuccessHook(r);
-    }), e?.afterError && e.afterError.forEach((r) => {
-      o.registerAfterErrorHook(r);
-    }), t._options.hooks || (t._options.hooks = o), t;
-  }, [s, i, e]), p = a(() => f ?? g(), [f]);
-  return /* @__PURE__ */ u(E, { client: p, children: /* @__PURE__ */ u(R, { client: d, children: m }) });
+    return e?.beforeCreateRequest && e.beforeCreateRequest.forEach((o) => {
+      r.registerBeforeCreateRequestHook(o);
+    }), e?.beforeRequest && e.beforeRequest.forEach((o) => {
+      r.registerBeforeRequestHook(o);
+    }), e?.afterSuccess && e.afterSuccess.forEach((o) => {
+      r.registerAfterSuccessHook(o);
+    }), e?.afterError && e.afterError.forEach((o) => {
+      r.registerAfterErrorHook(o);
+    }), t._options.hooks || (t._options.hooks = r), t;
+  }, [s, i, e]), H = m(() => f ?? b(), [f]);
+  return /* @__PURE__ */ u(k, { client: H, children: /* @__PURE__ */ u(R, { client: p, children: d }) });
 }
 export {
-  G as ApiProvider
+  I as ApiProvider
 };
 //# sourceMappingURL=ApiProvider.js.map

package/dist/contexts/ApiProvider/ApiProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"ApiProvider.js","sources":["../../../src/contexts/ApiProvider/ApiProvider.tsx"],"sourcesContent":["import { QueryClientProvider, type QueryClient } from '@tanstack/react-query'\nimport { GustoEmbeddedProvider } from '@gusto/embedded-api/react-query/_context'\nimport { GustoEmbeddedCore } from '@gusto/embedded-api/core'\nimport { SDKHooks as NativeSDKHooks } from '@gusto/embedded-api/hooks/hooks'\nimport { useMemo } from 'react'\nimport { apiVersionHook } from './apiVersionHook'\nimport { createSdkQueryClient } from './createSdkQueryClient'\nimport type { SDKHooks, BeforeRequestHook } from '@/types/hooks'\n\n/**\n * Props for {@link ApiProvider}.\n *\n * @internal\n */\nexport interface ApiProviderProps {\n  /** Base URL the SDK uses for all `@gusto/embedded-api-v-2026-06-15` requests. */\n  url: string\n  /** Default headers applied to every SDK request, in addition to the `X-Gusto-API-Version` header set automatically. */\n  headers?: HeadersInit\n  /** Lifecycle hooks for intercepting and modifying SDK requests and responses. */\n  hooks?: SDKHooks\n  /** Subtree that renders inside the API + React Query providers. */\n  children: React.ReactNode\n  /** Optional React Query client. When omitted, a client is created with the SDK's defaults (auto-invalidation on mutation success). */\n  queryClient?: QueryClient\n}\n\n/**\n * Wires the `@gusto/embedded-api-v-2026-06-15` client and a React Query client into the React tree.\n *\n * @remarks\n * Registers the SDK's `X-Gusto-API-Version` header on every request, applies any default `headers`,\n * and registers user-supplied lifecycle hooks (`beforeCreateRequest`, `beforeRequest`, `afterSuccess`,\n * `afterError`). When no `queryClient` is supplied, one is created with the SDK's defaults so\n * successful mutations under the `['@gusto/embedded-api-v-2026-06-15']` key invalidate every SDK\n * query automatically. Partners who supply their own `QueryClient` are responsible for matching that\n * contract.\n *\n * Typically wrapped by {@link GustoProvider}; use directly only when composing the provider stack\n * manually.\n *\n * @param props - See {@link ApiProviderProps}.\n * @returns A React subtree wrapped in `QueryClientProvider` and the embedded API context.\n * @internal\n */\nexport function ApiProvider({\n  url,\n  headers,\n  hooks,\n  children,\n  queryClient: queryClientFromProps,\n}: ApiProviderProps) {\n  const gustoClient = useMemo(() => {\n    const client = new GustoEmbeddedCore({\n      serverURL: url,\n    })\n\n    const sdkHooks = client._options.hooks || new NativeSDKHooks()\n\n    sdkHooks.registerBeforeRequestHook(apiVersionHook)\n\n    if (headers) {\n      const defaultHeaderHook: BeforeRequestHook = {\n        beforeRequest: (context, request) => {\n          const headersInstance = new Headers(headers)\n          headersInstance.forEach((headerValue, headerName) => {\n            if (headerValue) {\n              request.headers.set(headerName, headerValue)\n            }\n          })\n          return request\n        },\n      }\n      sdkHooks.registerBeforeRequestHook(defaultHeaderHook)\n    }\n\n    if (hooks?.beforeCreateRequest) {\n      hooks.beforeCreateRequest.forEach(hook => {\n        sdkHooks.registerBeforeCreateRequestHook(hook)\n      })\n    }\n\n    if (hooks?.beforeRequest) {\n      hooks.beforeRequest.forEach(hook => {\n        sdkHooks.registerBeforeRequestHook(hook)\n      })\n    }\n\n    if (hooks?.afterSuccess) {\n      hooks.afterSuccess.forEach(hook => {\n        sdkHooks.registerAfterSuccessHook(hook)\n      })\n    }\n\n    if (hooks?.afterError) {\n      hooks.afterError.forEach(hook => {\n        sdkHooks.registerAfterErrorHook(hook)\n      })\n    }\n\n    if (!client._options.hooks) {\n      client._options.hooks = sdkHooks\n    }\n\n    return client\n  }, [url, headers, hooks])\n\n  const queryClient = useMemo(() => {\n    return queryClientFromProps ?? createSdkQueryClient()\n  }, [queryClientFromProps])\n\n  return (\n    <QueryClientProvider client={queryClient}>\n      <GustoEmbeddedProvider client={gustoClient}>{children}</GustoEmbeddedProvider>\n    </QueryClientProvider>\n  )\n}\n"],"names":["ApiProvider","url","headers","hooks","children","queryClientFromProps","gustoClient","useMemo","client","GustoEmbeddedCore","sdkHooks","NativeSDKHooks","apiVersionHook","defaultHeaderHook","context","request","headerValue","headerName","hook","queryClient","createSdkQueryClient","jsx","QueryClientProvider","GustoEmbeddedProvider"],"mappings":";;;;;;;;AA6CO,SAASA,EAAY;AAAA,EAC1B,KAAAC;AAAA,EACA,SAAAC;AAAA,EACA,OAAAC;AAAA,EACA,UAAAC;AAAA,EACA,aAAaC;AACf,GAAqB;AACnB,QAAMC,IAAcC,EAAQ,MAAM;AAChC,UAAMC,IAAS,IAAIC,EAAkB;AAAA,MACnC,WAAWR;AAAA,IAAA,CACZ,GAEKS,IAAWF,EAAO,SAAS,SAAS,IAAIG,EAAA;AAI9C,QAFAD,EAAS,0BAA0BE,CAAc,GAE7CV,GAAS;AACX,YAAMW,IAAuC;AAAA,QAC3C,eAAe,CAACC,GAASC,OACC,IAAI,QAAQb,CAAO,EAC3B,QAAQ,CAACc,GAAaC,MAAe;AACnD,UAAID,KACFD,EAAQ,QAAQ,IAAIE,GAAYD,CAAW;AAAA,QAE/C,CAAC,GACMD;AAAA,MACT;AAEF,MAAAL,EAAS,0BAA0BG,CAAiB;AAAA,IACtD;AAEA,WAAIV,GAAO,uBACTA,EAAM,oBAAoB,QAAQ,CAAAe,MAAQ;AACxC,MAAAR,EAAS,gCAAgCQ,CAAI;AAAA,IAC/C,CAAC,GAGCf,GAAO,iBACTA,EAAM,cAAc,QAAQ,CAAAe,MAAQ;AAClC,MAAAR,EAAS,0BAA0BQ,CAAI;AAAA,IACzC,CAAC,GAGCf,GAAO,gBACTA,EAAM,aAAa,QAAQ,CAAAe,MAAQ;AACjC,MAAAR,EAAS,yBAAyBQ,CAAI;AAAA,IACxC,CAAC,GAGCf,GAAO,cACTA,EAAM,WAAW,QAAQ,CAAAe,MAAQ;AAC/B,MAAAR,EAAS,uBAAuBQ,CAAI;AAAA,IACtC,CAAC,GAGEV,EAAO,SAAS,UACnBA,EAAO,SAAS,QAAQE,IAGnBF;AAAA,EACT,GAAG,CAACP,GAAKC,GAASC,CAAK,CAAC,GAElBgB,IAAcZ,EAAQ,MACnBF,KAAwBe,EAAA,GAC9B,CAACf,CAAoB,CAAC;AAEzB,SACE,gBAAAgB,EAACC,KAAoB,QAAQH,GAC3B,4BAACI,GAAA,EAAsB,QAAQjB,GAAc,UAAAF,EAAA,CAAS,EAAA,CACxD;AAEJ;"}
+{"version":3,"file":"ApiProvider.js","sources":["../../../src/contexts/ApiProvider/ApiProvider.tsx"],"sourcesContent":["import { QueryClientProvider, type QueryClient } from '@tanstack/react-query'\nimport { GustoEmbeddedProvider } from '@gusto/embedded-api/react-query/_context'\nimport { GustoEmbeddedCore } from '@gusto/embedded-api/core'\nimport { SDKHooks as NativeSDKHooks } from '@gusto/embedded-api/hooks/hooks'\nimport { useMemo } from 'react'\nimport { apiVersionHook } from './apiVersionHook'\nimport { apiVersionMismatchHook } from './apiVersionMismatchHook'\nimport { createSdkQueryClient } from './createSdkQueryClient'\nimport type { SDKHooks, BeforeRequestHook } from '@/types/hooks'\n\n/**\n * Props for {@link ApiProvider}.\n *\n * @internal\n */\nexport interface ApiProviderProps {\n  /** Base URL the SDK uses for all `@gusto/embedded-api-v-2026-06-15` requests. */\n  url: string\n  /** Default headers applied to every SDK request, in addition to the `X-Gusto-API-Version` header set automatically. */\n  headers?: HeadersInit\n  /** Lifecycle hooks for intercepting and modifying SDK requests and responses. */\n  hooks?: SDKHooks\n  /** Subtree that renders inside the API + React Query providers. */\n  children: React.ReactNode\n  /** Optional React Query client. When omitted, a client is created with the SDK's defaults (auto-invalidation on mutation success). */\n  queryClient?: QueryClient\n}\n\n/**\n * Wires the `@gusto/embedded-api-v-2026-06-15` client and a React Query client into the React tree.\n *\n * @remarks\n * Registers the SDK's `X-Gusto-API-Version` header on every request, warns via `console.warn` if a\n * response reports a different `X-Gusto-API-Version` than was requested (e.g. a proxy rewriting the\n * header), applies any default `headers`, and registers user-supplied lifecycle hooks\n * (`beforeCreateRequest`, `beforeRequest`, `afterSuccess`, `afterError`). When no `queryClient` is\n * supplied, one is created with the SDK's defaults so\n * successful mutations under the `['@gusto/embedded-api-v-2026-06-15']` key invalidate every SDK\n * query automatically. Partners who supply their own `QueryClient` are responsible for matching that\n * contract.\n *\n * Typically wrapped by {@link GustoProvider}; use directly only when composing the provider stack\n * manually.\n *\n * @param props - See {@link ApiProviderProps}.\n * @returns A React subtree wrapped in `QueryClientProvider` and the embedded API context.\n * @internal\n */\nexport function ApiProvider({\n  url,\n  headers,\n  hooks,\n  children,\n  queryClient: queryClientFromProps,\n}: ApiProviderProps) {\n  const gustoClient = useMemo(() => {\n    const client = new GustoEmbeddedCore({\n      serverURL: url,\n    })\n\n    const sdkHooks = client._options.hooks || new NativeSDKHooks()\n\n    sdkHooks.registerBeforeRequestHook(apiVersionHook)\n    sdkHooks.registerAfterSuccessHook(apiVersionMismatchHook)\n    sdkHooks.registerAfterErrorHook(apiVersionMismatchHook)\n\n    if (headers) {\n      const defaultHeaderHook: BeforeRequestHook = {\n        beforeRequest: (context, request) => {\n          const headersInstance = new Headers(headers)\n          headersInstance.forEach((headerValue, headerName) => {\n            if (headerValue) {\n              request.headers.set(headerName, headerValue)\n            }\n          })\n          return request\n        },\n      }\n      sdkHooks.registerBeforeRequestHook(defaultHeaderHook)\n    }\n\n    if (hooks?.beforeCreateRequest) {\n      hooks.beforeCreateRequest.forEach(hook => {\n        sdkHooks.registerBeforeCreateRequestHook(hook)\n      })\n    }\n\n    if (hooks?.beforeRequest) {\n      hooks.beforeRequest.forEach(hook => {\n        sdkHooks.registerBeforeRequestHook(hook)\n      })\n    }\n\n    if (hooks?.afterSuccess) {\n      hooks.afterSuccess.forEach(hook => {\n        sdkHooks.registerAfterSuccessHook(hook)\n      })\n    }\n\n    if (hooks?.afterError) {\n      hooks.afterError.forEach(hook => {\n        sdkHooks.registerAfterErrorHook(hook)\n      })\n    }\n\n    if (!client._options.hooks) {\n      client._options.hooks = sdkHooks\n    }\n\n    return client\n  }, [url, headers, hooks])\n\n  const queryClient = useMemo(() => {\n    return queryClientFromProps ?? createSdkQueryClient()\n  }, [queryClientFromProps])\n\n  return (\n    <QueryClientProvider client={queryClient}>\n      <GustoEmbeddedProvider client={gustoClient}>{children}</GustoEmbeddedProvider>\n    </QueryClientProvider>\n  )\n}\n"],"names":["ApiProvider","url","headers","hooks","children","queryClientFromProps","gustoClient","useMemo","client","GustoEmbeddedCore","sdkHooks","NativeSDKHooks","apiVersionHook","apiVersionMismatchHook","defaultHeaderHook","context","request","headerValue","headerName","hook","queryClient","createSdkQueryClient","jsx","QueryClientProvider","GustoEmbeddedProvider"],"mappings":";;;;;;;;;AAgDO,SAASA,EAAY;AAAA,EAC1B,KAAAC;AAAA,EACA,SAAAC;AAAA,EACA,OAAAC;AAAA,EACA,UAAAC;AAAA,EACA,aAAaC;AACf,GAAqB;AACnB,QAAMC,IAAcC,EAAQ,MAAM;AAChC,UAAMC,IAAS,IAAIC,EAAkB;AAAA,MACnC,WAAWR;AAAA,IAAA,CACZ,GAEKS,IAAWF,EAAO,SAAS,SAAS,IAAIG,EAAA;AAM9C,QAJAD,EAAS,0BAA0BE,CAAc,GACjDF,EAAS,yBAAyBG,CAAsB,GACxDH,EAAS,uBAAuBG,CAAsB,GAElDX,GAAS;AACX,YAAMY,IAAuC;AAAA,QAC3C,eAAe,CAACC,GAASC,OACC,IAAI,QAAQd,CAAO,EAC3B,QAAQ,CAACe,GAAaC,MAAe;AACnD,UAAID,KACFD,EAAQ,QAAQ,IAAIE,GAAYD,CAAW;AAAA,QAE/C,CAAC,GACMD;AAAA,MACT;AAEF,MAAAN,EAAS,0BAA0BI,CAAiB;AAAA,IACtD;AAEA,WAAIX,GAAO,uBACTA,EAAM,oBAAoB,QAAQ,CAAAgB,MAAQ;AACxC,MAAAT,EAAS,gCAAgCS,CAAI;AAAA,IAC/C,CAAC,GAGChB,GAAO,iBACTA,EAAM,cAAc,QAAQ,CAAAgB,MAAQ;AAClC,MAAAT,EAAS,0BAA0BS,CAAI;AAAA,IACzC,CAAC,GAGChB,GAAO,gBACTA,EAAM,aAAa,QAAQ,CAAAgB,MAAQ;AACjC,MAAAT,EAAS,yBAAyBS,CAAI;AAAA,IACxC,CAAC,GAGChB,GAAO,cACTA,EAAM,WAAW,QAAQ,CAAAgB,MAAQ;AAC/B,MAAAT,EAAS,uBAAuBS,CAAI;AAAA,IACtC,CAAC,GAGEX,EAAO,SAAS,UACnBA,EAAO,SAAS,QAAQE,IAGnBF;AAAA,EACT,GAAG,CAACP,GAAKC,GAASC,CAAK,CAAC,GAElBiB,IAAcb,EAAQ,MACnBF,KAAwBgB,EAAA,GAC9B,CAAChB,CAAoB,CAAC;AAEzB,SACE,gBAAAiB,EAACC,KAAoB,QAAQH,GAC3B,4BAACI,GAAA,EAAsB,QAAQlB,GAAc,UAAAF,EAAA,CAAS,EAAA,CACxD;AAEJ;"}

package/dist/contexts/ApiProvider/apiVersionMismatchHook.js

@@ -0,0 +1,15 @@
+import { API_VERSION as s } from "./apiVersion.js";
+function t(r, e) {
+  const o = e?.headers.get("X-Gusto-API-Version");
+  o && o !== s && console.warn(
+    `[@gusto/embedded-react-sdk] Requested API version ${s} for "${r}", but the response reported version ${o}. This usually means something between the SDK and Gusto (e.g. a proxy) is rewriting the X-Gusto-API-Version header, which can cause the response to be parsed against the wrong schema.`
+  );
+}
+const a = {
+  afterSuccess: (r, e) => (t(r.operationID, e), e),
+  afterError: (r, e, o) => (t(r.operationID, e), { response: e, error: o })
+};
+export {
+  a as apiVersionMismatchHook
+};
+//# sourceMappingURL=apiVersionMismatchHook.js.map

package/dist/contexts/ApiProvider/apiVersionMismatchHook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiVersionMismatchHook.js","sources":["../../../src/contexts/ApiProvider/apiVersionMismatchHook.ts"],"sourcesContent":["import { API_VERSION } from './apiVersion'\nimport type { AfterErrorHook, AfterSuccessHook } from '@/types/hooks'\n\nfunction warnOnVersionMismatch(operationID: string, response: Response | null) {\n  const responseVersion = response?.headers.get('X-Gusto-API-Version')\n  if (responseVersion && responseVersion !== API_VERSION) {\n    // eslint-disable-next-line no-console\n    console.warn(\n      `[@gusto/embedded-react-sdk] Requested API version ${API_VERSION} for \"${operationID}\", but the response reported version ${responseVersion}. This usually means something between the SDK and Gusto (e.g. a proxy) is rewriting the X-Gusto-API-Version header, which can cause the response to be parsed against the wrong schema.`,\n    )\n  }\n}\n\n/** @internal */\nexport const apiVersionMismatchHook: AfterSuccessHook & AfterErrorHook = {\n  afterSuccess: (context, response) => {\n    warnOnVersionMismatch(context.operationID, response)\n    return response\n  },\n  afterError: (context, response, error) => {\n    warnOnVersionMismatch(context.operationID, response)\n    return { response, error }\n  },\n}\n"],"names":["warnOnVersionMismatch","operationID","response","responseVersion","API_VERSION","apiVersionMismatchHook","context","error"],"mappings":";AAGA,SAASA,EAAsBC,GAAqBC,GAA2B;AAC7E,QAAMC,IAAkBD,GAAU,QAAQ,IAAI,qBAAqB;AACnE,EAAIC,KAAmBA,MAAoBC,KAEzC,QAAQ;AAAA,IACN,qDAAqDA,CAAW,SAASH,CAAW,wCAAwCE,CAAe;AAAA,EAAA;AAGjJ;AAGO,MAAME,IAA4D;AAAA,EACvE,cAAc,CAACC,GAASJ,OACtBF,EAAsBM,EAAQ,aAAaJ,CAAQ,GAC5CA;AAAA,EAET,YAAY,CAACI,GAASJ,GAAUK,OAC9BP,EAAsBM,EAAQ,aAAaJ,CAAQ,GAC5C,EAAE,UAAAA,GAAU,OAAAK,EAAA;AAEvB;"}

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, 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 { UnstableFeaturesProvider } from '../UnstableFeaturesProvider/UnstableFeaturesProvider'\nimport type { UnstableFeatures } from '../UnstableFeaturesProvider/useUnstableFeature'\nimport { SDKI18next } from './SDKI18next'\nimport { InternalError } from '@/components/Common'\nimport { LocaleProvider } from '@/contexts/LocaleProvider'\nimport { NonceContext } from '@/contexts/NonceProvider'\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  /**\n   * CSP nonce to apply to runtime-injected `<style>` elements (theming, PDF download window).\n   * Pass the same per-request nonce your app uses in its `style-src 'nonce-…'` directive.\n   * Also exposed to custom UI components via `useNonce`.\n   */\n  nonce?: string\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   * Opt-in flags for alpha SDK functionality. See {@link UnstableFeatures}.\n   * @alpha\n   */\n  unstableFeatures?: UnstableFeatures\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 * @group Providers\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    nonce,\n    portalContainer,\n    components,\n    LoaderComponent,\n    queryClient,\n    unstableFeatures,\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    <NonceContext.Provider value={nonce}>\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                      <UnstableFeaturesProvider value={unstableFeatures}>\n                        {children}\n                      </UnstableFeaturesProvider>\n                    </ApiProvider>\n                  </I18nextProvider>\n                </LocaleProvider>\n              </ThemeProvider>\n            </ErrorBoundary>\n          </ObservabilityProvider>\n        </LoadingIndicatorProvider>\n      </ComponentsProvider>\n    </NonceContext.Provider>\n  )\n}\n"],"names":["GustoProviderCustomUIAdapter","props","children","config","dictionary","lng","locale","currency","theme","nonce","portalContainer","components","LoaderComponent","queryClient","unstableFeatures","language","lang","ns","SDKI18next","useEffect","handleTopLevelError","useMemo","error","errorInfo","observabilityError","normalizeToSDKError","sanitizedError","sanitizeError","NonceContext","jsx","ComponentsProvider","LoadingIndicatorProvider","ObservabilityProvider","ErrorBoundary","InternalError","ThemeProvider","LocaleProvider","I18nextProvider","ApiProvider","UnstableFeaturesProvider"],"mappings":";;;;;;;;;;;;;;;;;AAwGO,SAASA,GAA6BC,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,OAAAC;AAAA,IACA,iBAAAC;AAAA,IACA,YAAAC;AAAA,IACA,iBAAAC;AAAA,IACA,aAAAC;AAAA,IACA,kBAAAC;AAAA,EAAA,IACEb;AAEJ,MAAIG;AACF,eAAWW,KAAYX,GAAY;AACjC,YAAMY,IAAOD;AACb,iBAAWE,KAAMb,EAAWY,CAAI;AAC9B,QAAAE,EAAW;AAAA,UACTF;AAAA,UACAC;AAAA,UACCb,EAAWY,CAAI,EAA8BC,CAAE;AAAA,UAChD;AAAA,UACA;AAAA,QAAA;AAAA,IAGN;AAGF,EAAAE,EAAU,MAAM;AACd,KAAM,YACJ,MAAMD,EAAW,eAAeb,CAAG;AAAA,EAEvC,GAAG,CAACA,CAAG,CAAC;AAER,QAAMe,IAAsBC,EAAQ,MAAM;AACxC,QAAKlB,EAAO,eAAe;AAE3B,aAAO,CAACmB,GAAgBC,MAAyB;AAC/C,YAAI,CAACpB,EAAO,eAAe,QAAS;AAIpC,cAAMqB,IAAqB;AAAA,UACzB,GAHeC,EAAoBH,CAAK;AAAA,UAIxC,WAAW,KAAK,IAAA;AAAA,UAChB,gBAAgBC,EAAU,kBAAkB;AAAA,QAAA,GAGxCG,IAAiBC,EAAcH,GAAoBrB,EAAO,cAAc,YAAY;AAE1F,QAAAA,EAAO,cAAc,QAAQuB,CAAc;AAAA,MAC7C;AAAA,EACF,GAAG,CAACvB,EAAO,aAAa,CAAC;AACzB,2BACGyB,EAAa,UAAb,EAAsB,OAAOnB,GAC5B,UAAA,gBAAAoB,EAACC,GAAA,EAAmB,OAAOnB,GACzB,4BAACoB,GAAA,EAAyB,OAAOnB,GAC/B,UAAA,gBAAAiB,EAACG,KAAsB,eAAe7B,EAAO,eAC3C,UAAA,gBAAA0B,EAACI,KAAc,mBAAmBC,GAAe,SAASd,GACxD,4BAACe,GAAA,EAAc,OAAA3B,GAAc,iBAAAE,GAC3B,UAAA,gBAAAmB,EAACO,KAAe,QAAA9B,GAAgB,UAAAC,GAC9B,UAAA,gBAAAsB,EAACQ,GAAA,EAAgB,MAAMnB,GACrB,UAAA,gBAAAW;AAAA,IAACS;AAAA,IAAA;AAAA,MACC,KAAKnC,EAAO;AAAA,MACZ,SAASA,EAAO;AAAA,MAChB,OAAOA,EAAO;AAAA,MACd,aAAAU;AAAA,MAEA,UAAA,gBAAAgB,EAACU,GAAA,EAAyB,OAAOzB,GAC9B,UAAAZ,EAAA,CACH;AAAA,IAAA;AAAA,EAAA,KAToCG,CAWxC,EAAA,CACF,EAAA,CACF,GACF,GACF,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 { UnstableFeaturesProvider } from '../UnstableFeaturesProvider/UnstableFeaturesProvider'\nimport type { UnstableFeatures } from '../UnstableFeaturesProvider/useUnstableFeature'\nimport { SDKI18next } from './SDKI18next'\nimport { InternalError } from '@/components/Common'\nimport { LocaleProvider } from '@/contexts/LocaleProvider'\nimport { NonceContext } from '@/contexts/NonceProvider'\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  /**\n   * CSP nonce to apply to runtime-injected `<style>` elements (theming, PDF download window).\n   * Pass the same per-request nonce your app uses in its `style-src 'nonce-…'` directive.\n   * Also exposed to custom UI components via `useNonce`.\n   */\n  nonce?: string\n  /**\n   * Element to use as the portal container for SDK popovers and dropdowns.\n   * Defaults to a themed root element the SDK appends to `document.body`.\n   *\n   * Pass an element here if rendering inside a modal, or **required** if\n   * rendering inside a shadow root — `document.body` sits outside every\n   * shadow boundary, so without an explicit container overlays would\n   * otherwise escape your shadow root's style encapsulation.\n   */\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   * Opt-in flags for alpha SDK functionality. See {@link UnstableFeatures}.\n   * @alpha\n   */\n  unstableFeatures?: UnstableFeatures\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 * @group Providers\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    nonce,\n    portalContainer,\n    components,\n    LoaderComponent,\n    queryClient,\n    unstableFeatures,\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    <NonceContext.Provider value={nonce}>\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                      <UnstableFeaturesProvider value={unstableFeatures}>\n                        {children}\n                      </UnstableFeaturesProvider>\n                    </ApiProvider>\n                  </I18nextProvider>\n                </LocaleProvider>\n              </ThemeProvider>\n            </ErrorBoundary>\n          </ObservabilityProvider>\n        </LoadingIndicatorProvider>\n      </ComponentsProvider>\n    </NonceContext.Provider>\n  )\n}\n"],"names":["GustoProviderCustomUIAdapter","props","children","config","dictionary","lng","locale","currency","theme","nonce","portalContainer","components","LoaderComponent","queryClient","unstableFeatures","language","lang","ns","SDKI18next","useEffect","handleTopLevelError","useMemo","error","errorInfo","observabilityError","normalizeToSDKError","sanitizedError","sanitizeError","NonceContext","jsx","ComponentsProvider","LoadingIndicatorProvider","ObservabilityProvider","ErrorBoundary","InternalError","ThemeProvider","LocaleProvider","I18nextProvider","ApiProvider","UnstableFeaturesProvider"],"mappings":";;;;;;;;;;;;;;;;;AAgHO,SAASA,GAA6BC,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,OAAAC;AAAA,IACA,iBAAAC;AAAA,IACA,YAAAC;AAAA,IACA,iBAAAC;AAAA,IACA,aAAAC;AAAA,IACA,kBAAAC;AAAA,EAAA,IACEb;AAEJ,MAAIG;AACF,eAAWW,KAAYX,GAAY;AACjC,YAAMY,IAAOD;AACb,iBAAWE,KAAMb,EAAWY,CAAI;AAC9B,QAAAE,EAAW;AAAA,UACTF;AAAA,UACAC;AAAA,UACCb,EAAWY,CAAI,EAA8BC,CAAE;AAAA,UAChD;AAAA,UACA;AAAA,QAAA;AAAA,IAGN;AAGF,EAAAE,EAAU,MAAM;AACd,KAAM,YACJ,MAAMD,EAAW,eAAeb,CAAG;AAAA,EAEvC,GAAG,CAACA,CAAG,CAAC;AAER,QAAMe,IAAsBC,EAAQ,MAAM;AACxC,QAAKlB,EAAO,eAAe;AAE3B,aAAO,CAACmB,GAAgBC,MAAyB;AAC/C,YAAI,CAACpB,EAAO,eAAe,QAAS;AAIpC,cAAMqB,IAAqB;AAAA,UACzB,GAHeC,EAAoBH,CAAK;AAAA,UAIxC,WAAW,KAAK,IAAA;AAAA,UAChB,gBAAgBC,EAAU,kBAAkB;AAAA,QAAA,GAGxCG,IAAiBC,EAAcH,GAAoBrB,EAAO,cAAc,YAAY;AAE1F,QAAAA,EAAO,cAAc,QAAQuB,CAAc;AAAA,MAC7C;AAAA,EACF,GAAG,CAACvB,EAAO,aAAa,CAAC;AACzB,2BACGyB,EAAa,UAAb,EAAsB,OAAOnB,GAC5B,UAAA,gBAAAoB,EAACC,GAAA,EAAmB,OAAOnB,GACzB,4BAACoB,GAAA,EAAyB,OAAOnB,GAC/B,UAAA,gBAAAiB,EAACG,KAAsB,eAAe7B,EAAO,eAC3C,UAAA,gBAAA0B,EAACI,KAAc,mBAAmBC,GAAe,SAASd,GACxD,4BAACe,GAAA,EAAc,OAAA3B,GAAc,iBAAAE,GAC3B,UAAA,gBAAAmB,EAACO,KAAe,QAAA9B,GAAgB,UAAAC,GAC9B,UAAA,gBAAAsB,EAACQ,GAAA,EAAgB,MAAMnB,GACrB,UAAA,gBAAAW;AAAA,IAACS;AAAA,IAAA;AAAA,MACC,KAAKnC,EAAO;AAAA,MACZ,SAASA,EAAO;AAAA,MAChB,OAAOA,EAAO;AAAA,MACd,aAAAU;AAAA,MAEA,UAAA,gBAAAgB,EAACU,GAAA,EAAyB,OAAOzB,GAC9B,UAAAZ,EAAA,CACH;AAAA,IAAA;AAAA,EAAA,KAToCG,CAWxC,EAAA,CACF,EAAA,CACF,GACF,GACF,EAAA,CACF,GACF,GACF;AAEJ;"}

package/dist/contexts/ThemeProvider/ThemeProvider.js

@@ -1,39 +1,45 @@
-import { jsx as u } from "react/jsx-runtime";
-import { useRef as a, useCallback as h, useMemo as i, useEffect as p } from "react";
-import { ThemeContext as C } from "./useTheme.js";
+import { jsx as a } from "react/jsx-runtime";
+import { useRef as d, useLayoutEffect as f, useMemo as i, useEffect as p } from "react";
+import { ThemeContext as h } from "./useTheme.js";
 import { mergePartnerTheme as S } from "./theme.js";
 /* empty css                    */
-import { useNonce as T } from "../NonceProvider/useNonce.js";
-const g = ({
-  theme: o = {},
-  portalContainer: r,
-  children: n
+import { useNonce as G } from "../NonceProvider/useNonce.js";
+const C = ({
+  theme: c = {},
+  portalContainer: t,
+  children: r
 }) => {
-  const t = T(), e = a(null), c = a(null), f = h(
-    (d) => {
-      c.current = r ?? d;
-    },
-    [r]
-  ), s = i(
-    () => S(o),
-    [o]
+  const o = G(), e = d(null), s = d(null);
+  f(() => {
+    if (t) {
+      s.current = t;
+      return;
+    }
+    const n = document.createElement("div");
+    return n.className = "GSDK GSDK-portal-root", n.setAttribute("data-testid", "GSDK-portal-root"), document.body.appendChild(n), s.current = n, () => {
+      n.remove();
+    };
+  }, [t]);
+  const u = i(
+    () => S(c),
+    [c]
   ), m = i(
     () => `.GSDK{
-${l(s).join(`
+${l(u).join(`
 `)}
 }`,
-    [s]
+    [u]
   );
   return p(() => {
-    e.current || (e.current = document.createElement("style"), e.current.setAttribute("data-testid", "GSDK"), t && (e.current.nonce = t), document.head.appendChild(e.current)), e.current.textContent = m;
-  }, [m, t]), /* @__PURE__ */ u(C.Provider, { value: { container: c }, children: /* @__PURE__ */ u("article", { className: "GSDK", "data-testid": "GSDK", ref: f, children: n }) });
-}, l = (o, r) => {
-  const n = [];
-  for (const [t, e] of Object.entries(o))
-    typeof e == "object" ? n.push(...l(e, r ? r + "-" + t : t)) : n.push(`--g-${r ? r + "-" + t : t}: ${e};`);
-  return n;
+    e.current || (e.current = document.createElement("style"), e.current.setAttribute("data-testid", "GSDK"), o && (e.current.nonce = o), document.head.appendChild(e.current)), e.current.textContent = m;
+  }, [m, o]), /* @__PURE__ */ a(h.Provider, { value: { container: s }, children: /* @__PURE__ */ a("article", { className: "GSDK", "data-testid": "GSDK", children: r }) });
+}, l = (c, t) => {
+  const r = [];
+  for (const [o, e] of Object.entries(c))
+    typeof e == "object" ? r.push(...l(e, t ? t + "-" + o : o)) : r.push(`--g-${t ? t + "-" + o : o}: ${e};`);
+  return r;
 };
 export {
-  g as ThemeProvider
+  C as ThemeProvider
 };
 //# sourceMappingURL=ThemeProvider.js.map

package/dist/contexts/ThemeProvider/ThemeProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"ThemeProvider.js","sources":["../../../src/contexts/ThemeProvider/ThemeProvider.tsx"],"sourcesContent":["import type React from 'react'\nimport { useCallback, useEffect, useMemo, useRef } from 'react'\nimport { ThemeContext } from './useTheme'\nimport { mergePartnerTheme, type GustoSDKTheme } from './theme'\nimport { useNonce } from '@/contexts/NonceProvider'\nimport '@/styles/sdk.scss'\n\n/** @internal */\nexport interface ThemeProviderProps {\n  /** Partial set of theme tokens that override the SDK defaults. */\n  theme?: Partial<GustoSDKTheme>\n  /**\n   * Element to use as the portal container for all SDK overlays (Select, ComboBox,\n   * DatePicker, Menu, etc.). Defaults to the SDK's root article element.\n   *\n   * Pass `document.body` (or another stable element outside the SDK's container)\n   * when your app's scroll or clipping context interferes with overlay positioning.\n   */\n  portalContainer?: HTMLElement\n  /** Subtree rendered inside the SDK's themed root element. */\n  children?: React.ReactNode\n}\n\n/** @internal */\nexport const ThemeProvider: React.FC<ThemeProviderProps> = ({\n  theme: partnerThemeOverrides = {},\n  portalContainer,\n  children,\n}) => {\n  const nonce = useNonce()\n  const GThemeVariables = useRef<HTMLStyleElement | null>(null)\n  const portalContainerRef = useRef<HTMLElement | null>(null)\n\n  const articleRef = useCallback(\n    (el: HTMLElement | null) => {\n      portalContainerRef.current = portalContainer ?? el\n    },\n    [portalContainer],\n  )\n\n  const mergedTheme = useMemo(\n    () => mergePartnerTheme(partnerThemeOverrides),\n    [partnerThemeOverrides],\n  )\n\n  const cssContent = useMemo(\n    () => `.GSDK{\\n${parseThemeToCSS(mergedTheme).join('\\n')}\\n}`,\n    [mergedTheme],\n  )\n\n  useEffect(() => {\n    if (!GThemeVariables.current) {\n      GThemeVariables.current = document.createElement('style')\n      GThemeVariables.current.setAttribute('data-testid', 'GSDK')\n      if (nonce) GThemeVariables.current.nonce = nonce\n      document.head.appendChild(GThemeVariables.current)\n    }\n\n    GThemeVariables.current.textContent = cssContent\n  }, [cssContent, nonce])\n\n  return (\n    <ThemeContext.Provider value={{ container: portalContainerRef }}>\n      <article className=\"GSDK\" data-testid=\"GSDK\" ref={articleRef}>\n        {children}\n      </article>\n    </ThemeContext.Provider>\n  )\n}\n\n/**\n * Recursive flattening of the theme object into css variable format\n */\nconst parseThemeToCSS = (theme: Partial<GustoSDKTheme>, prefix?: string): string[] => {\n  const cssProps: string[] = []\n  for (const [key, value] of Object.entries(theme)) {\n    if (typeof value === 'object') {\n      cssProps.push(...parseThemeToCSS(value, prefix ? prefix + '-' + key : key))\n    } else {\n      cssProps.push(`--g-${prefix ? prefix + '-' + key : key}: ${value};`)\n    }\n  }\n  return cssProps\n}\n"],"names":["ThemeProvider","partnerThemeOverrides","portalContainer","children","nonce","useNonce","GThemeVariables","useRef","portalContainerRef","articleRef","useCallback","el","mergedTheme","useMemo","mergePartnerTheme","cssContent","parseThemeToCSS","useEffect","ThemeContext","jsx","theme","prefix","cssProps","key","value"],"mappings":";;;;;;AAwBO,MAAMA,IAA8C,CAAC;AAAA,EAC1D,OAAOC,IAAwB,CAAA;AAAA,EAC/B,iBAAAC;AAAA,EACA,UAAAC;AACF,MAAM;AACJ,QAAMC,IAAQC,EAAA,GACRC,IAAkBC,EAAgC,IAAI,GACtDC,IAAqBD,EAA2B,IAAI,GAEpDE,IAAaC;AAAA,IACjB,CAACC,MAA2B;AAC1B,MAAAH,EAAmB,UAAUN,KAAmBS;AAAA,IAClD;AAAA,IACA,CAACT,CAAe;AAAA,EAAA,GAGZU,IAAcC;AAAA,IAClB,MAAMC,EAAkBb,CAAqB;AAAA,IAC7C,CAACA,CAAqB;AAAA,EAAA,GAGlBc,IAAaF;AAAA,IACjB,MAAM;AAAA,EAAWG,EAAgBJ,CAAW,EAAE,KAAK;AAAA,CAAI,CAAC;AAAA;AAAA,IACxD,CAACA,CAAW;AAAA,EAAA;AAGd,SAAAK,EAAU,MAAM;AACd,IAAKX,EAAgB,YACnBA,EAAgB,UAAU,SAAS,cAAc,OAAO,GACxDA,EAAgB,QAAQ,aAAa,eAAe,MAAM,GACtDF,MAAOE,EAAgB,QAAQ,QAAQF,IAC3C,SAAS,KAAK,YAAYE,EAAgB,OAAO,IAGnDA,EAAgB,QAAQ,cAAcS;AAAA,EACxC,GAAG,CAACA,GAAYX,CAAK,CAAC,qBAGnBc,EAAa,UAAb,EAAsB,OAAO,EAAE,WAAWV,EAAA,GACzC,UAAA,gBAAAW,EAAC,WAAA,EAAQ,WAAU,QAAO,eAAY,QAAO,KAAKV,GAC/C,UAAAN,GACH,GACF;AAEJ,GAKMa,IAAkB,CAACI,GAA+BC,MAA8B;AACpF,QAAMC,IAAqB,CAAA;AAC3B,aAAW,CAACC,GAAKC,CAAK,KAAK,OAAO,QAAQJ,CAAK;AAC7C,IAAI,OAAOI,KAAU,WACnBF,EAAS,KAAK,GAAGN,EAAgBQ,GAAOH,IAASA,IAAS,MAAME,IAAMA,CAAG,CAAC,IAE1ED,EAAS,KAAK,OAAOD,IAASA,IAAS,MAAME,IAAMA,CAAG,KAAKC,CAAK,GAAG;AAGvE,SAAOF;AACT;"}
+{"version":3,"file":"ThemeProvider.js","sources":["../../../src/contexts/ThemeProvider/ThemeProvider.tsx"],"sourcesContent":["import type React from 'react'\nimport { useEffect, useLayoutEffect, useMemo, useRef } from 'react'\nimport { ThemeContext } from './useTheme'\nimport { mergePartnerTheme, type GustoSDKTheme } from './theme'\nimport { useNonce } from '@/contexts/NonceProvider'\nimport '@/styles/sdk.scss'\n\n/** @internal */\nexport interface ThemeProviderProps {\n  /** Partial set of theme tokens that override the SDK defaults. */\n  theme?: Partial<GustoSDKTheme>\n  /**\n   * Element to use as the portal container for all SDK overlays (Select, ComboBox,\n   * DatePicker, Menu, etc.). Defaults to a themed root element the SDK appends\n   * directly to `document.body`, so overlays are never affected by a host page's\n   * `position`, `transform`, `filter`, or `contain` on an intervening ancestor.\n   * That default root carries both the `GSDK` and `GSDK-portal-root` classes —\n   * the latter lets a host page's own `.GSDK` overrides exclude it\n   * (`.GSDK:not(.GSDK-portal-root)`) instead of reaching overlay content.\n   *\n   * Pass a specific element (e.g. when rendering inside a modal or shadow root)\n   * to portal overlays there instead.\n   */\n  portalContainer?: HTMLElement\n  /** Subtree rendered inside the SDK's themed root element. */\n  children?: React.ReactNode\n}\n\n/** @internal */\nexport const ThemeProvider: React.FC<ThemeProviderProps> = ({\n  theme: partnerThemeOverrides = {},\n  portalContainer,\n  children,\n}) => {\n  const nonce = useNonce()\n  const GThemeVariables = useRef<HTMLStyleElement | null>(null)\n  const portalContainerRef = useRef<HTMLElement | null>(null)\n\n  useLayoutEffect(() => {\n    if (portalContainer) {\n      portalContainerRef.current = portalContainer\n      return\n    }\n\n    const defaultPortalRoot = document.createElement('div')\n    defaultPortalRoot.className = 'GSDK GSDK-portal-root'\n    defaultPortalRoot.setAttribute('data-testid', 'GSDK-portal-root')\n    document.body.appendChild(defaultPortalRoot)\n    portalContainerRef.current = defaultPortalRoot\n\n    return () => {\n      defaultPortalRoot.remove()\n    }\n  }, [portalContainer])\n\n  const mergedTheme = useMemo(\n    () => mergePartnerTheme(partnerThemeOverrides),\n    [partnerThemeOverrides],\n  )\n\n  const cssContent = useMemo(\n    () => `.GSDK{\\n${parseThemeToCSS(mergedTheme).join('\\n')}\\n}`,\n    [mergedTheme],\n  )\n\n  useEffect(() => {\n    if (!GThemeVariables.current) {\n      GThemeVariables.current = document.createElement('style')\n      GThemeVariables.current.setAttribute('data-testid', 'GSDK')\n      if (nonce) GThemeVariables.current.nonce = nonce\n      document.head.appendChild(GThemeVariables.current)\n    }\n\n    GThemeVariables.current.textContent = cssContent\n  }, [cssContent, nonce])\n\n  return (\n    <ThemeContext.Provider value={{ container: portalContainerRef }}>\n      <article className=\"GSDK\" data-testid=\"GSDK\">\n        {children}\n      </article>\n    </ThemeContext.Provider>\n  )\n}\n\n/**\n * Recursive flattening of the theme object into css variable format\n */\nconst parseThemeToCSS = (theme: Partial<GustoSDKTheme>, prefix?: string): string[] => {\n  const cssProps: string[] = []\n  for (const [key, value] of Object.entries(theme)) {\n    if (typeof value === 'object') {\n      cssProps.push(...parseThemeToCSS(value, prefix ? prefix + '-' + key : key))\n    } else {\n      cssProps.push(`--g-${prefix ? prefix + '-' + key : key}: ${value};`)\n    }\n  }\n  return cssProps\n}\n"],"names":["ThemeProvider","partnerThemeOverrides","portalContainer","children","nonce","useNonce","GThemeVariables","useRef","portalContainerRef","useLayoutEffect","defaultPortalRoot","mergedTheme","useMemo","mergePartnerTheme","cssContent","parseThemeToCSS","useEffect","ThemeContext","jsx","theme","prefix","cssProps","key","value"],"mappings":";;;;;;AA6BO,MAAMA,IAA8C,CAAC;AAAA,EAC1D,OAAOC,IAAwB,CAAA;AAAA,EAC/B,iBAAAC;AAAA,EACA,UAAAC;AACF,MAAM;AACJ,QAAMC,IAAQC,EAAA,GACRC,IAAkBC,EAAgC,IAAI,GACtDC,IAAqBD,EAA2B,IAAI;AAE1D,EAAAE,EAAgB,MAAM;AACpB,QAAIP,GAAiB;AACnB,MAAAM,EAAmB,UAAUN;AAC7B;AAAA,IACF;AAEA,UAAMQ,IAAoB,SAAS,cAAc,KAAK;AACtD,WAAAA,EAAkB,YAAY,yBAC9BA,EAAkB,aAAa,eAAe,kBAAkB,GAChE,SAAS,KAAK,YAAYA,CAAiB,GAC3CF,EAAmB,UAAUE,GAEtB,MAAM;AACX,MAAAA,EAAkB,OAAA;AAAA,IACpB;AAAA,EACF,GAAG,CAACR,CAAe,CAAC;AAEpB,QAAMS,IAAcC;AAAA,IAClB,MAAMC,EAAkBZ,CAAqB;AAAA,IAC7C,CAACA,CAAqB;AAAA,EAAA,GAGlBa,IAAaF;AAAA,IACjB,MAAM;AAAA,EAAWG,EAAgBJ,CAAW,EAAE,KAAK;AAAA,CAAI,CAAC;AAAA;AAAA,IACxD,CAACA,CAAW;AAAA,EAAA;AAGd,SAAAK,EAAU,MAAM;AACd,IAAKV,EAAgB,YACnBA,EAAgB,UAAU,SAAS,cAAc,OAAO,GACxDA,EAAgB,QAAQ,aAAa,eAAe,MAAM,GACtDF,MAAOE,EAAgB,QAAQ,QAAQF,IAC3C,SAAS,KAAK,YAAYE,EAAgB,OAAO,IAGnDA,EAAgB,QAAQ,cAAcQ;AAAA,EACxC,GAAG,CAACA,GAAYV,CAAK,CAAC,qBAGnBa,EAAa,UAAb,EAAsB,OAAO,EAAE,WAAWT,KACzC,UAAA,gBAAAU,EAAC,aAAQ,WAAU,QAAO,eAAY,QACnC,UAAAf,GACH,GACF;AAEJ,GAKMY,IAAkB,CAACI,GAA+BC,MAA8B;AACpF,QAAMC,IAAqB,CAAA;AAC3B,aAAW,CAACC,GAAKC,CAAK,KAAK,OAAO,QAAQJ,CAAK;AAC7C,IAAI,OAAOI,KAAU,WACnBF,EAAS,KAAK,GAAGN,EAAgBQ,GAAOH,IAASA,IAAS,MAAME,IAAMA,CAAG,CAAC,IAE1ED,EAAS,KAAK,OAAOD,IAASA,IAAS,MAAME,IAAMA,CAAG,KAAKC,CAAK,GAAG;AAGvE,SAAOF;AACT;"}