@capxul/sdk-react 4.2.0 → 4.20.0-beta.10

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { A as entered, C as CreateOrganizationFailure, D as OrganizationDetails, E as InvocationOptions, F as useCapxulTransitions, M as useCapxulDestination, N as useCapxulIdentity, O as ProfileDetails, P as useCapxulSend, S as CapxulSend, T as Destination, _ as ReadyDestination, a as AuthenticationSlots, b as Slot, c as ControllerAction, d as OnboardingControllerProps, f as OrgFailure, g as ProfileSlotProps, h as PendingAuthState, i as AuthenticatedState, j as useCapxulAuth, k as SendResult, l as FaultedState, m as OtpPendingState, n as AccountProgress, o as CapxulAuthenticationController, p as OrgProgress, r as ActionResult, s as CapxulOnboardingController, t as AccountFailure, u as NavigationAction, v as RetryAction, w as CreateOrganizationSubmission, x as CapxulAuth, y as SignedOutState } from "./controllers-BWmKRFy6.mjs";
 import { ReactNode, RefCallback } from "react";
 import { QueryClient, UseMutationResult, UseQueryResult } from "@tanstack/react-query";
-import { Account, AccountRequirement, ActivityAnnotation, ActivityAnnotationInput, ActivityDetail, ActivityKind, ActivityListParams, ActivityPage, ActivityPhase, ActivityRange, ActivityReference, ActorReference, AddressBookEntry, BudgetId, CapxulClient, CapxulError, CapxulResult, CapxulSigner, CreateOrgInput, CurrentHoldings, HostObservability, IdentityDestination, InviteMemberInput, MemberView, Money, MoneyParseErrorReason, OrgId, OrgView, OrganizationPaymentBatchInput, OrganizationPaymentInput, PartyId, Payment, PaymentDirection, PaymentDocumentRef, PaymentDocumentRender, PaymentStatus, PaymentTiming, PaymentType, PaymentsPayInput, PayrollGroupId, PayrollGroupInput, PayrollRunId, PayrollRunStatus, Permission, PermissionMethods, PermissionReadResult, Profile, RoleView, SubmittedPermissionExecution, isClaimed, isRestoring } from "@capxul/sdk";
+import { Account, AccountRequirement, ActivityAnnotation, ActivityAnnotationInput, ActivityDetail, ActivityKind, ActivityListParams, ActivityPage, ActivityPhase, ActivityRange, ActivityReference, ActivitySummaryTotal, ActorReference, AddressBookEntry, AssetAmount, AssetId, BudgetId, CapxulClient, CapxulError, CapxulResult, CapxulSigner, CreateOrgInput, CurrentHoldings, HostObservability, IdentityDestination, IdentityState, MemberView, Money, MoneyParseErrorReason, OrgId, OrgView, OrganizationAccess, OrganizationPaymentBatchInput, OrganizationPaymentInput, PartyId, Payment, PaymentDirection, PaymentDocumentDownload, PaymentDocumentReadRef, PaymentDocumentRef, PaymentDocumentRender, PaymentStatus, PaymentTiming, PaymentType, PaymentsPayInput, PayrollGroupId, PayrollGroupInput, PayrollRunId, PayrollRunStatus, Permission, PermissionMethods, PermissionReadResult, Profile, RoleView, SubmittedPermissionExecution, isClaimed, isRestoring } from "@capxul/sdk";
 //#region src/provider.d.ts
 type CapxulProviderSharedProps = {
   /** Bring your own QueryClient; otherwise the provider creates one. */
@@ -28,6 +28,11 @@ type CapxulProviderPublishableKeyProps = CapxulProviderSharedProps & {
    * route cross-origin for the publishable key's allowed origins.
    */
   readonly bootstrapBaseUrl?: string;
+  /**
+   * AUTH A3. Pass `"explicit"` on `/connect` so restore and OTP do not write
+   * Profile, Account, or invitations. Default automatic.
+   */
+  readonly accountSetup?: "automatic" | "explicit";
 };
 /**
  * Node / server / test path — a pre-built client is supplied; lifecycle stays
@@ -77,7 +82,7 @@ declare function useCapxulAccountBalance(options?: UseCapxulAccountBalanceOption
 //#region src/hooks/use-capxul-account-fund.d.ts
 type UseCapxulAccountFundReturn = UseMutationResult<{
   readonly txHash: string;
-}, CapxulError, Money>;
+}, CapxulError, AssetAmount>;
 declare function useCapxulAccountFund(): UseCapxulAccountFundReturn;
 //#endregion
 //#region src/hooks/use-capxul-money.d.ts
@@ -143,7 +148,7 @@ declare function useCapxulHoldings(params?: UseCapxulHoldingsParams): UseQueryRe
  * List the Organizations that the current user can access. Binds directly to
  * the locked `capxul.orgs()` SDK method.
  */
-type UseCapxulOrgsReturn = UseQueryResult<readonly OrgView[], CapxulError>;
+type UseCapxulOrgsReturn = UseQueryResult<readonly OrganizationAccess[], CapxulError>;
 type UseCapxulOrgsOptions = {
   /**
    * Gate the query on auth readiness. `client.orgs()` is a session-scoped
@@ -199,15 +204,6 @@ declare function useCapxulOrgTreasury(orgId: OrgId | undefined, options?: UseCap
 type UseCapxulCreateOrgReturn = UseMutationResult<OrgView, CapxulError, CreateOrgInput>;
 declare function useCapxulCreateOrg(): UseCapxulCreateOrgReturn;
 //#endregion
-//#region src/hooks/use-capxul-invite-member.d.ts
-/**
- * Invite a member to an Organization by email. The hook uses the closed-over `orgId`.
- * It binds directly to
- * `capxul.org(orgId).invite(input)`. On success, invalidates the member list.
- */
-type UseCapxulInviteMemberReturn = UseMutationResult<MemberView, CapxulError, InviteMemberInput>;
-declare function useCapxulInviteMember(orgId: OrgId | undefined): UseCapxulInviteMemberReturn;
-//#endregion
 //#region src/headless/journey/journey-state.d.ts
 type OnboardingIntent = "personal" | "organization";
 type OnboardingStep = "profile" | "organization" | "provisioning";
@@ -383,9 +379,9 @@ interface Contact {
 interface ContactRow extends Contact {
   /** Ours: one initials rule, not one copy per screen. */
   readonly initials: string;
-  readonly rename: (name: string) => void;
-  readonly hide: () => void;
-  readonly unhide: () => void;
+  readonly rename: (name: string, options?: InvocationOptions) => void;
+  readonly hide: (options?: InvocationOptions) => void;
+  readonly unhide: (options?: InvocationOptions) => void;
 }
 /** ADR-0023 R1: refusal CODES, never sentences — the app owns the words. */
 type ContactsRefusal = "loading" | "org-unavailable" | "unavailable";
@@ -421,7 +417,13 @@ interface ContactsListOptions {
 interface ContactsAddSlice {
   readonly value: string;
   readonly change: (text: string) => void;
-  readonly submit: () => void;
+  /**
+   * #1960 R02: hand it the options the screen captured BEFORE the click. The
+   * same snapshot reaches the SDK add call and comes back on `onAdded`/
+   * `onFailed`, so the UI observation and the operation share one identity even
+   * when the reply lands after an account switch. Omitted stays omitted.
+   */
+  readonly submit: (options?: InvocationOptions) => void;
   readonly isSubmitting: boolean;
   readonly blocked: boolean;
   readonly blockedReason: ContactsAddBlockedReason | null;
@@ -431,12 +433,17 @@ interface ContactsAddSlice {
 //#region src/headless/contacts/contacts.d.ts
 interface CapxulContactsProps {
   readonly actor: ContactsActor;
-  readonly onAdded: (contact: Contact) => void;
+  /**
+   * `options` is exactly what the caller handed `.Add.submit` or a row verb, so
+   * the screen's own observation of the finished action can reuse the attempt
+   * identity the SDK operation ran under (#1960 R02).
+   */
+  readonly onAdded: (contact: Contact, options?: InvocationOptions) => void;
   /** ADR-0023 R1: the app maps `error.code` to its own copy; no SDK sentence. */
-  readonly onFailed: (error: CapxulError) => void;
+  readonly onFailed: (error: CapxulError, options?: InvocationOptions) => void;
   readonly children: ReactNode;
 }
-declare function Root$6({ actor, onAdded, onFailed, children }: CapxulContactsProps): import("react/jsx-runtime").JSX.Element;
+declare function Root$7({ actor, onAdded, onFailed, children }: CapxulContactsProps): import("react/jsx-runtime").JSX.Element;
 declare function Summary$3({ children }: {
   readonly children: (slice: ContactsSummarySlice) => ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
@@ -447,7 +454,7 @@ declare function Add({ children }: {
   readonly children: (slice: ContactsAddSlice) => ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
 /** The compound shape the app's own design system already uses (`StatusTabs`). */
-declare const CapxulContacts: typeof Root$6 & {
+declare const CapxulContacts: typeof Root$7 & {
   Summary: typeof Summary$3;
   List: typeof List;
   Add: typeof Add;
@@ -467,6 +474,7 @@ interface ActivityReceipt {
  */
 type ActivityRow = {
   readonly kind: "payment";
+  readonly execution?: Payment["execution"];
   readonly reference: ActivityReference;
   readonly direction: PaymentDirection;
   readonly counterpartyLabel: string;
@@ -499,17 +507,19 @@ type ActivityRow = {
  */
 type SummaryWindow = "all" | "last30days" | ActivityRange;
 /**
- * Finished money strings for ONE currency bucket, so no consumer indexes an
- * array of per-currency totals. All four strings are `null` and `count` is `0`
+ * Finished valuation strings in the display currency. Unrated assets remain
+ * separate. All four strings are `null` and `count` is `0`
  * when the window holds no activity — we say there is nothing, the app says it
  * in its own words.
  */
 interface ActivitySummarySlice {
+  readonly readWarning?: ActivityPage["readWarning"];
   readonly currency: string | null;
   readonly moneyIn: string | null;
   readonly moneyOut: string | null;
   readonly net: string | null;
   readonly pending: string | null;
+  readonly unrated: readonly ActivitySummaryTotal[];
   /** A count is not money, so it is not formatted. */
   readonly count: number;
   readonly isLoading: boolean;
@@ -541,11 +551,17 @@ interface ActivitySearchSlice {
   readonly change: (text: string) => void;
 }
 interface ActivityRowsSlice {
+  readonly readWarning?: ActivityPage["readWarning"];
   /** Already filtered and already searched. */
   readonly rows: readonly ActivityRow[];
   readonly isLoading: boolean;
   readonly error: CapxulError | null;
-  readonly retry: () => void;
+  /**
+   * #1960 R02: pass the options captured before the retry was selected and the
+   * re-read runs under the same attempt identity as the UI observation. Omit
+   * them and the read keeps its own invocation context.
+   */
+  readonly retry: (options?: InvocationOptions) => void;
   /** Server read time of the newest page, so the app can say which read is older. */
   readonly observedAt: number | null;
 }
@@ -565,9 +581,14 @@ interface ActivityLoadMoreSlice {
   readonly sentinelRef: RefCallback<HTMLElement>;
 }
 interface ActivityDetailSlice {
-  /** ONE finished document, never the array, so no consumer writes `documents[0]`. */
-  readonly receiptDocument: PaymentDocumentRef | null;
-  readonly openReceiptDocument: () => Promise<PaymentDocumentRender>;
+  /** Current Payment state from the existing detail read; absent for Movements. */
+  readonly payment?: Pick<Payment, "status" | "execution">;
+  readonly documents: readonly PaymentDocumentRef[];
+  readonly selectedDocument: PaymentDocumentRef | null;
+  readonly selectDocument: (ref: PaymentDocumentReadRef) => void;
+  readonly renderDocument: () => Promise<PaymentDocumentRender>;
+  /** Return exact bytes on a deliberate action. The host owns the download URL. */
+  readonly downloadDocument: () => Promise<PaymentDocumentDownload>;
   readonly isOpeningDocument: boolean;
   readonly memo: string;
   readonly setMemo: (text: string) => void;
@@ -583,13 +604,15 @@ interface ActivityDetailSlice {
   readonly error: CapxulError | null;
 }
 interface CsvExport {
+  readonly readWarning?: ActivityPage["readWarning"];
   readonly text: string;
   readonly rowCount: number;
   /** The 5,000-row ceiling was reached and rows were left unread. */
   readonly truncated: boolean;
 }
 interface ActivityExportSlice {
-  readonly toCsv: () => Promise<CsvExport>;
+  /** Same contract as `retry`: the export's pages run under the caller's attempt. */
+  readonly toCsv: (options?: InvocationOptions) => Promise<CsvExport>;
   readonly isExporting: boolean;
 }
 //#endregion
@@ -605,7 +628,7 @@ interface CapxulActivityProps {
   readonly pageSize?: number;
   readonly children: ReactNode;
 }
-declare function Root$5({ actor, pageSize, children }: CapxulActivityProps): import("react/jsx-runtime").JSX.Element;
+declare function Root$6({ actor, pageSize, children }: CapxulActivityProps): import("react/jsx-runtime").JSX.Element;
 /**
  * The one part that holds a query rather than reading the engine's: it takes a
  * `window` prop, and two placements can ask for different windows, so a single
@@ -636,7 +659,7 @@ declare function Export({ children }: {
   readonly children: (slice: ActivityExportSlice) => ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
 /** The compound shape the app's own design system already uses (`StatusTabs`). */
-declare const CapxulActivity: typeof Root$5 & {
+declare const CapxulActivity: typeof Root$6 & {
   Summary: typeof Summary$2;
   Filters: typeof Filters;
   Search: typeof Search;
@@ -671,7 +694,7 @@ type SentPayment = {
   /** The backend payment row. */
   readonly payment: Payment;
   /** What we parsed and sent — `.value` is the comma-stripped major-unit string. */
-  readonly amount: Money;
+  readonly amount: AssetAmount;
   /** The trimmed text the person typed — the app's success toast interpolates it. */
   readonly recipient: string;
 };
@@ -679,7 +702,7 @@ type SentPayment = {
  * Refusal CODES, never sentences (#1447 ruling 8). The app maps each code to
  * the words it already prints; no English refusal string ships from here.
  */
-type CapxulSendMoneyBlockedReason = "signer-not-ready" | "amount-invalid" | "recipient-unresolved" | "no-source" | "no-asset";
+type CapxulSendMoneyBlockedReason = "signer-not-ready" | "amount-invalid" | "recipient-unresolved" | "no-source" | "no-asset" | "asset-unnamed";
 /**
  * One Budget the member can spend from — the id the payment carries, and
  * nothing else.
@@ -704,7 +727,7 @@ interface SendMoneySourceSlice {
   readonly isPending: boolean;
 }
 interface SendMoneyAssetOption {
-  readonly id: string;
+  readonly id: AssetId;
   readonly symbol: string;
   readonly availableDisplay: string;
 }
@@ -739,7 +762,7 @@ interface CapxulSendMoneyProps {
   readonly onFailed: (error: CapxulError) => void;
   readonly children: ReactNode;
 }
-declare function Root$4({ actor, onSent, onFailed, children }: CapxulSendMoneyProps): import("react/jsx-runtime").JSX.Element;
+declare function Root$5({ actor, onSent, onFailed, children }: CapxulSendMoneyProps): import("react/jsx-runtime").JSX.Element;
 declare function Source({ children }: {
   readonly children: (slice: SendMoneySourceSlice) => ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
@@ -756,7 +779,7 @@ declare function Actions$1({ children }: {
   readonly children: (slice: SendMoneyActionsSlice) => ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
 /** The compound shape the app's own design system already uses (`StatusTabs`). */
-declare const CapxulSendMoney: typeof Root$4 & {
+declare const CapxulSendMoney: typeof Root$5 & {
   Source: typeof Source;
   Asset: typeof Asset$1;
   Amount: typeof Amount;
@@ -788,7 +811,7 @@ interface CapxulOrgMemberProps {
   readonly orgId: OrgId | string | undefined;
   readonly children: ReactNode;
 }
-declare function Root$3({ orgId, children }: CapxulOrgMemberProps): import("react/jsx-runtime").JSX.Element;
+declare function Root$4({ orgId, children }: CapxulOrgMemberProps): import("react/jsx-runtime").JSX.Element;
 /**
  * One part serves all four denial idioms the app already uses: disabled with no
  * explanation, disabled plus a native `title`, a whole-surface swap, and
@@ -803,7 +826,7 @@ declare function Standing({ children }: {
   readonly children: (slice: OrgMemberStandingSlice) => ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
 /** The compound shape the app's own design system already uses (`StatusTabs`). */
-declare const CapxulOrgMember: typeof Root$3 & {
+declare const CapxulOrgMember: typeof Root$4 & {
   Can: typeof Can;
   Standing: typeof Standing;
 };
@@ -816,8 +839,19 @@ type DashboardScope = {
   readonly orgId?: string;
 };
 type DashboardAccessPhase = "checking" | "error" | "redirect" | "granted";
+/**
+ * Which of the three probes produced the error the screen is showing. The
+ * error code alone cannot say: a provider failure reads the same whether the
+ * session read, the membership list or the lifecycle read raised it, and a
+ * consumer that reports a displayed gate error has to keep those apart
+ * (#1963 R05-2). It names the SOURCE only; `retry` still re-runs every failed
+ * probe, exactly as before.
+ */
+type DashboardAccessProbe = "session" | "membership" | "lifecycle";
 interface DashboardAccessErrorSlice {
   readonly error: CapxulError;
+  /** The probe the surfaced error came from, in the frozen precedence order. */
+  readonly probe: DashboardAccessProbe;
   /** Re-runs each failed probe. */
   readonly retry: () => void;
 }
@@ -828,14 +862,20 @@ interface CapxulDashboardAccessProps {
   readonly scope: DashboardScope;
   readonly children: ReactNode;
 }
-declare function Root$2({ scope, children }: CapxulDashboardAccessProps): import("react/jsx-runtime").JSX.Element;
+declare function Root$3({ scope, children }: CapxulDashboardAccessProps): import("react/jsx-runtime").JSX.Element;
 /** Hands nothing — today's app renders `null` here, exactly as it does now. */
-declare function Checking({ children }: {
+declare function Checking$1({ children }: {
   readonly children?: ReactNode;
 }): import("react/jsx-runtime").JSX.Element | null;
 declare function DashboardError({ children }: {
   readonly children: (slice: DashboardAccessErrorSlice) => ReactNode;
 }): import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Hands the destination and draws nothing. Reaching this part is a REQUEST to
+ * navigate, never an arrival: the app may cancel or supersede it, so nothing
+ * here — and nothing a consumer hangs off it — may claim a completed redirect
+ * (#1963 R05-1). The destination page's own normalized pageview proves arrival.
+ */
 declare function Redirect({ children }: {
   readonly children: (slice: DashboardAccessRedirectSlice) => ReactNode;
 }): import("react/jsx-runtime").JSX.Element | null;
@@ -843,8 +883,8 @@ declare function Granted({ children }: {
   readonly children?: ReactNode;
 }): import("react/jsx-runtime").JSX.Element | null;
 /** The compound shape the app's own design system already uses (`StatusTabs`). */
-declare const CapxulDashboardAccess: typeof Root$2 & {
-  Checking: typeof Checking;
+declare const CapxulDashboardAccess: typeof Root$3 & {
+  Checking: typeof Checking$1;
   Error: typeof DashboardError;
   Redirect: typeof Redirect;
   Granted: typeof Granted;
@@ -874,8 +914,14 @@ interface PayrollSummarySlice {
 }
 interface PayrollGroupsSlice {
   readonly groups: readonly PayrollGroupRow[];
-  readonly save: (input: PayrollGroupInput) => Promise<CapxulResult<PayrollGroupRow>>;
-  readonly remove: (id: PayrollGroupId) => Promise<CapxulResult<void>>;
+  /**
+   * R13 (#1968): `options` is the browser attempt the caller captured before the
+   * employer pressed the button. It reaches the SDK operation unchanged, so the
+   * group's `ui_payroll_action_completed` and the durable `payroll_group_changed`
+   * share one correlation. Absent, the write keeps its own invocation context.
+   */
+  readonly save: (input: PayrollGroupInput, options?: InvocationOptions) => Promise<CapxulResult<PayrollGroupRow>>;
+  readonly remove: (id: PayrollGroupId, options?: InvocationOptions) => Promise<CapxulResult<void>>;
   readonly isSaving: boolean;
   readonly isLoading: boolean;
   readonly error: CapxulError | null;
@@ -886,7 +932,7 @@ interface CapxulPayrollProps {
   readonly orgId: OrgId | undefined;
   readonly children: ReactNode;
 }
-declare function Root$1({ orgId, children }: CapxulPayrollProps): import("react/jsx-runtime").JSX.Element;
+declare function Root$2({ orgId, children }: CapxulPayrollProps): import("react/jsx-runtime").JSX.Element;
 declare function Summary$1({ children }: {
   readonly children: (slice: PayrollSummarySlice) => ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
@@ -898,7 +944,7 @@ declare function Groups({ children }: {
  * There is NO `.Runs` part (ruling Q6): no shipped region has the right shape
  * for a run list, and a part without a production caller may not ship.
  */
-declare const CapxulPayroll: typeof Root$1 & {
+declare const CapxulPayroll: typeof Root$2 & {
   Summary: typeof Summary$1;
   Groups: typeof Groups;
 };
@@ -920,10 +966,10 @@ interface PayrollRecipientOption {
 //#region src/headless/payroll/use-payroll-run.d.ts
 /**
  * Refusal CODES, never sentences (ADR-0023 R1). `blockedReason` names the FIRST
- * false fact in the fixed order of the contract's seven-row table, so the same
- * composer state always yields the same code.
+ * false fact in the fixed order below, so the same composer state always
+ * yields the same code.
  */
-type CapxulPayrollRunBlockedReason = "signer-not-ready" | "no-source" | "ambiguous-source" | "no-asset" | "no-recipients" | "amount-invalid" | "insufficient-funds";
+type CapxulPayrollRunBlockedReason = "signer-not-ready" | "no-source" | "ambiguous-source" | "no-asset" | "no-recipients" | "amount-invalid" | "insufficient-funds" | "asset-unnamed";
 interface PayrollRunGroupOption {
   readonly id: PayrollGroupId;
   readonly label: string;
@@ -950,7 +996,7 @@ interface PayrollRunAmountEntry {
   /** True while the value is one we seeded and the employer has not edited. */
   readonly prefilled: boolean;
   /** The treasury asset's currency. Rows stay absent until this value exists. */
-  readonly currency: Money["currency"];
+  readonly currency: string;
 }
 interface PayrollRunAmountsSlice {
   readonly entries: readonly PayrollRunAmountEntry[];
@@ -967,7 +1013,14 @@ interface PayrollRunSummarySlice {
 interface PayrollRunActionsSlice {
   readonly recovery: "none" | "restoring" | "required" | "unavailable";
   readonly recoveryError: CapxulError | null;
-  readonly submit: () => void;
+  /**
+   * R13 (#1968): `options` is the browser attempt captured before the employer
+   * confirmed. It reaches `authorizeRun` unchanged, so the sheet's own
+   * `ui_payroll_action_completed` and the durable `payroll_run_transitioned`
+   * rows share one correlation. It is NEVER written into the persisted draft —
+   * a restored run keeps its own identity, not a stale attempt's.
+   */
+  readonly submit: (options?: InvocationOptions) => void;
   readonly isSubmitting: boolean;
   readonly blocked: boolean;
   readonly blockedReason: CapxulPayrollRunBlockedReason | null;
@@ -996,7 +1049,7 @@ interface CapxulPayrollRunProps {
   readonly onFailed: (error: CapxulError) => void;
   readonly children: ReactNode;
 }
-declare function Root({ orgId, prefill, onRun, onFailed, children }: CapxulPayrollRunProps): import("react/jsx-runtime").JSX.Element;
+declare function Root$1({ orgId, prefill, onRun, onFailed, children }: CapxulPayrollRunProps): import("react/jsx-runtime").JSX.Element;
 declare function Recipients({ children }: {
   readonly children: (slice: PayrollRunRecipientsSlice) => ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
@@ -1013,7 +1066,7 @@ declare function Actions({ children }: {
   readonly children: (slice: PayrollRunActionsSlice) => ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
 /** The compound shape the app's own design system already uses (`StatusTabs`). */
-declare const CapxulPayrollRun: typeof Root & {
+declare const CapxulPayrollRun: typeof Root$1 & {
   Recipients: typeof Recipients;
   Amounts: typeof Amounts;
   Asset: typeof Asset;
@@ -1021,6 +1074,64 @@ declare const CapxulPayrollRun: typeof Root & {
   Actions: typeof Actions;
 };
 //#endregion
+//#region src/headless/client-connection/use-client-connection.d.ts
+interface OtpSlice {
+  readonly email: string;
+  readonly pending: boolean;
+  readonly canResend: boolean;
+  readonly verifyCode: (code: string) => Promise<void>;
+  readonly resend: () => Promise<void>;
+}
+interface ConsentSlice {
+  readonly verifiedEmail: string;
+  readonly clientLabel: string;
+  readonly scopeCodes: readonly string[];
+  readonly purpose: "login" | "signup";
+  readonly setupState: "not_required" | "new" | "resumable";
+  readonly pending: boolean;
+  readonly accept: () => Promise<void>;
+  readonly cancel: () => Promise<void>;
+}
+interface CompleteSlice {
+  readonly outcome: "connected";
+}
+interface FailureSlice {
+  readonly code: string;
+  readonly field?: string;
+  readonly retry: () => Promise<void>;
+  readonly cancel: () => Promise<void>;
+}
+//#endregion
+//#region src/headless/client-connection/client-connection.d.ts
+interface CapxulClientConnectionProps {
+  readonly client: CapxulClient;
+  readonly requestId: string;
+  readonly children: ReactNode;
+}
+declare function Root({ client, requestId, children }: CapxulClientConnectionProps): import("react/jsx-runtime").JSX.Element;
+declare function Checking({ children }: {
+  readonly children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element | null;
+declare function Otp({ children }: {
+  readonly children: (slice: OtpSlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element | null;
+declare function Consent({ children }: {
+  readonly children: (slice: ConsentSlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element | null;
+declare function Complete({ children }: {
+  readonly children: (slice: CompleteSlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element | null;
+declare function Failure({ children }: {
+  readonly children: (slice: FailureSlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element | null;
+declare const CapxulClientConnection: typeof Root & {
+  Checking: typeof Checking;
+  Otp: typeof Otp;
+  Consent: typeof Consent;
+  Complete: typeof Complete;
+  Failure: typeof Failure;
+};
+//#endregion
 //#region src/internal/reactivity-keys.d.ts
 declare const capxulKeys: {
   root: readonly ["capxul"];
@@ -1036,7 +1147,7 @@ declare const capxulKeys: {
   orgRoles: (orgId: OrgId | undefined) => readonly ["capxul", "org", "pending" | OrgId, "roles"];
   orgTreasury: (orgId: OrgId | undefined) => readonly ["capxul", "org", "pending" | OrgId, "treasury"];
   orgPermissions: (orgId: OrgId | undefined) => readonly ["capxul", "org", "pending" | OrgId, "permissions"];
-  orgMe: (orgId: OrgId | undefined) => readonly ["capxul", "org", "pending" | OrgId, "me"];
+  orgMe: (orgId: OrgId | undefined, account: string | undefined) => readonly ["capxul", "org", "pending" | OrgId, "me", string];
   orgLifecycle: (orgId: OrgId | undefined) => readonly ["capxul", "org", "pending" | OrgId, "lifecycle"];
   contacts: (scope: string) => readonly ["capxul", "contacts", string];
   contactsList: (scope: string, includeHidden: boolean) => readonly ["capxul", "contacts", string, "all" | "visible"];
@@ -1051,4 +1162,4 @@ declare const capxulKeys: {
   payment: (paymentId: string | undefined) => readonly ["capxul", "payments", string];
 };
 //#endregion
-export { type AccountFailure, type AccountProgress, type ActionResult, type ActivityDetailSlice, type ActivityExportSlice, type ActivityFilterValues, type ActivityFiltersSlice, type ActivityLoadMoreSlice, type ActivityReceipt, type ActivityRow, type ActivityRowsSlice, type ActivitySearchSlice, type ActivitySummarySlice, type AuthenticatedState, type AuthenticationSlots, type CanReason, CapxulActivity, type CapxulActivityProps, type CapxulAuth, CapxulAuthenticationController, type CapxulBootstrapState, type CapxulBootstrapStatus, CapxulContacts, type CapxulContactsProps, CapxulDashboardAccess, type CapxulDashboardAccessProps, CapxulOnboardingController, CapxulOrgMember, type CapxulOrgMemberProps, CapxulPayroll, type CapxulPayrollProps, CapxulPayrollRun, type CapxulPayrollRunBlockedReason, type CapxulPayrollRunProps, CapxulProvider, type CapxulProviderProps, type CapxulSend, CapxulSendMoney, type CapxulSendMoneyBlockedReason, type CapxulSendMoneyProps, type Contact, type ContactRelationship, type ContactRow, type ContactsActor, type ContactsAddBlockedReason, type ContactsAddError, type ContactsAddSlice, type ContactsListOptions, type ContactsListSlice, type ContactsRefusal, type ContactsSummarySlice, type ControllerAction, type CreateOrganizationFailure, type CreateOrganizationSubmission, type CsvExport, type DashboardAccessErrorSlice, type DashboardAccessPhase, type DashboardAccessRedirectSlice, type DashboardScope, type Destination, type FaultedState, type HandleAvailability, type ImageUploadInput, type ImageUploadTarget, type InvocationOptions, type NavigationAction, type OnboardingControllerProps, type OnboardingIntent, type OnboardingJourney, type OnboardingJourneyPosition, type OnboardingOrigin, type OnboardingStep, type OrgFailure, type OrgMemberAction, type OrgMemberCanSlice, type OrgMemberStanding, type OrgMemberStandingSlice, type OrgProgress, type OrganizationDetails, type OrganizationDraft, type OtpPendingState, type PayoutDraftChain, type PayoutDraftEntry, type PayrollGroupRow, type PayrollGroupsSlice, type PayrollRecipientOption, type PayrollRunActionsSlice, type PayrollRunAmountEntry, type PayrollRunAmountsSlice, type PayrollRunAssetSlice, type PayrollRunGroupOption, type PayrollRunPrefill, type PayrollRunRecipientsSlice, type PayrollRunStatus, type PayrollRunSummarySlice, type PayrollSummarySlice, type PendingAuthState, type ProfileDetails, type ProfileDraft, type ProfileSlotProps, type ReadyDestination, type RetryAction, type SendActor, type SendMoneyActionsSlice, type SendMoneyAmountSlice, type SendMoneyAssetError, type SendMoneyAssetOption, type SendMoneyAssetSlice, type SendMoneyRecipientSlice, type SendMoneyRecipientStatus, type SendMoneySourceError, type SendMoneySourceOption, type SendMoneySourceSlice, type SendResult, type SentPayment, type SentPayrollRun, type SignedOutState, type Slot, type SummaryWindow, type UseCapxulAccountBalanceOptions, type UseCapxulAccountBalanceReturn, type UseCapxulAccountFundReturn, type UseCapxulCreateCommitmentReturn, type UseCapxulCreateOrgReturn, type UseCapxulHandleAvailabilityReturn, type UseCapxulImageUploadReturn, type UseCapxulInviteMemberReturn, type UseCapxulOrgMembersOptions, type UseCapxulOrgMembersReturn, type UseCapxulOrgRolesOptions, type UseCapxulOrgRolesReturn, type UseCapxulOrgTreasuryOptions, type UseCapxulOrgTreasuryReturn, type UseCapxulOrgsReturn, type UseCapxulPayReturn, type UseCapxulPaymentReturn, type UseCapxulPaymentsReturn, type UseCapxulProfileReturn, type UseCapxulRedirectPaymentReturn, type UseCapxulUploadImageReturn, acknowledgeOnboardingDestination, activeOnboardingRecovery, capxulKeys, clearOnboardingJourney, currentOnboardingJourneyId, entered, invalidateOnboardingJourneyObservation, isClaimed, isRestoring, loadOnboardingJourney, onboardingJourneyPosition, saveOnboardingJourney, startOnboardingJourney, useCapxul, useCapxulAccountBalance, useCapxulAccountFund, useCapxulActivity, useCapxulActivityDetail, useCapxulAnnotateMovement, useCapxulAuth, useCapxulCancelPayment, useCapxulClaimPayment, useCapxulClientOrNull, useCapxulCreateCommitment, useCapxulCreateOrg, useCapxulDestination, useCapxulHandleAvailability, useCapxulHoldings, useCapxulIdentity, useCapxulImageUpload, useCapxulInviteMember, useCapxulOrgMembers, useCapxulOrgRoles, useCapxulOrgTreasury, useCapxulOrganizationPay, useCapxulOrganizationPayBatch, useCapxulOrgs, useCapxulPay, useCapxulPayment, useCapxulPayments, useCapxulPermission, useCapxulPermissionAssign, useCapxulPermissionChange, useCapxulPermissionCreate, useCapxulPermissionReplace, useCapxulPermissionRevoke, useCapxulPermissions, useCapxulProfile, useCapxulRedirectPayment, useCapxulSend, useCapxulTransitions, useCapxulUploadImage };
+export { type AccountFailure, type AccountProgress, type ActionResult, type ActivityDetailSlice, type ActivityExportSlice, type ActivityFilterValues, type ActivityFiltersSlice, type ActivityLoadMoreSlice, type ActivityReceipt, type ActivityRow, type ActivityRowsSlice, type ActivitySearchSlice, type ActivitySummarySlice, type AuthenticatedState, type AuthenticationSlots, type CanReason, CapxulActivity, type CapxulActivityProps, type CapxulAuth, CapxulAuthenticationController, type CapxulBootstrapState, type CapxulBootstrapStatus, CapxulClientConnection, type CapxulClientConnectionProps, CapxulContacts, type CapxulContactsProps, CapxulDashboardAccess, type CapxulDashboardAccessProps, CapxulOnboardingController, CapxulOrgMember, type CapxulOrgMemberProps, CapxulPayroll, type CapxulPayrollProps, CapxulPayrollRun, type CapxulPayrollRunBlockedReason, type CapxulPayrollRunProps, CapxulProvider, type CapxulProviderProps, type CapxulSend, CapxulSendMoney, type CapxulSendMoneyBlockedReason, type CapxulSendMoneyProps, type CompleteSlice as ClientConnectionCompleteSlice, type ConsentSlice as ClientConnectionConsentSlice, type FailureSlice as ClientConnectionFailureSlice, type OtpSlice as ClientConnectionOtpSlice, type Contact, type ContactRelationship, type ContactRow, type ContactsActor, type ContactsAddBlockedReason, type ContactsAddError, type ContactsAddSlice, type ContactsListOptions, type ContactsListSlice, type ContactsRefusal, type ContactsSummarySlice, type ControllerAction, type CreateOrganizationFailure, type CreateOrganizationSubmission, type CsvExport, type DashboardAccessErrorSlice, type DashboardAccessPhase, type DashboardAccessProbe, type DashboardAccessRedirectSlice, type DashboardScope, type Destination, type FaultedState, type HandleAvailability, type ImageUploadInput, type ImageUploadTarget, type InvocationOptions, type NavigationAction, type OnboardingControllerProps, type OnboardingIntent, type OnboardingJourney, type OnboardingJourneyPosition, type OnboardingOrigin, type OnboardingStep, type OrgFailure, type OrgMemberAction, type OrgMemberCanSlice, type OrgMemberStanding, type OrgMemberStandingSlice, type OrgProgress, type OrganizationDetails, type OrganizationDraft, type OtpPendingState, type PayoutDraftChain, type PayoutDraftEntry, type PayrollGroupRow, type PayrollGroupsSlice, type PayrollRecipientOption, type PayrollRunActionsSlice, type PayrollRunAmountEntry, type PayrollRunAmountsSlice, type PayrollRunAssetSlice, type PayrollRunGroupOption, type PayrollRunPrefill, type PayrollRunRecipientsSlice, type PayrollRunStatus, type PayrollRunSummarySlice, type PayrollSummarySlice, type PendingAuthState, type ProfileDetails, type ProfileDraft, type ProfileSlotProps, type ReadyDestination, type RetryAction, type SendActor, type SendMoneyActionsSlice, type SendMoneyAmountSlice, type SendMoneyAssetError, type SendMoneyAssetOption, type SendMoneyAssetSlice, type SendMoneyRecipientSlice, type SendMoneyRecipientStatus, type SendMoneySourceError, type SendMoneySourceOption, type SendMoneySourceSlice, type SendResult, type SentPayment, type SentPayrollRun, type SignedOutState, type Slot, type SummaryWindow, type UseCapxulAccountBalanceOptions, type UseCapxulAccountBalanceReturn, type UseCapxulAccountFundReturn, type UseCapxulCreateCommitmentReturn, type UseCapxulCreateOrgReturn, type UseCapxulHandleAvailabilityReturn, type UseCapxulImageUploadReturn, type UseCapxulOrgMembersOptions, type UseCapxulOrgMembersReturn, type UseCapxulOrgRolesOptions, type UseCapxulOrgRolesReturn, type UseCapxulOrgTreasuryOptions, type UseCapxulOrgTreasuryReturn, type UseCapxulOrgsReturn, type UseCapxulPayReturn, type UseCapxulPaymentReturn, type UseCapxulPaymentsReturn, type UseCapxulProfileReturn, type UseCapxulRedirectPaymentReturn, type UseCapxulUploadImageReturn, acknowledgeOnboardingDestination, activeOnboardingRecovery, capxulKeys, clearOnboardingJourney, currentOnboardingJourneyId, entered, invalidateOnboardingJourneyObservation, isClaimed, isRestoring, loadOnboardingJourney, onboardingJourneyPosition, saveOnboardingJourney, startOnboardingJourney, useCapxul, useCapxulAccountBalance, useCapxulAccountFund, useCapxulActivity, useCapxulActivityDetail, useCapxulAnnotateMovement, useCapxulAuth, useCapxulCancelPayment, useCapxulClaimPayment, useCapxulClientOrNull, useCapxulCreateCommitment, useCapxulCreateOrg, useCapxulDestination, useCapxulHandleAvailability, useCapxulHoldings, useCapxulIdentity, useCapxulImageUpload, useCapxulOrgMembers, useCapxulOrgRoles, useCapxulOrgTreasury, useCapxulOrganizationPay, useCapxulOrganizationPayBatch, useCapxulOrgs, useCapxulPay, useCapxulPayment, useCapxulPayments, useCapxulPermission, useCapxulPermissionAssign, useCapxulPermissionChange, useCapxulPermissionCreate, useCapxulPermissionReplace, useCapxulPermissionRevoke, useCapxulPermissions, useCapxulProfile, useCapxulRedirectPayment, useCapxulSend, useCapxulTransitions, useCapxulUploadImage };