core-3nweb-client-lib 0.20.7 → 0.22.0

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

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2015 - 2018, 2020 3NSoft Inc.
+ Copyright (C) 2015 - 2018, 2020, 2022 3NSoft Inc.
 
  This program is free software: you can redistribute it and/or modify it under
  the terms of the GNU General Public License as published by the Free Software
@@ -28,7 +28,6 @@ const buffer_utils_2 = require("../../lib-common/buffer-utils");
 const pipe_1 = require("../../lib-common/byte-streaming/pipe");
 const dev_file_src_1 = require("./dev-file-src");
 const dev_file_sink_1 = require("./dev-file-sink");
-const file_source_1 = require("../files/file-source");
 /**
  * This recursively creates folder, or ensures its presence with non-exclusive
  * parameter.
@@ -411,7 +410,12 @@ class DeviceFS {
             throw file_1.maskPathInExc(this.root.length, e);
         });
         const byteSrc = dev_file_src_1.DevFileByteSource.make(pathStr, this.root.length, stats);
-        return file_source_1.fileSrcFromContinuousSrc(byteSrc);
+        return {
+            getPosition: byteSrc.getPosition,
+            getSize: async () => (await byteSrc.getSize()).size,
+            read: byteSrc.read,
+            seek: byteSrc.seek
+        };
     }
     async writeBytes(path, bytes, flags = WRITE_NONEXCL_FLAGS) {
         const pathSections = splitPathIntoParts(path);

package/build/lib-client/objs-on-disk/file-writing-proc.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.FileWritingProc = void 0;
 const processes_1 = require("../../lib-common/processes");
@@ -126,9 +127,9 @@ function combineSegsFrom(segs) {
         }
         else if (chunkEnd < sOfs) {
             chunks.push({ ofs: chunkStart, bytes: buffer_utils_1.joinByteArrs(chunkSegs) });
+            chunkSegs = [seg];
             chunkStart = sOfs;
             chunkEnd = chunkStart + seg.length;
-            chunkSegs.push(seg);
         }
         else {
             throw new Error(`Got missorted segment`);

package/build/lib-client/objs-on-disk/obj-on-disk.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.ObjOnDisk = void 0;
 const buffer_utils_1 = require("../../lib-common/buffer-utils");
@@ -60,8 +61,10 @@ class ObjOnDisk {
         const objFile = await obj_file_1.ObjVersionFile.createNew(path);
         const obj = new ObjOnDisk(objId, version, objFile, downloader, false, getBase);
         const write$ = file_writing_proc_1.FileWritingProc.makeFor(objFile, encSub)
-            .pipe(operators_1.tap(undefined, undefined, () => {
-            obj.readable = true;
+            .pipe(operators_1.tap({
+            complete: () => {
+                obj.readable = true;
+            }
         }), utils_for_observables_1.flatTap(undefined, () => objFile.removeFile()), utils_for_observables_1.allowOnlySingleStart());
         return { obj, write$ };
     }
@@ -104,12 +107,10 @@ class ObjOnDisk {
         for (const chunk of segsLocations) {
             if ((chunk.type === 'new-on-disk')
                 || (chunk.type === 'base-on-disk')) {
-                const chunkBytes = await this.objFile.readSegs(chunk.thisVerOfs, chunk.len);
-                bytesAndChunks.push(...chunkBytes);
+                bytesAndChunks.push(...(await this.objFile.readSegs(chunk.thisVerOfs, chunk.len)));
             }
             else if (chunk.type === 'base') {
-                const baseBytesAndChunks = await this.readBaseBytesFromOtherFilesOnDisk(chunk);
-                bytesAndChunks.push(...baseBytesAndChunks);
+                bytesAndChunks.push(...(await this.readBaseBytesFromOtherFilesOnDisk(chunk)));
             }
             else {
                 bytesAndChunks.push(chunk);

package/build/lib-common/big-endian.d.ts

@@ -35,18 +35,6 @@ export declare function packUintTo4Bytes(u: number, b: Buffer, i: number): void;
  * in 4 bytes of x, starting at index i.
  */
 export declare function uintFrom4Bytes(x: Uint8Array, i?: number): number;
