@tasenor/common-node 1.9.32 → 1.9.34

package/dist/src/commands/tx.js

@@ -0,0 +1,81 @@
+/* eslint-disable camelcase */
+import { sprintf } from 'sprintf-js';
+import { Command } from '.';
+import { log } from '@tasenor/common';
+class TxCommand extends Command {
+    addArguments(parser) {
+        const sub = parser.add_subparsers();
+        const ls = sub.add_parser('ls', { help: 'List all transactions' });
+        ls.set_defaults({ subCommand: 'ls' });
+        ls.add_argument('db', { help: 'Name of the database' });
+        ls.add_argument('period', { help: 'Period year, date or ID' });
+        const rm = sub.add_parser('rm', { help: 'Delete a transaction' });
+        rm.set_defaults({ subCommand: 'rm' });
+        rm.add_argument('db', { help: 'Name of the database' });
+        rm.add_argument('id', { help: 'ID of the transaction' });
+        const create = sub.add_parser('create', { help: 'Create a transaction' });
+        create.set_defaults({ subCommand: 'create' });
+        create.add_argument('--force', { help: 'Allow invalid transactions.', action: 'store_true', required: false });
+        create.add_argument('--data', { help: 'Define additional data field for all entries as JSON.', required: false });
+        create.add_argument('db', { help: 'Name of the database' });
+        create.add_argument('date', { help: 'The transaction date' });
+        create.add_argument('entry', { nargs: '+', help: 'A transaction line as string, e.g "1234 Description +12,00" or "1234 Description +12,00 {<data>}"' });
+    }
+    async ls() {
+        const { db, period } = this.args;
+        const periodId = await this.periodId(db, period);
+        const resp = await this.get(`/db/${db}/document?period=${periodId}&entries`);
+        await this.readAccounts(db);
+        this.out('document', resp);
+    }
+    print(data) {
+        for (const doc of data.sort((a, b) => (a.number || 0) - (b.number || 0))) {
+            const { number, date } = doc;
+            console.log(`#${number} ${date}`);
+            if (doc.entries) {
+                for (const entry of doc.entries) {
+                    console.log('  ', this.accountsById[entry.account_id || -1].number, sprintf('%.2f', entry.debit ? entry.amount / 100 : entry.amount / -100), entry.description);
+                }
+            }
+        }
+    }
+    async rm() {
+        const { db, id } = this.args;
+        await this.delete(`/db/${db}/document/${id}`);
+        log(`Document ${id} deleted successfully.`);
+    }
+    async create() {
+        const { db, date, data, entry, force } = this.args;
+        if (!db) {
+            throw new Error(`Invalid database argument ${JSON.stringify(db)}`);
+        }
+        const periodId = await this.periodId(db, date);
+        let entries = await this.entries(db, entry);
+        if (data) {
+            const extras = await this.jsonData(data);
+            entries = entries.map(e => ({ ...e, data: extras }));
+        }
+        const sum = entries.reduce((prev, cur) => prev + cur.amount, 0);
+        if (sum && !force) {
+            throw new Error(`Transaction total must be zero. Got ${sum} from ${JSON.stringify(entries)}.`);
+        }
+        const document = await this.post(`/db/${db}/document`, { period_id: periodId, date: this.date(date) });
+        log(`Created a document #${document.id} on ${date}.`);
+        for (const e of entries) {
+            const out = await this.post(`/db/${db}/entry`, {
+                document_id: document.id,
+                account_id: e.account_id,
+                debit: e.amount > 0,
+                amount: Math.abs(e.amount),
+                description: e.description,
+                data: e.data
+            });
+            log(`Created an entry #${out.id} for ${e.number} ${e.description} ${sprintf('%.2f', e.amount / 100)}${e.data ? ' ' + JSON.stringify(e.data) : ''}.`);
+        }
+    }
+    async run() {
+        await this.runBy('subCommand');
+    }
+}
+export default TxCommand;
+//# sourceMappingURL=tx.js.map

package/dist/src/commands/tx.js.map

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

