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

fix: pushModal not dispatched in GoCardless linking #3515

Merged
merged 4 commits into from
Sep 28, 2024

Conversation

EtaoinWu
Copy link
Contributor

@EtaoinWu EtaoinWu commented Sep 27, 2024

Background

Multiple reports in Discord shows that the current master branch has issues with gocardless linking: mine, valerio's, aaarzan's, ROuGGy's among others. The symptom seems to be that, after a successful callback from GoCardless, Actual refuses to pop up the next step in the linking process, which is to select accounts to sync from. Server logs and browser console logs shows no anomaly.

Contribution

I tracked down the issue, and found that in gocardless.ts, the callback onSuccess only generates a pushModal action without sending it to dispatch:

_authorize(dispatch, upgradingAccountId, {
  onSuccess: async data => {
    pushModal('select-linked-accounts', {
      accounts: data.accounts,
      requisitionId: data.id,
      upgradingAccountId,
      syncSource: 'goCardless',
    });
  },
});

Therefore a SelectLinkedAccountsModal was never generated.

This was introduced in 420aad0 (#3413) two weeks ago. Latest release (v24.9.0) was not affected.

Next steps & help needed

I am unfortunately not a React dev, and lacks the environment or tool to build and test it. I hope that other contributors in this community can help verify my fix and resolve this issue.

@actual-github-bot actual-github-bot bot changed the title fix: pushModal not dispatched in GoCardless linking [WIP] fix: pushModal not dispatched in GoCardless linking Sep 27, 2024
Copy link
Contributor

coderabbitai bot commented Sep 27, 2024

Walkthrough

The pull request modifies the authorizeBank function in the gocardless.ts file. The primary change involves wrapping the pushModal function call within a dispatch function in the onSuccess callback. This adjustment ensures that the modal dispatch adheres to the Redux action flow while maintaining the same parameters for pushModal.

Changes

File Path Change Summary
packages/desktop-client/src/gocardless.ts Modified the authorizeBank function to wrap the pushModal call in a dispatch function.

Suggested reviewers

  • MatissJanis

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 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

netlify bot commented Sep 27, 2024

Deploy Preview for actualbudget ready!

Name Link
🔨 Latest commit d781eea
🔍 Latest deploy log https://app.netlify.com/sites/actualbudget/deploys/66f81e4a28bd550008391c81
😎 Deploy Preview https://deploy-preview-3515.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 Sep 27, 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
9 5.29 MB → 5.29 MB (+10 B) +0.00%
Changeset
File Δ Size
src/gocardless.ts 📈 +10 B (+1.04%) 962 B → 972 B
View detailed bundle breakdown

Added

No assets were added

Removed

No assets were removed

Bigger

Asset File Size % Changed
static/js/index.js 3.31 MB → 3.31 MB (+10 B) +0.00%

Smaller

No assets were smaller

Unchanged

Asset File Size % Changed
static/js/AppliedFilters.js 20.97 kB 0%
static/js/indexeddb-main-thread-worker-e59fee74.js 13.5 kB 0%
static/js/usePreviewTransactions.js 1.64 kB 0%
static/js/resize-observer.js 18.37 kB 0%
static/js/BackgroundImage.js 122.29 kB 0%
static/js/narrow.js 82.1 kB 0%
static/js/wide.js 225.27 kB 0%
static/js/ReportRouter.js 1.5 MB 0%

Copy link
Contributor

github-actions bot commented Sep 27, 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.19 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.19 MB 0%

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/gocardless.ts (1)

Line range hint 1-55: Suggestions for improving the overall code quality

While the main issue has been addressed, consider the following improvements to enhance the code quality and maintainability:

  1. Enhance error handling in the onMoveExternal callback. Currently, it only returns the error response without any specific error handling or logging.

  2. Consider making the accessValidForDays parameter configurable instead of hardcoding it to 90 days. This could be done by accepting it as an optional parameter in the authorizeBank function.

  3. Add comments to explain the purpose of functions and any complex logic, especially for the _authorize function and its callbacks.

  4. Consider adding type annotations for the data parameter in the onSuccess callback of the authorizeBank function to improve type safety.

Here's an example of how you could implement some of these suggestions:

import { type Dispatch } from 'loot-core/client/actions/types';
import { pushModal } from 'loot-core/src/client/actions/modals';
import { send } from 'loot-core/src/platform/client/fetch';
import { type GoCardlessToken } from 'loot-core/src/types/models';

// Helper function to handle GoCardless authorization process
function _authorize(
  dispatch: Dispatch,
  upgradingAccountId: string | undefined,
  {
    onSuccess,
    onClose,
    accessValidForDays = 90,
  }: {
    onSuccess: (data: GoCardlessToken) => Promise<void>;
    onClose?: () => void;
    accessValidForDays?: number;
  },
) {
  dispatch(
    pushModal('gocardless-external-msg', {
      onMoveExternal: async ({ institutionId }) => {
        try {
          const resp = await send('gocardless-create-web-token', {
            upgradingAccountId,
            institutionId,
            accessValidForDays,
          });

          if ('error' in resp) {
            console.error('Error creating web token:', resp.error);
            return resp;
          }

          const { link, requisitionId } = resp;
          window.Actual?.openURLInBrowser(link);

          return send('gocardless-poll-web-token', {
            upgradingAccountId,
            requisitionId,
          });
        } catch (error) {
          console.error('Error in onMoveExternal:', error);
          throw error;
        }
      },

      onClose,
      onSuccess,
    }),
  );
}

// Main function to initiate GoCardless bank authorization
export async function authorizeBank(
  dispatch: Dispatch,
  { 
    upgradingAccountId,
    accessValidForDays = 90,
  }: { 
    upgradingAccountId?: string;
    accessValidForDays?: number;
  } = {},
) {
  _authorize(dispatch, upgradingAccountId, {
    onSuccess: async (data: GoCardlessToken) => {
      dispatch(
        pushModal('select-linked-accounts', {
          accounts: data.accounts,
          requisitionId: data.id,
          upgradingAccountId,
          syncSource: 'goCardless',
        }),
      );
    },
    accessValidForDays,
  });
}

These changes improve error handling, make the accessValidForDays parameter configurable, add comments for clarity, and improve type safety.

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Files that changed from the base of the PR and between 6725d56 and 20b55f4.

📒 Files selected for processing (1)
  • packages/desktop-client/src/gocardless.ts (1 hunks)
🔇 Additional comments (1)
packages/desktop-client/src/gocardless.ts (1)

48-55: LGTM! This change addresses the reported issue.

The modification correctly wraps the pushModal call with a dispatch function, which should resolve the issue of the modal not being displayed after a successful GoCardless callback. This change aligns with Redux patterns and maintains the existing functionality by keeping the same parameters for pushModal.

To ensure this fix resolves the issue completely, please run the following verification steps:

  1. Test the GoCardless linking process end-to-end.
  2. Verify that the SelectLinkedAccountsModal is displayed after a successful callback from GoCardless.
  3. Check the Redux DevTools (if available) to confirm that the pushModal action is correctly dispatched.

If possible, it would be beneficial to add or update unit tests to cover this scenario and prevent regression.

@EtaoinWu EtaoinWu force-pushed the gocardless-link-dispatch-fix branch from 20b55f4 to ab78b1c Compare September 27, 2024 07:17
@joel-jeremy
Copy link
Contributor

@EtaoinWu Nice catch! Thank you for this PR. Can you please add a release note so we can get this in? :)

@EtaoinWu EtaoinWu changed the title [WIP] fix: pushModal not dispatched in GoCardless linking fix: pushModal not dispatched in GoCardless linking Sep 27, 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 getting to the bottom of this! Definitely a good catch before the next release.

Will merge after #3526 so the build pipeline succeeds

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.

3 participants