@capxul/sdk-react 2.0.1 → 2.0.2

package/README.md

@@ -24,13 +24,17 @@ export function Providers({ children }: { children: React.ReactNode }) {
   expose the Core SDK identity actor without a parallel React state model.
 - `useCapxulSend` carries caller-owned invocation controls to that actor.
 - `useCapxulAuth` is the stable six-verb application facade.
+- The provider restores Account readiness after a complete authenticated
+  session. Account and Organization readiness transitions refresh active
+  authenticated queries.
 - `CapxulAuthenticationController` and `CapxulOnboardingController` select
   app-owned slots and render no SDK-owned DOM. Supplying the onboarding
   controller's `recoveryOptions` factory lets a fresh actor resume account
   prerequisites before the stored Organization replay; a failed prerequisite
   returns the same manual replay instead of looping.
 - Rich-data hooks such as `useCapxulProfile`, `useCapxulOrgs`, members, roles,
-  treasury, and money hooks remain TanStack Query projections.
+  treasury, and money hooks remain TanStack Query projections. Personal
+  holdings and activity reads start only after the Account is claimed.
 
 The packed npm package exposes `@capxul/sdk-react` and
 `@capxul/sdk-react/testing`. The workspace-only `@capxul/sdk-react/headless`

package/dist/{controllers--rna89ya.mjs → controllers-DeXOe2mR.mjs}

@@ -184,8 +184,11 @@ function createAuth(client, clearAuthenticatedQueries) {
 			ok: false,
 			reason: "INVALID_INPUT"
 		};
-		const completed = await completeProfile(submission.profileDetails, invocation);
-		if (!completed.ok) return completed;
+		const current = runtime.snapshot();
+		if (current.phase !== "authenticated" || !current.profileComplete) {
+			const completed = await completeProfile(submission.profileDetails, invocation);
+			if (!completed.ok) return completed;
+		}
 		const refreshed = await read(invocation);
 		if (!refreshed.ok) return refreshed;
 		const claimed = await reachClaimed(invocation);
@@ -257,6 +260,24 @@ function createAuth(client, clearAuthenticatedQueries) {
 			return ensureAccount(invocation);
 		}),
 		createOrganization: (submission, options) => guarded(runtime, "createOrganization", options, async (invocation) => {
+			const current = runtime.snapshot();
+			if (current.phase === "authenticated" && current.account.at === "claimed") {
+				const org = current.account.org;
+				if (org !== null && (org.at === "loading" || org.at === "settingUp" || org.at === "ready")) return {
+					ok: true,
+					orgId: org.orgId
+				};
+				if (org?.at === "failed" && org.orgId !== null) {
+					if (!org.retryable) return {
+						ok: false,
+						reason: org.failure.code
+					};
+					return failure(await runtime.send({ _tag: "RetryOrganization" }, invocation)) ?? {
+						ok: true,
+						orgId: org.orgId
+					};
+				}
+			}
 			const prepared = await prepareOrganization(submission, invocation);
 			if (!prepared.ok) return prepared;
 			const created = await runtime.send({
@@ -291,20 +312,37 @@ function CapxulIdentityProvider({ client, children }) {
 	const runtime = client?._internal.identity ?? null;
 	const listeners = useRef(/* @__PURE__ */ new Set());
 	useEffect(() => {
-		if (client === null) return;
-		Promise.resolve().then(() => client.auth.getSession()).catch(() => void 0);
-	}, [client]);
+		if (client === null || runtime === null) return;
+		const controller = new AbortController();
+		let active = true;
+		Promise.resolve().then(async () => {
+			const restored = await client.auth.getSession({ signal: controller.signal });
+			if (!active || !restored.ok) return;
+			let state = runtime.snapshot();
+			if (state.phase === "authenticated" && state.account.at === "unknown") {
+				await runtime.send({ _tag: "ReadSession" }, { signal: controller.signal });
+				if (!active) return;
+				state = runtime.snapshot();
+			}
+			if (state.phase === "authenticated" && state.profileComplete && state.account.at === "unknown") await runtime.send({ _tag: "EnsureAccount" }, { signal: controller.signal });
+		}).catch(() => void 0);
+		return () => {
+			active = false;
+			controller.abort();
+		};
+	}, [client, runtime]);
 	useEffect(() => {
 		if (runtime === null) return;
 		return runtime.subscribeTransitions((record) => {
 			const state = runtime.snapshot();
+			if (record.outcome === "applied" && record.from !== record.to && (record.to === "authenticated:claimed" || record.to === "authenticated:claimed:ready")) queryClient.invalidateQueries({ queryKey: capxulKeys.root });
 			for (const listener of listeners.current) try {
 				listener(record, state);
 			} catch {
 				listeners.current.delete(listener);
 			}
 		});
-	}, [runtime]);
+	}, [queryClient, runtime]);
 	const addTransitionListener = useCallback((listener) => {
 		listeners.current.add(listener);
 		return () => listeners.current.delete(listener);

package/dist/index.mjs

@@ -1,5 +1,5 @@
 "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--rna89ya.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-DeXOe2mR.mjs";
 import { useEffect, useState } from "react";
 import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 //#region ../errors/src/errors.ts
@@ -425,17 +425,19 @@ function useCapxulPermission(orgId, permissionId) {
 //#region src/hooks/use-capxul-activity.ts
 function useCapxulActivity(params) {
 	const client = useCapxulClientOrNull();
+	const identity = useCapxulIdentityOrNull();
 	return useQuery({
 		queryKey: [...capxulKeys.activity, params ?? {}],
 		queryFn: async () => {
 			const bootstrapped = requireBootstrappedClient(client, "activity.list");
 			return unwrapCapxulResult(await bootstrapped.activity.list(params), bootstrapped._internal.telemetry);
 		},
-		enabled: client !== null
+		enabled: client !== null && identity?.phase === "authenticated" && identity.account.at === "claimed"
 	});
 }
 function useCapxulActivityDetail(reference) {
 	const client = useCapxulClientOrNull();
+	const identity = useCapxulIdentityOrNull();
 	return useQuery({
 		queryKey: capxulKeys.activityDetail(reference?.kind ?? "payment", reference?.id),
 		queryFn: async () => {
@@ -443,7 +445,7 @@ function useCapxulActivityDetail(reference) {
 			const bootstrapped = requireBootstrappedClient(client, "activity.get");
 			return unwrapCapxulResult(await bootstrapped.activity.get(reference), bootstrapped._internal.telemetry);
 		},
-		enabled: client !== null && reference !== void 0
+		enabled: client !== null && reference !== void 0 && identity?.phase === "authenticated" && identity.account.at === "claimed"
 	});
 }
 function useCapxulAnnotateMovement() {
@@ -461,13 +463,14 @@ function useCapxulAnnotateMovement() {
 //#region src/hooks/use-capxul-holdings.ts
 function useCapxulHoldings() {
 	const client = useCapxulClientOrNull();
+	const identity = useCapxulIdentityOrNull();
 	return useQuery({
 		queryKey: capxulKeys.holdings,
 		queryFn: async () => {
 			const bootstrapped = requireBootstrappedClient(client, "holdings.current");
 			return unwrapCapxulResult(await bootstrapped.holdings.current(), bootstrapped._internal.telemetry);
 		},
-		enabled: client !== null
+		enabled: client !== null && identity?.phase === "authenticated" && identity.account.at === "claimed"
 	});
 }
 //#endregion

package/dist/testing/index.mjs

@@ -1,4 +1,4 @@
-import { n as CapxulOnboardingController, r as CapxulProvider, t as CapxulAuthenticationController } from "../controllers--rna89ya.mjs";
+import { n as CapxulOnboardingController, r as CapxulProvider, t as CapxulAuthenticationController } from "../controllers-DeXOe2mR.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.0.1",
+  "version": "2.0.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Xelmar-tech/infrastructure.git",
@@ -26,7 +26,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@capxul/sdk": "2.0.1"
+    "@capxul/sdk": "2.0.2"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.66.9",
@@ -43,8 +43,8 @@
     "vite-plus": "0.1.23",
     "vitest": "npm:@voidzero-dev/vite-plus-test@0.1.23",
     "@capxul/types": "0.1.0",
-    "@capxul/errors": "0.0.1",
-    "@capxul/typescript-config": "0.0.0"
+    "@capxul/typescript-config": "0.0.0",
+    "@capxul/errors": "0.0.1"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.66.9",