spec-3nweb-server 1.8.4 → 1.8.6

package/build/tests/protocols/3nstorage/owner/specs/trans-cancel.js

@@ -0,0 +1,72 @@
+"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 test_utils_1 = require("../test-utils");
+const owner_1 = require("../../../../../lib-common/service-api/3nstorage/owner");
+const async_jasmine_1 = require("../../../../libs-for-tests/async-jasmine");
+const xhr_utils_1 = require("../../../../libs-for-tests/xhr-utils");
+const requests_1 = require("../../../../shared-checks/requests");
+const random_node_1 = require("../../../../../lib-common/random-node");
+const url_1 = require("url");
+exports.specs = {
+    description: 'Request to cancel non-root object transaction'
+};
+const obj = {
+    objId: 'aaaa',
+    version: 1,
+    header: (0, random_node_1.bytesSync)(100),
+    segs: (0, random_node_1.bytesSync)(573)
+};
+exports.specs.definition = (setup) => (() => {
+    let reqOpts;
+    let storageServer;
+    let user;
+    let transactionId;
+    (0, async_jasmine_1.beforeAllAsync)(async () => {
+        storageServer = setup().storageServer;
+        user = setup().user;
+        await storageServer.restartAndClearStorageFor(user.id);
+        const sessionId = await (0, test_utils_1.startSession)(user);
+        const fstReqOpts = {
+            url: (0, url_1.resolve)(user.storageOwnerUrl, owner_1.currentObj.firstPutReqUrlEnd(obj.objId, { ver: 1, header: obj.header.length })),
+            method: 'PUT',
+            sessionId
+        };
+        const fstRep = await (0, xhr_utils_1.doBinaryRequest)(fstReqOpts, obj.header);
+        transactionId = fstRep.data.transactionId;
+        reqOpts = {
+            url: (0, url_1.resolve)(user.storageOwnerUrl, owner_1.cancelTransaction.getReqUrlEnd(obj.objId, transactionId)),
+            method: 'POST',
+            sessionId: sessionId
+        };
+    });
+    (0, async_jasmine_1.itAsync)('cancels object transaction', async () => {
+        expect(await storageServer.currentObjExists(user.id, obj.objId)).withContext('initially, there is no object').toBeFalsy();
+        expect(await storageServer.transactionExists(user.id, obj.objId)).withContext('initially, there is a started transaction').toBeTruthy();
+        // normal reply
+        const rep = await (0, xhr_utils_1.doBodylessRequest)(reqOpts);
+        expect(rep.status).withContext('status for normal transaction completion').toBe(owner_1.cancelTransaction.SC.ok);
+        expect(await storageServer.transactionExists(user.id, obj.objId)).withContext('transaction should not be present, as it has been completed').toBeFalsy();
+        expect(await storageServer.currentObjExists(user.id, obj.objId, 1, obj)).withContext('object is not created, cause transaction has been cancelled').toBeFalsy();
+        // XXX split out fuzzing requests
+        await (0, requests_1.expectNonAcceptanceOfNonEmptyBody)(reqOpts);
+        await (0, requests_1.expectNonAcceptanceOfBadSessionId)(reqOpts);
+    });
+    // XXX add cancelation with unknown object id, and unknown transaction id
+});

package/build/tests/protocols/3nstorage/owner/test-utils.d.ts

@@ -0,0 +1,14 @@
+import { User } from '../../../libs-for-tests/mailerid';
+import * as api from '../../../../lib-common/service-api/3nstorage/owner';
+import { StorageComponent } from '../../../libs-for-tests/server-components/3nstorage';
+import { GenericSpecDescribe } from '../../../libs-for-tests/spec-assembly';
+export { User } from '../../../libs-for-tests/mailerid';
+export { StorageComponent } from '../../../libs-for-tests/server-components/3nstorage';
+export interface TestSetup {
+    user: User;
+    storageServer: StorageComponent;
+}
+export type SpecDescribe = GenericSpecDescribe<TestSetup>;
+export declare function startSession(user: User): Promise<string>;
+export declare function getObjStatus(user: User, objId: string | null, sessionId: string): Promise<api.ObjStatus>;
+export declare function archiveObjVer(user: User, objId: string | null, version: number, sessionId: string): Promise<void>;

