@capxul/sdk-react 2.1.0 → 2.2.0

package/README.md

@@ -35,6 +35,19 @@ export function Providers({ children }: { children: React.ReactNode }) {
 - Rich-data hooks such as `useCapxulProfile`, `useCapxulOrgs`, members, roles,
   treasury, and money hooks remain TanStack Query projections. Personal
   holdings and activity reads start only after the Account is claimed.
+- `CapxulSendMoney` is the compound send component. One root owns the send
+  behaviour and draws nothing. The `.Asset`, `.Amount`, `.Recipient`, and
+  `.Actions` region parts each hand the screen one finished slice. The engine
+  hook stays module-scoped. This release ships the personal actor path;
+  `.Source` and the organization path follow the Access & session budgets
+  read.
+- `CapxulContacts` is the compound address-book component. One root owns the
+  book behaviour and draws nothing. The `.Summary`, `.List`, and `.Add` region
+  parts each hand the screen one finished slice, and a `.List` row carries its
+  own `rename`, `hide`, and `unhide` verbs. A screen places any subset. Both
+  actor paths ship: a personal actor reads the account book, and an
+  organization actor reads the organization book. The `managePeople` capability
+  gate stays in the app, on `CapxulOrgMember.Can`.
 
 The packed npm package exposes `@capxul/sdk-react` and
 `@capxul/sdk-react/testing`. The workspace-only `@capxul/sdk-react/headless`

package/dist/{controllers-Chqyy3HR.mjs → controllers-ClhmseFL.mjs}

@@ -80,6 +80,17 @@ const capxulKeys = {
 		orgId ?? "pending",
 		"permissions"
 	],
+	contacts: (scope) => [
+		"capxul",
+		"contacts",
+		scope
+	],
+	contactsList: (scope, includeHidden) => [
+		"capxul",
+		"contacts",
+		scope,
+		includeHidden ? "all" : "visible"
+	],
 	activity: ["capxul", "activity"],
 	activityDetail: (reference) => [
 		"capxul",

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { A as useCapxulAuth, C as CreateOrganizationSubmission, D as ProfileDetails, E as OrganizationDetails, M as useCapxulIdentity, N as useCapxulSend, O as SendResult, P as useCapxulTransitions, S as CapxulSend, T as InvocationOptions, _ 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 useCapxulDestination, k as entered, 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 Destination, x as CapxulAuth, y as SignedOutState } from "./controllers-D3_Q5d2t.mjs";
 import { ReactNode } from "react";
 import { QueryClient, UseMutationResult, UseQueryResult } from "@tanstack/react-query";
-import { Account, AccountRequirement, ActivityAnnotationInput, ActivityDetail, ActivityListParams, ActivityPage, ActivityReference, CapxulClient, CapxulError, CapxulSigner, CreateOrgInput, CurrentHoldings, HostObservability, InviteMemberInput, MemberView, Money, MovementAnnotation, OrgId, OrgView, OrganizationPaymentBatchInput, OrganizationPaymentInput, Payment, PaymentTiming, PaymentsPayInput, Permission, PermissionReadResult, Profile, RoleView } from "@capxul/sdk";
+import { Account, AccountRequirement, ActivityAnnotationInput, ActivityDetail, ActivityListParams, ActivityPage, ActivityReference, AddressBookEntry, CapxulClient, CapxulError, CapxulSigner, CreateOrgInput, CurrentHoldings, HostObservability, InviteMemberInput, MemberView, Money, MoneyParseErrorReason, MovementAnnotation, OrgId, OrgView, OrganizationPaymentBatchInput, OrganizationPaymentInput, PartyId, Payment, PaymentTiming, PaymentsPayInput, Permission, PermissionReadResult, Profile, RoleView } from "@capxul/sdk";
 
 //#region src/provider.d.ts
 type CapxulProviderSharedProps = {
@@ -112,6 +112,7 @@ type Address = Brand<string, "Address">;
 type PermissionId = Brand<string, "PermissionId">;
 type PermissionAssignmentId = Brand<string, "PermissionAssignmentId">;
 type PaymentCommandId = Brand<string, "PaymentCommandId">;
+type OrgId$1 = Brand<string, "OrgId">;
 type WeiAmount = Brand<string, "WeiAmount">;
 type RoleKey = Brand<string, "RoleKey">;
 type AllowanceKey = Brand<string, "AllowanceKey">;
@@ -517,4 +518,215 @@ type UseCapxulImageUploadReturn = UseMutationResult<{
  */
 declare function useCapxulImageUpload(): UseCapxulImageUploadReturn;
 //#endregion
-export { type AccountFailure, type AccountProgress, type ActionResult, type AuthenticatedState, type AuthenticationSlots, type CapxulAuth, CapxulAuthenticationController, type CapxulBootstrapState, type CapxulBootstrapStatus, CapxulOnboardingController, CapxulProvider, type CapxulProviderProps, type CapxulSend, type ControllerAction, type CreateOrganizationSubmission, type Destination, type FaultedState, type ImageUploadInput, type ImageUploadTarget, type InvocationOptions, type NavigationAction, type OnboardingControllerProps, type OnboardingIntent, type OnboardingJourney, type OnboardingJourneyPosition, type OnboardingOrigin, type OnboardingStep, type OrgFailure, type OrgProgress, type OrganizationDetails, type OrganizationDraft, type OtpPendingState, type PayoutDraftChain, type PayoutDraftEntry, type PendingAuthState, type ProfileDetails, type ProfileDraft, type ProfileSlotProps, type ReadyDestination, type RetryAction, type SendResult, type SignedOutState, type Slot, type UseCapxulAccountBalanceOptions, type UseCapxulAccountBalanceReturn, type UseCapxulAccountFundReturn, type UseCapxulCreateCommitmentReturn, type UseCapxulCreateOrgReturn, 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 UseCapxulUsernameAvailabilityReturn, type UsernameAvailability, acknowledgeOnboardingDestination, activeOnboardingRecovery, clearOnboardingJourney, currentOnboardingJourneyId, entered, invalidateOnboardingJourneyObservation, loadOnboardingJourney, onboardingJourneyPosition, saveOnboardingJourney, startOnboardingJourney, useCapxul, useCapxulAccountBalance, useCapxulAccountFund, useCapxulActivity, useCapxulActivityDetail, useCapxulAnnotateMovement, useCapxulAuth, useCapxulCancelPayment, useCapxulClaimPayment, useCapxulClientOrNull, useCapxulCreateCommitment, useCapxulCreateOrg, useCapxulDestination, useCapxulHoldings, useCapxulIdentity, useCapxulImageUpload, useCapxulInviteMember, useCapxulOrgMembers, useCapxulOrgRoles, useCapxulOrgTreasury, useCapxulOrganizationPay, useCapxulOrganizationPayBatch, useCapxulOrgs, useCapxulPay, useCapxulPayment, useCapxulPayments, useCapxulPermission, useCapxulPermissionAssign, useCapxulPermissionChange, useCapxulPermissionCreate, useCapxulPermissionReplace, useCapxulPermissionRevoke, useCapxulPermissions, useCapxulProfile, useCapxulRedirectPayment, useCapxulSend, useCapxulTransitions, useCapxulUsernameAvailability };
+//#region src/headless/contacts/use-contacts.d.ts
+type ContactsActor = {
+  readonly kind: "personal";
+} | {
+  readonly kind: "organization";
+  readonly orgId: OrgId$1 | undefined;
+};
+/**
+ * How a contact entered the book. Taken from the shipped surface rather than
+ * re-declared, so the component can never advertise a provenance the wire
+ * cannot carry (ADR-0022 R2; #1532 owns the definition site).
+ */
+type ContactRelationship = AddressBookEntry["relationship"][number];
+interface Contact {
+  /**
+   * The counterparty's `PartyId` — created once and claimed at signup, never
+   * re-keyed (ADR-0022 R1/R3). No email, no prefix, nothing to parse.
+   */
+  readonly id: PartyId;
+  /** The saved label when there is one, else the party's display name. */
+  readonly name: string;
+  readonly relationship: readonly ContactRelationship[];
+  readonly hidden: boolean;
+  /** Epoch milliseconds. The seam never formats a date; the app writes the words. */
+  readonly lastActivityAt: number;
+}
+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;
+}
+/** ADR-0023 R1: refusal CODES, never sentences — the app owns the words. */
+type ContactsRefusal = "loading" | "org-unavailable" | "unavailable";
+/**
+ * The blocked facts, in the fixed order `.Add.blockedReason` names them.
+ * `"no-permission"` is absent by ruling, not by omission: the org screen places
+ * `CapxulOrgMember.Can do="managePeople"` around its own Add control.
+ */
+type ContactsAddBlockedReason = "org-unavailable" | "empty";
+/**
+ * Why an add did not land, as a code. ADR-0023 R1 supersedes the contract's
+ * field-message carve-out: `"unresolved"` is the backend refusing to resolve
+ * what was typed (`INVALID_INPUT`), and every other code — offline, signed
+ * out, refused — is `"failed"`. A person can fix only one of them.
+ */
+type ContactsAddError = "unresolved" | "failed";
+interface ContactsSummarySlice {
+  readonly total: number | null;
+  readonly activeCount: number | null;
+  readonly isLoading: boolean;
+  readonly reason: ContactsRefusal | null;
+}
+interface ContactsListSlice {
+  readonly rows: readonly ContactRow[];
+  readonly isLoading: boolean;
+  readonly reason: ContactsRefusal | null;
+}
+interface ContactsListOptions {
+  readonly limit?: number | undefined;
+  /** `"all"` forwards `includeHidden` to the backend, which already accepts it. */
+  readonly show?: "visible" | "all" | undefined;
+}
+interface ContactsAddSlice {
+  readonly value: string;
+  readonly change: (text: string) => void;
+  readonly submit: () => void;
+  readonly isSubmitting: boolean;
+  readonly blocked: boolean;
+  readonly blockedReason: ContactsAddBlockedReason | null;
+  readonly error: ContactsAddError | null;
+}
+//#endregion
+//#region src/headless/contacts/contacts.d.ts
+interface CapxulContactsProps {
+  readonly actor: ContactsActor;
+  readonly onAdded: (contact: Contact) => void;
+  /** ADR-0023 R1: the app maps `error.code` to its own copy; no SDK sentence. */
+  readonly onFailed: (error: CapxulError) => void;
+  readonly children: ReactNode;
+}
+declare function Root$1({
+  actor,
+  onAdded,
+  onFailed,
+  children
+}: CapxulContactsProps): import("react/jsx-runtime").JSX.Element;
+declare function Summary({
+  children
+}: {
+  readonly children: (slice: ContactsSummarySlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+declare function List({
+  limit,
+  show,
+  children
+}: ContactsListOptions & {
+  readonly children: (slice: ContactsListSlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+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$1 & {
+  Summary: typeof Summary;
+  List: typeof List;
+  Add: typeof Add;
+};
+//#endregion
+//#region src/headless/send-money/use-recipient-resolution.d.ts
+type SendMoneyRecipientMethod = "username" | "email-address";
+type SendMoneyRecipientStatus = "empty" | "checking" | "found" | "not-found" | "failed";
+interface SendMoneyRecipientSlice {
+  readonly method: SendMoneyRecipientMethod;
+  readonly setMethod: (method: SendMoneyRecipientMethod) => void;
+  readonly value: string;
+  readonly change: (text: string) => void;
+  /** ADR-0023 R1: the status IS the failure code; the app owns the sentence. */
+  readonly status: SendMoneyRecipientStatus;
+  readonly label: string | null;
+}
+//#endregion
+//#region src/headless/send-money/use-send-money.d.ts
+type SendActor = {
+  readonly kind: "personal";
+} | {
+  readonly kind: "organization";
+  readonly orgId: OrgId$1 | undefined;
+};
+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; /** The trimmed text the person typed — the app's success toast interpolates it. */
+  readonly recipient: string;
+};
+/**
+ * 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";
+interface SendMoneyAssetOption {
+  readonly id: string;
+  readonly symbol: string;
+  readonly availableDisplay: string;
+}
+/** ADR-0023 R1: a code, never a sentence — the app owns the words. */
+type SendMoneyAssetError = "read-failed";
+interface SendMoneyAssetSlice {
+  readonly options: ReadonlyArray<SendMoneyAssetOption>;
+  readonly selected: SendMoneyAssetOption | null;
+  readonly select: (id: string) => void;
+  readonly error: SendMoneyAssetError | null;
+}
+interface SendMoneyAmountSlice {
+  readonly value: string;
+  readonly change: (text: string) => void;
+  /** ADR-0023 R1: the parse verdict as a closed code; the app maps it to copy. */
+  readonly error: MoneyParseErrorReason | null;
+  readonly availableDisplay: string | null;
+}
+interface SendMoneyActionsSlice {
+  readonly submit: () => void;
+  readonly isSubmitting: boolean;
+  readonly blocked: boolean;
+  readonly blockedReason: CapxulSendMoneyBlockedReason | null;
+}
+//#endregion
+//#region src/headless/send-money/send-money.d.ts
+interface CapxulSendMoneyProps {
+  readonly actor: SendActor;
+  readonly onSent: (sent: SentPayment) => void;
+  /** ADR-0023 R1: the app maps `error.code` to its own copy; no SDK sentence. */
+  readonly onFailed: (error: CapxulError) => void;
+  readonly children: ReactNode;
+}
+declare function Root({
+  actor,
+  onSent,
+  onFailed,
+  children
+}: CapxulSendMoneyProps): import("react/jsx-runtime").JSX.Element;
+declare function Asset({
+  children
+}: {
+  readonly children: (slice: SendMoneyAssetSlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+declare function Amount({
+  children
+}: {
+  readonly children: (slice: SendMoneyAmountSlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+declare function Recipient({
+  children
+}: {
+  readonly children: (slice: SendMoneyRecipientSlice) => ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+declare function Actions({
+  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 & {
+  Asset: typeof Asset;
+  Amount: typeof Amount;
+  Recipient: typeof Recipient;
+  Actions: typeof Actions;
+};
+//#endregion
+export { type AccountFailure, type AccountProgress, type ActionResult, type AuthenticatedState, type AuthenticationSlots, type CapxulAuth, CapxulAuthenticationController, type CapxulBootstrapState, type CapxulBootstrapStatus, CapxulContacts, type CapxulContactsProps, CapxulOnboardingController, 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 CreateOrganizationSubmission, type Destination, type FaultedState, type ImageUploadInput, type ImageUploadTarget, type InvocationOptions, type NavigationAction, type OnboardingControllerProps, type OnboardingIntent, type OnboardingJourney, type OnboardingJourneyPosition, type OnboardingOrigin, type OnboardingStep, type OrgFailure, type OrgProgress, type OrganizationDetails, type OrganizationDraft, type OtpPendingState, type PayoutDraftChain, type PayoutDraftEntry, 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 SendMoneyRecipientMethod, type SendMoneyRecipientSlice, type SendMoneyRecipientStatus, type SendResult, type SentPayment, type SignedOutState, type Slot, type UseCapxulAccountBalanceOptions, type UseCapxulAccountBalanceReturn, type UseCapxulAccountFundReturn, type UseCapxulCreateCommitmentReturn, type UseCapxulCreateOrgReturn, 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 UseCapxulUsernameAvailabilityReturn, type UsernameAvailability, acknowledgeOnboardingDestination, activeOnboardingRecovery, clearOnboardingJourney, currentOnboardingJourneyId, entered, invalidateOnboardingJourneyObservation, loadOnboardingJourney, onboardingJourneyPosition, saveOnboardingJourney, startOnboardingJourney, useCapxul, useCapxulAccountBalance, useCapxulAccountFund, useCapxulActivity, useCapxulActivityDetail, useCapxulAnnotateMovement, useCapxulAuth, useCapxulCancelPayment, useCapxulClaimPayment, useCapxulClientOrNull, useCapxulCreateCommitment, useCapxulCreateOrg, useCapxulDestination, useCapxulHoldings, useCapxulIdentity, useCapxulImageUpload, useCapxulInviteMember, useCapxulOrgMembers, useCapxulOrgRoles, useCapxulOrgTreasury, useCapxulOrganizationPay, useCapxulOrganizationPayBatch, useCapxulOrgs, useCapxulPay, useCapxulPayment, useCapxulPayments, useCapxulPermission, useCapxulPermissionAssign, useCapxulPermissionChange, useCapxulPermissionCreate, useCapxulPermissionReplace, useCapxulPermissionRevoke, useCapxulPermissions, useCapxulProfile, useCapxulRedirectPayment, useCapxulSend, useCapxulTransitions, useCapxulUsernameAvailability };

package/dist/index.mjs

@@ -1,166 +1,9 @@
 "use client";
-import { a as useCapxulAuth, c as useCapxulIdentityOrNull, d as capxulKeys, f as useCapxulClientOrNull, i as entered, l as useCapxulSend, n as CapxulOnboardingController, o as useCapxulDestination, p as useCapxul, r as CapxulProvider, s as useCapxulIdentity, t as CapxulAuthenticationController, u as useCapxulTransitions } from "./controllers-Chqyy3HR.mjs";
-import { useEffect, useState } from "react";
+import { a as useCapxulAuth, c as useCapxulIdentityOrNull, d as capxulKeys, f as useCapxulClientOrNull, i as entered, l as useCapxulSend, n as CapxulOnboardingController, o as useCapxulDestination, p as useCapxul, r as CapxulProvider, s as useCapxulIdentity, t as CapxulAuthenticationController, u as useCapxulTransitions } from "./controllers-ClhmseFL.mjs";
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
-import { fingerprintPaymentIntent } from "@capxul/sdk";
-//#region ../errors/src/errors.ts
-const CAPXUL_ERROR_CODES = [
-	"NOT_AUTHENTICATED",
-	"EMAIL_DELIVERY_FAILED",
-	"PROFILE_NOT_FOUND",
-	"SMART_ACCOUNT_MISSING",
-	"PLAYER_NOT_FOUND",
-	"ACCOUNT_NOT_FOUND",
-	"PROVIDER_ERROR",
-	"CAPABILITY_UNAVAILABLE",
-	"INVALID_INPUT",
-	"ENV_MISSING",
-	"NOT_IMPLEMENTED",
-	"VERIFICATION_REQUIRED",
-	"INSUFFICIENT_BALANCE",
-	"INVALID_RECIPIENT",
-	"ROLE_PERMISSION_DENIED",
-	"TRANSACTION_FAILED",
-	"RATE_LIMITED",
-	"NETWORK_ERROR",
-	"UNKNOWN",
-	"OTP_EXPIRED",
-	"SIGNER_REJECTED",
-	"CANCELLED",
-	"WRONG_STATE",
-	"STALE_EPOCH",
-	"SUPERSEDED",
-	"WORK_DIED",
-	"ACTOR_STOPPED"
-];
-var CapxulError$1 = class extends Error {
-	code;
-	details;
-	correlationId;
-	layer;
-	constructor(code, message, options = {}) {
-		super(message, "cause" in options ? { cause: options.cause } : void 0);
-		this.name = "CapxulError";
-		this.code = code;
-		if (options.details !== void 0) this.details = options.details;
-		if (options.correlationId !== void 0) this.correlationId = options.correlationId;
-		if (options.layer !== void 0) this.layer = options.layer;
-	}
-};
-const Errors = {
-	notAuthenticated: (message, opts) => new CapxulError$1("NOT_AUTHENTICATED", message ?? "Not authenticated", opts?.failure_mode ? { details: { failure_mode: opts.failure_mode } } : void 0),
-	emailDeliveryFailed: (detail) => new CapxulError$1("EMAIL_DELIVERY_FAILED", "Failed to send email", { details: { detail } }),
-	profileNotFound: (authUserId) => new CapxulError$1("PROFILE_NOT_FOUND", `Profile not found for user ${authUserId}`, { details: { authUserId } }),
-	smartAccountMissing: (authUserId) => new CapxulError$1("SMART_ACCOUNT_MISSING", "Smart account not provisioned", { details: { authUserId } }),
-	playerNotFound: (playerId) => new CapxulError$1("PLAYER_NOT_FOUND", playerId ? `Openfort player ${playerId} not found` : "Openfort player not found", playerId === void 0 ? void 0 : { details: { playerId } }),
-	accountNotFound: (accountId) => new CapxulError$1("ACCOUNT_NOT_FOUND", accountId ? `Openfort account ${accountId} not found` : "Openfort account not found", accountId === void 0 ? void 0 : { details: { accountId } }),
-	providerError: (provider, operation, cause, opts) => {
-		const details = {
-			provider,
-			operation
-		};
-		if (opts?.failure_mode) details.failure_mode = opts.failure_mode;
-		return new CapxulError$1("PROVIDER_ERROR", `Provider error: ${provider} ${operation}`, {
-			cause,
-			details
-		});
-	},
-	capabilityUnavailable: (provider, operation) => new CapxulError$1("CAPABILITY_UNAVAILABLE", "Provider capability is unavailable", { details: {
-		provider,
-		operation
-	} }),
-	invalidInput: (field, reason) => new CapxulError$1("INVALID_INPUT", `Invalid ${field}: ${reason}`, { details: {
-		field,
-		reason
-	} }),
-	envMissing: (name) => new CapxulError$1("ENV_MISSING", `Environment variable ${name} not configured`, { details: { name } }),
-	notImplemented: (domain, method) => new CapxulError$1("NOT_IMPLEMENTED", `${domain}.${method} is not yet implemented. This feature is planned for a future release.`, { details: {
-		domain,
-		method
-	} }),
-	/**
-	* Sibling factory to {@link Errors.providerError} for the per-state timeout
-	* path in flows. Same `PROVIDER_ERROR` code as
-	* `providerError`, plus a `details.reason: "timeout"` discriminator so
-	* downstream observers can distinguish failure modes without parsing the
-	* message string. The redacted message names the timeout budget; the
-	* native `cause` carries the same information for `reportError` fidelity.
-	*/
-	providerTimeout: (provider, operation, timeoutMs) => new CapxulError$1("PROVIDER_ERROR", `Provider error: ${provider} ${operation} (timeout exceeded ${timeoutMs}ms)`, {
-		details: {
-			provider,
-			operation,
-			reason: "timeout"
-		},
-		cause: /* @__PURE__ */ new Error(`timeout: ${operation} exceeded ${timeoutMs}ms`)
-	}),
-	verificationRequired: (details) => {
-		return new CapxulError$1("VERIFICATION_REQUIRED", "rail" in details ? `Verification is required before ${details.rail} can use ${details.currentKind}.` : `Verification tier ${details.requiredTier} is required.`, { details });
-	},
-	insufficientBalance: (asset, available, required) => new CapxulError$1("INSUFFICIENT_BALANCE", `Insufficient ${asset} balance`, { details: {
-		asset,
-		available,
-		required
-	} }),
-	invalidRecipient: (reason) => new CapxulError$1("INVALID_RECIPIENT", `Invalid recipient: ${reason}`, { details: { reason } }),
-	/**
-	* The org Zodiac Roles modifier REFUSED the spend on-chain (G4 · #547): the
-	* member's role condition (per-tx cap, per-day allowance, allowed recipient,
-	* or membership) was violated, so `execTransactionWithRole` reverted. This is
-	* a PERMISSION denial — explicitly NOT an `INSUFFICIENT_BALANCE` (the treasury
-	* held the funds; the role's authority is what bound). `reason` discriminates
-	* the violated condition (`over_cap` / `daily_cap` / `not_member` /
-	* `disallowed_recipient` / `condition_violation`); leak-safe — no on-chain
-	* identifiers ever enter the details.
-	*/
-	rolePermissionDenied: (details) => new CapxulError$1("ROLE_PERMISSION_DENIED", `Org role denied this spend on-chain (${details.reason}).`, { details: details.operation === void 0 ? { reason: details.reason } : {
-		reason: details.reason,
-		operation: details.operation
-	} }),
-	/**
-	* A transaction (or sponsored UserOp) failed. `details.reason` discriminates
-	* the failure mode for callers that must distinguish a CONFIRMED on-chain
-	* revert (`"onchain_revert"` — the op executed and reverted, e.g. a Zodiac
-	* Roles condition violation) from an inconclusive infra failure. A confirmed
-	* revert is the ONLY mode the org spend port may map to a roles denial.
-	*/
-	transactionFailed: (operation, cause, extra) => new CapxulError$1("TRANSACTION_FAILED", `Transaction failed: ${operation}`, {
-		cause,
-		details: extra?.reason === void 0 ? { operation } : {
-			operation,
-			reason: extra.reason
-		}
-	}),
-	rateLimited: (details) => new CapxulError$1("RATE_LIMITED", "Rate limit exceeded", details === void 0 ? void 0 : { details: { ...details } }),
-	networkError: (operation, cause) => new CapxulError$1("NETWORK_ERROR", `Network error during ${operation}`, {
-		cause,
-		details: { operation }
-	}),
-	unknown: (cause) => new CapxulError$1("UNKNOWN", "Unknown error", { cause }),
-	otpExpired: (details) => new CapxulError$1("OTP_EXPIRED", "Verification code has expired. Request a new one.", details === void 0 ? void 0 : { details: { ...details } }),
-	signerRejected: (details) => new CapxulError$1("SIGNER_REJECTED", "Signer rejected the request.", {
-		cause: details.cause,
-		details: details.reason === void 0 ? { source: details.source } : {
-			source: details.source,
-			reason: details.reason
-		}
-	}),
-	cancelled: (details) => new CapxulError$1("CANCELLED", "Operation was cancelled.", details === void 0 ? void 0 : { details: { ...details } }),
-	/**
-	* Method called from a flow state where its precondition fails (TA16). The
-	* SDK's method API short-circuits with this error before driving the
-	* internal state machine. `currentState` is the Effect-machine snapshot
-	* tag (stringified from the SDK's actor-shell snapshot; see
-	* `packages/errors/CONTEXT.md`); `validStates`
-	* enumerates the states the method accepts.
-	*/
-	wrongState: (details) => new CapxulError$1("WRONG_STATE", `${details.method} called from state '${details.currentState}'; valid states: ${details.validStates.join(", ")}`, { details: {
-		...details,
-		validStates: [...details.validStates]
-	} })
-};
-new Set(CAPXUL_ERROR_CODES);
-//#endregion
+import { Errors, fingerprintPaymentIntent, formatMoney, isMoneyParseError, parseMoney } from "@capxul/sdk";
+import { Fragment, jsx } from "react/jsx-runtime";
 //#region src/internal/require-bootstrapped-client.ts
 /**
 * Narrow the bootstrap-nullable client to a ready client inside a query /
@@ -182,12 +25,10 @@ function requireBootstrappedClient(client, method) {
 * Unwrap a `CapxulResult` for TanStack query/mutation functions and throw into
 * React Query's error path.
 *
-* Failure observation belongs to the core SDK method boundary. The legacy
-* telemetry/operation arguments remain temporarily source-compatible with the
-* existing hook call sites, but are deliberately ignored so React cannot
+* Failure observation belongs to the core SDK method boundary. React does not
 * report the same logical failure a second time.
 */
-function unwrapCapxulResult(result, _legacyTelemetry, _legacyOperation = "query") {
+function unwrapCapxulResult(result) {
 	if (result.ok) return result.value;
 	throw result.error;
 }
@@ -198,7 +39,7 @@ function useCapxulProfile() {
 	const identity = useCapxulIdentityOrNull();
 	return useQuery({
 		queryKey: capxulKeys.profile,
-		queryFn: async () => unwrapCapxulResult(await requireBootstrappedClient(client, "identity.loadCurrent").identity.loadCurrent(), client._internal.telemetry),
+		queryFn: async () => unwrapCapxulResult(await requireBootstrappedClient(client, "identity.loadCurrent").identity.loadCurrent()),
 		enabled: client !== null && identity?.phase === "authenticated"
 	});
 }
@@ -209,8 +50,7 @@ function useCapxulAccountBalance(options) {
 	return useQuery({
 		queryKey: capxulKeys.accountBalance,
 		queryFn: async () => {
-			const bootstrappedClient = requireBootstrappedClient(client, "accounts.read");
-			return unwrapCapxulResult(await bootstrappedClient.accounts.read(), bootstrappedClient._internal.telemetry);
+			return unwrapCapxulResult(await requireBootstrappedClient(client, "accounts.read").accounts.read());
 		},
 		enabled: client !== null && (options?.enabled ?? true)
 	});
@@ -222,8 +62,7 @@ function useCapxulAccountFund() {
 	const queryClient = useQueryClient();
 	return useMutation({
 		mutationFn: async (amount) => {
-			const bootstrappedClient = requireBootstrappedClient(client, "_internal.accounts.fund");
-			return unwrapCapxulResult(await bootstrappedClient._internal.accounts.fund(amount), bootstrappedClient._internal.telemetry, "mutation");
+			return unwrapCapxulResult(await requireBootstrappedClient(client, "_internal.accounts.fund")._internal.accounts.fund(amount));
 		},
 		onSuccess: async () => {
 			await queryClient.invalidateQueries({ queryKey: capxulKeys.accountBalance });
@@ -255,7 +94,7 @@ async function storageKey(operation, intent) {
 }
 function paymentLockManager() {
 	const manager = navigator.locks;
-	if (manager === void 0 || typeof manager.query !== "function") throw new Error("Web Locks are required for payment request keys");
+	if (manager === void 0 || typeof manager.query !== "function") throw Errors.providerError("sdk-react", "paymentRequestKey", /* @__PURE__ */ new Error("Web Locks are required for payment request keys"));
 	return manager;
 }
 function attemptLockName(storageSlot, attemptId) {
@@ -299,14 +138,14 @@ function readState(key) {
 	const stored = localStorage.getItem(key);
 	if (stored === null) return null;
 	const state = JSON.parse(stored);
-	if (typeof state.key !== "string" || !Array.isArray(state.active) || state.active.some((attempt) => typeof attempt !== "string") || typeof state.resolved !== "boolean") throw new TypeError("Invalid payment request key state");
+	if (typeof state.key !== "string" || !Array.isArray(state.active) || state.active.some((attempt) => typeof attempt !== "string") || typeof state.resolved !== "boolean") throw Errors.providerError("sdk-react", "paymentRequestKey", /* @__PURE__ */ new TypeError("Invalid payment request key state"));
 	return state;
 }
 async function beginPaymentRequestKey(operation, intent) {
-	const storageSlot = await storageKey(operation, intent);
 	let releaseAttemptLock;
 	let forgetPagehideRelease;
 	try {
+		const storageSlot = await storageKey(operation, intent);
 		const attemptId = `attempt_${crypto.randomUUID()}`;
 		releaseAttemptLock = await holdAttemptLock(attemptLockName(storageSlot, attemptId));
 		forgetPagehideRelease = releaseAttemptOnPagehide(releaseAttemptLock);
@@ -408,7 +247,7 @@ function useCapxulPay() {
 			}, async (requestKey) => unwrapCapxulResult(await bootstrappedClient.payments.pay({
 				...input,
 				requestKey
-			}), bootstrappedClient._internal.telemetry, "mutation"));
+			})));
 		},
 		onSuccess: async (payment) => {
 			await invalidateMoneyState(queryClient, {
@@ -423,8 +262,7 @@ function useCapxulCreateCommitment() {
 	const queryClient = useQueryClient();
 	return useMutation({
 		mutationFn: async (input) => {
-			const bootstrapped = requireBootstrappedClient(client, "payments.createCommitment");
-			return unwrapCapxulResult(await bootstrapped.payments.createCommitment(input), bootstrapped._internal.telemetry, "mutation");
+			return unwrapCapxulResult(await requireBootstrappedClient(client, "payments.createCommitment").payments.createCommitment(input));
 		},
 		onSuccess: (payment) => invalidateMoneyState(queryClient, {
 			actor: { kind: "personal" },
@@ -437,8 +275,7 @@ function usePaymentIdMutation(method) {
 	const queryClient = useQueryClient();
 	return useMutation({
 		mutationFn: async (paymentId) => {
-			const bootstrapped = requireBootstrappedClient(client, `payments.${method}`);
-			return unwrapCapxulResult(await bootstrapped.payments[method](paymentId), bootstrapped._internal.telemetry, "mutation");
+			return unwrapCapxulResult(await requireBootstrappedClient(client, `payments.${method}`).payments[method](paymentId));
 		},
 		onSuccess: (payment) => invalidateMoneyState(queryClient, {
 			actor: { kind: "personal" },
@@ -453,8 +290,7 @@ function useCapxulRedirectPayment() {
 	const queryClient = useQueryClient();
 	return useMutation({
 		mutationFn: async (input) => {
-			const bootstrapped = requireBootstrappedClient(client, "payments.redirect");
-			return unwrapCapxulResult(await bootstrapped.payments.redirect(input), bootstrapped._internal.telemetry, "mutation");
+			return unwrapCapxulResult(await requireBootstrappedClient(client, "payments.redirect").payments.redirect(input));
 		},
 		onSuccess: (payment) => invalidateMoneyState(queryClient, {
 			actor: { kind: "personal" },
@@ -468,8 +304,7 @@ function useCapxulPayments(options) {
 	return useQuery({
 		queryKey: capxulKeys.payments,
 		queryFn: async () => {
-			const bootstrappedClient = requireBootstrappedClient(client, "payments.list");
-			return unwrapCapxulResult(await bootstrappedClient.payments.list(), bootstrappedClient._internal.telemetry);
+			return unwrapCapxulResult(await requireBootstrappedClient(client, "payments.list").payments.list());
 		},
 		enabled: client !== null && identity?.phase === "authenticated" && identity.account.at === "claimed" && (options?.enabled ?? true)
 	});
@@ -480,8 +315,7 @@ function useCapxulPayment(paymentId, options) {
 		queryKey: capxulKeys.payment(paymentId),
 		queryFn: async () => {
 			if (paymentId === void 0) throw Errors.invalidInput("paymentId", "required for payments.get");
-			const bootstrappedClient = requireBootstrappedClient(client, "payments.get");
-			return unwrapCapxulResult(await bootstrappedClient.payments.get(paymentId), bootstrappedClient._internal.telemetry);
+			return unwrapCapxulResult(await requireBootstrappedClient(client, "payments.get").payments.get(paymentId));
 		},
 		enabled: client !== null && paymentId !== void 0 && (options?.enabled ?? true)
 	});
@@ -502,7 +336,7 @@ function useCapxulOrganizationPay(orgId) {
 			}, async (requestKey) => unwrapCapxulResult(await bootstrapped.org(orgId).payments.pay({
 				...input,
 				requestKey
-			}), bootstrapped._internal.telemetry, "mutation"));
+			})));
 		},
 		onSuccess: async (payment) => {
 			return invalidateMoneyState(queryClient, {
@@ -529,7 +363,7 @@ function useCapxulOrganizationPayBatch(orgId) {
 			}, async (requestKey) => unwrapCapxulResult(await bootstrapped.org(orgId).payments.payBatch({
 				...input,
 				requestKey
-			}), bootstrapped._internal.telemetry, "mutation"));
+			})));
 		},
 		onSuccess: async (payments) => {
 			return Promise.all(payments.map((payment) => invalidateMoneyState(queryClient, {
@@ -549,9 +383,8 @@ function usePermissionMutation(orgId, operation) {
 	const queryClient = useQueryClient();
 	return useMutation({
 		mutationFn: async (input) => {
-			const bootstrapped = requireBootstrappedClient(client, `permissions.${operation}`);
-			const method = bootstrapped.org(orgId).permissions[operation];
-			return unwrapCapxulResult(await method(input), bootstrapped._internal.telemetry, "mutation");
+			const method = requireBootstrappedClient(client, `permissions.${operation}`).org(orgId).permissions[operation];
+			return unwrapCapxulResult(await method(input));
 		},
 		onSuccess: () => queryClient.invalidateQueries({ queryKey: capxulKeys.orgPermissions(orgId) })
 	});
@@ -566,8 +399,7 @@ function useCapxulPermissions(orgId, options) {
 	return useQuery({
 		queryKey: capxulKeys.orgPermissions(orgId),
 		queryFn: async () => {
-			const bootstrapped = requireBootstrappedClient(client, "permissions.list");
-			return unwrapCapxulResult(await bootstrapped.org(orgId).permissions.list(), bootstrapped._internal.telemetry);
+			return unwrapCapxulResult(await requireBootstrappedClient(client, "permissions.list").org(orgId).permissions.list());
 		},
 		enabled: client !== null && (options?.enabled ?? true)
 	});
@@ -577,9 +409,8 @@ function useCapxulPermission(orgId, permissionId) {
 	return useQuery({
 		queryKey: [...capxulKeys.orgPermissions(orgId), permissionId ?? "pending"],
 		queryFn: async () => {
-			if (permissionId === void 0) throw new Error("permissionId is required");
-			const bootstrapped = requireBootstrappedClient(client, "permissions.get");
-			return unwrapCapxulResult(await bootstrapped.org(orgId).permissions.get(permissionId), bootstrapped._internal.telemetry);
+			if (permissionId === void 0) throw Errors.invalidInput("permissionId", "required for permissions.get");
+			return unwrapCapxulResult(await requireBootstrappedClient(client, "permissions.get").org(orgId).permissions.get(permissionId));
 		},
 		enabled: client !== null && permissionId !== void 0
 	});
@@ -592,8 +423,7 @@ function useCapxulActivity(params) {
 	return useQuery({
 		queryKey: [...capxulKeys.activity, params ?? {}],
 		queryFn: async () => {
-			const bootstrapped = requireBootstrappedClient(client, "activity.list");
-			return unwrapCapxulResult(await bootstrapped.activity.list(params), bootstrapped._internal.telemetry);
+			return unwrapCapxulResult(await requireBootstrappedClient(client, "activity.list").activity.list(params));
 		},
 		enabled: client !== null && identity?.phase === "authenticated" && identity.account.at === "claimed"
 	});
@@ -604,9 +434,8 @@ function useCapxulActivityDetail(reference) {
 	return useQuery({
 		queryKey: capxulKeys.activityDetail(reference),
 		queryFn: async () => {
-			if (reference === void 0) throw new Error("activity reference is required");
-			const bootstrapped = requireBootstrappedClient(client, "activity.get");
-			return unwrapCapxulResult(await bootstrapped.activity.get(reference), bootstrapped._internal.telemetry);
+			if (reference === void 0) throw Errors.invalidInput("reference", "required for activity.get");
+			return unwrapCapxulResult(await requireBootstrappedClient(client, "activity.get").activity.get(reference));
 		},
 		enabled: client !== null && reference !== void 0 && identity?.phase === "authenticated" && identity.account.at === "claimed"
 	});
@@ -616,8 +445,7 @@ function useCapxulAnnotateMovement() {
 	const queryClient = useQueryClient();
 	return useMutation({
 		mutationFn: async (input) => {
-			const bootstrapped = requireBootstrappedClient(client, "activity.annotate");
-			return unwrapCapxulResult(await bootstrapped.activity.annotate(input), bootstrapped._internal.telemetry, "mutation");
+			return unwrapCapxulResult(await requireBootstrappedClient(client, "activity.annotate").activity.annotate(input));
 		},
 		onSuccess: () => queryClient.invalidateQueries({ queryKey: capxulKeys.activity })
 	});
@@ -630,8 +458,7 @@ function useCapxulHoldings() {
 	return useQuery({
 		queryKey: capxulKeys.holdings,
 		queryFn: async () => {
-			const bootstrapped = requireBootstrappedClient(client, "holdings.current");
-			return unwrapCapxulResult(await bootstrapped.holdings.current(), bootstrapped._internal.telemetry);
+			return unwrapCapxulResult(await requireBootstrappedClient(client, "holdings.current").holdings.current());
 		},
 		enabled: client !== null && identity?.phase === "authenticated" && identity.account.at === "claimed"
 	});
@@ -643,8 +470,7 @@ function useCapxulOrgs(options) {
 	return useQuery({
 		queryKey: capxulKeys.orgs,
 		queryFn: async () => {
-			const bootstrappedClient = requireBootstrappedClient(client, "orgs");
-			return unwrapCapxulResult(await bootstrappedClient.orgs(), bootstrappedClient._internal.telemetry);
+			return unwrapCapxulResult(await requireBootstrappedClient(client, "orgs").orgs());
 		},
 		enabled: client !== null && (options?.enabled ?? true)
 	});
@@ -658,8 +484,7 @@ function useCapxulOrgMembers(orgId, options) {
 		queryKey: capxulKeys.orgMembers(orgId),
 		queryFn: async () => {
 			if (orgId === void 0) throw Errors.invalidInput("orgId", "required for useCapxulOrgMembers");
-			const bootstrappedClient = requireBootstrappedClient(client, "org.members");
-			return unwrapCapxulResult(await bootstrappedClient.org(orgId).members(), bootstrappedClient._internal.telemetry);
+			return unwrapCapxulResult(await requireBootstrappedClient(client, "org.members").org(orgId).members());
 		},
 		enabled: client !== null && enabled && orgId !== void 0
 	});
@@ -673,8 +498,7 @@ function useCapxulOrgRoles(orgId, options) {
 		queryKey: capxulKeys.orgRoles(orgId),
 		queryFn: async () => {
 			if (orgId === void 0) throw Errors.invalidInput("orgId", "required for useCapxulOrgRoles");
-			const bootstrappedClient = requireBootstrappedClient(client, "org.roles");
-			return unwrapCapxulResult(await bootstrappedClient.org(orgId).roles(), bootstrappedClient._internal.telemetry);
+			return unwrapCapxulResult(await requireBootstrappedClient(client, "org.roles").org(orgId).roles());
 		},
 		enabled: client !== null && enabled && orgId !== void 0
 	});
@@ -688,8 +512,7 @@ function useCapxulOrgTreasury(orgId, options) {
 		queryKey: capxulKeys.orgTreasury(orgId),
 		queryFn: async () => {
 			if (orgId === void 0) throw Errors.invalidInput("orgId", "required for useCapxulOrgTreasury");
-			const bootstrappedClient = requireBootstrappedClient(client, "org.treasury");
-			return unwrapCapxulResult(await bootstrappedClient.org(orgId).treasury(), bootstrappedClient._internal.telemetry);
+			return unwrapCapxulResult(await requireBootstrappedClient(client, "org.treasury").org(orgId).treasury());
 		},
 		enabled: client !== null && enabled && orgId !== void 0
 	});
@@ -701,8 +524,7 @@ function useCapxulCreateOrg() {
 	const queryClient = useQueryClient();
 	return useMutation({
 		mutationFn: async (input) => {
-			const bootstrappedClient = requireBootstrappedClient(client, "createOrg");
-			return unwrapCapxulResult(await bootstrappedClient.createOrg(input), bootstrappedClient._internal.telemetry, "mutation");
+			return unwrapCapxulResult(await requireBootstrappedClient(client, "createOrg").createOrg(input));
 		},
 		onSuccess: async () => {
 			await queryClient.invalidateQueries({ queryKey: capxulKeys.orgs });
@@ -717,8 +539,7 @@ function useCapxulInviteMember(orgId) {
 	return useMutation({
 		mutationFn: async (input) => {
 			if (orgId === void 0) throw Errors.invalidInput("orgId", "required for useCapxulInviteMember");
-			const bootstrappedClient = requireBootstrappedClient(client, "org.invite");
-			return unwrapCapxulResult(await bootstrappedClient.org(orgId).invite(input), bootstrappedClient._internal.telemetry, "mutation");
+			return unwrapCapxulResult(await requireBootstrappedClient(client, "org.invite").org(orgId).invite(input));
 		},
 		onSuccess: async () => {
 			if (orgId === void 0) return;
@@ -973,8 +794,7 @@ function useCapxulUsernameAvailability(username, options) {
 	return useQuery({
 		queryKey: capxulKeys.usernameAvailability(candidate),
 		queryFn: async () => {
-			const bootstrappedClient = requireBootstrappedClient(client, "identity.usernameAvailable");
-			return unwrapCapxulResult(await bootstrappedClient.identity.usernameAvailable(candidate), bootstrappedClient._internal.telemetry);
+			return unwrapCapxulResult(await requireBootstrappedClient(client, "identity.usernameAvailable").identity.usernameAvailable(candidate));
 		},
 		enabled: client !== null && candidate.length >= 3 && (options?.enabled ?? true)
 	});
@@ -992,15 +812,13 @@ function useCapxulImageUpload() {
 	const queryClient = useQueryClient();
 	return useMutation({
 		mutationFn: async ({ blob, target }) => {
-			const bootstrappedClient = requireBootstrappedClient(client, "media.uploadImage");
-			const media = bootstrappedClient.media;
-			const telemetry = bootstrappedClient._internal.telemetry;
-			const uploaded = unwrapCapxulResult(await media.uploadImage(blob), telemetry);
-			if (target.kind === "profile") return { url: unwrapCapxulResult(await media.setProfileImage({ storageId: uploaded.storageId }), telemetry).imageUrl };
+			const media = requireBootstrappedClient(client, "media.uploadImage").media;
+			const uploaded = unwrapCapxulResult(await media.uploadImage(blob));
+			if (target.kind === "profile") return { url: unwrapCapxulResult(await media.setProfileImage({ storageId: uploaded.storageId })).imageUrl };
 			return { url: unwrapCapxulResult(await media.setOrgLogo({
 				orgId: target.orgId,
 				storageId: uploaded.storageId
-			}), telemetry).logoUrl };
+			})).logoUrl };
 		},
 		onSuccess: async (_value, input) => {
 			await queryClient.invalidateQueries({ queryKey: input.target.kind === "profile" ? capxulKeys.profile : capxulKeys.orgs });
@@ -1008,4 +826,413 @@ function useCapxulImageUpload() {
 	});
 }
 //#endregion
-export { CapxulAuthenticationController, CapxulOnboardingController, CapxulProvider, acknowledgeOnboardingDestination, activeOnboardingRecovery, clearOnboardingJourney, currentOnboardingJourneyId, entered, invalidateOnboardingJourneyObservation, loadOnboardingJourney, onboardingJourneyPosition, saveOnboardingJourney, startOnboardingJourney, useCapxul, useCapxulAccountBalance, useCapxulAccountFund, useCapxulActivity, useCapxulActivityDetail, useCapxulAnnotateMovement, useCapxulAuth, useCapxulCancelPayment, useCapxulClaimPayment, useCapxulClientOrNull, useCapxulCreateCommitment, useCapxulCreateOrg, useCapxulDestination, useCapxulHoldings, useCapxulIdentity, useCapxulImageUpload, useCapxulInviteMember, useCapxulOrgMembers, useCapxulOrgRoles, useCapxulOrgTreasury, useCapxulOrganizationPay, useCapxulOrganizationPayBatch, useCapxulOrgs, useCapxulPay, useCapxulPayment, useCapxulPayments, useCapxulPermission, useCapxulPermissionAssign, useCapxulPermissionChange, useCapxulPermissionCreate, useCapxulPermissionReplace, useCapxulPermissionRevoke, useCapxulPermissions, useCapxulProfile, useCapxulRedirectPayment, useCapxulSend, useCapxulTransitions, useCapxulUsernameAvailability };
+//#region src/headless/contacts/use-contacts.ts
+function useContacts(input) {
+	const { actor, onAdded, onFailed } = input;
+	const client = useCapxulClientOrNull();
+	const queryClient = useQueryClient();
+	const orgId = actor.kind === "organization" ? actor.orgId : void 0;
+	const scope = actor.kind === "personal" ? "personal" : orgId ?? "pending";
+	const refusal = actor.kind === "organization" && orgId === void 0 ? "org-unavailable" : null;
+	const book = useMemo(() => addressBookOf(client, actor.kind, orgId), [
+		client,
+		actor.kind,
+		orgId
+	]);
+	const invalidate = useCallback(() => queryClient.invalidateQueries({ queryKey: capxulKeys.contacts(scope) }), [queryClient, scope]);
+	const writeMutate = useMutation({
+		mutationFn: async (command) => {
+			const target = requireBook(book, `addressBook.${command.kind}`);
+			return unwrapCapxulResult(command.kind === "rename" ? await target.label({
+				entryId: command.id,
+				label: command.name
+			}) : command.kind === "hide" ? await target.hide(command.id) : await target.unhide(command.id));
+		},
+		onSettled: invalidate,
+		onError: onFailed
+	}).mutate;
+	const [value, setValue] = useState("");
+	const [addError, setAddError] = useState(null);
+	const addContact = useMutation({
+		mutationFn: async (ref) => unwrapCapxulResult(await requireBook(book, "addressBook.add").add({ ref })),
+		onSettled: invalidate
+	});
+	const addMutate = addContact.mutate;
+	const blockedReason = refusal !== null ? "org-unavailable" : value.trim() === "" ? "empty" : null;
+	const submitGate = useRef(false);
+	const submit = useCallback(() => {
+		if (blockedReason !== null || submitGate.current) return;
+		submitGate.current = true;
+		setAddError(null);
+		addMutate(refFromTypedText(value), {
+			onSuccess: (entry) => {
+				setValue("");
+				onAdded(toContact(entry));
+			},
+			onError: (error) => {
+				setAddError(error.code === "INVALID_INPUT" ? "unresolved" : "failed");
+				onFailed(error);
+			},
+			onSettled: () => {
+				submitGate.current = false;
+			}
+		});
+	}, [
+		addMutate,
+		blockedReason,
+		onAdded,
+		onFailed,
+		value
+	]);
+	const change = useCallback((text) => {
+		setValue(text);
+		setAddError(null);
+	}, []);
+	return {
+		book,
+		scope,
+		refusal,
+		rename: useCallback((id, name) => writeMutate({
+			kind: "rename",
+			id,
+			name
+		}), [writeMutate]),
+		hide: useCallback((id) => writeMutate({
+			kind: "hide",
+			id
+		}), [writeMutate]),
+		unhide: useCallback((id) => writeMutate({
+			kind: "unhide",
+			id
+		}), [writeMutate]),
+		add: {
+			value,
+			change,
+			submit,
+			isSubmitting: addContact.isPending,
+			blocked: blockedReason !== null,
+			blockedReason,
+			error: addError
+		}
+	};
+}
+/**
+* The read every part stands on. Two placements with the same `show` share one
+* query key, so React Query issues ONE request for them.
+*/
+function useContactsList(engine, options) {
+	const includeHidden = options.show === "all";
+	const { book, refusal } = engine;
+	const query = useQuery({
+		queryKey: capxulKeys.contactsList(engine.scope, includeHidden),
+		queryFn: async () => unwrapCapxulResult(await requireBook(book, "addressBook.list").list({ includeHidden })),
+		enabled: book !== null
+	});
+	const reason = refusal ?? (query.isError ? "unavailable" : query.data === void 0 ? "loading" : null);
+	const entries = query.data;
+	const { limit } = options;
+	const { rename, hide, unhide } = engine;
+	return {
+		rows: useMemo(() => {
+			if (entries === void 0) return [];
+			return (limit === void 0 ? entries : entries.slice(0, limit)).map((entry) => Object.assign(toContact(entry), {
+				initials: initialsOf(entry.label),
+				rename: (name) => rename(entry.id, name),
+				hide: () => hide(entry.id),
+				unhide: () => unhide(entry.id)
+			}));
+		}, [
+			entries,
+			hide,
+			limit,
+			rename,
+			unhide
+		]),
+		isLoading: reason === "loading",
+		reason
+	};
+}
+/** Counts over the same visible read `.List` uses — one request, two parts. */
+function useContactsSummary(engine) {
+	const { rows, isLoading, reason } = useContactsList(engine, {});
+	const settled = reason === null;
+	return {
+		total: settled ? rows.length : null,
+		activeCount: settled ? rows.filter((row) => row.relationship.includes("paid")).length : null,
+		isLoading,
+		reason
+	};
+}
+function addressBookOf(client, kind, orgId) {
+	if (client === null) return null;
+	if (kind === "personal") return client.account.addressBook;
+	return orgId === void 0 ? null : client.org(orgId).addressBook;
+}
+function requireBook(book, method) {
+	if (book === null) throw Errors.wrongState({
+		method,
+		currentState: "bootstrapping",
+		validStates: ["ready"]
+	});
+	return book;
+}
+function toContact(entry) {
+	return {
+		id: entry.id,
+		name: entry.label,
+		relationship: entry.relationship,
+		hidden: entry.hidden,
+		lastActivityAt: entry.lastActivityAt
+	};
+}
+/**
+* One typed field, both shapes. A leading `@` names a handle; an `@` anywhere
+* else names an email — what the app already builds for Quick Pay, and what the
+* backend resolver already accepts.
+*/
+function refFromTypedText(text) {
+	const trimmed = text.trim();
+	return trimmed.includes("@") && !trimmed.startsWith("@") ? {
+		kind: "email",
+		email: trimmed
+	} : {
+		kind: "handle",
+		handle: trimmed.replace(/^@/, "")
+	};
+}
+/** First letters of the first two words, uppercased. */
+function initialsOf(name) {
+	return name.trim().split(/\s+/).slice(0, 2).map((word) => word.charAt(0).toUpperCase()).join("");
+}
+//#endregion
+//#region src/headless/contacts/contacts.tsx
+const ContactsContext = createContext(null);
+function useContactsContext() {
+	const engine = useContext(ContactsContext);
+	if (engine === null) throw new Error("CapxulContacts parts must be used inside <CapxulContacts>");
+	return engine;
+}
+function Root$1({ actor, onAdded, onFailed, children }) {
+	const engine = useContacts({
+		actor,
+		onAdded,
+		onFailed
+	});
+	return /* @__PURE__ */ jsx(ContactsContext.Provider, {
+		value: engine,
+		children
+	});
+}
+function Summary({ children }) {
+	return /* @__PURE__ */ jsx(Fragment, { children: children(useContactsSummary(useContactsContext())) });
+}
+function List({ limit, show, children }) {
+	return /* @__PURE__ */ jsx(Fragment, { children: children(useContactsList(useContactsContext(), {
+		limit,
+		show
+	})) });
+}
+function Add({ children }) {
+	return /* @__PURE__ */ jsx(Fragment, { children: children(useContactsContext().add) });
+}
+/** The compound shape the app's own design system already uses (`StatusTabs`). */
+const CapxulContacts = Object.assign(Root$1, {
+	Summary,
+	List,
+	Add
+});
+//#endregion
+//#region src/headless/send-money/signer-status.ts
+const NO_SUBSCRIPTION = () => () => {};
+function useSignerStatus(client) {
+	const signer = client?.signer;
+	return useSyncExternalStore(useMemo(() => signer === void 0 ? NO_SUBSCRIPTION : (listener) => signer.subscribe(listener), [signer]), () => signer === void 0 ? "unknown" : signer.status(), () => "unknown");
+}
+//#endregion
+//#region src/headless/send-money/use-recipient-resolution.ts
+function toTargetReference(method, text) {
+	const trimmed = text.trim();
+	if (trimmed === "") return null;
+	return method === "username" ? {
+		kind: "handle",
+		handle: trimmed.replace(/^@/, "")
+	} : {
+		kind: "email",
+		email: trimmed
+	};
+}
+/** How long the engine waits after the last keystroke before resolving. */
+const RESOLVE_DEBOUNCE_MS = 400;
+function useRecipientResolution(client) {
+	const [method, setMethodState] = useState("email-address");
+	const [text, setText] = useState("");
+	const reference = useMemo(() => toTargetReference(method, text), [method, text]);
+	const debouncedReference = useDebouncedValue(reference, RESOLVE_DEBOUNCE_MS);
+	const [outcome, setOutcome] = useState(null);
+	useEffect(() => {
+		if (debouncedReference === null || client === null) {
+			setOutcome(null);
+			return;
+		}
+		const controller = new AbortController();
+		setOutcome({
+			reference: debouncedReference,
+			status: "checking",
+			target: null
+		});
+		client.targets.resolve(debouncedReference, { signal: controller.signal }).then((result) => {
+			if (controller.signal.aborted) return;
+			setOutcome(result.ok ? {
+				reference: debouncedReference,
+				status: "found",
+				target: result.value
+			} : {
+				reference: debouncedReference,
+				status: result.error.code === "INVALID_INPUT" ? "not-found" : "failed",
+				target: null
+			});
+		});
+		return () => controller.abort();
+	}, [client, debouncedReference]);
+	const setMethod = useCallback((next) => {
+		setMethodState(next);
+		setText("");
+	}, []);
+	const settled = outcome !== null && outcome.reference === debouncedReference ? outcome : null;
+	const status = reference === null ? "empty" : reference !== debouncedReference || settled === null ? "checking" : settled.status;
+	const resolvedTarget = status === "found" ? settled?.target ?? null : null;
+	return {
+		slice: {
+			method,
+			setMethod,
+			value: text,
+			change: setText,
+			status,
+			label: resolvedTarget?.label ?? null
+		},
+		resolvedTarget,
+		trimmed: text.trim()
+	};
+}
+//#endregion
+//#region src/headless/send-money/use-send-money.ts
+function useSendMoney(input) {
+	const { actor, onSent, onFailed } = input;
+	const client = useCapxulClientOrNull();
+	const signerStatus = useSignerStatus(client);
+	const balance = useCapxulAccountBalance({ enabled: actor.kind === "personal" });
+	const account = actor.kind === "personal" ? balance.data ?? null : null;
+	const assetOptions = useMemo(() => account === null ? [] : [{
+		id: account.id,
+		symbol: account.available.currency,
+		availableDisplay: formatMoney(account.available, { grammar: "code" })
+	}], [account]);
+	const [selectedAssetId, setSelectedAssetId] = useState(null);
+	useEffect(() => {
+		if (!assetOptions.some((option) => option.id === selectedAssetId)) setSelectedAssetId(assetOptions[0]?.id ?? null);
+	}, [assetOptions, selectedAssetId]);
+	const selectedAssetOption = assetOptions.find((option) => option.id === selectedAssetId) ?? null;
+	const selectedAssetMoney = selectedAssetOption !== null && account !== null ? account.available : null;
+	const selectAsset = useCallback((id) => {
+		setSelectedAssetId((current) => assetOptions.some((option) => option.id === id) ? id : current);
+	}, [assetOptions]);
+	const [amountText, setAmountText] = useState("");
+	const parsed = useMemo(() => selectedAssetMoney === null || amountText.trim() === "" ? null : parseMoney(amountText, selectedAssetMoney), [amountText, selectedAssetMoney]);
+	const parsedMoney = parsed !== null && !isMoneyParseError(parsed) ? parsed : null;
+	const amountError = parsed !== null && isMoneyParseError(parsed) ? parsed.reason : null;
+	const recipient = useRecipientResolution(client);
+	const resolvedTarget = recipient.resolvedTarget;
+	const pay = useCapxulPay();
+	const blockedReason = signerStatus !== "ready" ? "signer-not-ready" : actor.kind === "organization" ? "no-source" : selectedAssetOption === null ? "no-asset" : parsedMoney === null ? "amount-invalid" : resolvedTarget === null ? "recipient-unresolved" : null;
+	const submitGate = useRef(false);
+	const submit = useCallback(() => {
+		if (blockedReason !== null || submitGate.current) return;
+		if (parsedMoney === null || resolvedTarget === null) return;
+		submitGate.current = true;
+		const amount = parsedMoney;
+		const sentRecipient = recipient.trimmed;
+		pay.mutate({
+			to: resolvedTarget.reference,
+			amount
+		}, {
+			onSuccess: (payment) => onSent({
+				payment,
+				amount,
+				recipient: sentRecipient
+			}),
+			onError: (error) => onFailed(error),
+			onSettled: () => {
+				submitGate.current = false;
+			}
+		});
+	}, [
+		blockedReason,
+		onFailed,
+		onSent,
+		parsedMoney,
+		pay,
+		recipient.trimmed,
+		resolvedTarget
+	]);
+	return {
+		asset: {
+			options: assetOptions,
+			selected: selectedAssetOption,
+			select: selectAsset,
+			error: actor.kind === "personal" && balance.error !== null ? "read-failed" : null
+		},
+		amount: {
+			value: amountText,
+			change: setAmountText,
+			error: amountError,
+			availableDisplay: selectedAssetOption?.availableDisplay ?? null
+		},
+		recipient: recipient.slice,
+		actions: {
+			submit,
+			isSubmitting: pay.isPending,
+			blocked: blockedReason !== null,
+			blockedReason
+		}
+	};
+}
+//#endregion
+//#region src/headless/send-money/send-money.tsx
+const SendMoneyContext = createContext(null);
+function useSendMoneyContext() {
+	const engine = useContext(SendMoneyContext);
+	if (engine === null) throw new Error("CapxulSendMoney parts must be used inside <CapxulSendMoney>");
+	return engine;
+}
+function Root({ actor, onSent, onFailed, children }) {
+	const engine = useSendMoney({
+		actor,
+		onSent,
+		onFailed
+	});
+	return /* @__PURE__ */ jsx(SendMoneyContext.Provider, {
+		value: engine,
+		children
+	});
+}
+function Asset({ children }) {
+	return /* @__PURE__ */ jsx(Fragment, { children: children(useSendMoneyContext().asset) });
+}
+function Amount({ children }) {
+	return /* @__PURE__ */ jsx(Fragment, { children: children(useSendMoneyContext().amount) });
+}
+function Recipient({ children }) {
+	return /* @__PURE__ */ jsx(Fragment, { children: children(useSendMoneyContext().recipient) });
+}
+function Actions({ children }) {
+	return /* @__PURE__ */ jsx(Fragment, { children: children(useSendMoneyContext().actions) });
+}
+/** The compound shape the app's own design system already uses (`StatusTabs`). */
+const CapxulSendMoney = Object.assign(Root, {
+	Asset,
+	Amount,
+	Recipient,
+	Actions
+});
+//#endregion
+export { CapxulAuthenticationController, CapxulContacts, CapxulOnboardingController, CapxulProvider, CapxulSendMoney, acknowledgeOnboardingDestination, activeOnboardingRecovery, clearOnboardingJourney, currentOnboardingJourneyId, entered, invalidateOnboardingJourneyObservation, loadOnboardingJourney, onboardingJourneyPosition, saveOnboardingJourney, startOnboardingJourney, useCapxul, useCapxulAccountBalance, useCapxulAccountFund, useCapxulActivity, useCapxulActivityDetail, useCapxulAnnotateMovement, useCapxulAuth, useCapxulCancelPayment, useCapxulClaimPayment, useCapxulClientOrNull, useCapxulCreateCommitment, useCapxulCreateOrg, useCapxulDestination, useCapxulHoldings, useCapxulIdentity, useCapxulImageUpload, useCapxulInviteMember, useCapxulOrgMembers, useCapxulOrgRoles, useCapxulOrgTreasury, useCapxulOrganizationPay, useCapxulOrganizationPayBatch, useCapxulOrgs, useCapxulPay, useCapxulPayment, useCapxulPayments, useCapxulPermission, useCapxulPermissionAssign, useCapxulPermissionChange, useCapxulPermissionCreate, useCapxulPermissionReplace, useCapxulPermissionRevoke, useCapxulPermissions, useCapxulProfile, useCapxulRedirectPayment, useCapxulSend, useCapxulTransitions, useCapxulUsernameAvailability };

package/dist/testing/index.mjs

@@ -1,4 +1,4 @@
-import { n as CapxulOnboardingController, r as CapxulProvider, t as CapxulAuthenticationController } from "../controllers-Chqyy3HR.mjs";
+import { n as CapxulOnboardingController, r as CapxulProvider, t as CapxulAuthenticationController } from "../controllers-ClhmseFL.mjs";
 import "react";
 import { jsx } from "react/jsx-runtime";
 import { createCapxulTestClient } from "@capxul/sdk/testing";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capxul/sdk-react",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Xelmar-tech/infrastructure.git",
@@ -26,7 +26,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@capxul/sdk": "2.1.0"
+    "@capxul/sdk": "2.2.0"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.66.9",