package/dist/src/commands/user.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '.';
+import { ArgumentParser } from 'argparse';
+declare class UserCommand extends Command {
+    addArguments(parser: ArgumentParser): void;
+    ls(): Promise<void>;
+    print(data: any): void;
+    rm(): Promise<void>;
+    create(): Promise<void>;
+    add(): Promise<void>;
+    run(): Promise<void>;
+}
+export default UserCommand;

package/dist/src/commands/user.js

@@ -0,0 +1,52 @@
+import { log } from '@tasenor/common';
+import { Command } from '.';
+class UserCommand extends Command {
+    addArguments(parser) {
+        const sub = parser.add_subparsers();
+        const ls = sub.add_parser('ls', { help: 'List all users' });
+        ls.set_defaults({ subCommand: 'ls' });
+        const rm = sub.add_parser('rm', { help: 'Delete a user' });
+        rm.set_defaults({ subCommand: 'rm' });
+        rm.add_argument('email', { help: 'Email address of the user' });
+        const create = sub.add_parser('create', { help: 'Create a user' });
+        create.set_defaults({ subCommand: 'create' });
+        create.add_argument('name', { help: 'Full name of the user' });
+        create.add_argument('passwd', { help: 'Initial password for the user' });
+        create.add_argument('email', { help: 'Email address of the user' });
+        const add = sub.add_parser('add', { help: 'Add a user to the database' });
+        add.set_defaults({ subCommand: 'add' });
+        add.add_argument('email', { help: 'Email address of the user' });
+        add.add_argument('db', { help: 'Name of the database' });
+    }
+    async ls() {
+        const resp = await this.get('/admin/user');
+        this.out('user', resp);
+    }
+    print(data) {
+        for (const user of data.sort((a, b) => (a.id || 0) - (b.id || 0))) {
+            const { id, name, email, config } = user;
+            console.log(`#${id} ${name} ${email} ${JSON.stringify(config)}`);
+        }
+    }
+    async rm() {
+        const { email } = this.args;
+        await this.delete(`/admin/user/${email}`);
+        log(`User ${email} deleted successfully.`);
+    }
+    async create() {
+        const { name, passwd, email } = this.args;
+        const params = { name, password: passwd, email };
+        await this.post('/admin/user', params);
+        log(`User ${name} created successfully.`);
+    }
+    async add() {
+        const { email, db } = this.args;
+        log(`Adding user ${email} to database ${db}`);
+        await this.post(`/admin/user/${email}/databases`, { database: this.str(db) });
+    }
+    async run() {
+        await this.runBy('subCommand');
+    }
+}
+export default UserCommand;
+//# sourceMappingURL=user.js.map

package/dist/src/commands/user.js.map

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

package/dist/src/database/BookkeeperImporter.d.ts

