@capxul/sdk-react 4.20.0-beta.35 → 4.20.0-beta.37

package/dist/index.d.mts

@@ -360,7 +360,7 @@ type SentPayment = {
  * Refusal CODES, never sentences (#1447 ruling 8). The app maps each code to
  * the words it already prints; no English refusal string ships from here.
  */
-type CapxulSendMoneyBlockedReason = "signer-not-ready" | "amount-invalid" | "recipient-unresolved" | "no-source" | "no-asset" | "asset-unnamed";
+type CapxulSendMoneyBlockedReason = "signer-not-ready" | "amount-invalid" | "recipient-unresolved" | "no-source" | "no-asset";
 /**
  * One Budget the member can spend from — the id the payment carries, and
  * nothing else.
@@ -999,7 +999,7 @@ interface PayrollRecipientOption {
  * false fact in the fixed order below, so the same composer state always
  * yields the same code.
  */
-type CapxulPayrollRunBlockedReason = "signer-not-ready" | "no-source" | "ambiguous-source" | "no-asset" | "no-recipients" | "amount-invalid" | "insufficient-funds" | "asset-unnamed";
+type CapxulPayrollRunBlockedReason = "signer-not-ready" | "no-source" | "ambiguous-source" | "no-asset" | "no-recipients" | "amount-invalid" | "insufficient-funds";
 interface PayrollRunGroupOption {
   readonly id: PayrollGroupId;
   readonly label: string;

package/dist/index.mjs

@@ -1,5 +1,5 @@
 "use client";
-import { _ as orgKeySegment, a as entered, c as useCapxulIdentity, d as useCapxulTransitions, f as toInvocationControls, g as capxulKeys, h as actingAccount, i as CapxulProvider, l as useCapxulIdentityOrNull, m as accountKey, n as CapxulAuthenticationController, o as useCapxulAuth, p as toInvocationOptions, r as absurd, s as useCapxulDestination, t as CapxulOnboardingController, u as useCapxulSend, v as useCapxulClientOrNull, y as useCapxul } from "./onboarding-controller-DWuvVuC8.mjs";
+import { _ as orgKeySegment, a as entered, c as useCapxulIdentity, d as useCapxulTransitions, f as toInvocationControls, g as capxulKeys, h as actingAccount, i as CapxulProvider, l as useCapxulIdentityOrNull, m as accountKey, n as CapxulAuthenticationController, o as useCapxulAuth, p as toInvocationOptions, r as absurd, s as useCapxulDestination, t as CapxulOnboardingController, u as useCapxulSend, v as useCapxulClientOrNull, y as useCapxul } from "./onboarding-controller-BCrkmLxQ.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, EVM_ADDRESS_RE, Errors, HANDLE_RE, PAYMENT_DIRECTIONS, PAYMENT_STATUSES, assetSymbolFor, fingerprintPaymentIntent, formatAssetAmount, formatMoney, isCapxulError, isClaimed, isClaimed as isClaimed$1, isMoneyParseError, isRestoring, isRestoring as isRestoring$1, parseAssetAmount, parseMoney, paymentPhase, requireAsset, resolveIdentityDestination, toAssetId, toCurrencyCode, toEvmAddress, toOrgId, toPartyId, toRaw, valueActivitySummary } from "@capxul/sdk";
@@ -1204,14 +1204,24 @@ async function storageKey$1(operation, intent) {
 }
 function paymentLockManager() {
 	const manager = navigator.locks;
-	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"));
+	if (manager === void 0 || typeof manager.query !== "function") throw Errors.providerUnavailable({
+		provider: "sdk-react",
+		operation: "paymentRequestKey",
+		mode: "no-secure-context",
+		details: { reason: "web-locks-unavailable" }
+	});
 	return manager;
 }
 function readState(key) {
 	const stored = localStorage.getItem(key);
 	if (stored === null) return null;
 	const state = JSON.parse(stored);
-	if (!isPaymentRequestKeyState(state)) throw Errors.providerError("sdk-react", "paymentRequestKey", /* @__PURE__ */ new TypeError("Invalid payment request key state"));
+	if (!isPaymentRequestKeyState(state)) throw Errors.providerUnavailable({
+		provider: "sdk-react",
+		operation: "paymentRequestKey",
+		mode: "defect",
+		details: { reason: "invalid-stored-state" }
+	});
 	return state;
 }
 async function beginPaymentRequestKey(operation, intent) {
@@ -1267,7 +1277,12 @@ async function beginPaymentRequestKey(operation, intent) {
 	} catch (cause) {
 		forgetPagehideRelease?.();
 		releaseAttemptLock?.();
-		throw Errors.providerError("sdk-react", "paymentRequestKey", cause);
+		throw Errors.providerUnavailable({
+			provider: "sdk-react",
+			operation: "paymentRequestKey",
+			mode: "unknown",
+			cause
+		});
 	}
 }
 async function withPaymentRequestKey(operation, intent, work) {
@@ -1418,26 +1433,6 @@ function useCapxulOrganizationPayBatch(orgId) {
 	});
 }
 //#endregion
-//#region src/payments/write-names-asset.ts
-/**
-* Identity law: "A payment names an asset or inherits it from an authorized
-* fact. Missing asset refuses." The rule was recorded in the retired
-* treasury-cut handoff (removed from the current tree by the exact-asset
-* contraction; its record survives in Git history).
-*
-* A Capxul payment writer takes `PaymentMoney` — a peg currency, a value and
-* `decimals` — and settles one fixed legacy token. No `AssetId` crosses that
-* seam, so a payment composed from a named position cannot name the asset it
-* moves: a position selected as USDT authorizes a different token.
-*
-* `false` until the writer takes the command's asset. The Send and Payroll
-* composers read this to refuse a submission rather than authorize a token the
-* person did not pick.
-*/
-function writeNamesAsset() {
-	return false;
-}
-//#endregion
 //#region src/platform/signer-status.ts
 const NO_SUBSCRIPTION = () => () => {};
 function useSignerStatus(client) {
@@ -1592,9 +1587,6 @@ function useSendMoney(input) {
 	const client = useCapxulClientOrNull();
 	const signerStatus = useSignerStatus(client);
 	const orgId = actor.kind === "organization" ? actor.orgId : void 0;
-	const meReading = useOrgMeReading(orgId);
-	const sourceOptions = useMemo(() => meReading.kind === "ready" ? meReading.me.budgets.map((budget) => ({ id: budget.id })) : [], [meReading]);
-	const [selectedSource, selectSource] = useSelectedOption(sourceOptions);
 	const balance = useCapxulAccountBalance({ enabled: actor.kind === "personal" });
 	const treasury = useCapxulOrgTreasury(orgId, { enabled: actor.kind === "organization" });
 	const accountQuery = actor.kind === "personal" ? balance : treasury;
@@ -1603,6 +1595,9 @@ function useSendMoney(input) {
 	const assetOptions = useMemo(() => assetSelections.map((selection) => selection.option), [assetSelections]);
 	const [selectedAssetOption, selectAsset] = useSelectedOption(assetOptions);
 	const selectedAssetMoney = useMemo(() => assetSelections.find((selection) => selection.option.id === selectedAssetOption?.id)?.money ?? null, [assetSelections, selectedAssetOption]);
+	const meReading = useOrgMeReading(orgId);
+	const sourceOptions = useMemo(() => meReading.kind === "ready" ? meReading.me.budgets.filter((budget) => selectedAssetOption === null || budget.asset.assetId === selectedAssetOption.id).map((budget) => ({ id: budget.id })) : [], [meReading, selectedAssetOption]);
+	const [selectedSource, selectSource] = useSelectedOption(sourceOptions);
 	const [amountText, setAmountText] = useState("");
 	const parsed = useMemo(() => selectedAssetMoney === null || amountText.trim() === "" ? null : parseAssetAmount(amountText, requireAsset(selectedAssetMoney.asset)), [amountText, selectedAssetMoney]);
 	const parsedMoney = parsed !== null && !isMoneyParseError(parsed) ? parsed : null;
@@ -1616,7 +1611,7 @@ function useSendMoney(input) {
 	const personalPay = useCapxulPay();
 	const organizationPay = useCapxulOrganizationPay(orgId);
 	const pay = actor.kind === "personal" ? personalPay : organizationPay;
-	const blockedReason = signerStatus !== "ready" ? "signer-not-ready" : actor.kind === "organization" && selectedSource === null ? "no-source" : selectedAssetOption === null ? "no-asset" : parsedMoney === null ? "amount-invalid" : resolvedReference === null ? "recipient-unresolved" : writeNamesAsset() ? null : "asset-unnamed";
+	const blockedReason = signerStatus !== "ready" ? "signer-not-ready" : actor.kind === "organization" && selectedSource === null ? "no-source" : selectedAssetOption === null ? "no-asset" : parsedMoney === null ? "amount-invalid" : resolvedReference === null ? "recipient-unresolved" : null;
 	const submitGate = useRef(false);
 	const submit = useCallback(() => {
 		if (blockedReason !== null || submitGate.current) return;
@@ -2844,8 +2839,8 @@ function decodeDraft(value, scope) {
 		};
 		try {
 			if (toRaw(selectedAmount, selectedAsset).toString() !== net) throw Errors.invalidInput("payrollDraft", "Draft payout units differ from net");
-		} catch {
-			throw Errors.invalidInput("payrollDraft", "Invalid draft payout amount");
+		} catch (cause) {
+			throw Errors.invalidInput("payrollDraft", "Invalid draft payout amount", cause);
 		}
 		return {
 			to: {
@@ -2902,8 +2897,14 @@ function minorAmount(value) {
 	if (typeof value !== "string" || !/^\d+$/u.test(value) || BigInt(value) <= 0n) throw Errors.invalidInput("payrollDraft", "Invalid draft amount");
 	return value;
 }
+/** A draft failure that is not already typed: local storage failed, and nothing says how. */
 function runDraftError(cause) {
-	return cause instanceof CapxulError ? cause : Errors.providerError("sdk-react", "payrollDraft", cause);
+	return cause instanceof CapxulError ? cause : Errors.providerUnavailable({
+		provider: "sdk-react",
+		operation: "payrollDraft",
+		mode: "unknown",
+		cause
+	});
 }
 function storageKey(scope) {
 	return `capxul.payroll.run-draft.v1:${scope}`;
@@ -2915,8 +2916,8 @@ function readRunDraft(scope) {
 		let value;
 		try {
 			value = JSON.parse(raw);
-		} catch {
-			throw Errors.invalidInput("payrollDraft", "Invalid run draft JSON");
+		} catch (cause) {
+			throw Errors.invalidInput("payrollDraft", "Invalid run draft JSON", cause);
 		}
 		return decodeDraft(value, scope);
 	} catch (cause) {
@@ -3362,8 +3363,8 @@ function freshRunDraft(input) {
 		}
 	};
 }
-function hasRequiredCompensation(frozen, writerNamesSelectedAsset, selected, terms) {
-	return frozen || !writerNamesSelectedAsset || selected.every((recipientId) => terms.has(recipientId));
+function hasRequiredCompensation(frozen, selected, terms) {
+	return frozen || selected.every((recipientId) => terms.has(recipientId));
 }
 /**
 * WHICH run the composer is composing, by MEANING rather than by object shape.
@@ -3406,10 +3407,14 @@ function remainingBalanceDisplay(available, total, asset) {
 	}));
 	return remaining < 0n ? `-${formatted}` : formatted;
 }
-/** Persisted replay keeps its authorized Budget and asset; a prior debit cannot block its own recovery. */
+/**
+* Persisted replay keeps its authorized Budget and asset; a prior debit cannot
+* block its own recovery. A restored run names its Budget, so it counts only
+* whether that Budget is still offered, never how many others are.
+*/
 function runAuthorityFacts(draft, budgets, asset, money, funds) {
 	return {
-		budgetCount: draft !== null && !budgets.some((budget) => budget.id === draft.input.permissionId) ? 0 : budgets.length,
+		budgetCount: draft === null ? budgets.length : budgets.filter((budget) => budget.id === draft.input.permissionId).length,
 		hasAsset: asset !== null && (draft === null || draft.asset.id === asset.id && draft.input.asset === money?.asset),
 		funds: draft?.input.requestKey === void 0 ? funds : "available"
 	};
@@ -3426,8 +3431,7 @@ function firstFalseFact(facts) {
 	if (!facts.hasAsset) return "no-asset";
 	if (facts.recipientCount === 0) return "no-recipients";
 	if (!facts.amountsParse) return "amount-invalid";
-	if (facts.funds === "insufficient") return "insufficient-funds";
-	return facts.writeNamesAsset ? null : "asset-unnamed";
+	return facts.funds === "insufficient" ? "insufficient-funds" : null;
 }
 //#endregion
 //#region src/payroll/use-run-amounts.ts
@@ -3510,14 +3514,15 @@ function useRunAmounts(input) {
 * share one account id, and a symbol is display only (ADR-0028 R3). The run
 * writer receives the selected asset explicitly.
 */
-function useRunAsset(account, canSelect) {
+function useRunAsset(account, canSelect, restoredAssetId) {
 	const assetSelections = useMemo(() => assetSelectionsFromAccount(account), [account]);
 	const assetOptions = useMemo(() => assetSelections.map((selection) => selection.option), [assetSelections]);
 	const [selectedAssetId, setSelectedAssetId] = useState(null);
 	useEffect(() => {
 		if (!assetOptions.some((option) => option.id === selectedAssetId)) setSelectedAssetId(assetOptions[0]?.id ?? null);
 	}, [assetOptions, selectedAssetId]);
-	const selectedAsset = assetOptions.find((option) => option.id === selectedAssetId) ?? null;
+	const effectiveAssetId = restoredAssetId ?? selectedAssetId;
+	const selectedAsset = assetOptions.find((option) => option.id === effectiveAssetId) ?? null;
 	return {
 		assetOptions,
 		selectedAsset,
@@ -3609,7 +3614,7 @@ function usePayrollRun(input) {
 		draftError
 	]);
 	const canSelectAsset = useCallback(() => !submitGate.current && !frozen, [frozen]);
-	const { assetOptions, selectedAsset, selectAsset, assetMoney } = useRunAsset(treasury.data ?? null, canSelectAsset);
+	const { assetOptions, selectedAsset, selectAsset, assetMoney } = useRunAsset(treasury.data ?? null, canSelectAsset, draft?.input.asset ?? null);
 	const { named, payableRefs, compensationTerms } = useRunRecipients({
 		options: roster.options,
 		refs: roster.refs,
@@ -3624,14 +3629,12 @@ function usePayrollRun(input) {
 		names: named,
 		change
 	});
-	const budgets = me.data?.budgets ?? [];
-	const writerNamesSelectedAsset = writeNamesAsset();
+	const budgets = (me.data?.budgets ?? []).filter((budget) => selectedAsset === null || budget.asset.assetId === selectedAsset.id);
 	const blockedReason = firstFalseFact({
 		signerReady: signerStatus === "ready",
 		...runAuthorityFacts(draft, budgets, selectedAsset, assetMoney, funds),
 		recipientCount: payableRefs === null ? 0 : selected.length,
-		amountsParse: total !== null && hasRequiredCompensation(frozen, writerNamesSelectedAsset, selected, compensationTerms),
-		writeNamesAsset: writerNamesSelectedAsset
+		amountsParse: total !== null && hasRequiredCompensation(frozen, selected, compensationTerms)
 	});
 	const authorize = useAuthorizeRun({
 		client,

package/dist/{onboarding-controller-DWuvVuC8.mjs → onboarding-controller-BCrkmLxQ.mjs}

@@ -859,11 +859,13 @@ function CapxulProvider(props) {
 //#endregion
 //#region ../protocol/src/errors/failure-modes.ts
 /**
-* Why an operation failed — the one flat vocabulary. The first four are the
-* auth/provider diagnoses that predate this file. The rest name the chain
-* path. `FailureMode` is derived from this list so a runtime membership check
-* (the SDK's `$exception` projection, the observability schema) and the type
-* can never drift apart.
+* Why an operation failed — the one flat vocabulary. The first five are the
+* auth and signer diagnoses that predate this file. The next eleven name the
+* chain path. `refused` and `defect` name a provider refusal and a Capxul
+* fault on any path (ADR-0039 D2). `FailureMode` is derived from this list so
+* a runtime membership check (the SDK's `$exception` projection, the
+* observability schema) and the type can never drift apart. Every word has a
+* failure class in `classes.ts`.
 */
 const FAILURE_MODES = [
 	"auth-origin-mismatch",
@@ -882,6 +884,8 @@ const FAILURE_MODES = [
 	"forbidden",
 	"bad-request",
 	"method-unsupported",
+	"refused",
+	"defect",
 	"unknown"
 ];
 function isFailureMode(value) {

package/dist/testing/index.mjs

@@ -1,4 +1,4 @@
-import { i as CapxulProvider, n as CapxulAuthenticationController, t as CapxulOnboardingController } from "../onboarding-controller-DWuvVuC8.mjs";
+import { i as CapxulProvider, n as CapxulAuthenticationController, t as CapxulOnboardingController } from "../onboarding-controller-BCrkmLxQ.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": "4.20.0-beta.35",
+  "version": "4.20.0-beta.37",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Xelmar-tech/infrastructure.git",
@@ -56,7 +56,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@capxul/sdk": "4.20.0-beta.35"
+    "@capxul/sdk": "4.20.0-beta.37"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.66.9",
@@ -75,7 +75,7 @@
     "vite": "npm:@voidzero-dev/vite-plus-core@1.0.0",
     "vite-plus": "1.0.0",
     "vitest": "5.0.1",
-    "@capxul/protocol": "0.2.0-beta.6",
+    "@capxul/protocol": "0.2.0-beta.8",
     "@capxul/typescript-config": "0.0.0"
   },
   "peerDependencies": {