@capxul/sdk-react 1.0.0-alpha.21 → 1.0.0-alpha.22

package/dist/index.mjs

@@ -355,6 +355,7 @@ function actorKey(actor) {
 }
 function targetKey(target) {
 	if (target === void 0) return "all";
+	if ("self" in target) return "self";
 	switch (target.kind) {
 		case "handle": return `handle:${target.handle}`;
 		case "email": return `email:${target.email}`;
@@ -396,6 +397,12 @@ const capxulKeys = {
 	root: ["capxul"],
 	session: ["capxul", "session"],
 	profile: ["capxul", "profile"],
+	usernameAvailability: (username) => [
+		"capxul",
+		"profile",
+		"username-availability",
+		username
+	],
 	account: ["capxul", "account"],
 	accountLifecycle: ["capxul", "accountLifecycle"],
 	provisioning: ["capxul", "provisioning"],
@@ -1796,6 +1803,333 @@ function Destinations({ input, slots }) {
 	return slots.root?.({ children }) ?? children;
 }
 //#endregion
-export { AddressBook, CapxulProvider, Destinations, InsightsSummary, PayrollRoster, RequestInbox, SendMoney, capxulAccountScope, capxulOrgScope, useCapxul, useCapxulAccountBalance, useCapxulAccountFund, useCapxulAccountLifecycle, useCapxulActivity, useCapxulAddAddressBookEntry, useCapxulAddDestination, useCapxulAddPayrollRosterLine, useCapxulAddressBook, useCapxulAddressBookEntry, useCapxulApproveInboxRequest, useCapxulAssignRole, useCapxulCancelPayment, useCapxulCancelRequest, useCapxulClientOrNull, useCapxulCompleteOrganizationOnboarding, useCapxulCompletePersonalOnboarding, useCapxulCreateOrg, useCapxulCurrentUser, useCapxulDeclineInboxRequest, useCapxulDestinations, useCapxulHideAddressBookEntry, useCapxulInbox, useCapxulInsightsHistory, useCapxulInsightsSummary, useCapxulInviteMember, useCapxulIssueRequest, useCapxulLabelAddressBookEntry, useCapxulOfframpQuote, useCapxulOfframpStatus, useCapxulOrg, useCapxulOrgDeployRoles, useCapxulOrgLifecycle, useCapxulOrgMembers, useCapxulOrgRoles, useCapxulOrgTreasury, useCapxulOrganizationAccount, useCapxulOrganizationAuditLog, useCapxulOrgs, useCapxulPay, useCapxulPayment, useCapxulPayments, useCapxulPayout, useCapxulPayrollRoster, useCapxulProfile, useCapxulReconcileRequests, useCapxulRemoveDestination, useCapxulRemoveMember, useCapxulRemovePayrollRosterLine, useCapxulRequest, useCapxulRequests, useCapxulRunPayroll, useCapxulSession, useCapxulSignIn, useCapxulSignOut, useCapxulSubAccountCreate, useCapxulSubAccountDelete, useCapxulSubAccountRename, useCapxulSubAccountsList, useCapxulSwitchActingEntity, useCapxulTransfer, useCapxulUnhideAddressBookEntry, useCapxulUpdatePayrollRosterLine, useCapxulVerifyOtp, useCapxulWithdraw };
+//#region src/headless/journey/journey-state.ts
+const JOURNEY_KEY = "capxul.onboarding.journey.v1";
+const VALIDATED_OWNER_KEY = "capxul.onboarding.validated-owner.v1";
+const JOURNEY_VERSION = 1;
+const MAX_DRAFT_TEXT_LENGTH = 200;
+const MAX_ID_LENGTH = 160;
+const MAX_STORED_JOURNEY_LENGTH = 8192;
+const MAX_PAYOUT_DRAFT_ENTRIES = 10;
+/**
+* The owner whose stored journey may currently be attributed to observations.
+* Persisted in sessionStorage rather than module memory so `currentOnboarding-
+* JourneyId` is a pure function of durable state — attribution is the same
+* regardless of the order of renders, reloads, or telemetry emits. Established
+* only when an authenticated owner is (journey start, or an owner-matched load)
+* and cleared at every auth boundary or on discard.
+*/
+function markOnboardingOwnerValidated(ownerId) {
+	try {
+		sessionStorage.setItem(VALIDATED_OWNER_KEY, ownerId);
+	} catch {}
+}
+function clearValidatedOnboardingOwner() {
+	try {
+		sessionStorage.removeItem(VALIDATED_OWNER_KEY);
+	} catch {}
+}
+function validatedOnboardingOwner() {
+	try {
+		return sessionStorage.getItem(VALIDATED_OWNER_KEY);
+	} catch {
+		return null;
+	}
+}
+function startOnboardingJourney(input) {
+	const journey = {
+		version: JOURNEY_VERSION,
+		ownerId: input.ownerId,
+		journeyId: `journey_${createRandomId()}`,
+		intent: input.intent,
+		entryPoint: input.entryPoint,
+		step: input.step ?? "profile",
+		...input.origin === void 0 ? {} : { origin: input.origin }
+	};
+	markOnboardingOwnerValidated(journey.ownerId);
+	saveOnboardingJourney(journey);
+	return journey;
+}
+function loadOnboardingJourney(expectedOwnerId) {
+	try {
+		const raw = sessionStorage.getItem(JOURNEY_KEY);
+		if (raw === null) return null;
+		if (raw.length > MAX_STORED_JOURNEY_LENGTH) return discardInvalidJourney();
+		const value = JSON.parse(raw);
+		if (!isValidJourney(value)) return discardInvalidJourney();
+		if (expectedOwnerId !== void 0 && value.ownerId !== expectedOwnerId) return discardInvalidJourney();
+		if (expectedOwnerId !== void 0) markOnboardingOwnerValidated(expectedOwnerId);
+		return value;
+	} catch {
+		return discardInvalidJourney();
+	}
+}
+function saveOnboardingJourney(journey) {
+	if (!isValidJourney(journey)) {
+		discardInvalidJourney();
+		return;
+	}
+	try {
+		sessionStorage.setItem(JOURNEY_KEY, JSON.stringify(journey));
+	} catch {}
+}
+function currentOnboardingJourneyId() {
+	const journey = loadOnboardingJourney();
+	const owner = validatedOnboardingOwner();
+	return journey !== null && owner !== null && journey.ownerId === owner ? journey.journeyId : void 0;
+}
+/** Stop observation attribution while no authenticated owner is established. */
+function invalidateOnboardingJourneyObservation() {
+	clearValidatedOnboardingOwner();
+}
+/** Where the journey stands — the pure position apps map to their routes. */
+function onboardingJourneyPosition(journey) {
+	const proof = journey.origin?.kind === "proof";
+	if (journey.organizationId !== void 0) return {
+		intent: journey.intent,
+		step: "provisioning",
+		organizationId: journey.organizationId,
+		proof
+	};
+	return {
+		intent: journey.intent,
+		step: journey.step,
+		proof
+	};
+}
+/**
+* The interruption-recovery decision (behavior map §4): a journey that does
+* not match the ready destination the app just rendered must resume; a
+* matching one needs no recovery. Returns the journey to resume, or null.
+*/
+function activeOnboardingRecovery(ownerId, renderedReadyDestination) {
+	const journey = loadOnboardingJourney(ownerId);
+	if (journey === null) return null;
+	return (renderedReadyDestination?.kind === "personal" ? journey.intent === "personal" && journey.step === "provisioning" && journey.organizationId === void 0 : renderedReadyDestination?.kind === "organization" && journey.intent === "organization" && journey.step === "provisioning" && journey.organizationId === renderedReadyDestination.organizationId) ? null : journey;
+}
+function acknowledgeOnboardingDestination(destination, ownerId) {
+	const journey = loadOnboardingJourney(ownerId);
+	if (journey === null) return false;
+	if (!(destination.kind === "personal" ? journey.intent === "personal" && journey.step === "provisioning" : journey.intent === "organization" && journey.step === "provisioning" && journey.organizationId === destination.organizationId)) return false;
+	clearOnboardingJourney();
+	return true;
+}
+function clearOnboardingJourney() {
+	clearValidatedOnboardingOwner();
+	try {
+		sessionStorage.removeItem(JOURNEY_KEY);
+	} catch {}
+}
+function isValidJourney(value) {
+	if (!isRecord(value) || value.version !== JOURNEY_VERSION) return false;
+	if (!hasOnlyKeys(value, [
+		"version",
+		"ownerId",
+		"journeyId",
+		"intent",
+		"entryPoint",
+		"origin",
+		"step",
+		"profile",
+		"organization",
+		"stableHandle",
+		"organizationId"
+	])) return false;
+	if (!isBoundedId(value.ownerId)) return false;
+	if (!isBoundedId(value.journeyId) || !value.journeyId.startsWith("journey_")) return false;
+	if (value.intent !== "personal" && value.intent !== "organization") return false;
+	if (value.entryPoint !== "signup" && value.entryPoint !== "dashboard") return false;
+	if (value.step !== "profile" && value.step !== "organization" && value.step !== "provisioning") return false;
+	if (value.origin !== void 0 && !isOrigin(value.origin)) return false;
+	if (value.profile !== void 0 && !isProfileDraft(value.profile)) return false;
+	if (value.organization !== void 0 && !isOrganizationDraft(value.organization)) return false;
+	if (value.stableHandle !== void 0 && !isDraftText(value.stableHandle)) return false;
+	if (value.organizationId !== void 0 && !isBoundedId(value.organizationId)) return false;
+	if (value.organization !== void 0 && value.stableHandle !== value.organization.handle) return false;
+	if (value.stableHandle !== void 0 && value.organization === void 0) return false;
+	if (value.intent === "personal" && (value.step === "organization" || value.organization !== void 0 || value.stableHandle !== void 0)) return false;
+	if (value.step === "organization" && value.intent !== "organization") return false;
+	if (value.organizationId !== void 0 && value.intent !== "organization") return false;
+	if (value.organizationId !== void 0 && value.step !== "provisioning") return false;
+	return true;
+}
+function isOrigin(value) {
+	if (!isRecord(value)) return false;
+	if (value.kind === "personal") return hasOnlyKeys(value, ["kind"]);
+	if (value.kind === "organization") return hasOnlyKeys(value, ["kind", "organizationId"]) && isBoundedId(value.organizationId);
+	return value.kind === "proof" && hasOnlyKeys(value, ["kind", "organizationId"]) && (value.organizationId === void 0 || isBoundedId(value.organizationId));
+}
+function isProfileDraft(value) {
+	if (!isRecord(value) || !hasOnlyKeys(value, [
+		"displayName",
+		"country",
+		"withdrawalAddress",
+		"username",
+		"payoutAddresses"
+	]) || !isDraftText(value.displayName) || !isDraftText(value.country) || !isDraftText(value.withdrawalAddress)) return false;
+	if (value.username !== void 0 && !isDraftText(value.username)) return false;
+	if (value.payoutAddresses !== void 0 && !isPayoutDraftList(value.payoutAddresses)) return false;
+	return true;
+}
+function isPayoutDraftList(value) {
+	return Array.isArray(value) && value.length <= MAX_PAYOUT_DRAFT_ENTRIES && value.every((entry) => isRecord(entry) && hasOnlyKeys(entry, ["chain", "address"]) && (entry.chain === "evm" || entry.chain === "solana" || entry.chain === "starknet") && isDraftText(entry.address));
+}
+function isOrganizationDraft(value) {
+	if (!isRecord(value) || !hasOnlyKeys(value, [
+		"name",
+		"handle",
+		"country",
+		"bio",
+		"size"
+	]) || !isDraftText(value.name) || !isDraftText(value.handle) || !isDraftText(value.country)) return false;
+	if (value.bio !== void 0 && !isDraftText(value.bio)) return false;
+	if (value.size !== void 0 && !isDraftText(value.size)) return false;
+	return true;
+}
+function isDraftText(value) {
+	return typeof value === "string" && value.length <= MAX_DRAFT_TEXT_LENGTH;
+}
+function isBoundedId(value) {
+	return typeof value === "string" && value.length > 0 && value.length <= MAX_ID_LENGTH;
+}
+function discardInvalidJourney() {
+	clearValidatedOnboardingOwner();
+	try {
+		sessionStorage.removeItem(JOURNEY_KEY);
+	} catch {}
+	return null;
+}
+function createRandomId() {
+	if (typeof globalThis.crypto?.randomUUID === "function") return globalThis.crypto.randomUUID();
+	return Math.random().toString(36).slice(2);
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function hasOnlyKeys(value, allowed) {
+	return Object.keys(value).every((key) => allowed.includes(key));
+}
+//#endregion
+//#region src/headless/routing/resolve-post-auth-destination.ts
+function resolvePostAuthDestination(inputs) {
+	if (inputs.journey !== null) return {
+		kind: "journey",
+		position: onboardingJourneyPosition(inputs.journey)
+	};
+	if (!inputs.profileOnboarded) return { kind: "selectUserType" };
+	if (!inputs.accountReady) return { kind: "provisioning" };
+	return {
+		kind: "dashboard",
+		entity: inputs.lastActingEntity ?? { kind: "personal" }
+	};
+}
+//#endregion
+//#region src/internal/use-debounced-value.ts
+/** The value as of `delayMs` after its last change (initial value immediate). */
+function useDebouncedValue(value, delayMs) {
+	const [debounced, setDebounced] = useState(value);
+	useEffect(() => {
+		const timer = setTimeout(() => setDebounced(value), delayMs);
+		return () => clearTimeout(timer);
+	}, [value, delayMs]);
+	return debounced;
+}
+//#endregion
+//#region src/headless/onboarding/use-capxul-username-availability.ts
+/**
+* #1062: debounced availability probe for the username 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
+* else owns is "taken".
+*/
+function useCapxulUsernameAvailability(username, options) {
+	const client = useCapxulClientOrNull();
+	const candidate = useDebouncedValue(username.trim(), options?.debounceMs ?? 300);
+	return useQuery({
+		queryKey: capxulKeys.usernameAvailability(candidate),
+		queryFn: async () => {
+			const bootstrappedClient = requireBootstrappedClient(client, "identity.usernameAvailable");
+			return unwrapCapxulResult(await bootstrappedClient.identity.usernameAvailable(candidate), bootstrappedClient._internal.telemetry);
+		},
+		enabled: client !== null && candidate.length >= 3 && (options?.enabled ?? true)
+	});
+}
+//#endregion
+//#region src/headless/onboarding/use-capxul-persist-payout-entries.ts
+const CHAIN_TO_NETWORK = {
+	evm: "base-sepolia",
+	solana: "solana-devnet",
+	starknet: "starknet-sepolia"
+};
+/**
+* #1063: persist onboarding payout entries as SELF-owned wallet destinations.
+* Per-entry failures are collected, never thrown — payout persistence is
+* additive to the journey (identity creation is the invariant; behavior map
+* §3 J1), so callers surface `failures` as a non-blocking notice.
+*/
+function useCapxulPersistPayoutEntries() {
+	const client = useCapxulClientOrNull();
+	const queryClient = useQueryClient();
+	return useMutation({
+		mutationFn: async (entries) => {
+			const bootstrappedClient = requireBootstrappedClient(client, "destinations.add");
+			const failures = [];
+			let persisted = 0;
+			for (const entry of entries) {
+				const result = await bootstrappedClient.destinations.add({
+					target: { self: true },
+					kind: "external_account",
+					payload: {
+						network: CHAIN_TO_NETWORK[entry.chain],
+						address: entry.address
+					}
+				});
+				if (result.ok) persisted += 1;
+				else failures.push({
+					entry,
+					error: result.error
+				});
+			}
+			return {
+				persisted,
+				failures
+			};
+		},
+		onSuccess: async () => {
+			await queryClient.invalidateQueries({ queryKey: capxulKeys.destinationsScope });
+		}
+	});
+}
+//#endregion
+//#region src/headless/media/use-capxul-image-upload.ts
+/**
+* #1061 / ADR-0014: the whole upload→record sequence as one mutation —
+* upload the blob, then bind the returned storage id to the profile image or
+* the org logo. The url is the resolved serving URL (re-read from queries,
+* never persisted by consumers).
+*/
+function useCapxulImageUpload() {
+	const client = useCapxulClientOrNull();
+	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 };
+			return { url: unwrapCapxulResult(await media.setOrgLogo({
+				orgId: target.orgId,
+				storageId: uploaded.storageId
+			}), telemetry).logoUrl };
+		},
+		onSuccess: async (_value, input) => {
+			await queryClient.invalidateQueries({ queryKey: input.target.kind === "profile" ? capxulKeys.profile : capxulKeys.orgs });
+		}
+	});
+}
+//#endregion
+export { AddressBook, CapxulProvider, Destinations, InsightsSummary, PayrollRoster, RequestInbox, SendMoney, acknowledgeOnboardingDestination, activeOnboardingRecovery, capxulAccountScope, capxulOrgScope, clearOnboardingJourney, currentOnboardingJourneyId, invalidateOnboardingJourneyObservation, loadOnboardingJourney, onboardingJourneyPosition, resolvePostAuthDestination, saveOnboardingJourney, startOnboardingJourney, useCapxul, useCapxulAccountBalance, useCapxulAccountFund, useCapxulAccountLifecycle, useCapxulActivity, useCapxulAddAddressBookEntry, useCapxulAddDestination, useCapxulAddPayrollRosterLine, useCapxulAddressBook, useCapxulAddressBookEntry, useCapxulApproveInboxRequest, useCapxulAssignRole, useCapxulCancelPayment, useCapxulCancelRequest, useCapxulClientOrNull, useCapxulCompleteOrganizationOnboarding, useCapxulCompletePersonalOnboarding, useCapxulCreateOrg, useCapxulCurrentUser, useCapxulDeclineInboxRequest, useCapxulDestinations, useCapxulHideAddressBookEntry, useCapxulImageUpload, useCapxulInbox, useCapxulInsightsHistory, useCapxulInsightsSummary, useCapxulInviteMember, useCapxulIssueRequest, useCapxulLabelAddressBookEntry, useCapxulOfframpQuote, useCapxulOfframpStatus, useCapxulOrg, useCapxulOrgDeployRoles, useCapxulOrgLifecycle, useCapxulOrgMembers, useCapxulOrgRoles, useCapxulOrgTreasury, useCapxulOrganizationAccount, useCapxulOrganizationAuditLog, useCapxulOrgs, useCapxulPay, useCapxulPayment, useCapxulPayments, useCapxulPayout, useCapxulPayrollRoster, useCapxulPersistPayoutEntries, useCapxulProfile, useCapxulReconcileRequests, useCapxulRemoveDestination, useCapxulRemoveMember, useCapxulRemovePayrollRosterLine, useCapxulRequest, useCapxulRequests, useCapxulRunPayroll, useCapxulSession, useCapxulSignIn, useCapxulSignOut, useCapxulSubAccountCreate, useCapxulSubAccountDelete, useCapxulSubAccountRename, useCapxulSubAccountsList, useCapxulSwitchActingEntity, useCapxulTransfer, useCapxulUnhideAddressBookEntry, useCapxulUpdatePayrollRosterLine, useCapxulUsernameAvailability, useCapxulVerifyOtp, useCapxulWithdraw };
 
 //# sourceMappingURL=index.mjs.map