@tasenor/common-node 1.9.32 → 1.9.34

package/dist/src/database/DB.js

@@ -0,0 +1,354 @@
+import { Crypto, error, isDatabaseName, log } from '@tasenor/common';
+import { randomString, vault } from '..';
+import knex from 'knex';
+import { types } from 'pg';
+import { builtins } from 'pg-types';
+import { create as opaque } from 'ts-opaque';
+// How many times to retry migration before giving up.
+const MIGRATION_RETRY = 20;
+// Fix Knex messing around with the date values and timezones.
+const parseDate = (val) => val;
+types.setTypeParser(builtins.TIMESTAMPTZ, parseDate);
+types.setTypeParser(builtins.TIMESTAMP, parseDate);
+types.setTypeParser(builtins.DATE, parseDate);
+/**
+ * Check if the database with the given name exists.
+ * @param master The master database.
+ * @param name Name of the DB to check.
+ * @returns True if it is found.
+ */
+const exists = async (master, name) => {
+    return !!(await master('databases').select('*').where({ name }).first());
+};
+/**
+ * Construct a Knex configuration for the given database.
+ * @param master
+ * @param name
+ * @param hostOverride
+ * @returns
+ */
+const getConfig = async (master, name, hostOverride = null) => {
+    const userDb = await master('databases').select('*').where({ name }).first();
+    const password = await Crypto.decrypt(vault.get('SECRET'), userDb.password);
+    if (!password) {
+        throw new Error('Failed to get password.');
+    }
+    return {
+        client: 'postgresql',
+        connection: {
+            host: hostOverride === null ? userDb.host : hostOverride,
+            port: userDb.port,
+            database: userDb.name,
+            user: userDb.user,
+            password
+        },
+        pool: {
+            min: 1,
+            max: 3
+        }
+    };
+};
+const cache = {};
+/**
+ * Get the cached connection to the given customer database.
+ * @param master Master database connection.
+ * @param name Name of the database.
+ * @param hostOverride If given, use this host instead of the host in database.
+ * @returns Knex connection.
+ */
+const get = async (master, name, hostOverride = null) => {
+    if (!(await exists(master, name))) {
+        delete cache[name];
+        throw new Error(`Database '${name}' does not exist.`);
+    }
+    const cacheName = hostOverride ? `${name}:${hostOverride}` : name;
+    if (!cache[cacheName]) {
+        const knexConfig = await getConfig(master, name, hostOverride);
+        cache[cacheName] = knex(knexConfig);
+    }
+    return cache[cacheName];
+};
+/**
+ * Disconnect and drop cached connection.
+ * @param name Name of the database.
+ */
+const disconnect = async (name) => {
+    for (const conn of Object.entries(cache)) {
+        if (conn[0].split(':')[0] === name) {
+            log(`Disconnecting ${conn[0]}`);
+            await conn[1].destroy();
+            delete cache[conn[0]];
+        }
+    }
+};
+/**
+ * Get the configuration for the root connection.
+ * @returns Configuration object.
+ */
+const getRootConfig = () => {
+    const url = new URL(vault.get('DATABASE_URL'));
+    const knexConfig = {
+        client: 'postgresql',
+        connection: {
+            host: url.hostname,
+            port: parseInt(url.port) || 5432,
+            database: 'postgres',
+            user: vault.get('DATABASE_ROOT_USER'),
+            password: vault.get('DATABASE_ROOT_PASSWORD')
+        },
+        pool: {
+            min: 1,
+            max: 1
+        }
+    };
+    return knexConfig;
+};
+/**
+ * Convert database URL to knex config.
+ * @param knexUrl
+ * @returns
+ */
+const getKnexConfig = (knexUrl) => {
+    const url = new URL(knexUrl);
+    return {
+        client: 'postgresql',
+        connection: {
+            host: url.hostname,
+            port: parseInt(url.port) || 5432,
+            database: url.pathname.replace(/^\//, ''),
+            user: url.username,
+            password: url.password
+        },
+        pool: {
+            min: 1,
+            max: 5
+        }
+    };
+};
+/**
+ * Get the cached connetion to the root access.
+ * @returns Knex instance.
+ */
+let rootCache;
+const getRoot = () => {
+    if (rootCache)
+        return rootCache;
+    rootCache = knex(getRootConfig());
+    return rootCache;
+};
+const getMasterConfig = () => {
+    return getKnexConfig(vault.get('DATABASE_URL'));
+};
+/**
+ * Get the master database.
+ * @returns A Knex instance.
+ */
+let masterCache;
+const getMaster = () => {
+    if (masterCache)
+        return masterCache;
+    masterCache = knex(getMasterConfig());
+    return masterCache;
+};
+/**
+ * Test if the name is valid database name.
+ * @param name
+ * @returns True if valid.
+ */
+const isValidName = (name) => {
+    return isDatabaseName(name);
+};
+/**
+ * Create new customer database.
+ * @param db Knex for bookkeeper master database.
+ * @param name Name of the new database.
+ * @param host A host name of the DB host.
+ * @param port A port used by the DB host.
+ * @param migrations Path of the migrations file.
+ * @returns ID
+ */
+const create = async (masterDb, name, host, port, migrations = null, hostOverride = null) => {
+    if (await exists(masterDb, name)) {
+        throw new Error(`Database '${name}' exist.`);
+    }
+    if (!isValidName(name)) {
+        throw new Error(`Invalid database name '${name}'.`);
+    }
+    const rootDb = getRoot();
+    const user = 'user' + randomString(20);
+    const password = randomString(64);
+    const entry = {
+        name,
+        host,
+        port,
+        user,
+        password: await Crypto.encrypt(vault.get('SECRET'), password),
+        config: {}
+    };
+    await rootDb.raw(`CREATE USER "${user}" WITH PASSWORD '${password}'`);
+    await rootDb.raw(`CREATE DATABASE "${name}"`);
+    await rootDb.raw(`GRANT ALL PRIVILEGES ON DATABASE "${name}" TO "${user}"`);
+    const id = (await masterDb('databases').insert(entry).returning('id'))[0].id;
+    if (migrations) {
+        await migrate(masterDb, name, migrations, hostOverride);
+    }
+    return id;
+};
+/**
+ * Apply migrations to the named customer database.
+ * @param masterDb
+ * @param name
+ * @param migrations
+ * @param hostOverride
+ */
+const migrate = async (masterDb, name, migrations, hostOverride = null) => {
+    log(`Migrating database '${name}'.`);
+    const conf = await getConfig(masterDb, name, hostOverride);
+    conf.migrations = { directory: migrations };
+    const db = knex(conf);
+    await db.migrate.latest();
+    // Do not leave hanging connections.
+    await db.destroy();
+};
+/**
+ * Apply migrations to the master database.
+ */
+const migrateMaster = async (migrations) => {
+    function delay(time) {
+        return new Promise(resolve => setTimeout(resolve, time));
+    }
+    log('Migrating master database.');
+    const conf = await getMasterConfig();
+    conf.migrations = { directory: migrations };
+    const db = knex(conf);
+    for (let i = 0; i < MIGRATION_RETRY; i++) {
+        try {
+            await db.migrate.latest();
+            log('Migrating master database successful.');
+            break;
+        }
+        catch (err) {
+            if (i < MIGRATION_RETRY - 1) {
+                error('Migration failed. Retrying...');
+                await delay(1000);
+            }
+        }
+    }
+    // Do not leave hanging connections.
+    await db.destroy();
+};
+/**
+ * Roll bakc last migrations from the named customer database.
+ * @param masterDb
+ * @param name
+ * @param migrations
+ * @param hostOverride
+ */
+const rollback = async (masterDb, name, migrations, hostOverride = null) => {
+    const conf = await getConfig(masterDb, name, hostOverride);
+    conf.migrations = { directory: migrations };
+    const db = knex(conf);
+    await db.migrate.rollback();
+    // Do not leave hanging connections.
+    await db.destroy();
+};
+/**
+ * Destroy customer database.
+ * @param masterDb
+ * @param name
+ * @param hostOverride
+ */
+const destroy = async (masterDb, name, hostOverride = null) => {
+    const db = await masterDb('databases').where({ name }).first();
+    if (!db) {
+        return 'Database not found.';
+    }
+    const dbToDelete = await get(masterDb, name, hostOverride);
+    await dbToDelete.raw(`DROP OWNED BY ${db.user}`);
+    disconnect(name);
+    await masterDb('database_users').where({ database_id: db.id }).delete();
+    await masterDb('databases').where({ id: db.id }).delete();
+    const rootDb = getRoot();
+    await rootDb.raw(`DROP OWNED BY ${db.user}`);
+    await rootDb.raw(`DROP USER ${db.user}`);
+    await rootDb.raw(`DROP DATABASE ${db.name} WITH (FORCE)`);
+    return null;
+};
+/**
+ * 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.
+ */
+async function findName(masterDb, init) {
+    let n = 1;
+    let name = init;
+    while (await exists(masterDb, opaque(name))) {
+        n++;
+        name = `${init}${n}`;
+    }
+    return name;
+}
+/**
+ * Terminate all DB connections.
+ */
+async function disconnectAll() {
+    if (masterCache) {
+        log('Disconnecting master DB.');
+        await masterCache.destroy();
+    }
+    if (rootCache) {
+        log('Disconnecting root DB.');
+        await rootCache.destroy();
+    }
+    for (const conn of Object.entries(cache)) {
+        log(`Disconnecting ${conn[0]}`);
+        await conn[1].destroy();
+    }
+}
+/**
+ * Get a list of all customer database connection infos.
+ */
+async function customerDbs(hostOverride = null) {
+    const all = [];
+    await vault.initialize();
+    const master = await getMaster();
+    const dbs = await master('databases').select('name', 'host', 'port', 'user', 'password');
+    for (const db of dbs) {
+        const conf = await getConfig(master, db.name, hostOverride);
+        const { host, port, database, user, password } = conf.connection;
+        all.push({ host, port, database, user, password });
+    }
+    return all;
+}
+/**
+ * Resolve database host from environment DATABASE_URL if set.
+ */
+function envHost() {
+    if (!process.env.DATABASE_URL) {
+        return null;
+    }
+    const url = new URL(process.env.DATABASE_URL);
+    return url.hostname;
+}
+export const DB = {
+    create,
+    customerDbs,
+    destroy,
+    disconnectAll,
+    envHost,
+    exists,
+    findName,
+    get,
+    getConfig,
+    getKnexConfig,
+    getMaster,
+    getMasterConfig,
+    getRoot,
+    getRootConfig,
+    isValidName,
+    migrate,
+    migrateMaster,
+    rollback
+};
+//# sourceMappingURL=DB.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DB.js","sourceRoot":"","sources":["../../../src/database/DB.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAgB,KAAK,EAAgB,cAAc,EAAE,GAAG,EAAe,MAAM,iBAAiB,CAAA;AAC7G,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,IAAI,CAAA;AACxC,OAAO,IAAc,MAAM,MAAM,CAAA;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,CAAA;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACnC,OAAO,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,WAAW,CAAA;AAE5C,sDAAsD;AACtD,MAAM,eAAe,GAAG,EAAE,CAAA;AAE1B,8DAA8D;AAC9D,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAA;AAC9B,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;AACpD,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;AAClD,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;AAc7C;;;;;GAKG;AACH,MAAM,MAAM,GAAG,KAAK,EAAE,MAAoB,EAAE,IAAkB,EAAoB,EAAE;IAClF,OAAO,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA;AAC1E,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,SAAS,GAAG,KAAK,EAAE,MAAoB,EAAE,IAAkB,EAAE,eAAgC,IAAI,EAAuB,EAAE;IAC9H,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAA;IAC5E,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;IACrF,IAAI,CAAC,QAAQ,EAAE;QACb,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAA;KAC3C;IACD,OAAO;QACL,MAAM,EAAE,YAAY;QACpB,UAAU,EAAE;YACV,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY;YACxD,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,MAAM,CAAC,IAAI;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ;SACT;QACD,IAAI,EAAE;YACJ,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,CAAC;SACP;KACF,CAAA;AACH,CAAC,CAAA;AAED,MAAM,KAAK,GAAG,EAAE,CAAA;AAChB;;;;;;GAMG;AACH,MAAM,GAAG,GAAG,KAAK,EAAE,MAAoB,EAAE,IAAkB,EAAE,eAAgC,IAAI,EAAyB,EAAE;IAC1H,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,EAAE;QACjC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAA;QAClB,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,mBAAmB,CAAC,CAAA;KACtD;IAED,MAAM,SAAS,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAEjE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE;QACrB,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,YAAY,CAAC,CAAA;QAC9D,KAAK,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAA;KACpC;IACD,OAAO,KAAK,CAAC,SAAS,CAAC,CAAA;AACzB,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,UAAU,GAAG,KAAK,EAAE,IAAY,EAAiB,EAAE;IACvD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QACxC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE;YAClC,GAAG,CAAC,iBAAiB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;YAC/B,MAAO,IAAI,CAAC,CAAC,CAAU,CAAC,OAAO,EAAE,CAAA;YACjC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;SACtB;KACF;AACH,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,aAAa,GAAG,GAAe,EAAE;IACrC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAA;IAC9C,MAAM,UAAU,GAAG;QACjB,MAAM,EAAE,YAAY;QACpB,UAAU,EAAE;YACV,IAAI,EAAE,GAAG,CAAC,QAAQ;YAClB,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI;YAChC,QAAQ,EAAE,UAAU;YACpB,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,oBAAoB,CAAC;YACrC,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,wBAAwB,CAAC;SAC9C;QACD,IAAI,EAAE;YACJ,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,CAAC;SACP;KACF,CAAA;IACD,OAAO,UAAU,CAAA;AACnB,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,aAAa,GAAG,CAAC,OAAY,EAAc,EAAE;IACjD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAA;IAC5B,OAAO;QACL,MAAM,EAAE,YAAY;QACpB,UAAU,EAAE;YACV,IAAI,EAAE,GAAG,CAAC,QAAQ;YAClB,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI;YAChC,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YACzC,IAAI,EAAE,GAAG,CAAC,QAAQ;YAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACvB;QACD,IAAI,EAAE;YACJ,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,CAAC;SACP;KACF,CAAA;AACH,CAAC,CAAA;AAED;;;GAGG;AACH,IAAI,SAAS,CAAA;AACb,MAAM,OAAO,GAAG,GAAiB,EAAE;IACjC,IAAI,SAAS;QAAE,OAAO,SAAS,CAAA;IAE/B,SAAS,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,CAAA;IACjC,OAAO,SAAS,CAAA;AAClB,CAAC,CAAA;AAED,MAAM,eAAe,GAAG,GAAe,EAAE;IACvC,OAAO,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAQ,CAAC,CAAA;AACxD,CAAC,CAAA;AAED;;;GAGG;AACH,IAAI,WAAW,CAAA;AACf,MAAM,SAAS,GAAG,GAAiB,EAAE;IACnC,IAAI,WAAW;QAAE,OAAO,WAAW,CAAA;IAEnC,WAAW,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC,CAAA;IACrC,OAAO,WAAW,CAAA;AACpB,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,WAAW,GAAG,CAAC,IAAY,EAAW,EAAE;IAC5C,OAAO,cAAc,CAAC,IAAI,CAAC,CAAA;AAC7B,CAAC,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,GAAG,KAAK,EAAE,QAAsB,EAAE,IAAkB,EAAE,IAAc,EAAE,IAAY,EAAE,aAA4B,IAAI,EAAE,eAAgC,IAAI,EAAe,EAAE;IACrL,IAAI,MAAM,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE;QAChC,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,UAAU,CAAC,CAAA;KAC7C;IACD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE;QACtB,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,IAAI,CAAC,CAAA;KACpD;IACD,MAAM,MAAM,GAAG,OAAO,EAAE,CAAA;IACxB,MAAM,IAAI,GAAG,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,CAAA;IACtC,MAAM,QAAQ,GAAG,YAAY,CAAC,EAAE,CAAC,CAAA;IACjC,MAAM,KAAK,GAAG;QACZ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,QAAQ,EAAE,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAW,EAAE,QAAQ,CAAC;QACvE,MAAM,EAAE,EAAE;KACX,CAAA;IACD,MAAM,MAAM,CAAC,GAAG,CAAC,gBAAgB,IAAI,oBAAoB,QAAQ,GAAG,CAAC,CAAA;IACrE,MAAM,MAAM,CAAC,GAAG,CAAC,oBAAoB,IAAI,GAAG,CAAC,CAAA;IAC7C,MAAM,MAAM,CAAC,GAAG,CAAC,qCAAqC,IAAI,SAAS,IAAI,GAAG,CAAC,CAAA;IAC3E,MAAM,EAAE,GAAG,CAAC,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAE5E,IAAI,UAAU,EAAE;QACd,MAAM,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,CAAC,CAAA;KACxD;IAED,OAAO,EAAE,CAAA;AACX,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,OAAO,GAAG,KAAK,EAAE,QAAsB,EAAE,IAAkB,EAAE,UAAkB,EAAE,eAAgC,IAAI,EAAiB,EAAE;IAC5I,GAAG,CAAC,uBAAuB,IAAI,IAAI,CAAC,CAAA;IACpC,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,CAAC,CAAA;IAC1D,IAAI,CAAC,UAAU,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,CAAA;IAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;IACrB,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAA;IACzB,oCAAoC;IACpC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAA;AACpB,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,aAAa,GAAG,KAAK,EAAE,UAAkB,EAAiB,EAAE;IAChE,SAAS,KAAK,CAAC,IAAI;QACjB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAA;IAC1D,CAAC;IAED,GAAG,CAAC,4BAA4B,CAAC,CAAA;IAEjC,MAAM,IAAI,GAAG,MAAM,eAAe,EAAE,CAAA;IACpC,IAAI,CAAC,UAAU,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,CAAA;IAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,eAAe,EAAE,CAAC,EAAE,EAAE;QACxC,IAAI;YACF,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAA;YACzB,GAAG,CAAC,uCAAuC,CAAC,CAAA;YAC5C,MAAK;SACN;QAAC,OAAO,GAAG,EAAE;YACZ,IAAI,CAAC,GAAG,eAAe,GAAG,CAAC,EAAE;gBAC3B,KAAK,CAAC,+BAA+B,CAAC,CAAA;gBACtC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAA;aAClB;SACF;KACF;IACD,oCAAoC;IACpC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAA;AACpB,CAAC,CAAA;AAED;;;;;;GAMG;AACH,MAAM,QAAQ,GAAG,KAAK,EAAE,QAAsB,EAAE,IAAkB,EAAE,UAAkB,EAAE,eAAgC,IAAI,EAAiB,EAAE;IAC7I,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,CAAC,CAAA;IAC1D,IAAI,CAAC,UAAU,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,CAAA;IAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;IACrB,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAA;IAC3B,oCAAoC;IACpC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAA;AACpB,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,OAAO,GAAG,KAAK,EAAE,QAAsB,EAAE,IAAkB,EAAE,eAAgC,IAAI,EAAwB,EAAE;IAC/H,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAA;IAC9D,IAAI,CAAC,EAAE,EAAE;QACP,OAAO,qBAAqB,CAAA;KAC7B;IACD,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,CAAC,CAAA;IAC1D,MAAM,UAAU,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,CAAC,CAAA;IAEhD,UAAU,CAAC,IAAI,CAAC,CAAA;IAEhB,MAAM,QAAQ,CAAC,gBAAgB,CAAC,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAA;IACvE,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAA;IAEzD,MAAM,MAAM,GAAG,OAAO,EAAE,CAAA;IACxB,MAAM,MAAM,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,CAAC,CAAA;IAC5C,MAAM,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,CAAC,CAAA;IACxC,MAAM,MAAM,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,IAAI,eAAe,CAAC,CAAA;IAEzD,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED;;;;;GAKG;AACH,KAAK,UAAU,QAAQ,CAAC,QAAsB,EAAE,IAAY;IAC1D,IAAI,CAAC,GAAG,CAAC,CAAA;IACT,IAAI,IAAI,GAAG,IAAI,CAAA;IACf,OAAO,MAAM,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE;QAC3C,CAAC,EAAE,CAAA;QACH,IAAI,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,CAAA;KACrB;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,aAAa;IAC1B,IAAI,WAAW,EAAE;QACf,GAAG,CAAC,0BAA0B,CAAC,CAAA;QAC/B,MAAM,WAAW,CAAC,OAAO,EAAE,CAAA;KAC5B;IACD,IAAI,SAAS,EAAE;QACb,GAAG,CAAC,wBAAwB,CAAC,CAAA;QAC7B,MAAM,SAAS,CAAC,OAAO,EAAE,CAAA;KAC1B;IACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QACxC,GAAG,CAAC,iBAAiB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;QAC/B,MAAO,IAAI,CAAC,CAAC,CAAU,CAAC,OAAO,EAAE,CAAA;KAClC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,WAAW,CAAC,eAAgC,IAAI;IAC7D,MAAM,GAAG,GAAyB,EAAE,CAAA;IACpC,MAAM,KAAK,CAAC,UAAU,EAAE,CAAA;IACxB,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAA;IAChC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAA;IACxF,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE;QACpB,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;QAC3D,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,UAAgC,CAAA;QACtF,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;KACnD;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;GAEG;AACH,SAAS,OAAO;IACd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE;QAC7B,OAAO,IAAI,CAAA;KACZ;IACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;IAC7C,OAAO,GAAG,CAAC,QAAQ,CAAA;AACrB,CAAC;AAED,MAAM,CAAC,MAAM,EAAE,GAAG;IAChB,MAAM;IACN,WAAW;IACX,OAAO;IACP,aAAa;IACb,OAAO;IACP,MAAM;IACN,QAAQ;IACR,GAAG;IACH,SAAS;IACT,aAAa;IACb,SAAS;IACT,eAAe;IACf,OAAO;IACP,aAAa;IACb,WAAW;IACX,OAAO;IACP,aAAa;IACb,QAAQ;CACT,CAAA"}

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

@@ -0,0 +1,7 @@
+/**
+ * Database connectivity and utilities.
+ *
+ * @module tasenor-common-node/src/database
+ */
+export * from './BookkeeperImporter';
+export * from './DB';

package/dist/src/database/index.js

@@ -0,0 +1,8 @@
+/**
+ * Database connectivity and utilities.
+ *
+ * @module tasenor-common-node/src/database
+ */
+export * from './BookkeeperImporter';
+export * from './DB';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/database/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,sBAAsB,CAAA;AACpC,cAAc,MAAM,CAAA"}

package/dist/src/doccer.d.ts

@@ -0,0 +1,29 @@
+/**
+ *
+ * # Tasenor Common for Node
+ *
+ * Type definitions and functionality implementation for Node.
+ *
+ * An interactive stateful process is a backend system which handles a process with a
+ * states, but the transition from one state to another could need user input from
+ * the client - e.g. web browser.
+ *
+ * ## Sub-modules
+ *
+ * * [cli](tasenor_common_node_src_cli.html)
+ * * [database](tasenor_common_node_src_database.html)
+ * * [export](tasenor_common_node_src_export.html)
+ * * [import](tasenor_common_node_src_import.html)
+ * * [net](tasenor_common_node_src_net.html)
+ * * [plugins](tasenor_common_node_src_plugins.html)
+ * * [reports](tasenor_common_node_src_reports.html)
+ * * [system](tasenor_common_node_src_system.html)
+ * * [common](tasenor_common_node_src_common.html)
+ * * [error](tasenor_common_node_src_error.html)
+ * * [import](tasenor_common_node_src_import.html)
+ * * [process](tasenor_common_node_src_process.html)
+ * * [server](tasenor_common_node_src_server.html)
+ *
+ * @module tasenor-common-node
+ */
+export * from './index';

package/dist/src/doccer.js

@@ -0,0 +1,30 @@
+/**
+ *
+ * # Tasenor Common for Node
+ *
+ * Type definitions and functionality implementation for Node.
+ *
+ * An interactive stateful process is a backend system which handles a process with a
+ * states, but the transition from one state to another could need user input from
+ * the client - e.g. web browser.
+ *
+ * ## Sub-modules
+ *
+ * * [cli](tasenor_common_node_src_cli.html)
+ * * [database](tasenor_common_node_src_database.html)
+ * * [export](tasenor_common_node_src_export.html)
+ * * [import](tasenor_common_node_src_import.html)
+ * * [net](tasenor_common_node_src_net.html)
+ * * [plugins](tasenor_common_node_src_plugins.html)
+ * * [reports](tasenor_common_node_src_reports.html)
+ * * [system](tasenor_common_node_src_system.html)
+ * * [common](tasenor_common_node_src_common.html)
+ * * [error](tasenor_common_node_src_error.html)
+ * * [import](tasenor_common_node_src_import.html)
+ * * [process](tasenor_common_node_src_process.html)
+ * * [server](tasenor_common_node_src_server.html)
+ *
+ * @module tasenor-common-node
+ */
+export * from './index';
+//# sourceMappingURL=doccer.js.map

package/dist/src/doccer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doccer.js","sourceRoot":"","sources":["../../src/doccer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,cAAc,SAAS,CAAA"}

package/dist/src/error.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Error types for processing and an exception used to ask more information from UI.
+ *
+ * @module tasenor-common-node/src/error
+ */
+import { TasenorElement } from '@tasenor/common';
+export declare class ProcessingError extends Error {
+}
+export declare class InvalidFile extends ProcessingError {
+}
+export declare class InvalidArgument extends ProcessingError {
+}
+export declare class BadState extends ProcessingError {
+}
+export declare class NotImplemented extends ProcessingError {
+}
+export declare class NotFound extends ProcessingError {
+}
+export declare class DatabaseError extends ProcessingError {
+}
+export declare class SystemError extends ProcessingError {
+}
+/**
+ * Special exception to halt processing in order to require more configuration information from UI.
+ */
+export declare class AskUI extends Error {
+    element: TasenorElement;
+    constructor(element: TasenorElement);
+}
+export declare function isAskUI(obj: unknown): obj is AskUI;

package/dist/src/error.js

@@ -0,0 +1,35 @@
+/**
+ * Error types for processing and an exception used to ask more information from UI.
+ *
+ * @module tasenor-common-node/src/error
+ */
+export class ProcessingError extends Error {
+}
+export class InvalidFile extends ProcessingError {
+}
+export class InvalidArgument extends ProcessingError {
+}
+export class BadState extends ProcessingError {
+}
+export class NotImplemented extends ProcessingError {
+}
+export class NotFound extends ProcessingError {
+}
+export class DatabaseError extends ProcessingError {
+}
+export class SystemError extends ProcessingError {
+}
+/**
+ * Special exception to halt processing in order to require more configuration information from UI.
+ */
+export class AskUI extends Error {
+    element;
+    constructor(element) {
+        super('Need more information from UI.');
+        this.element = element;
+    }
+}
+export function isAskUI(obj) {
+    return (obj instanceof Error) && 'element' in obj;
+}
+//# sourceMappingURL=error.js.map

package/dist/src/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,OAAO,eAAgB,SAAQ,KAAK;CAAG;AAC7C,MAAM,OAAO,WAAY,SAAQ,eAAe;CAAG;AACnD,MAAM,OAAO,eAAgB,SAAQ,eAAe;CAAG;AACvD,MAAM,OAAO,QAAS,SAAQ,eAAe;CAAG;AAChD,MAAM,OAAO,cAAe,SAAQ,eAAe;CAAG;AACtD,MAAM,OAAO,QAAS,SAAQ,eAAe;CAAG;AAChD,MAAM,OAAO,aAAc,SAAQ,eAAe;CAAG;AACrD,MAAM,OAAO,WAAY,SAAQ,eAAe;CAAG;AAEnD;;GAEG;AACH,MAAM,OAAO,KAAM,SAAQ,KAAK;IACvB,OAAO,CAAgB;IAE9B,YAAY,OAAuB;QACjC,KAAK,CAAC,gCAAgC,CAAC,CAAA;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;CACF;AAED,MAAM,UAAU,OAAO,CAAC,GAAY;IAClC,OAAO,CAAC,GAAG,YAAY,KAAK,CAAC,IAAI,SAAS,IAAI,GAAG,CAAA;AACnD,CAAC"}

package/dist/src/export/Exporter.d.ts

@@ -0,0 +1,69 @@
+import { KnexDatabase } from '..';
+import { ParsedTsvFileData, BookkeeperConfig, DirectoryPath, TsvFilePath, JsonFilePath, Json, TarFilePath } from '@tasenor/common';
+/**
+ * Common functionality for exporters.
+ */
+export declare class Exporter {
+    /**
+     * Version number of the file format produced by this exporter.
+     */
+    VERSION: number;
+    /**
+     * Read all accounts from the database and generate TSV-data.
+     * @param db Knex connection to use.
+     * @returns
+     */
+    getAccounts(db: KnexDatabase): Promise<ParsedTsvFileData>;
+    /**
+     * Read all periods from the database and generate TSV-data.
+     * @param db Knex connection to use.
+     * @returns
+     */
+    getPeriods(db: KnexDatabase): Promise<ParsedTsvFileData>;
+    /**
+     * Read all entries and documents from the database and generate TSV-data.
+     * @param db Knex connection to use.
+     * @returns
+     */
+    getEntries(db: KnexDatabase): Promise<ParsedTsvFileData>;
+    /**
+     * Read configuration information from database and construct compiled configuration.
+     * @param db Knex connection to use.
+     * @returns
+     */
+    getConfig(db: KnexDatabase): Promise<BookkeeperConfig>;
+    /**
+     * Read all tags from the database and generate TSV-data.
+     * @param db Knex connection to use.
+     * @param out Directory to write image files.
+     * @returns
+     */
+    getTags(db: KnexDatabase, out: DirectoryPath): Promise<ParsedTsvFileData>;
+    /**
+     * Write prepared data to TSV file.
+     * @param path Output file path.
+     * @param lines Data content.
+     */
+    writeTsv(path: TsvFilePath, lines: ParsedTsvFileData): void;
+    /**
+     * Write prepared data to JSON file.
+     * @param path Output file path.
+     * @param lines Data content.
+     */
+    writeJson(path: JsonFilePath, data: Json): void;
+    /**
+     * Save complete backup of the Sqlite database to the given directory.
+     * @param db Database connection.
+     * @param out Directory to store all files.
+     * @returns Configuration constructed from the database.
+     */
+    dump(db: KnexDatabase, out: DirectoryPath): Promise<BookkeeperConfig>;
+    /**
+     * Construct a tar-package for the given configuration from the source directory.
+     * @param conf Configuration found from the database.
+     * @param out Directory containing files extracted as a backup.
+     * @param destPath Destionation file name if given.
+     * @returns Path to the tar-package.
+     */
+    makeTar(conf: BookkeeperConfig, out: DirectoryPath, destPath: DirectoryPath | undefined): Promise<TarFilePath>;
+}