Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add option to unmark imported transactions #3810

Open
wants to merge 2 commits into
base: master
Choose a base branch
from

Conversation

csenel
Copy link

@csenel csenel commented Nov 9, 2024

Fixes: #3358

As described in the feature request, a tooltip was added for transactions after v24.9.0. However as someone who imports & exports budget files between servers, most of the historical transactions are marked as imported. Furthermore when you duplicate to create a new transaction, the imported payee field is also kept the same.

With this change, I have added an option to the transaction table to unmark imported transactions (set imported_payee field to empty string), which will disable the imported payee tooltip.

Please let me know how it looks. This is my first PR ever working on a typescript code base. Even though I have tested the functionality locally, it's likely that I might have missed some things.

@actual-github-bot actual-github-bot bot changed the title Add support to unmark imported transactions [WIP] Add support to unmark imported transactions Nov 9, 2024
Copy link

netlify bot commented Nov 9, 2024

Deploy Preview for actualbudget ready!

Name Link
🔨 Latest commit da7821f
🔍 Latest deploy log https://app.netlify.com/sites/actualbudget/deploys/6758c8af792c270008c6dca8
😎 Deploy Preview https://deploy-preview-3810.demo.actualbudget.org
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

Copy link
Contributor

github-actions bot commented Nov 9, 2024

Bundle Stats — desktop-client

Hey there, this message comes from a GitHub action that helps you and reviewers to understand how these changes affect the size of this project's bundle.

As this PR is updated, I'll keep you updated on how the bundle size is impacted.

Total

Files count Total bundle size % Changed
10 5.47 MB → 5.47 MB (+1.53 kB) +0.03%
Changeset
File Δ Size
src/components/transactions/SelectedTransactionsButton.tsx 📈 +746 B (+9.22%) 7.9 kB → 8.63 kB
src/components/accounts/Account.tsx 📈 +660 B (+1.44%) 44.63 kB → 45.27 kB
src/hooks/useTransactionBatchActions.ts 📈 +82 B (+1.03%) 7.74 kB → 7.82 kB
src/components/accounts/Header.tsx 📈 +80 B (+0.42%) 18.58 kB → 18.65 kB
View detailed bundle breakdown

Added

No assets were added

Removed

No assets were removed

Bigger

Asset File Size % Changed
static/js/wide.js 241.29 kB → 242.74 kB (+1.45 kB) +0.60%
static/js/index.js 3.45 MB → 3.45 MB (+82 B) +0.00%

Smaller

No assets were smaller

Unchanged

Asset File Size % Changed
static/js/resize-observer.js 18.37 kB 0%
static/js/useAccountPreviewTransactions.js 1.63 kB 0%
static/js/indexeddb-main-thread-worker-e59fee74.js 13.5 kB 0%
static/js/workbox-window.prod.es5.js 5.69 kB 0%
static/js/narrow.js 82.99 kB 0%
static/js/BackgroundImage.js 122.29 kB 0%
static/js/AppliedFilters.js 21.91 kB 0%
static/js/ReportRouter.js 1.52 MB 0%

Copy link
Contributor

github-actions bot commented Nov 9, 2024

Bundle Stats — loot-core

Hey there, this message comes from a GitHub action that helps you and reviewers to understand how these changes affect the size of this project's bundle.

As this PR is updated, I'll keep you updated on how the bundle size is impacted.

Total

Files count Total bundle size % Changed
1 1.32 MB 0%

Changeset

No files were changed

View detailed bundle breakdown

Added

No assets were added

Removed

No assets were removed

Bigger

No assets were bigger

Smaller

No assets were smaller

Unchanged

Asset File Size % Changed
kcab.worker.js 1.32 MB 0%

@csenel csenel changed the title [WIP] Add support to unmark imported transactions Add support to unmark imported transactions Nov 9, 2024
Copy link
Contributor

coderabbitai bot commented Nov 9, 2024

Warning

There were issues while running some tools. Please review the errors and either fix the tool’s configuration or disable the tool if it’s a critical failure.

🔧 eslint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

packages/desktop-client/src/components/accounts/Account.tsx

