spec-3nweb-server 1.7.8 → 1.7.11

package/README.md

@@ -7,9 +7,9 @@ Thus, we call it a spec server.
 Main purpose of this server is to ensure that 3NWeb protocols are implementable, and to be a testbed for possible new features.
 Secondary purpose of this server is to be packagable into a home-class server, i.e. server that can be run from a single machine.
 
-## Usage
+## Build & Test
 
-To use this repo, you need [Node.js](https://nodejs.org/) with [Typescript](http://www.typescriptlang.org/), installed globally to Node.js (with flag `-g`).
+To use this repo, you need [Node.js](https://nodejs.org/).
 
 When in the project's folder, run
 ```
@@ -32,6 +32,20 @@ Config file is `src/tests/jasmine.ts`.
 
 Please note, that support for running server on windows hasn't been introduced, yet.
 
+## ASMail (Authenticated Secure Mail) protocol overview
+
+```mermaid
+flowchart LR
+	C@{ shape: hex, label: "customer#64;x.y.z" } -- anonymous <br> connection --> VS@{ shape: lin-cyl, label: "ASMail service for a.b.c" }
+	V@{ shape: hex, label: "vendor#64;a.b.c" } -- anonymous <br> connection --> CS@{ shape: lin-cyl, label: "ASMail service for x.y.z" }
+	subgraph cg[" "]
+		CS -- owner <br> connection --> C
+	end
+	subgraph vg[" "]
+		VS -- owner <br> connection --> V
+	end
+```
+
 # License
 
 Code is provided here under GNU General Public License, version 3.

package/build/asmail/asmail-app.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2017, 2020 3NSoft Inc.
+ Copyright (C) 2015 - 2017, 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
@@ -51,11 +51,11 @@ function makeASMailApp(rootFolder, domain, midAuthorizer, errLogger) {
     const mailDeliverySessions = delivery_sessions_1.DeliverySessions.make(5 * 60);
     const recipientsSessions = (0, sessions_1.makeSessionFactory)(10 * 60);
     const userSettingSessions = (0, sessions_1.makeSessionFactory)(10 * 60);
-    const recipients = (0, recipients_1.makeFactory)(rootFolder);
+    const recipients = (0, recipients_1.makeRecipients)(rootFolder);
     setupStaticEntryRoute(app.http);
-    app.http.use(PATHS.delivery, (0, delivery_1.makeApp)(domain, mailDeliverySessions, recipients, midAuthorizer));
-    app.use(PATHS.retrieval, (0, retrieval_1.makeApp)(domain, recipientsSessions, recipients, midAuthorizer));
-    app.http.use(PATHS.config, (0, config_1.makeApp)(domain, userSettingSessions, recipients, midAuthorizer));
+    app.http.use(PATHS.delivery, (0, delivery_1.makeApp)(domain, mailDeliverySessions, recipients.delivery, midAuthorizer));
+    app.use(PATHS.retrieval, (0, retrieval_1.makeApp)(domain, recipientsSessions, recipients.retrieval, midAuthorizer));
+    app.http.use(PATHS.config, (0, config_1.makeApp)(domain, userSettingSessions, recipients.config, midAuthorizer));
     app.http.use((0, error_handler_1.makeErrHandler)(errLogger));
     return app;
 }

package/build/asmail/config.d.ts

@@ -1,5 +1,5 @@
 import * as express from 'express';
 import { SessionsFactory } from './resources/sessions';
-import { Factory as UsersFactory } from './resources/recipients';
+import { ASMailServiceConfig } from './resources/recipients';
 import { MidAuthorizer } from '../lib-server/routes/sessions/mid-auth';
-export declare function makeApp(domain: string, sessions: SessionsFactory, recipients: UsersFactory, midAuthorizer: MidAuthorizer): express.Express;
+export declare function makeApp(domain: string, sessions: SessionsFactory, recipients: ASMailServiceConfig, midAuthorizer: MidAuthorizer): express.Express;

package/build/asmail/delivery.d.ts

@@ -1,5 +1,5 @@
 import * as express from 'express';
 import { SessionsFactory } from './resources/delivery-sessions';
-import { Factory as RecipFactory } from './resources/recipients';
+import { MsgDelivery } from './resources/recipients';
 import { IMidAuthorizer } from './routes/delivery/sender-authorization';
-export declare function makeApp(domain: string, sessions: SessionsFactory, recipients: RecipFactory, midAuthorizer: IMidAuthorizer): express.Express;
+export declare function makeApp(domain: string, sessions: SessionsFactory, recipients: MsgDelivery, midAuthorizer: IMidAuthorizer): express.Express;

package/build/asmail/delivery.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2017 3NSoft Inc.
+ Copyright (C) 2015 - 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

package/build/asmail/resources/inbox.d.ts

@@ -5,6 +5,7 @@ import * as configApi from '../../lib-common/service-api/asmail/config';
 import * as retrievalApi from '../../lib-common/service-api/asmail/retrieval';
 import { UserFiles, ObjReader } from '../../lib-server/resources/user-files';
 export { ObjPipe, ObjReader } from '../../lib-server/resources/user-files';
+type InitPubKey = configApi.p.initPubKey.Certs;
 type AnonSenderPolicy = configApi.p.anonSenderPolicy.Policy;
 export type AuthSenderPolicy = configApi.p.authSenderPolicy.Policy;
 type Whitelist = configApi.p.authSenderWhitelist.List;
@@ -23,7 +24,7 @@ export declare const SC: {
     OBJ_FILE_INCOMPLETE: string;
 };
 export interface InboxParams {
-    "pubkey": deliveryApi.initPubKey.Reply | null;
+    "pubkey": InitPubKey | null;
     "anonymous/policy": AnonSenderPolicy;
     "anonymous/invites": AnonSenderInvites;
     "authenticated/policy": AuthSenderPolicy;
@@ -110,11 +111,11 @@ export declare class Inbox extends UserFiles<InboxParams> {
      * @return a promise, resolvable to true, when certs are set, or
      * resolvable to false, when given certs do not pass sanitization.
      */
-    setPubKey(initKeyCerts: deliveryApi.initPubKey.Reply | null): Promise<boolean>;
+    setPubKey(initKeyCerts: InitPubKey | null): Promise<boolean>;
     setAnonSenderPolicy(policy: AnonSenderPolicy): Promise<boolean>;
     setAnonSenderInvites(invites: AnonSenderInvites): Promise<boolean>;
     setAuthSenderPolicy(policy: AuthSenderPolicy): Promise<boolean>;
-    setAuthSenderBlacklist(list: Blacklist): Promise<boolean>;
-    setAuthSenderWhitelist(list: Whitelist): Promise<boolean>;
+    setAuthSenderBlacklist(lst: Blacklist): Promise<boolean>;
+    setAuthSenderWhitelist(lst: Whitelist): Promise<boolean>;
     setAuthSenderInvites(invites: AuthSenderInvites): Promise<boolean>;
 }

package/build/asmail/resources/inbox.js

@@ -334,100 +334,110 @@ class Inbox extends user_files_1.UserFiles {
      * resolvable to false, when given certs do not pass sanitization.
      */
     async setPubKey(initKeyCerts) {
-        let isOK;
-        if (initKeyCerts === null) {
-            isOK = true;
+        if ((initKeyCerts === null) || isValidIntroPKeyCerts(initKeyCerts)) {
+            await this.setParam('pubkey', initKeyCerts);
+            return true;
         }
         else {
-            isOK = ((typeof initKeyCerts === 'object') &&
-                (0, jwkeys_1.isLikeSignedKeyCert)(initKeyCerts.pkeyCert) &&
-                (0, jwkeys_1.isLikeSignedKeyCert)(initKeyCerts.userCert) &&
-                (0, jwkeys_1.isLikeSignedKeyCert)(initKeyCerts.provCert));
-        }
-        if (isOK) {
-            await this.setParam('pubkey', initKeyCerts);
+            return false;
         }
-        return isOK;
     }
     async setAnonSenderPolicy(policy) {
-        const isOK = (('object' === typeof policy) && !!policy &&
-            ('boolean' === typeof policy.accept) &&
-            ('boolean' === typeof policy.acceptWithInvitesOnly) &&
-            ('number' === typeof policy.defaultMsgSize) &&
-            (policy.defaultMsgSize > 500));
-        if (isOK) {
+        if (isValidAnonSenderPolicy(policy)) {
             await this.setParam('anonymous/policy', policy);
+            return true;
+        }
+        else {
+            return false;
         }
-        return isOK;
     }
     async setAnonSenderInvites(invites) {
-        const isOK = ('object' === typeof invites) && !!invites;
-        if (!isOK) {
-            return false;
+        if (isValidListWithMsgMaxSizes(invites)) {
+            await this.setParam('anonymous/invites', invites);
+            return true;
         }
-        for (var invite in invites) {
-            const msgMaxSize = invites[invite];
-            const isOK = ('number' === typeof msgMaxSize) && (msgMaxSize > 500);
-            if (!isOK) {
-                return false;
-            }
+        else {
+            return false;
         }
-        await this.setParam('anonymous/invites', invites);
-        return true;
     }
     async setAuthSenderPolicy(policy) {
-        const isOK = (('object' === typeof policy) && !!policy &&
-            ('boolean' === typeof policy.applyBlackList) &&
-            ('boolean' === typeof policy.acceptFromWhiteListOnly) &&
-            ('boolean' === typeof policy.acceptWithInvitesOnly) &&
-            ('number' === typeof policy.defaultMsgSize) &&
-            (policy.defaultMsgSize > 500));
-        if (!isOK) {
+        if (isValidAuthSenderPolicy(policy)) {
             await this.setParam('authenticated/policy', policy);
+            return true;
         }
-        return isOK;
-    }
-    async setAuthSenderBlacklist(list) {
-        const isOK = ('object' === typeof list) && !!list;
-        if (isOK) {
-            await this.setParam('authenticated/blacklist', list);
+        else {
+            return false;
         }
-        return isOK;
     }
-    async setAuthSenderWhitelist(list) {
-        const isOK = ('object' === typeof list) && !!list;
-        if (!isOK) {
+    async setAuthSenderBlacklist(lst) {
+        if (isValidBlacklist(lst)) {
+            await this.setParam('authenticated/blacklist', lst);
+            return true;
+        }
+        else {
             return false;
         }
-        for (var addr in list) {
-            const msgMaxSize = list[addr];
-            const isOK = ('number' === typeof msgMaxSize) && (msgMaxSize > 500);
-            if (!isOK) {
-                return false;
-            }
+    }
+    async setAuthSenderWhitelist(lst) {
+        if (isValidListWithMsgMaxSizes(lst)) {
+            await this.setParam('authenticated/whitelist', lst);
+            return true;
+        }
+        else {
+            return false;
         }
-        await this.setParam('authenticated/whitelist', list);
-        return true;
     }
     async setAuthSenderInvites(invites) {
-        const isOK = ('object' === typeof invites) && !!invites;
-        if (!isOK) {
-            return false;
+        if (isValidListWithMsgMaxSizes(invites)) {
+            await this.setParam('authenticated/invites', invites);
+            return true;
         }
-        for (var invite in invites) {
-            const msgMaxSize = invites[invite];
-            const isOK = ('number' === typeof msgMaxSize) && (msgMaxSize > 500);
-            if (!isOK) {
-                return false;
-            }
+        else {
+            return false;
         }
-        await this.setParam('authenticated/invites', invites);
-        return true;
     }
 }
 exports.Inbox = Inbox;
 Object.freeze(Inbox.prototype);
 Object.freeze(Inbox);
+function isValidIntroPKeyCerts(pkeyCerts) {
+    return ((typeof pkeyCerts === 'object') && !!pkeyCerts &&
+        (0, jwkeys_1.isLikeSignedKeyCert)(pkeyCerts.pkeyCert) &&
+        (0, jwkeys_1.isLikeSignedKeyCert)(pkeyCerts.userCert) &&
+        (0, jwkeys_1.isLikeSignedKeyCert)(pkeyCerts.provCert));
+}
+function isValidAnonSenderPolicy(policy) {
+    return (('object' === typeof policy) && !!policy &&
+        ('boolean' === typeof policy.accept) &&
+        ('boolean' === typeof policy.acceptWithInvitesOnly) &&
+        ('number' === typeof policy.defaultMsgSize) &&
+        (policy.defaultMsgSize > 500));
+}
+function isValidAuthSenderPolicy(policy) {
+    return (('object' === typeof policy) && !!policy &&
+        ('boolean' === typeof policy.applyBlackList) &&
+        ('boolean' === typeof policy.acceptFromWhiteListOnly) &&
+        ('boolean' === typeof policy.acceptWithInvitesOnly) &&
+        ('number' === typeof policy.defaultMsgSize) &&
+        (policy.defaultMsgSize > 500));
+}
+function isValidListWithMsgMaxSizes(lst) {
+    const isOK = ('object' === typeof lst) && !!lst;
+    if (!isOK) {
+        return false;
+    }
+    for (const inviteOrAddr in lst) {
+        const msgMaxSize = lst[inviteOrAddr];
+        const isOK = ('number' === typeof msgMaxSize) && (msgMaxSize > 500);
+        if (!isOK) {
+            return false;
+        }
+    }
+    return true;
+}
+function isValidBlacklist(lst) {
+    return ('object' === typeof lst) && !!lst;
+}
 class ObjFiles {
     constructor(cachePeriodMillis, deliveryFolder, readyMsgsFolder) {
         this.deliveryFolder = deliveryFolder;

package/build/asmail/resources/recipients.d.ts

@@ -5,110 +5,97 @@ import * as deliveryApi from '../../lib-common/service-api/asmail/delivery';
 import * as retrievalApi from '../../lib-common/service-api/asmail/retrieval';
 export { SC } from './inbox';
 export declare const BIN_TYPE = "application/octet-stream";
-/**
- * This checks existence of a given user, returning a promise, resolvable
- * either to true, when given user id is known, or to false, when it is not.
- */
-export type UserExists = (userId: string) => Promise<boolean>;
-/**
- * This tells what is an allowable maximum message size for a given recipient,
- * for a given sender and/or under a given invitation token.
- * Function returns a promise, resolvable to
- * (1) zero (0), if leaving mail is forbidden,
- * (2) greater than zero maximum message length, and
- * (3) -1 (less than zero), if mail cannot be accepted due to full mail
- *     box.
- */
-export type AllowedMaxMsgSize = (recipient: string, sender: string | undefined, invitation: string | undefined) => Promise<number>;
-/**
- * This allocates storage for a message returning a promise, resolvable to
- * (1) message id, when a folder for new message has been created,
- * (2) undefined, if recipient is unknown.
- */
-export type SetMsgStorage = (recipient: string, msgMeta: deliveryApi.msgMeta.Request, authSender: string | undefined, invite: string | undefined, maxMsgLength: number) => Promise<string>;
-/**
- * This saves object's bytes, returning a promise, resolvable when saving
- * is OK, otherwise, promise rejects with string error code from SC.
- */
-export type SaveObj = (recipient: string, msgId: string, objId: string, fstReq: deliveryApi.PutObjFirstQueryOpts | undefined, sndReq: deliveryApi.PutObjSecondQueryOpts | undefined, bytesLen: number, bytes: Readable) => Promise<void>;
-/**
- * This finalizes delivery of a message, returning a promise.
- * Rejected promise may have a string error code from SC.
- */
-export type FinalizeDelivery = (recipient: string, msgId: string) => Promise<void>;
-/**
- * This returns a promise, resolvable to array with ids of available messages.
- * Rejected promise may have a string error code from SC.
- */
-export type GetMsgIds = (userId: string) => Promise<retrievalApi.listMsgs.Reply>;
-/**
- * This returns a promise, resolvable to message meta.
- * Rejected promise may have a string error code from SC.
- */
-export type GetMsgMeta = (userId: string, msgId: string) => Promise<retrievalApi.MsgMeta>;
-/**
- * This deletes a message returning a promise, resolvable when message is
- * removed.
- * Rejected promise may have a string error code from SC.
- */
-export type DeleteMsg = (userId: string, msgId: string) => Promise<void>;
-/**
- * This returns parameter of a message that is still in delivery, identified
- * by given recipient and message id. If message is unknown, or if it has
- * already been delivered, error code is thrown.
- * Rejected promise may have a string error code from SC.
- */
-export type IncompleteMsgDeliveryParams = (recipient: string, msgId: string) => Promise<{
-    maxMsgLength: number;
-    currentMsgLength: number;
-}>;
-/**
- * This returns a promise, resolvable to readable stream of object bytes.
- * Rejected promise may be passing string error code from SC.
- */
-export type GetObj = (userId: string, msgId: string, objId: string, header: boolean, segsOffset: number, segsLimit: number | undefined) => Promise<ObjReader>;
-type GetParam<P extends keyof InboxParams> = (userId: string) => Promise<InboxParams[P]>;
-type SetParam<P extends keyof InboxParams> = (userId: string, param: InboxParams[P]) => Promise<boolean>;
-export type GetPubKey = GetParam<'pubkey'>;
-export type SetPubKey = SetParam<'pubkey'>;
-export type GetAnonSenderPolicy = GetParam<'anonymous/policy'>;
-export type SetAnonSenderPolicy = SetParam<'anonymous/policy'>;
-export type GetAnonSenderInvites = GetParam<'anonymous/invites'>;
-export type SetAnonSenderInvites = SetParam<'anonymous/invites'>;
-export type GetAuthSenderPolicy = GetParam<'authenticated/policy'>;
-export type SetAuthSenderPolicy = SetParam<'authenticated/policy'>;
-export type GetAuthSenderInvites = GetParam<'authenticated/invites'>;
-export type SetAuthSenderInvites = SetParam<'authenticated/invites'>;
-export type GetAuthSenderBlacklist = GetParam<'authenticated/blacklist'>;
-export type SetAuthSenderBlacklist = SetParam<'authenticated/blacklist'>;
-export type GetAuthSenderWhitelist = GetParam<'authenticated/whitelist'>;
-export type SetAuthSenderWhitelist = SetParam<'authenticated/whitelist'>;
+export type GetParam<P extends keyof InboxParams> = (userId: string) => Promise<InboxParams[P]>;
+export type SetParam<P extends keyof InboxParams> = (userId: string, param: InboxParams[P]) => Promise<boolean>;
 export type EventsSink = MailEventsSink;
-export interface Factory {
-    exists: UserExists;
-    allowedMaxMsgSize: AllowedMaxMsgSize;
-    setMsgStorage: SetMsgStorage;
-    saveObj: SaveObj;
-    finalizeDelivery: FinalizeDelivery;
-    getMsgIds: GetMsgIds;
-    getMsgMeta: GetMsgMeta;
-    deleteMsg: DeleteMsg;
-    getObj: GetObj;
-    incompleteMsgDeliveryParams: IncompleteMsgDeliveryParams;
+export interface Recipients {
+    config: ASMailServiceConfig;
+    delivery: MsgDelivery;
+    retrieval: MsgRetrieval;
+}
+export interface ASMailServiceConfig {
+    /**
+     * This checks existence of a given user, returning a promise, resolvable
+     * either to true, when given user id is known, or to false, when it is not.
+     */
+    exists: (userId: string) => Promise<boolean>;
+    getPubKey: GetParam<'pubkey'>;
+    setPubKey: SetParam<'pubkey'>;
+    getAnonSenderPolicy: GetParam<'anonymous/policy'>;
+    setAnonSenderPolicy: SetParam<'anonymous/policy'>;
+    getAnonSenderInvites: GetParam<'anonymous/invites'>;
+    setAnonSenderInvites: SetParam<'anonymous/invites'>;
+    getAuthSenderPolicy: GetParam<'authenticated/policy'>;
+    setAuthSenderPolicy: SetParam<'authenticated/policy'>;
+    getAuthSenderInvites: GetParam<'authenticated/invites'>;
+    setAuthSenderInvites: SetParam<'authenticated/invites'>;
+    getAuthSenderBlacklist: GetParam<'authenticated/blacklist'>;
+    setAuthSenderBlacklist: SetParam<'authenticated/blacklist'>;
+    getAuthSenderWhitelist: GetParam<'authenticated/whitelist'>;
+    setAuthSenderWhitelist: SetParam<'authenticated/whitelist'>;
+}
+export interface MsgDelivery {
+    getPubKey: ASMailServiceConfig['getPubKey'];
+    /**
+     * This tells what is an allowable maximum message size for a given
+     * recipient, for a given sender and/or under a given invitation token.
+     * Function returns a promise, resolvable to
+     * (1) zero (0), if leaving mail is forbidden,
+     * (2) greater than zero maximum message length, and
+     * (3) -1 (less than zero), if mail cannot be accepted due to full mail
+     *     box.
+     */
+    allowedMaxMsgSize: (recipient: string, sender: string | undefined, invitation: string | undefined) => Promise<number>;
+    /**
+     * This allocates storage for a message returning a promise, resolvable to
+     * (1) message id, when a folder for new message has been created,
+     * (2) undefined, if recipient is unknown.
+     */
+    setMsgStorage: (recipient: string, msgMeta: deliveryApi.msgMeta.Request, authSender: string | undefined, invite: string | undefined, maxMsgLength: number) => Promise<string>;
+    /**
+     * This saves object's bytes, returning a promise, resolvable when saving
+     * is OK, otherwise, promise rejects with string error code from SC.
+     */
+    saveObj: (recipient: string, msgId: string, objId: string, fstReq: deliveryApi.PutObjFirstQueryOpts | undefined, sndReq: deliveryApi.PutObjSecondQueryOpts | undefined, bytesLen: number, bytes: Readable) => Promise<void>;
+    /**
+     * This returns parameter of a message that is still in delivery, identified
+     * by given recipient and message id. If message is unknown, or if it has
+     * already been delivered, error code is thrown.
+     * Rejected promise may have a string error code from SC.
+     */
+    incompleteMsgDeliveryParams: (recipient: string, msgId: string) => Promise<{
+        maxMsgLength: number;
+        currentMsgLength: number;
+    }>;
+    /**
+     * This finalizes delivery of a message, returning a promise.
+     * Rejected promise may have a string error code from SC.
+     */
+    finalizeDelivery: (recipient: string, msgId: string) => Promise<void>;
+}
+export interface MsgRetrieval {
+    exists: ASMailServiceConfig['exists'];
+    /**
+     * This returns a promise, resolvable to array with ids of available
+     * messages. Rejected promise may have a string error code from SC.
+     */
+    getMsgIds: (userId: string) => Promise<retrievalApi.listMsgs.Reply>;
+    /**
+     * This returns a promise, resolvable to message meta.
+     * Rejected promise may have a string error code from SC.
+     */
+    getMsgMeta: (userId: string, msgId: string) => Promise<retrievalApi.MsgMeta>;
+    /**
+     * This deletes a message returning a promise, resolvable when message is
+     * removed.
+     * Rejected promise may have a string error code from SC.
+     */
+    deleteMsg: (userId: string, msgId: string) => Promise<void>;
+    /**
+     * This returns a promise, resolvable to readable stream of object bytes.
+     * Rejected promise may be passing string error code from SC.
+     */
+    getObj: (userId: string, msgId: string, objId: string, header: boolean, segsOffset: number, segsLimit: number | undefined) => Promise<ObjReader>;
     setMailEventsSink(sink: EventsSink): void;
-    getPubKey: GetPubKey;
-    setPubKey: SetPubKey;
-    getAnonSenderPolicy: GetAnonSenderPolicy;
-    setAnonSenderPolicy: SetAnonSenderPolicy;
-    getAnonSenderInvites: GetAnonSenderInvites;
-    setAnonSenderInvites: SetAnonSenderInvites;
-    getAuthSenderPolicy: GetAuthSenderPolicy;
-    setAuthSenderPolicy: SetAuthSenderPolicy;
-    getAuthSenderInvites: GetAuthSenderInvites;
-    setAuthSenderInvites: SetAuthSenderInvites;
-    getAuthSenderBlacklist: GetAuthSenderBlacklist;
-    setAuthSenderBlacklist: SetAuthSenderBlacklist;
-    getAuthSenderWhitelist: GetAuthSenderWhitelist;
-    setAuthSenderWhitelist: SetAuthSenderWhitelist;
 }
-export declare function makeFactory(rootFolder: string, writeBufferSize?: string | number, readBufferSize?: string | number): Factory;
+export declare function makeRecipients(rootFolder: string, writeBufferSize?: string | number, readBufferSize?: string | number): Recipients;

package/build/asmail/resources/recipients.js

@@ -16,7 +16,7 @@
  this program. If not, see <http://www.gnu.org/licenses/>.
 */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.makeFactory = exports.BIN_TYPE = exports.SC = void 0;
+exports.makeRecipients = exports.BIN_TYPE = exports.SC = void 0;
 const inbox_1 = require("./inbox");
 const server_data_folders_1 = require("../../lib-server/resources/server-data-folders");
 var inbox_2 = require("./inbox");
@@ -86,22 +86,26 @@ async function adaptToFreeSpaceLeft(inbox, msgSize) {
  */
 async function allowedMsgSizeForAnonSender(inbox, invitation) {
     const policy = await inbox.getParam('anonymous/policy');
-    if (!policy.accept) {
-        return 0;
-    }
-    if (!invitation) {
+    if (policy.accept) {
+        // XXX this misses case when invite allows for bigger messages,
+        //     while without invite messages are also allowed.
         if (policy.acceptWithInvitesOnly) {
-            return 0;
+            if (invitation) {
+                const invites = await inbox.getParam('anonymous/invites');
+                const sizeForInvite = invites[invitation];
+                return ((typeof sizeForInvite === 'number') ?
+                    adaptToFreeSpaceLeft(inbox, sizeForInvite) : 0);
+            }
+            else {
+                return 0;
+            }
+        }
+        else {
+            return await adaptToFreeSpaceLeft(inbox, policy.defaultMsgSize);
         }
-        return await adaptToFreeSpaceLeft(inbox, policy.defaultMsgSize);
     }
     else {
-        const invites = await inbox.getParam('anonymous/invites');
-        const sizeForInvite = invites[invitation];
-        if (typeof sizeForInvite !== 'number') {
-            return 0;
-        }
-        return adaptToFreeSpaceLeft(inbox, sizeForInvite);
+        return 0;
     }
 }
 /**
@@ -144,7 +148,7 @@ async function allowedMsgSizeForAuthSender(inbox, sender, invitation) {
     }
     return adaptToFreeSpaceLeft(inbox, policy.defaultMsgSize);
 }
-function makeFactory(rootFolder, writeBufferSize, readBufferSize) {
+function makeRecipients(rootFolder, writeBufferSize, readBufferSize) {
     const boxes = new Map();
     let mailEventsSink = undefined;
     async function getInbox(userId) {
@@ -169,7 +173,7 @@ function makeFactory(rootFolder, writeBufferSize, readBufferSize) {
             return inbox;
         }
     }
-    const recipients = {
+    const config = {
         exists: async (userId) => {
             try {
                 await getInbox(userId);
@@ -237,7 +241,11 @@ function makeFactory(rootFolder, writeBufferSize, readBufferSize) {
         setAuthSenderWhitelist: async (userId, list) => {
             const inbox = await getInbox(userId);
             return inbox.setAuthSenderWhitelist(list);
-        },
+        }
+    };
+    Object.freeze(config);
+    const delivery = {
+        getPubKey: config.getPubKey,
         allowedMaxMsgSize: async (recipient, sender, invitation) => {
             const inbox = await getInbox(recipient);
             // XXX move these two functions into inbox
@@ -268,6 +276,14 @@ function makeFactory(rootFolder, writeBufferSize, readBufferSize) {
             const inbox = await getInbox(recipient);
             return inbox.completeMsgDelivery(msgId);
         },
+        incompleteMsgDeliveryParams: async (recipient, msgId) => {
+            const inbox = await getInbox(recipient);
+            return inbox.getIncompleteMsgParams(msgId);
+        }
+    };
+    Object.freeze(delivery);
+    const retrieval = {
+        exists: config.exists,
         getMsgIds: async (userId) => {
             const inbox = await getInbox(userId);
             return inbox.getMsgIds();
@@ -280,10 +296,6 @@ function makeFactory(rootFolder, writeBufferSize, readBufferSize) {
             const inbox = await getInbox(userId);
             return inbox.rmMsg(msgId);
         },
-        incompleteMsgDeliveryParams: async (recipient, msgId) => {
-            const inbox = await getInbox(recipient);
-            return inbox.getIncompleteMsgParams(msgId);
-        },
         getObj: async (userId, msgId, objId, header, segsOffset, segsLimit) => {
             const inbox = await getInbox(userId);
             return inbox.getObj(msgId, objId, header, segsOffset, segsLimit);
@@ -295,8 +307,12 @@ function makeFactory(rootFolder, writeBufferSize, readBufferSize) {
             mailEventsSink = sink;
         }
     };
+    Object.freeze(retrieval);
+    const recipients = {
+        config, delivery, retrieval
+    };
     Object.freeze(recipients);
     return recipients;
 }
-exports.makeFactory = makeFactory;
+exports.makeRecipients = makeRecipients;
 Object.freeze(exports);

package/build/asmail/retrieval.d.ts

@@ -1,5 +1,5 @@
 import { AppWithWSs } from '../lib-server/web-sockets/app';
 import { SessionsFactory } from './resources/sessions';
-import { Factory as RecipFactory } from './resources/recipients';
+import { MsgRetrieval } from './resources/recipients';
 import { MidAuthorizer } from '../lib-server/routes/sessions/mid-auth';
-export declare function makeApp(domain: string, sessions: SessionsFactory, recipients: RecipFactory, midAuthorizer: MidAuthorizer): AppWithWSs;
+export declare function makeApp(domain: string, sessions: SessionsFactory, recipients: MsgRetrieval, midAuthorizer: MidAuthorizer): AppWithWSs;

package/build/asmail/retrieval.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2016 3NSoft Inc.
+ Copyright (C) 2015 - 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

package/build/asmail/routes/config/param-getter.d.ts

@@ -1,2 +1,4 @@
 import { RequestHandler } from 'express';
-export declare function getParam<T>(paramGetter: (userId: string) => Promise<T>): RequestHandler;
+import { GetParam } from '../../resources/recipients';
+import { InboxParams } from '../../resources/inbox';
+export declare function getParam<P extends keyof InboxParams>(paramGetter: GetParam<P>): RequestHandler;

package/build/asmail/routes/config/param-getter.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2016 3NSoft Inc.
+ Copyright (C) 2015 - 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
@@ -20,9 +20,6 @@ exports.getParam = void 0;
 const recipients_1 = require("../../resources/recipients");
 const config_1 = require("../../../lib-common/service-api/asmail/config");
 function getParam(paramGetter) {
-    if ('function' !== typeof paramGetter) {
-        throw new TypeError("Given argument 'paramGetter' must be function, but is not.");
-    }
     return async (req, res, next) => {
         const session = req.session;
         const userId = session.params.userId;

package/build/asmail/routes/config/param-setter.d.ts

@@ -1,2 +1,4 @@
 import { RequestHandler } from 'express';
-export declare function setParam<T>(paramSetter: (userId: string, param: T) => Promise<boolean>): RequestHandler;
+import { SetParam } from '../../resources/recipients';
+import { InboxParams } from '../../resources/inbox';
+export declare function setParam<P extends keyof InboxParams>(paramSetter: SetParam<P>): RequestHandler;

package/build/asmail/routes/config/param-setter.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2016 3NSoft Inc.
+ Copyright (C) 2015 - 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
@@ -20,9 +20,6 @@ exports.setParam = void 0;
 const recipients_1 = require("../../resources/recipients");
 const config_1 = require("../../../lib-common/service-api/asmail/config");
 function setParam(paramSetter) {
-    if ('function' !== typeof paramSetter) {
-        throw new TypeError("Given argument 'paramSetter' must be function, but is not.");
-    }
     return async (req, res, next) => {
         const session = req.session;
         const userId = session.params.userId;
@@ -48,4 +45,3 @@ function setParam(paramSetter) {
     };
 }
 exports.setParam = setParam;
-;

package/build/asmail/routes/delivery/finalize-delivery.d.ts

@@ -1,3 +1,3 @@
 import { RequestHandler } from 'express';
-import { FinalizeDelivery } from '../../resources/recipients';
-export declare function finalizeDelivery(finDelivFunc: FinalizeDelivery): RequestHandler;
+import { MsgDelivery } from '../../resources/recipients';
+export declare function finalizeDelivery(finDelivFunc: MsgDelivery['finalizeDelivery']): RequestHandler;

package/build/asmail/routes/delivery/finalize-delivery.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2016 3NSoft Inc.
+ Copyright (C) 2015 - 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
@@ -20,9 +20,6 @@ exports.finalizeDelivery = void 0;
 const recipients_1 = require("../../resources/recipients");
 const delivery_1 = require("../../../lib-common/service-api/asmail/delivery");
 function finalizeDelivery(finDelivFunc) {
-    if ('function' !== typeof finDelivFunc) {
-        throw new TypeError("Given argument 'finDelivFunc' must be function, but is not.");
-    }
     return async (req, res, next) => {
         const session = req.session;
         const recipient = session.params.recipient;

package/build/asmail/routes/delivery/pre-flight.d.ts

@@ -1,5 +1,5 @@
 import { RequestHandler } from 'express';
-import { AllowedMaxMsgSize } from '../../resources/recipients';
+import { MsgDelivery } from '../../resources/recipients';
 import { Redirect } from './start-session';
 /**
  * This creates a pre-flight route handler.
@@ -13,4 +13,4 @@ import { Redirect } from './start-session';
  * (1) string with URI for ASMail service, which is serving given recipient,
  * (2) undefined, if it is this server should service given recipient.
  */
-export declare function preFlight(allowedMsgSizeFunc: AllowedMaxMsgSize, redirectFunc?: Redirect): RequestHandler;
+export declare function preFlight(allowedMsgSizeFunc: MsgDelivery['allowedMaxMsgSize'], redirectFunc?: Redirect): RequestHandler;

package/build/asmail/routes/delivery/pre-flight.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2017 3NSoft Inc.
+ Copyright (C) 2015 - 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
@@ -33,12 +33,6 @@ const canonical_address_1 = require("../../../lib-common/canonical-address");
  * (2) undefined, if it is this server should service given recipient.
  */
 function preFlight(allowedMsgSizeFunc, redirectFunc) {
-    if (typeof allowedMsgSizeFunc !== 'function') {
-        throw new TypeError(`Given argument 'allowedMsgSizeFunc' must be function, but is not.`);
-    }
-    if ((redirectFunc !== undefined) && (typeof redirectFunc !== 'function')) {
-        throw new TypeError(`Given argument 'redirectFunc' must either be function, or be undefined, but it is neither.`);
-    }
     async function serveRequestHere(recipient, sender, invitation, res) {
         const msgSize = await allowedMsgSizeFunc(recipient, sender, invitation);
         if (msgSize > 0) {

package/build/asmail/routes/delivery/provide-recipient-pubkey.d.ts

@@ -1,8 +1,8 @@
 import { RequestHandler } from 'express';
-import { GetPubKey } from '../../resources/recipients';
+import { MsgDelivery } from '../../resources/recipients';
 /**
  * This creates a get-init-pub-key route handler.
  * @param pkeyProvidingFunc is a function that provides recipient's public key
  * for use in this communication.
  */
-export declare function getRecipientPubKey(pkeyProvidingFunc: GetPubKey): RequestHandler;
+export declare function getRecipientPubKey(pkeyProvidingFunc: MsgDelivery['getPubKey']): RequestHandler;

package/build/asmail/routes/delivery/provide-recipient-pubkey.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2016 3NSoft Inc.
+ Copyright (C) 2015 - 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
@@ -25,9 +25,6 @@ const delivery_1 = require("../../../lib-common/service-api/asmail/delivery");
  * for use in this communication.
  */
 function getRecipientPubKey(pkeyProvidingFunc) {
-    if ('function' !== typeof pkeyProvidingFunc) {
-        throw new TypeError("Given argument 'pkeyProvidingFunc' must be function, but is not.");
-    }
     return async (req, res, next) => {
         const session = req.session;
         try {

package/build/asmail/routes/delivery/put-metadata.d.ts

@@ -1,3 +1,3 @@
 import { RequestHandler } from 'express';
-import { SetMsgStorage } from '../../resources/recipients';
-export declare function saveMetadata(setMsgStorageFunc: SetMsgStorage, maxChunk: string | number): RequestHandler;
+import { MsgDelivery } from '../../resources/recipients';
+export declare function saveMetadata(setMsgStorageFunc: MsgDelivery['setMsgStorage'], maxChunk: string | number): RequestHandler;

package/build/asmail/routes/delivery/put-metadata.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2016 3NSoft Inc.
+ Copyright (C) 2015 - 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
@@ -44,10 +44,6 @@ function findProblemWithObjIds(ids) {
     return;
 }
 function saveMetadata(setMsgStorageFunc, maxChunk) {
-    if ('function' !== typeof setMsgStorageFunc) {
-        throw new TypeError("Given argument 'setMsgStorageFunc' must " +
-            "be function, but is not.");
-    }
     const maxChunkSize = confUtil.stringToNumOfBytes(maxChunk);
     return async (req, res, next) => {
         const session = req.session;

package/build/asmail/routes/delivery/put-obj.d.ts

@@ -1,3 +1,3 @@
 import { RequestHandler } from 'express';
-import { SaveObj } from '../../resources/recipients';
-export declare function saveMsgObj(saveObjFunc: SaveObj, chunkLimit: string | number): RequestHandler;
+import { MsgDelivery } from '../../resources/recipients';
+export declare function saveMsgObj(saveObjFunc: MsgDelivery['saveObj'], chunkLimit: string | number): RequestHandler;

package/build/asmail/routes/delivery/put-obj.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2017, 2019 - 2020 3NSoft Inc.
+ Copyright (C) 2015 - 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
@@ -22,9 +22,6 @@ const delivery_1 = require("../../../lib-common/service-api/asmail/delivery");
 const confUtil = require("../../../lib-server/conf-util");
 const body_parsers_1 = require("../../../lib-server/middleware/body-parsers");
 function saveMsgObj(saveObjFunc, chunkLimit) {
-    if ('function' !== typeof saveObjFunc) {
-        throw new TypeError("Given argument 'saveObjFunc' must be function, but is not.");
-    }
     const maxChunkSize = confUtil.stringToNumOfBytes(chunkLimit);
     return async (req, res, next) => {
         if (!req.is(recipients_1.BIN_TYPE)) {

package/build/asmail/routes/delivery/restart-session.d.ts

@@ -1,5 +1,5 @@
 import { RequestHandler } from 'express';
-import { IncompleteMsgDeliveryParams } from '../../resources/recipients';
+import { MsgDelivery } from '../../resources/recipients';
 import { GenerateSession, GetSessionForMsg } from '../../resources/delivery-sessions';
 import { Redirect } from './start-session';
 /**
@@ -15,4 +15,4 @@ import { Redirect } from './start-session';
  * (1) string with URI for ASMail service, which is serving given recipient,
  * (2) undefined, if it is this server should service given recipient.
  */
-export declare function restartSession(sessionGenFunc: GenerateSession, sessionForMsgFunc: GetSessionForMsg, incompleteMsgFunc: IncompleteMsgDeliveryParams, maxChunk: string | number, redirectFunc?: Redirect): RequestHandler;
+export declare function restartSession(sessionGenFunc: GenerateSession, sessionForMsgFunc: GetSessionForMsg, incompleteMsgFunc: MsgDelivery['incompleteMsgDeliveryParams'], maxChunk: string | number, redirectFunc?: Redirect): RequestHandler;

package/build/asmail/routes/delivery/restart-session.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2017 3NSoft Inc.
+ 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
@@ -35,18 +35,6 @@ const confUtil = require("../../../lib-server/conf-util");
  * (2) undefined, if it is this server should service given recipient.
  */
 function restartSession(sessionGenFunc, sessionForMsgFunc, incompleteMsgFunc, maxChunk, redirectFunc) {
-    if (typeof sessionGenFunc !== 'function') {
-        throw new TypeError(`Given argument 'sessionGenFunc' must be function, but is not.`);
-    }
-    if (typeof sessionForMsgFunc !== 'function') {
-        throw new TypeError(`Given argument 'sessionForMsgFunc' must be function, but is not.`);
-    }
-    if (typeof incompleteMsgFunc !== 'function') {
-        throw new TypeError(`Given argument 'incompleteMsgFunc' must be function, but is not.`);
-    }
-    if ((redirectFunc !== undefined) && (typeof redirectFunc !== 'function')) {
-        throw new TypeError(`Given argument 'redirectFunc' must either be function, or be undefined, but it is neither.`);
-    }
     const maxChunkSize = confUtil.stringToNumOfBytes(maxChunk);
     async function serveRequestHere(recipient, msgId, res) {
         let session = await sessionForMsgFunc(recipient, msgId);

package/build/asmail/routes/delivery/sender-authorization.js

@@ -26,9 +26,6 @@ const delivery_1 = require("../../../lib-common/service-api/asmail/delivery");
  * and false for failed authorization.
  */
 function authorize(relyingPartyDomain, midAuthorizingFunc) {
-    if ('function' !== typeof midAuthorizingFunc) {
-        throw new TypeError("Given argument 'midAuthorizingFunc' must be function, but is not.");
-    }
     return async (req, res, next) => {
         if (req.session.isAuthorized) {
             res.status(delivery_1.ERR_SC.duplicateReq).send("This protocol request has already been served.");

package/build/asmail/routes/delivery/start-session.d.ts

@@ -1,10 +1,11 @@
 import { RequestHandler } from 'express';
 import { GenerateSession } from '../../resources/delivery-sessions';
-import { AllowedMaxMsgSize } from '../../resources/recipients';
+import { MsgDelivery } from '../../resources/recipients';
 export type Redirect = (userId: string) => Promise<string>;
 /**
  * This creates a start-session route handler.
- * @param allowedMsgSizeFunc is a function returning promises, that may resolve to
+ * @param allowedMsgSizeFunc is a function returning promises, that
+ * may resolve to
  * (1) undefined, if recipient is unknown,
  * (2) zero (0), if leaving mail is forbidden,
  * (3) greater than zero maximum message length, and
@@ -16,4 +17,4 @@ export type Redirect = (userId: string) => Promise<string>;
  * (1) string with URI for ASMail service, which is serving given recipient,
  * (2) undefined, if it is this server should service given recipient.
  */
-export declare function startSession(allowedMsgSizeFunc: AllowedMaxMsgSize, sessionGenFunc: GenerateSession, redirectFunc?: Redirect): RequestHandler;
+export declare function startSession(allowedMsgSizeFunc: MsgDelivery['allowedMaxMsgSize'], sessionGenFunc: GenerateSession, redirectFunc?: Redirect): RequestHandler;

package/build/asmail/routes/delivery/start-session.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2016 3NSoft Inc.
+ Copyright (C) 2015 - 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
@@ -22,7 +22,8 @@ const delivery_1 = require("../../../lib-common/service-api/asmail/delivery");
 const canonical_address_1 = require("../../../lib-common/canonical-address");
 /**
  * This creates a start-session route handler.
- * @param allowedMsgSizeFunc is a function returning promises, that may resolve to
+ * @param allowedMsgSizeFunc is a function returning promises, that
+ * may resolve to
  * (1) undefined, if recipient is unknown,
  * (2) zero (0), if leaving mail is forbidden,
  * (3) greater than zero maximum message length, and
@@ -35,15 +36,6 @@ const canonical_address_1 = require("../../../lib-common/canonical-address");
  * (2) undefined, if it is this server should service given recipient.
  */
 function startSession(allowedMsgSizeFunc, sessionGenFunc, redirectFunc) {
-    if (typeof allowedMsgSizeFunc !== 'function') {
-        throw new TypeError(`Given argument 'allowedMsgSizeFunc' must be function, but is not.`);
-    }
-    if (typeof sessionGenFunc !== 'function') {
-        throw new TypeError(`Given argument 'sessionGenFunc' must be function, but is not.`);
-    }
-    if ((redirectFunc !== undefined) && (typeof redirectFunc !== 'function')) {
-        throw new TypeError(`Given argument 'redirectFunc' must either be function, or be undefined, but it is neither.`);
-    }
     async function serveRequestHere(recipient, sender, invitation, res) {
         const msgSize = await allowedMsgSizeFunc(recipient, sender, invitation);
         if (msgSize > 0) {

package/build/asmail/routes/retrieval/get-message-meta.d.ts

@@ -1,3 +1,3 @@
 import { RequestHandler } from 'express';
-import { GetMsgMeta } from '../../resources/recipients';
-export declare function getMsgMeta(getMsgMetaFunc: GetMsgMeta): RequestHandler;
+import { MsgRetrieval } from '../../resources/recipients';
+export declare function getMsgMeta(getMsgMetaFunc: MsgRetrieval['getMsgMeta']): RequestHandler;

package/build/asmail/routes/retrieval/get-message-meta.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2016 3NSoft Inc.
+ Copyright (C) 2015 - 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
@@ -20,9 +20,6 @@ exports.getMsgMeta = void 0;
 const recipients_1 = require("../../resources/recipients");
 const retrieval_1 = require("../../../lib-common/service-api/asmail/retrieval");
 function getMsgMeta(getMsgMetaFunc) {
-    if ('function' !== typeof getMsgMetaFunc) {
-        throw new TypeError("Given argument 'getMsgMetaFunc' must be function, but is not.");
-    }
     return async (req, res, next) => {
         const userId = req.session.params.userId;
         const msgId = req.params.msgId;

package/build/asmail/routes/retrieval/get-message-obj.d.ts

@@ -1,3 +1,3 @@
 import { RequestHandler } from 'express';
-import { GetObj } from '../../resources/recipients';
-export declare function getMsgObj(getMsgObjFunc: GetObj): RequestHandler;
+import { MsgRetrieval } from '../../resources/recipients';
+export declare function getMsgObj(getMsgObjFunc: MsgRetrieval['getObj']): RequestHandler;

package/build/asmail/routes/retrieval/get-message-obj.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2017 3NSoft Inc.
+ Copyright (C) 2015 - 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
@@ -26,25 +26,18 @@ function extractQueryOptions(req) {
     const query = req.query;
     const header = (query.header === 'true');
     const ofs = (query.ofs ? parseInt(query.ofs) : 0);
-    if (isNaN(ofs) ||
-        (ofs < 0) ||
-        (header && (ofs > 0))) {
+    if (isNaN(ofs) || (ofs < 0) || (header && (ofs > 0))) {
         return;
     }
     const limit = (query.limit ? parseInt(query.limit) : undefined);
     if (limit !== undefined) {
-        if (isNaN(limit) ||
-            (limit < 0) ||
-            (!header && (limit === 0))) {
+        if (isNaN(limit) || (limit < 0) || (!header && (limit === 0))) {
             return;
         }
     }
     return { header, limit, ofs };
 }
 function getMsgObj(getMsgObjFunc) {
-    if ('function' !== typeof getMsgObjFunc) {
-        throw new TypeError("Given argument 'getMsgObjFunc' must be function, but is not.");
-    }
     return async (req, res, next) => {
         const userId = req.session.params.userId;
         const msgId = req.params.msgId;

package/build/asmail/routes/retrieval/list-messages.d.ts

@@ -1,3 +1,3 @@
 import { RequestHandler } from 'express';
-import { GetMsgIds } from '../../resources/recipients';
-export declare function listMsgIds(listMsgIdsFunc: GetMsgIds): RequestHandler;
+import { MsgRetrieval } from '../../resources/recipients';
+export declare function listMsgIds(listMsgIdsFunc: MsgRetrieval['getMsgIds']): RequestHandler;

package/build/asmail/routes/retrieval/list-messages.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2016 3NSoft Inc.
+ Copyright (C) 2015 - 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
@@ -20,9 +20,6 @@ exports.listMsgIds = void 0;
 const recipients_1 = require("../../resources/recipients");
 const retrieval_1 = require("../../../lib-common/service-api/asmail/retrieval");
 function listMsgIds(listMsgIdsFunc) {
-    if ('function' !== typeof listMsgIdsFunc) {
-        throw new TypeError("Given argument 'listMsgIdsFunc' must be function, but is not.");
-    }
     return async (req, res, next) => {
         const userId = req.session.params.userId;
         try {

package/build/asmail/routes/retrieval/remove-message.d.ts

@@ -1,3 +1,3 @@
 import { RequestHandler } from 'express';
-import { DeleteMsg } from '../../resources/recipients';
-export declare function deleteMsg(delMsgFunc: DeleteMsg): RequestHandler;
+import { MsgRetrieval } from '../../resources/recipients';
+export declare function deleteMsg(delMsgFunc: MsgRetrieval['deleteMsg']): RequestHandler;

package/build/asmail/routes/retrieval/remove-message.js

@@ -20,9 +20,6 @@ exports.deleteMsg = void 0;
 const recipients_1 = require("../../resources/recipients");
 const retrieval_1 = require("../../../lib-common/service-api/asmail/retrieval");
 function deleteMsg(delMsgFunc) {
-    if ('function' !== typeof delMsgFunc) {
-        throw new TypeError("Given argument 'delMsgFunc' must be function, but is not.");
-    }
     return async (req, res, next) => {
         const userId = req.session.params.userId;
         const msgId = req.params.msgId;

package/build/lib-common/async-fs-node.d.ts

@@ -1,6 +1,7 @@
 /// <reference types="node" />
 /// <reference types="node" />
 /// <reference types="node" />
+/// <reference types="node" />
 import * as fs from 'fs';
 import { Readable, Writable } from 'stream';
 export { Stats } from 'fs';

package/build/lib-common/buffer-utils.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="node" />
+/// <reference types="node" />
 export declare const EMPTY_BUFFER: Buffer;
 /**
  * Buffer and Uint8Array are intimately linked in Node, starting with some

package/build/lib-common/objs-on-disk/file-layout.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="node" />
+/// <reference types="node" />
 import { Layout } from "xsp-files";
 export interface HeaderChunkInfo {
     len: number;

package/build/lib-common/objs-on-disk/v1-obj-file-format.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="node" />
+/// <reference types="node" />
 import { HeaderChunkInfo, SegsChunk } from "./file-layout";
 export declare const V1_FILE_START: Buffer;
 /**

package/build/signup/signup-tokens.d.ts

@@ -1,4 +1,5 @@
 /// <reference types="node" />
+/// <reference types="node" />
 export type SignupContext = SingleUserSignupCtx | MultiDomainSignupCtx;
 export interface SingleUserSignupCtx {
     token: string;

package/package.json

@@ -1,15 +1,19 @@
 {
   "name": "spec-3nweb-server",
-  "version": "1.7.8",
+  "version": "1.7.11",
   "description": "3NWeb spec server.",
   "main": "build/lib.js",
   "types": "build/lib.d.ts",
+  "bin": {
+    "3nweb": "node build/main.js"
+  },
   "scripts": {
     "build": "tsc -p ts-code",
+    "server": "node build/main.js",
     "test": "node build/tests/jasmine.js",
     "clear-for-packing": "npm prune --production && bash -c \"rm -rf build/mock build/tests 'node_modules/ecma-nacl/c sources'\"",
     "clear-for-packing-mock": "npm prune --production && bash -c \"rm -rf build/tests 'node_modules/ecma-nacl/c sources'\"",
-    "pack": "pkg --config package.json build/main.js",
+    "pack": "echo unimplemented",
     "pack-deb": "npm run pack && bash packing/create-deb.sh",
     "postinstall": "node -e \"try{require('./postinstall')}catch(e){}\""
   },
@@ -47,16 +51,9 @@
     "@types/node": "^16.11.7",
     "@types/ws": "^4.0.0",
     "jasmine": "^3.9.0",
-    "pkg": "^5.8.1",
     "rxjs": "^5.3.0",
     "typescript": "^4.7.4",
     "xhr2": "^0.1.3"
   },
-  "pkg": {
-    "targets": [
-      "node18-linux-x64"
-    ],
-    "outputPath": "dist"
-  },
   "readmeFilename": "README.md"
 }