feat: add quiet reading with rare confirmations

Part of the quiet-user-feedback change; docs and specs land in their own repositories.

src/pages/account-operations/ui/AccountOperationsPage/AccountOperationsPage.vm.ts

@@ -11,7 +11,7 @@ import {
 } from "@/entities/broker-operation";
 import { useScreenSync } from "@/features/tbank-connection";
 import { ApiErrorCode, apiErrorCode, isApiErrorCode } from "@/shared/api";
-import { isValidPeriod, useUrlPeriod } from "@/shared/lib";
+import { isValidPeriod, useInitialAvailability, useUrlPeriod } from "@/shared/lib";
 
 const operationCategorySet = new Set<string>(operationCategories);
 
@@ -24,7 +24,6 @@ type AccountOperationsPageViewModel
 		hasPrevious: boolean;
 		historyLoading?: boolean;
 		items: BrokerageOperation[];
-		lastSuccessfulAt?: null | string;
 		onApply: () => void;
 		onCategoriesChange: (value: string[]) => void;
 		onNext: () => void;
@@ -32,13 +31,9 @@ type AccountOperationsPageViewModel
 		onPrevious: () => void;
 		onReset: () => void;
 		partial?: boolean;
-		refreshError?: boolean;
-		refreshing?: boolean;
-		retry?: () => void;
-		sourceError?: boolean;
 		state: "loaded";
 	}
-	| { onReset: () => void; retry: () => void; state: "error" }
+	| { onReset: () => void; state: "error" }
 	| { state: "loading" };
 
 const useAccountOperationsPageVm = (): AccountOperationsPageViewModel => {
@@ -85,19 +80,28 @@ const useAccountOperationsPageVm = (): AccountOperationsPageViewModel => {
 		history.reset();
 	}
 
-	const sync = useScreenSync(
+	useScreenSync(
 		{ accountId, screen: "operations", ...firstPageQuery },
 		[operations],
 	);
 
-	if (operations.isLoading) return { state: "loading" };
+	const availability = useInitialAvailability({
+		hasContent: !!operations.data,
+		identity: scope,
+		isError: operations.isError || operations.meta?.sync.state === "failed",
+		isFetching: operations.isFetching,
+	});
+
+	if (availability === "loading" && operations.isLoading)
+		return { state: "loading" };
+
+	if (history.isRecoveringInvalidCursor)
+		return { state: "loading" };
 
 	const resetQueryKey = brokerageOperationsQueryOptions(accountId, {
 		limit: 100,
 	}).queryKey;
 
-	const retry = () => history.retry(sync.retry);
-
 	const onReset = () => {
 		setDraftPeriod([null, null]);
 		setDraftCategories([]);
@@ -106,16 +110,22 @@ const useAccountOperationsPageVm = (): AccountOperationsPageViewModel => {
 		void queryClient.invalidateQueries({ queryKey: resetQueryKey });
 	};
 
+	const isInvalidCursor = isApiErrorCode(
+		apiErrorCode(operations.error),
+		ApiErrorCode.InvalidOperationsCursor,
+	);
+
 	if (
-		(operations.isError || operations.meta?.sync.state === "failed")
-		&& (!operations.data
-			|| isApiErrorCode(
-				apiErrorCode(operations.error),
-				ApiErrorCode.InvalidOperationsCursor,
-			))
+		(isInvalidCursor || !operations.data)
+		&& (operations.isError || operations.meta?.sync.state === "failed")
 	)
-		return { onReset, retry, state: "error" };
-	if (!operations.data) return { state: "loading" };
+		return { onReset, state: "error" };
+
+	if (!operations.data)
+		return availability === "unavailable"
+			? { onReset, state: "error" }
+			: { state: "loading" };
+
 	const nextCursor = operations.data.nextCursor;
 
 	const isDirty
@@ -133,7 +143,6 @@ const useAccountOperationsPageVm = (): AccountOperationsPageViewModel => {
 			operations.meta?.coverage?.historyState === "loading"
 			|| operations.meta?.coverage?.historyState === "partial",
 		items: operations.data.items,
-		lastSuccessfulAt: operations.meta?.lastSuccessfulAt,
 		onApply: () => {
 			if (!isValidPeriod(draftFrom, draftTo)) return;
 			setSearchParameters({
@@ -155,10 +164,6 @@ const useAccountOperationsPageVm = (): AccountOperationsPageViewModel => {
 		onPrevious: history.onPrevious,
 		onReset,
 		partial: operations.meta?.availability !== "complete",
-		refreshError: operations.isError || sync.sourceError || sync.transportError,
-		refreshing: operations.isFetching || sync.refreshing,
-		retry,
-		sourceError: sync.sourceError,
 		state: "loaded",
 	};
 };