Oops! Something went wrong! :(

ESLint: 8.57.1

ESLint couldn't find the plugin "eslint-plugin-eslint-plugin".

(The package "eslint-plugin-eslint-plugin" was not found when loaded as a Node module from the directory "/packages/eslint-plugin-actual".)

It's likely that the plugin isn't installed correctly. Try reinstalling by running the following:

npm install eslint-plugin-eslint-plugin@latest --save-dev

The plugin "eslint-plugin-eslint-plugin" was referenced from the config file in "packages/eslint-plugin-actual/.eslintrc.js".

If you still can't figure out the problem, please stop by https://eslint.org/chat/help to chat with the team.

Walkthrough

The pull request introduces a new method, onUnmarkTransactionsAsImported, within the AccountInternal class, enabling the unmarking of transactions as imported based on their IDs. This method retrieves relevant transactions, checks for the imported_payee property, and updates the field accordingly. The method is integrated into the Account component's render method and passed as a prop to the AccountHeader component, enhancing the UI's functionality.

Additionally, the AccountHeaderProps type is updated to include the new property onUnmarkTransactionsAsImported, which is utilized in the SelectedTransactionsButton component. This component is modified to manage the unmarking action, including a new memoized function to evaluate the status of selected transactions. The useTransactionBatchActions hook is also updated to handle the imported_payee field, allowing for batch processing of transaction modifications. Overall, these changes enhance transaction management within the application.

Assessment against linked issues

Objective Addressed Explanation
Option to disable imported payee tooltip (#3358) The PR does not implement an option to disable the tooltip as requested.

Possibly related PRs

Suggested labels

:sparkles: Merged

Suggested reviewers

  • youngcw

Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Generate unit testing code for this file.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai generate unit testing code for this file.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and generate unit testing code.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR. (Experiment)
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 3

🧹 Outside diff range and nitpick comments (2)
packages/desktop-client/src/hooks/useTransactionBatchActions.ts (2)

117-120: Enhance comment and add validation for imported_payee.

While the implementation is correct, consider these improvements:

  1. Make the comment more specific about the impact: "Unmark as imported transaction by setting imported_payee to empty string, which removes the imported tooltip."
  2. Add validation to avoid unnecessary updates when the field is already empty.
 if (name === 'imported_payee') {
-  // Unmark as imported transaction by setting imported payee to empty string.
+  // Unmark as imported transaction by setting imported_payee to empty string,
+  // which removes the imported tooltip.
+  if (trans.imported_payee) {
     valueToSet = '';
+  }
 }

234-235: Consider architectural improvements for better UX.

While the implementation is solid, consider these architectural improvements:

  1. Add a confirmation dialog for bulk unmarking, similar to other batch operations
  2. Add this action to the transaction context menu for single-transaction operations
  3. Consider adding a bulk "Mark as imported" operation for symmetry

Would you like help implementing any of these suggestions?

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between 2b72b2f and 3764d09.

⛔ Files ignored due to path filters (1)
  • upcoming-release-notes/3810.md is excluded by !**/*.md
📒 Files selected for processing (4)
  • packages/desktop-client/src/components/accounts/Account.tsx (2 hunks)
  • packages/desktop-client/src/components/accounts/Header.tsx (3 hunks)
  • packages/desktop-client/src/components/transactions/SelectedTransactionsButton.tsx (5 hunks)
  • packages/desktop-client/src/hooks/useTransactionBatchActions.ts (2 hunks)
🧰 Additional context used
🪛 Biome
packages/desktop-client/src/components/transactions/SelectedTransactionsButton.tsx

[error] 158-158: Change to an optional chain.

Unsafe fix: Change to an optional chain.

(lint/complexity/useOptionalChain)

🔇 Additional comments (8)
packages/desktop-client/src/components/transactions/SelectedTransactionsButton.tsx (4)

42-42: LGTM: Prop type definition is well-structured.

The new prop follows the established naming conventions and type patterns in the codebase.


299-306: LGTM: Menu item is well-integrated.

The menu item is properly structured with:

  • Correct placement in the menu
  • Appropriate conditional rendering
  • Proper translation support

335-337: LGTM: Handler implementation is correct.

The new case in the switch statement follows the established pattern and correctly handles the unmark action.


Line range hint 1-361: Verify integration with imported transaction handling.

While the implementation looks good, let's verify the complete flow:

  1. Ensure this component receives the proper callback from its parent
  2. Confirm the tooltip is properly hidden when a transaction is unmarked
✅ Verification successful

Based on the search results, I can now provide a final response since I have enough information to verify the implementation:

Implementation is properly integrated and functional

The code shows proper integration of the unmark imported transactions feature:

  1. The SelectedTransactionsButton component correctly checks for imported transactions using imported_payee field
  2. The feature is properly connected through the component hierarchy:
    • Account.tsx implements the handler onUnmarkTransactionsAsImported
    • Header.tsx passes it down to child components
    • SelectedTransactionsButton.tsx exposes it in the menu when applicable

The implementation aligns with the user needs as it:

  • Only shows the option when there are imported transactions selected
  • Handles batch operations correctly
  • Properly integrates with the undo notification system
🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Check if the component is properly connected to handle imported transactions
echo "Checking parent components for proper prop passing..."
rg -l "onUnmarkTransactionsAsImported" --type ts --type tsx

# Verify tooltip implementation
echo "Checking tooltip implementation..."
rg "imported_payee.*tooltip" --type ts --type tsx

Length of output: 363


Script:

#!/bin/bash
# Let's try with correct file type flags and broader search patterns
echo "Checking parent components and handlers..."
rg -t typescript -t tsx "onUnmarkTransactionsAsImported"

echo -e "\nChecking tooltip and imported payee related code..."
rg -t typescript -t tsx "imported_payee"

echo -e "\nChecking transaction list component..."
rg -t typescript -t tsx "SelectedTransactionsButton.*props"

Length of output: 571


Script:

#!/bin/bash
# Search without file type flags since they're not recognized
echo "Checking parent components and handlers..."
rg "onUnmarkTransactionsAsImported"

echo -e "\nChecking imported payee related code..."
rg "imported_payee"

echo -e "\nChecking TransactionList component..."
fd "TransactionList" --exec cat {} \; 

Length of output: 43327

🧰 Tools
🪛 Biome

[error] 158-158: Change to an optional chain.

Unsafe fix: Change to an optional chain.

(lint/complexity/useOptionalChain)

packages/desktop-client/src/components/accounts/Header.tsx (3)

116-116: LGTM! Type definition is correctly added.

The onUnmarkTransactionsAsImported property is properly integrated into the AccountHeaderProps type definition, maintaining type safety by inheriting from the SelectedTransactionsButton component.


183-183: LGTM! Prop destructuring is properly implemented.

The onUnmarkTransactionsAsImported prop is correctly destructured from the component props, following the established pattern in the codebase.


372-372: LGTM! Prop is correctly passed to child component.

The onUnmarkTransactionsAsImported prop is properly passed to the SelectedTransactionsButton component, enabling the unmarking of imported transactions as intended.

Let's verify the integration with the SelectedTransactionsButton component:

✅ Verification successful

Prop is correctly integrated and handled in the SelectedTransactionsButton component

The verification confirms:

  • The prop is properly typed in SelectedTransactionsButton component's props interface
  • The prop is correctly destructured in the component parameters
  • The prop is properly invoked with selectedIds when needed
  • The implementation follows a complete chain from Account component through Header to SelectedTransactionsButton
🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Description: Verify the SelectedTransactionsButton component accepts and handles the new prop

# Test: Check if SelectedTransactionsButton component properly declares the prop
ast-grep --pattern 'type $_ = {
  $$$
  onUnmarkTransactionsAsImported?: $_
  $$$
}'

# Test: Check if the component implements the unmarking functionality
rg -A 5 'onUnmarkTransactionsAsImported'

Length of output: 5069

packages/desktop-client/src/components/accounts/Account.tsx (1)

1778-1780: LGTM!

The prop is correctly passed to the AccountHeader component, following the existing naming conventions and integration patterns.

@csenel csenel changed the title Add support to unmark imported transactions Add option to unmark imported transactions Nov 9, 2024
Copy link
Contributor

@matt-fidd matt-fidd left a comment

Choose a reason for hiding this comment

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

Thanks for this! Sorry it's taken a while to review
Looking to get it moving through now

Comment on lines +1140 to +1164
onUnmarkTransactionsAsImported = async (ids: string[]) => {
this.setState({ workingHard: true });

const { data } = await runQuery(
q('transactions')
.filter({ id: { $oneof: ids } })
.select('*')
.options({ splits: 'grouped' }),
);

const transactions: TransactionEntity[] = data;

if (!transactions || transactions.length === 0) {
return;
}

const importedTransactionIds = transactions
.filter(t => t.imported_payee)
.map(t => t.id);

this.onBatchEdit('imported_payee', importedTransactionIds);

this.refetchTransactions();
};

Copy link
Contributor

Choose a reason for hiding this comment

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

@joel-jeremy will know better than me on this, is this okay here or should it be moved to packages/desktop-client/src/hooks/useTransactionBatchActions.ts?

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

🧹 Outside diff range and nitpick comments (1)
packages/desktop-client/src/components/transactions/SelectedTransactionsButton.tsx (1)

150-161: Consider using optional chaining for better code style.

While the logic is correct, we can improve the code style by using optional chaining as recommended by the linter.

  const canUnmarkTransactionsAsImported = useMemo(() => {
    if (selectedIds.length === 0 || types.preview) {
      return false;
    }

    const transactions = selectedIds.map(id => getTransaction(id));

-   const areSomeImportedTransactions = transactions.some(
-     tx => tx && tx.imported_payee,
-   );
+   const areSomeImportedTransactions = transactions.some(
+     tx => tx?.imported_payee,
+   );
    return areSomeImportedTransactions;
  }, [selectedIds, types, getTransaction]);
🧰 Tools
🪛 Biome (1.9.4)

[error] 158-158: Change to an optional chain.

Unsafe fix: Change to an optional chain.

(lint/complexity/useOptionalChain)

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between 3764d09 and da7821f.

📒 Files selected for processing (4)
  • packages/desktop-client/src/components/accounts/Account.tsx (2 hunks)
  • packages/desktop-client/src/components/accounts/Header.tsx (3 hunks)
  • packages/desktop-client/src/components/transactions/SelectedTransactionsButton.tsx (5 hunks)
  • packages/desktop-client/src/hooks/useTransactionBatchActions.ts (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (2)
  • packages/desktop-client/src/hooks/useTransactionBatchActions.ts
  • packages/desktop-client/src/components/accounts/Header.tsx
🧰 Additional context used
📓 Learnings (1)
packages/desktop-client/src/components/transactions/SelectedTransactionsButton.tsx (1)
Learnt from: csenel
PR: actualbudget/actual#3810
File: packages/desktop-client/src/components/transactions/SelectedTransactionsButton.tsx:150-161
Timestamp: 2024-11-10T16:45:25.627Z
Learning: In `packages/desktop-client/src/components/transactions/SelectedTransactionsButton.tsx`, prefer to keep the implementation of checks consistent with similar patterns elsewhere in the codebase, even if alternative implementations are more concise.
🪛 Biome (1.9.4)
packages/desktop-client/src/components/transactions/SelectedTransactionsButton.tsx

[error] 158-158: Change to an optional chain.

Unsafe fix: Change to an optional chain.

(lint/complexity/useOptionalChain)

🔇 Additional comments (4)
packages/desktop-client/src/components/transactions/SelectedTransactionsButton.tsx (3)

42-42: LGTM!

The new prop type follows the established pattern for batch operations and has a clear, descriptive name.


59-59: LGTM!

The prop is correctly destructured and follows the alphabetical ordering convention.


299-306: LGTM!

The menu item and its handler are implemented consistently with other similar features in the component.

Also applies to: 335-337

packages/desktop-client/src/components/accounts/Account.tsx (1)

1140-1163: 🛠️ Refactor suggestion

Consider optimizing the implementation and adding error handling.

While the implementation works, there are several areas for improvement:

  1. Add error handling for database operations
  2. Reset the workingHard state after operations complete
  3. Optimize the query by filtering imported transactions at the database level
 onUnmarkTransactionsAsImported = async (ids: string[]) => {
   this.setState({ workingHard: true });
+  try {
     const { data } = await runQuery(
       q('transactions')
         .filter({
           id: { $oneof: ids },
+          imported_payee: { $ne: null }
         })
         .select('*')
         .options({ splits: 'grouped' }),
     );
 
     const transactions: TransactionEntity[] = data;
 
     if (!transactions || transactions.length === 0) {
+      this.setState({ workingHard: false });
       return;
     }
 
-    const importedTransactionIds = transactions
-      .filter(t => t.imported_payee)
-      .map(t => t.id);
+    const importedTransactionIds = transactions.map(t => t.id);
 
     this.onBatchEdit('imported_payee', importedTransactionIds);
 
     this.refetchTransactions();
+  } catch (error) {
+    console.error('Failed to unmark transactions as imported:', error);
+  } finally {
+    this.setState({ workingHard: false });
+  }
 };

Likely invalid or redundant comment.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[Feature]: Option to disable imported payee tooltip
2 participants