spec-3nweb-server 1.8.4 → 1.8.6

package/build/tests/protocols/asmail/delivery/specs/put-obj.js

@@ -0,0 +1,123 @@
+"use strict";
+/*
+ Copyright (C) 2016 - 2017, 2019, 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.specs = void 0;
+const async_jasmine_1 = require("../../../../libs-for-tests/async-jasmine");
+const test_utils_1 = require("../test-utils");
+const xhr_utils_1 = require("../../../../libs-for-tests/xhr-utils");
+const url_1 = require("url");
+const delivery_1 = require("../../../../../lib-common/service-api/asmail/delivery");
+const requests_1 = require("../../../../shared-checks/requests");
+const asmail_1 = require("../../../../libs-for-tests/asmail");
+const json_copy_1 = require("../../../../libs-for-tests/json-copy");
+exports.specs = {
+    description: `Request to put message object's segments`
+};
+const obj1 = test_utils_1.msg.msgObjs[0];
+const obj2 = test_utils_1.msg.msgObjs[1];
+exports.specs.definition = (setup) => (() => {
+    let user2;
+    let deliveryUrl;
+    let fstReqOpts;
+    let sndReqOpts;
+    let maxChunkSize;
+    (0, async_jasmine_1.beforeEachAsync)(async () => {
+        user2 = setup().user2;
+        deliveryUrl = await setup().asmailServer.getDeliveryUrl();
+        const sessInfo = await (0, asmail_1.startMsgDelivery)(deliveryUrl, { recipient: user2.id }, { pid: test_utils_1.msg.cryptoMeta.pid, objIds: [obj1.objId, obj2.objId] });
+        maxChunkSize = sessInfo.maxChunkSize;
+        fstReqOpts = {
+            url: (0, url_1.resolve)(deliveryUrl, delivery_1.msgObj.firstPutReqUrlEnd(obj1.objId, { header: obj1.header.length })),
+            method: 'PUT',
+            sessionId: sessInfo.sessionId
+        };
+        sndReqOpts = {
+            url: (0, url_1.resolve)(deliveryUrl, delivery_1.msgObj.secondPutReqUrlEnd(obj1.objId, { ofs: 0 })),
+            method: 'PUT',
+            sessionId: sessInfo.sessionId
+        };
+    });
+    (0, async_jasmine_1.itAsync)('fails for unknown object, in initial put request', async () => {
+        const opts = (0, json_copy_1.copy)(fstReqOpts);
+        opts.url = (0, url_1.resolve)(deliveryUrl, delivery_1.msgObj.firstPutReqUrlEnd('unknown-obj', { header: obj1.header.length, last: true }));
+        const rep = await (0, xhr_utils_1.doBinaryRequest)(opts, [obj1.header, obj1.segs]);
+        expect(rep.status).withContext('status for unknown object').toBe(delivery_1.msgObj.SC.unknownObj);
+    });
+    (0, async_jasmine_1.itAsync)('fails for unknown object, in secondary put request', async () => {
+        const opts = (0, json_copy_1.copy)(sndReqOpts);
+        opts.url = (0, url_1.resolve)(deliveryUrl, delivery_1.msgObj.secondPutReqUrlEnd('unknown-obj', { ofs: 0, last: true }));
+        const rep = await (0, xhr_utils_1.doBinaryRequest)(opts, obj1.segs);
+        expect(rep.status).withContext('status for unknown object').toBe(delivery_1.msgObj.SC.unknownObj);
+    });
+    (0, async_jasmine_1.itAsync)('will not work outside of a valid session', async () => {
+        await (0, requests_1.expectNonAcceptanceOfBadSessionId)(fstReqOpts);
+        await (0, requests_1.expectNonAcceptanceOfBadSessionId)(sndReqOpts);
+    });
+    (0, async_jasmine_1.itAsync)('first request is limited by session parameter', async () => {
+        const opts = (0, json_copy_1.copy)(fstReqOpts);
+        opts.url = (0, url_1.resolve)(deliveryUrl, delivery_1.msgObj.firstPutReqUrlEnd(obj1.objId, { header: 100, last: true }));
+        await (0, requests_1.expectNonAcceptanceOfLongBody)(opts, 'application/octet-stream', maxChunkSize + 100);
+    });
+    (0, async_jasmine_1.itAsync)('second request is limited by session parameter', async () => {
+        const opts = (0, json_copy_1.copy)(fstReqOpts);
+        opts.url = (0, url_1.resolve)(deliveryUrl, delivery_1.msgObj.firstPutReqUrlEnd(obj1.objId, { header: obj1.header.length }));
+        const rep = await (0, xhr_utils_1.doBinaryRequest)(opts, obj1.header);
+        opts.url = (0, url_1.resolve)(deliveryUrl, delivery_1.msgObj.secondPutReqUrlEnd(obj1.objId, { ofs: 0 }));
+        await (0, requests_1.expectNonAcceptanceOfLongBody)(opts, 'application/octet-stream', maxChunkSize + 100);
+    });
+    (0, async_jasmine_1.itAsync)(`writes whole object in one request`, async () => {
+        const opts = (0, json_copy_1.copy)(fstReqOpts);
+        opts.url = (0, url_1.resolve)(deliveryUrl, delivery_1.msgObj.firstPutReqUrlEnd(obj1.objId, { header: obj1.header.length, last: true }));
+        let rep = await (0, xhr_utils_1.doBinaryRequest)(opts, [obj1.header, obj1.segs]);
+        expect(rep.status).withContext('status for successful writing of segments bytes').toBe(delivery_1.msgObj.SC.ok);
+    });
+    (0, async_jasmine_1.itAsync)(`writes object in several requests`, async () => {
+        // first request, to start transmission
+        const opts = (0, json_copy_1.copy)(fstReqOpts);
+        opts.url = (0, url_1.resolve)(deliveryUrl, delivery_1.msgObj.firstPutReqUrlEnd(obj2.objId, { header: obj2.header.length }));
+        // we send only header here, but we may send some segment bytes as well
+        const rep = await (0, xhr_utils_1.doBinaryRequest)(opts, obj2.header);
+        expect(rep.status).withContext('status for successful writing of segments bytes').toBe(delivery_1.msgObj.SC.ok);
+        // following requests
+        for (let ofs = 0; ofs < obj2.segs.length; ofs += 512) {
+            const chunk = obj2.segs.subarray(ofs, ofs + 512);
+            const last = ((ofs + chunk.length) === obj2.segs.length);
+            opts.url = (0, url_1.resolve)(deliveryUrl, delivery_1.msgObj.secondPutReqUrlEnd(obj2.objId, { ofs, last }));
+            const rep = await (0, xhr_utils_1.doBinaryRequest)(opts, chunk);
+            expect(rep.status).withContext('status for successful writing of segments bytes').toBe(delivery_1.msgObj.SC.ok);
+        }
+    });
+    (0, async_jasmine_1.itAsync)(`should not work, if metadata hasn't been sent, yet`, async () => {
+        const opts = (0, json_copy_1.copy)(fstReqOpts);
+        opts.sessionId = (await (0, asmail_1.startMsgDeliverySession)(deliveryUrl, { recipient: user2.id })).sessionId;
+        let rep = await (0, xhr_utils_1.doBinaryRequest)(opts, obj1.header);
+        expect(rep.status).withContext('status for sending object bytes before sending message metadata').toBe(delivery_1.ERR_SC.earlyReq);
+        opts.url = sndReqOpts.url;
+        rep = await (0, xhr_utils_1.doBinaryRequest)(opts, obj1.header);
+        expect(rep.status).withContext('status for sending object bytes before sending message metadata').toBe(delivery_1.ERR_SC.earlyReq);
+    });
+    (0, async_jasmine_1.itAsync)('will not accept bad type', async () => {
+        await (0, requests_1.expectNonAcceptanceOfBadType)(fstReqOpts, 'application/octet-stream', obj1.segs);
+        await (0, requests_1.expectNonAcceptanceOfBadType)(sndReqOpts, 'application/octet-stream', obj1.segs);
+    });
+    (0, async_jasmine_1.itAsync)('requires messagedelivery session', async () => {
+        await (0, requests_1.expectNonAcceptanceOfBadSessionId)(fstReqOpts, true);
+        await (0, requests_1.expectNonAcceptanceOfBadSessionId)(sndReqOpts, true);
+    });
+});
+Object.freeze(exports);

package/build/tests/protocols/asmail/delivery/specs/restart-session.d.ts

@@ -0,0 +1,2 @@
+import { SpecDescribe } from '../test-utils';
+export declare const specs: SpecDescribe;

package/build/tests/protocols/asmail/delivery/specs/restart-session.js

@@ -0,0 +1,79 @@
+"use strict";
+/*
+ Copyright (C) 2017 3NSoft, 2025 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.specs = void 0;
+const async_jasmine_1 = require("../../../../libs-for-tests/async-jasmine");
+const test_utils_1 = require("../test-utils");
+const xhr_utils_1 = require("../../../../libs-for-tests/xhr-utils");
+const url_1 = require("url");
+const delivery_1 = require("../../../../../lib-common/service-api/asmail/delivery");
+const requests_1 = require("../../../../shared-checks/requests");
+exports.specs = {
+    description: 'Request to restart message delivery session'
+};
+exports.specs.definition = (setup) => (() => {
+    let user2;
+    let initialSession;
+    let reqOpts;
+    (0, async_jasmine_1.beforeAllAsync)(async () => {
+        user2 = setup().user2;
+        const deliveryUrl = await setup().asmailServer.getDeliveryUrl();
+        initialSession = await (0, test_utils_1.startSessionAndSendMsgObjs)(deliveryUrl, user2.id, test_utils_1.msg);
+        reqOpts = {
+            url: (0, url_1.resolve)(deliveryUrl, delivery_1.sessionRestart.URL_END),
+            method: 'POST',
+            responseType: 'json'
+        };
+    });
+    (0, async_jasmine_1.itAsync)('with ok reply returns session parameters (id, etc.)', async () => {
+        const req = {
+            recipient: user2.id,
+            msgId: initialSession.msgId
+        };
+        const rep = await (0, xhr_utils_1.doJsonRequest)(reqOpts, req);
+        expect(rep.status).withContext('successful session start status').toBe(delivery_1.sessionRestart.SC.ok);
+        expect(typeof rep.data.sessionId).toBe('string');
+        expect(rep.data.sessionId.length).toBeGreaterThan(0);
+        expect(rep.data.maxMsgLength).toBe(initialSession.maxMsgLength);
+        expect(rep.data.maxChunkSize).toBe(initialSession.maxChunkSize);
+    });
+    (0, async_jasmine_1.itAsync)('returns error status when recipient is unknown', async () => {
+        const req = {
+            recipient: 'unknown user@bank.com',
+            msgId: initialSession.msgId
+        };
+        const rep = await (0, xhr_utils_1.doJsonRequest)(reqOpts, req);
+        expect(rep.status).withContext('status for unknown recipient').toBe(delivery_1.sessionRestart.SC.unknownRecipient);
+    });
+    (0, async_jasmine_1.itAsync)(`returns error status when message is not known in delivery`, async () => {
+        const req = {
+            recipient: user2.id,
+            msgId: 'unknown message'
+        };
+        const rep = await (0, xhr_utils_1.doJsonRequest)(reqOpts, req);
+        expect(rep.status).withContext('status for unknown message').toBe(delivery_1.sessionRestart.SC.unknownMsg);
+    });
+    (0, async_jasmine_1.itAsync)('adequately responds to fuzzing', async () => {
+        // bad JSON's
+        const REQ_SIZE_LIMIT = 1024;
+        const badJSONs = [null, undefined, 1, 'string',
+            [1, 2], [], { a: 1, b: 2 }];
+        await (0, requests_1.expectNonAcceptanceOfBadJsonRequest)(reqOpts, REQ_SIZE_LIMIT, badJSONs);
+    });
+});
+Object.freeze(exports);

package/build/tests/protocols/asmail/delivery/specs/start-session.d.ts

@@ -0,0 +1,2 @@
+import { SpecDescribe } from '../test-utils';
+export declare const specs: SpecDescribe;

package/build/tests/protocols/asmail/delivery/specs/start-session.js

@@ -0,0 +1,64 @@
+"use strict";
+/*
+ Copyright (C) 2016 - 2017, 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.specs = void 0;
+const async_jasmine_1 = require("../../../../libs-for-tests/async-jasmine");
+const xhr_utils_1 = require("../../../../libs-for-tests/xhr-utils");
+const url_1 = require("url");
+const delivery_1 = require("../../../../../lib-common/service-api/asmail/delivery");
+const requests_1 = require("../../../../shared-checks/requests");
+exports.specs = {
+    description: 'Request to start message delivery session'
+};
+exports.specs.definition = (setup) => (() => {
+    let user2;
+    let reqOpts;
+    (0, async_jasmine_1.beforeAllAsync)(async () => {
+        user2 = setup().user2;
+        const deliveryUrl = await setup().asmailServer.getDeliveryUrl();
+        reqOpts = {
+            url: (0, url_1.resolve)(deliveryUrl, delivery_1.sessionStart.URL_END),
+            method: 'POST',
+            responseType: 'json'
+        };
+    });
+    (0, async_jasmine_1.itAsync)('with ok reply returns session parameters (id, etc.)', async () => {
+        const req = {
+            recipient: user2.id
+        };
+        const rep = await (0, xhr_utils_1.doJsonRequest)(reqOpts, req);
+        expect(rep.status).withContext('successful session start status').toBe(delivery_1.sessionStart.SC.ok);
+        expect(typeof rep.data.sessionId).toBe('string');
+        expect(rep.data.sessionId.length).toBeGreaterThan(0);
+        expect(typeof rep.data.maxMsgLength).toBe('number');
+        expect(rep.data.maxMsgLength).toBeGreaterThan(0);
+    });
+    (0, async_jasmine_1.itAsync)('returns error status when recipient is unknown', async () => {
+        const req = { recipient: 'unknown user@bank.com' };
+        const rep = await (0, xhr_utils_1.doJsonRequest)(reqOpts, req);
+        expect(rep.status).withContext('status for unknown recipient').toBe(delivery_1.sessionStart.SC.unknownRecipient);
+    });
+    (0, async_jasmine_1.itAsync)('adequately responds to fuzzing', async () => {
+        // bad JSON's
+        const REQ_SIZE_LIMIT = 1024;
+        const badJSONs = [null, undefined, 1, 'string',
+            [1, 2], [], { a: 1, b: 2 }];
+        await (0, requests_1.expectNonAcceptanceOfBadJsonRequest)(reqOpts, REQ_SIZE_LIMIT, badJSONs);
+    });
+});
+Object.freeze(exports);

package/build/tests/protocols/asmail/delivery/test-utils.d.ts

@@ -0,0 +1,16 @@
+import { ASMailComponent } from '../../../libs-for-tests/server-components/asmail';
+import { User } from '../../../libs-for-tests/mailerid';
+import { GenericSpecDescribe } from '../../../libs-for-tests/spec-assembly';
+import { Msg, Obj, DeliveryInfo } from '../../../libs-for-tests/asmail';
+export { ASMailComponent } from '../../../libs-for-tests/server-components/asmail';
+export { User } from '../../../libs-for-tests/mailerid';
+export interface TestSetup {
+    asmailServer: ASMailComponent;
+    user1: User;
+    user2: User;
+}
+export type SpecDescribe = GenericSpecDescribe<TestSetup>;
+export declare const obj1: Obj;
+export declare const obj2: Obj;
+export declare const msg: Msg;
+export declare function startSessionAndSendMsgObjs(deliveryUrl: string, recipient: string, msg: Msg): Promise<DeliveryInfo>;

package/build/tests/protocols/asmail/delivery/test-utils.js

@@ -0,0 +1,46 @@
+"use strict";
+/*
+ Copyright (C) 2017 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.startSessionAndSendMsgObjs = exports.msg = exports.obj2 = exports.obj1 = exports.ASMailComponent = void 0;
+const random_node_1 = require("../../../../lib-common/random-node");
+const asmail_1 = require("../../../libs-for-tests/asmail");
+var asmail_2 = require("../../../libs-for-tests/server-components/asmail");
+Object.defineProperty(exports, "ASMailComponent", { enumerable: true, get: function () { return asmail_2.ASMailComponent; } });
+exports.obj1 = {
+    objId: 'aaaa',
+    header: (0, random_node_1.bytesSync)(100),
+    segs: (0, random_node_1.bytesSync)(573)
+};
+exports.obj2 = {
+    objId: 'bbbb',
+    header: (0, random_node_1.bytesSync)(100),
+    segs: (0, random_node_1.bytesSync)(20 * 1024 + 7)
+};
+exports.msg = {
+    cryptoMeta: { pid: 'xxxx' },
+    msgObjs: [exports.obj1, exports.obj2]
+};
+async function startSessionAndSendMsgObjs(deliveryUrl, recipient, msg) {
+    const sessInfo = await (0, asmail_1.startMsgDelivery)(deliveryUrl, { recipient }, { pid: msg.cryptoMeta.pid,
+        objIds: [msg.msgObjs[0].objId, msg.msgObjs[1].objId] });
+    await (0, asmail_1.sendMsgObj)(deliveryUrl, sessInfo.sessionId, msg.msgObjs[0], sessInfo.maxChunkSize);
+    await (0, asmail_1.sendMsgObj)(deliveryUrl, sessInfo.sessionId, msg.msgObjs[1], sessInfo.maxChunkSize);
+    return sessInfo;
+}
+exports.startSessionAndSendMsgObjs = startSessionAndSendMsgObjs;
+Object.freeze(exports);

package/build/tests/protocols/asmail/delivery.d.ts

@@ -0,0 +1 @@
+export {};

package/build/tests/protocols/asmail/delivery.js

@@ -0,0 +1,46 @@
+"use strict";
+/*
+ Copyright (C) 2016 - 2017 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 });
+const async_jasmine_1 = require("../../libs-for-tests/async-jasmine");
+const asmail_1 = require("../../libs-for-tests/server-components/asmail");
+const config_1 = require("../../../lib-common/service-api/asmail/config");
+const asmail_2 = require("../../libs-for-tests/asmail");
+const path_1 = require("path");
+const spec_assembly_1 = require("../../libs-for-tests/spec-assembly");
+const SPECS_FOLDER = (0, path_1.join)(__dirname, './delivery/specs');
+describe('ASMail delivery service', () => {
+    let asmailServer;
+    const midServiceDomain = 'localhost';
+    const signupDomains = ['company.inc', 'personal.net'];
+    let user1;
+    let user2;
+    (0, async_jasmine_1.beforeAllAsync)(async () => {
+        asmailServer = new asmail_1.ASMailComponent(signupDomains, midServiceDomain);
+        await asmailServer.start();
+        user1 = await asmailServer.addUser(`Bob Johnson @${signupDomains[0]}`);
+        user2 = await asmailServer.addUser(`William Young @${signupDomains[1]}`);
+        const user2Params = {};
+        user2Params[config_1.p.initPubKey.URL_END] = await (0, asmail_2.generateInitPubKey)(asmailServer.midUrl, user2);
+        await (0, asmail_2.setInboxParams)(asmailServer.asmailUrl, user2, user2Params);
+    });
+    (0, async_jasmine_1.afterAllAsync)(async () => {
+        await asmailServer.stop();
+        asmailServer = undefined;
+    });
+    (0, spec_assembly_1.addSpecsFrom)(SPECS_FOLDER, () => ({ asmailServer, user1, user2 }));
+});

package/build/tests/protocols/asmail/retrieval/specs/events.d.ts

@@ -0,0 +1,2 @@
+import { SpecDescribe } from '../test-utils';
+export declare const specs: SpecDescribe;

package/build/tests/protocols/asmail/retrieval/specs/events.js

@@ -0,0 +1,62 @@
+"use strict";
+/*
+ Copyright (C) 2017, 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.specs = void 0;
+const async_jasmine_1 = require("../../../../libs-for-tests/async-jasmine");
+const test_utils_1 = require("../test-utils");
+const ws_utils_1 = require("../../../../libs-for-tests/ws-utils");
+const processes_1 = require("../../../../../lib-common/processes");
+const ws_ipc_1 = require("../../../../../lib-common/ipc/ws-ipc");
+const retrieval_1 = require("../../../../../lib-common/service-api/asmail/retrieval");
+const rxjs_1 = require("rxjs");
+exports.specs = {
+    description: `is an event emitter`
+};
+exports.specs.definition = (setup) => (() => {
+    let asmailServer;
+    let wsUrl;
+    let deliveryUrl;
+    let user1;
+    let sessionId;
+    (0, async_jasmine_1.beforeEachAsync)(async () => {
+        asmailServer = setup().asmailServer;
+        const retrievalUrl = await asmailServer.getRetrievalUrl();
+        wsUrl = `wss${retrievalUrl.substring(5)}${retrieval_1.wsEventChannel.URL_END}`;
+        deliveryUrl = await asmailServer.getDeliveryUrl();
+        user1 = setup().user1;
+        sessionId = await (0, test_utils_1.startSession)(user1, retrievalUrl);
+    });
+    (0, async_jasmine_1.itAsync)(`requires session to open web socket`, async () => {
+        let rep = await (0, ws_utils_1.openSocket)(wsUrl, 'invalid session id');
+        expect(rep.status).withContext('status for missing authorized session').toBe(retrieval_1.ERR_SC.needAuth);
+    });
+    (0, async_jasmine_1.itAsync)(`emits event on completion of message reception`, async () => {
+        let rep = await (0, ws_utils_1.openSocket)(wsUrl, sessionId);
+        expect(rep.status).toBe(retrieval_1.wsEventChannel.SC.ok);
+        const eventSrc = (0, ws_ipc_1.makeSubscriber)(rep.data, undefined);
+        const eventPromise = rxjs_1.Observable.create(obs => eventSrc.subscribe(retrieval_1.msgRecievedCompletely.EVENT_NAME, obs))
+            .take(1)
+            .toPromise();
+        // give some time for subscription to occur
+        await (0, processes_1.sleep)(10);
+        const msgId = await (0, test_utils_1.sendMsg)(deliveryUrl, user1.id, test_utils_1.msg);
+        const event = await eventPromise;
+        expect(typeof event).toBe('object');
+        expect(event.msgId).withContext(`message reception completion event should give a respective message id`).toBe(msgId);
+    });
+});

package/build/tests/protocols/asmail/retrieval/specs/get-message-meta.d.ts

@@ -0,0 +1,2 @@
+import { SpecDescribe } from '../test-utils';
+export declare const specs: SpecDescribe;

package/build/tests/protocols/asmail/retrieval/specs/get-message-meta.js

@@ -0,0 +1,70 @@
+"use strict";
+/*
+ Copyright (C) 2016 - 2017, 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.specs = void 0;
+const async_jasmine_1 = require("../../../../libs-for-tests/async-jasmine");
+const test_utils_1 = require("../test-utils");
+const url_1 = require("url");
+const retrieval_1 = require("../../../../../lib-common/service-api/asmail/retrieval");
+const xhr_utils_1 = require("../../../../libs-for-tests/xhr-utils");
+const requests_1 = require("../../../../shared-checks/requests");
+const json_copy_1 = require("../../../../libs-for-tests/json-copy");
+exports.specs = {
+    description: `Request to get message meta`
+};
+exports.specs.definition = (setup) => (() => {
+    let asmailServer;
+    let retrievalUrl;
+    let deliveryUrl;
+    let user1;
+    let reqOpts;
+    (0, async_jasmine_1.beforeEachAsync)(async () => {
+        asmailServer = setup().asmailServer;
+        retrievalUrl = await asmailServer.getRetrievalUrl();
+        deliveryUrl = await asmailServer.getDeliveryUrl();
+        user1 = setup().user1;
+        const sessionId = await (0, test_utils_1.startSession)(user1, retrievalUrl);
+        reqOpts = {
+            url: (0, url_1.resolve)(retrievalUrl, retrieval_1.msgMetadata.genUrlEnd('some-msg')),
+            method: 'GET',
+            responseType: 'json',
+            sessionId
+        };
+    });
+    (0, async_jasmine_1.itAsync)('returns message metadata', async () => {
+        const msgId = await (0, test_utils_1.sendMsg)(deliveryUrl, user1.id, test_utils_1.msg);
+        const opts = (0, json_copy_1.copy)(reqOpts);
+        opts.url = (0, url_1.resolve)(retrievalUrl, retrieval_1.msgMetadata.genUrlEnd(msgId));
+        const rep = await (0, xhr_utils_1.doBodylessRequest)(opts);
+        expect(rep.status).withContext('status for successfully found message').toBe(retrieval_1.msgMetadata.SC.ok);
+        expect(rep.data.authSender).toBeFalsy();
+        expect(typeof rep.data.deliveryStart).toBe('number');
+        expect(typeof rep.data.deliveryCompletion).toBe('number');
+        expect(rep.data.deliveryStart).not.toBeGreaterThan(rep.data.deliveryCompletion);
+    });
+    (0, async_jasmine_1.itAsync)(`returns an error when message is unknown`, async () => {
+        const opts = (0, json_copy_1.copy)(reqOpts);
+        opts.url = (0, url_1.resolve)(retrievalUrl, retrieval_1.msgMetadata.genUrlEnd('unknown-message'));
+        const rep = await (0, xhr_utils_1.doBodylessRequest)(opts);
+        expect(rep.status).withContext('status for unknown message').toBe(retrieval_1.msgMetadata.SC.unknownMsg);
+    });
+    (0, async_jasmine_1.itAsync)(`requires open session`, async () => {
+        const opts = (0, json_copy_1.copy)(reqOpts);
+        await (0, requests_1.expectNonAcceptanceOfBadSessionId)(opts);
+    });
+});

package/build/tests/protocols/asmail/retrieval/specs/get-message-obj.d.ts

@@ -0,0 +1,2 @@
+import { SpecDescribe } from '../test-utils';
+export declare const specs: SpecDescribe;