core-3nweb-client-lib 0.44.7 → 0.44.9

package/build/lib-client/local-files/dev-file-src.js

@@ -13,7 +13,8 @@
  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.DevFileByteSource = void 0;
 const fs = require("../../lib-common/async-fs-node");
@@ -38,9 +39,9 @@ class DevFileByteSource {
         if (this.offset >= this.size) {
             return;
         }
-        let fd = undefined;
+        let fh = undefined;
         try {
-            fd = await fs.open(this.path, 'r');
+            fh = await fs.open(this.path, 'r');
             let buf;
             if (typeof len === 'number') {
                 len = Math.min(this.size - this.offset, len);
@@ -49,7 +50,7 @@ class DevFileByteSource {
             else {
                 buf = Buffer.allocUnsafe(this.size - this.offset);
             }
-            await fs.readToBuf(fd, this.offset, buf);
+            await fs.readToBuf(fh, this.offset, buf);
             this.offset += buf.length;
             return buf;
         }
@@ -57,8 +58,8 @@ class DevFileByteSource {
             throw (0, file_1.maskPathInExc)(this.pathPrefixMaskLen, e);
         }
         finally {
-            if (fd !== undefined) {
-                await fs.close(fd);
+            if (fh !== undefined) {
+                await fh.close();
             }
         }
     }

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

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2018, 2020, 2022 3NSoft Inc.
+ Copyright (C) 2015 - 2018, 2020, 2022, 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
@@ -335,15 +335,15 @@ class DeviceFS {
     }
     async readBytes(path, start, end) {
         if ((typeof start === 'number') && (start < 0)) {
-            throw new Error(`Parameter start has bad value: ${start}`);
+            throw new RangeError(`Parameter start has bad value: ${start}`);
         }
         if ((typeof end === 'number') && (end < 0)) {
-            throw new Error(`Parameter end has bad value: ${end}`);
+            throw new RangeError(`Parameter end has bad value: ${end}`);
         }
-        let fd = undefined;
+        let fh = undefined;
         try {
-            fd = await fs.open(this.fullPath(path), 'r');
-            const size = (await fs.fstat(fd)).size;
+            fh = await fs.open(this.fullPath(path), 'r');
+            const size = (await fh.stat()).size;
             if (size === 0) {
                 return;
             }
@@ -358,22 +358,22 @@ class DeviceFS {
                 return;
             }
             const bytes = Buffer.allocUnsafe(end - start);
-            await fs.readToBuf(fd, start, bytes);
+            await fs.readToBuf(fh, start, bytes);
             return bytes;
         }
         catch (e) {
             throw (0, file_1.maskPathInExc)(this.root.length, e);
         }
         finally {
-            if (fd !== undefined) {
-                await fs.close(fd);
+            if (fh !== undefined) {
+                await fh.close();
             }
         }
     }
     async getByteSink(path, flags = WRITE_NONEXCL_FLAGS) {
         const pathSections = splitPathIntoParts(path);
         const pathStr = this.fullPath(path);
-        let fd = undefined;
+        let fh = undefined;
         try {
             if (flags.create) {
                 if (pathSections.length > 1) {
@@ -381,10 +381,10 @@ class DeviceFS {
                     await this.makeFolder(enclosingFolder);
                 }
                 if (flags.exclusive) {
-                    fd = await fs.open(pathStr, 'wx');
+                    fh = await fs.open(pathStr, 'wx');
                 }
                 else {
-                    fd = await fs.open(pathStr, flags.truncate ? 'w' : 'r+')
+                    fh = await fs.open(pathStr, flags.truncate ? 'w' : 'r+')
                         .catch((exc) => {
                         if (exc.notFound) {
                             return fs.open(pathStr, 'w');
@@ -396,17 +396,17 @@ class DeviceFS {
                 }
             }
             else {
-                fd = await fs.open(pathStr, flags.truncate ? 'w' : 'r+');
+                fh = await fs.open(pathStr, flags.truncate ? 'w' : 'r+');
             }
-            const stats = await fs.fstat(fd);
+            const stats = await fh.stat();
             return dev_file_sink_1.DevFileByteSink.make(pathStr, this.root.length, stats);
         }
         catch (e) {
             throw (0, file_1.maskPathInExc)(this.root.length, e);
         }
         finally {
-            if (fd !== undefined) {
-                await fs.close(fd);
+            if (fh !== undefined) {
+                await fh.close();
             }
         }
     }
@@ -427,27 +427,27 @@ class DeviceFS {
     async writeBytes(path, bytes, flags = WRITE_NONEXCL_FLAGS) {
         const pathSections = splitPathIntoParts(path);
         const pathStr = this.fullPath(path);
-        let fd = undefined;
+        let fh = undefined;
         try {
             if (flags.create) {
                 if (pathSections.length > 1) {
                     const enclosingFolder = pathSections.slice(0, pathSections.length - 1).join('/');
                     await this.makeFolder(enclosingFolder);
                 }
-                fd = await fs.open(pathStr, (flags.exclusive ? 'wx' : 'w'));
+                fh = await fs.open(pathStr, (flags.exclusive ? 'wx' : 'w'));
             }
             else {
-                fd = await fs.open(pathStr, 'r+');
-                await fs.ftruncate(fd, 0);
+                fh = await fs.open(pathStr, 'r+');
+                await fh.truncate(0);
             }
-            await fs.writeFromBuf(fd, 0, (0, buffer_utils_1.toBuffer)(bytes));
+            await fs.writeFromBuf(fh, 0, (0, buffer_utils_1.toBuffer)(bytes));
         }
         catch (e) {
             throw (0, file_1.maskPathInExc)(this.root.length, e);
         }
         finally {
-            if (fd !== undefined) {
-                await fs.close(fd);
+            if (fh !== undefined) {
+                await fh.close();
             }
         }
     }

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

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2016 - 2020, 2022 3NSoft Inc.
+ Copyright (C) 2016 - 2020, 2022, 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
@@ -25,12 +25,14 @@ const xsp_files_1 = require("xsp-files");
 const assert_1 = require("../../lib-common/assert");
 const error_1 = require("../../lib-common/exceptions/error");
 const path_1 = require("path");
+const runtime_1 = require("../../lib-common/exceptions/runtime");
 function makeNotFoundExc(msg) {
     return {
         runtimeException: true,
         type: 'cache',
         cause: msg,
-        notFound: true
+        notFound: true,
+        stack: (0, runtime_1.getStackHere)(1)
     };
 }
 function makeAlreadyExistExc(msg) {
@@ -38,7 +40,8 @@ function makeAlreadyExistExc(msg) {
         runtimeException: true,
         type: 'cache',
         cause: msg,
-        alreadyExist: true
+        alreadyExist: true,
+        stack: (0, runtime_1.getStackHere)(1)
     };
 }
 function alreadyExistsOrReThrow(exc) {

package/build/lib-client/request-utils.d.ts

@@ -51,5 +51,6 @@ export interface NetClient {
      * @param opts
      */
     doBodylessRequest<T>(opts: RequestOpts): Promise<Reply<T>>;
+    reset(): void;
 }
-export declare function makeNetClient(request?: RequestFn<unknown>): NetClient;
+export declare function makeNetClient(request?: RequestFn<unknown>, reset?: () => void): NetClient;

package/build/lib-client/request-utils.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2018, 2020, 2025 3NSoft Inc.
+ Copyright (C) 2015 - 2018, 2020, 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
@@ -23,7 +23,6 @@ exports.makeNetClient = makeNetClient;
 const http_1 = require("../lib-common/exceptions/http");
 const bytes_fifo_buffer_1 = require("../lib-common/byte-streaming/bytes-fifo-buffer");
 const https = require("https");
-const url_1 = require("url");
 const rxjs_1 = require("rxjs");
 const buffer_utils_1 = require("../lib-common/buffer-utils");
 const deferred_1 = require("../lib-common/processes/deferred");
@@ -54,13 +53,13 @@ function formHttpsReqOpts(opts, contentType, reqBody) {
     if (reqBody && (opts.method !== 'POST') && (opts.method !== 'PUT')) {
         throw new Error(`Cannot have body in ${opts.method} request.`);
     }
-    const url = (0, url_1.parse)(opts.url);
+    const url = new URL(opts.url);
     const netReqOpts = {
         protocol: url.protocol,
         method: opts.method,
         hostname: url.hostname,
         port: url.port,
-        path: url.path,
+        path: url.pathname + url.search,
         headers: {}
     };
     if (reqBody) {
@@ -147,8 +146,7 @@ function formReply(res, resBody, reqOpts) {
         status,
         data,
         headers: (reqOpts.responseHeaders ?
-            makeHeaders(filterHeaders(res.headers, reqOpts.responseHeaders)) :
-            undefined)
+            makeHeaders(filterHeaders(res.headers, reqOpts.responseHeaders)) : undefined)
     };
     return rep;
 }
@@ -171,14 +169,6 @@ function makeHeaders(headers) {
         }
     };
 }
-// /**
-//  * @param rep
-//  * @param errMsg
-//  * @return http exception based on given reply, with an optional message
-//  */
-// export function makeException(rep: Reply<any>, message?: string): HTTPException {
-// 	return makeHTTPException(rep.url, rep.method, rep.status, { message });
-// }
 function extractIntHeader(rep, headerName) {
     const intHeader = parseInt(rep.headers.get(headerName));
     if (isNaN(intHeader)) {
@@ -195,7 +185,7 @@ function makeNodeRequest() {
         return processRequest(nodeRequest, httpsOpts, opts, reqBody);
     };
 }
-function makeNetClient(request = makeNodeRequest()) {
+function makeNetClient(request = makeNodeRequest(), reset = () => { }) {
     const client = {
         doBinaryRequest(opts, bytes) {
             let reqBody;
@@ -215,11 +205,10 @@ function makeNetClient(request = makeNodeRequest()) {
             return request(opts);
         },
         doJsonRequest(opts, json) {
-            const reqBody = ((json === undefined) ?
-                new Uint8Array(0) :
-                buffer_utils_1.utf8.pack(JSON.stringify(json)));
+            const reqBody = ((json === undefined) ? new Uint8Array(0) : buffer_utils_1.utf8.pack(JSON.stringify(json)));
             return request(opts, 'application/json', reqBody);
-        }
+        },
+        reset
     };
     return Object.freeze(client);
 }

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

@@ -5,6 +5,7 @@
 import { Reply, RequestOpts, NetClient } from '../lib-client/request-utils';
 import * as WebSocket from 'ws';
 import { MailerIdSigner } from '../lib-common/mailerid-sigs/user';
+import { AwaitableState } from '../lib-common/awaitable-state';
 export type IGetMailerIdSigner = () => Promise<MailerIdSigner>;
 export interface ServiceAccessParams {
     login: string;
@@ -22,6 +23,7 @@ export declare abstract class ServiceUser {
     private loginUrlPart;
     private logoutUrlEnd;
     private get loginUrl();
+    readonly connectedState: AwaitableState;
     private redirectedFrom;
     private canBeRedirected;
     private sessionId;

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

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015, 2017, 2020, 2022, 2025 3NSoft Inc.
+ Copyright (C) 2015, 2017, 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
@@ -19,16 +19,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ServiceUser = void 0;
 const api = require("../lib-common/service-api/mailer-id/login");
 const ws_utils_1 = require("./ws-utils");
-const url_1 = require("url");
 const login_1 = require("./mailer-id/login");
 const assert_1 = require("../lib-common/assert");
 const http_1 = require("../lib-common/exceptions/http");
+const awaitable_state_1 = require("../lib-common/awaitable-state");
 class ServiceUser {
     get serviceURI() {
         return this.uri;
     }
     set serviceURI(uriString) {
-        const u = (0, url_1.parse)(uriString);
+        const u = new URL(uriString);
         if (u.protocol !== 'https:') {
             throw new Error("Url protocol must be https.");
         }
@@ -49,12 +49,12 @@ class ServiceUser {
         this.getInitServiceURI = getInitServiceURI;
         this.net = net;
         this.uri = undefined;
+        this.connectedState = new awaitable_state_1.AwaitableState();
         this.redirectedFrom = undefined;
         this.sessionId = undefined;
         this.loginProc = undefined;
         this.loginUrlPart = accessParams.login;
-        if ((this.loginUrlPart.length > 0)
-            && (this.loginUrlPart[this.loginUrlPart.length - 1] !== '/')) {
+        if ((this.loginUrlPart.length > 0) && !this.loginUrlPart.endsWith('/')) {
             this.loginUrlPart += '/';
         }
         this.logoutUrlEnd = accessParams.logout;
@@ -162,31 +162,42 @@ class ServiceUser {
         }
     }
     async callEnsuringLogin(func) {
-        if (this.loginProc || !this.sessionId) {
-            await this.login();
-            return func();
-        }
-        else {
-            // first attepmt
-            const initSessionId = this.sessionId;
-            const rep = await func();
-            if (rep.status !== api.ERR_SC.needAuth) {
-                return rep;
+        try {
+            let reply;
+            if (this.loginProc || !this.sessionId) {
+                await this.login();
+                reply = await func();
+            }
+            else {
+                // first attepmt
+                const initSessionId = this.sessionId;
+                const rep = await func();
+                if (rep.status !== api.ERR_SC.needAuth) {
+                    return rep;
+                }
+                // if auth is needed, do login and a second attempt
+                if (this.sessionId === initSessionId) {
+                    this.sessionId = undefined;
+                }
+                await this.login();
+                reply = await func();
             }
-            // if auth is needed, do login and a second attempt
-            if (this.sessionId === initSessionId) {
-                this.sessionId = undefined;
+            this.connectedState.setState();
+            return reply;
+        }
+        catch (exc) {
+            if (exc.type === 'connect') {
+                this.net.reset();
+                this.connectedState.clearState();
             }
-            await this.login();
-            return func();
+            throw exc;
         }
     }
     prepCallOpts(opts, isWS) {
         opts.sessionId = this.sessionId;
         if (opts.appPath) {
             opts.url = (isWS ?
-                `wss${this.serviceURI.substring(5)}${opts.appPath}` :
-                `${this.serviceURI}${opts.appPath}`);
+                `wss${this.serviceURI.substring(5)}${opts.appPath}` : `${this.serviceURI}${opts.appPath}`);
         }
         else if (!opts.url) {
             throw new Error(`Missing both appPath and ready url in request options.`);

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

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2020, 2022 3NSoft Inc.
+ Copyright (C) 2020, 2022, 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
@@ -20,6 +20,7 @@ exports.XAttrs = exports.CommonAttrs = void 0;
 const assert_1 = require("../../lib-common/assert");
 const buffer_utils_1 = require("../../lib-common/buffer-utils");
 const big_endian_1 = require("../../lib-common/big-endian");
+const runtime_1 = require("../../lib-common/exceptions/runtime");
 class CommonAttrs {
     constructor(ctime, mtime) {
         this.ctime = ctime;
@@ -309,7 +310,8 @@ function parsingException(msg, cause) {
     return {
         runtimeException: true,
         type: 'attrs-parsing',
-        cause, msg
+        cause, msg,
+        stack: (0, runtime_1.getStackHere)(1)
     };
 }
 Object.freeze(exports);

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

@@ -25,16 +25,16 @@ exports.makeUnknownTransactionExc = makeUnknownTransactionExc;
 exports.makeVersionMismatchExc = makeVersionMismatchExc;
 exports.makeStorageIsClosedExc = makeStorageIsClosedExc;
 exports.makeFSSyncException = makeFSSyncException;
+const runtime_1 = require("../../lib-common/exceptions/runtime");
 function makeStorageException(fields) {
     const exc = {
         runtimeException: true,
-        type: 'storage'
+        type: 'storage',
+        stack: (0, runtime_1.getStackHere)(1)
     };
     for (const [key, value] of Object.entries(fields)) {
         exc[key] = value;
     }
-    const err = new Error(`runtime exception stack`);
-    exc['stack'] = err.stack;
     return exc;
 }
 function makeObjNotFoundExc(objId, remoteStorage) {
@@ -74,7 +74,8 @@ function makeFSSyncException(path, fields) {
     const exc = {
         runtimeException: true,
         type: 'fs-sync',
-        path
+        path,
+        stack: (0, runtime_1.getStackHere)(1)
     };
     for (const [key, value] of Object.entries(fields)) {
         exc[key] = value;

package/build/lib-client/xsp-fs/folder-node-serialization.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2017, 2022 3NSoft Inc.
+ Copyright (C) 2017, 2022, 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
@@ -22,6 +22,7 @@ const buffer_utils_1 = require("../../lib-common/buffer-utils");
 const xsp_files_1 = require("xsp-files");
 const big_endian_1 = require("../../lib-common/big-endian");
 const assert_1 = require("../../lib-common/assert");
+const runtime_1 = require("../../lib-common/exceptions/runtime");
 const ver1Serialization = new Uint8Array([1]);
 function parseFolderInfo(bytes) {
     if (!bytes) {
@@ -42,7 +43,8 @@ function parsingException(msg, cause) {
         runtimeException: true,
         type: 'folder-parsing',
         message: msg,
-        cause
+        cause,
+        stack: (0, runtime_1.getStackHere)(1)
     };
 }
 var formatV1;

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

@@ -268,14 +268,11 @@ class NodeInFS {
             this.writeProc = new synced_1.SingleProc();
         }
         if (!awaitPrevChange && this.writeProc.isProcessing()) {
-            throw (0, runtime_1.makeRuntimeException)('file', { path: this.name, fsEtityType: this.type }, { concurrentUpdate: true });
+            throw (0, runtime_1.makeRuntimeException)('file', { path: this.name, fsEtityType: this.type }, { concurrentUpdate: true }, true);
         }
         const res = await this.writeProc.startOrChain(async () => {
             if (this.isMarkedRemoved) {
-                throw (0, runtime_1.makeRuntimeException)('file', {
-                    path: this.name, fsEtityType: this.type,
-                    message: `NodeInFS is marked removed`
-                }, { notFound: true });
+                throw (0, runtime_1.makeRuntimeException)('file', { path: this.name, fsEtityType: this.type, message: `NodeInFS is marked removed` }, { notFound: true });
             }
             try {
                 const res = await change();

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

@@ -1,40 +1,24 @@
 import * as fs from 'fs';
 import { Readable, Writable } from 'stream';
-export { Stats } from 'fs';
-export { FileException } from './exceptions/file';
-export declare function readFile(filename: string, options: {
-    encoding: BufferEncoding;
-    flag?: string;
-}): Promise<string>;
-export declare function readFile(filename: string, options?: {
-    flag?: string;
-}): Promise<Buffer>;
-export declare function writeFile(path: string, data: any, options?: {
-    encoding?: BufferEncoding;
-    mode?: string;
-    flag?: string;
-}): Promise<void>;
-export declare function appendFile(path: string, data: any, options?: {
-    encoding?: BufferEncoding;
-    mode?: string;
-    flag?: string;
-}): Promise<void>;
-export declare function mkdir(path: string, options?: number | string | fs.MakeDirectoryOptions | null): Promise<void>;
-export declare function open(path: string, flags: string): Promise<number>;
-export declare function close(fd: number): Promise<void>;
-export declare function symlink(target: string, path: string, type?: 'dir' | 'file' | 'junction'): Promise<void>;
-export declare function readlink(path: string): Promise<string>;
-export declare function lstat(path: string): Promise<fs.Stats>;
-export declare function stat(path: string): Promise<fs.Stats>;
-export declare function fstat(fd: number): Promise<fs.Stats>;
-export declare function readdir(path: string): Promise<string[]>;
-export declare function rmdir(path: string): Promise<void>;
-export declare function unlink(path: string): Promise<void>;
-export declare function rename(oldPath: string, newPath: string): Promise<void>;
-export declare function truncate(path: string, size: number): Promise<void>;
-export declare function ftruncate(fd: number, size: number): Promise<void>;
-/**
- * @param fd is an open file descriptor
+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;
+/**
+ * @param fh is an open file handle
  * @param pos is a position in the file, from which reading should start
  * @param buf is a buffer, into which bytes should be read from start to
  * the end, i.e. number of bytes that must be read is equal to the buffer's
@@ -44,14 +28,14 @@ export declare function ftruncate(fd: number, size: number): Promise<void>;
  * The promise fails, if an end of file is encountered before entire buffer is
  * filled up with bytes.
  */
-export declare function readToBuf(fd: number, pos: number, buf: Buffer): Promise<void>;
+export declare function readToBuf(fh: FileHandle, pos: number, buf: Buffer): Promise<void>;
 /**
- * @param fd is an open file descriptor
+ * @param fh is an open file handle
  * @param pos is a position in the file, from which writing should start
  * @param buf is a buffer, from which all bytes should be written into the file.
  * @returns a promise, resolvable when all bytes were written to the file.
  */
-export declare function writeFromBuf(fd: number, pos: number, buf: Buffer): Promise<void>;
+export declare function writeFromBuf(fh: FileHandle, pos: number, buf: Buffer): Promise<void>;
 /**
  * This will create a new file of a given size, and will fail, if a file
  * with a given path already exists.
@@ -59,10 +43,10 @@ export declare function writeFromBuf(fd: number, pos: number, buf: Buffer): Prom
  * @param fileSize
  * @param keepFileOpen
  * @returns a promise, resolvable, when a new empty file has been created.
- * When keep open flag was passed, live numeric file descriptor is returned,
+ * When keep open flag was passed, live file handle is returned,
  * else return value is undefined and should be ignored.
  */
-export declare function createEmptyFile(filePath: string, fileSize: number, keepFileOpen?: boolean): Promise<number | undefined>;
+export declare function createEmptyFile(filePath: string, fileSize: number, keepFileOpen?: boolean): Promise<FileHandle | undefined>;
 /**
  * @param path
  * @return a promise, resolvable to true, if given path represents directory,
@@ -91,18 +75,18 @@ export declare function getFileSize(filePath: string): Promise<number>;
  */
 export declare function getFolderContentSize(folderPath: string): Promise<number>;
 /**
- * @param fd is an open file descriptor
+ * @param fh is an open file handle
  * @param pos is a position in the file, from which writing should start
  * @param buf is a buffer, from which all bytes should be written into the file.
  * @returns a promise, resolvable when all bytes were written to it.
  */
-export declare function write(fd: number, pos: number, buf: Buffer): Promise<void>;
+export declare function write(fh: FileHandle, pos: number, buf: Buffer): Promise<void>;
 /**
- * @param fd is an open file descriptor in append mode.
+ * @param fh is an open file handle in append mode.
  * @param buf is a buffer, from which all bytes should be written into the file.
  * @returns a promise, resolvable when all bytes were written to it.
  */
-export declare function append(fd: number, buf: Buffer): Promise<void>;
+export declare function append(fh: FileHandle, buf: Buffer): Promise<void>;
 /**
  * @param filePath
  * @param pos is a position in the file, from which writting should start
@@ -115,7 +99,7 @@ export declare function append(fd: number, buf: Buffer): Promise<void>;
  */
 export declare function streamToExistingFile(filePath: string, pos: number, len: number, src: Readable, bufSize: number): Promise<void>;
 /**
- * @param fd is an open file descriptor
+ * @param fh is an open file handle
  * @param pos is a position in the file, from which reading should start
  * @param buf is a buffer, into which bytes should be read from start to
  * the end, i.e. number of bytes that must be read is equal to the buffer's
@@ -125,7 +109,7 @@ export declare function streamToExistingFile(filePath: string, pos: number, len:
  * The promise fails, if an end of file is encountered before entire buffer is
  * filled up with bytes.
  */
-export declare function read(fd: number, pos: number, buf: Buffer): Promise<void>;
+export declare function read(fh: FileHandle, pos: number, buf: Buffer): Promise<void>;
 /**
  * @param folder is a path to a folder, which should be recursively removed,
  * together with all files.