spec-3nweb-server 1.8.5 → 1.8.6

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

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

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

@@ -0,0 +1,97 @@
+/*
+ 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/>.
+*/
+
+import { beforeAllAsync, itAsync } from '../../../../libs-for-tests/async-jasmine';
+import { SpecDescribe, TestSetup, User, startSessionAndSendMsgObjs, msg } from '../test-utils';
+import { doJsonRequest, RequestOpts } from '../../../../libs-for-tests/xhr-utils';
+import { resolve as resolveUrl } from 'url';
+import { sessionRestart as api } from '../../../../../lib-common/service-api/asmail/delivery';
+import { expectNonAcceptanceOfBadJsonRequest } from '../../../../shared-checks/requests';
+import { DeliveryInfo } from '../../../../libs-for-tests/asmail';
+
+export const specs: SpecDescribe = {
+	description: 'Request to restart message delivery session'
+};
+
+specs.definition = (setup: () => TestSetup) => (() => {
+
+	let user2: User;
+	let initialSession: DeliveryInfo;
+	let reqOpts: RequestOpts;
+
+	beforeAllAsync(async () => {
+		user2 = setup().user2;
+		const deliveryUrl = await setup().asmailServer.getDeliveryUrl();
+		initialSession = await startSessionAndSendMsgObjs(
+			deliveryUrl, user2.id, msg);
+		reqOpts = {
+			url: resolveUrl(deliveryUrl, api.URL_END),
+			method: 'POST',
+			responseType: 'json'
+		};
+	});
+
+	itAsync('with ok reply returns session parameters (id, etc.)', async () => {
+		
+		const req: api.Request = {
+			recipient: user2.id,
+			msgId: initialSession.msgId
+		};
+		
+		const rep = await doJsonRequest<api.Reply>(reqOpts, req);
+		expect(rep.status).withContext('successful session start status').toBe(api.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);
+		
+	});
+
+	itAsync('returns error status when recipient is unknown', async () => {
+		const req: api.Request = {
+			recipient: 'unknown user@bank.com',
+			msgId: initialSession.msgId
+		};
+		const rep = await doJsonRequest<api.Reply>(reqOpts, req);
+		expect(rep.status).withContext('status for unknown recipient').toBe(api.SC.unknownRecipient);
+	});
+
+	itAsync(`returns error status when message is not known in delivery`,
+			async () => {
+		const req: api.Request = {
+			recipient: user2.id,
+			msgId: 'unknown message'
+		};
+		const rep = await doJsonRequest<api.Reply>(reqOpts, req);
+		expect(rep.status).withContext('status for unknown message').toBe(api.SC.unknownMsg);
+	});
+
+	itAsync('adequately responds to fuzzing', async () => {
+		
+		// bad JSON's
+		const REQ_SIZE_LIMIT = 1024;
+		const badJSONs: any[] = [ null, undefined, 1, 'string',
+			[1,2], [], { a:1, b:2 }];
+		await expectNonAcceptanceOfBadJsonRequest(reqOpts, REQ_SIZE_LIMIT,
+			badJSONs);
+			
+	});
+
+	
+});
+
+Object.freeze(exports);

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

@@ -0,0 +1,79 @@
+/*
+ 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/>.
+*/
+
+import { beforeAllAsync, itAsync } from '../../../../libs-for-tests/async-jasmine';
+import { SpecDescribe, TestSetup, User } from '../test-utils';
+import { doJsonRequest, RequestOpts } from '../../../../libs-for-tests/xhr-utils';
+import { resolve as resolveUrl } from 'url';
+import { sessionStart as api } from '../../../../../lib-common/service-api/asmail/delivery';
+import { expectNonAcceptanceOfBadJsonRequest } from '../../../../shared-checks/requests';
+
+export const specs: SpecDescribe = {
+	description: 'Request to start message delivery session'
+};
+
+specs.definition = (setup: () => TestSetup) => (() => {
+
+	let user2: User;
+	let reqOpts: RequestOpts;
+
+	beforeAllAsync(async () => {
+		user2 = setup().user2;
+		const deliveryUrl = await setup().asmailServer.getDeliveryUrl();
+		reqOpts = {
+			url: resolveUrl(deliveryUrl, api.URL_END),
+			method: 'POST',
+			responseType: 'json'
+		};
+	});
+
+	itAsync('with ok reply returns session parameters (id, etc.)', async () => {
+		
+		const req: api.Request = {
+			recipient: user2.id
+		};
+		
+		const rep = await doJsonRequest<api.Reply>(reqOpts, req);
+		expect(rep.status).withContext('successful session start status').toBe(api.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);
+		
+	});
+
+	itAsync('returns error status when recipient is unknown', async () => {
+		const req: api.Request = { recipient: 'unknown user@bank.com' };
+		const rep = await doJsonRequest<api.Reply>(reqOpts, req);
+		expect(rep.status).withContext('status for unknown recipient').toBe(api.SC.unknownRecipient);
+	});
+
+	itAsync('adequately responds to fuzzing', async () => {
+		
+		// bad JSON's
+		const REQ_SIZE_LIMIT = 1024;
+		const badJSONs: any[] = [ null, undefined, 1, 'string',
+			[1,2], [], { a:1, b:2 }];
+		await expectNonAcceptanceOfBadJsonRequest(reqOpts, REQ_SIZE_LIMIT,
+			badJSONs);
+			
+	});
+
+	
+});
+
+Object.freeze(exports);

