core-3nweb-client-lib 0.41.14 → 0.42.1

package/build/core/asmail/inbox/inbox-events.d.ts

@@ -3,6 +3,7 @@ import { LogError } from '../../../lib-client/logging/log-to-file';
 type IncomingMessage = web3n.asmail.IncomingMessage;
 type InboxEventType = web3n.asmail.InboxEventType;
 type Observer<T> = web3n.Observer<T>;
+type MsgInfo = web3n.asmail.MsgInfo;
 /**
  * Instance of this class handles event subscription from UI side. It observes
  * inbox server events, handles them, and generates respective events for UI
@@ -14,8 +15,26 @@ type Observer<T> = web3n.Observer<T>;
  * Hence, this should do restarts to server around wakeup events.
  */
 export declare class InboxEvents {
-    constructor(msgReceiver: MailRecipient, getMsg: (msgId: string) => Promise<IncomingMessage>, logError: LogError);
-    private newMsg$;
+    private readonly getMsg;
+    private readonly listMsgs;
+    private readonly rmMsg;
+    private readonly logError;
+    private readonly newMsgs;
+    private readonly newMsg$;
+    private listeningProc;
+    private readonly makeServerEvents;
+    private networkActive;
+    private listMsgsFrom;
+    constructor(msgReceiver: MailRecipient, getMsg: (msgId: string) => Promise<IncomingMessage>, listMsgs: (fromTS: number) => Promise<MsgInfo[]>, rmMsg: (msgId: string) => Promise<void>, logError: LogError);
+    private startListening;
+    private getMessage;
     subscribe<T>(event: InboxEventType, observer: Observer<T>): () => void;
+    close(): void;
+    get isListening(): boolean;
+    private shouldRestartAfterErr;
+    private stopListening;
+    suspendNetworkActivity(): void;
+    resumeNetworkActivity(): void;
+    private startListingOfDisconnectedPeriod;
 }
 export {};

package/build/core/asmail/inbox/inbox-events.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2017, 2019, 2022, 2024 3NSoft Inc.
+ Copyright (C) 2017, 2019, 2022, 2024 - 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
@@ -13,13 +13,16 @@
  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/>. */
+ this program. If not, see <http://www.gnu.org/licenses/>.
+*/
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InboxEvents = void 0;
+const rxjs_1 = require("rxjs");
 const retrieval_1 = require("../../../lib-common/service-api/asmail/retrieval");
 const server_events_1 = require("../../../lib-client/server-events");
 const operators_1 = require("rxjs/operators");
 const utils_for_observables_1 = require("../../../lib-common/utils-for-observables");
+const sleep_1 = require("../../../lib-common/processes/sleep");
 const SERVER_EVENTS_RESTART_WAIT_SECS = 5;
 /**
  * Instance of this class handles event subscription from UI side. It observes
@@ -32,25 +35,60 @@ const SERVER_EVENTS_RESTART_WAIT_SECS = 5;
  * Hence, this should do restarts to server around wakeup events.
  */
 class InboxEvents {
-    constructor(msgReceiver, getMsg, logError) {
-        const serverEvents = new server_events_1.ServerEvents(() => msgReceiver.openEventSource(logError), SERVER_EVENTS_RESTART_WAIT_SECS, logError);
-        this.newMsg$ = serverEvents.observe(retrieval_1.msgRecievedCompletely.EVENT_NAME)
-            .pipe(
-        // XXX tap to log more details
-        (0, operators_1.tap)({
-            complete: () => logError({}, `InboxEvents.newMsg$ completes`),
-            error: err => logError(err, `InboxEvents.newMsg$ has error`)
-        }), (0, operators_1.mergeMap)(async (ev) => {
-            try {
-                const msg = await getMsg(ev.msgId);
-                return msg;
+    constructor(msgReceiver, getMsg, listMsgs, rmMsg, logError) {
+        this.getMsg = getMsg;
+        this.listMsgs = listMsgs;
+        this.rmMsg = rmMsg;
+        this.logError = logError;
+        this.newMsgs = new rxjs_1.Subject();
+        this.newMsg$ = this.newMsgs.asObservable().pipe((0, operators_1.share)());
+        this.listeningProc = undefined;
+        this.networkActive = true;
+        this.listMsgsFrom = undefined;
+        this.makeServerEvents = () => new server_events_1.ServerEvents(() => msgReceiver.openEventSource(this.logError));
+        this.startListening();
+        Object.seal(this);
+    }
+    startListening() {
+        if (this.listeningProc || !this.networkActive) {
+            return;
+        }
+        function clearListeningProc() {
+            if (this.listeningProc === sub) {
+                this.listeningProc = undefined;
             }
-            catch (err) {
-                // TODO should more error handling logic be added here?
-                await logError(err, `Cannot get message ${ev.msgId}`);
+        }
+        const sub = this.makeServerEvents()
+            .observe(retrieval_1.msgRecievedCompletely.EVENT_NAME)
+            .pipe((0, operators_1.mergeMap)(async (ev) => this.getMessage(ev.msgId), 5))
+            .subscribe({
+            next: msg => {
+                if (msg) {
+                    this.newMsgs.next(msg);
+                }
+            },
+            complete: () => {
+                clearListeningProc();
+            },
+            error: async (exc) => {
+                clearListeningProc();
+                if (this.shouldRestartAfterErr(exc)) {
+                    await (0, sleep_1.sleep)(SERVER_EVENTS_RESTART_WAIT_SECS);
+                    this.startListening();
+                }
             }
-        }), (0, operators_1.filter)(msg => !!msg), (0, operators_1.share)());
-        Object.seal(this);
+        });
+        this.listeningProc = sub;
+    }
+    async getMessage(msgId) {
+        try {
+            return await this.getMsg(msgId);
+        }
+        catch (err) {
+            // XXX we need to skip, if it is a connectivity error here
+            await this.rmMsg(msgId);
+            await this.logError(err, `Cannot get message ${msgId}, and removing it as a result`);
+        }
     }
     subscribe(event, observer) {
         if (event === 'message') {
@@ -61,6 +99,72 @@ class InboxEvents {
             throw new Error(`Event type ${event} is unknown to inbox`);
         }
     }
+    close() {
+        this.newMsgs.complete();
+    }
+    get isListening() {
+        return !!this.listeningProc;
+    }
+    shouldRestartAfterErr(exc) {
+        if (!exc.runtimeException) {
+            return false;
+        }
+        if (exc.type === 'connect') {
+            return true;
+        }
+        else if (exc.type === 'http-request') {
+            return false;
+        }
+        else if (exc.type === 'websocket') {
+            return true;
+        }
+        else {
+            return false;
+        }
+    }
+    stopListening() {
+        var _a;
+        (_a = this.listeningProc) === null || _a === void 0 ? void 0 : _a.unsubscribe();
+        this.listeningProc = undefined;
+    }
+    suspendNetworkActivity() {
+        this.networkActive = false;
+        if (this.isListening) {
+            if (!this.listMsgsFrom) {
+                this.listMsgsFrom = Date.now();
+            }
+            this.stopListening();
+        }
+    }
+    resumeNetworkActivity() {
+        this.networkActive = true;
+        if (!this.isListening) {
+            this.startListening();
+            this.startListingOfDisconnectedPeriod();
+        }
+    }
+    async startListingOfDisconnectedPeriod() {
+        if (!this.listMsgsFrom) {
+            return;
+        }
+        const fromTS = this.listMsgsFrom + 2 * 60 * 1000;
+        let msgInfos = (await this.listMsgs(fromTS))
+            .filter(info => (fromTS <= info.deliveryTS))
+            .sort((a, b) => (a.deliveryTS - b.deliveryTS));
+        for (const info of msgInfos) {
+            const msg = await this.getMessage(info.msgId);
+            if (msg) {
+                this.newMsgs.next(msg);
+            }
+            else if (!this.networkActive) {
+                return;
+            }
+            else {
+                // XXX
+            }
+        }
+        this.listMsgsFrom = undefined;
+    }
 }
 exports.InboxEvents = InboxEvents;
 Object.freeze(InboxEvents.prototype);

package/build/core/asmail/inbox/index.d.ts

@@ -96,5 +96,7 @@ export declare class InboxOnServer {
     private listMsgs;
     private getMsg;
     private msgToUIForm;
+    suspendNetworkActivity(): void;
+    resumeNetworkActivity(): void;
 }
 export {};

package/build/core/asmail/inbox/index.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2020, 2022 3NSoft Inc.
+ Copyright (C) 2015 - 2020, 2022, 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,7 +51,7 @@ class InboxOnServer {
         this.logError = logError;
         this.procs = new synced_1.NamedProcs();
         this.recentlyOpenedMsgs = (0, timed_cache_1.makeTimedCache)(60 * 1000);
-        this.inboxEvents = new inbox_events_1.InboxEvents(this.msgReceiver, this.getMsg.bind(this), this.logError);
+        this.inboxEvents = new inbox_events_1.InboxEvents(this.msgReceiver, this.getMsg.bind(this), this.listMsgs.bind(this), this.removeMsg.bind(this), this.logError);
         Object.seal(this);
     }
     static async makeAndStart(cachePath, syncedFS, r) {
@@ -71,6 +71,7 @@ class InboxOnServer {
     }
     async close() {
         this.index.stopSyncing();
+        this.inboxEvents.close();
     }
     makeCAP() {
         const service = {
@@ -229,11 +230,10 @@ class InboxOnServer {
             if (msgIds.length === 0) {
                 return indexedMsgs;
             }
-            const keying = msgIds.map(msgId => this.startCachingAndAddKeyToIndex(msgId)
+            await Promise.all(msgIds.map(msgId => this.startCachingAndAddKeyToIndex(msgId)
                 .catch(async (exc) => {
                 await this.logError(exc, `Failed to start caching message ${msgId}`);
-            }));
-            await Promise.all(keying);
+            })));
             return this.index.listMsgs(fromTS);
         });
     }
@@ -309,6 +309,12 @@ class InboxOnServer {
         }
         return m;
     }
+    suspendNetworkActivity() {
+        this.inboxEvents.suspendNetworkActivity();
+    }
+    resumeNetworkActivity() {
+        this.inboxEvents.resumeNetworkActivity();
+    }
 }
 exports.InboxOnServer = InboxOnServer;
 Object.freeze(InboxOnServer.prototype);

package/build/core/asmail/index.d.ts

@@ -29,5 +29,7 @@ export declare class ASMail {
     makeASMailCAP(): Service;
     makePreflightOnlyASMailCAP(): Service;
     close(): Promise<void>;
+    suspendNetworkActivity(): void;
+    resumeNetworkActivity(): void;
 }
 export {};

package/build/core/asmail/index.js

@@ -129,6 +129,12 @@ class ASMail {
         await this.keyring.close();
         await this.sendingParams.close();
     }
+    suspendNetworkActivity() {
+        this.inbox.suspendNetworkActivity();
+    }
+    resumeNetworkActivity() {
+        this.inbox.resumeNetworkActivity();
+    }
 }
 exports.ASMail = ASMail;
 Object.freeze(ASMail.prototype);

