spec-3nweb-server 1.8.4 → 1.8.6

package/build/tests/libs-for-tests/server-components/3nstorage.js

@@ -0,0 +1,200 @@
+"use strict";
+/*
+ Copyright (C) 2016, 2019 - 2020 3NSoft Inc.
+ 
+ This program is free software: you can redistribute it and/or modify it under
+ the terms of the GNU General Public License as published by the Free Software
+ Foundation, either version 3 of the License, or (at your option) any later
+ version.
+ 
+ This program is distributed in the hope that it will be useful, but
+ WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ See the GNU General Public License for more details.
+ 
+ You should have received a copy of the GNU General Public License along with
+ this program. If not, see <http://www.gnu.org/licenses/>.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageComponent = void 0;
+const component_1 = require("./component");
+const mailerid_1 = require("./mailerid");
+const url_1 = require("url");
+const _3nstorage_1 = require("../3nstorage");
+const fs = require("../../../lib-common/async-fs-node");
+const bytes_equal_1 = require("../bytes-equal");
+const obj_file_1 = require("../../../lib-common/objs-on-disk/obj-file");
+const path_1 = require("path");
+const buffer_utils_1 = require("../../../lib-common/buffer-utils");
+const server_data_folders_1 = require("../../../lib-server/resources/server-data-folders");
+async function rmFolderContent(folder) {
+    await fs.rmDirWithContent(folder);
+    await fs.mkdir(folder);
+}
+class StorageComponent extends component_1.Component {
+    constructor(signupDomains, midServiceDomain) {
+        super({
+            rootFolder: null,
+            domain: midServiceDomain,
+            signup: {},
+            enabledServices: {
+                mailerId: true,
+                storage: true
+            },
+            mailerId: {
+                certs: null
+            }
+        }, signupDomains);
+        this.midServiceDomain = midServiceDomain;
+        Object.seal(this);
+    }
+    async addUser(userId, configureDNS = true) {
+        if (configureDNS) {
+            this.dns.configureFor(userId);
+        }
+        let user = await (0, mailerid_1.addUserIn)(this.url, userId);
+        user.midUrl = this.midUrl;
+        user.storageOwnerUrl = await this.getStorageOwnerUrl();
+        return user;
+    }
+    get midUrl() {
+        return (0, url_1.resolve)(this.url, 'mailerid/');
+    }
+    get storageUrl() {
+        return (0, url_1.resolve)(this.url, '3nstorage/');
+    }
+    async getStorageOwnerUrl() {
+        let storageOwnerUrl = await (0, _3nstorage_1.get3NStorageServiceUrl)(this.storageUrl, 'owner');
+        if (!storageOwnerUrl.endsWith('/')) {
+            storageOwnerUrl += '/';
+        }
+        return storageOwnerUrl;
+    }
+    storeFolder(userId) {
+        return (0, path_1.join)((0, server_data_folders_1.userDataInRootFolder)(this.conf.rootFolder, userId), 'store');
+    }
+    async checkTransactionPresence(transFolder, transactionId) {
+        const transFile = 'transaction';
+        try {
+            const lst = await fs.readdir(transFolder);
+            expect(lst).toContain(transFile);
+        }
+        catch (exc) {
+            if (exc.notFound) {
+                return false;
+            }
+            else {
+                throw exc;
+            }
+        }
+        if (transactionId) {
+            const trans = JSON.parse(await fs.readFile((0, path_1.join)(transFolder, transFile), { encoding: 'utf8' }));
+            return (trans.transactionId === transactionId);
+        }
+        return true;
+    }
+    rootTransactionExists(userId, transactionId) {
+        return this.checkTransactionPresence((0, path_1.join)(this.storeFolder(userId), 'root', 'transaction'), transactionId);
+    }
+    transactionExists(userId, objId, transactionId) {
+        return this.checkTransactionPresence((0, path_1.join)(this.storeFolder(userId), 'transactions', objId), transactionId);
+    }
+    async checkCurrentObjPresence(objFolder, ver, obj) {
+        let status;
+        try {
+            status = JSON.parse(await fs.readFile(objFolder + '/status', { encoding: 'utf8' }));
+        }
+        catch (exc) {
+            if (exc.notFound) {
+                return false;
+            }
+            else {
+                throw exc;
+            }
+        }
+        if (status.state !== 'current') {
+            return false;
+        }
+        const currVer = status.currentVersion;
+        if ((ver !== undefined) && (currVer !== ver)) {
+            return false;
+        }
+        if (obj) {
+            const filePath = (0, path_1.join)(objFolder, `${currVer}.v`);
+            const file = await obj_file_1.ObjVersionFile.forExisting(filePath)
+                .catch((exc) => {
+                if (exc.notFound) {
+                    return undefined;
+                }
+                throw exc;
+            });
+            if (!file) {
+                return false;
+            }
+            const headerInFile = await file.readHeader();
+            if (!headerInFile
+                || !(0, bytes_equal_1.bytesEqual)(headerInFile, obj.header)) {
+                return false;
+            }
+            const diff = obj.diff;
+            if (file.getBaseVersion() === undefined) {
+                if (diff) {
+                    return false;
+                }
+                const segsInFile = (0, buffer_utils_1.joinByteArrs)(await file.readSegs(0, file.getTotalSegsLen()));
+                if (!(0, bytes_equal_1.bytesEqual)(segsInFile, obj.segs)) {
+                    return false;
+                }
+            }
+            else {
+                if (!diff) {
+                    return false;
+                }
+                if (file.getBaseVersion() !== diff.baseVersion) {
+                    return false;
+                }
+                if (file.getTotalSegsLen() !== diff.segsSize) {
+                    return false;
+                }
+                let ofs = 0;
+                for (const [isNew, dsOfs, len] of diff.sections) {
+                    if (isNew === 0) {
+                        const sections = await file.segsLocations(ofs, len);
+                        for (const section of sections) {
+                            if (section.type !== 'base') {
+                                return false;
+                            }
+                        }
+                    }
+                    else {
+                        if (!(0, bytes_equal_1.bytesEqual)((0, buffer_utils_1.joinByteArrs)(await file.readSegs(ofs, len)), obj.segs.subarray(dsOfs, dsOfs + len))) {
+                            return false;
+                        }
+                    }
+                    ofs += len;
+                }
+            }
+        }
+        return true;
+    }
+    currentRootObjExists(userId, ver, obj) {
+        return this.checkCurrentObjPresence((0, path_1.join)(this.storeFolder(userId), 'root'), ver, obj);
+    }
+    currentObjExists(userId, objId, ver, obj) {
+        return this.checkCurrentObjPresence((0, path_1.join)(this.storeFolder(userId), 'objects', objId), ver, obj);
+    }
+    async clearStorage(userId) {
+        let storeFolder = this.storeFolder(userId);
+        await rmFolderContent((0, path_1.join)(storeFolder, 'transactions'));
+        await rmFolderContent((0, path_1.join)(storeFolder, 'objects'));
+        await rmFolderContent((0, path_1.join)(storeFolder, 'root'));
+    }
+    async restartAndClearStorageFor(userId) {
+        await this.clearStorage(userId);
+        await this.restart();
+    }
+}
+exports.StorageComponent = StorageComponent;
+Object.freeze(StorageComponent.prototype);
+Object.freeze(StorageComponent);
+Object.freeze(exports);

package/build/tests/libs-for-tests/server-components/admin.d.ts

@@ -0,0 +1,6 @@
+import { Component } from './component';
+export declare class AdminComponent extends Component {
+    constructor(signupDomains: string[]);
+    get signupUrl(): string;
+    createSingleUserSignupTokenFor(userId: string): Promise<string>;
+}

package/build/tests/libs-for-tests/server-components/admin.js

@@ -0,0 +1,43 @@
+"use strict";
+/*
+ Copyright (C) 2016, 2020 3NSoft Inc.
+ 
+ This program is free software: you can redistribute it and/or modify it under
+ the terms of the GNU General Public License as published by the Free Software
+ Foundation, either version 3 of the License, or (at your option) any later
+ version.
+ 
+ This program is distributed in the hope that it will be useful, but
+ WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ See the GNU General Public License for more details.
+ 
+ You should have received a copy of the GNU General Public License along with
+ this program. If not, see <http://www.gnu.org/licenses/>.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminComponent = void 0;
+const component_1 = require("./component");
+const url_1 = require("url");
+const lib_1 = require("../../../lib");
+class AdminComponent extends component_1.Component {
+    constructor(signupDomains) {
+        super({
+            rootFolder: null,
+            domain: null,
+            signup: {},
+            enabledServices: {}
+        }, signupDomains);
+        Object.seal(this);
+    }
+    get signupUrl() {
+        return (0, url_1.resolve)(this.url, 'signup/');
+    }
+    createSingleUserSignupTokenFor(userId) {
+        return (0, lib_1.addSingleUserSignup)(this.dataFolder, userId);
+    }
+}
+exports.AdminComponent = AdminComponent;
+Object.freeze(AdminComponent.prototype);
+Object.freeze(AdminComponent);
+Object.freeze(exports);

package/build/tests/libs-for-tests/server-components/asmail.d.ts

@@ -0,0 +1,16 @@
+import { Component } from './component';
+import { User } from '../pkl';
+import { Msg } from '../asmail';
+export declare class ASMailComponent extends Component {
+    midServiceDomain: string;
+    constructor(signupDomains: string[], midServiceDomain: string);
+    addUser(userId: string, configureDNS?: boolean): Promise<User>;
+    get midUrl(): string;
+    get asmailUrl(): string;
+    getConfUrl(): Promise<string>;
+    getDeliveryUrl(): Promise<string>;
+    getRetrievalUrl(): Promise<string>;
+    private inboxFolder;
+    private msgFolder;
+    msgExists(userId: string, msgId: string, deliveryComplete: boolean, msg?: Msg): Promise<boolean>;
+}

package/build/tests/libs-for-tests/server-components/asmail.js

@@ -0,0 +1,143 @@
+"use strict";
+/*
+ Copyright (C) 2016 - 2017, 2019 - 2020, 2025 3NSoft Inc.
+ 
+ This program is free software: you can redistribute it and/or modify it under
+ the terms of the GNU General Public License as published by the Free Software
+ Foundation, either version 3 of the License, or (at your option) any later
+ version.
+ 
+ This program is distributed in the hope that it will be useful, but
+ WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ See the GNU General Public License for more details.
+ 
+ You should have received a copy of the GNU General Public License along with
+ this program. If not, see <http://www.gnu.org/licenses/>.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASMailComponent = void 0;
+const component_1 = require("./component");
+const mailerid_1 = require("./mailerid");
+const url_1 = require("url");
+const asmail_1 = require("../asmail");
+const fs = require("../../../lib-common/async-fs-node");
+const bytes_equal_1 = require("../bytes-equal");
+const path_1 = require("path");
+const obj_file_1 = require("../../../lib-common/objs-on-disk/obj-file");
+const buffer_utils_1 = require("../../../lib-common/buffer-utils");
+const server_data_folders_1 = require("../../../lib-server/resources/server-data-folders");
+class ASMailComponent extends component_1.Component {
+    constructor(signupDomains, midServiceDomain) {
+        super({
+            rootFolder: null,
+            domain: midServiceDomain,
+            signup: {},
+            enabledServices: {
+                mailerId: true,
+                asmail: true
+            },
+            mailerId: {
+                certs: null
+            }
+        }, signupDomains);
+        this.midServiceDomain = midServiceDomain;
+        Object.seal(this);
+    }
+    async addUser(userId, configureDNS = true) {
+        if (configureDNS) {
+            this.dns.configureFor(userId);
+        }
+        let user = await (0, mailerid_1.addUserIn)(this.url, userId);
+        user.midUrl = this.midUrl;
+        return user;
+    }
+    get midUrl() {
+        return (0, url_1.resolve)(this.url, 'mailerid/');
+    }
+    get asmailUrl() {
+        return (0, url_1.resolve)(this.url, 'asmail/');
+    }
+    getConfUrl() {
+        return (0, asmail_1.getASMailServiceUrl)(this.asmailUrl, 'config');
+    }
+    getDeliveryUrl() {
+        return (0, asmail_1.getASMailServiceUrl)(this.asmailUrl, 'delivery');
+    }
+    getRetrievalUrl() {
+        return (0, asmail_1.getASMailServiceUrl)(this.asmailUrl, 'retrieval');
+    }
+    inboxFolder(userId) {
+        return (0, path_1.join)((0, server_data_folders_1.userDataInRootFolder)(this.conf.rootFolder, userId), 'mail');
+    }
+    msgFolder(userId, msgId, deliveryComplete) {
+        return (0, path_1.join)(this.inboxFolder(userId), (deliveryComplete ? 'messages' : 'delivery'), msgId);
+    }
+    // XXX adopt new file access
+    async msgExists(userId, msgId, deliveryComplete, msg) {
+        let meta;
+        let msgFolder = this.msgFolder(userId, msgId, deliveryComplete);
+        try {
+            let metaFile = (0, path_1.join)(msgFolder, 'meta.json');
+            meta = JSON.parse(await fs.readFile(metaFile, { encoding: 'utf8' }));
+        }
+        catch (exc) {
+            if (exc.notFound) {
+                return false;
+            }
+            else {
+                throw exc;
+            }
+        }
+        let extMeta = meta.extMeta;
+        if (!deliveryComplete || !msg) {
+            return true;
+        }
+        // check meta
+        if (msg.cryptoMeta.pid) {
+            expect(extMeta.pid).withContext('correct key-pair id in meta').toBe(msg.cryptoMeta.pid);
+        }
+        if (msg.cryptoMeta.recipientKid) {
+            expect(extMeta.recipientKid).withContext('correct recipient key id in meta').toBe(msg.cryptoMeta.recipientKid);
+        }
+        if (msg.cryptoMeta.senderPKey) {
+            expect(extMeta.senderPKey).withContext('correct sender\'s public key').toBe(msg.cryptoMeta.senderPKey);
+        }
+        expect(extMeta.objIds.length).withContext('correct number of message objects in meta').toBe(msg.msgObjs.length);
+        expect(Object.keys(meta.objs).length).withContext('correct number of message object sizes in meta').toBe(msg.msgObjs.length);
+        for (let i = 0; i < msg.msgObjs.length; i += 1) {
+            // check meta info for each object
+            let obj = msg.msgObjs[i];
+            let objId = obj.objId;
+            expect(extMeta.objIds[i]).toBe(objId);
+            expect(meta.objs[objId].size.header).withContext('header length of a message object').toBe(obj.header.length);
+            expect(meta.objs[objId].size.segments).withContext('segments length of a message object').toBe(obj.segs.length);
+            expect(meta.objs[objId].completed).withContext('completness flag of a message object').toBe(true);
+            // check object file
+            const filePath = (0, path_1.join)(msgFolder, objId);
+            const file = await obj_file_1.ObjVersionFile.forExisting(filePath)
+                .catch((exc) => {
+                if (exc.notFound) {
+                    return undefined;
+                }
+                throw exc;
+            });
+            if (!file) {
+                return false;
+            }
+            const headerInFile = await file.readHeader();
+            if (!headerInFile
+                || !(0, bytes_equal_1.bytesEqual)(headerInFile, obj.header)) {
+                return false;
+            }
+            const segsInFile = (0, buffer_utils_1.joinByteArrs)(await file.readSegs(0, file.getTotalSegsLen()));
+            if (!(0, bytes_equal_1.bytesEqual)(segsInFile, obj.segs)) {
+                return false;
+            }
+        }
+        return true;
+    }
+}
+exports.ASMailComponent = ASMailComponent;
+Object.freeze(ASMailComponent.prototype);
+Object.freeze(ASMailComponent);

package/build/tests/libs-for-tests/server-components/component.d.ts

@@ -0,0 +1,13 @@
+import { ServerRunner } from '../server-runner';
+import { Configurations } from '../../../services';
+import { DNSMock } from '../../../mock/dns';
+import { AppWithWSs } from '../../../lib-server/web-sockets/app';
+export declare abstract class Component extends ServerRunner {
+    protected conf: Configurations;
+    private signupDomains;
+    protected dataFolder: string;
+    dns: DNSMock;
+    constructor(conf: Configurations, signupDomains: string[], servicePort?: number, dataFolder?: string);
+    prepToRun(): Promise<AppWithWSs>;
+    clean(): Promise<void>;
+}

package/build/tests/libs-for-tests/server-components/component.js

@@ -0,0 +1,77 @@
+"use strict";
+/*
+ Copyright (C) 2016, 2020 3NSoft Inc.
+ 
+ This program is free software: you can redistribute it and/or modify it under
+ the terms of the GNU General Public License as published by the Free Software
+ Foundation, either version 3 of the License, or (at your option) any later
+ version.
+ 
+ This program is distributed in the hope that it will be useful, but
+ WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ See the GNU General Public License for more details.
+ 
+ You should have received a copy of the GNU General Public License along with
+ this program. If not, see <http://www.gnu.org/licenses/>.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Component = void 0;
+const server_runner_1 = require("../server-runner");
+const async_fs_node_1 = require("../../../lib-common/async-fs-node");
+const services_1 = require("../../../services");
+const dns_1 = require("../../../mock/dns");
+const dns = require("dns");
+const app_1 = require("../../../lib-server/web-sockets/app");
+const path_1 = require("path");
+const signup_tokens_1 = require("../../../signup/signup-tokens");
+const DEFAULT_SERVICE_PORT = 8088;
+const DEFAULT_DATA_FOLDER = (0, path_1.join)(__dirname, '/../../../../test-data');
+class Component extends server_runner_1.ServerRunner {
+    constructor(conf, signupDomains, servicePort = DEFAULT_SERVICE_PORT, dataFolder = DEFAULT_DATA_FOLDER) {
+        super(servicePort);
+        this.conf = conf;
+        this.signupDomains = signupDomains;
+        this.dataFolder = dataFolder;
+        this.conf.rootFolder = this.dataFolder;
+        this.conf.signup.noTokenFile = (0, path_1.join)(this.dataFolder, 'no-tokens-signup.json');
+        if (this.conf.mailerId) {
+            const certs = this.conf.mailerId.certs;
+            this.conf.mailerId.certs = (0, path_1.join)(this.dataFolder, (certs ? certs : 'mid-certs.json'));
+        }
+        const urlWithoutProto = this.url.substring(this.url.indexOf('://') + 3);
+        this.dns = new dns_1.DNSMock(urlWithoutProto + 'mailerid/');
+    }
+    async prepToRun() {
+        // prepare data folders
+        try {
+            await (0, async_fs_node_1.mkdir)(this.dataFolder);
+            // write to-tokens signup file
+            const noTokenCtx = (0, signup_tokens_1.makeMultiDomainSignupCtx)(this.signupDomains);
+            await (0, async_fs_node_1.writeFile)(this.conf.signup.noTokenFile, JSON.stringify(noTokenCtx), { encoding: 'utf8' });
+        }
+        catch (exc) {
+            if (!exc.alreadyExists) {
+                throw exc;
+            }
+        }
+        // inject dns mock
+        dns.resolveTxt = this.dns.resolveTxt;
+        // setup servers
+        const app = new app_1.AppWithWSs();
+        app.use((0, services_1.accountsApp)(this.conf));
+        app.use((0, services_1.servicesApp)(this.conf));
+        return app;
+    }
+    async clean() {
+        await (0, async_fs_node_1.rmDirWithContent)(this.dataFolder).catch((exc) => {
+            if (!exc.notFound) {
+                throw exc;
+            }
+        });
+    }
+}
+exports.Component = Component;
+Object.freeze(Component.prototype);
+Object.freeze(Component);
+Object.freeze(exports);

package/build/tests/libs-for-tests/server-components/mailerid.d.ts

@@ -0,0 +1,10 @@
+import { Component } from './component';
+import { User } from '../pkl';
+export declare function addUserIn(rootServerUrl: string, userId: string): Promise<User>;
+export declare class MailerIdComponent extends Component {
+    midServiceDomain: string;
+    constructor(signupDomains: string[], midServiceDomain: string);
+    addUser(userId: string): Promise<User>;
+    get midUrl(): string;
+    getProvUrl(): Promise<string>;
+}

package/build/tests/libs-for-tests/server-components/mailerid.js

@@ -0,0 +1,103 @@
+"use strict";
+/*
+ Copyright (C) 2016, 2020 3NSoft Inc.
+ 
+ This program is free software: you can redistribute it and/or modify it under
+ the terms of the GNU General Public License as published by the Free Software
+ Foundation, either version 3 of the License, or (at your option) any later
+ version.
+ 
+ This program is distributed in the hope that it will be useful, but
+ WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ See the GNU General Public License for more details.
+ 
+ You should have received a copy of the GNU General Public License along with
+ this program. If not, see <http://www.gnu.org/licenses/>.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MailerIdComponent = exports.addUserIn = void 0;
+const component_1 = require("./component");
+const url_1 = require("url");
+const xhr_utils_1 = require("../xhr-utils");
+const signup = require("../../../lib-common/admin-api/signup");
+const random = require("../../../lib-common/random-node");
+const ecma_nacl_1 = require("ecma-nacl");
+const jwkeys_1 = require("../../../lib-common/jwkeys");
+const buffer_utils_1 = require("../../../lib-common/buffer-utils");
+const mailerid_1 = require("../mailerid");
+async function addUserIn(rootServerUrl, userId) {
+    let reqOpts = {
+        url: (0, url_1.resolve)((0, url_1.resolve)(rootServerUrl, 'signup/'), signup.addUser.URL_END),
+        method: 'POST'
+    };
+    let user = {
+        id: userId,
+        loginDefaultSKey: await random.bytes(ecma_nacl_1.box.KEY_LENGTH),
+        loginLabeledSKey: {
+            k: await random.bytes(ecma_nacl_1.box.KEY_LENGTH),
+            kid: await random.stringOfB64Chars(12)
+        },
+        midUrl: undefined,
+        storageOwnerUrl: undefined
+    };
+    let req = {
+        userId: user.id,
+        storage: {
+            kdParams: {}
+        },
+        mailerId: {
+            defaultPKey: {
+                pkey: {
+                    alg: ecma_nacl_1.box.JWK_ALG_NAME,
+                    kid: '_',
+                    use: jwkeys_1.use.MID_PKLOGIN,
+                    k: buffer_utils_1.base64.pack(ecma_nacl_1.box.generate_pubkey(user.loginDefaultSKey))
+                },
+                kdParams: {}
+            },
+            otherPKeys: [{
+                    alg: ecma_nacl_1.box.JWK_ALG_NAME,
+                    kid: user.loginLabeledSKey.kid,
+                    use: jwkeys_1.use.MID_PKLOGIN,
+                    k: buffer_utils_1.base64.pack(ecma_nacl_1.box.generate_pubkey(user.loginLabeledSKey.k))
+                }]
+        }
+    };
+    let rep = await (0, xhr_utils_1.doJsonRequest)(reqOpts, req);
+    if (rep.status !== signup.addUser.SC.ok) {
+        throw new Error(`Fail to add user ${userId}`);
+    }
+    return user;
+}
+exports.addUserIn = addUserIn;
+class MailerIdComponent extends component_1.Component {
+    constructor(signupDomains, midServiceDomain) {
+        super({
+            rootFolder: null,
+            domain: midServiceDomain,
+            signup: {},
+            enabledServices: {
+                mailerId: true
+            },
+            mailerId: {
+                certs: null
+            }
+        }, signupDomains);
+        this.midServiceDomain = midServiceDomain;
+        Object.seal(this);
+    }
+    addUser(userId) {
+        return addUserIn(this.url, userId);
+    }
+    get midUrl() {
+        return (0, url_1.resolve)(this.url, 'mailerid/');
+    }
+    getProvUrl() {
+        return (0, mailerid_1.getProvPath)(this.midUrl);
+    }
+}
+exports.MailerIdComponent = MailerIdComponent;
+Object.freeze(MailerIdComponent.prototype);
+Object.freeze(MailerIdComponent);
+Object.freeze(exports);

package/build/tests/libs-for-tests/server-runner.d.ts

@@ -0,0 +1,15 @@
+import { AppWithWSs } from '../../lib-server/web-sockets/app';
+export type ServerState = 'stopped' | 'starting' | 'running' | 'stopping';
+export declare abstract class ServerRunner {
+    protected servicePort: number;
+    protected state: ServerState;
+    protected app: AppWithWSs;
+    constructor(servicePort: number);
+    abstract prepToRun(): Promise<AppWithWSs>;
+    abstract clean(): Promise<void>;
+    isRunning(): boolean;
+    start(): Promise<void>;
+    stop(doCleanup?: boolean): Promise<void>;
+    restart(): Promise<void>;
+    protected get url(): string;
+}