package/ts-code/tests/protocols/asmail/delivery/test-utils.ts

@@ -0,0 +1,64 @@
+/*
+ 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/>.
+*/
+
+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 { bytesSync as randomBytes } from '../../../../lib-common/random-node';
+import { Msg, Obj, DeliveryInfo, startMsgDelivery, sendMsgObj } 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 const obj1: Obj = {
+	objId: 'aaaa',
+	header: randomBytes(100),
+	segs: randomBytes(573)
+};
+export const obj2: Obj = {
+	objId: 'bbbb',
+	header: randomBytes(100),
+	segs: randomBytes(20*1024 + 7)
+};
+export const msg: Msg = {
+	cryptoMeta: { pid: 'xxxx' },
+	msgObjs: [ obj1, obj2 ]
+}
+
+export async function startSessionAndSendMsgObjs(deliveryUrl: string,
+		recipient: string, msg: Msg): Promise<DeliveryInfo> {
+	const sessInfo = await startMsgDelivery(deliveryUrl,
+		{ recipient },
+		{ pid: msg.cryptoMeta.pid,
+			objIds: [ msg.msgObjs[0].objId, msg.msgObjs[1].objId ] });
+	await sendMsgObj(deliveryUrl, sessInfo.sessionId, msg.msgObjs[0],
+		sessInfo.maxChunkSize);
+	await sendMsgObj(deliveryUrl, sessInfo.sessionId, msg.msgObjs[1],
+		sessInfo.maxChunkSize);
+	return sessInfo;
+}
+
+Object.freeze(exports);

package/ts-code/tests/protocols/asmail/delivery.ts

@@ -0,0 +1,56 @@
+/*
+ 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/>.
+*/
+
+
+import { afterAllAsync, beforeAllAsync } from '../../libs-for-tests/async-jasmine';
+import { ASMailComponent } from '../../libs-for-tests/server-components/asmail';
+import { User } from '../../libs-for-tests/mailerid';
+import { p } from '../../../lib-common/service-api/asmail/config';
+import { setInboxParams, generateInitPubKey } from '../../libs-for-tests/asmail';
+import { join as joinPaths } from 'path';
+import { addSpecsFrom } from '../../libs-for-tests/spec-assembly';
+
+const SPECS_FOLDER = joinPaths(__dirname, './delivery/specs');
+
+describe('ASMail delivery service', () => {
+	
+	let asmailServer: ASMailComponent;
+	const midServiceDomain = 'localhost';
+	const signupDomains = [ 'company.inc', 'personal.net' ];
+	let user1: User;
+	let user2: User;
+	
+	beforeAllAsync(async () => {
+		asmailServer = new ASMailComponent(signupDomains, midServiceDomain);
+		await asmailServer.start();
+		user1 = await asmailServer.addUser(`Bob Johnson @${signupDomains[0]}`);
+		user2 = await asmailServer.addUser(`William Young @${signupDomains[1]}`);
+		const user2Params = <any> {};
+		user2Params[p.initPubKey.URL_END] = await generateInitPubKey(
+			asmailServer.midUrl, user2
+		);
+		await setInboxParams(asmailServer.asmailUrl, user2, user2Params);
+	});
+	
+	afterAllAsync(async () => {
+		await asmailServer.stop();
+		asmailServer = (undefined as any);
+	});
+	
+	addSpecsFrom(SPECS_FOLDER, () => ({ asmailServer, user1, user2 }));
+	
+});

package/ts-code/tests/protocols/asmail/retrieval/specs/events.ts