package/build/tests/protocols/3nstorage/owner/test-utils.js

@@ -0,0 +1,54 @@
+"use strict";
+/*
+ Copyright (C) 2016, 2022 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.archiveObjVer = exports.getObjStatus = exports.startSession = exports.StorageComponent = void 0;
+const mailerid_1 = require("../../../libs-for-tests/mailerid");
+const url_1 = require("url");
+const api = require("../../../../lib-common/service-api/3nstorage/owner");
+const xhr_utils_1 = require("../../../libs-for-tests/xhr-utils");
+const assert_1 = require("../../../libs-for-tests/assert");
+var _3nstorage_1 = require("../../../libs-for-tests/server-components/3nstorage");
+Object.defineProperty(exports, "StorageComponent", { enumerable: true, get: function () { return _3nstorage_1.StorageComponent; } });
+async function startSession(user) {
+    return await (0, mailerid_1.doMailerIdLogin)((0, url_1.resolve)(user.storageOwnerUrl, api.midLogin.URL_PART), user);
+}
+exports.startSession = startSession;
+async function getObjStatus(user, objId, sessionId) {
+    const rep = await (0, xhr_utils_1.doBodylessRequest)({
+        url: (0, url_1.resolve)(user.storageOwnerUrl, (objId ?
+            api.objStatus.getReqUrlEnd(objId) : api.rootStatus.getReqUrlEnd())),
+        method: 'GET',
+        sessionId,
+        responseType: 'json'
+    });
+    (0, assert_1.assert)(rep.status === api.objStatus.SC.ok, `Unexpected status ${rep.status} with data ${rep.data}, when listing archived versions of object ${objId}`);
+    return rep.data;
+}
+exports.getObjStatus = getObjStatus;
+async function archiveObjVer(user, objId, version, sessionId) {
+    const rep = await (0, xhr_utils_1.doBodylessRequest)({
+        url: (0, url_1.resolve)(user.storageOwnerUrl, (objId ?
+            api.archiveObj.postAndDelReqUrlEnd(objId, version) :
+            api.archiveRoot.postAndDelReqUrlEnd(version))),
+        method: 'POST',
+        sessionId
+    });
+    (0, assert_1.assert)(rep.status === api.archiveObj.SC.okPost, `Unexpected status ${rep.status} with data ${rep.data}, when archiving version ${version} of object ${objId}`);
+}
+exports.archiveObjVer = archiveObjVer;
+Object.freeze(exports);

package/build/tests/protocols/3nstorage/owner.d.ts

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

package/build/tests/protocols/3nstorage/owner.js

@@ -0,0 +1,138 @@
+"use strict";
+/*
+ Copyright (C) 2016, 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 });
+const async_jasmine_1 = require("../../libs-for-tests/async-jasmine");
+const _3nstorage_1 = require("../../libs-for-tests/server-components/3nstorage");
+const mailerid_1 = require("../../libs-for-tests/mailerid");
+const check_mid_login_1 = require("../../shared-checks/check-mid-login");
+const url_1 = require("url");
+const api = require("../../../lib-common/service-api/3nstorage/owner");
+const xhr_utils_1 = require("../../libs-for-tests/xhr-utils");
+const requests_1 = require("../../shared-checks/requests");
+const test_utils_1 = require("./owner/test-utils");
+const path_1 = require("path");
+const spec_assembly_1 = require("../../libs-for-tests/spec-assembly");
+const json_equal_1 = require("../../libs-for-tests/json-equal");
+const SPECS_FOLDER = (0, path_1.join)(__dirname, './owner/specs');
+describe('3NStorage owner service', () => {
+    let storageServer;
+    const midServiceDomain = 'localhost';
+    const signupDomains = ['company.inc', 'personal.net'];
+    let user;
+    (0, async_jasmine_1.beforeAllAsync)(async () => {
+        storageServer = new _3nstorage_1.StorageComponent(signupDomains, midServiceDomain);
+        await storageServer.start();
+        user = await storageServer.addUser(`Bob Johnson @${signupDomains[0]}`);
+        await storageServer.stop(false);
+    });
+    (0, async_jasmine_1.afterAllAsync)(async () => {
+        if (storageServer.isRunning()) {
+            await storageServer.stop();
+        }
+        else {
+            await storageServer.clean();
+        }
+        storageServer = undefined;
+    });
+    describe('session', () => {
+        (0, async_jasmine_1.beforeAllAsync)(async () => {
+            await storageServer.restart();
+        });
+        describe('MailerId login', (0, check_mid_login_1.midLoginSpecs)(() => (0, url_1.resolve)(user.storageOwnerUrl, api.midLogin.URL_PART), () => user));
+        (0, async_jasmine_1.itAsync)('closing', async () => {
+            const sessionId = await (0, test_utils_1.startSession)(user);
+            const reqOpts = {
+                url: (0, url_1.resolve)(user.storageOwnerUrl, api.closeSession.URL_END),
+                method: 'POST',
+                sessionId
+            };
+            // normal closing of a session
+            let rep = await (0, xhr_utils_1.doBodylessRequest)(reqOpts);
+            expect(rep.status).withContext('status for successful closing of session').toBe(200);
+            // repeated call should see invalid session respose
+            rep = await (0, xhr_utils_1.doBodylessRequest)(reqOpts);
+            expect(rep.status).toBe(api.ERR_SC.needAuth);
+            reqOpts.sessionId = await (0, mailerid_1.doMailerIdLogin)((0, url_1.resolve)(user.storageOwnerUrl, api.midLogin.URL_PART), user);
+            await (0, requests_1.expectNonAcceptanceOfNonEmptyBody)(reqOpts);
+            await (0, requests_1.expectNonAcceptanceOfBadSessionId)(reqOpts);
+        });
+        (0, async_jasmine_1.itAsync)('dictates parameters to client side', async () => {
+            const ownerUrl = user.storageOwnerUrl;
+            const sessionId = await (0, test_utils_1.startSession)(user);
+            const reqOpts = {
+                url: (0, url_1.resolve)(ownerUrl, api.sessionParams.URL_END),
+                method: 'GET',
+                responseType: 'json',
+                sessionId
+            };
+            const rep = await (0, xhr_utils_1.doBodylessRequest)(reqOpts);
+            expect(rep.status).withContext('for successful getting of session parameters').toBe(200);
+            expect(typeof rep.data.maxChunkSize).toBe('number');
+            expect(rep.data.maxChunkSize).not.toBeLessThan(64 * 1024);
+            await (0, requests_1.expectNonAcceptanceOfBadSessionId)(reqOpts);
+        });
+    });
+    function checkParamRoutes(paramUrlPart, goodValues, badValues, maxBodyLen) {
+        return () => {
+            let sessionId;
+            (0, async_jasmine_1.beforeAllAsync)(async () => {
+                sessionId = await (0, test_utils_1.startSession)(user);
+            });
+            (0, async_jasmine_1.itAsync)('is readable', async () => {
+                const reqOpts = {
+                    url: (0, url_1.resolve)(user.storageOwnerUrl, paramUrlPart),
+                    method: 'GET',
+                    responseType: 'json',
+                    sessionId
+                };
+                const rep = await (0, xhr_utils_1.doBodylessRequest)(reqOpts);
+                expect(rep.status).withContext('status for reading parameter').toBe(api.PARAM_SC.ok);
+                await (0, requests_1.expectNonAcceptanceOfBadSessionId)(reqOpts);
+            });
+            async function getParam() {
+                const reqOpts = {
+                    url: (0, url_1.resolve)(user.storageOwnerUrl, paramUrlPart),
+                    method: 'GET',
+                    responseType: 'json',
+                    sessionId
+                };
+                const rep = await (0, xhr_utils_1.doBodylessRequest)(reqOpts);
+                expect(rep.status).toBe(api.PARAM_SC.ok);
+                return rep.data;
+            }
+            (0, async_jasmine_1.itAsync)('is writable', async () => {
+                const initValue = await getParam();
+                const reqOpts = {
+                    url: (0, url_1.resolve)(user.storageOwnerUrl, paramUrlPart),
+                    method: 'PUT',
+                    sessionId
+                };
+                for (const paramVal of goodValues) {
+                    const rep = await (0, xhr_utils_1.doJsonRequest)(reqOpts, paramVal);
+                    expect(rep.status).withContext('status for successful parameter value update').toBe(api.PARAM_SC.ok);
+                    const paramOnServer = await getParam();
+                    expect((0, json_equal_1.deepEqual)(paramVal, paramOnServer)).withContext('parameter value on the server should be set to new value').toBe(true);
+                }
+                await (0, requests_1.expectNonAcceptanceOfBadJsonRequest)(reqOpts, maxBodyLen, badValues);
+                await (0, requests_1.expectNonAcceptanceOfBadSessionId)(reqOpts);
+            });
+        };
+    }
+    describe(`user's key derivation parameters`, checkParamRoutes(api.keyDerivParams.URL_END, [], [1, undefined, 'string', [1, 2], []], 1024));
+    (0, spec_assembly_1.addSpecsFrom)(SPECS_FOLDER, () => ({ user, storageServer }));
+});

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

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

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

@@ -0,0 +1,117 @@
+"use strict";
+/*
+ Copyright (C) 2016, 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 });
+const async_jasmine_1 = require("../../libs-for-tests/async-jasmine");
+const asmail_1 = require("../../libs-for-tests/server-components/asmail");
+const mailerid_1 = require("../../libs-for-tests/mailerid");
+const check_mid_login_1 = require("../../shared-checks/check-mid-login");
+const api = require("../../../lib-common/service-api/asmail/config");
+const xhr_utils_1 = require("../../libs-for-tests/xhr-utils");
+const requests_1 = require("../../shared-checks/requests");
+const url_1 = require("url");
+const json_equal_1 = require("../../libs-for-tests/json-equal");
+describe('ASMail configuration', () => {
+    let asmailServer;
+    const midServiceDomain = 'localhost';
+    const signupDomains = ['company.inc', 'personal.net'];
+    let user1;
+    let confUrl;
+    (0, async_jasmine_1.beforeAllAsync)(async () => {
+        asmailServer = new asmail_1.ASMailComponent(signupDomains, midServiceDomain);
+        await asmailServer.start();
+        confUrl = await asmailServer.getConfUrl();
+        if (!confUrl.endsWith('/')) {
+            confUrl += '/';
+        }
+        user1 = await asmailServer.addUser(`Bob Johnson @${signupDomains[0]}`);
+    });
+    (0, async_jasmine_1.afterAllAsync)(async () => {
+        await asmailServer.stop();
+        asmailServer = undefined;
+    });
+    describe('MailerId login', (0, check_mid_login_1.midLoginSpecs)(() => (0, url_1.resolve)(confUrl, api.midLogin.URL_PART), () => user1));
+    async function startSession(user) {
+        return await (0, mailerid_1.doMailerIdLogin)((0, url_1.resolve)(confUrl, api.midLogin.URL_PART), user);
+    }
+    function checkParamRoutes(paramUrlPart, goodValues, badValues, maxBodyLen) {
+        return () => {
+            let sessionId;
+            (0, async_jasmine_1.beforeAllAsync)(async () => {
+                sessionId = await startSession(user1);
+            });
+            (0, async_jasmine_1.itAsync)('is readable', async () => {
+                const reqOpts = {
+                    url: (0, url_1.resolve)(confUrl, paramUrlPart),
+                    method: 'GET',
+                    responseType: 'json',
+                    sessionId
+                };
+                const rep = await (0, xhr_utils_1.doBodylessRequest)(reqOpts);
+                expect(rep.status).withContext('status for reading parameter').toBe(api.PARAM_SC.ok);
+                await (0, requests_1.expectNonAcceptanceOfBadSessionId)(reqOpts);
+            });
+            async function getParam() {
+                const reqOpts = {
+                    url: (0, url_1.resolve)(confUrl, paramUrlPart),
+                    method: 'GET',
+                    responseType: 'json',
+                    sessionId
+                };
+                const rep = await (0, xhr_utils_1.doBodylessRequest)(reqOpts);
+                expect(rep.status).toBe(api.PARAM_SC.ok);
+                return rep.data;
+            }
+            (0, async_jasmine_1.itAsync)('is writable', async () => {
+                const reqOpts = {
+                    url: (0, url_1.resolve)(confUrl, paramUrlPart),
+                    method: 'PUT',
+                    sessionId
+                };
+                for (const paramVal of goodValues) {
+                    const rep = await (0, xhr_utils_1.doJsonRequest)(reqOpts, paramVal);
+                    expect(rep.status).withContext('status for successful parameter value update').toBe(api.PARAM_SC.ok);
+                    const paramOnServer = await getParam();
+                    expect((0, json_equal_1.deepEqual)(paramVal, paramOnServer)).withContext('parameter value on the server should be set to new value').toBe(true);
+                }
+                await (0, requests_1.expectNonAcceptanceOfBadJsonRequest)(reqOpts, maxBodyLen, badValues);
+                await (0, requests_1.expectNonAcceptanceOfBadSessionId)(reqOpts);
+            });
+        };
+    }
+    // TODO add route checking for other parameters,
+    //		write stricter good/bad values that go into the check
+    describe(`user's initial public key`, checkParamRoutes(api.p.initPubKey.URL_END, [], [1, undefined, 'string', [1, 2], []], 4 * 1024));
+    describe(`invites for anonymous senders`, checkParamRoutes(api.p.anonSenderInvites.URL_END, [{}], [1, null, undefined, 'string'], 40 * 1024));
+    (0, async_jasmine_1.itAsync)(`closing session`, async () => {
+        const sessionId = await startSession(user1);
+        const reqOpts = {
+            url: (0, url_1.resolve)(confUrl, api.closeSession.URL_END),
+            method: 'POST',
+            sessionId
+        };
+        // normal closing of a session
+        let rep = await (0, xhr_utils_1.doBodylessRequest)(reqOpts);
+        expect(rep.status).withContext('status for successful closing of session').toBe(200);
+        // repeated call should see invalid session respose
+        rep = await (0, xhr_utils_1.doBodylessRequest)(reqOpts);
+        expect(rep.status).toBe(api.ERR_SC.needAuth);
+        reqOpts.sessionId = await startSession(user1);
+        await (0, requests_1.expectNonAcceptanceOfNonEmptyBody)(reqOpts);
+        await (0, requests_1.expectNonAcceptanceOfBadSessionId)(reqOpts);
+    });
+});

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

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

package/build/tests/protocols/asmail/delivery/specs/finalize-delivery.js

@@ -0,0 +1,60 @@
+"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 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 complete message delivery`
+};
+exports.specs.definition = (setup) => (() => {
+    let user2;
+    let deliveryUrl;
+    let asmailServer;
+    let sessInfo;
+    let reqOpts;
+    (0, async_jasmine_1.beforeEachAsync)(async () => {
+        user2 = setup().user2;
+        asmailServer = setup().asmailServer;
+        deliveryUrl = await asmailServer.getDeliveryUrl();
+        sessInfo = await (0, test_utils_1.startSessionAndSendMsgObjs)(deliveryUrl, user2.id, test_utils_1.msg);
+        reqOpts = {
+            url: (0, url_1.resolve)(deliveryUrl, delivery_1.completion.URL_END),
+            method: 'POST',
+            sessionId: sessInfo.sessionId
+        };
+    });
+    (0, async_jasmine_1.itAsync)(`marks message as completely delivered`, async () => {
+        expect(await asmailServer.msgExists(user2.id, sessInfo.msgId, false)).withContext('message is known to be in delivery').toBeTruthy();
+        let rep = await (0, xhr_utils_1.doBodylessRequest)(reqOpts);
+        expect(rep.status).withContext('normal end of message delivering session').toBe(delivery_1.completion.SC.ok);
+        expect(await asmailServer.msgExists(user2.id, sessInfo.msgId, true, test_utils_1.msg)).withContext('message must now be delivered').toBeTruthy();
+        // duplicate should not work, as session is already closed
+        rep = await (0, xhr_utils_1.doBodylessRequest)(reqOpts);
+        expect(rep.status).toBe(requests_1.UNAUTHORIZED_STATUS);
+    });
+    (0, async_jasmine_1.itAsync)('adequately responds to fuzzing', async () => {
+        await (0, requests_1.expectNonAcceptanceOfNonEmptyBody)(reqOpts);
+        await (0, requests_1.expectNonAcceptanceOfBadSessionId)(reqOpts);
+    });
+});
+Object.freeze(exports);

package/build/tests/protocols/asmail/delivery/specs/provide-recipient-pubkey.d.ts

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

package/build/tests/protocols/asmail/delivery/specs/provide-recipient-pubkey.js

@@ -0,0 +1,68 @@
+"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");
+const asmail_1 = require("../../../../libs-for-tests/asmail");
+const json_copy_1 = require("../../../../libs-for-tests/json-copy");
+exports.specs = {
+    description: `Request to get recipient's registered initial key`
+};
+exports.specs.definition = (setup) => (() => {
+    let deliveryUrl;
+    let user1;
+    let user2;
+    let baseReqOpts;
+    (0, async_jasmine_1.beforeAllAsync)(async () => {
+        user1 = setup().user1;
+        user2 = setup().user2;
+        deliveryUrl = await setup().asmailServer.getDeliveryUrl();
+        baseReqOpts = {
+            url: (0, url_1.resolve)(deliveryUrl, delivery_1.initPubKey.URL_END),
+            method: 'GET',
+            responseType: 'json'
+        };
+    });
+    (0, async_jasmine_1.itAsync)(`returns certificates, registered by recipient`, async () => {
+        const sessInfo = await (0, asmail_1.startMsgDeliverySession)(deliveryUrl, { recipient: user2.id });
+        const reqOpts = (0, json_copy_1.copy)(baseReqOpts);
+        reqOpts.sessionId = sessInfo.sessionId;
+        const rep = await (0, xhr_utils_1.doBodylessRequest)(reqOpts);
+        expect(rep.status).withContext('status for successfully getting a key').toBe(delivery_1.initPubKey.SC.ok);
+        // TODO add check of certs, together with adding check in setting pkey
+    });
+    (0, async_jasmine_1.itAsync)(`returns error, when recipient registered no certs`, async () => {
+        // recipient doesn't have initial public key registered
+        const sessInfo = await (0, asmail_1.startMsgDeliverySession)(deliveryUrl, { recipient: user1.id });
+        const reqOpts = (0, json_copy_1.copy)(baseReqOpts);
+        reqOpts.sessionId = sessInfo.sessionId;
+        let rep = await (0, xhr_utils_1.doBodylessRequest)(reqOpts);
+        expect(rep.status).withContext('status for no key registered with server').toBe(delivery_1.initPubKey.SC.pkeyNotRegistered);
+        // session is closed, when there is no key, so repeat request is denied
+        rep = await (0, xhr_utils_1.doBodylessRequest)(reqOpts);
+        expect(rep.status).withContext('status for closed session').toBe(requests_1.UNAUTHORIZED_STATUS);
+    });
+    (0, async_jasmine_1.itAsync)('adequately responds to fuzzing', async () => {
+        await (0, requests_1.expectNonAcceptanceOfBadSessionId)(baseReqOpts);
+    });
+});
+Object.freeze(exports);

package/build/tests/protocols/asmail/delivery/specs/put-metadata.d.ts

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

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

@@ -0,0 +1,83 @@
+"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 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");
+exports.specs = {
+    description: `Request to put message's metadata`
+};
+exports.specs.definition = (setup) => (() => {
+    let user2;
+    let reqOpts;
+    let asmailServer;
+    (0, async_jasmine_1.beforeEachAsync)(async () => {
+        user2 = setup().user2;
+        asmailServer = setup().asmailServer;
+        const deliveryUrl = await asmailServer.getDeliveryUrl();
+        const sessInfo = await (0, asmail_1.startMsgDeliverySession)(deliveryUrl, { recipient: user2.id });
+        reqOpts = {
+            url: (0, url_1.resolve)(deliveryUrl, delivery_1.msgMeta.URL_END),
+            method: 'PUT',
+            responseType: 'json',
+            sessionId: sessInfo.sessionId
+        };
+    });
+    (0, async_jasmine_1.itAsync)('starts actual message delivery, returning message id', async () => {
+        const req = {
+            pid: test_utils_1.msg.cryptoMeta.pid,
+            objIds: [test_utils_1.msg.msgObjs[0].objId, test_utils_1.msg.msgObjs[1].objId]
+        };
+        const rep = await (0, xhr_utils_1.doJsonRequest)(reqOpts, req);
+        expect(rep.status).withContext('status for normal meta acceptance and issue of a corresponding message id').toBe(delivery_1.msgMeta.SC.ok);
+        expect(typeof rep.data.msgId).toBe('string');
+        const msgId = rep.data.msgId;
+        expect(msgId.length).toBeGreaterThan(0);
+        expect(typeof rep.data.maxChunkSize).toBe('number');
+        expect(rep.data.maxChunkSize).not.toBeLessThan(64 * 1024);
+        expect(await asmailServer.msgExists(user2.id, msgId, false)).withContext('message is known to be in delivery').toBeTruthy();
+    });
+    (0, async_jasmine_1.itAsync)('is not allowing message with object ids that are either same, or have chars not from base64 url-safe alphabet', async () => {
+        // request with object ids, exact to letter case
+        const req = {
+            pid: test_utils_1.msg.cryptoMeta.pid,
+            objIds: [test_utils_1.msg.msgObjs[0].objId, test_utils_1.msg.msgObjs[0].objId.toLowerCase()]
+        };
+        let rep = await (0, xhr_utils_1.doJsonRequest)(reqOpts, req);
+        expect(rep.status).withContext('same object ids are not allowed').toBe(delivery_1.ERR_SC.malformed);
+        req.objIds = [test_utils_1.msg.msgObjs[0].objId, test_utils_1.msg.msgObjs[0].objId + '+as'];
+        rep = await (0, xhr_utils_1.doJsonRequest)(reqOpts, req);
+        expect(rep.status).withContext('object ids, equal to letter case, are not allowed').toBe(delivery_1.ERR_SC.malformed);
+    });
+    (0, async_jasmine_1.itAsync)('adequately responds to fuzzing', async () => {
+        // bad JSON's
+        const REQ_SIZE_LIMIT = 16 * 1024;
+        const badJSONs = [null, undefined, 1, 'string',
+            // XXX add meta checks to screen out these
+            // [1,2], [], { a:1, b:2 }
+        ];
+        await (0, requests_1.expectNonAcceptanceOfBadJsonRequest)(reqOpts, REQ_SIZE_LIMIT, badJSONs);
+        await (0, requests_1.expectNonAcceptanceOfBadSessionId)(reqOpts, true);
+    });
+});
+Object.freeze(exports);

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

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