package/build/core/index.js

@@ -326,8 +326,14 @@ class Core {
     getStorages() {
         return this.storages.wrap();
     }
-    async onDeviceSystemSuspend() { }
-    async onDeviceSystemResume() { }
+    async onDeviceSystemSuspend() {
+        this.asmail.suspendNetworkActivity();
+        this.storages.suspendNetworkActivity();
+    }
+    async onDeviceSystemResume() {
+        this.storages.resumeNetworkActivity();
+        this.asmail.resumeNetworkActivity();
+    }
 }
 exports.Core = Core;
 Object.freeze(Core.prototype);

package/build/core/storage/index.d.ts

@@ -46,6 +46,8 @@ export declare class Storages implements FactoryOfFSs {
      * @param dst is a path starting with core app folder name
      */
     migrateCoreAppDataOnFirstRun(type: StorageType, src: string, dst: string): Promise<void>;
+    suspendNetworkActivity(): void;
+    resumeNetworkActivity(): void;
 }
 export interface FactoryOfFSs {
     makeSyncedFSForApp(appFolder: string): Promise<WritableFS>;
@@ -57,23 +59,4 @@ export interface FactoryOfFSs {
 export declare function reverseDomain(domain: string): string;
 type Service = web3n.storage.Service;
 type StoragePolicy = web3n.caps.common.StoragePolicy;
-export declare class PerAppStorage {
-    private readonly appFSsFactory;
-    private readonly policy;
-    private readonly appFSs;
-    private readonly revAppDomain;
-    constructor(appFSsFactory: FactoryOfFSs, appDomain: string, policy: StoragePolicy);
-    wrap(): ReturnType<Storages['makeStorageCAP']>;
-    private getAppSyncedFS;
-    private getAppLocalFS;
-    /**
-     * This throws up, if given file system is not allowed to be opened.
-     * @param appFolder
-     * @param type
-     */
-    private ensureAppFSAllowed;
-    private getUserFS;
-    private getSysFS;
-    private close;
-}
 export {};

package/build/core/storage/index.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2017, 2019 - 2022 3NSoft Inc.
+ Copyright (C) 2015 - 2017, 2019 - 2022, 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
@@ -16,7 +16,7 @@
  this program. If not, see <http://www.gnu.org/licenses/>.
 */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PerAppStorage = exports.Storages = void 0;
+exports.Storages = void 0;
 exports.reverseDomain = reverseDomain;
 const fs_1 = require("../../lib-client/xsp-fs/fs");
 const storage_1 = require("./synced/storage");
@@ -386,6 +386,14 @@ class Storages {
             await this.local.migrateCoreAppDataOnFirstRun(src, dst);
         }
     }
+    suspendNetworkActivity() {
+        var _a;
+        (_a = this.synced) === null || _a === void 0 ? void 0 : _a.storage.suspendNetworkActivity();
+    }
+    resumeNetworkActivity() {
+        var _a;
+        (_a = this.synced) === null || _a === void 0 ? void 0 : _a.storage.resumeNetworkActivity();
+    }
 }
 exports.Storages = Storages;
 Object.freeze(Storages.prototype);
@@ -482,7 +490,6 @@ class PerAppStorage {
         this.appFSs.clear();
     }
 }
-exports.PerAppStorage = PerAppStorage;
 Object.freeze(PerAppStorage.prototype);
 Object.freeze(PerAppStorage);
 async function applyPolicyToFSItem(fsi, policy, path) {

package/build/core/storage/synced/remote-events.d.ts

@@ -19,4 +19,6 @@ export declare class RemoteEvents {
     private absorbObjRemoval;
     private absorbObjVersionArchival;
     private absorbArchVersionRemoval;
+    suspendNetworkActivity(): void;
+    resumeNetworkActivity(): void;
 }

package/build/core/storage/synced/remote-events.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2019 - 2020, 2022 3NSoft Inc.
+ Copyright (C) 2019 - 2020, 2022, 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
@@ -36,8 +36,12 @@ class RemoteEvents {
         Object.seal(this);
     }
     startAbsorbingRemoteEvents() {
-        const serverEvents = new server_events_1.ServerEvents(() => this.remoteStorage.openEventSource(this.logError), SERVER_EVENTS_RESTART_WAIT_SECS, this.logError);
-        this.absorbingRemoteEventsProc = (0, rxjs_1.merge)(this.absorbObjChange(serverEvents), this.absorbObjRemoval(serverEvents), this.absorbObjVersionArchival(serverEvents), this.absorbArchVersionRemoval(serverEvents))
+        const serverEvents = new server_events_1.ServerEvents(() => this.remoteStorage.openEventSource(this.logError));
+        this.absorbingRemoteEventsProc = (0, rxjs_1.merge)(this.absorbObjChange(serverEvents), this.absorbObjRemoval(serverEvents), 
+        // XXX commenting out to see if unknownEvent exception goes away
+        //     Is server doesn't know it?
+        // this.absorbObjVersionArchival(serverEvents),
+        this.absorbArchVersionRemoval(serverEvents))
             .subscribe({
             next: noop,
             error: async (err) => {
@@ -117,6 +121,16 @@ class RemoteEvents {
             });
         }, 1));
     }
+    suspendNetworkActivity() {
+        // XXX
+        // - set haveNetwork flag to false
+        // - press breaks on events from server
+    }
+    resumeNetworkActivity() {
+        // XXX
+        // - set haveNetwork flag to true
+        // - restart watching events from server
+    }
 }
 exports.RemoteEvents = RemoteEvents;
 Object.freeze(RemoteEvents.prototype);

package/build/core/storage/synced/storage.d.ts

@@ -53,5 +53,7 @@ export declare class SyncedStore implements ISyncedStorage {
     saveObj(objId: ObjId, version: number, encSub: Subscribe): Promise<void>;
     removeObj(objId: string): Promise<void>;
     close(): Promise<void>;
+    suspendNetworkActivity(): void;
+    resumeNetworkActivity(): void;
 }
 export {};

package/build/core/storage/synced/storage.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2020, 2022 3NSoft Inc.
+ Copyright (C) 2015 - 2020, 2022, 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
@@ -248,6 +248,12 @@ class SyncedStore {
             await this.logError(err);
         }
     }
+    suspendNetworkActivity() {
+        this.remoteEvents.suspendNetworkActivity();
+    }
+    resumeNetworkActivity() {
+        this.remoteEvents.resumeNetworkActivity();
+    }
 }
 exports.SyncedStore = SyncedStore;
 Object.freeze(SyncedStore.prototype);

package/build/lib-client/asmail/recipient.js