@@ -0,0 +1,77 @@
+import { BookkeeperConfig, DirectoryPath, Hostname, ProcessedTsvFileData, TarFilePath, TextFilePath, TsvFilePath } from '@tasenor/common';
+import { KnexDatabase } from './DB';
+/**
+ * Implementation of the database backup file reading.
+ */
+export declare class BookkeeperImporter {
+    VERSION: number | null;
+    /**
+     * Read in a TSV-file and construct list of objects.
+     * @param file Path to the TSV-file.
+     * @returns List of objects using texts in header line as keys.
+     */
+    readTsv(file: TsvFilePath): Promise<ProcessedTsvFileData>;
+    /**
+     * Read the version number from the file.
+     * @param file Path to the version file.
+     */
+    setVersion(file: TextFilePath): void;
+    /**
+     * Read the account information from the tsv file.
+     * @param file A tsv file to read.
+     */
+    readAccountTsv(file: TsvFilePath): Promise<Record<string, unknown>[]>;
+    /**
+     * Read the account information in to the database.
+     * @param db Database connection.
+     * @param files A list of files to read.
+     */
+    setAccounts(db: KnexDatabase, files: TsvFilePath[]): Promise<void>;
+    /**
+     * Read the period information in to the database.
+     * @param db Database connection.
+     * @param file Path to the period file.
+     */
+    setPeriods(db: any, file: TsvFilePath): Promise<void>;
+    /**
+     * Read and store all documents and entries found from the TSV-file.
+     * @param db Database connection.
+     * @param file Path to the transaction file.
+     * @param conf Database configuration.
+     */
+    setEntries(db: KnexDatabase, file: TsvFilePath, conf: BookkeeperConfig): Promise<void>;
+    /**
+     * Set the configuration for database.
+     * @param db Database connection.
+     * @param name Name of the database to update.
+     * @param conf Database configuration.
+     */
+    setConfig(db: KnexDatabase, config: BookkeeperConfig): Promise<void>;
+    /**
+     * Read in tag data and files from the backup.
+     * @param db Database connection.
+     * @param file Path to the tag file. Also its directory is assumed where images can be found.
+     */
+    setTags(db: KnexDatabase, file: TsvFilePath): Promise<void>;
+    /**
+     * Remove all data from all tables.
+     * @param db Database connection.
+     */
+    clearEverything(db: KnexDatabase): Promise<void>;
+    /**
+     * Clear the given database and restore everything from the directory.
+     * @param masterDb Master DB connection.
+     * @param dbName Name of the database to use.
+     * @param out The directory containing unpacked backup.
+     * @param hostOverride If set, use this hostname instead of the one in database, when connecting to target DB.
+     */
+    restore(masterDb: KnexDatabase, dbName: string, out: DirectoryPath, hostOverride?: Hostname | null): Promise<void>;
+    /**
+     * Clear the given database and restore everything from the directory.
+     * @param masterDb Master DB connection.
+     * @param dbName Name of the database to use.
+     * @param out The directory containing unpacked backup.
+     * @param hostOverride If set, use this hostname instead of the one in database, when connecting to target DB.
+     */
+    run(masterDb: KnexDatabase, dbName: string, tarPath: TarFilePath, out: DirectoryPath, hostOverride?: Hostname | null): Promise<void>;
+}

package/dist/src/database/BookkeeperImporter.js

