Skip to content

Remove Onyx.connect() key ONYXKEYS.COLLECTION.REPORT_ACTIONS in src/libs/OptionsListUtils.ts - part 5#92330

Open
truph01 wants to merge 23 commits into
Expensify:mainfrom
truph01:fix/66381-part-5
Open

Remove Onyx.connect() key ONYXKEYS.COLLECTION.REPORT_ACTIONS in src/libs/OptionsListUtils.ts - part 5#92330
truph01 wants to merge 23 commits into
Expensify:mainfrom
truph01:fix/66381-part-5

Conversation

@truph01

@truph01 truph01 commented Jun 2, 2026

Copy link
Copy Markdown
Contributor

Explanation of Change

This is the 5th PR in the migration of Onyx.connect() for ONYXKEYS.COLLECTION.REPORT_ACTIONS in OptionsListUtils. It refactors:

  1. getLastMessageTextForReport -> createOption -> getReportOption
  2. getLastMessageTextForReport -> createOption -> getReportDisplayOption

Fixed Issues

$ #66381
PROPOSAL:

Tests

  1. Open ND
  2. Click Search icon in top right
  3. Verify the recent reports are displayed correctly.
  • Verify that no errors appear in the JS console

Offline tests

QA Steps

// TODO: These must be filled out, or the issue title must include ""[No QA].""

  • Verify that no errors appear in the JS console

PR Author Checklist

  • I linked the correct issue in the ### Fixed Issues section above
  • I wrote clear testing steps that cover the changes made in this PR
    • I added steps for local testing in the Tests section
    • I added steps for the expected offline behavior in the Offline steps section
    • I added steps for Staging and/or Production testing in the QA steps section
    • I added steps to cover failure scenarios (i.e. verify an input displays the correct error message if the entered data is not correct)
    • I turned off my network connection and tested it while offline to ensure it matches the expected behavior (i.e. verify the default avatar icon is displayed if app is offline)
    • I tested this PR with a High Traffic account against the staging or production API to ensure there are no regressions (e.g. long loading states that impact usability).
  • I included screenshots or videos for tests on all platforms
  • I ran the tests on all platforms & verified they passed on:
    • Android: Native
    • Android: mWeb Chrome
    • iOS: Native
    • iOS: mWeb Safari
    • MacOS: Chrome / Safari
  • I verified there are no console errors (if there's a console error not related to the PR, report it or open an issue for it to be fixed)
  • I verified there are no new alerts related to the canBeMissing param for useOnyx
  • I followed proper code patterns (see Reviewing the code)
    • I verified that any callback methods that were added or modified are named for what the method does and never what callback they handle (i.e. toggleReport and not onIconClick)
    • I verified that comments were added to code that is not self explanatory
    • I verified that any new or modified comments were clear, correct English, and explained ""why"" the code was doing something instead of only explaining ""what"" the code was doing.
    • I verified any copy / text shown in the product is localized by adding it to src/languages/* files and using the translation method
      • If any non-english text was added/modified, I used JaimeGPT to get English > Spanish translation. I then posted it in #expensify-open-source and it was approved by an internal Expensify engineer. Link to Slack message:
    • I verified all numbers, amounts, dates and phone numbers shown in the product are using the localization methods
    • I verified any copy / text that was added to the app is grammatically correct in English. It adheres to proper capitalization guidelines (note: only the first word of header/labels should be capitalized), and is either coming verbatim from figma or has been approved by marketing (in order to get marketing approval, ask the Bug Zero team member to add the Waiting for copy label to the issue)
    • I verified proper file naming conventions were followed for any new files or renamed files. All non-platform specific files are named after what they export and are not named ""index.js"". All platform-specific files are named for the platform the code supports as outlined in the README.
    • I verified the JSDocs style guidelines (in STYLE.md) were followed
  • If a new code pattern is added I verified it was agreed to be used by multiple Expensify engineers
  • I followed the guidelines as stated in the Review Guidelines
  • I tested other components that can be impacted by my changes (i.e. if the PR modifies a shared library or component like Avatar, I verified the components using Avatar are working as expected)
  • I verified all code is DRY (the PR doesn't include any logic written more than once, with the exception of tests)
  • I verified any variables that can be defined as constants (ie. in CONST.ts or at the top of the file that uses the constant) are defined as such
  • I verified that if a function's arguments changed that all usages have also been updated correctly
  • If any new file was added I verified that:
    • The file has a description of what it does and/or why is needed at the top of the file if the code is not self explanatory
  • If a new CSS style is added I verified that:
    • A similar style doesn't already exist
    • The style can't be created with an existing StyleUtils function (i.e. StyleUtils.getBackgroundAndBorderStyle(theme.componentBG))
  • If new assets were added or existing ones were modified, I verified that:
    • The assets are optimized and compressed (for SVG files, run npm run compress-svg)
    • The assets load correctly across all supported platforms.
  • If the PR modifies code that runs when editing or sending messages, I tested and verified there is no unexpected behavior for all supported markdown - URLs, single line code, code blocks, quotes, headings, bold, strikethrough, and italic.
  • If the PR modifies a generic component, I tested and verified that those changes do not break usages of that component in the rest of the App (i.e. if a shared library or component like Avatar is modified, I verified that Avatar is working as expected in all cases)
  • If the PR modifies a component related to any of the existing Storybook stories, I tested and verified all stories for that component are still working as expected.
  • If the PR modifies a component or page that can be accessed by a direct deeplink, I verified that the code functions as expected when the deeplink is used - from a logged in and logged out account.
  • If the PR modifies the UI (e.g. new buttons, new UI components, changing the padding/spacing/sizing, moving components, etc) or modifies the form input styles:
    • I verified that all the inputs inside a form are aligned with each other.
    • I added Design label and/or tagged @Expensify/design so the design team can review the changes.
  • If a new page is added, I verified it's using the ScrollView component to make it scrollable when more elements are added to the page.
  • I added unit tests for any new feature or bug fix in this PR to help automatically prevent regressions in this user flow.
  • If the main branch was merged into this PR after a review, I tested again and verified the outcome was still expected according to the Test steps.

Screenshots/Videos

Android: Native
Android: mWeb Chrome
iOS: Native
iOS: mWeb Safari
MacOS: Chrome / Safari

@codecov

codecov Bot commented Jun 2, 2026

Copy link
Copy Markdown

Codecov Report

✅ Changes either increased or maintained existing code coverage, great job!

Files with missing lines Coverage Δ
src/hooks/useRelevantSortedActions.ts 100.00% <100.00%> (ø)
src/libs/OptionsListUtils/index.ts 86.89% <ø> (ø)
src/pages/Share/SubmitDetailsPage.tsx 87.50% <100.00%> (+0.14%) ⬆️
...es/iou/request/step/IOURequestStepConfirmation.tsx 64.85% <100.00%> (+0.20%) ⬆️
src/pages/Share/ShareDetailsPage.tsx 0.00% <0.00%> (ø)
... and 10 files with indirect coverage changes

@truph01
truph01 marked this pull request as ready for review June 2, 2026 09:56
@truph01
truph01 requested review from a team as code owners June 2, 2026 09:56
@melvin-bot
melvin-bot Bot requested review from DylanDylann and heyjennahay and removed request for a team June 2, 2026 09:56
@melvin-bot

melvin-bot Bot commented Jun 2, 2026

Copy link
Copy Markdown

@DylanDylann Please copy/paste the Reviewer Checklist from here into a new comment on this PR and complete it. If you have the K2 extension, you can simply click: [this button]

@melvin-bot
melvin-bot Bot requested review from a team and grgia and removed request for a team June 2, 2026 09:56
@melvin-bot

melvin-bot Bot commented Jun 2, 2026

Copy link
Copy Markdown

@grgia Please copy/paste the Reviewer Checklist from here into a new comment on this PR and complete it. If you have the K2 extension, you can simply click: [this button]

grgia
grgia previously approved these changes Jun 4, 2026

@grgia grgia left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no code blockers, building test

@github-actions

github-actions Bot commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

🚧 @grgia has triggered a test Expensify/App build. You can view the workflow run here.

@github-actions

github-actions Bot commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

🧪🧪 Use the links below to test this adhoc build on Android, iOS, and Web. Happy testing! 🧪🧪
Built from App PR #92330.

Android 🤖 iOS 🍎
⏩ SKIPPED ⏩ ⏩ SKIPPED ⏩
The build for Android was skipped The build for iOS was skipped
Web 🕸️
https://92330.pr-testing.expensify.com
Web

👀 View the workflow run that generated this build 👀

@DylanDylann

Copy link
Copy Markdown
Contributor

Let's wait until #92308 is merged

@truph01

truph01 commented Jun 10, 2026

Copy link
Copy Markdown
Contributor Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 4b618c6785

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

participantReportDraft,
undefined,
undefined,
sortedActions,

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Add sortedActions to memo dependencies

When the confirmation screen is already mounted and useSortedActions() later publishes updated report actions (for example after a report preview/expense action changes while the user is on this step), this memoized participant list keeps using the old sortedActions value because it is not in the dependency array below. That leaves the participant option/preview text stale until some unrelated dependency changes or the screen remounts, which defeats the new data path being passed into getReportOption.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add sortedActions to deps

grgia
grgia previously approved these changes Jun 10, 2026
@truph01

truph01 commented Jun 24, 2026

Copy link
Copy Markdown
Contributor Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a2f965fa00

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread src/pages/Share/SubmitDetailsPage.tsx Outdated
useShareFileSizeValidation(currentReceiptSource, setErrorTitle, setErrorMessage, !errorTitle);

const selectedParticipants = unknownUserDetails ? [unknownUserDetails] : getMoneyRequestParticipantsFromReport(report, currentUserPersonalDetails.accountID);
const participantReportIDs = selectedParticipants.map((participant) => participant.reportID).filter(Boolean);

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Memoize report IDs passed to the hook

In the share-submit flow this array is rebuilt on every render, but useRelevantSortedActions memoizes its Onyx selector on the array identity and explicitly requires callers to pass a stable reference. When this page re-renders while editing the receipt/comment or receiving Onyx updates on a high-traffic account, it recreates the selector/subscription to RAM_ONLY_SORTED_REPORT_ACTIONS, so this path still pays the expensive derived-action selection work the migration is trying to avoid. Please wrap the selected participants and/or mapped IDs in useMemo, as the IOU confirmation path does.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Resolved

@truph01

truph01 commented Jun 24, 2026

Copy link
Copy Markdown
Contributor Author

@DylanDylann All good now!

grgia
grgia previously approved these changes Jun 25, 2026
@DylanDylann

Copy link
Copy Markdown
Contributor

@truph01 Could you verify again whether we actually need to pass sortedActions in these places?

@DylanDylann

Copy link
Copy Markdown
Contributor

@MelvinBot Please review this PR and let me know if we need to pass sortActions in these places and please explain why do we need to pass them or not

@truph01

truph01 commented Jun 29, 2026

Copy link
Copy Markdown
Contributor Author

@truph01 Could you verify again whether we actually need to pass sortedActions in these places?

@DylanDylann We still need to pass sortedActions, but I've introduced selector useRelevantSortedActions to reduce the size of sortedActions based on #92330 (comment)

@DylanDylann

Copy link
Copy Markdown
Contributor

Ex: At SubmitDetailsPage, passing sortedActions into getReportOption has no observable effect:

  1. getReportOption → createOption is called with showChatPreviewLine: false. Inside createOption, sortedActions only influences result.lastMessageText and result.alternateText (via getAlternateText).
  2. With showChatPreviewLine: false, every branch in getAlternateText takes the fallback and never the sortedActions-derived last-message text, so alternateText doesn't depend on it.
  3. getReportOption then overwrites text and alternateText in all branches anyway, discarding whatever createOption produced.
  4. That leaves only lastMessageText, which isn't read here, the participants array goes to MoneyRequestConfirmationList, and neither that component (nor its footer/subcomponents) nor this page references lastMessageText

So passing sortedActions vs undefined yields an identical UI

@truph01

truph01 commented Jun 29, 2026

Copy link
Copy Markdown
Contributor Author

@MelvinBot What do you think about #92330 (comment)?

@truph01

truph01 commented Jun 29, 2026

Copy link
Copy Markdown
Contributor Author

Ex: At SubmitDetailsPage, passing sortedActions into getReportOption has no observable effect:

@DylanDylann I agree that we can stop passing sortedActions to getReportOption in SubmitDetailsPage.tsx because:

So passing sortedActions vs undefined yields an identical UI

But if getReportOption is updated later and sortedActions becomes required, how can we ensure the author making that change is aware that sortedActions also needs to be passed back on this page?

@DylanDylann

Copy link
Copy Markdown
Contributor

We can update the type to | undefined and pass undefined in the cases where it's not needed

@grgia grgia left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@truph01 do we need sortedActions at the two getReportOption sites? Could we use the useRelevantSortedActions?

Seems SubmitDetailsPage and IOURequestStepConfirmation gain a useRelevantSortedActions subscription whose result is discarded, adding re-renders for nothing

@DylanDylann

Copy link
Copy Markdown
Contributor

@truph01 Let's hold off on this PR for a bit. I want to double check everything to make sure our approach is the best option and doesn't cause any performance regressions.

@DylanDylann

Copy link
Copy Markdown
Contributor

@truph01 Using selector looks ok, please continue updating this comment? #92330 (comment)

Comment on lines +35 to +39
for (const action of reportActions) {
if (!isReportPreviewAction(action)) {
continue;
}
const iouReportID = getIOUReportIDFromReportActionPreview(action);

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

but this scan includes every REPORT_PREVIEW in the chat's history, so on a workspace chat the confirmation page subscribes to every linked expense report and re-renders whenever any of them changes.

Since sortedActions is newest-first, can we break after the first preview with pendingAction !== DELETE?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@grgia Just checking pendingAction !== DELETE wouldn't be enough here — getLatestVisibleMoneyRequestAction (used downstream in getReportOption) also filters on isMoneyRequestAction and isReportActionVisible

@grgia

grgia commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

@truph01 would you please add WIP to the title while you update

@grgia grgia changed the title Remove Onyx.connect() key ONYXKEYS.COLLECTION.REPORT_ACTIONS in src/libs/OptionsListUtils.ts - part 5 [WIP] Remove Onyx.connect() key ONYXKEYS.COLLECTION.REPORT_ACTIONS in src/libs/OptionsListUtils.ts - part 5 Jul 17, 2026
@truph01

truph01 commented Jul 18, 2026

Copy link
Copy Markdown
Contributor Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: a7c0055623

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread src/pages/Share/SubmitDetailsPage.tsx Outdated
useShareFileSizeValidation(currentReceiptSource, setErrorTitle, setErrorMessage, !errorTitle);

const selectedParticipants = unknownUserDetails ? [unknownUserDetails] : getMoneyRequestParticipantsFromReport(report, currentUserPersonalDetails.accountID);
const participantReportIDs = selectedParticipants.map((participant) => participant.reportID).filter(Boolean);

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Memoize participant report IDs before subscribing

participantReportIDs is rebuilt on every render, despite useRelevantSortedActions requiring a referentially stable array. Consequently, any unrelated state or Onyx update in this receipt-submission screen recreates the selector passed to useOnyx and renews its subscription to the global sorted-actions derived value, defeating the targeted-subscription optimization and causing avoidable work while users edit the submission.

Useful? React with 👍 / 👎.

@truph01

truph01 commented Jul 18, 2026

Copy link
Copy Markdown
Contributor Author

Ex: At SubmitDetailsPage, passing sortedActions into getReportOption has no observable effect:

  1. getReportOption → createOption is called with showChatPreviewLine: false. Inside createOption, sortedActions only influences result.lastMessageText and result.alternateText (via getAlternateText).
  2. With showChatPreviewLine: false, every branch in getAlternateText takes the fallback and never the sortedActions-derived last-message text, so alternateText doesn't depend on it.
  3. getReportOption then overwrites text and alternateText in all branches anyway, discarding whatever createOption produced.
  4. That leaves only lastMessageText, which isn't read here, the participants array goes to MoneyRequestConfirmationList, and neither that component (nor its footer/subcomponents) nor this page references lastMessageText

So passing sortedActions vs undefined yields an identical UI

@DylanDylann @grgia I don't think this is a good pattern — it couples callers to the function's internal implementation. For example:

function calculate(a: number, b: number) {
  if (a === 1) return a;
  if (b === 2) return b;
  // ... 10 more branches using b
  if (b === 99) return b;
}

Knowing that a === 1 short-circuits today, a caller might skip computing b. But if calculate later changes to use b in that branch too, the caller silently breaks. Callers shouldn't reverse-engineer which internal paths will execute — if the function accepts the param, provide it.

Anyway, we already reduced the size of the reportActions via useRelevantSortedActions.

@truph01 truph01 changed the title [WIP] Remove Onyx.connect() key ONYXKEYS.COLLECTION.REPORT_ACTIONS in src/libs/OptionsListUtils.ts - part 5 Remove Onyx.connect() key ONYXKEYS.COLLECTION.REPORT_ACTIONS in src/libs/OptionsListUtils.ts - part 5 Jul 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants