core-3nweb-client-lib 0.27.0 → 0.27.4

package/build/lib-client/3nstorage/xsp-fs/fs.js

@@ -32,6 +32,7 @@ const pipe_1 = require("../../../lib-common/byte-streaming/pipe");
 const buffer_utils_1 = require("../../../lib-common/buffer-utils");
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
+const node_in_fs_1 = require("./node-in-fs");
 const utils_for_observables_1 = require("../../../lib-common/utils-for-observables");
 function splitPathIntoParts(path) {
     return path_1.posix.resolve('/', path).split('/').filter(part => !!part);
@@ -68,7 +69,7 @@ class XspFS {
     }
     storage() {
         if (!this.store) {
-            throw (0, file_1.makeFileException)(file_1.Code.storageClosed, this.name);
+            throw (0, file_1.makeFileException)('storageClosed', this.name);
         }
         return this.store;
     }
@@ -146,8 +147,10 @@ class XspFS {
         const folder = (await parentFolder.getFolder(folderName)
             .catch(setExcPath(path)));
         if (!removeContent && !folder.isEmpty()) {
-            throw (0, file_1.makeFileException)(file_1.Code.notEmpty, path);
+            throw (0, file_1.makeFileException)('notEmpty', path);
         }
+        // note that internal folder.delete() removes all children as a matter
+        // of not leaving inaccessible nodes, i.e. content is removed implicitly
         await parentFolder.removeChild(folder);
     }
     async deleteFile(path) {
@@ -252,17 +255,11 @@ class XspFS {
             return true;
         }
         else if (throwIfMissing) {
-            let code = '';
-            if (type === 'file') {
-                code = file_1.Code.notFile;
+            switch (type) {
+                case 'file': throw (0, file_1.makeFileException)('notFile', path);
+                case 'folder': throw (0, file_1.makeFileException)('notDirectory', path);
+                case 'link': throw (0, file_1.makeFileException)('notLink', path);
             }
-            else if (type === 'folder') {
-                code = file_1.Code.notDirectory;
-            }
-            else if (type === 'link') {
-                code = file_1.Code.notLink;
-            }
-            throw (0, file_1.makeFileException)(code, path);
         }
         else {
             return false;
@@ -415,14 +412,14 @@ class XspFS {
         const exists = await this.checkFilePresence(path);
         if (exists) {
             if (flags.create && flags.exclusive) {
-                throw (0, file_1.makeFileException)(file_1.Code.alreadyExists, path);
+                throw (0, file_1.makeFileException)('alreadyExists', path);
             }
             const fNode = await this.v.getOrCreateFile(path, flags);
             return (0, files_1.wrapWritableFile)(file_2.FileObject.makeExisting(fNode, true));
         }
         else {
             if (!flags.create) {
-                throw (0, file_1.makeFileException)(file_1.Code.notFound, path);
+                throw (0, file_1.makeFileException)('notFound', path);
             }
             return (0, files_1.wrapWritableFile)(file_2.FileObject.makeForNotExisiting(path_1.posix.basename(path), () => this.v.getOrCreateFile(path, flags), !!this.v.sync));
         }
@@ -512,7 +509,7 @@ class V {
     }
     getRootIfNotClosed(excPath) {
         if (!this.rootNode) {
-            throw (0, file_1.makeFileException)(file_1.Code.storageClosed, excPath);
+            throw (0, file_1.makeFileException)('storageClosed', excPath);
         }
         return this.rootNode;
     }
@@ -525,7 +522,7 @@ class V {
             .catch(setExcPath(path));
         if (file) {
             if (exclusive) {
-                throw (0, file_1.makeFileException)(file_1.Code.alreadyExists, path);
+                throw (0, file_1.makeFileException)('alreadyExists', path);
             }
         }
         else {
@@ -554,58 +551,56 @@ class V {
         const node = await this.get(path);
         return node.updateXAttrs(changes);
     }
-    async getXAttr(path, xaName) {
+    async getXAttr(path, xaName, flags) {
         const node = await this.get(path);
-        const attr = node.getXAttr(xaName);
-        return { attr, version: node.version };
+        return await node.getXAttr(xaName, flags);
     }
-    async listXAttrs(path) {
+    async listXAttrs(path, flags) {
         const node = await this.get(path);
-        return {
-            lst: node.listXAttrs(),
-            version: node.version
-        };
+        return node.listXAttrs(flags);
     }
-    async listFolder(path) {
+    async listFolder(path, flags) {
         const root = this.getRootIfNotClosed(path);
         const folder = await root.getFolderInThisSubTree(splitPathIntoParts(path), false).catch(setExcPath(path));
-        return folder.list();
+        return ((0, node_in_fs_1.shouldReadCurrentVersion)(flags) ?
+            folder.list() :
+            folder.listNonCurrent(flags));
     }
     async writeBytes(path, bytes, flags = WRITE_NONEXCL_FLAGS) {
         this.ensureIsWritable();
         const f = await this.getOrCreateFile(path, flags);
         return f.save(bytes);
     }
-    async readBytes(path, start, end) {
+    async readBytes(path, start, end, flags) {
         const file = await this.getOrCreateFile(path, {});
-        return await file.readBytes(start, end);
+        return await file.readBytes(start, end, flags);
     }
     writeTxtFile(path, txt, flags = WRITE_NONEXCL_FLAGS) {
         const bytes = buffer_utils_1.utf8.pack(txt);
         return this.writeBytes(path, bytes, flags);
     }
-    async readTxtFile(path) {
-        const { bytes, version } = await this.readBytes(path);
+    async readTxtFile(path, flags) {
+        const { bytes, version } = await this.readBytes(path, undefined, undefined, flags);
         try {
             const txt = (bytes ? buffer_utils_1.utf8.open(bytes) : '');
             return { txt, version };
         }
         catch (err) {
-            throw (0, file_1.makeFileException)(file_1.Code.parsingError, path, err);
+            throw (0, file_1.makeFileException)('parsingError', path, err);
         }
     }
     writeJSONFile(path, json, flags = WRITE_NONEXCL_FLAGS) {
         const txt = JSON.stringify(json);
         return this.writeTxtFile(path, txt, flags);
     }
-    async readJSONFile(path) {
-        const { txt, version } = await this.readTxtFile(path);
+    async readJSONFile(path, flags) {
+        const { txt, version } = await this.readTxtFile(path, flags);
         try {
             const json = JSON.parse(txt);
             return { json, version };
         }
         catch (err) {
-            throw (0, file_1.makeFileException)(file_1.Code.parsingError, path, err);
+            throw (0, file_1.makeFileException)('parsingError', path, err);
         }
     }
     async getByteSink(path, flags = WRITE_NONEXCL_FLAGS) {
@@ -613,9 +608,9 @@ class V {
         const f = await this.getOrCreateFile(path, flags);
         return f.writeSink(flags.truncate, flags.currentVersion);
     }
-    async getByteSource(path) {
+    async getByteSource(path, flags) {
         const f = await this.getOrCreateFile(path, {});
-        return f.readSrc();
+        return f.readSrc(flags);
     }
 }
 Object.freeze(V.prototype);
@@ -780,7 +775,7 @@ class S {
     async getFolderNode(path) {
         const node = await this.n.get(path);
         if (node.type !== 'folder') {
-            throw (0, file_1.makeFileException)(file_1.Code.notDirectory, path);
+            throw (0, file_1.makeFileException)('notDirectory', path);
         }
         return node;
     }

package/build/lib-client/3nstorage/xsp-fs/node-in-fs.d.ts

@@ -1,4 +1,4 @@
-import { FSChangeSrc, Node, NodeType, Storage, SyncedStorage } from './common';
+import { FSChangeSrc, Node, NodeType, Storage, SyncedStorage, UploadHeaderChange } from './common';
 import { Observable } from 'rxjs';
 import { CommonAttrs, XAttrs } from './attrs';
 import { NodePersistance } from './node-persistence';
@@ -9,6 +9,7 @@ declare type XAttrsChanges = web3n.files.XAttrsChanges;
 declare type SyncStatus = web3n.files.SyncStatus;
 declare type OptionsToAdopteRemote = web3n.files.OptionsToAdopteRemote;
 declare type OptionsToUploadLocal = web3n.files.OptionsToUploadLocal;
+declare type VersionedReadFlags = web3n.files.VersionedReadFlags;
 export declare abstract class NodeInFS<P extends NodePersistance> implements Node {
     protected readonly storage: Storage;
     readonly type: NodeType;
@@ -24,6 +25,7 @@ export declare abstract class NodeInFS<P extends NodePersistance> implements Nod
     protected setCurrentVersion(newVersion: number): void;
     readonly isInSyncedStorage: boolean;
     protected constructor(storage: Storage, type: NodeType, name: string, objId: string, currentVersion: number, parentId: string | undefined);
+    protected getObjSrcOfVersion(flags: VersionedReadFlags | undefined): Promise<ObjSource>;
     private updatedXAttrs;
     protected setUpdatedParams(version: number, attrs: CommonAttrs | undefined, xattrs: XAttrs | undefined): void;
     protected getParamsForUpdate(changes: XAttrsChanges | undefined): {
@@ -32,21 +34,22 @@ export declare abstract class NodeInFS<P extends NodePersistance> implements Nod
         xattrs?: XAttrs;
     };
     updateXAttrs(changes: XAttrsChanges): Promise<number>;
-    getXAttr(xaName: string): any;
-    listXAttrs(): string[];
+    getXAttr(xaName: string, flags: VersionedReadFlags | undefined): Promise<{
+        attr: any;
+        version: number;
+    }>;
+    listXAttrs(flags: VersionedReadFlags | undefined): Promise<{
+        lst: string[];
+        version: number;
+    }>;
     getAttrs(): CommonAttrs;
     listVersions(): Promise<{
         current?: number;
         archived?: number[];
     }>;
     archiveCurrent(version?: number): Promise<number>;
-    removeObj(src?: FSChangeSrc): Promise<void>;
-    /**
-     * This non-synchronized method deletes object from storage, and detaches
-     * this node from storage. Make sure to call it inside access synchronization
-     * construct.
-     */
-    protected delete(src: FSChangeSrc): Promise<void>;
+    removeNonFolderObj(src: FSChangeSrc): Promise<void>;
+    protected removeThisNodeAsLeaf(src: FSChangeSrc): Promise<void>;
     /**
      * This method runs node changing function in an exclusive manner.
      * Returned promise resolves to whatever change function returns.
@@ -80,6 +83,7 @@ export declare abstract class NodeInFS<P extends NodePersistance> implements Nod
         createOnRemote: boolean;
     } | undefined>;
     upload(opts: OptionsToUploadLocal | undefined): Promise<void>;
-    private uploadHeaderChange;
+    protected uploadHeaderChange(localVersion: number, uploadVersion: number): Promise<UploadHeaderChange | undefined>;
 }
+export declare function shouldReadCurrentVersion(flags: VersionedReadFlags | undefined): boolean;
 export {};

package/build/lib-client/3nstorage/xsp-fs/node-in-fs.js

@@ -16,7 +16,7 @@
  this program. If not, see <http://www.gnu.org/licenses/>.
 */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NodeInFS = void 0;
+exports.shouldReadCurrentVersion = exports.NodeInFS = void 0;
 /**
  * Everything in this module is assumed to be inside of a file system
  * reliance set.
@@ -29,6 +29,7 @@ const exceptions_1 = require("../exceptions");
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
 const attrs_1 = require("./attrs");
+const assert_1 = require("../../../lib-common/assert");
 class NodeInFS {
     constructor(storage, type, name, objId, currentVersion, parentId) {
         this.storage = storage;
@@ -57,6 +58,19 @@ class NodeInFS {
         }
         this.currentVersion = newVersion;
     }
+    getObjSrcOfVersion(flags) {
+        if (flags) {
+            const { remoteVersion, archivedVersion } = flags;
+            if (remoteVersion) {
+                const store = this.syncedStorage();
+                return store.getObjSrcOfRemoteVersion(this.objId, remoteVersion);
+            }
+            else if (archivedVersion) {
+                return this.storage.getObjSrc(this.objId, archivedVersion, true);
+            }
+        }
+        return this.storage.getObjSrc(this.objId);
+    }
     updatedXAttrs(changes) {
         return (this.xattrs ?
             (changes ? this.xattrs.makeUpdated(changes) : this.xattrs) :
@@ -89,11 +103,39 @@ class NodeInFS {
             return this.version;
         });
     }
-    getXAttr(xaName) {
-        return (this.xattrs ? this.xattrs.get(xaName) : undefined);
+    async getXAttr(xaName, flags) {
+        if (shouldReadCurrentVersion(flags)) {
+            return {
+                attr: (this.xattrs ? this.xattrs.get(xaName) : undefined),
+                version: this.version
+            };
+        }
+        else {
+            const src = await this.getObjSrcOfVersion(flags);
+            const payload = await this.crypto.readonlyPayload(src);
+            const xattrs = await payload.getXAttrs();
+            return {
+                attr: xattrs.get(xaName),
+                version: src.version
+            };
+        }
     }
-    listXAttrs() {
-        return (this.xattrs ? this.xattrs.list() : []);
+    async listXAttrs(flags) {
+        if (shouldReadCurrentVersion(flags)) {
+            return {
+                lst: (this.xattrs ? this.xattrs.list() : []),
+                version: this.version
+            };
+        }
+        else {
+            const src = await this.getObjSrcOfVersion(flags);
+            const payload = await this.crypto.readonlyPayload(src);
+            const xattrs = await payload.getXAttrs();
+            return {
+                lst: xattrs.list(),
+                version: src.version
+            };
+        }
     }
     getAttrs() {
         return this.attrs;
@@ -124,7 +166,7 @@ class NodeInFS {
         else {
             if (version) {
                 if (this.currentVersion !== version) {
-                    throw (0, file_1.makeFileException)(file_1.Code.versionMismatch, this.name);
+                    throw (0, file_1.makeFileException)('versionMismatch', this.name);
                 }
             }
             else {
@@ -135,15 +177,11 @@ class NodeInFS {
             return version;
         }
     }
-    removeObj(src = 'local') {
-        return this.doChange(true, () => this.delete(src));
+    removeNonFolderObj(src) {
+        (0, assert_1.assert)(this.type !== 'folder');
+        return this.doChange(true, () => this.removeThisNodeAsLeaf(src));
     }
-    /**
-     * This non-synchronized method deletes object from storage, and detaches
-     * this node from storage. Make sure to call it inside access synchronization
-     * construct.
-     */
-    async delete(src) {
+    async removeThisNodeAsLeaf(src) {
         await this.storage.removeObj(this.objId);
         this.storage.nodes.delete(this);
         this.currentVersion = -1;
@@ -171,11 +209,11 @@ class NodeInFS {
             this.writeProc = new synced_1.SingleProc();
         }
         if (!awaitPrevChange && this.writeProc.isProcessing()) {
-            throw (0, file_1.makeFileException)(file_1.Code.concurrentUpdate, this.name + ` type ${this.type}`);
+            throw (0, file_1.makeFileException)('concurrentUpdate', this.name + ` type ${this.type}`);
         }
         const res = await this.writeProc.startOrChain(async () => {
             if (this.currentVersion < 0) {
-                throw (0, file_1.makeFileException)(file_1.Code.notFound, this.name, `Object is marked removed`);
+                throw (0, file_1.makeFileException)('notFound', this.name, `Object is marked removed`);
             }
             try {
                 const res = await change();
@@ -187,17 +225,17 @@ class NodeInFS {
                 }
                 if (exc.type === 'storage') {
                     if (exc.concurrentTransaction) {
-                        throw (0, file_1.makeFileException)(file_1.Code.concurrentUpdate, this.name, exc);
+                        throw (0, file_1.makeFileException)('concurrentUpdate', this.name, exc);
                     }
                     else if (exc.objNotFound) {
-                        throw (0, file_1.makeFileException)(file_1.Code.notFound, this.name, exc);
+                        throw (0, file_1.makeFileException)('notFound', this.name, exc);
                     }
                 }
                 else if ((exc.type === 'file')
                     || (exc.type === 'fs-sync')) {
                     throw exc;
                 }
-                throw (0, file_1.makeFileException)(file_1.Code.ioError, this.name, exc);
+                throw (0, file_1.makeFileException)('ioError', this.name, exc);
             }
         });
         return res;
@@ -258,7 +296,7 @@ class NodeInFS {
     async updateStatusInfo() {
         const storage = this.syncedStorage();
         const status = await storage.updateStatusInfo(this.objId);
-        return await this.syncStatus();
+        return status;
     }
     isSyncedVersionOnDisk(version) {
         const storage = this.syncedStorage();
@@ -350,8 +388,7 @@ class NodeInFS {
                 return;
             }
             const { localVersion, createOnRemote, uploadVersion } = toUpload;
-            const uploadHeader = ((localVersion === uploadVersion) ? undefined :
-                await this.uploadHeaderChange(localVersion, uploadVersion));
+            const uploadHeader = await this.uploadHeaderChange(localVersion, uploadVersion);
             const storage = this.syncedStorage();
             await storage.upload(this.objId, localVersion, uploadVersion, uploadHeader, createOnRemote);
             await this.doChange(true, async () => {
@@ -366,6 +403,9 @@ class NodeInFS {
         }
     }
     async uploadHeaderChange(localVersion, uploadVersion) {
+        if (localVersion === uploadVersion) {
+            return;
+        }
         const currentSrc = await this.storage.getObjSrc(this.objId, localVersion);
         const localHeader = await currentSrc.readHeader();
         const uploadHeader = await this.crypto.reencryptHeader(localHeader, uploadVersion);
@@ -389,4 +429,14 @@ function copyWithPathIfRemoteEvent(e, path) {
             return e;
     }
 }
+function shouldReadCurrentVersion(flags) {
+    if (flags) {
+        const { archivedVersion, remoteVersion } = flags;
+        if (archivedVersion || remoteVersion) {
+            return false;
+        }
+    }
+    return true;
+}
+exports.shouldReadCurrentVersion = shouldReadCurrentVersion;
 Object.freeze(exports);

package/build/lib-client/3nstorage/xsp-fs/xsp-payload-v1.js

@@ -82,6 +82,6 @@ class ReadonlyPayloadV1 {
 Object.freeze(ReadonlyPayloadV1.prototype);
 Object.freeze(ReadonlyPayloadV1);
 function makeEndlessException() {
-    return (0, file_1.makeFileException)(file_1.Code.isEndless, '');
+    return (0, file_1.makeFileException)('isEndless', '');
 }
 Object.freeze(exports);

package/build/lib-client/local-files/device-fs.js

@@ -62,10 +62,10 @@ async function makeFolder(root, path, exclusive = false) {
             continue;
         }
         if (!stats.isDirectory()) {
-            throw (0, file_1.makeFileException)(file_1.Code.notDirectory, path.slice(0, i + 1).join('/'));
+            throw (0, file_1.makeFileException)('notDirectory', path.slice(0, i + 1).join('/'));
         }
         else if ((i === lastIndex) && exclusive) {
-            throw (0, file_1.makeFileException)(file_1.Code.alreadyExists, path.join('/'));
+            throw (0, file_1.makeFileException)('alreadyExists', path.join('/'));
         }
     }
 }
@@ -227,10 +227,10 @@ class DeviceFS {
         await fs.lstat(root)
             .then(stat => {
             if (create && exclusive) {
-                throw (0, file_1.makeFileException)(file_1.Code.alreadyExists, root);
+                throw (0, file_1.makeFileException)('alreadyExists', root);
             }
             if (!stat.isDirectory()) {
-                throw (0, file_1.makeFileException)(file_1.Code.notDirectory, root);
+                throw (0, file_1.makeFileException)('notDirectory', root);
             }
         }, async (e) => {
             if (!e.notFound || !create) {
@@ -455,7 +455,7 @@ class DeviceFS {
             return txt;
         }
         catch (err) {
-            throw (0, file_1.makeFileException)(file_1.Code.parsingError, path, err);
+            throw (0, file_1.makeFileException)('parsingError', path, err);
         }
     }
     writeJSONFile(path, json, flags = WRITE_NONEXCL_FLAGS) {
@@ -469,7 +469,7 @@ class DeviceFS {
             return json;
         }
         catch (err) {
-            throw (0, file_1.makeFileException)(file_1.Code.parsingError, path, err);
+            throw (0, file_1.makeFileException)('parsingError', path, err);
         }
     }
     async deleteFile(path) {
@@ -557,7 +557,7 @@ class DeviceFS {
             const dstPath = this.root + '/' + dst.join('/');
             await fs.lstat(dstPath)
                 .then(() => {
-                throw (0, file_1.makeFileException)(file_1.Code.alreadyExists, newPath);
+                throw (0, file_1.makeFileException)('alreadyExists', newPath);
             }, (exc) => {
                 if (!exc.notFound) {
                     throw exc;
@@ -692,10 +692,10 @@ class DeviceFS {
     async writableFile(path, flags = WRITE_NONEXCL_FLAGS) {
         const exists = await this.checkFilePresence(path);
         if (exists && flags.create && flags.exclusive) {
-            throw (0, file_1.makeFileException)(file_1.Code.alreadyExists, path);
+            throw (0, file_1.makeFileException)('alreadyExists', path);
         }
         if (!exists && !flags.create) {
-            throw (0, file_1.makeFileException)(file_1.Code.notFound, path);
+            throw (0, file_1.makeFileException)('notFound', path);
         }
         return (0, files_1.wrapWritableFile)(new FileObject(this, path, exists, true));
     }
@@ -765,7 +765,7 @@ class DeviceFS {
             }
             try {
                 if (observer.error) {
-                    observer.error((0, file_1.makeFileException)(sig, path, { code, sig }));
+                    observer.error((0, file_1.makeFileExceptionFromCode)(sig, path, { code, sig }));
                 }
                 else if (observer.complete) {
                     observer.complete();
@@ -876,7 +876,7 @@ async function checkFolderPresence(path) {
         throw (0, file_1.maskPathInExc)(0, e);
     });
     if (!stat.isDirectory()) {
-        throw (0, file_1.makeFileException)(file_1.Code.notDirectory, path);
+        throw (0, file_1.makeFileException)('notDirectory', path);
     }
 }
 class FileObject {

package/build/lib-client/objs-on-disk/obj-on-disk.d.ts

@@ -38,10 +38,13 @@ export declare class ObjOnDisk {
         diff: DiffInfo;
         newSegsPackOrder: FiniteChunk[];
     };
+    private segsThatNeedDownload;
+    doesFileNeedDownload(): boolean;
+    downloadMissingSections(): Promise<void>;
 }
 export interface ObjDownloader {
-    getLayoutWithHeaderAndFirstSegs(objId: ObjId, version: number): Promise<InitDownloadParts>;
-    getSegs(objId: ObjId, version: number, start: number, end: number): Promise<Uint8Array>;
+    getLayoutWithHeaderAndFirstSegs: (objId: ObjId, version: number) => Promise<InitDownloadParts>;
+    getSegs: (objId: ObjId, version: number, start: number, end: number) => Promise<Uint8Array>;
 }
 export interface InitDownloadParts {
     layout: Layout;

package/build/lib-client/objs-on-disk/obj-on-disk.js

@@ -192,6 +192,20 @@ class ObjOnDisk {
     diffFromBase() {
         return this.objFile.diffFromBase();
     }
+    segsThatNeedDownload() {
+        const totalLen = this.objFile.getTotalSegsLen();
+        const allSegs = this.objFile.segsLocations(0, totalLen);
+        return allSegs.filter(({ type }) => (type === 'new'));
+    }
+    doesFileNeedDownload() {
+        return (this.segsThatNeedDownload().length === 0);
+    }
+    async downloadMissingSections() {
+        const needDownload = this.segsThatNeedDownload();
+        for (const chunk of needDownload) {
+            await this.downloadAndSaveSegsChunk(chunk);
+        }
+    }
 }
 exports.ObjOnDisk = ObjOnDisk;
 Object.freeze(ObjOnDisk.prototype);
@@ -223,7 +237,8 @@ class ByteSourceFromObjOnDisk {
     async getSize() {
         const size = this.totalSegsLen();
         return ((typeof size === 'number') ?
-            { size, isEndless: false } : { size: 0, isEndless: true });
+            { size, isEndless: false } :
+            { size: 0, isEndless: true });
     }
     async seek(offset) {
         (0, assert_1.assert)(Number.isInteger(offset) && (offset >= 0), 'Illegal offset is given to seek: ' + offset);

package/build/lib-client/user-with-mid-session.d.ts

@@ -8,7 +8,7 @@ import * as WebSocket from 'ws';
 export declare type IGetMailerIdSigner = () => Promise<mid.MailerIdSigner>;
 export declare abstract class ServiceUser {
     readonly userId: string;
-    private readonly getSigner;
+    private getSigner;
     private getInitServiceURI;
     protected readonly net: NetClient;
     private uri;
@@ -28,6 +28,7 @@ export declare abstract class ServiceUser {
     }, getSigner: IGetMailerIdSigner | undefined, getInitServiceURI: () => Promise<string>, net: NetClient);
     private get isUriSet();
     private throwOnBadServiceURI;
+    protected setGetterOfSigner(getSigner: IGetMailerIdSigner): void;
     /**
      * This initializes service uri, if it hasn't been set, yet.
      * Else, this function does nothing.

package/build/lib-client/user-with-mid-session.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015, 2017, 2020 3NSoft Inc.
+ Copyright (C) 2015, 2017, 2020, 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
@@ -72,6 +72,12 @@ class ServiceUser {
             throw new Error(`Service uri is not a string: ${this.serviceURI}`);
         }
     }
+    setGetterOfSigner(getSigner) {
+        if (this.getSigner) {
+            throw new Error(`getSigner is already set`);
+        }
+        this.getSigner = getSigner;
+    }
     /**
      * This initializes service uri, if it hasn't been set, yet.
      * Else, this function does nothing.