Add ignore patterns, remove Bun

Author: NikxDa

README.md

@@ -61,12 +61,29 @@ A short summary:
 
 Once you have configured your importer, run `actual-monmon verify` to verify that the configuration has the correct format.
 
-**Usage**
+## Usage
 
 Once configured, importing is as simple as running `actual-monmon import`. Make sure that the Actual servers are running and that MoneyMoney is unlocked. By default, the importer will import 1 month worth of transactions. You can override this by passing the `--from` property, like so: `actual-monmon import --from=2024-01-01`.
 
 The importer will not track previous imports, so if you wait more than one month between imports, you might need to manually specify the last import date. Running the importer twice in the same month is no problem, as duplicate transactions will automatically be detected and skipped.
 
-**Bugs**
+## Advanced Configuration
 
-If there are any bugs or issues, please file an issue.
+The following configuration options can optionally be added
+
+### Ignore patterns
+
+Ignore patterns allow you to specify payee names, comments, or purposes which should be ignored. *Note:* Currently, the strings are treated as is, meaning they are case-sensitive, and will be checked for inclusion, not exact matches.
+
+```
+[import.ignorePatterns]
+commentPatterns = ["[actual-ignore]"]
+payeePatterns = []
+purposePatterns = []
+```
+
+The above configuration would ignore all transactions that have a comment containing the string `[actual-ignore]`.
+
+## Bugs
+
+If you notice any bugs or issues, please file an issue.

bun.lockb

@@ -31,7 +31,7 @@
         "@actual-app/api": "^6.5.0",
         "chalk": "^5.3.0",
         "date-fns": "^3.1.0",
-        "moneymoney": "^1.2.0",
+        "moneymoney": "^1.2.1",
         "node-fetch": "^3.3.2",
         "openai": "^3.2.1",
         "toml": "^3.0.0",

package-lock.json

@@ -138,25 +138,50 @@ class Importer {
     }) {
         const fromDate = from ?? subMonths(new Date(), 1);
 
-        let monMonTransactionsSinceFromDate = await getTransactions({
+        let monMonTransactions = await getTransactions({
             from: fromDate,
         });
 
         if (!this.config.import.importUncheckedTransactions) {
-            monMonTransactionsSinceFromDate =
-                monMonTransactionsSinceFromDate.filter((t) => t.booked);
+            monMonTransactions = monMonTransactions.filter((t) => t.booked);
+        }
+
+        if (this.config.import.ignorePatterns !== undefined) {
+            const ignorePatterns = this.config.import.ignorePatterns;
+
+            monMonTransactions = monMonTransactions.filter((t) => {
+                let isIgnored = (ignorePatterns.commentPatterns ?? []).some(
+                    (pattern) => t.comment?.includes(pattern)
+                );
+
+                isIgnored ||= (ignorePatterns.payeePatterns ?? []).some(
+                    (pattern) => t.name.includes(pattern)
+                );
+
+                isIgnored ||= (ignorePatterns.purposePatterns ?? []).some(
+                    (pattern) => t.purpose?.includes(pattern)
+                );
+
+                if (isIgnored) {
+                    this.logger.debug(
+                        `Ignoring transaction ${t.id} (${t.name}) due to ignore patterns`
+                    );
+                }
+
+                return !isIgnored;
+            });
         }
 
         this.logger.debug(
             `Found ${
-                monMonTransactionsSinceFromDate.length
+                monMonTransactions.length
             } total transactions in MoneyMoney since ${format(
                 fromDate,
                 DATE_FORMAT
             )}`
         );
 
-        const monMonTransactionMap = monMonTransactionsSinceFromDate.reduce(
+        const monMonTransactionMap = monMonTransactions.reduce(
             (acc, transaction) => {
                 if (!acc[transaction.accountUuid]) {
                     acc[transaction.accountUuid] = [];

package.json

@@ -40,6 +40,13 @@ export const configSchema = z
         }),
         import: z.object({
             importUncheckedTransactions: z.boolean(),
+            ignorePatterns: z
+                .object({
+                    commentPatterns: z.array(z.string()).optional(),
+                    payeePatterns: z.array(z.string()).optional(),
+                    purposePatterns: z.array(z.string()).optional(),
+                })
+                .optional(),
         }),
         actualServers: z.array(actualServerSchema).min(1),
     })