core-3nweb-client-lib 0.43.6 → 0.43.8

package/build/api-defs/files.d.ts

@@ -169,6 +169,7 @@ declare namespace web3n.files {
 		local?: LocalVersion;
 		remote?: SyncVersionsBranch;
 		existsInSyncedParent?: boolean;
+		uploading?: UploadingState;
 	}
 
 	interface LocalVersion {
@@ -184,6 +185,24 @@ declare namespace web3n.files {
 
 	type SyncState = 'synced' | 'behind' | 'unsynced' | 'conflicting';
 
+	interface UploadingState {
+		/**
+		 * Local version that is uploaded to server.
+		 * If it is an upload of object removal, version is -1.
+		 */
+		localVersion: number;
+		/**
+		 * New remote version that is uploaded to server.
+		 * If it is an upload of object removal, version is -1.
+		 */
+		remoteVersion: number;
+		/**
+		 * Bytes left to upload.
+		 */
+		bytesLeftToUpload: number;
+		uploadStarted: boolean;
+	}
+
 	interface FileByteSource {
 
 		/**
@@ -445,6 +464,12 @@ declare namespace web3n.files {
 
 	interface ReadonlyFileVersionedAPI {
 
+		/**
+		 * This returns a promise, resolvable to stats of the file.
+		 * @param flags are optional flags to read archived or remote versions.
+		 */
+		stat(flags?: VersionedReadFlags): Promise<Stats>;
+
 		getXAttr(
 			xaName: string, flags?: VersionedReadFlags
 		): Promise<{ attr: any; version: number; }>;
@@ -1063,6 +1088,14 @@ declare namespace web3n.files {
 
 	interface ReadonlyFSVersionedAPI {
 
+		/**
+		 * This returns a promise, resolvable to stats of an entity at a given
+		 * path.
+		 * @param path
+		 * @param flags are optional flags to read archived or remote versions.
+		 */
+		stat(path: string, flags?: VersionedReadFlags): Promise<Stats>;
+
 		getXAttr(
 			path: string, xaName: string, flags?: VersionedReadFlags
 		): Promise<{ attr: any; version: number; }>;

package/build/core/storage/synced/obj-status.d.ts

@@ -48,16 +48,37 @@ export interface RemovalUpload {
 export interface WholeVerOrderedUpload {
     type: 'ordered-whole';
     createObj?: boolean;
+    /**
+     * Header bytes that need to be uploaded. Undefined when header has been uploaded.
+     */
     header?: number;
+    /**
+     * Segments bytes left to upload.
+     */
     segsLeft: number;
+    /**
+     * Offset in segments, to which point bytes where uploaded.
+     */
     segsOfs: number;
+    /**
+     * Upload transaction id.
+     */
     transactionId?: string;
 }
 export interface DiffVerOrderedUpload {
     type: 'ordered-diff';
     diff: DiffInfo;
+    /**
+     * Header bytes that need to be uploaded. Undefined when header has been uploaded.
+     */
     header?: number;
+    /**
+     * New chunks of segments that should be uploaded.
+     */
     newSegsLeft: FiniteChunk[];
+    /**
+     * Upload transaction id.
+     */
     transactionId?: string;
 }
 export interface BytesSection {

package/build/core/storage/synced/obj-status.js

@@ -1,6 +1,6 @@
 "use strict";
 /*
- Copyright (C) 2016 - 2020, 2022 3NSoft Inc.
+ Copyright (C) 2016 - 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
@@ -494,7 +494,8 @@ class ObjStatus {
             state: this.stateIndicator,
             local: localVersionFromStatus(this.status.local),
             remote,
-            synced
+            synced,
+            uploading: uploadInStatus(this.status.upload)
         };
     }
     neverUploaded() {
@@ -674,4 +675,46 @@ function skipNotFoundExc(exc) {
         throw exc;
     }
 }
+function uploadInStatus(upload) {
+    if (!upload) {
+        return;
+    }
+    if (upload.type === 'new-version') {
+        const { needUpload } = upload;
+        if (!needUpload) {
+            return;
+        }
+        let bytesLeftToUpload = 0;
+        if (needUpload.type === 'ordered-whole') {
+            const { header, segsLeft } = needUpload;
+            if (header) {
+                bytesLeftToUpload += header;
+            }
+            bytesLeftToUpload += segsLeft;
+        }
+        else if (needUpload.type === 'ordered-diff') {
+            const { header, newSegsLeft } = needUpload;
+            if (header) {
+                bytesLeftToUpload += header;
+            }
+            for (const { len: chunkLen } of newSegsLeft) {
+                bytesLeftToUpload += chunkLen;
+            }
+        }
+        return {
+            localVersion: upload.localVersion,
+            remoteVersion: upload.uploadVersion,
+            bytesLeftToUpload,
+            uploadStarted: !!needUpload.transactionId
+        };
+    }
+    else {
+        return {
+            localVersion: -1,
+            remoteVersion: -1,
+            bytesLeftToUpload: 0,
+            uploadStarted: false
+        };
+    }
+}
 Object.freeze(exports);

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

@@ -181,8 +181,7 @@ class UploadTask {
         }
     }
     async headerToUpload() {
-        return (this.uploadHeader ?
-            this.uploadHeader : await this.src.readHeader());
+        return (this.uploadHeader ? this.uploadHeader : await this.src.readHeader());
     }
     async startOrderedDiffUpload(upload) {
         const diff = buffer_utils_1.utf8.pack(JSON.stringify(upload.diff));

package/build/core-ipc/file.d.ts

@@ -47,6 +47,10 @@ export interface VersionedReadFlagsMsg {
 }
 export declare function versionedReadFlagsFromMsg(msg: VersionedReadFlagsMsg | undefined): VersionedReadFlags | undefined;
 export declare function versionedReadFlagsToMsg(flags: VersionedReadFlags | undefined): VersionedReadFlagsMsg | undefined;
+export declare namespace vStat {
+    function wrapService(fn: ReadonlyFileVersionedAPI['stat']): ExposedFn;
+    function makeCaller(caller: Caller, objPath: string[]): ReadonlyFileVersionedAPI['stat'];
+}
 export declare namespace vGetXAttr {
     interface Reply {
         version: number;

package/build/core-ipc/file.js

@@ -16,7 +16,7 @@
  this program. If not, see <http://www.gnu.org/licenses/>.
 */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.vListVersions = exports.vGetByteSink = exports.updateXAttrs = exports.vGetByteSource = exports.vReadJSON = exports.vReadTxt = exports.vReadBytes = exports.vListXAttrs = exports.vGetXAttr = exports.readBytes = exports.fileMsgType = void 0;
+exports.vListVersions = exports.vGetByteSink = exports.updateXAttrs = exports.vGetByteSource = exports.vReadJSON = exports.vReadTxt = exports.vReadBytes = exports.vListXAttrs = exports.vGetXAttr = exports.vStat = exports.readBytes = exports.fileMsgType = void 0;
 exports.makeFileCaller = makeFileCaller;
 exports.exposeFileService = exposeFileService;
 exports.packStats = packStats;
@@ -75,6 +75,7 @@ function makeFileCaller(caller, fileMsg) {
         const vPath = (0, protobuf_msg_1.methodPathFor)(objPath, 'v');
         file.v = {
             getByteSource: vGetByteSource.makeCaller(caller, vPath),
+            stat: vStat.makeCaller(caller, vPath),
             getXAttr: vGetXAttr.makeCaller(caller, vPath),
             listXAttrs: vListXAttrs.makeCaller(caller, vPath),
             readBytes: vReadBytes.makeCaller(caller, vPath),
@@ -129,6 +130,7 @@ function exposeFileService(file, expServices) {
     if (file.v) {
         implExp.v = {
             getByteSource: vGetByteSource.wrapService(file.v.getByteSource, expServices),
+            stat: vStat.wrapService(file.v.stat),
             getXAttr: vGetXAttr.wrapService(file.v.getXAttr),
             listXAttrs: vListXAttrs.wrapService(file.v.listXAttrs),
             readBytes: vReadBytes.wrapService(file.v.readBytes),
@@ -171,7 +173,10 @@ function exposeFileService(file, expServices) {
 exports.fileMsgType = protobuf_type_1.ProtoType.for(file_proto_1.file.File);
 const statsMsgType = protobuf_type_1.ProtoType.for(file_proto_1.file.StatsMsg);
 function packStats(s) {
-    const msg = {
+    return statsMsgType.pack(statsToMsg(s));
+}
+function statsToMsg(s) {
+    return {
         writable: s.writable,
         isFile: (0, protobuf_msg_1.toOptVal)(s.isFile),
         isFolder: (0, protobuf_msg_1.toOptVal)(s.isFolder),
@@ -181,10 +186,11 @@ function packStats(s) {
         size: (0, protobuf_msg_1.toOptVal)(s.size),
         version: (0, protobuf_msg_1.toOptVal)(s.version),
     };
-    return statsMsgType.pack(msg);
 }
 function unpackStats(buf) {
-    const m = statsMsgType.unpack(buf);
+    return msgToStats(statsMsgType.unpack(buf));
+}
+function msgToStats(m) {
     return {
         writable: m.writable,
         isFile: (0, protobuf_msg_1.valOfOpt)(m.isFile),
@@ -205,7 +211,8 @@ function syncStatusToMsg(s) {
         local: syncBranchToMsg(s.local),
         synced: syncBranchToMsg(s.synced),
         remote: syncBranchToMsg(s.remote),
-        existsInSyncedParent: (0, protobuf_msg_1.toOptVal)(s.existsInSyncedParent)
+        existsInSyncedParent: (0, protobuf_msg_1.toOptVal)(s.existsInSyncedParent),
+        uploading: uploadingToMsg(s.uploading)
     };
 }
 function msgToSyncStatus(m) {
@@ -217,7 +224,8 @@ function msgToSyncStatus(m) {
         local: msgToSyncBranch(m.local),
         synced: msgToSyncBranch(m.synced),
         remote: msgToSyncBranch(m.remote),
-        existsInSyncedParent: (0, protobuf_msg_1.valOfOpt)(m.existsInSyncedParent)
+        existsInSyncedParent: (0, protobuf_msg_1.valOfOpt)(m.existsInSyncedParent),
+        uploading: msgToUploading(m.uploading)
     };
 }
 function syncBranchToMsg(b) {
@@ -236,11 +244,28 @@ function msgToSyncBranch(m) {
     }
     return {
         latest: (0, protobuf_msg_1.valOfOptInt)(m.latest),
-        archived: ((m.archived.length > 0) ?
-            m.archived.map(protobuf_msg_1.fixInt) : undefined),
+        archived: ((m.archived.length > 0) ? m.archived.map(protobuf_msg_1.fixInt) : undefined),
         isArchived: (0, protobuf_msg_1.valOfOpt)(m.isArchived)
     };
 }
+function uploadingToMsg(u) {
+    if (!u) {
+        return;
+    }
+    const { localVersion, remoteVersion, uploadStarted, bytesLeftToUpload } = u;
+    return { localVersion, remoteVersion, uploadStarted, bytesLeftToUpload };
+}
+function msgToUploading(u) {
+    if (!u) {
+        return;
+    }
+    return {
+        localVersion: (0, protobuf_msg_1.fixInt)(u.localVersion),
+        remoteVersion: (0, protobuf_msg_1.fixInt)(u.remoteVersion),
+        bytesLeftToUpload: (0, protobuf_msg_1.fixInt)(u.bytesLeftToUpload),
+        uploadStarted: u.uploadStarted
+    };
+}
 const syncStatusMsgType = protobuf_type_1.ProtoType.for(file_proto_1.file.SyncStatusMsg);
 function packSyncStatus(s) {
     return syncStatusMsgType.pack(syncStatusToMsg(s));
@@ -556,6 +581,25 @@ function versionedReadFlagsToMsg(flags) {
         remoteVersion: (0, protobuf_msg_1.toOptVal)(flags.remoteVersion)
     };
 }
+var vStat;
+(function (vStat) {
+    function wrapService(fn) {
+        return buf => {
+            const promise = fn(unpackVersionedReadFlagsRequest(buf))
+                .then(packStats);
+            return { promise };
+        };
+    }
+    vStat.wrapService = wrapService;
+    function makeCaller(caller, objPath) {
+        const path = (0, protobuf_msg_1.methodPathFor)(objPath, 'stat');
+        return flags => caller
+            .startPromiseCall(path, packVersionedReadFlagsRequest(flags))
+            .then(unpackStats);
+    }
+    vStat.makeCaller = makeCaller;
+})(vStat || (exports.vStat = vStat = {}));
+Object.freeze(vStat);
 var vGetXAttr;
 (function (vGetXAttr) {
     const requestType = protobuf_type_1.ProtoType.for(file_proto_1.file.VersionedGetXAttrRequestBody);

package/build/core-ipc/fs.js

@@ -83,6 +83,7 @@ function makeFSCaller(caller, fsMsg) {
         const vPath = (0, protobuf_msg_1.methodPathFor)(objPath, 'v');
         fs.v = {
             getByteSource: vGetByteSource.makeCaller(caller, vPath),
+            stat: vStat.makeCaller(caller, vPath),
             getXAttr: vGetXAttr.makeCaller(caller, vPath),
             listXAttrs: vListXAttrs.makeCaller(caller, vPath),
             listFolder: vListFolder.makeCaller(caller, vPath),
@@ -161,6 +162,7 @@ function exposeFSService(fs, expServices) {
     if (fs.v) {
         implExp.v = {
             getByteSource: vGetByteSource.wrapService(fs.v.getByteSource, expServices),
+            stat: vStat.wrapService(fs.v.stat),
             getXAttr: vGetXAttr.wrapService(fs.v.getXAttr),
             listXAttrs: vListXAttrs.wrapService(fs.v.listXAttrs),
             listFolder: vListFolder.wrapService(fs.v.listFolder),
@@ -1181,6 +1183,26 @@ function unpackRequestWithPathAndFlags(buf) {
         flags: file.versionedReadFlagsFromMsg(flags)
     };
 }
+var vStat;
+(function (vStat) {
+    function wrapService(fn) {
+        return buf => {
+            const { path, flags } = unpackRequestWithPathAndFlags(buf);
+            const promise = fn(path, flags)
+                .then(file.packStats);
+            return { promise };
+        };
+    }
+    vStat.wrapService = wrapService;
+    function makeCaller(caller, objPath) {
+        const ipcPath = (0, protobuf_msg_1.methodPathFor)(objPath, 'stat');
+        return (path, flags) => caller
+            .startPromiseCall(ipcPath, packRequestWithPathAndFlags(path, flags))
+            .then(file.unpackStats);
+    }
+    vStat.makeCaller = makeCaller;
+})(vStat || (vStat = {}));
+Object.freeze(vStat);
 var vGetXAttr;
 (function (vGetXAttr) {
     const requestType = protobuf_type_1.ProtoType.for(fs_proto_1.fs.VersionedGetXAttrRequestBody);

package/build/lib-client/fs-utils/files.js

@@ -62,6 +62,7 @@ function wrapWritableFileVersionedAPI(vImpl) {
         return;
     }
     const w = {
+        stat: vImpl.stat.bind(vImpl),
         getXAttr: vImpl.getXAttr.bind(vImpl),
         listXAttrs: vImpl.listXAttrs.bind(vImpl),
         updateXAttrs: vImpl.updateXAttrs.bind(vImpl),
@@ -120,6 +121,7 @@ function wrapReadonlyFileVersionedAPI(vImpl) {
         return;
     }
     const w = {
+        stat: vImpl.stat.bind(vImpl),
         getXAttr: vImpl.getXAttr.bind(vImpl),
         listXAttrs: vImpl.listXAttrs.bind(vImpl),
         getByteSource: vImpl.getByteSource.bind(vImpl),
@@ -206,6 +208,7 @@ function wrapWritableFSVersionedAPI(vImpl) {
         return;
     }
     const w = {
+        stat: vImpl.stat.bind(vImpl),
         getXAttr: vImpl.getXAttr.bind(vImpl),
         listXAttrs: vImpl.listXAttrs.bind(vImpl),
         updateXAttrs: vImpl.updateXAttrs.bind(vImpl),
@@ -272,6 +275,7 @@ function wrapReadonlyFSVersionedAPI(vImpl) {
         return;
     }
     const w = {
+        stat: vImpl.stat.bind(vImpl),
         getXAttr: vImpl.getXAttr.bind(vImpl),
         listXAttrs: vImpl.listXAttrs.bind(vImpl),
         getByteSource: vImpl.getByteSource.bind(vImpl),

package/build/lib-client/xsp-fs/file-node.d.ts

@@ -12,6 +12,7 @@ type FileByteSource = web3n.files.FileByteSource;
 type FileByteSink = web3n.files.FileByteSink;
 type XAttrsChanges = web3n.files.XAttrsChanges;
 type VersionedReadFlags = web3n.files.VersionedReadFlags;
+type Stats = web3n.files.Stats;
 interface FileAttrs {
     attrs: CommonAttrs;
     size: number;
@@ -19,7 +20,7 @@ interface FileAttrs {
 }
 declare class FilePersistance extends NodePersistance {
     constructor(zNonce: Uint8Array, key: Uint8Array, cryptor: AsyncSBoxCryptor);
-    getAttrs(objSrc: ObjSource): Promise<FileAttrs>;
+    getFileAttrs(objSrc: ObjSource): Promise<FileAttrs>;
     getFileSource(objSrc: ObjSource): Promise<FileByteSource>;
     readBytes(objSrc: ObjSource, start: number | undefined, end: number | undefined): Promise<Uint8Array | undefined>;
     saveBytes(bytes: Uint8Array | Uint8Array[], version: number, attrs: CommonAttrs, xattrs: XAttrs | undefined): Promise<Subscribe>;
@@ -42,7 +43,7 @@ export declare class FileNode extends NodeInFS<FilePersistance> {
     private static initWithAttrs;
     protected setCurrentStateFrom(src: ObjSource): Promise<void>;
     private setUpdatedState;
-    get size(): number;
+    getStats(flags?: VersionedReadFlags): Promise<Stats>;
     readSrc(flags: VersionedReadFlags | undefined): Promise<{
         src: FileByteSource;
         version: number;

package/build/lib-client/xsp-fs/file-node.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
@@ -29,19 +29,16 @@ const assert_1 = require("../../lib-common/assert");
 const attrs_1 = require("./attrs");
 const file_1 = require("../../lib-common/exceptions/file");
 const node_persistence_1 = require("./node-persistence");
-async function fileAttrsFrom(payload) {
-    const attrs = payload.getAttrs();
-    const xattrs = await payload.getXAttrs();
-    return { attrs: attrs_1.CommonAttrs.fromAttrs(attrs), size: attrs.size, xattrs };
-}
 class FilePersistance extends node_persistence_1.NodePersistance {
     constructor(zNonce, key, cryptor) {
         super(zNonce, key, cryptor);
         Object.seal(this);
     }
-    async getAttrs(objSrc) {
+    async getFileAttrs(objSrc) {
         const payload = await super.readonlyPayload(objSrc);
-        return await fileAttrsFrom(payload);
+        const attrs = payload.getAttrs();
+        const xattrs = await payload.getXAttrs();
+        return { attrs: attrs_1.CommonAttrs.fromAttrs(attrs), size: attrs.size, xattrs };
     }
     async getFileSource(objSrc) {
         const payload = await this.readonlyPayload(objSrc);
@@ -122,15 +119,37 @@ class FileNode extends node_in_fs_1.NodeInFS {
         return file;
     }
     async setCurrentStateFrom(src) {
-        const fileAttrs = await this.crypto.getAttrs(src);
+        const fileAttrs = await this.crypto.getFileAttrs(src);
         this.setUpdatedState(src.version, fileAttrs);
     }
     setUpdatedState(version, fileAttrs) {
         this.fileSize = fileAttrs.size;
         super.setUpdatedParams(version, fileAttrs.attrs, fileAttrs.xattrs);
     }
-    get size() {
-        return this.fileSize;
+    async getStats(flags) {
+        let attrs;
+        let version;
+        let size;
+        if ((0, node_in_fs_1.shouldReadCurrentVersion)(flags)) {
+            attrs = this.attrs;
+            version = this.version;
+            size = this.fileSize;
+        }
+        else {
+            const src = await this.getObjSrcOfVersion(flags);
+            const fileAttrs = await this.crypto.getFileAttrs(src);
+            attrs = fileAttrs.attrs;
+            version = src.version;
+            size = fileAttrs.size;
+        }
+        return {
+            ctime: new Date(attrs.ctime),
+            mtime: new Date(attrs.mtime),
+            version,
+            writable: false,
+            isFile: true,
+            size
+        };
     }
     async readSrc(flags) {
         const objSrc = await this.getObjSrcOfVersion(flags);

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

@@ -54,6 +54,7 @@ declare class V implements WritableFileVersionedAPI, N {
     constructor(name: string, node: FileNode | undefined, makeOrGetNode: (() => Promise<FileNode>) | undefined, writable: boolean, isInSyncedStorage: boolean);
     getNode(): Promise<FileNode>;
     ensureIsWritable(): void;
+    stat(flags?: VersionedReadFlags): Promise<Stats>;
     updateXAttrs(changes: XAttrsChanges): Promise<number>;
     getXAttr(xaName: string, flags?: VersionedReadFlags): Promise<{
         attr: any;

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

@@ -54,18 +54,8 @@ class FileObject {
         linkParams.readonly = !this.writable;
         return linkParams;
     }
-    async stat() {
-        const node = await this.v.getNode();
-        const attrs = node.getAttrs();
-        const stat = {
-            writable: this.writable,
-            size: node.size,
-            version: node.version,
-            isFile: true,
-            ctime: new Date(attrs.ctime),
-            mtime: new Date(attrs.mtime),
-        };
-        return stat;
+    stat() {
+        return this.v.stat();
     }
     async updateXAttrs(changes) {
         await this.v.updateXAttrs(changes);
@@ -143,6 +133,12 @@ class V {
             throw new Error(`File is not writable`);
         }
     }
+    async stat(flags) {
+        const node = await this.getNode();
+        const stats = await node.getStats(flags);
+        stats.writable = this.writable;
+        return stats;
+    }
     async updateXAttrs(changes) {
         this.ensureIsWritable();
         const node = await this.getNode();

package/build/lib-client/xsp-fs/folder-node.d.ts

@@ -13,6 +13,7 @@ type OptionsToAdopteRemote = web3n.files.OptionsToAdopteRemote;
 type OptionsToAdoptRemoteItem = web3n.files.OptionsToAdoptRemoteItem;
 type OptionsToUploadLocal = web3n.files.OptionsToUploadLocal;
 type VersionedReadFlags = web3n.files.VersionedReadFlags;
+type Stats = web3n.files.Stats;
 export interface NodeInfo {
     /**
      * This is a usual file name.
@@ -74,6 +75,7 @@ export declare class FolderNode extends NodeInFS<FolderPersistance> {
     private static readNodeFromObjBytes;
     static rootFromLinkParams(storage: Storage, params: FolderLinkParams): Promise<FolderNode>;
     static rootFromJSON(storage: Storage, name: string | undefined, folderJson: FolderInJSON): FolderNode;
+    getStats(flags?: VersionedReadFlags): Promise<Stats>;
     protected setCurrentStateFrom(src: ObjSource): Promise<void>;
     adoptRemote(opts: OptionsToAdopteRemote | undefined): Promise<void>;
     private callRemoveObjOn;

package/build/lib-client/xsp-fs/folder-node.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
@@ -162,6 +162,26 @@ class FolderNode extends node_in_fs_1.NodeInFS {
         rf.setUpdatedParams(0, attrs, xattrs);
         return rf;
     }
+    async getStats(flags) {
+        let attrs;
+        let version;
+        if ((0, node_in_fs_1.shouldReadCurrentVersion)(flags)) {
+            attrs = this.attrs;
+            version = this.version;
+        }
+        else {
+            const src = await this.getObjSrcOfVersion(flags);
+            attrs = await this.crypto.getAttrs(src);
+            version = src.version;
+        }
+        return {
+            ctime: new Date(attrs.ctime),
+            mtime: new Date(attrs.mtime),
+            version,
+            writable: false,
+            isFolder: true,
+        };
+    }
     async setCurrentStateFrom(src) {
         const { folderInfo, attrs, xattrs } = await this.crypto.read(src);
         this.currentState = folderInfo;

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

@@ -121,6 +121,7 @@ declare class V implements WritableFSVersionedAPI, N {
     getOrCreateFile(path: string, flags: FileFlags): Promise<FileNode>;
     get(path: string): Promise<NodeInFS<any>>;
     ensureIsWritable(): void;
+    stat(path: string, flags?: VersionedReadFlags): Promise<Stats>;
     updateXAttrs(path: string, changes: XAttrsChanges): Promise<number>;
     getXAttr(path: string, xaName: string, flags?: VersionedReadFlags): Promise<{
         attr: any;

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

@@ -204,31 +204,8 @@ class XspFS {
             throw exc;
         }
     }
-    async stat(path) {
-        const node = await this.v.get(path);
-        const attrs = node.getAttrs();
-        const stats = {
-            ctime: new Date(attrs.ctime),
-            mtime: new Date(attrs.mtime),
-            version: node.version,
-            writable: this.writable,
-        };
-        if (node.type === 'file') {
-            stats.size = node.size;
-            stats.isFile = true;
-            return stats;
-        }
-        else if (node.type === 'folder') {
-            stats.isFolder = true;
-            return stats;
-        }
-        else if (node.type === 'link') {
-            stats.isLink = true;
-            return stats;
-        }
-        else {
-            throw new Error(`Unknown type of fs node`);
-        }
+    stat(path) {
+        return this.v.stat(path);
     }
     async updateXAttrs(path, changes) {
         await this.v.updateXAttrs(path, changes);
@@ -551,6 +528,12 @@ class V {
             throw new Error(`FS is not writable`);
         }
     }
+    async stat(path, flags) {
+        const node = await this.get(path);
+        const stats = await node.getStats(flags);
+        stats.writable = this.writable;
+        return stats;
+    }
     async updateXAttrs(path, changes) {
         this.ensureIsWritable();
         const node = await this.get(path);

package/build/lib-client/xsp-fs/link-node.d.ts

@@ -8,6 +8,8 @@ import { Storage, AsyncSBoxCryptor } from './common';
 import { ObjSource, Subscribe } from 'xsp-files';
 import { CommonAttrs, XAttrs } from './attrs';
 import { NodePersistance } from './node-persistence';
+type VersionedReadFlags = web3n.files.VersionedReadFlags;
+type Stats = web3n.files.Stats;
 declare class LinkPersistance extends NodePersistance {
     constructor(zNonce: Uint8Array, key: Uint8Array, cryptor: AsyncSBoxCryptor);
     read(src: ObjSource): Promise<{
@@ -25,6 +27,7 @@ export declare class LinkNode extends NodeInFS<LinkPersistance> {
     static makeForNew(storage: Storage, parentId: string, name: string, key: Uint8Array): Promise<LinkNode>;
     static makeForExisting(storage: Storage, parentId: string, name: string, objId: string, key: Uint8Array): Promise<LinkNode>;
     protected setCurrentStateFrom(src: ObjSource): Promise<void>;
+    getStats(flags?: VersionedReadFlags): Promise<Stats>;
     private setUpdatedState;
     save(params: LinkParameters<any>, changes?: XAttrsChanges): Promise<void>;
     private getLinkParams;