Clear delete navigate back URL when the deleted expense screen unmounts

src/libs/actions/Report/index.ts

@@ -83,6 +83,7 @@ import isSearchTopmostFullScreenRoute from '@libs/Navigation/helpers/isSearchTop
 import type {LinkToOptions} from '@libs/Navigation/helpers/linkTo/types';
 import Navigation from '@libs/Navigation/Navigation';
 import REPORT_LINK_ROUTE_PARAMS from '@libs/Navigation/reportLinkRouteParams';
+import TransitionTracker from '@libs/Navigation/TransitionTracker';
 import enhanceParameters from '@libs/Network/enhanceParameters';
 import {getDBTimeWithSkew, getIsOffline as isOfflineNetwork} from '@libs/NetworkState';
 import {buildOptimisticNextStep} from '@libs/NextStepUtils';
@@ -190,6 +191,7 @@ import {
 import {buildOptimisticSnapshotData, getCurrentSearchQueryJSON} from '@libs/SearchQueryUtils';
 import playSound, {SOUNDS} from '@libs/Sound';
 import {startSendMessagePhase} from '@libs/telemetry/sendMessageSpans';
+import {doesDeleteNavigateBackUrlIncludeDuplicatesReview} from '@libs/TransactionNavigationUtils';
 import {
     getAmount,
     getCurrency,
@@ -7273,14 +7275,41 @@ function downloadReportPDF(fileName: string, reportName: string, translate: Loca
     fileDownload(translate, addEncryptedAuthTokenToURL(pdfURL, encryptedAuthToken, true), downloadFileName, '', Browser.isMobileSafari()).then(() => setDownload(fileName, false));
 }
 
+// Read when the clear fires, since the unmounting screen may not have the value yet.
+let deleteTransactionNavigateBackUrl: string | undefined;
+// A newer deletion cancels this so a stale clear can't wipe its URL.
+let pendingDeleteTransactionNavigateBackUrlClear: {cancel: () => void} | undefined;
+Onyx.connectWithoutView({
+    key: ONYXKEYS.NVP_DELETE_TRANSACTION_NAVIGATE_BACK_URL,
+    callback: (value) => {
+        deleteTransactionNavigateBackUrl = value;
+    },
+});
+
 function setDeleteTransactionNavigateBackUrl(url: string) {
+    pendingDeleteTransactionNavigateBackUrlClear?.cancel();
+    pendingDeleteTransactionNavigateBackUrlClear = undefined;
     Onyx.set(ONYXKEYS.NVP_DELETE_TRANSACTION_NAVIGATE_BACK_URL, url);
 }
 
 function clearDeleteTransactionNavigateBackUrl() {
     Onyx.merge(ONYXKEYS.NVP_DELETE_TRANSACTION_NAVIGATE_BACK_URL, null);
 }
 
+function clearDeleteTransactionNavigateBackUrlAfterTransitions() {
+    pendingDeleteTransactionNavigateBackUrlClear?.cancel();
+    pendingDeleteTransactionNavigateBackUrlClear = TransitionTracker.runAfterTransitions({
+        callback: () => {
+            pendingDeleteTransactionNavigateBackUrlClear = undefined;
+            if (!deleteTransactionNavigateBackUrl || doesDeleteNavigateBackUrlIncludeDuplicatesReview(deleteTransactionNavigateBackUrl)) {
+                return;
+            }
+            requestAnimationFrame(clearDeleteTransactionNavigateBackUrl);
+        },
+        waitForUpcomingTransition: true,
+    });
+}
+
 type DeleteAppReportProps = {
     report: OnyxEntry<Report>;
     reportActions: OnyxEntry<ReportActions>;
@@ -9371,6 +9400,7 @@ export {
     clearAddRoomMemberError,
     clearAvatarErrors,
     clearDeleteTransactionNavigateBackUrl,
+    clearDeleteTransactionNavigateBackUrlAfterTransitions,
     clearIOUError,
     clearNewRoomFormError,
     setNewRoomFormLoading,

src/pages/Search/SearchMoneyRequestReportPage.tsx

@@ -42,7 +42,13 @@ import ReactionListWrapper from '@pages/inbox/ReactionListWrapper';
 import {ReportActionEditMessageContextProvider} from '@pages/inbox/report/ReportActionEditMessageContext';
 import useClearReportActionDraftsOnReportChange from '@pages/inbox/report/useClearReportActionDraftsOnReportChange';
 
-import {clearDeleteTransactionNavigateBackUrl, createTransactionThreadReport, openReport, updateLastVisitTime} from '@userActions/Report';
+import {
+    clearDeleteTransactionNavigateBackUrl,
+    clearDeleteTransactionNavigateBackUrlAfterTransitions,
+    createTransactionThreadReport,
+    openReport,
+    updateLastVisitTime,
+} from '@userActions/Report';
 
 import CONST from '@src/CONST';
 import ONYXKEYS from '@src/ONYXKEYS';
@@ -125,6 +131,8 @@ function SearchMoneyRequestReportPage({route}: SearchMoneyRequestPageProps) {
         return () => handle.cancel();
     }, [isFocused, deleteTransactionNavigateBackUrl]);
 
+    useEffect(() => () => clearDeleteTransactionNavigateBackUrlAfterTransitions(), []);
+
     const [reportLoadingState = defaultReportLoadingState] = useOnyx(`${ONYXKEYS.COLLECTION.RAM_ONLY_REPORT_LOADING_STATE}${reportIDFromRoute}`);
     const [isLoadingApp] = useOnyx(ONYXKEYS.IS_LOADING_APP);
     const isReportArchived = useReportIsArchived(report?.reportID);

src/pages/inbox/DeleteTransactionNavigateBackHandler.tsx

@@ -3,7 +3,7 @@ import useOnyx from '@hooks/useOnyx';
 import TransitionTracker from '@libs/Navigation/TransitionTracker';
 import {doesDeleteNavigateBackUrlIncludeDuplicatesReview} from '@libs/TransactionNavigationUtils';
 
-import {clearDeleteTransactionNavigateBackUrl} from '@userActions/Report';
+import {clearDeleteTransactionNavigateBackUrl, clearDeleteTransactionNavigateBackUrlAfterTransitions} from '@userActions/Report';
 
 import ONYXKEYS from '@src/ONYXKEYS';
 
@@ -36,6 +36,9 @@ function DeleteTransactionNavigateBackHandler() {
         return () => handle.cancel();
     }, [isFocused, deleteTransactionNavigateBackUrl]);
 
+    // Native stack never renders a popped screen unfocused, so also clear on unmount.
+    useEffect(() => () => clearDeleteTransactionNavigateBackUrlAfterTransitions(), []);
+
     return null;
 }
 

tests/ui/SearchMoneyRequestReportPageTest.tsx

@@ -73,6 +73,7 @@ jest.mock('@userActions/Report', () => ({
     openReport: jest.fn(),
     updateLastVisitTime: jest.fn(),
     clearDeleteTransactionNavigateBackUrl: jest.fn(),
+    clearDeleteTransactionNavigateBackUrlAfterTransitions: jest.fn(),
 }));
 
 // All child components are mocked to null: none of them need to actually render for these tests,

tests/unit/DeleteTransactionNavigateBackHandlerTest.tsx

@@ -0,0 +1,132 @@
+import {render} from '@testing-library/react-native';
+
+import TransitionTracker from '@libs/Navigation/TransitionTracker';
+
+import DeleteTransactionNavigateBackHandler from '@pages/inbox/DeleteTransactionNavigateBackHandler';
+
+import {setDeleteTransactionNavigateBackUrl} from '@userActions/Report';
+
+import ONYXKEYS from '@src/ONYXKEYS';
+
+import type * as Navigation from '@react-navigation/native';
+
+import Onyx from 'react-native-onyx';
+
+import waitForBatchedUpdates from '../utils/waitForBatchedUpdates';
+
+jest.mock('@react-navigation/native', () => ({
+    ...jest.requireActual<typeof Navigation>('@react-navigation/native'),
+    useIsFocused: jest.fn(() => true),
+}));
+
+jest.mock('@libs/Navigation/TransitionTracker', () => ({
+    runAfterTransitions: jest.fn(({callback}: {callback: () => void}) => {
+        callback();
+        return {cancel: jest.fn()};
+    }),
+}));
+
+const REPORT_URL = 'r/123';
+const NEXT_REPORT_URL = 'r/456';
+const DUPLICATES_REVIEW_URL = 'r/123/duplicates/review';
+
+async function flushClear() {
+    await waitForBatchedUpdates();
+    await new Promise<void>((resolve) => {
+        requestAnimationFrame(() => resolve());
+    });
+    await waitForBatchedUpdates();
+}
+
+async function getNavigateBackUrl() {
+    return new Promise<string | undefined>((resolve) => {
+        const connection = Onyx.connectWithoutView({
+            key: ONYXKEYS.NVP_DELETE_TRANSACTION_NAVIGATE_BACK_URL,
+            callback: (value) => {
+                Onyx.disconnect(connection);
+                resolve(value);
+            },
+        });
+    });
+}
+
+describe('DeleteTransactionNavigateBackHandler', () => {
+    beforeAll(() => {
+        Onyx.init({keys: ONYXKEYS});
+    });
+
+    beforeEach(async () => {
+        await Onyx.clear();
+        await waitForBatchedUpdates();
+    });
+
+    it('clears the navigate back URL when the focused screen unmounts', async () => {
+        // Given a focused expense screen that was just deleted, so the URL is set while it is still focused
+        const {unmount} = render(<DeleteTransactionNavigateBackHandler />);
+        await Onyx.set(ONYXKEYS.NVP_DELETE_TRANSACTION_NAVIGATE_BACK_URL, REPORT_URL);
+        await waitForBatchedUpdates();
+
+        // When the native stack pops it, it unmounts without ever rendering unfocused
+        unmount();
+        await flushClear();
+
+        // Then the URL is cleared so it does not leak into the next expense
+        expect(await getNavigateBackUrl()).toBeUndefined();
+    });
+
+    it('keeps the navigate back URL while the screen stays focused', async () => {
+        // Given a focused expense screen with the URL set
+        render(<DeleteTransactionNavigateBackHandler />);
+        await Onyx.set(ONYXKEYS.NVP_DELETE_TRANSACTION_NAVIGATE_BACK_URL, REPORT_URL);
+
+        // When nothing navigates away
+        await flushClear();
+
+        // Then the URL stays, so the deleted expense does not flash Not Found before the pop
+        expect(await getNavigateBackUrl()).toBe(REPORT_URL);
+    });
+
+    it('keeps the duplicates review URL when the screen unmounts', async () => {
+        // Given a focused screen whose URL points to duplicates review, which clears the URL by itself
+        const {unmount} = render(<DeleteTransactionNavigateBackHandler />);
+        await Onyx.set(ONYXKEYS.NVP_DELETE_TRANSACTION_NAVIGATE_BACK_URL, DUPLICATES_REVIEW_URL);
+        await waitForBatchedUpdates();
+
+        // When the screen unmounts
+        unmount();
+        await flushClear();
+
+        // Then the URL is left for the duplicates review flow
+        expect(await getNavigateBackUrl()).toBe(DUPLICATES_REVIEW_URL);
+    });
+
+    it('does not clear a newer deletion URL from a remount clear that is still waiting', async () => {
+        // Given a screen that remounts without a deletion, so its clear waits for a later transition
+        let pendingCallback: (() => void) | undefined;
+        let isCancelled = false;
+        jest.mocked(TransitionTracker.runAfterTransitions).mockImplementationOnce(({callback}) => {
+            pendingCallback = () => {
+                callback();
+            };
+            return {
+                cancel: () => {
+                    isCancelled = true;
+                },
+            };
+        });
+        const {unmount} = render(<DeleteTransactionNavigateBackHandler />);
+        unmount();
+
+        // When the next expense is deleted before that transition finishes
+        setDeleteTransactionNavigateBackUrl(NEXT_REPORT_URL);
+        await waitForBatchedUpdates();
+        if (!isCancelled) {
+            pendingCallback?.();
+        }
+        await flushClear();
+
+        // Then the stale clear is cancelled and the new URL stays until its own screen leaves
+        expect(isCancelled).toBe(true);
+        expect(await getNavigateBackUrl()).toBe(NEXT_REPORT_URL);
+    });
+});