@@ -67,9 +67,8 @@ class MailRecipient extends user_with_mid_session_1.ServiceUser {
         return this.net;
     }
     async listMsgs(fromTS) {
-        // XXX modify request to take fromTS parameter to limit number of msgs
         const rep = await this.doBodylessSessionRequest({
-            appPath: api.listMsgs.URL_END,
+            appPath: api.listMsgs.genUrlEnd(fromTS ? { from: fromTS } : undefined),
             method: 'GET',
             responseType: 'json'
         });

package/build/lib-client/server-events.d.ts

@@ -1,19 +1,14 @@
 import { SubscribingClient } from '../lib-common/ipc/generic-ipc';
 import { Observable } from 'rxjs';
-import { LogError } from './logging/log-to-file';
 export declare class ServerEvents<N extends string, T> {
     private readonly subscribeToServer;
-    private restartWaitSecs;
-    private readonly logError;
     private server;
     private openningServer;
-    constructor(subscribeToServer: () => Promise<SubscribingClient>, restartWaitSecs: number, logError: LogError);
+    constructor(subscribeToServer: () => Promise<SubscribingClient>);
     /**
      * This method creates an observable of server's events.
      * @param event is an event on server, to which to subscribe.
      */
     observe(event: N): Observable<T>;
     private setServer;
-    private shouldRestartAfterErr;
-    private restartObservation;
 }

package/build/lib-client/server-events.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2017, 2019, 2022 3NSoft Inc.
+ Copyright (C) 2017, 2019, 2022, 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
@@ -19,13 +19,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ServerEvents = void 0;
 const rxjs_1 = require("rxjs");
 const synced_1 = require("../lib-common/processes/synced");
-const sleep_1 = require("../lib-common/processes/sleep");
-const operators_1 = require("rxjs/operators");
 class ServerEvents {
-    constructor(subscribeToServer, restartWaitSecs, logError) {
+    constructor(subscribeToServer) {
         this.subscribeToServer = subscribeToServer;
-        this.restartWaitSecs = restartWaitSecs;
-        this.logError = logError;
         this.server = undefined;
         this.openningServer = new synced_1.SingleProc();
         Object.seal(this);
@@ -35,7 +31,7 @@ class ServerEvents {
      * @param event is an event on server, to which to subscribe.
      */
     observe(event) {
-        const event$ = new rxjs_1.Observable(observer => {
+        return new rxjs_1.Observable(observer => {
             // simple sync creation of detach function
             if (this.server) {
                 return this.server.subscribe(event, observer);
@@ -57,9 +53,7 @@ class ServerEvents {
                 obs = undefined;
             })
                 .catch(err => {
-                if (obs) {
-                    obs.error(err);
-                }
+                obs === null || obs === void 0 ? void 0 : obs.error(err);
                 obs = undefined;
             });
             return () => {
@@ -71,22 +65,7 @@ class ServerEvents {
                     obs = undefined;
                 }
             };
-        })
-            .pipe(
-        // XXX tap to log more details
-        (0, operators_1.tap)({
-            complete: () => this.logError(null, `ServerEvents.observe('${event}') stream completes`),
-            error: err => this.logError(err, `ServerEvents.observe('${event}') stream has error`)
-        }), (0, operators_1.catchError)(err => {
-            if (this.shouldRestartAfterErr(err)) {
-                // console.error(stringifyErr(err));
-                return this.restartObservation(event);
-            }
-            else {
-                return (0, rxjs_1.throwError)(() => err);
-            }
-        }));
-        return event$;
+        });
     }
     setServer(server) {
         this.server = server;
@@ -96,31 +75,6 @@ class ServerEvents {
             }
         });
     }
-    shouldRestartAfterErr(exc) {
-        if (!exc.runtimeException) {
-            return false;
-        }
-        if (exc.type === 'connect') {
-            return true;
-        }
-        else if (exc.type === 'http-request') {
-            return false;
-        }
-        else if (exc.type === 'websocket') {
-            return true;
-        }
-        else {
-            return false;
-        }
-    }
-    restartObservation(event) {
-        return (0, rxjs_1.from)((0, sleep_1.sleep)(this.restartWaitSecs * 1000))
-            .pipe(
-        // XXX tap to log more details
-        (0, operators_1.tap)({
-            next: () => this.logError(null, `ServerEvents.restartObservation of ${event} events`)
-        }), (0, operators_1.mergeMap)(() => this.observe(event)));
-    }
 }
 exports.ServerEvents = ServerEvents;
 Object.freeze(ServerEvents.prototype);

package/build/lib-client/xsp-fs/common.d.ts

@@ -120,6 +120,8 @@ export interface SyncedStorage extends Storage {
     dropCachedLocalObjVersionsLessOrEqual(objId: ObjId, localVersion: number): void;
     uploadObjRemoval(objId: ObjId): Promise<void>;
     status(objId: ObjId): Promise<SyncedObjStatus>;
+    suspendNetworkActivity(): void;
+    resumeNetworkActivity(): void;
 }
 export interface SyncedObjStatus extends LocalObjStatus {
     syncStatus(): SyncStatus;

package/build/lib-client/xsp-fs/common.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2017, 2019 - 2020, 2022 3NSoft Inc.
+ Copyright (C) 2015 - 2017, 2019 - 2020, 2022, 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
@@ -136,6 +136,8 @@ function wrapSyncStorageImplementation(impl) {
     wrap.dropCachedLocalObjVersionsLessOrEqual = impl.dropCachedLocalObjVersionsLessOrEqual.bind(impl);
     wrap.adoptRemote = impl.adoptRemote.bind(impl);
     wrap.updateStatusInfo = impl.updateStatusInfo.bind(impl);
+    wrap.suspendNetworkActivity = impl.suspendNetworkActivity.bind(impl);
+    wrap.resumeNetworkActivity = impl.resumeNetworkActivity.bind(impl);
     return Object.freeze(wrap);
 }
 function isSyncedStorage(storage) {

package/build/lib-common/service-api/asmail/retrieval.d.ts

@@ -19,8 +19,13 @@ export declare namespace midLogin {
 export declare namespace closeSession {
     const URL_END = "close-session";
 }
+export interface ListMsgsOpts {
+    from?: number;
+    to?: number;
+}
 export declare namespace listMsgs {
-    const URL_END = "msg/ids";
+    const EXPRESS_URL_END = "msg/ids";
+    function genUrlEnd(opts?: ListMsgsOpts): string;
     interface Reply extends Array<string> {
     }
     const SC: {

package/build/lib-common/service-api/asmail/retrieval.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015, 2017, 2019 3NSoft Inc.
+ Copyright (C) 2015, 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
@@ -50,7 +50,12 @@ var closeSession;
 Object.freeze(closeSession);
 var listMsgs;
 (function (listMsgs) {
-    listMsgs.URL_END = 'msg/ids';
+    listMsgs.EXPRESS_URL_END = 'msg/ids';
+    function genUrlEnd(opts) {
+        let optStr = (opts ? '?' + (0, querystring_1.stringify)(opts) : '');
+        return `msg/ids${optStr}`;
+    }
+    listMsgs.genUrlEnd = genUrlEnd;
     listMsgs.SC = {
         ok: 200,
     };

package/build/lib-index.d.ts

@@ -2,7 +2,7 @@
 export * from "./core";
 export { SignUp, CreatedUser } from './core/startup/sign-up';
 export { IdManager } from './core/id-manager';
-export { Storages, FactoryOfFSs, reverseDomain, PerAppStorage } from './core/storage';
+export { Storages, FactoryOfFSs, reverseDomain } from './core/storage';
 export { SignIn, GenerateKey, CompleteInitWithoutCache } from './core/startup/sign-in';
 export { ASMail } from './core/asmail';
 export { makeServiceLocator, ServiceLocatorMaker } from "./lib-client/service-locator";

package/build/lib-index.js

@@ -30,7 +30,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.makeLogger = exports.DeviceFS = exports.sysFolders = exports.appDirs = exports.makeNetClient = exports.makeServiceLocator = exports.ASMail = exports.SignIn = exports.PerAppStorage = exports.reverseDomain = exports.Storages = exports.IdManager = exports.SignUp = void 0;
+exports.makeLogger = exports.DeviceFS = exports.sysFolders = exports.appDirs = exports.makeNetClient = exports.makeServiceLocator = exports.ASMail = exports.SignIn = exports.reverseDomain = exports.Storages = exports.IdManager = exports.SignUp = void 0;
 __exportStar(require("./core"), exports);
 var sign_up_1 = require("./core/startup/sign-up");
 Object.defineProperty(exports, "SignUp", { enumerable: true, get: function () { return sign_up_1.SignUp; } });
@@ -39,7 +39,6 @@ Object.defineProperty(exports, "IdManager", { enumerable: true, get: function ()
 var storage_1 = require("./core/storage");
 Object.defineProperty(exports, "Storages", { enumerable: true, get: function () { return storage_1.Storages; } });
 Object.defineProperty(exports, "reverseDomain", { enumerable: true, get: function () { return storage_1.reverseDomain; } });
-Object.defineProperty(exports, "PerAppStorage", { enumerable: true, get: function () { return storage_1.PerAppStorage; } });
 var sign_in_1 = require("./core/startup/sign-in");
 Object.defineProperty(exports, "SignIn", { enumerable: true, get: function () { return sign_in_1.SignIn; } });
 var asmail_1 = require("./core/asmail");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "core-3nweb-client-lib",
-  "version": "0.41.14",
+  "version": "0.42.1",
   "description": "3NWeb client core library, embeddable into different environments",
   "main": "build/lib-index.js",
   "types": "build/lib-index.d.ts",
@@ -41,7 +41,7 @@
     "@types/ws": "^7.4.7",
     "jasmine": "^3.9.0",
     "protobufjs-cli": "^1.0.2",
-    "spec-3nweb-server": "^1.7.14",
+    "spec-3nweb-server": "^1.8.0",
     "tsuml2": "^0.17.1",
     "typescript": "^5.5.3"
   }

package/{test-data-10-1759456540615/util/logs/2025-10-03.log.txt → test-data-1-1759636324169/util/logs/2025-10-05.log.txt}

@@ -1,13 +1,13 @@
 
-Thu Oct 02 2025 21:55:44 GMT-0400 (Eastern Daylight Saving Time) ==================================
-Core version 0.41.14
+Sat Oct 04 2025 23:52:23 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
 Log level: error.
 WebSocket to wss://localhost:8088/asmail/retrieval/events closed with error
 
 Error message: undefined
 
-Thu Oct 02 2025 21:55:44 GMT-0400 (Eastern Daylight Saving Time) ==================================
-Core version 0.41.14
+Sat Oct 04 2025 23:52:23 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
 Log level: error.
 WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
 

package/test-data-10-1759636364594/util/logs/2025-10-05.log.txt

@@ -0,0 +1,14 @@
+
+Sat Oct 04 2025 23:52:48 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/asmail/retrieval/events closed with error
+
+Error message: undefined
+
+Sat Oct 04 2025 23:52:48 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
+
+Error message: undefined

package/test-data-11-1759636364595/util/logs/2025-10-05.log.txt

@@ -0,0 +1,14 @@
+
+Sat Oct 04 2025 23:52:48 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/asmail/retrieval/events closed with error
+
+Error message: undefined
+
+Sat Oct 04 2025 23:52:48 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
+
+Error message: undefined

package/test-data-12-1759636368628/util/logs/2025-10-05.log.txt

@@ -0,0 +1,14 @@
+
+Sat Oct 04 2025 23:52:52 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/asmail/retrieval/events closed with error
+
+Error message: undefined
+
+Sat Oct 04 2025 23:52:52 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
+
+Error message: undefined

package/test-data-13-1759636369614/util/logs/2025-10-05.log.txt

@@ -0,0 +1,28 @@
+
+Sat Oct 04 2025 23:52:52 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/asmail/retrieval/events closed with error
+
+Error message: undefined
+
+Sat Oct 04 2025 23:52:52 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/asmail/retrieval/events closed with error
+
+Error message: undefined
+
+Sat Oct 04 2025 23:52:52 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
+
+Error message: undefined
+
+Sat Oct 04 2025 23:52:52 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
+
+Error message: undefined

package/test-data-2-1759636324173/util/logs/2025-10-05.log.txt

@@ -0,0 +1,14 @@
+
+Sat Oct 04 2025 23:52:25 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/asmail/retrieval/events closed with error
+
+Error message: undefined
+
+Sat Oct 04 2025 23:52:25 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
+
+Error message: undefined

package/test-data-3-1759636329651/util/logs/2025-10-05.log.txt

@@ -0,0 +1,28 @@
+
+Sat Oct 04 2025 23:52:15 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/asmail/retrieval/events closed with error
+
+Error message: undefined
+
+Sat Oct 04 2025 23:52:15 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/asmail/retrieval/events closed with error
+
+Error message: undefined
+
+Sat Oct 04 2025 23:52:15 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
+
+Error message: undefined
+
+Sat Oct 04 2025 23:52:15 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
+
+Error message: undefined

package/test-data-4-1759636335955/util/logs/2025-10-05.log.txt

@@ -0,0 +1,28 @@
+
+Sat Oct 04 2025 23:52:21 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/asmail/retrieval/events closed with error
+
+Error message: undefined
+
+Sat Oct 04 2025 23:52:21 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/asmail/retrieval/events closed with error
+
+Error message: undefined
+
+Sat Oct 04 2025 23:52:21 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
+
+Error message: undefined
+
+Sat Oct 04 2025 23:52:21 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
+
+Error message: undefined

package/test-data-5-1759636345925/util/logs/2025-10-05.log.txt

@@ -0,0 +1,14 @@
+
+Sat Oct 04 2025 23:52:27 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/asmail/retrieval/events closed with error
+
+Error message: undefined
+
+Sat Oct 04 2025 23:52:27 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
+
+Error message: undefined

package/test-data-6-1759636347983/util/logs/2025-10-05.log.txt

@@ -0,0 +1,14 @@
+
+Sat Oct 04 2025 23:52:30 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/asmail/retrieval/events closed with error
+
+Error message: undefined
+
+Sat Oct 04 2025 23:52:30 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
+
+Error message: undefined

package/test-data-7-1759636350156/util/logs/2025-10-05.log.txt

@@ -0,0 +1,14 @@
+
+Sat Oct 04 2025 23:52:39 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/asmail/retrieval/events closed with error
+
+Error message: undefined
+
+Sat Oct 04 2025 23:52:39 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
+
+Error message: undefined

package/test-data-8-1759636359769/util/logs/2025-10-05.log.txt

@@ -0,0 +1,14 @@
+
+Sat Oct 04 2025 23:52:44 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/asmail/retrieval/events closed with error
+
+Error message: undefined
+
+Sat Oct 04 2025 23:52:44 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
+
+Error message: undefined

package/test-data-9-1759636360774/util/logs/2025-10-05.log.txt

@@ -0,0 +1,28 @@
+
+Sat Oct 04 2025 23:52:44 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/asmail/retrieval/events closed with error
+
+Error message: undefined
+
+Sat Oct 04 2025 23:52:44 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/asmail/retrieval/events closed with error
+
+Error message: undefined
+
+Sat Oct 04 2025 23:52:44 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
+
+Error message: undefined
+
+Sat Oct 04 2025 23:52:44 GMT-0400 (Eastern Daylight Saving Time) ==================================
+Core version 0.42.1
+Log level: error.
+WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
+
+Error message: undefined

package/test-data-1-1759456500985/util/logs/2025-10-03.log.txt

@@ -1,7 +0,0 @@
-
-Thu Oct 02 2025 21:55:20 GMT-0400 (Eastern Daylight Saving Time) ==================================
-Core version 0.41.14
-Log level: error.
-WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
-
-Error message: undefined

package/test-data-11-1759456540616/util/logs/2025-10-03.log.txt

@@ -1,7 +0,0 @@
-
-Thu Oct 02 2025 21:55:44 GMT-0400 (Eastern Daylight Saving Time) ==================================
-Core version 0.41.14
-Log level: error.
-WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
-
-Error message: undefined

package/test-data-12-1759456544627/util/logs/2025-10-03.log.txt

@@ -1,7 +0,0 @@
-
-Thu Oct 02 2025 21:55:48 GMT-0400 (Eastern Daylight Saving Time) ==================================
-Core version 0.41.14
-Log level: error.
-WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
-
-Error message: undefined

package/test-data-13-1759456545560/util/logs/2025-10-03.log.txt

@@ -1,14 +0,0 @@
-
-Thu Oct 02 2025 21:55:48 GMT-0400 (Eastern Daylight Saving Time) ==================================
-Core version 0.41.14
-Log level: error.
-WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
-
-Error message: undefined
-
-Thu Oct 02 2025 21:55:48 GMT-0400 (Eastern Daylight Saving Time) ==================================
-Core version 0.41.14
-Log level: error.
-WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
-
-Error message: undefined

package/test-data-2-1759456500988/util/logs/2025-10-03.log.txt

@@ -1,7 +0,0 @@
-
-Thu Oct 02 2025 21:55:22 GMT-0400 (Eastern Daylight Saving Time) ==================================
-Core version 0.41.14
-Log level: error.
-WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
-
-Error message: undefined

package/test-data-3-1759456506409/util/logs/2025-10-03.log.txt

@@ -1,14 +0,0 @@
-
-Thu Oct 02 2025 21:55:12 GMT-0400 (Eastern Daylight Saving Time) ==================================
-Core version 0.41.14
-Log level: error.
-WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
-
-Error message: undefined
-
-Thu Oct 02 2025 21:55:12 GMT-0400 (Eastern Daylight Saving Time) ==================================
-Core version 0.41.14
-Log level: error.
-WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
-
-Error message: undefined

package/test-data-4-1759456512650/util/logs/2025-10-03.log.txt

@@ -1,14 +0,0 @@
-
-Thu Oct 02 2025 21:55:18 GMT-0400 (Eastern Daylight Saving Time) ==================================
-Core version 0.41.14
-Log level: error.
-WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
-
-Error message: undefined
-
-Thu Oct 02 2025 21:55:18 GMT-0400 (Eastern Daylight Saving Time) ==================================
-Core version 0.41.14
-Log level: error.
-WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
-
-Error message: undefined

package/test-data-5-1759456522373/util/logs/2025-10-03.log.txt

@@ -1,7 +0,0 @@
-
-Thu Oct 02 2025 21:55:24 GMT-0400 (Eastern Daylight Saving Time) ==================================
-Core version 0.41.14
-Log level: error.
-WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
-
-Error message: undefined

package/test-data-6-1759456524407/util/logs/2025-10-03.log.txt

@@ -1,7 +0,0 @@
-
-Thu Oct 02 2025 21:55:26 GMT-0400 (Eastern Daylight Saving Time) ==================================
-Core version 0.41.14
-Log level: error.
-WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
-
-Error message: undefined

package/test-data-7-1759456526517/util/logs/2025-10-03.log.txt

@@ -1,7 +0,0 @@
-
-Thu Oct 02 2025 21:55:36 GMT-0400 (Eastern Daylight Saving Time) ==================================
-Core version 0.41.14
-Log level: error.
-WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
-
-Error message: undefined

package/test-data-8-1759456536045/util/logs/2025-10-03.log.txt

@@ -1,7 +0,0 @@
-
-Thu Oct 02 2025 21:55:40 GMT-0400 (Eastern Daylight Saving Time) ==================================
-Core version 0.41.14
-Log level: error.
-WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
-
-Error message: undefined

package/test-data-9-1759456536980/util/logs/2025-10-03.log.txt

@@ -1,14 +0,0 @@
-
-Thu Oct 02 2025 21:55:40 GMT-0400 (Eastern Daylight Saving Time) ==================================
-Core version 0.41.14
-Log level: error.
-WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
-
-Error message: undefined
-
-Thu Oct 02 2025 21:55:40 GMT-0400 (Eastern Daylight Saving Time) ==================================
-Core version 0.41.14
-Log level: error.
-WebSocket to wss://localhost:8088/3nstorage/owner/events closed with error
-
-Error message: undefined