@tasenor/common-node 1.9.16

package/dist/tasenor-common-node/src/import/TransactionRules.js

@@ -0,0 +1,522 @@
+import { isAssetTransfer, RuleParsingError, RulesEngine, isUIQueryRef, warning, debug, error } from '@dataplug/tasenor-common';
+import clone from 'clone';
+import { BadState, SystemError } from '../error';
+/**
+ * ## Transaction rule system
+ *
+ * The classification of the import data uses rule system describing how to transform segmented
+ * data to *transfers*, i.e. generic description of bookkeeping events. Initially in the beginning
+ * of the processing the settings and rules defined for the particular importer are copied to the
+ * initial state of the process. During the processing we may ask questions and add more information
+ * to the process.
+ *
+ * So the structure of the configration is
+ * ```json
+ * {
+ *   "language": "fi",
+ *   "currency": "EUR",
+ *    ...
+ *   "account.income.currency.EUR": "1910",
+ *    ...
+ *   "rules": [...],
+ *   "questions": {...},
+ *   "answers": {...}
+ * }
+ * ```
+ * There are
+ * 1. Generic universal settings like *language* or *currency*.
+ * 2. Then there is an account and import setting configuration that has been possibly resolved during the import process
+ *    by asking from user, but which will also apply universally afterwards and are copied to the future import
+ *    configuration.
+ * 3. **Rules** section defines how to map segments to transfers.
+ * 4. **Question** section defines UI questions to resolve some cases, that always require user interaction and
+ *    cannot be resolved automatically.
+ * 5. **Answers** section is a collection of responses to questions stored by each segment. They are not universally
+ *    copied to the importer, but are only relevant the current import only.
+ *
+ * ### Settings
+ *
+ * The following general settings are used
+ * - `currency` - A main currency of the bookkeeping database.
+ * - `language` - A translation language for the imported texts.
+ * - `tags.*.*.*` - A list of tags to be added for every transaction descriptions. Also some specific tags
+ *                  can be specified, since `*.*.*` uses the same convention than account configurations.
+ *
+ * Accounts are defined as the following.
+ * - `account.<reason>.<type>.<asset>` - Defines the account number to be used for the given purpose.
+ *                                       Parts can be `'*'` to allow any purpose. Otherwise they are
+ *                                       explained in more detail in {@link TransferAnalyzer}.
+ *
+ * Miscellaneous optional settings:
+ * - `isTradeFeePartOfTotal` If set to `true`, assume that trading fee is included in the total.
+ *                           Otherwise it is assumed to be paid on the top of the total.
+ * - `recordDeposits` If set to false, skip deposits.
+ * - `recordWithdrawals` If set to false, skip withdrawls.
+ * - `allowShortSelling` If set, allow short selling, i.e. selling assets we don't have.
+ *
+ * #### Example
+ * ```json
+ * {
+ *   "currency": "EUR",
+ *   "language": "en",
+ *   "tags.*.*.*": ["Lynx"],
+ *   "account.deposit.currency.EUR": "1918",
+ *   "account.deposit.external.EUR": "9999",
+ *   "account.withdrawal.currency.EUR": "1918",
+ *   "account.withdrawal.external.EUR": "9999",
+ *   "account.expense.statement.INTEREST_EXPENSE": "9550",
+ *   "account.expense.currency.EUR": "1918",
+ *
+ *   "rules": [],
+ *   "questions": [],
+ *   "answers": {}
+ * }
+ * ```
+ *
+ * ### Rules
+ *
+ * Rules sections is a list of rule definitions of form
+ * ```json
+ * {
+ *    "name": "Name of the rule",
+ *    "filter": "<expression>",
+ *    "comment": "<optional description>",
+ *    "options": {
+ *      <optional flags>
+ *    },
+ *    "result": [
+ *       <transfer1>, <transfer2>...
+ *    ]
+ * }
+ * ```
+ * The *name* is any string describing the rule. Rules are used so that each segment resulting from the segmentation
+ * step are handled in the order of their timestamps. Lines belonging to the segment are offered one by one to the
+ * *filter* expression and if returning true, the entries in *result* are concatenated together. Each entry in the
+ * result is a *transfer description*.
+ *
+ * The filtering and result expressions has various variables set during the processing. All variables from
+ * the segmentation is included. Typically they are the same as the column names in the CSV file for example.
+ * See {@link TransactionRules.classifyLines} for other variables available.
+ *
+ * The structure of transfers are explained in {@link TransferAnalyzer}.
+ *
+ * The syntax of the filter and result is explained in {@link RulesEngine}.
+ *
+ * Currently one one boolean option is supported: `singleMatch` which means that matching any of the lines in the
+ * segment suffices and the parsing result is returned immediately when matching rule is found. The rest of the
+ * lines are ignored. It is useful when for example using `sum(lines, 'field')` to gather values from all lines
+ * of the segment at once.
+ *
+ * ### Questions
+ *
+ * There are situation, where importer cannot deduct some part of the transfer automatically. In that case we can
+ * define a question that needs to be answered every time, when the matching rule has been found. For example
+ * we may determine based on the transaction data that it is related to computers but we want to know the exact
+ * type of the purchase. Then we can define a question
+ * ```json
+ *   {
+ *     "name": "Computer purchase",
+ *     "label": "What category is the purchase",
+ *     "ask": {
+ *       "Hardware equipment": "HARDWARE",
+ *       "Software": "SOFTWARE"
+ *     }
+ *   },
+ * ```
+ *
+ * The question can be used in the transfer as explained in {@link TransferAnalyzer}.
+ *
+ * Different question types are documented in {@link TransactionUI.parseQuery}.
+ *
+ * ### Answers
+ *
+ * This section collects answers given earlier during the processing. They are grouped per segment ID per transfer.
+ * For example
+ * ```json
+ * "d3e89d9af37dda4609bed94770fc5c52be946175": {
+ *   "type": "HARDWARE"
+ * },
+ * ```
+ * It may contain also complete transaction definition, which will override all parsing
+ * ```
+ *   "581e46d024678ddcddc01ae36369bf6fc54f16b2": {
+ *     "transfers": [
+ *       {
+ *         "data": {
+ *           "text": "Payment for something"
+ *         },
+ *         "type": "account",
+ *         "asset": "8650",
+ *         "amount": 59.27,
+ *         "reason": "expense"
+ *       },
+ *       {
+ *         "type": "account",
+ *         "asset": "3020",
+ *         "amount": -59.27,
+ *         "reason": "expense"
+ *       }
+ *     ]
+ *  }
+ * ```
+ * There is also a global answer section applied to all imports. If an asset has changed its name, it can be
+ * stored like this in the empty segment ID:
+ * ```
+ *   "": {
+ *     "asset-renaming": [
+ *         {
+ *           "date": "<YYYY-MM-DD>"
+ *           "type": "stock",
+ *           "old": "<OLD ASSET>"
+ *           "new": "<NEW ASSET>"
+ *         }
+ *       ]
+ *     }
+ *   }
+ * ```
+ */
+export class TransactionRules {
+    // TODO: Could also define extension from ProcessConfig configuration type definition and start building precise description.
+    //       Most of the use cases in files of this dir, are referring to the import configuration.
+    handler;
+    UI;
+    cache;
+    constructor(handler) {
+        this.handler = handler;
+        this.UI = handler.UI;
+        this.clearCache();
+    }
+    /**
+     * Clear colleciton of named UI questions.
+     */
+    clearCache() {
+        this.cache = {};
+    }
+    /**
+     * Handle query caching.
+     * @param query
+     *
+     * If query has no name, we do nothing. Return query itself.
+     * Otherwise it depends if query has anything else but name.
+     * For name-only we look from cache and throw error if not found.
+     * Otherwise it is saved to cache.
+     */
+    cachedQuery(query) {
+        if (query.name) {
+            if (isUIQueryRef(query)) {
+                if (!this.cache[query.name]) {
+                    throw new BadState(`Cannot use a reference to question '${query.name}' before it is defined.`);
+                }
+                return this.cache[query.name];
+            }
+            else {
+                this.cache[query.name] = query;
+            }
+        }
+        return query;
+    }
+    /**
+     * Collect answers for questions or if not yet given, throw new query to get them.
+     * @param questions
+     * @param config
+     */
+    async getAnswers(segmentId, lines, questions, config) {
+        // Check existing answers.
+        const language = config.language;
+        const results = {};
+        const missing = [];
+        for (let [variable, query] of Object.entries(questions)) {
+            query = this.cachedQuery(query);
+            const answers = config.answers || {};
+            if (segmentId in answers && variable in answers[segmentId]) {
+                results[variable] = answers[segmentId][variable];
+            }
+            else {
+                missing.push(await this.UI.parseQuery(`answer.${segmentId}.${variable}`, query, language));
+            }
+        }
+        // If not all answered, ask them.
+        if (missing.length) {
+            const element = {
+                type: 'flat',
+                elements: [
+                    await this.UI.describeLines(lines, language),
+                    ...missing,
+                    await this.UI.submit('Continue', 2, language)
+                ]
+            };
+            this.UI.throw(element);
+        }
+        return results;
+    }
+    /**
+     * Use the rules from the configuration to classify importer transfer lines.
+     * @param lines
+     * @param config
+     * @returns
+     *
+     * Each rule is checked against each line.
+     * For evaluation of the filter expression, all column values of the segment are provided.
+     * In addition the following special variables are provided:
+     * * `config` - all configuration variables
+     * * `rule` - the current rule we are evaluating
+     * * `options` - the options of the current rule we are evaluating
+     * * `text` - original text of the corresponding line
+     * * `lineNumber` - original line number of the corresponding line
+     * If the filter match is found, then questions are provided to UI unless already
+     * answered. The reponses to the questions are passed to the any further evaluations.
+     */
+    async classifyLines(lines, config, segment) {
+        let transfers = [];
+        const rules = config.rules || [];
+        const engine = new RulesEngine();
+        let matched = false;
+        // Make private copy.
+        config = clone(config);
+        // Cache questions.
+        if (config.questions) {
+            config.questions.forEach(q => this.cachedQuery(q));
+        }
+        debug('RULES', '============================================================');
+        debug('RULES', 'Classifying segment', segment.id);
+        debug('RULES', '============================================================');
+        // Check if we have explicit answer for the segment.
+        const explicit = await this.checkExplicitResult(segment, config.answers);
+        if (explicit) {
+            return explicit;
+        }
+        try {
+            const lineValues = lines.map(line => clone(line.columns));
+            let index = 0;
+            for (const line of lines) {
+                let lineHasMatch = false;
+                const columns = lineValues[index++];
+                debug('RULES', '-----------------------------------------------------');
+                debug('RULES', line.text);
+                debug('RULES', '-----------------------------------------------------');
+                debug('RULES', columns);
+                // Find the rule that has matching filter expression.
+                for (let rule of rules) {
+                    rule = clone(rule);
+                    const values = {
+                        ...columns,
+                        lines: lineValues,
+                        config,
+                        rule,
+                        options: rule.options || {},
+                        text: line.text,
+                        lineNumber: line.line
+                    };
+                    const singleMatch = rule.options && rule.options.singleMatch;
+                    if (engine.eval(rule.filter, values)) {
+                        debug('RULES', 'Rule', rule.name, 'with filter', rule.filter, 'matches.');
+                        matched = true;
+                        lineHasMatch = true;
+                        // Check that result is defined.
+                        if (!rule.result) {
+                            throw new BadState(`The rule ${JSON.stringify(rule)} has no result section.`);
+                        }
+                        // We have found the match. Now construct transfers from the rule.
+                        const answers = rule.questions ? await this.getAnswers(segment.id, lines, rule.questions, config) : {};
+                        // Replace cached queries to the variables passed to the rule engine.
+                        if (rule.questions) {
+                            const q = rule.questions;
+                            Object.keys(q).forEach(key => {
+                                q[key] = this.cachedQuery(q[key]);
+                            });
+                        }
+                        transfers = transfers.concat(this.parseResults(engine, lines, rule, values, answers));
+                        // Continue to next line unless single match.
+                        if (singleMatch) {
+                            return await this.postProcess(segment, {
+                                type: 'transfers',
+                                transfers
+                            });
+                        }
+                        break;
+                    } // if (engine.eval(rule.filter, values))
+                } // for (let rule of rules)
+                if (!lineHasMatch) {
+                    await this.UI.throwNoFilterMatchForLine(lines, config, this.handler.importOptions);
+                }
+            } // for (const line of lines)
+            if (transfers.length > 0) {
+                return await this.postProcess(segment, {
+                    type: 'transfers',
+                    transfers
+                });
+            }
+        }
+        catch (err) {
+            if (err instanceof RuleParsingError) {
+                await this.throwErrorRetry(err, config.language);
+            }
+            else {
+                throw err;
+            }
+        }
+        // Decide the error when passing through without finding an answer.
+        if (matched) {
+            throw new Error(`Found matches but the result list is empty for ${JSON.stringify(lines)}.`);
+        }
+        throw new Error(`Could not find rules matching ${JSON.stringify(lines)}.`);
+    }
+    /**
+     * Check if there is an explicit answer already that needs to be returned for this segment.
+     */
+    async checkExplicitResult(segment, ans) {
+        if (ans && segment.id) {
+            const answers = ans;
+            if (answers[segment.id]) {
+                // Explicit transfer.
+                if (answers[segment.id].transfers) {
+                    return await this.postProcess(segment, {
+                        type: 'transfers',
+                        transfers: answers[segment.id].transfers
+                    });
+                }
+                // Explicit skipping.
+                if (answers[segment.id].skip) {
+                    return {
+                        type: 'transfers',
+                        transfers: [],
+                        transactions: [
+                            {
+                                date: segment.time,
+                                segmentId: segment.id,
+                                entries: [],
+                                executionResult: 'skipped'
+                            }
+                        ]
+                    };
+                }
+            }
+        }
+    }
+    /**
+     * Compute results from a rule.
+     */
+    parseResults(engine, lines, rule, values, answers) {
+        const transfers = [];
+        const results = 'length' in rule.result ? rule.result : [rule.result];
+        let index = 0;
+        if (results.length === 0) {
+            debug('RULES', 'Result: NONE');
+        }
+        for (const result of results) {
+            debug('RULES', `Result[${index}]:`);
+            const transfer = {};
+            // Collect fields evaluating directly from formula.
+            for (const [name, formula] of Object.entries(result)) {
+                if (name in transfer) {
+                    warning(`A rule '${rule.name}' resulted duplicate value in formula '${formula}' for the field '${name}''. Already having ${JSON.stringify(transfer)}.`);
+                }
+                else {
+                    transfer[name] = engine.eval(formula, { ...values, ...answers });
+                    debug('RULES', `  ${name} =`, JSON.stringify(transfer[name]));
+                }
+            }
+            // Verify condition before adding.
+            if (transfer.if === undefined || engine.eval(transfer.if, { ...values, ...answers })) {
+                // Catch bad results from formulas. Hit two jokers as well.
+                if (isAssetTransfer(transfer) && transfer.asset !== 'undefined' && transfer.asset !== 'null') {
+                    transfers.push(transfer);
+                    if (transfer.if) {
+                        debug('RULES', '  Accepted condition', transfer.if);
+                    }
+                }
+                else {
+                    console.log('Failing lines:');
+                    console.dir(lines, { depth: null });
+                    console.log('Matching rule:');
+                    console.dir(rule, { depth: null });
+                    throw new BadState(`Asset transfer ${JSON.stringify(transfer)} is incomplete.`);
+                }
+            }
+            else {
+                debug('RULES', '  Dropped due to condition', transfer.if);
+            }
+            index++;
+        }
+        return transfers;
+    }
+    /**
+     * Throw UI error with retry option.
+     */
+    async throwErrorRetry(err, lang) {
+        error(`Parsing error in expression '${err.expression}': ${err.message}`);
+        if (err.variables.rule) {
+            error(`While parsig rule ${JSON.stringify(err.variables.rule)}`);
+        }
+        if (err.variables && err.variables.text) {
+            error(`Failure in line ${err.variables.lineNumber}: ${err.variables.text}`);
+            const variables = clone(err.variables);
+            delete variables.config;
+            delete variables.rule;
+            delete variables.text;
+            delete variables.lineNumber;
+            error(`Variables when processing the line: ${JSON.stringify(variables)}.`);
+        }
+        // For parsing errors we can expect user editing configuration and then retrying.
+        const msg = (await this.UI.getTranslation('Parsing error in expression `{expr}`: {message}', lang)).replace('{expr}', err.expression).replace('{message}', err.message);
+        await this.UI.throwErrorRetry(msg, lang);
+    }
+    /**
+     * Check for needed adjustments like VAT before returning the result.
+     * @param result
+     * @returns
+     */
+    async postProcess(segment, result) {
+        // Find currency.
+        const vatReasons = new Set(['dividend', 'income', 'expense']);
+        const currencies = new Set(result.transfers.filter(t => vatReasons.has(t.reason) && t.type === 'currency').map(t => t.asset));
+        if (currencies.size > 1) {
+            throw new SystemError(`Not yet able to sort out VAT for multiple different currencies in ${JSON.stringify(result.transfers)}`);
+        }
+        // If no currencies, assume no VAT.
+        if (currencies.size) {
+            const currency = [...currencies][0];
+            // Add VAT where needed.
+            const vatTransfers = [];
+            for (const transfer of result.transfers) {
+                let vatPct;
+                if (transfer.data && 'vat' in transfer.data) {
+                    vatPct = transfer.data.vat;
+                }
+                else {
+                    vatPct = await this.handler.getVAT(segment.time, transfer, currency);
+                }
+                const vatValue = (transfer.data && 'vatValue' in transfer.data) ? transfer.data.vatValue : null;
+                if ((vatPct || vatValue) && transfer.amount) {
+                    const oldAmount = Math.round(transfer.amount * 100);
+                    const newAmount = vatValue !== null && vatValue !== undefined ? Math.round(oldAmount - vatValue * 100) : Math.round(transfer.amount * 100 / (1 + vatPct / 100));
+                    transfer.amount = newAmount / 100;
+                    const vat = oldAmount - newAmount;
+                    const vatEntry = {
+                        reason: 'tax',
+                        type: 'statement',
+                        asset: vat > 0 ? 'VAT_FROM_PURCHASES' : 'VAT_FROM_SALES',
+                        amount: vat / 100,
+                        data: {
+                            currency
+                        }
+                    };
+                    if (transfer.tags) {
+                        vatEntry.tags = transfer.tags;
+                    }
+                    vatTransfers.push(vatEntry);
+                }
+            }
+            result.transfers = result.transfers.concat(vatTransfers);
+        }
+        // Bundle tags if given as an object.
+        for (let i = 0; i < result.transfers.length; i++) {
+            if ('tags' in result.transfers[i] && typeof result.transfers[i].tags === 'object' && result.transfers[i].tags?.length === undefined && result.transfers[i].tags !== null) {
+                const tags = result.transfers[i].tags;
+                result.transfers[i].tags = Object.keys(tags).filter(t => !!tags[t]).sort();
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=TransactionRules.js.map

package/dist/tasenor-common-node/src/import/TransactionRules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionRules.js","sourceRoot":"","sources":["../../../../src/import/TransactionRules.ts"],"names":[],"mappings":"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"}