@capxul/sdk-react 3.2.0 → 4.0.0

package/dist/{controllers-BSDuWapk.mjs → controllers-BgkCs0nW.mjs}

@@ -40,11 +40,11 @@ function useCapxulClientOrNull() {
 const capxulKeys = {
 	root: ["capxul"],
 	profile: ["capxul", "profile"],
-	usernameAvailability: (username) => [
+	handleAvailability: (handle) => [
 		"capxul",
 		"profile",
-		"username-availability",
-		username
+		"handle-availability",
+		handle
 	],
 	account: ["capxul", "account"],
 	provisioning: ["capxul", "provisioning"],

package/dist/index.d.mts

@@ -220,7 +220,7 @@ type ProfileDraft = {
   readonly displayName: string;
   readonly country: string;
   readonly withdrawalAddress: string;
-  readonly username?: string;
+  readonly handle?: string;
   readonly payoutAddresses?: readonly PayoutDraftEntry[];
 };
 type OrganizationDraft = {
@@ -295,23 +295,23 @@ declare function acknowledgeOnboardingDestination(destination: {
 }, ownerId: string): boolean;
 declare function clearOnboardingJourney(): void;
 //#endregion
-//#region src/headless/onboarding/use-capxul-username-availability.d.ts
-type UsernameAvailability = {
+//#region src/headless/onboarding/use-capxul-handle-availability.d.ts
+type HandleAvailability = {
   readonly available: boolean;
   readonly normalized: string;
 };
-type UseCapxulUsernameAvailabilityReturn = UseQueryResult<UsernameAvailability, CapxulError>;
+type UseCapxulHandleAvailabilityReturn = UseQueryResult<HandleAvailability, CapxulError>;
 /**
- * #1062: debounced availability probe for the username the user is typing.
+ * #1062: debounced availability probe for the handle the user is typing.
  * Disabled until the candidate reaches the 3-character floor; a malformed or
  * reserved candidate surfaces as the query's error (INVALID_INPUT with the
- * boundary's message), not as `available: false` — only a username someone
+ * boundary's message), not as `available: false` — only a handle someone
  * else owns is "taken".
  */
-declare function useCapxulUsernameAvailability(username: string, options?: {
+declare function useCapxulHandleAvailability(handle: string, options?: {
   readonly enabled?: boolean;
   readonly debounceMs?: number;
-}): UseCapxulUsernameAvailabilityReturn;
+}): UseCapxulHandleAvailabilityReturn;
 //#endregion
 //#region src/headless/media/use-capxul-image-upload.d.ts
 type ImageUploadTarget = {
@@ -622,16 +622,17 @@ declare const CapxulActivity: typeof Root$5 & {
 };
 //#endregion
 //#region src/headless/send-money/use-recipient-resolution.d.ts
-type SendMoneyRecipientMethod = "username" | "email-address";
-type SendMoneyRecipientStatus = "empty" | "checking" | "found" | "not-found" | "failed";
+type SendMoneyRecipientStatus = "empty" | "invalid" | "checking" | "known-party" | "new-email" | "external-warning" | "external-ready" | "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;
+  readonly kind: "person" | "organization" | "external_address" | "unresolved" | null;
+  readonly isCapxulAccount: boolean | null;
+  readonly publicValue: string | null;
+  readonly requiresAcknowledgement: boolean;
+  readonly acknowledgeExternalAddress: () => void;
 }
 //#endregion
 //#region src/headless/send-money/use-send-money.d.ts
@@ -997,7 +998,7 @@ declare const CapxulPayrollRun: typeof Root & {
 declare const capxulKeys: {
   root: readonly ["capxul"];
   profile: readonly ["capxul", "profile"];
-  usernameAvailability: (username: string) => readonly ["capxul", "profile", "username-availability", string];
+  handleAvailability: (handle: string) => readonly ["capxul", "profile", "handle-availability", string];
   account: readonly ["capxul", "account"];
   provisioning: readonly ["capxul", "provisioning"];
   binding: readonly ["capxul", "binding"];
@@ -1023,4 +1024,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 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 SendMoneyRecipientMethod, 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 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, capxulKeys, clearOnboardingJourney, currentOnboardingJourneyId, entered, invalidateOnboardingJourneyObservation, isClaimed, isRestoring, 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 };
+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, 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 };

package/dist/index.mjs

@@ -1,8 +1,8 @@
 "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-BSDuWapk.mjs";
+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-BgkCs0nW.mjs";
 import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { useInfiniteQuery, useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
-import { CAPXUL_OPERATIONS, CapxulError, Errors, PAYMENT_DIRECTIONS, PAYMENT_STATUSES, fingerprintPaymentIntent, formatMoney, isCapxulError, isClaimed, isClaimed as isClaimed$1, isMoneyParseError, isRestoring, isRestoring as isRestoring$1, parseMoney, paymentPhase, resolveIdentityDestination } from "@capxul/sdk";
+import { CAPXUL_OPERATIONS, CapxulError, EVM_ADDRESS_RE, Errors, HANDLE_RE, PAYMENT_DIRECTIONS, PAYMENT_STATUSES, fingerprintPaymentIntent, formatMoney, isCapxulError, isClaimed, isClaimed as isClaimed$1, isMoneyParseError, isRestoring, isRestoring as isRestoring$1, parseMoney, paymentPhase, resolveIdentityDestination, toEvmAddress, toPartyId } from "@capxul/sdk";
 import { Fragment, jsx } from "react/jsx-runtime";
 //#region src/internal/require-bootstrapped-client.ts
 /**
@@ -38,7 +38,7 @@ function useCapxulProfile() {
 	const client = useCapxulClientOrNull();
 	const identity = useCapxulIdentityOrNull();
 	return useQuery({
-		queryKey: capxulKeys.profile,
+		queryKey: [...capxulKeys.profile, identity?.phase === "authenticated" ? identity.session.authUserId : null],
 		queryFn: async () => unwrapCapxulResult(await requireBootstrappedClient(client, CAPXUL_OPERATIONS.identity.loadCurrent).identity.loadCurrent()),
 		enabled: client !== null && identity?.phase === "authenticated"
 	});
@@ -733,10 +733,10 @@ function isProfileDraft(value) {
 		"displayName",
 		"country",
 		"withdrawalAddress",
-		"username",
+		"handle",
 		"payoutAddresses"
 	]) || !isDraftText(value.displayName) || !isDraftText(value.country) || !isDraftText(value.withdrawalAddress)) return false;
-	if (value.username !== void 0 && !isDraftText(value.username)) return false;
+	if (value.handle !== void 0 && !isDraftText(value.handle)) return false;
 	if (value.payoutAddresses !== void 0 && !isPayoutDraftList(value.payoutAddresses)) return false;
 	return true;
 }
@@ -790,21 +790,21 @@ function useDebouncedValue(value, delayMs) {
 	return debounced;
 }
 //#endregion
-//#region src/headless/onboarding/use-capxul-username-availability.ts
+//#region src/headless/onboarding/use-capxul-handle-availability.ts
 /**
-* #1062: debounced availability probe for the username the user is typing.
+* #1062: debounced availability probe for the handle the user is typing.
 * Disabled until the candidate reaches the 3-character floor; a malformed or
 * reserved candidate surfaces as the query's error (INVALID_INPUT with the
-* boundary's message), not as `available: false` — only a username someone
+* boundary's message), not as `available: false` — only a handle someone
 * else owns is "taken".
 */
-function useCapxulUsernameAvailability(username, options) {
+function useCapxulHandleAvailability(handle, options) {
 	const client = useCapxulClientOrNull();
-	const candidate = useDebouncedValue(username.trim(), options?.debounceMs ?? 300);
+	const candidate = useDebouncedValue(handle.trim(), options?.debounceMs ?? 300);
 	return useQuery({
-		queryKey: capxulKeys.usernameAvailability(candidate),
+		queryKey: capxulKeys.handleAvailability(candidate),
 		queryFn: async () => {
-			return unwrapCapxulResult(await requireBootstrappedClient(client, CAPXUL_OPERATIONS.identity.usernameAvailable).identity.usernameAvailable(candidate));
+			return unwrapCapxulResult(await requireBootstrappedClient(client, CAPXUL_OPERATIONS.identity.handleAvailable).identity.handleAvailable(candidate));
 		},
 		enabled: client !== null && candidate.length >= 3 && (options?.enabled ?? true)
 	});
@@ -1329,7 +1329,7 @@ function useActivitySummary(actor, window) {
 //#region src/headless/activity/rows.ts
 /**
 * A Movement's phase is DERIVED, not asserted: `movementItems` returns `null`
-* for any Movement whose `canonicalState` is not `"finalized"`
+* for any Movement whose `canonicalState` is not `"included"`
 * (`activityList.ts:120`), so a Movement that reaches a page is finished and
 * carries no verdict of its own.
 */
@@ -1753,67 +1753,126 @@ function useSignerStatus(client) {
 }
 //#endregion
 //#region src/headless/send-money/use-recipient-resolution.ts
-function toTargetReference(method, text) {
+const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+const PARTY_ID_RE = /^party_[0-9A-Za-z]+$/;
+const RESOLVE_DEBOUNCE_MS = 400;
+function parseRecipient(text) {
 	const trimmed = text.trim();
-	if (trimmed === "") return null;
-	return method === "username" ? {
-		kind: "handle",
-		handle: trimmed.replace(/^@/, "")
-	} : {
-		kind: "email",
-		email: trimmed
+	if (trimmed === "") return { status: "empty" };
+	if (PARTY_ID_RE.test(trimmed)) return {
+		status: "valid",
+		reference: {
+			kind: "party",
+			partyId: toPartyId(trimmed)
+		}
 	};
+	if (EVM_ADDRESS_RE.test(trimmed)) return {
+		status: "valid",
+		reference: {
+			kind: "address",
+			address: toEvmAddress(trimmed)
+		}
+	};
+	if (EMAIL_RE.test(trimmed)) return {
+		status: "valid",
+		reference: {
+			kind: "email",
+			email: trimmed.toLowerCase()
+		}
+	};
+	const handle = trimmed.replace(/^@/, "").toLowerCase();
+	if (HANDLE_RE.test(handle)) return {
+		status: "valid",
+		reference: {
+			kind: "handle",
+			handle
+		}
+	};
+	return { status: "invalid" };
 }
-/** 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");
+function sameReference(left, right) {
+	return JSON.stringify(left) === JSON.stringify(right);
+}
+function publicRecipientValue(value) {
+	if (value === null) return null;
+	if (value.status === "known_party") return value.handle ?? value.label;
+	return value.status === "external_address" ? value.safeAddress : null;
+}
+function recipientStatus(parsed, settled, acknowledged) {
+	if (parsed.status === "empty" || parsed.status === "invalid") return parsed.status;
+	if (settled === null) return "checking";
+	if (!settled.ok) return settled.error.code === "INVALID_INPUT" ? "not-found" : "failed";
+	if (settled.value.status === "known_party") return "known-party";
+	if (settled.value.status === "new_email") return "new-email";
+	return acknowledged ? "external-ready" : "external-warning";
+}
+function useRecipientResolution(client, scope, organizationId) {
 	const [text, setText] = useState("");
-	const reference = useMemo(() => toTargetReference(method, text), [method, text]);
+	const parsed = useMemo(() => parseRecipient(text), [text]);
+	const reference = parsed.status === "valid" ? parsed.reference : null;
 	const debouncedReference = useDebouncedValue(reference, RESOLVE_DEBOUNCE_MS);
+	const debouncedText = useDebouncedValue(text, RESOLVE_DEBOUNCE_MS);
 	const [outcome, setOutcome] = useState(null);
+	const [acknowledgedOutcome, setAcknowledgedOutcome] = useState(null);
+	const capturedAcknowledgement = useRef(null);
+	const change = useCallback((next) => {
+		if (next === text) return;
+		setAcknowledgedOutcome(null);
+		setOutcome(null);
+		setText(next);
+	}, [text]);
 	useEffect(() => {
 		if (debouncedReference === null || client === null) {
 			setOutcome(null);
 			return;
 		}
 		const controller = new AbortController();
-		setOutcome({
-			reference: debouncedReference,
-			status: "checking",
-			label: null
-		});
+		setOutcome(null);
 		client.targets.resolve(debouncedReference, { signal: controller.signal }).then((result) => {
-			if (controller.signal.aborted) return;
-			setOutcome(result.ok ? {
-				reference: debouncedReference,
-				status: "found",
-				label: result.value.label
-			} : {
-				reference: debouncedReference,
-				status: result.error.code === "INVALID_INPUT" ? "not-found" : "failed",
-				label: null
+			if (!controller.signal.aborted) setOutcome({
+				client,
+				scope,
+				text: debouncedText,
+				input: debouncedReference,
+				result
 			});
 		});
 		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 resolvedReference = status === "found" ? settled?.reference ?? null : null;
+	}, [
+		client,
+		scope,
+		debouncedReference,
+		debouncedText
+	]);
+	const settled = reference !== null && debouncedReference !== null && outcome !== null && outcome.client === client && outcome.scope === scope && outcome.text === text && sameReference(reference, debouncedReference) && sameReference(outcome.input, debouncedReference) ? outcome.result : null;
+	const status = recipientStatus(parsed, settled, acknowledgedOutcome === outcome);
+	const ready = settled?.ok === true && (settled.value.status !== "external_address" || status === "external-ready");
+	const value = settled?.ok === true ? settled.value : null;
+	const acknowledgeExternalAddress = useCallback(() => {
+		if (value?.status !== "external_address" || outcome === null) return;
+		setAcknowledgedOutcome(outcome);
+		if (capturedAcknowledgement.current === outcome) return;
+		capturedAcknowledgement.current = outcome;
+		client?._internal.captureExternalAddressAcknowledged(value.safeAddress, organizationId);
+	}, [
+		client,
+		organizationId,
+		value,
+		outcome
+	]);
 	return {
 		slice: {
-			method,
-			setMethod,
 			value: text,
-			change: setText,
+			change,
 			status,
-			label: status === "found" ? settled?.label ?? null : null
+			label: value?.label ?? null,
+			kind: value?.kind ?? null,
+			isCapxulAccount: value?.isCapxulAccount ?? null,
+			publicValue: publicRecipientValue(value),
+			requiresAcknowledgement: status === "external-warning",
+			acknowledgeExternalAddress
 		},
-		resolvedReference,
+		resolvedReference: ready && value !== null ? value.reference : null,
 		trimmed: text.trim()
 	};
 }
@@ -1858,7 +1917,11 @@ function useSendMoney(input) {
 	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 recipient = useRecipientResolution(client, JSON.stringify([
+		actor.kind,
+		orgId,
+		account?.id
+	]), orgId);
 	const resolvedReference = recipient.resolvedReference;
 	const personalPay = useCapxulPay();
 	const organizationPay = useCapxulOrganizationPay(orgId);
@@ -1870,6 +1933,7 @@ function useSendMoney(input) {
 		if (parsedMoney === null || resolvedReference === null) return;
 		const amount = parsedMoney;
 		const sentRecipient = recipient.trimmed;
+		const externalAddressAcknowledged = recipient.slice.status === "external-ready";
 		const callbacks = {
 			onSuccess: (payment) => onSent({
 				payment,
@@ -1885,7 +1949,8 @@ function useSendMoney(input) {
 			submitGate.current = true;
 			personalPay.mutate({
 				to: resolvedReference,
-				amount
+				amount,
+				...externalAddressAcknowledged ? { externalAddressAcknowledged: true } : {}
 			}, callbacks);
 			return;
 		}
@@ -1894,7 +1959,8 @@ function useSendMoney(input) {
 		organizationPay.mutate({
 			permissionId: selectedSource.id,
 			to: resolvedReference,
-			amount
+			amount,
+			...externalAddressAcknowledged ? { externalAddressAcknowledged: true } : {}
 		}, callbacks);
 	}, [
 		actor.kind,
@@ -1905,6 +1971,7 @@ function useSendMoney(input) {
 		parsedMoney,
 		personalPay,
 		recipient.trimmed,
+		recipient.slice.status,
 		resolvedReference,
 		selectedSource
 	]);
@@ -2968,4 +3035,4 @@ const CapxulPayrollRun = Object.assign(Root, {
 	Actions
 });
 //#endregion
-export { CapxulActivity, CapxulAuthenticationController, CapxulContacts, CapxulDashboardAccess, CapxulOnboardingController, CapxulOrgMember, CapxulPayroll, CapxulPayrollRun, CapxulProvider, CapxulSendMoney, 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, 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 };
+export { CapxulActivity, CapxulAuthenticationController, CapxulContacts, CapxulDashboardAccess, CapxulOnboardingController, CapxulOrgMember, CapxulPayroll, CapxulPayrollRun, CapxulProvider, CapxulSendMoney, 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 };

package/dist/testing/index.mjs

@@ -1,4 +1,4 @@
-import { n as CapxulOnboardingController, r as CapxulProvider, t as CapxulAuthenticationController } from "../controllers-BSDuWapk.mjs";
+import { n as CapxulOnboardingController, r as CapxulProvider, t as CapxulAuthenticationController } from "../controllers-BgkCs0nW.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": "3.2.0",
+  "version": "4.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Xelmar-tech/infrastructure.git",
@@ -26,7 +26,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@capxul/sdk": "3.2.0"
+    "@capxul/sdk": "4.0.0"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.66.9",
@@ -43,8 +43,8 @@
     "vite": "npm:@voidzero-dev/vite-plus-core@0.3.0",
     "vite-plus": "0.3.0",
     "vitest": "4.1.11",
-    "@capxul/errors": "0.2.0",
-    "@capxul/types": "0.2.3",
+    "@capxul/errors": "0.3.0",
+    "@capxul/types": "0.3.0",
     "@capxul/typescript-config": "0.0.0"
   },
   "peerDependencies": {