@storyous/test-utils 1.0.0

package/README.md

@@ -0,0 +1,29 @@
+# `testUtils`
+
+## Usage
+
+``` typescript
+import * as assert from 'assert';
+import Koa from 'koa';
+import { describe, it } from 'mocha';
+import mailer from '@storyous/mailer';
+import testUtils from '@storyous/test-utils';
+
+testUtils.init(
+ () => new Koa(),
+ testUtils.uniqueDatabase('mongodb://127.0.0.0:27017/test'),
+ mailer,
+);
+
+describe('some test', async () => {
+
+    it('should do some request', async () => {
+        await testUtils.request().get('/').expect(200);
+    });
+    
+    it('should getSent emails', async () => {
+        await mailer.sendMail({});
+        assert.deepStrictEqual(testUtils.getSentMails(), []);
+    });
+};
+```

package/__tests__/testUtils.test.js

@@ -0,0 +1,48 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const mailer_1 = __importDefault(require("@storyous/mailer"));
+const assert = __importStar(require("assert"));
+const koa_1 = __importDefault(require("koa"));
+const mocha_1 = require("mocha");
+const testUtils_1 = __importDefault(require("../lib/testUtils"));
+testUtils_1.default.init(() => new koa_1.default(), 'mongodb://127.0.0.1/testing', mailer_1.default);
+(0, mocha_1.describe)('packages/testUtils', async () => {
+    (0, mocha_1.it)('should do some request', async () => {
+        await testUtils_1.default.request().get('/').expect(404);
+    });
+    (0, mocha_1.it)('should getSent emails', async () => {
+        assert.deepStrictEqual(testUtils_1.default.getSentMails(), []);
+    });
+    (0, mocha_1.it)('should generate uniqueDatabase', () => {
+        testUtils_1.default.init(() => new koa_1.default());
+        assert.deepStrictEqual(testUtils_1.default.uniqueDatabase(), null);
+        assert.deepStrictEqual(testUtils_1.default.uniqueDatabase('mongodb://127.0.0.0:27017/test')?.startsWith('mongodb://127.0.0.0:27017/test___'), true);
+    });
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGVzdFV0aWxzLnRlc3QuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyJ0ZXN0VXRpbHMudGVzdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsOERBQXNDO0FBQ3RDLCtDQUFpQztBQUNqQyw4Q0FBc0I7QUFDdEIsaUNBQXFDO0FBQ3JDLGlFQUF5QztBQUV6QyxtQkFBUyxDQUFDLElBQUksQ0FBQyxHQUFHLEVBQUUsQ0FBQyxJQUFJLGFBQUcsRUFBRSxFQUFFLDZCQUE2QixFQUFFLGdCQUFNLENBQUMsQ0FBQztBQUV2RSxJQUFBLGdCQUFRLEVBQUMsb0JBQW9CLEVBQUUsS0FBSyxJQUFJLEVBQUU7SUFFdEMsSUFBQSxVQUFFLEVBQUMsd0JBQXdCLEVBQUUsS0FBSyxJQUFJLEVBQUU7UUFDcEMsTUFBTSxtQkFBUyxDQUFDLE9BQU8sRUFBRSxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLENBQUM7SUFDbkQsQ0FBQyxDQUFDLENBQUM7SUFFSCxJQUFBLFVBQUUsRUFBQyx1QkFBdUIsRUFBRSxLQUFLLElBQUksRUFBRTtRQUNuQyxNQUFNLENBQUMsZUFBZSxDQUFDLG1CQUFTLENBQUMsWUFBWSxFQUFFLEVBQUUsRUFBRSxDQUFDLENBQUM7SUFDekQsQ0FBQyxDQUFDLENBQUM7SUFFSCxJQUFBLFVBQUUsRUFBQyxnQ0FBZ0MsRUFBRSxHQUFHLEVBQUU7UUFDdEMsbUJBQVMsQ0FBQyxJQUFJLENBQUMsR0FBRyxFQUFFLENBQUMsSUFBSSxhQUFHLEVBQUUsQ0FBQyxDQUFDO1FBQ2hDLE1BQU0sQ0FBQyxlQUFlLENBQUMsbUJBQVMsQ0FBQyxjQUFjLEVBQUUsRUFBRSxJQUFJLENBQUMsQ0FBQztRQUN6RCxNQUFNLENBQUMsZUFBZSxDQUNsQixtQkFBUyxDQUFDLGNBQWMsQ0FBQyxnQ0FBZ0MsQ0FBQyxFQUFFLFVBQVUsQ0FBQyxtQ0FBbUMsQ0FBQyxFQUMzRyxJQUFJLENBQ1AsQ0FBQztJQUNOLENBQUMsQ0FBQyxDQUFDO0FBQ1AsQ0FBQyxDQUFDLENBQUMifQ==

package/__tests__/testUtils.test.ts

@@ -0,0 +1,27 @@
+import mailer from '@storyous/mailer';
+import * as assert from 'assert';
+import Koa from 'koa';
+import { describe, it } from 'mocha';
+import testUtils from '../lib/testUtils';
+
+testUtils.init(() => new Koa(), 'mongodb://127.0.0.1/testing', mailer);
+
+describe('packages/testUtils', async () => {
+
+    it('should do some request', async () => {
+        await testUtils.request().get('/').expect(404);
+    });
+
+    it('should getSent emails', async () => {
+        assert.deepStrictEqual(testUtils.getSentMails(), []);
+    });
+
+    it('should generate uniqueDatabase', () => {
+        testUtils.init(() => new Koa());
+        assert.deepStrictEqual(testUtils.uniqueDatabase(), null);
+        assert.deepStrictEqual(
+            testUtils.uniqueDatabase('mongodb://127.0.0.0:27017/test')?.startsWith('mongodb://127.0.0.0:27017/test___'),
+            true,
+        );
+    });
+});

package/lib/mockTransport.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class MockTransport {
+    constructor() {
+        this._sentMail = [];
+        this._validate = (address) => {
+            if (!address) {
+                return new Error('Error validating address.');
+            }
+            if (typeof address !== 'string') {
+                address = address.address;
+            }
+            if (address.length > 254) {
+                return new Error('Error validating address.');
+            }
+            if (!address.match(/^[^@]+@.+\..+$/)) {
+                return new Error('Error validating address.');
+            }
+            return null;
+        };
+    }
+    getSentMail() {
+        return this._sentMail;
+    }
+    send(mail, callback) {
+        let err;
+        if (!mail.data.to) {
+            callback(new Error('I need to know who this email is being sent to :-('));
+            return;
+        }
+        if (Array.isArray(mail.data.to)) {
+            for (let i = 0; i < mail.data.to.length; i++) {
+                const address = mail.data.to[i];
+                err = this._validate(address);
+                if (err !== null) {
+                    callback(err);
+                    return;
+                }
+            }
+        }
+        else {
+            err = this._validate(mail.data.to);
+            if (err !== null) {
+                callback(err);
+                return;
+            }
+        }
+        this._sentMail.push(mail);
+        callback(null, { accepted: [mail.data.to] });
+    }
+}
+exports.default = MockTransport;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibW9ja1RyYW5zcG9ydC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIm1vY2tUcmFuc3BvcnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFJQSxNQUFxQixhQUFhO0lBQWxDO1FBQ1ksY0FBUyxHQUF1QixFQUFFLENBQUM7UUF1Q25DLGNBQVMsR0FBRyxDQUFDLE9BQTBCLEVBQUUsRUFBRTtZQUMvQyxJQUFJLENBQUMsT0FBTyxFQUFFO2dCQUNWLE9BQU8sSUFBSSxLQUFLLENBQUMsMkJBQTJCLENBQUMsQ0FBQzthQUNqRDtZQUVELElBQUksT0FBTyxPQUFPLEtBQUssUUFBUSxFQUFFO2dCQUM3QixPQUFPLEdBQUcsT0FBTyxDQUFDLE9BQU8sQ0FBQzthQUM3QjtZQUVELElBQUksT0FBTyxDQUFDLE1BQU0sR0FBRyxHQUFHLEVBQUU7Z0JBQ3RCLE9BQU8sSUFBSSxLQUFLLENBQUMsMkJBQTJCLENBQUMsQ0FBQzthQUNqRDtZQUVELElBQUksQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLGdCQUFnQixDQUFDLEVBQUU7Z0JBQ2xDLE9BQU8sSUFBSSxLQUFLLENBQUMsMkJBQTJCLENBQUMsQ0FBQzthQUNqRDtZQUVELE9BQU8sSUFBSSxDQUFDO1FBQ2hCLENBQUMsQ0FBQztJQUNOLENBQUM7SUFwREcsV0FBVztRQUNQLE9BQU8sSUFBSSxDQUFDLFNBQVMsQ0FBQztJQUMxQixDQUFDO0lBRU0sSUFBSSxDQUFFLElBQXNCLEVBQUUsUUFBaUQ7UUFDbEYsSUFBSSxHQUFHLENBQUM7UUFFUixJQUFJLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxFQUFFLEVBQUU7WUFDZixRQUFRLENBQUMsSUFBSSxLQUFLLENBQUMsb0RBQW9ELENBQUMsQ0FBQyxDQUFDO1lBQzFFLE9BQU87U0FDVjtRQUVELElBQUksS0FBSyxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQyxFQUFFO1lBQzdCLEtBQUssSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsR0FBRyxJQUFJLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxFQUFFLEVBQUU7Z0JBQzFDLE1BQU0sT0FBTyxHQUFHLElBQUksQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDO2dCQUNoQyxHQUFHLEdBQUcsSUFBSSxDQUFDLFNBQVMsQ0FBQyxPQUFPLENBQUMsQ0FBQztnQkFDOUIsSUFBSSxHQUFHLEtBQUssSUFBSSxFQUFFO29CQUNkLFFBQVEsQ0FBQyxHQUFHLENBQUMsQ0FBQztvQkFDZCxPQUFPO2lCQUNWO2FBQ0o7U0FDSjthQUFNO1lBQ0gsR0FBRyxHQUFHLElBQUksQ0FBQyxTQUFTLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUMsQ0FBQztZQUNuQyxJQUFJLEdBQUcsS0FBSyxJQUFJLEVBQUU7Z0JBQ2QsUUFBUSxDQUFDLEdBQUcsQ0FBQyxDQUFDO2dCQUNkLE9BQU87YUFDVjtTQUNKO1FBRUQsSUFBSSxDQUFDLFNBQVMsQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUM7UUFDMUIsUUFBUSxDQUFDLElBQUksRUFBRSxFQUFFLFFBQVEsRUFBRSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDLEVBQUUsQ0FBQyxDQUFDO0lBQ2pELENBQUM7Q0FxQko7QUEzREQsZ0NBMkRDIn0=

package/lib/mockTransport.ts

@@ -0,0 +1,64 @@
+import { Transport } from 'nodemailer';
+import { Address } from 'nodemailer/lib/mailer';
+import MailMessage from 'nodemailer/lib/mailer/mail-message';
+
+export default class MockTransport implements Transport {
+    private _sentMail: MailMessage<any>[] = [];
+
+    public readonly name: 'Mock';
+
+    public readonly version: '1.0.0';
+
+    getSentMail () {
+        return this._sentMail;
+    }
+
+    public send (mail: MailMessage<any>, callback: (err: Error | null, info?: any) => void): void {
+        let err;
+
+        if (!mail.data.to) {
+            callback(new Error('I need to know who this email is being sent to :-('));
+            return;
+        }
+
+        if (Array.isArray(mail.data.to)) {
+            for (let i = 0; i < mail.data.to.length; i++) {
+                const address = mail.data.to[i];
+                err = this._validate(address);
+                if (err !== null) {
+                    callback(err);
+                    return;
+                }
+            }
+        } else {
+            err = this._validate(mail.data.to);
+            if (err !== null) {
+                callback(err);
+                return;
+            }
+        }
+
+        this._sentMail.push(mail);
+        callback(null, { accepted: [mail.data.to] });
+    }
+
+    private _validate = (address?: string | Address) => {
+        if (!address) {
+            return new Error('Error validating address.');
+        }
+
+        if (typeof address !== 'string') {
+            address = address.address;
+        }
+
+        if (address.length > 254) {
+            return new Error('Error validating address.');
+        }
+
+        if (!address.match(/^[^@]+@.+\..+$/)) {
+            return new Error('Error validating address.');
+        }
+
+        return null;
+    };
+}

package/lib/testUtils.js

@@ -0,0 +1,85 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const http_1 = __importDefault(require("http"));
+const mocha_1 = require("mocha");
+const mongodb_1 = require("mongodb");
+const nodemailer_1 = __importDefault(require("nodemailer"));
+const supertest_1 = __importDefault(require("supertest"));
+const mockTransport_1 = __importDefault(require("./mockTransport"));
+const testUtils = {
+    _app: null,
+    _originalTransporter: undefined,
+    _mockTransporter: undefined,
+    init(app, cleanDatabaseUrl, mailer) {
+        (0, mocha_1.before)(async () => {
+            if (cleanDatabaseUrl) {
+                await this.cleanTestingDatabases(cleanDatabaseUrl);
+            }
+            if (app) {
+                this._app = http_1.default.createServer((await app()).callback());
+            }
+        });
+        (0, mocha_1.beforeEach)(() => {
+            if (mailer) {
+                this._originalTransporter = mailer._transporter;
+                this._mockTransporter = new mockTransport_1.default();
+                mailer._transporter = nodemailer_1.default.createTransport(this._mockTransporter);
+            }
+        });
+        (0, mocha_1.afterEach)(() => {
+            if (mailer) {
+                mailer._transporter = this._originalTransporter;
+            }
+        });
+    },
+    getSentMails() {
+        if (!this._mockTransporter) {
+            throw new Error('The Email Transporter is not initialized yet!');
+        }
+        return this._mockTransporter.getSentMail();
+    },
+    request() {
+        if (!this._app) {
+            throw new Error('The app is not initialized yet!');
+        }
+        return supertest_1.default.agent(this._app);
+    },
+    uniqueDatabase(mongodbUrl) {
+        if (!mongodbUrl) {
+            return null;
+        }
+        const parsed = new URL(mongodbUrl);
+        parsed.pathname = `${parsed.pathname}___${Date.now()}`;
+        return parsed.toString();
+    },
+    async cleanTestingDatabases(mongodbUrl) {
+        const client = new mongodb_1.MongoClient(mongodbUrl, { directConnection: true });
+        await client.connect();
+        const db = client.db();
+        const { databaseName } = db;
+        if (!/testing/i.test(databaseName)) {
+            throw new Error('The database name has to contains the "testing" keyword.');
+        }
+        const postfixMatcher = /___([0-9]{12,})/;
+        const baseName = databaseName.replace(postfixMatcher, '');
+        const matcher = new RegExp(`^${baseName}(${postfixMatcher.source})?$`);
+        const adminDb = db.admin();
+        const { databases } = await adminDb.listDatabases({ nameOnly: true });
+        const maxAgeDate = new Date();
+        maxAgeDate.setMinutes(maxAgeDate.getMinutes() - 15);
+        await Promise.all(databases.map(async ({ name }) => {
+            const [match, , timestamp] = name.match(matcher) || [];
+            if (match && (!timestamp || new Date(parseInt(timestamp, 10)) < maxAgeDate)) {
+                // eslint-disable-next-line no-console
+                console.log(`DROPPING OLD TESTING database ${name}`);
+                await client.db(name).dropDatabase();
+            }
+        }));
+        await client.close();
+    },
+};
+exports.default = testUtils;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGVzdFV0aWxzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsidGVzdFV0aWxzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7O0FBQUEsZ0RBQW9DO0FBRXBDLGlDQUFzRDtBQUN0RCxxQ0FBc0M7QUFDdEMsNERBQXFEO0FBRXJELDBEQUFzRDtBQUN0RCxvRUFBNEM7QUFFNUMsTUFBTSxTQUFTLEdBQUc7SUFDZCxJQUFJLEVBQWdCLElBQUk7SUFDeEIsb0JBQW9CLEVBQTBCLFNBQVM7SUFDdkQsZ0JBQWdCLEVBQTRCLFNBQVM7SUFFckQsSUFBSSxDQUFFLEdBQWUsRUFBRSxnQkFBeUIsRUFBRSxNQUE0QjtRQUMxRSxJQUFBLGNBQU0sRUFBQyxLQUFLLElBQUksRUFBRTtZQUNkLElBQUksZ0JBQWdCLEVBQUU7Z0JBQ2xCLE1BQU0sSUFBSSxDQUFDLHFCQUFxQixDQUFDLGdCQUFnQixDQUFDLENBQUM7YUFDdEQ7WUFFRCxJQUFJLEdBQUcsRUFBRTtnQkFDTCxJQUFJLENBQUMsSUFBSSxHQUFHLGNBQUksQ0FBQyxZQUFZLENBQUMsQ0FBQyxNQUFNLEdBQUcsRUFBRSxDQUFDLENBQUMsUUFBUSxFQUFFLENBQUMsQ0FBQzthQUMzRDtRQUNMLENBQUMsQ0FBQyxDQUFDO1FBRUgsSUFBQSxrQkFBVSxFQUFDLEdBQUcsRUFBRTtZQUNaLElBQUksTUFBTSxFQUFFO2dCQUNSLElBQUksQ0FBQyxvQkFBb0IsR0FBRyxNQUFNLENBQUMsWUFBWSxDQUFDO2dCQUNoRCxJQUFJLENBQUMsZ0JBQWdCLEdBQUcsSUFBSSx1QkFBYSxFQUFFLENBQUM7Z0JBQzVDLE1BQU0sQ0FBQyxZQUFZLEdBQUcsb0JBQVUsQ0FBQyxlQUFlLENBQUMsSUFBSSxDQUFDLGdCQUFnQixDQUFDLENBQUM7YUFDM0U7UUFDTCxDQUFDLENBQUMsQ0FBQztRQUVILElBQUEsaUJBQVMsRUFBQyxHQUFHLEVBQUU7WUFDWCxJQUFJLE1BQU0sRUFBRTtnQkFDUixNQUFNLENBQUMsWUFBWSxHQUFHLElBQUksQ0FBQyxvQkFBb0IsQ0FBQzthQUNuRDtRQUNMLENBQUMsQ0FBQyxDQUFDO0lBQ1AsQ0FBQztJQUVELFlBQVk7UUFDUixJQUFJLENBQUMsSUFBSSxDQUFDLGdCQUFnQixFQUFFO1lBQ3hCLE1BQU0sSUFBSSxLQUFLLENBQUMsK0NBQStDLENBQUMsQ0FBQztTQUNwRTtRQUVELE9BQU8sSUFBSSxDQUFDLGdCQUFnQixDQUFDLFdBQVcsRUFBRSxDQUFDO0lBQy9DLENBQUM7SUFFRCxPQUFPO1FBQ0gsSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJLEVBQUU7WUFDWixNQUFNLElBQUksS0FBSyxDQUFDLGlDQUFpQyxDQUFDLENBQUM7U0FDdEQ7UUFDRCxPQUFPLG1CQUFTLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUN0QyxDQUFDO0lBRUQsY0FBYyxDQUFFLFVBQW1CO1FBRS9CLElBQUksQ0FBQyxVQUFVLEVBQUU7WUFDYixPQUFPLElBQUksQ0FBQztTQUNmO1FBRUQsTUFBTSxNQUFNLEdBQUcsSUFBSSxHQUFHLENBQUMsVUFBVSxDQUFDLENBQUM7UUFDbkMsTUFBTSxDQUFDLFFBQVEsR0FBRyxHQUFHLE1BQU0sQ0FBQyxRQUFRLE1BQU0sSUFBSSxDQUFDLEdBQUcsRUFBRSxFQUFFLENBQUM7UUFDdkQsT0FBTyxNQUFNLENBQUMsUUFBUSxFQUFFLENBQUM7SUFDN0IsQ0FBQztJQUVELEtBQUssQ0FBQyxxQkFBcUIsQ0FBRSxVQUFrQjtRQUMzQyxNQUFNLE1BQU0sR0FBRyxJQUFJLHFCQUFXLENBQUMsVUFBVSxFQUFFLEVBQUUsZ0JBQWdCLEVBQUUsSUFBSSxFQUFFLENBQUMsQ0FBQztRQUN2RSxNQUFNLE1BQU0sQ0FBQyxPQUFPLEVBQUUsQ0FBQztRQUN2QixNQUFNLEVBQUUsR0FBRyxNQUFNLENBQUMsRUFBRSxFQUFFLENBQUM7UUFDdkIsTUFBTSxFQUFFLFlBQVksRUFBRSxHQUFHLEVBQUUsQ0FBQztRQUU1QixJQUFJLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxZQUFZLENBQUMsRUFBRTtZQUNoQyxNQUFNLElBQUksS0FBSyxDQUFDLDBEQUEwRCxDQUFDLENBQUM7U0FDL0U7UUFFRCxNQUFNLGNBQWMsR0FBRyxpQkFBaUIsQ0FBQztRQUN6QyxNQUFNLFFBQVEsR0FBRyxZQUFZLENBQUMsT0FBTyxDQUFDLGNBQWMsRUFBRSxFQUFFLENBQUMsQ0FBQztRQUUxRCxNQUFNLE9BQU8sR0FBRyxJQUFJLE1BQU0sQ0FBQyxJQUFJLFFBQVEsSUFBSSxjQUFjLENBQUMsTUFBTSxLQUFLLENBQUMsQ0FBQztRQUN2RSxNQUFNLE9BQU8sR0FBRyxFQUFFLENBQUMsS0FBSyxFQUFFLENBQUM7UUFDM0IsTUFBTSxFQUFFLFNBQVMsRUFBRSxHQUFHLE1BQU0sT0FBTyxDQUFDLGFBQWEsQ0FBQyxFQUFFLFFBQVEsRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDO1FBRXRFLE1BQU0sVUFBVSxHQUFHLElBQUksSUFBSSxFQUFFLENBQUM7UUFDOUIsVUFBVSxDQUFDLFVBQVUsQ0FBQyxVQUFVLENBQUMsVUFBVSxFQUFFLEdBQUcsRUFBRSxDQUFDLENBQUM7UUFFcEQsTUFBTSxPQUFPLENBQUMsR0FBRyxDQUFDLFNBQVMsQ0FBQyxHQUFHLENBQUMsS0FBSyxFQUFFLEVBQUUsSUFBSSxFQUFFLEVBQUUsRUFBRTtZQUMvQyxNQUFNLENBQUMsS0FBSyxFQUFDLEVBQUUsU0FBUyxDQUFDLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsSUFBSSxFQUFFLENBQUM7WUFDdEQsSUFBSSxLQUFLLElBQUksQ0FBQyxDQUFDLFNBQVMsSUFBSSxJQUFJLElBQUksQ0FBQyxRQUFRLENBQUMsU0FBUyxFQUFFLEVBQUUsQ0FBQyxDQUFDLEdBQUcsVUFBVSxDQUFDLEVBQUU7Z0JBQ3pFLHNDQUFzQztnQkFDdEMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxpQ0FBaUMsSUFBSSxFQUFFLENBQUMsQ0FBQztnQkFDckQsTUFBTSxNQUFNLENBQUMsRUFBRSxDQUFDLElBQUksQ0FBQyxDQUFDLFlBQVksRUFBRSxDQUFDO2FBQ3hDO1FBQ0wsQ0FBQyxDQUFDLENBQUMsQ0FBQztRQUVKLE1BQU0sTUFBTSxDQUFDLEtBQUssRUFBRSxDQUFDO0lBQ3pCLENBQUM7Q0FDSixDQUFDO0FBRUYsa0JBQWUsU0FBUyxDQUFDIn0=

package/lib/testUtils.ts

@@ -0,0 +1,100 @@
+import http, { Server } from 'http';
+import Koa from 'koa';
+import { afterEach, before, beforeEach } from 'mocha';
+import { MongoClient } from 'mongodb';
+import nodemailer, { Transporter } from 'nodemailer';
+import MailMessage from 'nodemailer/lib/mailer/mail-message';
+import supertest, { SuperAgentTest } from 'supertest';
+import MockTransport from './mockTransport';
+
+const testUtils = {
+    _app: <Server|null> null,
+    _originalTransporter: <Transporter|undefined> undefined,
+    _mockTransporter: <MockTransport|undefined> undefined,
+
+    init (app?: () => Koa, cleanDatabaseUrl?: string, mailer?: {_transporter: any}) {
+        before(async () => {
+            if (cleanDatabaseUrl) {
+                await this.cleanTestingDatabases(cleanDatabaseUrl);
+            }
+
+            if (app) {
+                this._app = http.createServer((await app()).callback());
+            }
+        });
+
+        beforeEach(() => {
+            if (mailer) {
+                this._originalTransporter = mailer._transporter;
+                this._mockTransporter = new MockTransport();
+                mailer._transporter = nodemailer.createTransport(this._mockTransporter);
+            }
+        });
+
+        afterEach(() => {
+            if (mailer) {
+                mailer._transporter = this._originalTransporter;
+            }
+        });
+    },
+
+    getSentMails (): MailMessage<any>[] {
+        if (!this._mockTransporter) {
+            throw new Error('The Email Transporter is not initialized yet!');
+        }
+
+        return this._mockTransporter.getSentMail();
+    },
+
+    request (): SuperAgentTest {
+        if (!this._app) {
+            throw new Error('The app is not initialized yet!');
+        }
+        return supertest.agent(this._app);
+    },
+
+    uniqueDatabase (mongodbUrl?: string): string|null {
+
+        if (!mongodbUrl) {
+            return null;
+        }
+
+        const parsed = new URL(mongodbUrl);
+        parsed.pathname = `${parsed.pathname}___${Date.now()}`;
+        return parsed.toString();
+    },
+
+    async cleanTestingDatabases (mongodbUrl: string): Promise<void> {
+        const client = new MongoClient(mongodbUrl, { directConnection: true });
+        await client.connect();
+        const db = client.db();
+        const { databaseName } = db;
+
+        if (!/testing/i.test(databaseName)) {
+            throw new Error('The database name has to contains the "testing" keyword.');
+        }
+
+        const postfixMatcher = /___([0-9]{12,})/;
+        const baseName = databaseName.replace(postfixMatcher, '');
+
+        const matcher = new RegExp(`^${baseName}(${postfixMatcher.source})?$`);
+        const adminDb = db.admin();
+        const { databases } = await adminDb.listDatabases({ nameOnly: true });
+
+        const maxAgeDate = new Date();
+        maxAgeDate.setMinutes(maxAgeDate.getMinutes() - 15);
+
+        await Promise.all(databases.map(async ({ name }) => {
+            const [match,, timestamp] = name.match(matcher) || [];
+            if (match && (!timestamp || new Date(parseInt(timestamp, 10)) < maxAgeDate)) {
+                // eslint-disable-next-line no-console
+                console.log(`DROPPING OLD TESTING database ${name}`);
+                await client.db(name).dropDatabase();
+            }
+        }));
+
+        await client.close();
+    },
+};
+
+export default testUtils;

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@storyous/test-utils",
+  "version": "1.0.0",
+  "description": "",
+  "homepage": "https://github.com/Storyous/mono-utils#readme",
+  "license": "ISC",
+  "main": "lib/testUtils.ts",
+  "scripts": {
+    "start": "tsc",
+    "build": "tsc && npm publish"
+  },
+  "mocha": {
+    "recursive": true,
+    "timeout": 15000,
+    "extension": [
+      "ts"
+    ],
+    "exit": true,
+    "require": "ts-node/register"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Storyous/mono-utils.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Storyous/mono-utils/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "koa": "^2.13.4",
+    "mocha": "^9.2.2",
+    "mongodb": "^4.5.0",
+    "nodemailer": "^6.7.3",
+    "supertest": "^6.2.2"
+  },
+  "devDependencies": {
+    "@storyous/mailer": "^1.0.0"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+    "extends": "../../tsconfig.json",
+
+    "include": [
+        "lib",
+        "__tests__"
+    ]
+}