-/**
- * @param u is an unsigned integer up to 40-bits to be stored big-endian way in
- * 5 bytes.
- */
-export declare function packUintTo5Bytes(u: number, b: Buffer, i: number): void;
-/**
- * @param x
- * @param i
- * @return unsigned integer (up to 40 bits), stored big-endian way
- * in 5 bytes of x, starting at index i.
- */
-export declare function uintFrom5Bytes(x: Uint8Array, i?: number): number;
 /**
  * @param u is an unsigned integer up to 48-bits to be stored big-endian way in
  * 6 bytes.
@@ -59,18 +47,6 @@ export declare function packUintTo6Bytes(u: number, b: Buffer, i: number): void;
  * in 6 bytes of x, starting at index i.
  */
 export declare function uintFrom6Bytes(x: Uint8Array, i?: number): number;
-/**
- * @param u is an unsigned integer up to 53-bits to be stored big-endian way in
- * 7 bytes.
- */
-export declare function packUintTo7Bytes(u: number, b: Buffer, i: number): void;
-/**
- * @param x
- * @param i
- * @return unsigned integer (up to 53 bits), stored big-endian way
- * in 7 bytes of x, starting at index i.
- */
-export declare function uintFrom7Bytes(x: Uint8Array, i?: number): number;
 /**
  * @param u is an unsigned integer up to 53-bits to be stored big-endian way in
  * 8 bytes.

package/build/lib-common/big-endian.js

@@ -13,9 +13,10 @@
  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.uintFrom8Bytes = exports.packUintTo8Bytes = exports.uintFrom7Bytes = exports.packUintTo7Bytes = exports.uintFrom6Bytes = exports.packUintTo6Bytes = exports.uintFrom5Bytes = exports.packUintTo5Bytes = exports.uintFrom4Bytes = exports.packUintTo4Bytes = exports.uintFrom3Bytes = exports.packUintTo3Bytes = exports.uintFrom2Bytes = exports.packUintTo2Bytes = void 0;
+exports.uintFrom8Bytes = exports.packUintTo8Bytes = exports.uintFrom6Bytes = exports.packUintTo6Bytes = exports.uintFrom4Bytes = exports.packUintTo4Bytes = exports.uintFrom3Bytes = exports.packUintTo3Bytes = exports.uintFrom2Bytes = exports.packUintTo2Bytes = void 0;
 /**
  * @param u is an unsigned integer up to 16-bits to be stored big-endian way in
  * 2 bytes.
@@ -100,44 +101,12 @@ function uintFrom4Bytes(x, i = 0) {
     if (x.length < i + 4) {
         throw new Error('Given array has less than 4 bytes, starting with a given index.');
     }
-    return (x[i] << 24) | (x[i + 1] << 16) | (x[i + 2] << 8) | x[i + 3];
+    // Note that (x << 24) may produce negative number, probably due to
+    // treating intermediate integer as signed, and pulling sign to resulting
+    // float number. Hence, we need a bit different operation here.
+    return (x[i] * 0x1000000) + ((x[i + 1] << 16) | (x[i + 2] << 8) | x[i + 3]);
 }
 exports.uintFrom4Bytes = uintFrom4Bytes;
-/**
- * @param u is an unsigned integer up to 40-bits to be stored big-endian way in
- * 5 bytes.
- */
-function packUintTo5Bytes(u, b, i) {
-    if (u > 0xffffffffff) {
-        throw new Error('Cannot store number bigger than 2^40-1');
-    }
-    if (b.length < i + 5) {
-        throw new Error('Given array has less than 5 bytes, starting with a given index.');
-    }
-    const h = Math.floor(u / 0x100000000);
-    const l = u % 0x100000000;
-    b[i] = h;
-    b[i + 1] = l >>> 24;
-    b[i + 2] = l >>> 16;
-    b[i + 3] = l >>> 8;
-    b[i + 4] = l;
-}
-exports.packUintTo5Bytes = packUintTo5Bytes;
-/**
- * @param x
- * @param i
- * @return unsigned integer (up to 40 bits), stored big-endian way
- * in 5 bytes of x, starting at index i.
- */
-function uintFrom5Bytes(x, i = 0) {
-    if (x.length < i + 5) {
-        throw new Error('Given array has less than 5 bytes, starting with a given index.');
-    }
-    const h = x[i];
-    const l = (x[i + 1] << 24) | (x[i + 2] << 16) | (x[i + 3] << 8) | x[i + 4];
-    return (h * 0x100000000 + l);
-}
-exports.uintFrom5Bytes = uintFrom5Bytes;
 /**
  * @param u is an unsigned integer up to 48-bits to be stored big-endian way in
  * 6 bytes.
@@ -169,48 +138,14 @@ function uintFrom6Bytes(x, i = 0) {
     if (x.length < i + 6) {
         throw new Error('Given array has less than 6 bytes, starting with a given index.');
     }
+    // Note that (x << 24) may produce negative number, probably due to
+    // treating intermediate integer as signed, and pulling sign to resulting
+    // float number. Hence, we need a bit different operation here.
     const h = (x[i] << 8) | x[i + 1];
-    const l = (x[i + 2] << 24) | (x[i + 3] << 16) | (x[i + 4] << 8) | x[i + 5];
+    const l = (x[i] * 0x1000000) + ((x[i + 3] << 16) | (x[i + 4] << 8) | x[i + 5]);
     return (h * 0x100000000 + l);
 }
 exports.uintFrom6Bytes = uintFrom6Bytes;
-/**
- * @param u is an unsigned integer up to 53-bits to be stored big-endian way in
- * 7 bytes.
- */
-function packUintTo7Bytes(u, b, i) {
-    if (u > Number.MAX_SAFE_INTEGER) {
-        throw new Error('Cannot store number bigger than 2^53-1');
-    }
-    if (b.length < i + 7) {
-        throw new Error('Given array has less than 7 bytes, starting with a given index.');
-    }
-    const h = Math.floor(u / 0x100000000);
-    const l = u % 0x100000000;
-    b[i] = h >>> 16;
-    b[i + 1] = h >>> 8;
-    b[i + 2] = h;
-    b[i + 3] = l >>> 24;
-    b[i + 4] = l >>> 16;
-    b[i + 5] = l >>> 8;
-    b[i + 6] = l;
-}
-exports.packUintTo7Bytes = packUintTo7Bytes;
-/**
- * @param x
- * @param i
- * @return unsigned integer (up to 53 bits), stored big-endian way
- * in 7 bytes of x, starting at index i.
- */
-function uintFrom7Bytes(x, i = 0) {
-    if (x.length < i + 7) {
-        throw new Error('Given array has less than 7 bytes, starting with a given index.');
-    }
-    const h = (x[i] << 16) | (x[i + 1] << 8) | x[i + 2];
-    const l = (x[i + 3] << 24) | (x[i + 4] << 16) | (x[i + 5] << 8) | x[i + 6];
-    return (h * 0x100000000 + l);
-}
-exports.uintFrom7Bytes = uintFrom7Bytes;
 /**
  * @param u is an unsigned integer up to 53-bits to be stored big-endian way in
  * 8 bytes.
@@ -244,8 +179,11 @@ function uintFrom8Bytes(x, i = 0) {
     if (x.length < i + 8) {
         throw new Error('Given array has less than 8 bytes, starting with a given index.');
     }
-    const h = (x[i] << 24) | (x[i + 1] << 16) | (x[i + 2] << 8) | x[i + 3];
-    const l = (x[i + 4] << 24) | (x[i + 5] << 16) | (x[i + 6] << 8) | x[i + 7];
+    // Note that (x << 24) may produce negative number, probably due to
+    // treating intermediate integer as signed, and pulling sign to resulting
+    // float number. Hence, we need a bit different operation here.
+    const h = (x[i] * 0x1000000) + ((x[i + 1] << 16) | (x[i + 2] << 8) | x[i + 3]);
+    const l = (x[i + 4] * 0x1000000) + ((x[i + 5] << 16) | (x[i + 6] << 8) | x[i + 7]);
     return (h * 0x100000000 + l);
 }
 exports.uintFrom8Bytes = uintFrom8Bytes;

package/build/lib-common/exceptions/file.js

@@ -30,7 +30,8 @@ exports.Code = {
     ioError: 'EIO',
     concurrentUpdate: 'concurrent-update',
     parsingError: 'parsing-error',
-    notImplemented: 'ENOSYS'
+    notImplemented: 'ENOSYS',
+    isEndless: 'is-endless',
 };
 Object.freeze(exports.Code);
 function makeFileException(code, path, cause) {
@@ -83,6 +84,9 @@ function makeFileException(code, path, cause) {
     else if (code === exports.Code.notImplemented) {
         err.notImplemented = true;
     }
+    else if (code === exports.Code.isEndless) {
+        err.isEndless = true;
+    }
     return err;
 }
 exports.makeFileException = makeFileException;

package/build/lib-common/obj-streaming/sink-utils.d.ts

@@ -1,9 +1,5 @@
-/// <reference types="node" />
-import { SegmentsWriter, Subscribe } from "xsp-files";
 declare type FileByteSink = web3n.files.FileByteSink;
 export declare type ContinuousSink = (bytes: Uint8Array | null, err?: any) => Promise<void>;
 export declare function makeContinuousSink(sink: FileByteSink, start?: number): ContinuousSink;
 export declare function appendFiniteSink(sink: FileByteSink, bytes: Uint8Array, closeSink?: boolean): Promise<void>;
-export declare function encryptBytesToSinkProc(bytes: Uint8Array | Uint8Array[], attrBytes: Buffer, segWriter: SegmentsWriter): Subscribe;
-export declare function encryptAttrsToSinkProc(attrBytes: Buffer, segWriter: SegmentsWriter, baseAttrsSize: number | undefined): Subscribe;
 export {};

package/build/lib-common/obj-streaming/sink-utils.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2018, 2020 3NSoft Inc.
+ Copyright (C) 2018, 2020, 2022 3NSoft Inc.
 
  This program is free software: you can redistribute it and/or modify it under
  the terms of the GNU General Public License as published by the Free Software
@@ -13,11 +13,10 @@
  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.encryptAttrsToSinkProc = exports.encryptBytesToSinkProc = exports.appendFiniteSink = exports.makeContinuousSink = void 0;
-const xsp_files_1 = require("xsp-files");
-const buffer_utils_1 = require("../buffer-utils");
+exports.appendFiniteSink = exports.makeContinuousSink = void 0;
 class ContSink {
     constructor(sink, position) {
         this.sink = sink;
@@ -54,69 +53,4 @@ async function appendFiniteSink(sink, bytes, closeSink = true) {
     }
 }
 exports.appendFiniteSink = appendFiniteSink;
-function encryptBytesToSinkProc(bytes, attrBytes, segWriter) {
-    const { sink, sub } = xsp_files_1.makeEncryptingByteSinkWithAttrs(segWriter);
-    const writeToSink = async () => {
-        try {
-            await sink.writeAttrs(attrBytes);
-            if (Array.isArray(bytes)) {
-                await writeAllByteArrsToSink(bytes, sink);
-            }
-            else {
-                await writeByteArrToSink(bytes, sink);
-            }
-            await sink.done();
-        }
-        catch (err) {
-            await sink.done(err);
-        }
-        finally {
-            segWriter.destroy();
-        }
-    };
-    return (obs, backpressure) => {
-        const unsub = sub(obs, backpressure);
-        writeToSink();
-        return unsub;
-    };
-}
-exports.encryptBytesToSinkProc = encryptBytesToSinkProc;
-function encryptAttrsToSinkProc(attrBytes, segWriter, baseAttrsSize) {
-    const { sink, sub } = xsp_files_1.makeEncryptingByteSinkWithAttrs(segWriter, baseAttrsSize);
-    const writeToSink = async () => {
-        try {
-            await sink.writeAttrs(attrBytes);
-            await sink.done();
-        }
-        catch (err) {
-            await sink.done(err);
-        }
-        finally {
-            segWriter.destroy();
-        }
-    };
-    return (obs, backpressure) => {
-        const unsub = sub(obs, backpressure);
-        writeToSink();
-        return unsub;
-    };
-}
-exports.encryptAttrsToSinkProc = encryptAttrsToSinkProc;
-async function writeByteArrToSink(bytes, sink) {
-    await sink.setSize(bytes.length);
-    await sink.freezeLayout();
-    await sink.write(0, bytes);
-}
-async function writeAllByteArrsToSink(bytes, sink) {
-    await sink.setSize(buffer_utils_1.byteLengthIn(bytes));
-    await sink.freezeLayout();
-    let pos = 0;
-    for (const arr of bytes) {
-        if (arr.length === 0) {
-            continue;
-        }
-        await sink.write(pos, arr);
-        pos += arr.length;
-    }
-}
 Object.freeze(exports);

package/build/lib-common/objs-on-disk/file-layout.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.ObjVersionBytesLayout = void 0;
 const v1_obj_file_format_1 = require("./v1-obj-file-format");

package/build/lib-common/objs-on-disk/obj-file.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.ObjVersionFile = void 0;
 const fs = require("../async-fs-node");
@@ -25,7 +26,6 @@ const v1_obj_file_format_1 = require("./v1-obj-file-format");
 const fs_1 = require("fs");
 const file_layout_1 = require("./file-layout");
 const big_endian_1 = require("../big-endian");
-global.log = false;
 class ObjVersionFile {
     constructor(path, layout) {
         this.path = path;

package/build/lib-common/objs-on-disk/utils.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.makeNoBaseObjPipe = exports.makeObjPipe = exports.chunksInOrderedStream = exports.streamToObjFile = exports.diffToLayout = void 0;
 const processes_1 = require("../processes");

package/build/lib-common/objs-on-disk/v1-obj-file-format.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.layoutV1 = exports.V1_FILE_START = void 0;
 const big_endian_1 = require("../big-endian");

package/build/lib-index.d.ts

@@ -4,6 +4,7 @@ export * from "./core-ipc/startup-caps";
 export * from "./ipc-via-protobuf/connector";
 export { FileMsg, makeFileCaller, exposeFileService } from "./ipc-via-protobuf/file";
 export { FSMsg, makeFSCaller, exposeFSService } from "./ipc-via-protobuf/fs";
+export { makeLogCaller, exposeLogger } from "./ipc-via-protobuf/log-cap";
 export * from "./core";
 export { makeServiceLocator, ServiceLocatorMaker } from "./lib-client/service-locator";
 export { makeNetClient } from "./lib-client/request-utils";

package/build/lib-index.js

@@ -36,6 +36,9 @@ Object.defineProperty(exports, "exposeFileService", { enumerable: true, get: fun
 var fs_1 = require("./ipc-via-protobuf/fs");
 Object.defineProperty(exports, "makeFSCaller", { enumerable: true, get: function () { return fs_1.makeFSCaller; } });
 Object.defineProperty(exports, "exposeFSService", { enumerable: true, get: function () { return fs_1.exposeFSService; } });
+var log_cap_1 = require("./ipc-via-protobuf/log-cap");
+Object.defineProperty(exports, "makeLogCaller", { enumerable: true, get: function () { return log_cap_1.makeLogCaller; } });
+Object.defineProperty(exports, "exposeLogger", { enumerable: true, get: function () { return log_cap_1.exposeLogger; } });
 __exportStar(require("./core"), exports);
 var service_locator_1 = require("./lib-client/service-locator");
 Object.defineProperty(exports, "makeServiceLocator", { enumerable: true, get: function () { return service_locator_1.makeServiceLocator; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "core-3nweb-client-lib",
-  "version": "0.20.7",
+  "version": "0.22.0",
   "description": "3NWeb client core library, embeddable into different environments",
   "main": "build/lib-index.js",
   "types": "build/lib-index.d.ts",
@@ -31,7 +31,7 @@
     "punycode": "^2.1.1",
     "rxjs": "^6.5.2",
     "ws": "^7.0.0",
-    "xsp-files": "^3.1.10"
+    "xsp-files": "^4.0.0"
   },
   "devDependencies": {
     "@types/jasmine": "^3.9.1",

package/build/lib-client/files/file-attrs.d.ts

@@ -1,76 +0,0 @@
-/// <reference types="node" />
-declare type FSEntityType = 'folder-json-v1' | 'link-json-v1' | 'file-v1-continuous' | 'file-v1-w-layout';
-export interface EntityAttrs {
-    type: FSEntityType;
-    ctime: number;
-    mtime: number;
-    ext: {
-        [name: string]: NamedAttr;
-    };
-}
-export interface FileAttrs extends EntityAttrs {
-    type: 'file-v1-continuous' | 'file-v1-w-layout';
-    size?: number;
-    layoutOfs?: number;
-}
-export interface FolderAttrs extends EntityAttrs {
-    type: 'folder-json-v1';
-}
-export interface LinkAttrs extends EntityAttrs {
-    type: 'link-json-v1';
-}
-export declare type Attrs = FolderAttrs | FileAttrs | LinkAttrs;
-export interface NamedBinaryAttr {
-    type: 'named-binary';
-    name: string;
-    value: Uint8Array;
-}
-export interface NamedStringAttr {
-    type: 'named-utf8str';
-    name: string;
-    value: string;
-}
-export interface NamedJsonAttr {
-    type: 'named-json';
-    name: string;
-    value: any;
-}
-export declare type NamedAttr = NamedBinaryAttr | NamedStringAttr | NamedJsonAttr;
-export declare function attrType(value: any): NamedAttr['type'];
-export declare function makeFileAttrs(now: number): FileAttrs;
-export declare function makeFolderAttrs(now: number): FolderAttrs;
-export declare function makeLinkAttrs(now: number): LinkAttrs;
-export interface ObjFileParsingException extends web3n.RuntimeException {
-    type: 'attrs-parsing';
-    msg: string;
-}
-declare type XAttrsChanges = web3n.files.XAttrsChanges;
-export declare class AttrsHolder<T extends EntityAttrs> {
-    private readonly attrs;
-    private modifiable;
-    constructor(attrs: T, modifiable?: boolean);
-    modifiableCopy(): AttrsHolder<T>;
-    static fromBytesReadonly<T extends EntityAttrs>(bytes: Uint8Array): AttrsHolder<T>;
-    static fromJSONReadonly<T extends EntityAttrs>(attrs: T): AttrsHolder<T>;
-    static makeReadonlyForFile(now: number): AttrsHolder<FileAttrs>;
-    static makeReadonlyForFolder(now: number): AttrsHolder<FolderAttrs>;
-    static makeReadonlyForLink(now: number): AttrsHolder<LinkAttrs>;
-    toBytes(): Buffer;
-    setReadonly(): void;
-    get isReadonly(): boolean;
-    private throwIfReadonly;
-    get ctime(): number;
-    set ctime(epoch: number);
-    get mtime(): number;
-    set mtime(epoch: number);
-    get type(): T['type'];
-    get serializedLen(): number;
-    getFileLayoutOfs(): number | undefined;
-    getFileSize(): number | undefined;
-    setFileLayoutOfs(ofs: number): void;
-    setContinuousFileSize(size: number): void;
-    getXAttr(xaName: string): any;
-    updateXAttrs(changes: XAttrsChanges): void;
-    listXAttrs(): string[];
-}
-export {};