@@ -0,0 +1,343 @@
+import glob from 'fast-glob';
+import path from 'path';
+import fs from 'fs';
+import { system } from '..';
+import { log, error } from '@tasenor/common';
+import { DB } from './DB';
+import { create } from 'ts-opaque';
+/**
+ * Implementation of the database backup file reading.
+ */
+export class BookkeeperImporter {
+    VERSION = null;
+    /**
+     * Read in a TSV-file and construct list of objects.
+     * @param file Path to the TSV-file.
+     * @returns List of objects using texts in header line as keys.
+     */
+    async readTsv(file) {
+        log(`Reading ${file}.`);
+        const content = fs.readFileSync(file).toString('utf-8').trim();
+        const lines = content.split('\n').map(s => s.split('\t'));
+        const headers = lines[0];
+        headers[0] = headers[0].replace(/^#\s+/, '');
+        const objects = [];
+        for (let i = 1; i < lines.length; i++) {
+            const obj = {};
+            for (let j = 0; j < headers.length; j++) {
+                obj[headers[j]] = lines[i][j] || '';
+            }
+            objects.push(obj);
+        }
+        return objects;
+    }
+    /**
+     * Read the version number from the file.
+     * @param file Path to the version file.
+     */
+    setVersion(file) {
+        this.VERSION = JSON.parse(fs.readFileSync(file).toString('utf-8'));
+        log(`Found file format version ${this.VERSION}.`);
+    }
+    /**
+     * Read the account information from the tsv file.
+     * @param file A tsv file to read.
+     */
+    async readAccountTsv(file) {
+        const match = /([a-z][a-z])-([A-Z][A-Z][A-Z])\.tsv$/.exec(file);
+        if (!match) {
+            throw new Error(`File name ${file} has not correct format.`);
+        }
+        const entries = [];
+        const [, language, currency] = match;
+        const accounts = await this.readTsv(file);
+        let headings = [];
+        for (const account of accounts) {
+            if (account.text !== '') {
+                const code = (!account.code
+                    ? null
+                    : (
+                    // Allow numeric VAT as well.
+                    /^\d+(\.\d+)$/.test(account.code) ? account.code : account.code.replace(/^_+/, '')));
+                let data;
+                try {
+                    data = account.data === undefined || account.data === '' ? {} : JSON.parse(account.data);
+                }
+                catch (err) {
+                    throw new Error(`Parsing account data failed: ${account.data}.`);
+                }
+                if (code !== null) {
+                    data.code = code;
+                }
+                // Verision 1.
+                if (this.VERSION === 1) {
+                    const flags = new Set(account.flags ? account.flags.split(' ') : []);
+                    if (flags.has('FAVOURITE')) {
+                        data.favourite = true;
+                    }
+                }
+                const entry = {
+                    language,
+                    currency,
+                    number: account['number / title'],
+                    name: account.text,
+                    type: account.type,
+                    data
+                };
+                if (headings.length) {
+                    for (const heading of headings) {
+                        heading.number = entry.number;
+                        entries.push(heading);
+                    }
+                    headings = [];
+                }
+                entries.push(entry);
+            }
+            else {
+                const spaces = /^(_*)/.exec(account['number / title']);
+                const entry = {
+                    text: account['number / title'].replace(/^_+/, ''),
+                    number: null,
+                    level: spaces ? spaces[1].length : 0
+                };
+                headings.push(entry);
+            }
+        }
+        return entries;
+    }
+    /**
+     * Read the account information in to the database.
+     * @param db Database connection.
+     * @param files A list of files to read.
+     */
+    async setAccounts(db, files) {
+        let count = 0;
+        for (const file of files) {
+            const accounts = await this.readAccountTsv(file);
+            for (const entry of accounts) {
+                if (entry.text) {
+                    await db('heading').insert(entry).catch(err => {
+                        error(`Failed to insert a heading ${JSON.stringify(entry)}`);
+                        throw err;
+                    });
+                }
+                else {
+                    await db('account').insert(entry).catch(err => {
+                        error(`Failed to insert an account ${JSON.stringify(entry)}`);
+                        throw err;
+                    });
+                }
+                count++;
+            }
+        }
+        log(`Inserted ${count} rows to the database.`);
+    }
+    /**
+     * Read the period information in to the database.
+     * @param db Database connection.
+     * @param file Path to the period file.
+     */
+    async setPeriods(db, file) {
+        log(`Reading period file ${file}.`);
+        let count = 0;
+        const periods = await this.readTsv(file);
+        for (const period of periods) {
+            const entry = {
+                start_date: period.start,
+                end_date: period.end,
+                locked: period.flags === 'LOCKED'
+            };
+            await db('period').insert(entry);
+            count++;
+        }
+        log(`Inserted ${count} rows to the database.`);
+    }
+    /**
+     * Read and store all documents and entries found from the TSV-file.
+     * @param db Database connection.
+     * @param file Path to the transaction file.
+     * @param conf Database configuration.
+     */
+    async setEntries(db, file, conf) {
+        log(`Reading entry file ${file}.`);
+        let count = 0;
+        const periods = await db('period').select('id').orderBy('start_date');
+        const periodMap = {};
+        const accounts = await db('account').select('id', 'number').where({ language: conf.language });
+        const accountMap = accounts.reduce((prev, cur) => ({ [cur.number]: cur.id, ...prev }), {});
+        let n = 1;
+        for (const period of periods) {
+            periodMap[n++] = period.id;
+        }
+        const data = await this.readTsv(file);
+        let periodId, docId, rowNumber;
+        for (const line of data) {
+            // Period line.
+            const check = /^Period (\d+)/.exec(line.number);
+            if (check) {
+                periodId = periodMap[parseInt(check[1])];
+                if (!periodId) {
+                    throw Error(`Inconsistent periods. Cannot find period number ${n}.`);
+                }
+                continue;
+            }
+            // Document line.
+            if (line.number !== '') {
+                const entry = {
+                    period_id: periodId,
+                    number: parseInt(line.number),
+                    date: line['date / account']
+                };
+                docId = (await db('document').insert(entry).returning('id'))[0].id;
+                count++;
+                rowNumber = 1;
+                continue;
+            }
+            // Entry line.
+            if (!accountMap[line['date / account']]) {
+                throw Error(`Inconsistent accounts. Cannot account find number ${line['date / account']}.`);
+            }
+            const amount = parseFloat(line.amount);
+            const data = {};
+            // Version 1.
+            if (this.VERSION === 1) {
+                const flags = new Set(line.flags.split(' '));
+                if (flags.has('VAT_IGNORE') || flags.has('VAT_RECONCILED')) {
+                    if (flags.has('VAT_IGNORE')) {
+                        data.VAT = { ignore: true };
+                    }
+                    if (flags.has('VAT_RECONCILED')) {
+                        data.VAT = { ...(data.VAT || {}), reconciled: true };
+                    }
+                }
+                // Version 2.
+            }
+            else if (this.VERSION === 2) {
+                Object.assign(data, JSON.parse(line.data));
+            }
+            const entry = {
+                document_id: docId,
+                account_id: accountMap[line['date / account']],
+                debit: !(amount < 0),
+                amount: Math.abs(amount),
+                description: line.text,
+                row_number: rowNumber,
+                data
+            };
+            rowNumber++;
+            await db('entry').insert(entry).catch(err => {
+                error(`Failed to insert an entry ${JSON.stringify(entry)}`);
+                throw err;
+            });
+            count++;
+        }
+        log(`Inserted ${count} rows to the database.`);
+    }
+    /**
+     * Set the configuration for database.
+     * @param db Database connection.
+     * @param name Name of the database to update.
+     * @param conf Database configuration.
+     */
+    async setConfig(db, config) {
+        log('Saving configuration.');
+        // Transform deep structures to dot-names.
+        const transform = (config, prefix = '') => {
+            const ret = {};
+            Object.keys(config).forEach(k => {
+                if (config[k] !== null && typeof config[k] === 'object' && config[k].length === undefined) {
+                    Object.assign(ret, transform(config[k], `${k}.`));
+                }
+                else {
+                    ret[`${prefix}${k}`] = config[k];
+                }
+            });
+            return ret;
+        };
+        // Save all.
+        for (const [k, v] of Object.entries(transform(config))) {
+            await db('settings').insert({ name: k, value: JSON.stringify(v) });
+        }
+    }
+    /**
+     * Read in tag data and files from the backup.
+     * @param db Database connection.
+     * @param file Path to the tag file. Also its directory is assumed where images can be found.
+     */
+    async setTags(db, file) {
+        log(`Reading tag file ${file}.`);
+        const picPath = path.dirname(file);
+        let count = 0;
+        const tags = await this.readTsv(file);
+        for (const tag of tags) {
+            const pic = fs.readFileSync(path.join(picPath, tag.picture));
+            const entry = {
+                tag: tag.tag,
+                name: tag.name,
+                mime: tag.mime,
+                picture: pic,
+                type: tag.type,
+                order: tag.order
+            };
+            await db('tags').insert(entry);
+            count++;
+        }
+        log(`Inserted ${count} rows to the database.`);
+    }
+    /**
+     * Remove all data from all tables.
+     * @param db Database connection.
+     */
+    async clearEverything(db) {
+        log('Deleting all existing data.');
+        await db('entry').del();
+        await db('document').del();
+        await db('account').del();
+        await db('heading').del();
+        await db('period').del();
+        await db('tags').del();
+        await db('settings').del();
+    }
+    /**
+     * Clear the given database and restore everything from the directory.
+     * @param masterDb Master DB connection.
+     * @param dbName Name of the database to use.
+     * @param out The directory containing unpacked backup.
+     * @param hostOverride If set, use this hostname instead of the one in database, when connecting to target DB.
+     */
+    async restore(masterDb, dbName, out, hostOverride = null) {
+        const userDb = await DB.get(masterDb, create(dbName), hostOverride);
+        this.setVersion(create(path.join(out, 'VERSION')));
+        const conf = JSON.parse(fs.readFileSync(path.join(out, 'settings.json')).toString('utf-8'));
+        if (!conf.language) {
+            throw new Error('Configuration does not have language.');
+        }
+        await this.clearEverything(userDb);
+        await this.setConfig(userDb, conf);
+        const files = glob.sync(path.join(out, 'accounts', '*'));
+        await this.setAccounts(userDb, files);
+        const periodsPath = path.join(out, 'periods.tsv');
+        await this.setPeriods(userDb, create(periodsPath));
+        const entriesPath = path.join(out, 'entries.tsv');
+        await this.setEntries(userDb, create(entriesPath), conf);
+        const tagsPath = path.join(out, 'tags.tsv');
+        await this.setTags(userDb, create(tagsPath));
+    }
+    /**
+     * Clear the given database and restore everything from the directory.
+     * @param masterDb Master DB connection.
+     * @param dbName Name of the database to use.
+     * @param out The directory containing unpacked backup.
+     * @param hostOverride If set, use this hostname instead of the one in database, when connecting to target DB.
+     */
+    async run(masterDb, dbName, tarPath, out, hostOverride = null) {
+        tarPath = create(path.resolve(tarPath));
+        if (!fs.existsSync(tarPath)) {
+            throw new Error(`Backup ${tarPath} does not exist.`);
+        }
+        await system(`cd "${out}" && tar xf "${tarPath}"`);
+        await this.restore(masterDb, dbName, out, hostOverride);
+        await system(`rm -fr "${out}"`);
+    }
+}
+//# sourceMappingURL=BookkeeperImporter.js.map

package/dist/src/database/BookkeeperImporter.js.map

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

package/dist/src/database/DB.d.ts

@@ -0,0 +1,51 @@
+import { DatabaseName, Hostname, ID, Url } from '@tasenor/common';
+import { Knex } from 'knex';
+export type KnexDatabase = Knex<any, any[]>;
+export type KnexConfig = Record<string, any>;
+export type KnexConnectionInfo = {
+    host: string;
+    port: string | number;
+    database: string;
+    user: string;
+    password: string;
+};
+/**
+ * Generate a name for a database that does not yet exist.
+ * @param masterDb - Master database.
+ * @param init - Initial part of the name.
+ * @returns Suitable name.
+ */
+declare function findName(masterDb: KnexDatabase, init: string): Promise<string>;
+/**
+ * Terminate all DB connections.
+ */
+declare function disconnectAll(): Promise<void>;
+/**
+ * Get a list of all customer database connection infos.
+ */
+declare function customerDbs(hostOverride?: null | Hostname): Promise<KnexConnectionInfo[]>;
+/**
+ * Resolve database host from environment DATABASE_URL if set.
+ */
+declare function envHost(): string | null;
+export declare const DB: {
+    create: (masterDb: KnexDatabase, name: DatabaseName, host: Hostname, port: number, migrations?: string | null, hostOverride?: null | Hostname) => Promise<ID>;
+    customerDbs: typeof customerDbs;
+    destroy: (masterDb: KnexDatabase, name: DatabaseName, hostOverride?: null | Hostname) => Promise<string | null>;
+    disconnectAll: typeof disconnectAll;
+    envHost: typeof envHost;
+    exists: (master: KnexDatabase, name: DatabaseName) => Promise<boolean>;
+    findName: typeof findName;
+    get: (master: KnexDatabase, name: DatabaseName, hostOverride?: null | Hostname) => Promise<KnexDatabase>;
+    getConfig: (master: KnexDatabase, name: DatabaseName, hostOverride?: null | Hostname) => Promise<KnexConfig>;
+    getKnexConfig: (knexUrl: Url) => KnexConfig;
+    getMaster: () => KnexDatabase;
+    getMasterConfig: () => KnexConfig;
+    getRoot: () => KnexDatabase;
+    getRootConfig: () => KnexConfig;
+    isValidName: (name: string) => boolean;
+    migrate: (masterDb: KnexDatabase, name: DatabaseName, migrations: string, hostOverride?: null | Hostname) => Promise<void>;
+    migrateMaster: (migrations: string) => Promise<void>;
+    rollback: (masterDb: KnexDatabase, name: DatabaseName, migrations: string, hostOverride?: null | Hostname) => Promise<void>;
+};
+export {};