core-3nweb-client-lib 0.45.2 → 0.46.0

package/build/core/asmail/index.js

@@ -69,8 +69,8 @@ class ASMail {
             address: this.address,
             cryptor: this.cryptor,
             getSigner,
-            asmailResolver: makeResolver('asmail'),
-            midResolver: makeResolver('mailerid'),
+            asmailResolver: makeResolver('asmail', this.logger.logError),
+            midResolver: makeResolver('mailerid', this.logger.logError),
             correspondents: {
                 needIntroKeyFor: this.keyring.needIntroKeyFor,
                 generateKeysToSend: this.keyring.generateKeysToSend,
@@ -92,12 +92,12 @@ class ASMail {
             cryptor: this.cryptor,
             getSigner,
             getStorages,
-            asmailResolver: makeResolver('asmail'),
+            asmailResolver: makeResolver('asmail', this.logger.logError),
             correspondents: {
                 msgDecryptor: this.keyring.decrypt,
                 markOwnSendingParamsAsUsed: this.sendingParams.thisSide.setAsUsed,
                 saveParamsForSendingTo: this.sendingParams.otherSides.set,
-                midResolver: makeResolver('mailerid')
+                midResolver: makeResolver('mailerid', this.logger.logError)
             },
             makeNet: this.makeNet,
             logError: this.logger.logError

package/build/core/index.js

@@ -93,7 +93,7 @@ class Core {
         });
         try {
             // 1) init of id manager without setting fs
-            const stepTwo = await id_manager_1.IdManager.initWithoutStore(u.address, this.makeResolver('mailerid'), this.makeNet, this.logger.logError, this.logger.logWarning);
+            const stepTwo = await id_manager_1.IdManager.initWithoutStore(u.address, this.makeResolver('mailerid', this.logger.logError), this.makeNet, this.logger.logError, this.logger.logWarning);
             if (!stepTwo) {
                 const message = `MailerId server doesn't recognize identity ${u.address}`;
                 emitBootEvent({ message, isError: true });
@@ -111,7 +111,7 @@ class Core {
             const { idManager, setupManagerStorage } = idManagerInit;
             // 3) initialize all storages
             emitBootEvent({ message: `Setting up main storage for new user` });
-            const storesUp = await this.storages.initFreshForNewUser(u.address, idManager.getSigner, u.storeParams, u.storeSKey, this.makeNet, this.makeResolver('3nstorage'), this.logger.logError);
+            const storesUp = await this.storages.initFreshForNewUser(u.address, idManager.getSigner, u.storeParams, u.storeSKey, this.makeNet, this.makeResolver('3nstorage', this.logger.logError), this.logger.logError);
             if (!storesUp) {
                 const message = `Main store failed to initialize for new user`;
                 emitBootEvent({ message, isError: true });
@@ -141,7 +141,7 @@ class Core {
         });
         try {
             // 1) init of id manager without setting fs
-            const stepTwo = await id_manager_1.IdManager.initWithoutStore(address, this.makeResolver('mailerid'), this.makeNet, this.logger.logError, this.logger.logWarning);
+            const stepTwo = await id_manager_1.IdManager.initWithoutStore(address, this.makeResolver('mailerid', this.logger.logError), this.makeNet, this.logger.logError, this.logger.logWarning);
             if (!stepTwo) {
                 emitBootEvent({
                     isError: true, message: `MailerId server doesn't recognize identity ${address}`
@@ -163,7 +163,7 @@ class Core {
                     const { idManager, setupManagerStorage } = idManagerInit;
                     // 3) initialize all storages
                     emitBootEvent({ message: `Setting up main storage without local cache` });
-                    const storeDone = await this.storages.initFromRemote(address, idManager.getSigner, storageKey, this.makeNet, this.makeResolver('3nstorage'), this.logger.logError);
+                    const storeDone = await this.storages.initFromRemote(address, idManager.getSigner, storageKey, this.makeNet, this.makeResolver('3nstorage', this.logger.logError), this.logger.logError);
                     if (!storeDone) {
                         emitBootEvent({ message: `Main store failed to initialize`, isError: true });
                         return false;
@@ -204,7 +204,7 @@ class Core {
         });
         try {
             emitBootEvent({ message: `Unlocking data from local cache with provided password/key` });
-            const completeStorageInit = await this.storages.startInitFromCache(address, storageKey, this.makeNet, this.makeResolver('3nstorage'), this.logger.logError);
+            const completeStorageInit = await this.storages.startInitFromCache(address, storageKey, this.makeNet, this.makeResolver('3nstorage', this.logger.logError), this.logger.logError);
             if (!completeStorageInit) {
                 emitBootEvent({
                     isError: true, message: `password/key is incorrect to decrypt local caches, or caches are damaged`
@@ -212,7 +212,7 @@ class Core {
                 return false;
             }
             emitBootEvent({ message: `✔️  main storage is opened` });
-            const idManager = await id_manager_1.IdManager.initFromCachedStore(address, await this.storages.makeSyncedFSForApp(constants_1.MAILERID_APP_NAME), this.makeResolver('mailerid'), this.makeNet, this.logger.logError, this.logger.logWarning);
+            const idManager = await id_manager_1.IdManager.initFromCachedStore(address, await this.storages.makeSyncedFSForApp(constants_1.MAILERID_APP_NAME), this.makeResolver('mailerid', this.logger.logError), this.makeNet, this.logger.logError, this.logger.logWarning);
             if (!idManager) {
                 return false;
             }
@@ -319,7 +319,7 @@ class Core {
         try {
             const address = this.idManager.getId();
             const getSigner = this.idManager.getSigner;
-            const asmailServerConfig = new config_1.ConfigOfASMailServer(address, getSigner, this.makeResolver('asmail'), this.makeNet());
+            const asmailServerConfig = new config_1.ConfigOfASMailServer(address, getSigner, this.makeResolver('asmail', this.logger.logError), this.makeNet());
             emitBootEvent({ coreApp: constants_1.KEYRINGS_APP_NAME, message: `starting initialization` });
             const keyringsSyncedFS = await this.storages.makeSyncedFSForApp(constants_1.KEYRINGS_APP_NAME);
             await this.keyrings.init(keyringsSyncedFS, this.idManager.getSigner, asmailServerConfig.makeParamSetterAndGetter('init-pub-key'));

package/build/injected-globals/inject-on-node.d.ts

@@ -0,0 +1,2 @@
+import { PlatformDeviceFS } from './platform-devfs';
+export declare function makePlatformDeviceFS(): PlatformDeviceFS;

package/build/injected-globals/inject-on-node.js

@@ -0,0 +1,70 @@
+"use strict";
+/*
+ Copyright (C) 2026 3NSoft Inc.
+ 
+ This program is free software: you can redistribute it and/or modify it under
+ the terms of the GNU General Public License as published by the Free Software
+ Foundation, either version 3 of the License, or (at your option) any later
+ version.
+ 
+ This program is distributed in the hope that it will be useful, but
+ WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ See the GNU General Public License for more details.
+ 
+ You should have received a copy of the GNU General Public License along with
+ this program. If not, see <http://www.gnu.org/licenses/>.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makePlatformDeviceFS = makePlatformDeviceFS;
+const fs_1 = require("fs");
+const file_1 = require("../lib-common/exceptions/file");
+function makeFileExceptionFromNodesAndThrow(nodeExc) {
+    throw (0, file_1.makeFileExceptionFromCode)(nodeExc.code, nodeExc.path, undefined, 1);
+}
+function wrapNodeFn(nodePromisingFn) {
+    return function wrapOfNodePromisingFn(...args) {
+        return nodePromisingFn.call(undefined, ...args).catch(makeFileExceptionFromNodesAndThrow);
+    };
+}
+function makePlatformDeviceFS() {
+    return {
+        readFile: wrapNodeFn(fs_1.promises.readFile),
+        writeFile: wrapNodeFn(fs_1.promises.writeFile),
+        appendFile: wrapNodeFn(fs_1.promises.appendFile),
+        mkdir: wrapNodeFn(fs_1.promises.mkdir),
+        open: wrapNodeFn(fs_1.promises.open),
+        symlink: wrapNodeFn(fs_1.promises.symlink),
+        readlink: wrapNodeFn(fs_1.promises.readlink),
+        lstat: wrapNodeFn(fs_1.promises.lstat),
+        stat: wrapNodeFn(fs_1.promises.stat),
+        readdir: wrapNodeFn(fs_1.promises.readdir),
+        rmdir: wrapNodeFn(fs_1.promises.rmdir),
+        unlink: wrapNodeFn(fs_1.promises.unlink),
+        rename: wrapNodeFn(fs_1.promises.rename),
+        truncate: wrapNodeFn(fs_1.promises.truncate),
+        copyFile: (src, dst, overwrite = false, dstMode = '660') => {
+            return new Promise((resolve, reject) => {
+                const srcStream = (0, fs_1.createReadStream)(src);
+                const dstStream = (0, fs_1.createWriteStream)(dst, {
+                    mode: parseInt(dstMode, 8),
+                    flags: (overwrite ? 'w' : 'wx')
+                });
+                srcStream.pipe(dstStream);
+                dstStream.on('finish', () => {
+                    resolve();
+                });
+                const isRejected = false;
+                const onErr = (err) => {
+                    if (!isRejected) {
+                        reject(err);
+                        srcStream.unpipe();
+                    }
+                };
+                srcStream.on('error', onErr);
+                dstStream.on('error', onErr);
+            });
+        },
+    };
+}
+Object.freeze(exports);

package/build/injected-globals/platform-devfs.d.ts

@@ -0,0 +1,31 @@
+import type { promises as fsFns } from 'fs';
+export type { Stats } from 'fs';
+export type { FileException } from '../lib-common/exceptions/file';
+export type FileHandle = fsFns.FileHandle;
+/**
+ * This should be injected at globalThis.platform.device_fs
+ */
+export interface PlatformDeviceFS {
+    readFile: typeof fsFns['readFile'];
+    writeFile: typeof fsFns['writeFile'];
+    appendFile: typeof fsFns['appendFile'];
+    mkdir: typeof fsFns['mkdir'];
+    open: typeof fsFns['open'];
+    symlink: typeof fsFns['symlink'];
+    readlink: typeof fsFns['readlink'];
+    lstat: typeof fsFns['lstat'];
+    stat: typeof fsFns['stat'];
+    readdir: typeof fsFns['readdir'];
+    rmdir: typeof fsFns['rmdir'];
+    unlink: typeof fsFns['unlink'];
+    rename: typeof fsFns['rename'];
+    truncate: typeof fsFns['truncate'];
+    /**
+     * This pipes source file into destination file.
+     * @param src
+     * @param dst
+     * @param overwrite
+     * @return a promise, resolvable when piping completes.
+     */
+    copyFile(src: string, dst: string, overwrite?: boolean, dstMode?: string): Promise<void>;
+}

package/build/injected-globals/platform-devfs.js

@@ -0,0 +1,19 @@
+"use strict";
+/*
+ Copyright (C) 2026 3NSoft Inc.
+ 
+ This program is free software: you can redistribute it and/or modify it under
+ the terms of the GNU General Public License as published by the Free Software
+ Foundation, either version 3 of the License, or (at your option) any later
+ version.
+ 
+ This program is distributed in the hope that it will be useful, but
+ WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ See the GNU General Public License for more details.
+ 
+ You should have received a copy of the GNU General Public License along with
+ this program. If not, see <http://www.gnu.org/licenses/>.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+Object.freeze(exports);

package/build/lib-client/doh.js

@@ -19,7 +19,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.dohAt = dohAt;
 const https = require("https");
 const request_utils_1 = require("./request-utils");
-const service_locator_1 = require("./service-locator");
+const dns_1 = require("dns");
 function dohAt(dohServerUrl) {
     async function resolveTxt(domain) {
         const answer = await sendDohQuestion(dohServerUrl, domain, 'TXT');
@@ -42,27 +42,27 @@ async function sendDohQuestion(serverUrl, domain, type) {
     const reply = await (0, request_utils_1.processRequest)(opts => https.request(opts), httpsOpts, opts, undefined)
         .catch((exc) => {
         if (exc.type === 'connect') {
-            throw { code: service_locator_1.DNS_ERR_CODE.ECONNREFUSED, hostname: domain, cause: exc };
+            throw { code: dns_1.CONNREFUSED, hostname: domain, cause: exc };
         }
         else {
-            throw { code: service_locator_1.DNS_ERR_CODE.ESERVFAIL, hostname: domain, cause: exc };
+            throw { code: dns_1.SERVFAIL, hostname: domain, cause: exc };
         }
     });
     const { status, data } = reply;
     if (status !== 200) {
         throw {
-            code: service_locator_1.DNS_ERR_CODE.ESERVFAIL, hostname: domain,
+            code: dns_1.SERVFAIL, hostname: domain,
             message: `status ${reply.status} from DoH server`
         };
     }
     if (data.Status !== 0) {
-        throw { code: service_locator_1.DNS_ERR_CODE.NOTFOUND, hostname: domain };
+        throw { code: dns_1.NOTFOUND, hostname: domain };
     }
     if (data.Answer) {
         return data.Answer;
     }
     else {
-        throw { code: service_locator_1.DNS_ERR_CODE.NODATA, hostname: domain };
+        throw { code: dns_1.NODATA, hostname: domain };
     }
 }
 Object.freeze(exports);

package/build/lib-client/logging/log-to-file.js

@@ -58,6 +58,7 @@ Log level: error.${msg ? `
 ${msg}` : ''}
 ${(0, error_1.stringifyErr)(err)}`;
             await appendLog(entry, now);
+            console.error(`[duplicating log message into console] ${entry}`);
         }
         catch (err2) {
             console.error(err);

package/build/lib-client/service-checks.js

@@ -130,7 +130,7 @@ async function checkSignup(client, signupURL, signupToken) {
 const srvLocator = (0, service_locator_1.makeServiceLocator)({ resolveTxt: dns_1.promises.resolveTxt }, (0, doh_1.dohAt)(`https://cloudflare-dns.com/dns-query`), (0, doh_1.dohAt)(`https://dns.google/resolve`));
 async function checkUserDomainDNS(service, domain) {
     try {
-        const serviceUrl = await (srvLocator(service))(`u@${domain}`);
+        const serviceUrl = await (srvLocator(service, noop))(`u@${domain}`);
         return {
             service,
             isOk: true,
@@ -166,4 +166,5 @@ async function checkUserDomainDNS(service, domain) {
         };
     }
 }
+async function noop() { }
 Object.freeze(exports);

package/build/lib-client/service-locator.d.ts

@@ -2,6 +2,7 @@ import { NetClient } from './request-utils';
 import { promises as dnsPromises } from 'dns';
 import { StorageRootRoute } from '../lib-common/service-api/3nstorage/root-route';
 import { ASMailRootRoute } from '../lib-common/service-api/asmail/root-route';
+import { LogError } from './logging/log-to-file';
 type SignedLoad = web3n.keys.SignedLoad;
 /**
  * This returns a promise, resolvable to ASMailRootRoute object.
@@ -26,15 +27,8 @@ export declare function mailerIdInfoAt(client: NetClient, url: string): Promise<
  * @param url
  */
 export declare function storageInfoAt(client: NetClient, url: string): Promise<StorageRootRoute>;
-export declare const DNS_ERR_CODE: {
-    NODATA: string;
-    NOTFOUND: string;
-    ESERVFAIL: string;
-    ECONNREFUSED: string;
-    ETIMEOUT: string;
-};
 export type ServiceTypeDNSLabel = 'mailerid' | 'asmail' | '3nstorage';
-export type ServiceLocatorMaker = (serviceLabel: ServiceTypeDNSLabel) => ServiceLocator;
+export type ServiceLocatorMaker = (serviceLabel: ServiceTypeDNSLabel, logError: LogError) => ServiceLocator;
 export type ServiceLocator = (address: string) => Promise<string>;
 export interface DnsResolver {
     resolveTxt: (typeof dnsPromises)['resolveTxt'];

package/build/lib-client/service-locator.js

@@ -16,13 +16,13 @@
  this program. If not, see <http://www.gnu.org/licenses/>.
 */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DNS_ERR_CODE = void 0;
 exports.asmailInfoAt = asmailInfoAt;
 exports.mailerIdInfoAt = mailerIdInfoAt;
 exports.storageInfoAt = storageInfoAt;
 exports.makeServiceLocator = makeServiceLocator;
 exports.getMailerIdInfoFor = getMailerIdInfoFor;
 const jwkeys_1 = require("../lib-common/jwkeys");
+const dns_1 = require("dns");
 const runtime_1 = require("../lib-common/exceptions/runtime");
 const http_1 = require("../lib-common/exceptions/http");
 async function readJSONLocatedAt(client, url) {
@@ -216,22 +216,15 @@ function getRecordAtStartOf(txt) {
         value: txt
     };
 }
-exports.DNS_ERR_CODE = {
-    NODATA: 'ENODATA',
-    NOTFOUND: 'ENOTFOUND',
-    ESERVFAIL: 'ESERVFAIL',
-    ECONNREFUSED: 'ECONNREFUSED',
-    ETIMEOUT: 'ETIMEOUT'
-};
-Object.freeze(exports.DNS_ERR_CODE);
 function makeServiceLocator(...resolvers) {
     if (resolvers.length === 0) {
         throw Error(`no DNS resolvers given`);
     }
-    return serviceLabel => async (address) => {
+    return (serviceLabel, logError) => async (address) => {
         const domain = domainOfAddress(address);
         let prevConnectionExc = undefined;
-        for (const resolver of resolvers) {
+        for (let i = 0; i < resolvers.length; i += 1) {
+            const resolver = resolvers[i];
             try {
                 const txtRecords = await resolver.resolveTxt(domain);
                 const recValue = extractPair(txtRecords, serviceLabel);
@@ -242,25 +235,25 @@ function makeServiceLocator(...resolvers) {
                 return url;
             }
             catch (err) {
+                await logError(err, `Resolver ${i + 1} fails to get TXT records of ${domain}`);
                 const { code, hostname, message } = err;
-                if (code === exports.DNS_ERR_CODE.NODATA) {
+                if (code === dns_1.NODATA) {
                     throw noServiceRecordExc(address);
                 }
-                else if ((code === exports.DNS_ERR_CODE.ESERVFAIL)
-                    || (code === exports.DNS_ERR_CODE.ECONNREFUSED)
-                    || (code === exports.DNS_ERR_CODE.ETIMEOUT)) {
+                else if ((code === dns_1.SERVFAIL)
+                    || (code === dns_1.CONNREFUSED)
+                    || (code === dns_1.TIMEOUT)) {
                     if (!prevConnectionExc) {
                         prevConnectionExc = noConnectionExc({ code, hostname, message });
                     }
                 }
-                else if ((code === exports.DNS_ERR_CODE.NOTFOUND) || hostname) {
+                else if ((code === dns_1.NOTFOUND) || hostname) {
                     throw domainNotFoundExc(address, { code, hostname, message });
                 }
                 else {
                     if (!prevConnectionExc) {
                         prevConnectionExc = err;
                     }
-                    throw err;
                 }
             }
         }

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

@@ -1,22 +1,11 @@
-import * as fs from 'fs';
 import { Readable, Writable } from 'stream';
-export type { Stats } from 'fs';
-export type { FileException } from './exceptions/file';
-export type FileHandle = fs.promises.FileHandle;
-export declare const readFile: typeof fs.promises.readFile;
-export declare const writeFile: typeof fs.promises.writeFile;
-export declare const appendFile: typeof fs.promises.appendFile;
-export declare const mkdir: typeof fs.promises.mkdir;
-export declare const open: typeof fs.promises.open;
-export declare const symlink: typeof fs.promises.symlink;
-export declare const readlink: typeof fs.promises.readlink;
-export declare const lstat: typeof fs.promises.lstat;
-export declare const stat: typeof fs.promises.stat;
-export declare const readdir: typeof fs.promises.readdir;
-export declare const rmdir: typeof fs.promises.rmdir;
-export declare const unlink: typeof fs.promises.unlink;
-export declare const rename: typeof fs.promises.rename;
-export declare const truncate: typeof fs.promises.truncate;
+import type { FileHandle } from '../injected-globals/platform-devfs';
+export type { FileHandle, FileException, Stats } from '../injected-globals/platform-devfs';
+/**
+ * fs functions follow node's type, and are injected via global object to allow injection in
+ * non-node environments, like Android or browser.
+ */
+export declare const appendFile: typeof import("fs/promises").appendFile, lstat: typeof import("fs/promises").lstat, mkdir: typeof import("fs/promises").mkdir, open: typeof import("fs/promises").open, readFile: typeof import("fs/promises").readFile, readdir: typeof import("fs/promises").readdir, readlink: typeof import("fs/promises").readlink, rename: typeof import("fs/promises").rename, rmdir: typeof import("fs/promises").rmdir, stat: typeof import("fs/promises").stat, symlink: typeof import("fs/promises").symlink, truncate: typeof import("fs/promises").truncate, unlink: typeof import("fs/promises").unlink, writeFile: typeof import("fs/promises").writeFile, copyFile: (src: string, dst: string, overwrite?: boolean, dstMode?: string) => Promise<void>;
 /**
  * @param fh is an open file handle
  * @param pos is a position in the file, from which reading should start
@@ -53,16 +42,6 @@ export declare function createEmptyFile(filePath: string, fileSize: number, keep
  * or false, if it does not.
  */
 export declare function existsFolder(path: string): Promise<boolean>;
-/**
- * @param path
- * @return true, if given path represents directory, or false, if it does not.
- */
-export declare function existsFolderSync(path: string): boolean;
-/**
- * @param path
- * @return true, if given path represents file, or false, if it does not.
- */
-export declare function existsFileSync(path: string): boolean;
 /**
  * @param filePath
  * @return a promise, resolvable to file's size.
@@ -126,26 +105,6 @@ export declare function rmDirWithContent(folder: string): Promise<void>;
  * sink completes.
  */
 export declare function streamFromFile(filePath: string, pos: number, len: number, sink: Writable, bufSize: number): Promise<void>;
-/**
- * This pipes source file into destination file.
- * @param src
- * @param dst
- * @param overwrite
- * @return a promise, resolvable when piping completes.
- */
-export declare function copyFile(src: string, dst: string, overwrite?: boolean, dstMode?: string): Promise<void>;
-/**
- * This copies tree of files from source to destination folders.
- * Target folders may exist in a destination tree.
- * Objects that are neither files, nor folders, are ignored.
- * @param src
- * @param dst
- * @param fileOverwrite when set to true, allows to overwrite files in a
- * destination tree. Otherwise, exception is thrown on already existing files.
- * @return a promise resolvable when the whole tree is copied from source to
- * destination.
- */
-export declare function copyTree(src: string, dst: string, fileOverwrite?: boolean): Promise<void>;
 /**
  * This function checks that given folder exists. If folder is not present,
  * it is created, recreating whole folder tree, if needed.

package/build/lib-common/async-fs-node.js

@@ -15,14 +15,13 @@
  You should have received a copy of the GNU General Public License along with
  this program. If not, see <http://www.gnu.org/licenses/>.
 */
+var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.truncate = exports.rename = exports.unlink = exports.rmdir = exports.readdir = exports.stat = exports.lstat = exports.readlink = exports.symlink = exports.open = exports.mkdir = exports.appendFile = exports.writeFile = exports.readFile = void 0;
+exports.copyFile = exports.writeFile = exports.unlink = exports.truncate = exports.symlink = exports.stat = exports.rmdir = exports.rename = exports.readlink = exports.readdir = exports.readFile = exports.open = exports.mkdir = exports.lstat = exports.appendFile = void 0;
 exports.readToBuf = readToBuf;
 exports.writeFromBuf = writeFromBuf;
 exports.createEmptyFile = createEmptyFile;
 exports.existsFolder = existsFolder;
-exports.existsFolderSync = existsFolderSync;
-exports.existsFileSync = existsFileSync;
 exports.getFileSize = getFileSize;
 exports.getFolderContentSize = getFolderContentSize;
 exports.write = write;
@@ -31,40 +30,18 @@ exports.streamToExistingFile = streamToExistingFile;
 exports.read = read;
 exports.rmDirWithContent = rmDirWithContent;
 exports.streamFromFile = streamFromFile;
-exports.copyFile = copyFile;
-exports.copyTree = copyTree;
 exports.ensureFolderExists = ensureFolderExists;
-const fs = require("fs");
-const fs_1 = require("fs");
 const file_1 = require("./exceptions/file");
 const synced_1 = require("./processes/synced");
 const deferred_1 = require("./processes/deferred");
 const bytes_fifo_buffer_1 = require("./byte-streaming/bytes-fifo-buffer");
 const buffer_utils_1 = require("./buffer-utils");
-const path_1 = require("path");
-function makeFileExceptionFromNodesAndThrow(nodeExc) {
-    throw (0, file_1.makeFileExceptionFromCode)(nodeExc.code, nodeExc.path, undefined, 1);
-}
-function wrapNodeFn(nodePromisingFn) {
-    return function wrapOfNodePromisingFn(...args) {
-        return nodePromisingFn.call(undefined, ...args).catch(makeFileExceptionFromNodesAndThrow);
-    };
-}
 function noop() { }
-exports.readFile = wrapNodeFn(fs.promises.readFile);
-exports.writeFile = wrapNodeFn(fs.promises.writeFile);
-exports.appendFile = wrapNodeFn(fs.promises.appendFile);
-exports.mkdir = wrapNodeFn(fs.promises.mkdir);
-exports.open = wrapNodeFn(fs.promises.open);
-exports.symlink = wrapNodeFn(fs.promises.symlink);
-exports.readlink = wrapNodeFn(fs.promises.readlink);
-exports.lstat = wrapNodeFn(fs.promises.lstat);
-exports.stat = wrapNodeFn(fs.promises.stat);
-exports.readdir = wrapNodeFn(fs.promises.readdir);
-exports.rmdir = wrapNodeFn(fs.promises.rmdir);
-exports.unlink = wrapNodeFn(fs.promises.unlink);
-exports.rename = wrapNodeFn(fs.promises.rename);
-exports.truncate = wrapNodeFn(fs.promises.truncate);
+/**
+ * fs functions follow node's type, and are injected via global object to allow injection in
+ * non-node environments, like Android or browser.
+ */
+_a = globalThis.platform.device_fs, exports.appendFile = _a.appendFile, exports.lstat = _a.lstat, exports.mkdir = _a.mkdir, exports.open = _a.open, exports.readFile = _a.readFile, exports.readdir = _a.readdir, exports.readlink = _a.readlink, exports.rename = _a.rename, exports.rmdir = _a.rmdir, exports.stat = _a.stat, exports.symlink = _a.symlink, exports.truncate = _a.truncate, exports.unlink = _a.unlink, exports.writeFile = _a.writeFile, exports.copyFile = _a.copyFile;
 /**
  * @param fh is an open file handle
  * @param pos is a position in the file, from which reading should start
@@ -164,46 +141,6 @@ async function existsFolder(path) {
         throw e;
     }
 }
-/**
- * @param path
- * @return true, if given path represents directory, or false, if it does not.
- */
-function existsFolderSync(path) {
-    try {
-        if ((0, fs_1.statSync)(path).isDirectory()) {
-            return true;
-        }
-        else {
-            throw (0, file_1.makeFileException)('notDirectory', path);
-        }
-    }
-    catch (e) {
-        if (e.code === file_1.Code.notFound) {
-            return false;
-        }
-        throw e;
-    }
-}
-/**
- * @param path
- * @return true, if given path represents file, or false, if it does not.
- */
-function existsFileSync(path) {
-    try {
-        if ((0, fs_1.statSync)(path).isFile()) {
-            return true;
-        }
-        else {
-            throw (0, file_1.makeFileException)('notFile', path);
-        }
-    }
-    catch (e) {
-        if (e.code === file_1.Code.notFound) {
-            return false;
-        }
-        throw e;
-    }
-}
 /**
  * @param filePath
  * @return a promise, resolvable to file's size.
@@ -485,73 +422,6 @@ async function streamFromFile(filePath, pos, len, sink, bufSize) {
         byteCount += buf.length;
     }
 }
-/**
- * This pipes source file into destination file.
- * @param src
- * @param dst
- * @param overwrite
- * @return a promise, resolvable when piping completes.
- */
-function copyFile(src, dst, overwrite = false, dstMode = '660') {
-    return new Promise((resolve, reject) => {
-        const srcStream = (0, fs_1.createReadStream)(src);
-        const dstStream = (0, fs_1.createWriteStream)(dst, {
-            mode: parseInt(dstMode, 8),
-            flags: (overwrite ? 'w' : 'wx')
-        });
-        srcStream.pipe(dstStream);
-        dstStream.on('finish', () => {
-            resolve();
-        });
-        const isRejected = false;
-        const onErr = (err) => {
-            if (!isRejected) {
-                reject(err);
-                srcStream.unpipe();
-            }
-        };
-        srcStream.on('error', onErr);
-        dstStream.on('error', onErr);
-    });
-}
-/**
- * This copies tree of files from source to destination folders.
- * Target folders may exist in a destination tree.
- * Objects that are neither files, nor folders, are ignored.
- * @param src
- * @param dst
- * @param fileOverwrite when set to true, allows to overwrite files in a
- * destination tree. Otherwise, exception is thrown on already existing files.
- * @return a promise resolvable when the whole tree is copied from source to
- * destination.
- */
-async function copyTree(src, dst, fileOverwrite = false) {
-    // destination folder, non-exclusively
-    await (0, exports.mkdir)(dst, { recursive: true })
-        .catch(async (exc) => {
-        if (!exc.alreadyExists) {
-            throw exc;
-        }
-    });
-    // copy files and folders from src folder
-    const srcFNames = await (0, exports.readdir)(src);
-    const cpTasks = [];
-    for (const fName of srcFNames) {
-        const srcPath = (0, path_1.join)(src, fName);
-        const dstPath = (0, path_1.join)(dst, fName);
-        const task = (0, exports.stat)(srcPath)
-            .then((stats) => {
-            if (stats.isFile()) {
-                return copyFile(srcPath, dstPath, fileOverwrite);
-            }
-            else if (stats.isDirectory()) {
-                return copyTree(srcPath, dstPath, fileOverwrite);
-            }
-        });
-        cpTasks.push(task);
-    }
-    await Promise.all(cpTasks);
-}
 /**
  * This function checks that given folder exists. If folder is not present,
  * it is created, recreating whole folder tree, if needed.

package/build/lib-index.d.ts

@@ -14,3 +14,4 @@ export { makeLogger } from './lib-client/logging/log-to-file';
 export declare const SYSTEM_DOMAIN = "3nweb.computer";
 export { checkServicesStartingFromSignup } from './lib-client/service-checks';
 export { dohAt } from './lib-client/doh';
+export * as injectOnNode from './injected-globals/inject-on-node';

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.dohAt = exports.checkServicesStartingFromSignup = exports.SYSTEM_DOMAIN = 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;
+exports.injectOnNode = exports.dohAt = exports.checkServicesStartingFromSignup = exports.SYSTEM_DOMAIN = 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; } });
@@ -60,4 +60,5 @@ var service_checks_1 = require("./lib-client/service-checks");
 Object.defineProperty(exports, "checkServicesStartingFromSignup", { enumerable: true, get: function () { return service_checks_1.checkServicesStartingFromSignup; } });
 var doh_1 = require("./lib-client/doh");
 Object.defineProperty(exports, "dohAt", { enumerable: true, get: function () { return doh_1.dohAt; } });
+exports.injectOnNode = require("./injected-globals/inject-on-node");
 Object.freeze(exports);

package/build/tests/jasmine.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2016, 2020 - 2022, 2025 3NSoft Inc.
+ Copyright (C) 2016, 2020 - 2022, 2025 - 2026 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
@@ -17,6 +17,11 @@
 */
 Object.defineProperty(exports, "__esModule", { value: true });
 const jasmine = require("jasmine");
+const inject_on_node_1 = require("../injected-globals/inject-on-node");
+// injecting global's expected to be on node
+globalThis.platform = {
+    device_fs: (0, inject_on_node_1.makePlatformDeviceFS)()
+};
 const jas = new jasmine({});
 const specsFromCLI = [];
 for (let i = 2; i < process.argv.length; i += 1) {

package/build/tests/units/obj-folders.js

@@ -60,7 +60,7 @@ describe('ObjFolders without timed generations', () => {
         await (0, async_fs_node_1.rmDirWithContent)(TEST_DATA);
     });
     (0, jasmine_utils_1.itCond)(`static folder content`, async () => {
-        expect((0, async_fs_node_1.existsFolderSync)((0, path_1.join)(TEST_DATA, ACCESS_DIR))).toBeTrue();
+        expect(await (0, async_fs_node_1.existsFolder)((0, path_1.join)(TEST_DATA, ACCESS_DIR))).toBeTrue();
         const cfg = await readJSONFile((0, path_1.join)(TEST_DATA, CONFIG_FILE));
         expect(cfg.charsInSplit).withContext('default config value').toBe(charsInSplit);
         expect(cfg.numOfSplits).withContext('default config value').toBe(numOfSplits);
@@ -68,13 +68,13 @@ describe('ObjFolders without timed generations', () => {
     (0, jasmine_utils_1.itCond)(`null id for root object`, async () => {
         const rootObjPath = (0, path_1.join)(objsDir, ROOT_OBJ_DIR);
         // behaviour with missing obj folder and no creation
-        expect((0, async_fs_node_1.existsFolderSync)(rootObjPath)).not.toBeTrue();
+        expect(await (0, async_fs_node_1.existsFolder)(rootObjPath)).not.toBeTrue();
         let folderPath = await folders.getFolderAccessFor(null);
         expect(folderPath).withContext(`obj folder not present, and is not created`).toBeUndefined();
-        expect((0, async_fs_node_1.existsFolderSync)(rootObjPath)).not.toBeTrue();
+        expect(await (0, async_fs_node_1.existsFolder)(rootObjPath)).not.toBeTrue();
         folderPath = await folders.getFolderAccessFor(null, true);
         expect(folderPath).toBe(rootObjPath);
-        expect((0, async_fs_node_1.existsFolderSync)(folderPath)).toBeTrue();
+        expect(await (0, async_fs_node_1.existsFolder)(folderPath)).toBeTrue();
         await writeFilesTo(folderPath, 4);
         // behaviour with exiting obj folder
         let existingPath = await folders.getFolderAccessFor(null);
@@ -95,11 +95,11 @@ describe('ObjFolders without timed generations', () => {
         const sameThirdIdPart = idA.slice(charsInSplit * 2, charsInSplit * 3);
         const fstDepthCount = await numOfItemsIn(objsDir);
         // behaviour with missing obj folder and no creation
-        expect((0, async_fs_node_1.existsFolderSync)((0, path_1.join)(objsDir, sameFstIdPart))).not.toBeTrue();
+        expect(await (0, async_fs_node_1.existsFolder)((0, path_1.join)(objsDir, sameFstIdPart))).not.toBeTrue();
         let folderA = await folders.getFolderAccessFor(idA);
         expect(folderA).withContext(`obj folder not present, and is not created`).toBeUndefined();
         folderA = await folders.getFolderAccessFor(idA, true);
-        expect((0, async_fs_node_1.existsFolderSync)(folderA)).toBeTrue();
+        expect(await (0, async_fs_node_1.existsFolder)(folderA)).toBeTrue();
         expect((0, path_1.basename)(folderA)).toBe(idA.slice(numOfSplits * charsInSplit));
         const threeLevelsDown = (0, path_1.join)(objsDir, sameFstIdPart, sameSndIdPart, sameThirdIdPart);
         expect(await numOfItemsIn(threeLevelsDown)).toBe(1);
@@ -110,18 +110,18 @@ describe('ObjFolders without timed generations', () => {
         existingPath = await folders.getFolderAccessFor(idA);
         expect(existingPath).toBe(folderA);
         expect(await numOfItemsIn(objsDir)).toBe(fstDepthCount + 1);
-        expect((0, async_fs_node_1.existsFolderSync)((0, path_1.join)(objsDir, sameFstIdPart))).toBeTrue();
+        expect(await (0, async_fs_node_1.existsFolder)((0, path_1.join)(objsDir, sameFstIdPart))).toBeTrue();
         const twoLevelsDown = (0, path_1.join)(objsDir, sameFstIdPart, sameSndIdPart);
         const thirdDepthCount = await numOfItemsIn(twoLevelsDown);
         const folderB = await folders.getFolderAccessFor(idB, true);
-        expect((0, async_fs_node_1.existsFolderSync)(folderB)).toBeTrue();
+        expect(await (0, async_fs_node_1.existsFolder)(folderB)).toBeTrue();
         expect((0, path_1.basename)(folderB)).toBe(idB.slice(numOfSplits * charsInSplit));
         expect(await numOfItemsIn(objsDir)).toBe(fstDepthCount + 1);
         expect(await numOfItemsIn(twoLevelsDown)).toBe(thirdDepthCount);
         expect(await numOfItemsIn(threeLevelsDown)).toBe(2);
         await writeFilesTo(folderB, 4);
         const folderC = await folders.getFolderAccessFor(idC, true);
-        expect((0, async_fs_node_1.existsFolderSync)(folderC)).toBeTrue();
+        expect(await (0, async_fs_node_1.existsFolder)(folderC)).toBeTrue();
         expect((0, path_1.basename)(folderC)).toBe(idC.slice(numOfSplits * charsInSplit));
         expect(await numOfItemsIn(objsDir)).toBe(fstDepthCount + 1);
         expect(await numOfItemsIn(twoLevelsDown)).toBe(thirdDepthCount + 1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "core-3nweb-client-lib",
-  "version": "0.45.2",
+  "version": "0.46.0",
   "description": "3NWeb client core library, embeddable into different environments",
   "main": "build/lib-index.js",
   "types": "build/lib-index.d.ts",
@@ -44,7 +44,7 @@
   },
   "devDependencies": {
     "@types/jasmine": "^5.1.13",
-    "@types/node": "^22.13.14",
+    "@types/node": "^24.1.0",
     "@types/punycode": "^2.1.1",
     "@types/ws": "^8.18.1",
     "jasmine": "^5.13.0",