@@ -0,0 +1,78 @@
+/*
+ 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/>.
+*/
+
+import { beforeEachAsync, itAsync } from '../../../../libs-for-tests/async-jasmine';
+import { SpecDescribe, TestSetup, User, msg, ASMailComponent, startSession, sendMsg } from '../test-utils';
+import { openSocket } from '../../../../libs-for-tests/ws-utils';
+import { sleep } from '../../../../../lib-common/processes';
+import { makeSubscriber } from '../../../../../lib-common/ipc/ws-ipc';
+import { msgRecievedCompletely, wsEventChannel as api, ERR_SC } from '../../../../../lib-common/service-api/asmail/retrieval';
+import { Observable } from 'rxjs';
+
+export const specs: SpecDescribe = {
+	description: `is an event emitter`
+};
+
+specs.definition = (setup: () => TestSetup) => (() => {
+	
+	let asmailServer: ASMailComponent;
+	let wsUrl: string;
+	let deliveryUrl: string;
+	let user1: User;
+	let sessionId: string;
+
+	beforeEachAsync(async () => {
+		asmailServer = setup().asmailServer;
+		const retrievalUrl = await asmailServer.getRetrievalUrl();
+		wsUrl = `wss${retrievalUrl.substring(5)}${api.URL_END}`;
+		deliveryUrl = await asmailServer.getDeliveryUrl();
+		user1 = setup().user1;
+		sessionId = await startSession(user1, retrievalUrl);
+	});
+	
+	itAsync(`requires session to open web socket`, async () => {
+
+		let rep = await openSocket(wsUrl, 'invalid session id');
+		expect(rep.status).withContext('status for missing authorized session').toBe(ERR_SC.needAuth);
+		
+	});
+	
+	itAsync(`emits event on completion of message reception`, async () => {
+
+		let rep = await openSocket(wsUrl, sessionId);
+		expect(rep.status).toBe(api.SC.ok);
+		
+		const eventSrc = makeSubscriber(rep.data, undefined);
+
+		const eventPromise = (Observable.create(
+			obs => eventSrc.subscribe<msgRecievedCompletely.Event>(
+			msgRecievedCompletely.EVENT_NAME, obs)) as Observable<msgRecievedCompletely.Event>)
+		.take(1)
+		.toPromise();
+		
+		// give some time for subscription to occur
+		await sleep(10);
+		
+		const msgId = await sendMsg(deliveryUrl, user1.id, 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/ts-code/tests/protocols/asmail/retrieval/specs/get-message-meta.ts

@@ -0,0 +1,80 @@
+/*
+ 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/>.
+*/
+
+import { beforeEachAsync, itAsync } from '../../../../libs-for-tests/async-jasmine';
+import { SpecDescribe, TestSetup, User, msg, ASMailComponent, startSession, sendMsg } from '../test-utils';
+import { resolve as resolveUrl } from 'url';
+import { msgMetadata as api } from '../../../../../lib-common/service-api/asmail/retrieval';
+import { RequestOpts, doBodylessRequest } from '../../../../libs-for-tests/xhr-utils';
+import { expectNonAcceptanceOfBadSessionId } from '../../../../shared-checks/requests';
+import { copy } from '../../../../libs-for-tests/json-copy';
+
+export const specs: SpecDescribe = {
+	description: `Request to get message meta`
+};
+
+specs.definition = (setup: () => TestSetup) => (() => {
+	
+	let asmailServer: ASMailComponent;
+	let retrievalUrl: string;
+	let deliveryUrl: string;
+	let user1: User;
+	let reqOpts: RequestOpts
+
+	beforeEachAsync(async () => {
+		asmailServer = setup().asmailServer;
+		retrievalUrl = await asmailServer.getRetrievalUrl();
+		deliveryUrl = await asmailServer.getDeliveryUrl();
+		user1 = setup().user1;
+		const sessionId = await startSession(user1, retrievalUrl);
+		reqOpts = {
+			url: resolveUrl(retrievalUrl, api.genUrlEnd('some-msg')),
+			method: 'GET',
+			responseType: 'json',
+			sessionId
+		};
+	});
+		
+	itAsync('returns message metadata', async () => {
+		const msgId = await sendMsg(deliveryUrl, user1.id, msg);
+		
+		const opts = copy(reqOpts);
+		opts.url = resolveUrl(retrievalUrl, api.genUrlEnd(msgId));
+		
+		const rep = await doBodylessRequest<api.Reply>(opts);
+		expect(rep.status).withContext('status for successfully found message').toBe(api.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!);
+	});
+
+	itAsync(`returns an error when message is unknown`, async () => {
+		const opts = copy(reqOpts);
+		opts.url = resolveUrl(retrievalUrl, api.genUrlEnd(
+			'unknown-message'));
+		const rep = await doBodylessRequest<api.Reply>(opts);
+		expect(rep.status).withContext('status for unknown message').toBe(api.SC.unknownMsg);
+	});
+
+	itAsync(`requires open session`, async () => {
+		const opts = copy(reqOpts);
+		await expectNonAcceptanceOfBadSessionId(opts);
+	});
+
+});