Node.js module to import a CSV file with transactions to BudgetBakers' Wallet.

Install the package using npm:

npm install wallet-budgetbakers-import

After installing, import it into your project:

import wallet from 'wallet-budgetbakers-import';

Importing a CSV file:

import wallet from 'wallet-budgetbakers-import';
try {
    await wallet.login('your-email@provider.com');
    const importRes = await wallet.importFile({
        file: 'path/to/file/2022-03-20T16-20.csv',
        importEmail: 'account-email@imports.budgetbakers.com'  
    });   
    console.log(importRes);    
} catch(err) {
    console.error(err);
}

The file with transactions must have the following format (date in ISO 8601):

date,note,income,expense
2023-03-15T10:30:00.000Z,Supermarket,0,1.99
2023-03-07T15:00:00.000Z,Income,200.00,0

Logs in with a Wallet account e-mail.

wallet.login('your-email@provider.com');

In order to validate the login process, the module will prompt the user to enter the link or SSO token that is sent to their e-mail. The authenticated session is stored locally in cookies.json and reused on later runs until the session expires server-side.

Retrieves an array of imported files.

wallet.getImports('-Account_00000000-0000-0000-0000-000000000000');

By providing an account id, the result will be filtered accordingly. This id can be found in the URL, when navigating to the account detail, in Wallet's web app.

Imports a CSV file.

wallet.importFile({
    file: 'path/to/file/2022-03-20T16-20.csv',
    importEmail: 'account-email@imports.budgetbakers.com',
    accountId: '-Account_00000000-0000-0000-0000-000000000000',
    newRecordsOnly: false,
    processImport: true
}); 

The following is a list of the available configuration values: