anote-server-libs 0.0.1

package/models/ApiCall.ts

@@ -0,0 +1,28 @@
+import {Pool} from 'pg';
+import {Logger} from 'winston';
+import {Model, ModelDao} from './repository/ModelDao';
+
+export interface ApiCall extends Model<string> {
+    responseCode: number;
+    responseJson: string;
+    expiresAt: Date;
+}
+
+export class ApiCallRepository extends ModelDao<string, ApiCall> {
+    constructor(protected pool: Pool, protected logger: Logger) {
+        super(pool, logger, 'api_call', 5, 'id=$1,"updatedOn"=$2,"responseCode"=$3,"responseJson"=$4,"expiresAt"=$5');
+    }
+
+    buildObject(q: any): ApiCall {
+        if(!q) return undefined;
+        q.id = q.id.trim();
+        q.updatedOn = q.updatedOn && new Date(q.updatedOn);
+        q.responseCode = parseInt(q.responseCode, 10);
+        q.expiresAt = q.expiresAt && new Date(q.expiresAt);
+        return q;
+    }
+
+    serialize(instance: ApiCall): any[] {
+        return [instance.id, instance.updatedOn, instance.responseCode, instance.responseJson, instance.expiresAt];
+    }
+}

package/models/Migration.ts

@@ -0,0 +1,29 @@
+import {Pool} from 'pg';
+import {Logger} from 'winston';
+import {ModelDao} from './repository/ModelDao';
+
+export interface Migration {
+    id: number;
+    hash: string;
+    sqlUp: string;
+    sqlDown: string;
+    state: number;
+}
+
+export class MigrationRepository extends ModelDao<number, Migration> {
+    constructor(protected pool: Pool, protected logger: Logger) {
+        super(pool, logger, 'migration', 5, 'id=$1,hash=$2,"sqlUp"=$3,"sqlDown"=$4,state=$5');
+    }
+
+    buildObject(q: any): Migration {
+        if(!q) return undefined;
+        q.id = parseInt(q.id, 10);
+        q.hash = q.hash.trim();
+        q.state = parseInt(q.state, 10);
+        return q;
+    }
+
+    serialize(instance: Migration): any[] {
+        return [instance.id, instance.hash, instance.sqlUp, instance.sqlDown, instance.state];
+    }
+}

package/models/repository/BaseModelRepository.ts

@@ -0,0 +1,135 @@
+import * as fs from 'fs';
+import * as Memcached from 'memcached';
+import {md} from 'node-forge';
+import {ClientBase, Pool} from 'pg';
+import {Logger} from 'winston';
+import { ApiCallRepository } from '../ApiCall';
+import { Migration, MigrationRepository } from '../Migration';
+import {ModelRepr} from './ModelDao';
+
+export class BaseModelRepository {
+    Migration: MigrationRepository;
+    ApiCall: ApiCallRepository;
+
+    constructor(public db: Pool, public dbSpare: Pool, public logger: Logger, public cache: Memcached) {
+        const dbQuery = db.query.bind(db);
+        db.query = (function(text: any, values: any, cb: any) {
+            if((this.idleCount + this.waitingCount) >= this.totalCount && this.totalCount === this.options.max)
+                return dbSpare.query(text, values, cb);
+            return dbQuery(text, values, cb);
+        }).bind(db);
+        this.Migration = new MigrationRepository(db, logger);
+        this.ApiCall = new ApiCallRepository(db, logger);
+    }
+
+    migrate(migrationsPath: string, callback: (() => void)) {
+        this.db.query('CREATE TABLE IF NOT EXISTS migration (' +
+            'id integer PRIMARY KEY,' +
+            'hash text NOT NULL,' +
+            '"sqlUp" text NOT NULL,' +
+            '"sqlDown" text NOT NULL,' +
+            'state integer NOT NULL' +
+            ')').then(() => {
+            this.Migration.getAllBy('id').then((migrations: Migration[]) => {
+                if(migrations.find(migration => migration.state !== 0)) process.exit(4); // Have to fix manually
+                // Read the new ones
+                fs.readdir(migrationsPath, (_, files) => {
+                    const migrationsAvailable = files
+                        .filter(file => /[0-9]+\.sql/.test(file))
+                        .map(file => parseInt(file.split('.sql')[0], 10))
+                        .filter(file => file > 0)
+                        .sort((a, b) => a - b)
+                        .map(file => {
+                            const content = fs.readFileSync(migrationsPath + file + '.sql', 'utf-8');
+                            return {
+                                id: file,
+                                content: content,
+                                hash: md.sha256.create().update(content).digest().toHex()
+                            };
+                        });
+                    if(migrationsAvailable.length === 0
+                        || migrationsAvailable.length
+                        !== migrationsAvailable[migrationsAvailable.length - 1].id) process.exit(5); // Did not use OK files
+                    let highestCommon = 0;
+                    while(highestCommon < migrations.length && highestCommon < migrationsAvailable.length
+                    && migrations[highestCommon].hash === migrationsAvailable[highestCommon].hash)
+                        highestCommon++;
+                    this.applyDownUntil(migrations, migrations.length, highestCommon).then(() => {
+                        this.applyUpUntil(migrationsAvailable, highestCommon, migrationsAvailable.length).then(callback, process.exit);
+                    }, process.exit);
+                });
+            }, () => process.exit(3));
+        }, () => process.exit(2));
+    }
+
+    lockTables(tables: ModelRepr[], client: ClientBase): Promise<any> {
+        return Promise.all(tables.map(t => client.query('LOCK TABLE ' + t.table + ' IN EXCLUSIVE MODE')));
+    }
+
+    private applyUpUntil(migrations: {id: number, content: string, hash: string}[], current: number, until: number): Promise<void> {
+        if(current < until)
+            return this.applyUp(migrations[current]).then(() => this.applyUpUntil(migrations, current + 1, until));
+        return Promise.resolve();
+    }
+
+    private applyUp(migration: {id: number, content: string, hash: string}): Promise<void> {
+        return new Promise((resolve, reject) => {
+            const sqlParts = migration.content.split('----');
+            this.Migration.create({
+                id: migration.id,
+                hash: migration.hash,
+                sqlUp: sqlParts[0],
+                sqlDown: sqlParts[1],
+                state: 2
+            }).then(() => {
+                this.db.query(sqlParts[0], (err: any) => {
+                    if(err) {
+                        console.error(err);
+                        reject(10);
+                    } else {
+                        this.db.query('UPDATE "migration" SET "state"=0 WHERE "id"=' + migration.id, (err2: any) => {
+                            if(err2) reject(11); // No cleanup
+                            else resolve();
+                        });
+                    }
+                });
+            }, () => process.exit(9));
+        });
+    }
+
+    private applyDownUntil(migrations: Migration[], current: number, until: number): Promise<void> {
+        if(current > until) {
+            current--;
+            return this.applyDown(migrations[current]).then(() => this.applyDownUntil(migrations, current, until));
+        }
+        return Promise.resolve();
+    }
+
+    private applyDown(migration: Migration): Promise<void> {
+        return new Promise((resolve, reject) => {
+            this.db.query('UPDATE "migration" SET "state"=1 WHERE "id"=' + migration.id, (err: any) => {
+                if(err) reject(6); // No required change
+                else this.db.query(migration.sqlDown, (err2: any) => {
+                    if(err2) {
+                        console.error(err2);
+                        reject(7);
+                    } // No apply down
+                    else this.db.query('DELETE FROM "migration" WHERE "id"=' + migration.id, (err3: any) => {
+                        if(err3 && migration.id !== 1) reject(8); // No cleanup for not base migration
+                        else {
+                            if(migration.id === 1) {
+                                this.db.query('CREATE TABLE IF NOT EXISTS migration (' +
+                                    'id integer PRIMARY KEY,' +
+                                    'hash text NOT NULL,' +
+                                    '"sqlUp" text NOT NULL,' +
+                                    '"sqlDown" text NOT NULL,' +
+                                    'state integer NOT NULL' +
+                                    ')').then(() => resolve(), reject);
+                            } else resolve();
+                        }
+                    });
+                });
+            });
+        });
+    }
+}

package/models/repository/MemoryCache.ts

@@ -0,0 +1,87 @@
+import * as Memcached from 'memcached';
+
+export class MemoryCache<T> {
+
+    private localCache = {};
+
+    constructor(private localKey: string, private cache?: Memcached) {
+    }
+
+    list(): Promise<T[]> {
+        if(this.cache) return new Promise(resolve => {
+            let pending = true;
+            setTimeout(() => {
+                if(pending) {
+                    pending = false;
+                    resolve([]);
+                }
+            }, 250);
+            this.cache.items((_, data) => {
+                if(pending) {
+                    pending = false;
+                    resolve(data.map(s => {
+                        const value = <string>s[Object.getOwnPropertyNames(s).find(sname => sname.startsWith(this.localKey))];
+                        return value && JSON.parse(value);
+                    }).filter(x => x));
+                }
+            });
+        });
+        else return Promise.resolve(Object.getOwnPropertyNames(this.localCache).map(key => this.localCache[key]));
+    }
+
+    get(key: string | number): Promise<T> {
+        if(this.cache) return new Promise(resolve => {
+            let pending = true;
+            setTimeout(() => {
+                if(pending) {
+                    pending = false;
+                    resolve(undefined);
+                }
+            }, 250);
+            this.cache.get(this.localKey + key, (_, data) => {
+                if(pending) {
+                    pending = false;
+                    resolve(data && JSON.parse(data));
+                }
+            });
+        });
+        else return Promise.resolve(this.localCache[key]);
+    }
+
+    set(key: string | number, val: T): Promise<void> {
+        if(this.cache) return new Promise(resolve => this.cache.add(this.localKey + key, JSON.stringify(val), 15 * 60, resolve));
+        else {
+            this.localCache[key] = val;
+            return Promise.resolve();
+        }
+    }
+
+    delete(key: string | number): Promise<void> {
+        if(this.cache) {
+            return new Promise(resolve => {
+                let fired = false;
+                const handler = setTimeout(() => {
+                    fired = true;
+                    resolve();
+                }, 50);
+                this.cache.del(this.localKey + key, () => {
+                    if(!fired) {
+                        clearTimeout(handler);
+                        resolve();
+                    }
+                });
+            });
+        } else {
+            this.localCache[key] = undefined;
+            return Promise.resolve();
+        }
+    }
+
+    clear() {
+        if(this.cache) {
+            this.localKey = this.localKey + '_';
+            if(this.localKey.length > 40)
+                this.localKey = this.localKey.replace(/_+$/, '');
+        } else this.localCache = {};
+    }
+}

package/models/repository/ModelDao.ts

@@ -0,0 +1,103 @@
+import {ClientBase, Pool} from 'pg';
+import {Logger} from 'winston';
+
+export interface Model<T> {
+    id?: T;
+    updatedOn?: Date;
+}
+
+export interface ModelRepr {
+    table: string;
+}
+
+export interface ViewCount<T> {
+    views: T[];
+    count: number;
+}
+
+abstract class Dao<R, T extends Model<R>> implements ModelRepr {
+    constructor(protected pool: Pool, protected logger: Logger, public table: string, protected nFields: number,
+                protected updateDefinition: string) {
+    }
+
+    groupResultSet(q: any[], key: (qs: any) => string): any[][] {
+        const storage = {};
+        for(let i = 0; i < q.length; i++) {
+            storage[key(q[i])] = storage[key(q[i])] || [];
+            storage[key(q[i])].push(q[i]);
+        }
+        return Object.getOwnPropertyNames(storage).map(k => storage[k]);
+    }
+
+    update(instance: T, client: ClientBase): Promise<R> {
+        instance.updatedOn = new Date();
+        const props = this.serialize(instance);
+        props.push(instance.id);
+        return client.query('UPDATE ' + this.table + ' SET ' + this.updateDefinition + ' WHERE id=$' + (this.nFields + 1), props).then(() => instance.id);
+    }
+
+    create(instance: T, client?: ClientBase): Promise<R> {
+        instance.updatedOn = new Date();
+        const props = this.serialize(instance);
+        return (client || this.pool).query('INSERT INTO ' + this.table + '(' + this.updateDefinition.replace(/=\$\d+/g, '') + ')'
+            + ' VALUES(' + new Array(this.nFields).fill(undefined).map((_, i: number) => '$' + (i + 1)).join(',') + ') RETURNING id',
+            props).then(q => {
+                const idNum = parseInt(q.rows[0].id, 10);
+                if(String(idNum) !== q.rows[0].id) return q.rows[0].id;
+                return idNum;
+            });
+    }
+
+    createSeveral(instances: T[], client?: ClientBase): Promise<R[]> {
+        if(!instances.length) return Promise.resolve([]);
+        const now = new Date();
+        instances.forEach(instance => instance.updatedOn = now);
+        const props = [].concat.apply([], instances.map(instance => this.serialize(instance)));
+        return (client || this.pool).query('INSERT INTO ' + this.table + '(' + this.updateDefinition.replace(/=\$\d+/g, '') + ')'
+            + ' VALUES' + instances.map((_, j) =>
+                ('(' + new Array(this.nFields).fill(undefined).map((__, i: number) => '$' + (j * this.nFields + i + 1)).join(', ') + ')')).join(',') + ' RETURNING id',
+            props).then(q => q.rows.map(r => {
+                const idNum = parseInt(r.id, 10);
+                if(String(idNum) !== q.rows[0].id) return r.id;
+                return idNum;
+            }));
+    }
+
+    protected abstract buildObject(q: any): T;
+
+    protected abstract serialize(instance: T): any[];
+}
+
+export abstract class ModelDao<R, T extends Model<R>> extends Dao<R, T> {
+    get(id: R, client?: ClientBase, lock = true): Promise<T> {
+        return (client || this.pool).query('SELECT * FROM ' + this.table + ' WHERE id=$1' + ((client && lock) ? ' FOR UPDATE' : ''), [id]).then(q => this.buildObject(q.rows[0]));
+    }
+
+    count(where?: string, inputs: any[] = [], client?: ClientBase): Promise<number> {
+        return (client || this.pool).query('SELECT count(*) AS cnt FROM ' + this.table + (where ? (' WHERE ' + where) : ''), inputs).then(q => parseInt(q.rows[0].cnt, 10));
+    }
+
+    getList(ids: R[], client?: ClientBase, lock = true): Promise<T[]> {
+        return (client || this.pool).query('SELECT * FROM ' + this.table + ' WHERE id=ANY($1)' + ((client && lock) ? ' FOR UPDATE' : ''), [ids])
+            .then(q => q.rows.map(r => this.buildObject(r)));
+    }
+
+    getAllBy(order?: string, offset?: number, limit?: number, where?: string, inputs: any[] = [], client?: ClientBase, lock = true): Promise<T[]> {
+        return (client || this.pool).query('SELECT * FROM ' + this.table + (where ? (' WHERE ' + where) : '') + (order ? (' ORDER BY ' + order) : '')
+            + (offset ? (' OFFSET ' + offset) : '') + (limit !== undefined ? (' LIMIT ' + limit) : '') + ((client && lock) ? ' FOR UPDATE' : ''), inputs)
+            .then(q => q.rows.map(r => this.buildObject(r)));
+    }
+
+    getViewCountBy(order?: string, offset?: number, limit?: number, where?: string, inputs: any[] = [], client?: ClientBase, lock = true): Promise<ViewCount<T>> {
+        return (client || this.pool).query('SELECT *, COUNT(*) OVER() AS cnt FROM ' + this.table + (where ? (' WHERE ' + where) : '') + (order ? (' ORDER BY ' + order) : '')
+            + (offset ? (' OFFSET ' + offset) : '') + (limit !== undefined ? (' LIMIT ' + limit) : '') + ((client && lock) ? ' FOR UPDATE' : ''), inputs)
+            .then(q => ({
+                views: q.rows.map(r => this.buildObject(r)),
+                count: q.rows.length ? parseInt(q.rows[0].cnt, 10) : 0
+            }));
+    }
+
+    delete(id: R, client: ClientBase): Promise<any> {
+        return client.query('DELETE FROM ' + this.table + ' WHERE id=$1', [id]);
+    }
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "anote-server-libs",
+  "version": "0.0.1",
+  "description": "Helpers for express-TS servers",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.anotemusic.com/anote/anote-server-libs.git"
+  },
+  "keywords": [
+    "Express"
+  ],
+  "author": "Mathonet Gregoire",
+  "license": "MIT",
+  "dependencies": {
+    "express": "4.17.2",
+    "jsonschema": "1.4.0",
+    "memcached": "2.2.2",
+    "node-forge": "1.2.1",
+    "pg": "8.7.3",
+    "winston": "3.5.1"
+  },
+  "devDependencies": {
+    "@types/node": "14.18.2"
+  }
+}

package/services/WithBody.ts

@@ -0,0 +1,56 @@
+import {Request, Response} from 'express';
+import {SchemaError, Validator} from 'jsonschema';
+
+export function WithBody(schema: any) {
+    const validator = new Validator();
+    validator.attributes.maxDigits = (instance, sc: any) => {
+        if(typeof instance !== 'number') return undefined;
+        if(typeof sc.maxDigits !== 'number' || Math.floor(sc.maxDigits) !== sc.maxDigits) {
+            throw new SchemaError('"maxDigits" expects an integer', sc);
+        }
+        if(Math.round(instance * 10 ** sc.maxDigits) / (10 ** sc.maxDigits) !== instance) {
+            return 'has more precision than ' + sc.maxDigits + ' digits';
+        }
+        return undefined;
+    };
+
+    return function(_: any, __: string, descriptor: PropertyDescriptor) {
+        if(typeof descriptor.value === 'function') {
+            const previousMethod = descriptor.value;
+            descriptor.value = function(this: any, req: Request, res: Response) {
+                const keys = Object.getOwnPropertyNames(schema.properties);
+                keys.forEach(key => {
+                    if(typeof schema.properties[key] === 'string') {
+                        schema.properties[key] = this.config.app.endpointsSchemas[schema.properties[key]];
+                    }
+                });
+                if(req.method.toUpperCase() !== 'POST' && req.method.toUpperCase() !== 'PUT') {
+                    return previousMethod.call(this, req, res);
+                }
+                if(!req.body) {
+                    res.status(400).json({
+                        error: {
+                            errorKey: 'client.body.missing',
+                            additionalInfo: 'client.extended.badPayload'
+                        }
+                    });
+                } else {
+                    const result = validator.validate(req.body, schema);
+                    if(result.valid) {
+                        return previousMethod.call(this, req, res);
+                    } else {
+                        res.status(400).json({
+                            error: {
+                                errorKey: 'client.body.missing',
+                                additionalInfo: 'client.extended.badPayload',
+                                detailedInfo: result.errors
+                            }
+                        });
+                    }
+                }
+            };
+            return descriptor;
+        }
+        return undefined;
+    };
+}

package/services/WithTransaction.ts

@@ -0,0 +1,146 @@
+import {NextFunction, Request, Response} from 'express';
+import {Logger} from 'winston';
+import {BaseModelRepository} from '../models/repository/BaseModelRepository';
+import {utils} from './utils';
+
+export const enum SystemLock {
+    CHECK_CROSSING = 1,
+    FLUSH_CALLS = 2
+}
+
+function jsonStringify(obj: any): string {
+    const cache: any = {};
+    return JSON.stringify(obj, function(_, value) {
+        if(typeof value === 'object' && value !== null) {
+            if(cache[value] !== -1) {
+                try {
+                    return JSON.parse(JSON.stringify(value));
+                } catch(error) {
+                    return;
+                }
+            }
+            cache[value] = true;
+        }
+        return value;
+    });
+}
+
+export function withTransaction(repo: BaseModelRepository, logger: Logger, previousMethod: (req: Request, res: Response, next: NextFunction) => void, lock?: SystemLock) {
+    return function(req: Request, res: Response, next: NextFunction) {
+        const endTerminator = res.end.bind(res);
+        const jsonTerminator = (obj: any) => {
+            res.write(jsonStringify(obj) || '{}');
+            endTerminator();
+        };
+        const connectTimeoutHandler = setTimeout(() => {
+            // Timed out getting a client, restart worker or process...
+            logger.error('Error timed out getting a client, exiting...');
+            process.exit(22);
+        }, 3000);
+        repo.db.connect().then(dbClient => {
+            clearTimeout(connectTimeoutHandler);
+            // On error, will rollback...
+            utils.logger = logger;
+            dbClient.removeListener('error', utils.clientErrorHandler);
+            dbClient.on('error', utils.clientErrorHandler);
+
+            res.locals.dbClient = dbClient;
+            res.locals.dbClientCommited = false;
+            res.locals.dbClientCommit = (cb: (err: any) => any) => {
+                if(!res.locals.dbClientCommited) {
+                    res.locals.dbClientCommited = true;
+                    dbClient.query('COMMIT').catch(err => err).then((err: any) => {
+                        dbClient.release();
+                        if(!(err instanceof Error)) {
+                            for(let i = 0; i < res.locals.dbClientOnCommit.length; i++) {
+                                res.locals.dbClientOnCommit[i]();
+                            }
+                        }
+                        cb(err instanceof Error ? err : undefined);
+                    });
+                } else {
+                    cb(undefined);
+                }
+            };
+            res.locals.dbClientOnCommit = [];
+            return dbClient.query('BEGIN').then(() => {
+                const finish = () => {
+                    res.json = (obj: any) => {
+                        if(res.statusCode > 303 && res.statusCode !== 412) {
+                            if(logger && res.statusCode > 499) {
+                                logger.error('Uncaught 500: %j', obj.error.additionalInfo);
+                            }
+                            dbClient.query('ROLLBACK').catch(err => obj.error.additionalInfo2 = {message: err.message}).then(() => {
+                                dbClient.release();
+                                jsonTerminator(obj);
+                            });
+                        } else {
+                            res.locals.dbClientCommit((err: any) => {
+                                if(err) {
+                                    res.status(500);
+                                    jsonTerminator({
+                                        error: {
+                                            errorKey: 'internal.db',
+                                            additionalInfo: {message: err.message}
+                                        }
+                                    });
+                                } else jsonTerminator(obj);
+                            });
+                        }
+                        return res;
+                    };
+                    res.end = () => {
+                        if(res.statusCode > 303 && res.statusCode !== 412) {
+                            if(logger && res.statusCode > 499) {
+                                logger.error('Uncaught 500 with no details...');
+                            }
+                            dbClient.query('ROLLBACK').catch((): any => undefined).then(() => {
+                                dbClient.release();
+                                endTerminator();
+                            });
+                        } else {
+                            res.locals.dbClientCommit((err: any) => {
+                                if(err) {
+                                    res.status(500);
+                                    jsonTerminator({
+                                        error: {
+                                            errorKey: 'internal.db',
+                                            additionalInfo: {message: err.message}
+                                        }
+                                    });
+                                } else endTerminator();
+                            });
+                        }
+                        return res;
+                    };
+                    return previousMethod.call(this, req, res, next);
+                };
+
+                if(lock) {
+                    dbClient.query('SELECT pg_advisory_xact_lock(' + lock + ')').then(() => finish()).catch(err => {
+                        res.status(500).json({
+                            error: {
+                                errorKey: 'internal.db',
+                                additionalInfo: {message: err.message}
+                            }
+                        });
+                        dbClient.release();
+                    });
+                } else {
+                    finish();
+                }
+            }).catch(err => {
+                dbClient.release();
+                throw err;
+            });
+        }).catch(err => {
+            // Error connecting to database, restarting worker after the timeout as well...
+            res.status(500).json({
+                error: {
+                    errorKey: 'internal.db',
+                    additionalInfo: {message: err.message}
+                }
+            });
+        });
+    };
+}

package/services/utils.ts

@@ -0,0 +1,158 @@
+import {NextFunction, Request, Response} from 'express';
+import {md} from 'node-forge';
+import {Logger} from 'winston';
+import {BaseModelRepository} from '../models/repository/BaseModelRepository';
+
+export function atob(str: string): string {
+    return Buffer.from(str, 'base64').toString('binary');
+}
+
+export function btoa(str: string): string {
+    return Buffer.from(str).toString('base64');
+}
+
+export function clientErrorHandle(this: Logger, err: any) {
+    this.error('Error on DB client: %j', err);
+}
+export const utils: {[id: string]: any} = {
+    clientErrorHandler: undefined
+};
+
+function gcdTwo(a: number, b: number): number {
+    if(a === 0)
+        return b;
+    return gcdTwo(b % a, a);
+}
+
+export function gcd(values: number[]): number {
+    let result = values[0];
+    for(let i = 1; i < values.length; i++)
+        result = gcdTwo(values[i], result);
+    return result;
+}
+
+export function lcm(values: number[]): number {
+    let l = 1, divisor = 2;
+    while(true) {
+        let counter = 0;
+        let divisible = false;
+        for(let i = 0; i < values.length; i++) {
+            if(values[i] === 0) {
+                return 0;
+            } else if(values[i] < 0) {
+                values[i] = values[i] * (-1);
+            }
+            if(values[i] === 1) {
+                counter++;
+            }
+            if(values[i] % divisor === 0) {
+                divisible = true;
+                values[i] = values[i] / divisor;
+            }
+        }
+        if(divisible) {
+            l = l * divisor;
+        } else {
+            divisor++;
+        }
+        if(counter === values.length) {
+            return l;
+        }
+    }
+}
+
+export function idempotent(repo: BaseModelRepository, debug: boolean, logger: Logger) {
+    return function(req: Request, res: Response, next: NextFunction) {
+        let idempotenceKey = req.header('x-idempotent-key');
+        if(idempotenceKey) {
+            idempotenceKey = idempotenceKey.substring(0, 40);
+            repo.ApiCall.get(idempotenceKey).then(call => {
+                if(!call) {
+                    const jsonTerminator = res.json;
+                    const endTerminator = res.end;
+                    res.json = (function(obj: any) {
+                        repo.ApiCall.create({
+                            id: idempotenceKey,
+                            responseCode: res.statusCode,
+                            responseJson: JSON.stringify(obj),
+                            expiresAt: new Date(Date.now() + 24 * 60 * 60 * 1000)
+                        }).then(() => jsonTerminator(obj), err => {
+                            if(err) logger.warn('Cannot save idempotent key: %j', err);
+                            jsonTerminator(obj);
+                        });
+                    }).bind(res);
+                    res.end = (function() {
+                        repo.ApiCall.create({
+                            id: idempotenceKey,
+                            responseCode: res.statusCode,
+                            responseJson: undefined,
+                            expiresAt: new Date(Date.now() + 24 * 60 * 60 * 1000)
+                        }).then(() => endTerminator(), err => {
+                            if(err) logger.warn('Cannot save idempotent key: %j', err);
+                            endTerminator();
+                        });
+                    }).bind(res);
+                    next();
+                } else res.status(417).json({
+                    responseCode: call.responseCode,
+                    responseBody: JSON.parse(call.responseJson)
+                });
+            }, err => res.status(500).json({
+                error: {
+                    errorKey: 'internal.db',
+                    additionalInfo: {message: err.message, stack: debug && err.stack}
+                }
+            }));
+        } else next();
+    };
+}
+
+export function sendSelfPostableMessage(res: Response, code: number, messageType: string, err?: any) {
+    res.type('text/html').status(code).write(`
+<!DOCTYPE HTML>
+<html>
+<head>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+</head>
+<body>
+<script type="text/javascript">
+    window.parent.postMessage({
+        type: '${messageType}',
+        confirm: ${!err},
+        error: JSON.parse('${JSON.stringify(err) || 'null'}')
+    }, '*');
+</script>
+</body>
+</html>
+    `);
+    res.end();
+}
+
+export function fpEuros(n: number) {
+    return Math.round(n * 100) / 100;
+}
+
+export function digitize(value: number | string, opts?: {[key: string]: any}): string {
+    if(value === undefined || value === null) return 'undefined';
+    if(typeof value === 'number') {
+        if(isNaN(value)) return '-';
+        if(!isFinite(value)) return 'Infinite';
+        value = String(value);
+    } else if(typeof value === 'string') return value;
+
+    const parts = value.split('.');
+    const initialLength = parts[0].length;
+    for(let i = initialLength - 3; i > 0; i -= 3) {
+        parts[0] = parts[0].slice(0, i) + ',' + parts[0].slice(i);
+    }
+    if(parts[0].startsWith('-,'))
+        parts[0] = '-' + parts[0].slice(2);
+    if(parts[1]) {
+        const expDecimals = parts[1].split(/[eE]-/);
+        if (expDecimals.length > 1 && parseInt(expDecimals[1], 10) > 2) return '0.00';
+        let decimals = fpEuros(parseFloat('0.' + parts[1])).toString().substr(2, 2);
+        if (decimals.length === 1) decimals += '0';
+        return parts[0] + '.' + decimals;
+    }
+    return (opts && opts.currency)? (parts[0] + '.00') : parts[0];
+}