@capxul/sdk-react 4.2.0-rc.10 → 4.2.0-rc.12

package/dist/capxul-source.json

@@ -1,11 +1,11 @@
 {
   "source": {
-    "commit": "a7e55e5f1c2af5567a8b285a4ef70b8b5a3289f6",
-    "tree": "91bf1b080c0006fe30131711c13c843afd627158",
+    "commit": "fd5b4d0f124c75f609e469b8673c61f84253c0dc",
+    "tree": "d61f0f6b0c83dfc2d405ffc6b55eecf2e9d80f2d",
     "branch": "codex/programme-rc",
     "repository": "https://github.com/Xelmar-tech/infrastructure",
     "lockfileSha256": "5870f53b72706d103220c1bcf733cb4fb71196aea32a9cfbdc277d73cc959264"
   },
   "name": "@capxul/sdk-react",
-  "version": "4.2.0-rc.10"
+  "version": "4.2.0-rc.12"
 }

package/dist/index.d.mts

@@ -891,8 +891,14 @@ interface PayrollSummarySlice {
 }
 interface PayrollGroupsSlice {
   readonly groups: readonly PayrollGroupRow[];
-  readonly save: (input: PayrollGroupInput) => Promise<CapxulResult<PayrollGroupRow>>;
-  readonly remove: (id: PayrollGroupId) => Promise<CapxulResult<void>>;
+  /**
+   * R13 (#1968): `options` is the browser attempt the caller captured before the
+   * employer pressed the button. It reaches the SDK operation unchanged, so the
+   * group's `ui_payroll_action_completed` and the durable `payroll_group_changed`
+   * share one correlation. Absent, the write keeps its own invocation context.
+   */
+  readonly save: (input: PayrollGroupInput, options?: InvocationOptions) => Promise<CapxulResult<PayrollGroupRow>>;
+  readonly remove: (id: PayrollGroupId, options?: InvocationOptions) => Promise<CapxulResult<void>>;
   readonly isSaving: boolean;
   readonly isLoading: boolean;
   readonly error: CapxulError | null;
@@ -984,7 +990,14 @@ interface PayrollRunSummarySlice {
 interface PayrollRunActionsSlice {
   readonly recovery: "none" | "restoring" | "required" | "unavailable";
   readonly recoveryError: CapxulError | null;
-  readonly submit: () => void;
+  /**
+   * R13 (#1968): `options` is the browser attempt captured before the employer
+   * confirmed. It reaches `authorizeRun` unchanged, so the sheet's own
+   * `ui_payroll_action_completed` and the durable `payroll_run_transitioned`
+   * rows share one correlation. It is NEVER written into the persisted draft —
+   * a restored run keeps its own identity, not a stale attempt's.
+   */
+  readonly submit: (options?: InvocationOptions) => void;
   readonly isSubmitting: boolean;
   readonly blocked: boolean;
   readonly blockedReason: CapxulPayrollRunBlockedReason | null;

package/dist/index.mjs

@@ -880,7 +880,7 @@ function useCapxulUploadImage() {
 //#endregion
 //#region src/headless/contacts/use-contacts.ts
 /** One captured snapshot, or nothing — never a fabricated empty options object. */
-const carry = (options) => options === void 0 ? {} : { options };
+const carry$1 = (options) => options === void 0 ? {} : { options };
 function useContacts(input) {
 	const { actor, onAdded, onFailed } = input;
 	const client = useCapxulClientOrNull();
@@ -922,7 +922,7 @@ function useContacts(input) {
 		setAddError(null);
 		addMutate({
 			ref: refFromTypedText(value),
-			...carry(attempt)
+			...carry$1(attempt)
 		}, {
 			onSuccess: (entry) => {
 				setValue("");
@@ -955,17 +955,17 @@ function useContacts(input) {
 			kind: "rename",
 			id,
 			name,
-			...carry(toInvocationOptions(options))
+			...carry$1(toInvocationOptions(options))
 		}), [writeMutate]),
 		hide: useCallback((id, options) => writeMutate({
 			kind: "hide",
 			id,
-			...carry(toInvocationOptions(options))
+			...carry$1(toInvocationOptions(options))
 		}), [writeMutate]),
 		unhide: useCallback((id, options) => writeMutate({
 			kind: "unhide",
 			id,
-			...carry(toInvocationOptions(options))
+			...carry$1(toInvocationOptions(options))
 		}), [writeMutate]),
 		add: {
 			value,
@@ -1598,6 +1598,28 @@ function useActivity(input) {
 		getNextPageParam: (last) => last.cursor ?? void 0,
 		enabled
 	});
+	const queryClient = useQueryClient();
+	useEffect(() => {
+		if (!enabled || client === null) return;
+		let stop;
+		let cancelled = false;
+		client.activity.subscribe(() => {
+			queryClient.invalidateQueries({ queryKey: capxulKeys.activity });
+		}, actor === void 0 ? void 0 : { actor }).then((result) => {
+			if (!result.ok) return;
+			if (cancelled) result.value();
+			else stop = result.value;
+		});
+		return () => {
+			cancelled = true;
+			stop?.();
+		};
+	}, [
+		actor,
+		client,
+		enabled,
+		queryClient
+	]);
 	const pages = query.data?.pages;
 	const rows = useMemo(() => {
 		return (pages?.flatMap((page) => page.items) ?? []).map((item) => toActivityRow(item, actor)).filter((row) => matchesSearch(row, searchText));
@@ -2557,6 +2579,14 @@ function scopedClient(client, method, orgId) {
 //#region src/headless/payroll/use-payroll.ts
 /** Money reads the same way everywhere on this screen: amount then code. */
 const GRAMMAR$1 = { grammar: "code" };
+/**
+* One captured snapshot, or nothing — never a fabricated empty options object,
+* and never a DOM event a screen wired straight to `onClick`.
+*/
+function carry(options) {
+	const attempt = toInvocationOptions(options);
+	return attempt === void 0 ? {} : { options: attempt };
+}
 function toPayrollGroupRow(group) {
 	const currency = new Set(group.members.map((member) => member.currency)).size === 1 ? group.members[0]?.currency : void 0;
 	return {
@@ -2596,16 +2626,17 @@ function usePayroll(orgId) {
 	const write = useMutation({
 		mutationFn: async (command) => {
 			const payroll = scopedClient(client, CAPXUL_OPERATIONS.org.payroll.groups[command.kind], orgId).payroll;
+			const controls = toInvocationControls(command.options);
 			if (command.kind === "remove") {
-				unwrapCapxulResult(await payroll.groups.remove(command.id));
+				unwrapCapxulResult(await payroll.groups.remove(command.id, controls));
 				return null;
 			}
-			return unwrapCapxulResult(await payroll.groups.save(command.input));
+			return unwrapCapxulResult(await payroll.groups.save(command.input, controls));
 		},
 		onSettled: invalidate
 	});
 	const mutateAsync = write.mutateAsync;
-	const save = useCallback(async (input) => {
+	const save = useCallback(async (input, options) => {
 		const refusal = invalidGroup(input);
 		if (refusal !== null) return {
 			ok: false,
@@ -2614,7 +2645,8 @@ function usePayroll(orgId) {
 		try {
 			const saved = await mutateAsync({
 				kind: "save",
-				input
+				input,
+				...carry(options)
 			});
 			return saved === null ? {
 				ok: false,
@@ -2630,11 +2662,12 @@ function usePayroll(orgId) {
 			};
 		}
 	}, [mutateAsync]);
-	const remove = useCallback(async (id) => {
+	const remove = useCallback(async (id, options) => {
 		try {
 			await mutateAsync({
 				kind: "remove",
-				id
+				id,
+				...carry(options)
 			});
 			return {
 				ok: true,
@@ -3152,11 +3185,12 @@ function usePayrollRun(input) {
 		amountsParse: total !== null
 	});
 	const authorize = useMutation({
-		mutationFn: async (candidate) => {
+		mutationFn: async ({ candidate, options }) => {
 			if (candidate.scope !== currentScope.current) throw Errors.notAuthenticated();
 			return executeRunDraft(candidate, async (persisted, onRequestKey, onResolved) => {
 				if (candidate.scope === currentScope.current) setDraft(persisted);
 				return unwrapCapxulResult(await scopedClient(client, CAPXUL_OPERATIONS.org.payroll.authorizeRun, orgId).payroll.authorizeRun(persisted.input, {
+					...toInvocationControls(options),
 					onResolved,
 					onRequestKey: (key) => {
 						if (candidate.scope !== currentScope.current) throw Errors.notAuthenticated();
@@ -3165,14 +3199,15 @@ function usePayrollRun(input) {
 				}));
 			});
 		},
-		onSettled: (_run, _error, candidate) => {
+		onSettled: (_run, _error, { candidate }) => {
 			queryClient.invalidateQueries({ queryKey: capxulKeys.payrollRuns(orgId) });
 			if (candidate.scope === currentScope.current) restoreDraft(candidate.scope);
 		}
 	});
 	const totalDisplay = total === null ? null : formatMoney(total, GRAMMAR);
 	const authorizeMutate = authorize.mutate;
-	const submit = useCallback(() => {
+	const submit = useCallback((options) => {
+		const attempt = toInvocationOptions(options);
 		const permissionId = budgets[0]?.id;
 		if (blockedReason !== null || submitGate.current || draftBlocked || draftScope === null || assetMoney === null || selectedAsset === null) return;
 		if (permissionId === void 0 || totalDisplay === null || parsedAmounts === null) return;
@@ -3214,7 +3249,10 @@ function usePayrollRun(input) {
 			}
 		};
 		submitGate.current = true;
-		authorizeMutate(candidate, {
+		authorizeMutate({
+			candidate,
+			...attempt === void 0 ? {} : { options: attempt }
+		}, {
 			onSuccess: (run) => {
 				if (candidate.scope === currentScope.current) onRun({
 					id: run.id,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capxul/sdk-react",
-  "version": "4.2.0-rc.10",
+  "version": "4.2.0-rc.12",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Xelmar-tech/infrastructure.git",
@@ -26,7 +26,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@capxul/sdk": "4.2.0-rc.10"
+    "@capxul/sdk": "4.2.0-rc.12"
   },
   "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.3.0",
     "@capxul/typescript-config": "0.0.0",
+    "@capxul/errors": "0.3.0",
     "@capxul/types": "0.3.0"
   },
   "peerDependencies": {