core-3nweb-client-lib 0.44.2 → 0.44.4

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

@@ -86,6 +86,7 @@ function wrapWritableFileSyncAPI(sImpl) {
         return;
     }
     const w = {
+        whenConnected: sImpl.whenConnected.bind(sImpl),
         status: sImpl.status.bind(sImpl),
         startDownload: sImpl.startDownload.bind(sImpl),
         isRemoteVersionOnDisk: sImpl.isRemoteVersionOnDisk.bind(sImpl),
@@ -140,6 +141,7 @@ function wrapReadonlyFileSyncAPI(sImpl) {
         return;
     }
     const w = {
+        whenConnected: sImpl.whenConnected.bind(sImpl),
         status: sImpl.status.bind(sImpl),
         startDownload: sImpl.startDownload.bind(sImpl),
         isRemoteVersionOnDisk: sImpl.isRemoteVersionOnDisk.bind(sImpl),
@@ -235,6 +237,7 @@ function wrapWritableFSSyncAPI(sImpl) {
         return;
     }
     const w = {
+        whenConnected: sImpl.whenConnected.bind(sImpl),
         status: sImpl.status.bind(sImpl),
         startDownload: sImpl.startDownload.bind(sImpl),
         isRemoteVersionOnDisk: sImpl.isRemoteVersionOnDisk.bind(sImpl),
@@ -248,7 +251,7 @@ function wrapWritableFSSyncAPI(sImpl) {
         getRemoteFileItem: sImpl.getRemoteFileItem.bind(sImpl),
         getRemoteFolderItem: sImpl.getRemoteFolderItem.bind(sImpl),
         diffCurrentAndRemoteFileVersions: sImpl.diffCurrentAndRemoteFileVersions.bind(sImpl),
-        mergeFolderCurrentAndRemoteVersions: sImpl.mergeFolderCurrentAndRemoteVersions.bind(sImpl),
+        absorbRemoteFolderChanges: sImpl.absorbRemoteFolderChanges.bind(sImpl),
     };
     return Object.freeze(w);
 }
@@ -303,6 +306,7 @@ function wrapReadonlyFSSyncAPI(sImpl) {
         return;
     }
     const w = {
+        whenConnected: sImpl.whenConnected.bind(sImpl),
         status: sImpl.status.bind(sImpl),
         startDownload: sImpl.startDownload.bind(sImpl),
         isRemoteVersionOnDisk: sImpl.isRemoteVersionOnDisk.bind(sImpl),

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

@@ -121,6 +121,7 @@ export interface SyncedStorage extends Storage {
     suspendNetworkActivity(): void;
     resumeNetworkActivity(): void;
     connectionEvent$: Observable<StorageConnectionStatus>;
+    whenConnected(): Promise<void>;
 }
 export interface SyncedObjStatus extends LocalObjStatus {
     syncStatus(): SyncStatus;

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

@@ -127,6 +127,7 @@ function wrapSyncStorageImplementation(impl) {
     wrap.resumeNetworkActivity = impl.resumeNetworkActivity.bind(impl);
     wrap.getNumOfBytesNeedingDownload = impl.getNumOfBytesNeedingDownload.bind(impl);
     wrap.connectionEvent$ = impl.connectionEvent$;
+    wrap.whenConnected = impl.whenConnected.bind(impl);
     return Object.freeze(wrap);
 }
 function isSyncedStorage(storage) {

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

@@ -41,9 +41,10 @@ export declare class FileNode extends NodeInFS<FilePersistance> {
     static makeForNew(storage: Storage, parentId: string, name: string, key: Uint8Array): Promise<FileNode>;
     static makeForExisting(storage: Storage, parentId: string, fileName: string, objId: string, key: Uint8Array): Promise<FileNode>;
     static makeFromLinkParams(storage: Storage, params: FileLinkParams): Promise<FileNode>;
-    private static initWithAttrs;
+    static readNodeFromObjBytes(storage: Storage, parentId: string | undefined, fileName: string, objId: string, src: ObjSource, key: Uint8Array): Promise<FileNode>;
     protected setCurrentStateFrom(src: ObjSource): Promise<void>;
     private setUpdatedState;
+    getStorage(): Storage;
     getStats(flags?: VersionedReadFlags): Promise<Stats>;
     readSrc(flags: VersionedReadFlags | undefined): Promise<{
         src: FileByteSource;

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

@@ -103,17 +103,18 @@ class FileNode extends node_in_fs_1.NodeInFS {
         if (!parentId) {
             throw new Error("Bad parent id");
         }
-        const file = await FileNode.initWithAttrs(storage, parentId, fileName, objId, key);
+        const src = await storage.getObjSrc(objId);
+        const file = await FileNode.readNodeFromObjBytes(storage, parentId, fileName, objId, src, key);
         return file;
     }
     static async makeFromLinkParams(storage, params) {
         const { objId, fileName } = params;
         const key = buffer_utils_1.base64.open(params.fKey);
-        const file = await FileNode.initWithAttrs(storage, undefined, fileName, objId, key);
+        const src = await storage.getObjSrc(objId);
+        const file = await FileNode.readNodeFromObjBytes(storage, undefined, fileName, objId, src, key);
         return file;
     }
-    static async initWithAttrs(storage, parentId, fileName, objId, key) {
-        const src = await storage.getObjSrc(objId);
+    static async readNodeFromObjBytes(storage, parentId, fileName, objId, src, key) {
         const file = new FileNode(storage, fileName, objId, src.version, parentId, key);
         await file.setCurrentStateFrom(src);
         return file;
@@ -126,6 +127,9 @@ class FileNode extends node_in_fs_1.NodeInFS {
         this.fileSize = fileAttrs.size;
         super.setUpdatedParams(version, fileAttrs.attrs, fileAttrs.xattrs);
     }
+    getStorage() {
+        return this.storage;
+    }
     async getStats(flags) {
         const { stats, attrs } = await this.getStatsAndSize(flags);
         stats.size = (attrs ? attrs.size : this.fileSize);

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

@@ -100,6 +100,7 @@ declare class V implements WritableFileVersionedAPI, N {
 declare class S implements WritableFileSyncAPI {
     private readonly n;
     constructor(n: N);
+    whenConnected(): Promise<void>;
     startUpload(opts?: OptionsToUploadLocal): Promise<{
         uploadVersion: number;
         uploadTaskId: number;

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

@@ -224,6 +224,9 @@ class S {
         this.n = n;
         Object.freeze(this);
     }
+    async whenConnected() {
+        return (await this.n.getNode()).getStorage().whenConnected();
+    }
     async startUpload(opts) {
         this.n.ensureIsWritable();
         const node = await this.n.getNode();

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

@@ -14,7 +14,7 @@ type OptionsToAdoptRemoteItem = web3n.files.OptionsToAdoptRemoteItem;
 type OptionsToUploadLocal = web3n.files.OptionsToUploadLocal;
 type VersionedReadFlags = web3n.files.VersionedReadFlags;
 type Stats = web3n.files.Stats;
-type OptionsToMergeFolderVersions = web3n.files.OptionsToMergeFolderVersions;
+type OptionsToAdoptRemoteFolderChanges = web3n.files.OptionsToAdoptRemoteFolderChanges;
 export interface NodeInfo {
     /**
      * This is a usual file name.
@@ -96,6 +96,7 @@ export declare class FolderNode extends NodeInFS<FolderPersistance> {
     hasChild(childName: string, throwIfMissing?: boolean): boolean;
     getNode<T extends NodeInFS<any>>(type: NodeType | undefined, name: string, undefOnMissing?: boolean): Promise<T | undefined>;
     private getOrMakeChildNodeForInfo;
+    private getNonLocal;
     getFolder(name: string, undefOnMissing?: boolean): Promise<FolderNode | undefined>;
     getFile(name: string, undefOnMissing?: boolean): Promise<FileNode | undefined>;
     getLink(name: string, undefOnMissing?: boolean): Promise<LinkNode | undefined>;
@@ -178,6 +179,6 @@ export declare class FolderNode extends NodeInFS<FolderPersistance> {
     diffCurrentAndRemote(remoteVersion: number | undefined): Promise<FolderDiff | undefined>;
     getRemoteItemNode<T extends NodeInFS<any>>(remoteItemName: string, remoteVersion: number | undefined): Promise<T>;
     getStorage(): Storage;
-    mergeCurrentAndRemoteVersions(opts: OptionsToMergeFolderVersions | undefined): Promise<number | undefined>;
+    absorbRemoteChanges(opts: OptionsToAdoptRemoteFolderChanges | undefined): Promise<number | undefined>;
 }
 export {};

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

@@ -344,17 +344,59 @@ class FolderNode extends node_in_fs_1.NodeInFS {
             return nodeSet;
         }
         catch (exc) {
-            if (exc.objNotFound && fromCurrentNodes) {
-                await this.fixMissingChildAndThrow(exc, info);
-            }
-            else if (exc.failedCipherVerification) {
+            if (exc.failedCipherVerification) {
                 exc = (0, file_1.makeFileException)('ioError', `${this.name}/${info.name}`, exc);
             }
-            // XXX why and what ?
+            else if (exc.objNotFound) {
+                if (fromCurrentNodes) {
+                    await this.fixMissingChildAndThrow(exc, info);
+                }
+                else {
+                    try {
+                        const node = await this.getNonLocal(info);
+                        if (node) {
+                            deferred.resolve(node);
+                            return nodeSet;
+                        }
+                        else {
+                            throw exc;
+                        }
+                    }
+                    catch (exc2) {
+                        exc = exc2;
+                    }
+                }
+            }
             deferred.reject((0, error_1.errWithCause)(exc, `Failed to instantiate fs node '${this.name}/${info.name}'`));
             return nodeSet;
         }
     }
+    async getNonLocal(info) {
+        var _a;
+        const storage = this.syncedStorage();
+        const { objId, name, key } = info;
+        const status = await storage.status(objId);
+        const { remote, synced } = status.syncStatus();
+        const remoteVersion = (_a = remote === null || remote === void 0 ? void 0 : remote.latest) !== null && _a !== void 0 ? _a : synced === null || synced === void 0 ? void 0 : synced.latest;
+        if (!remoteVersion) {
+            return;
+        }
+        const src = await storage.getObjSrcOfRemoteVersion(info.objId, remoteVersion);
+        let node;
+        if (info.isFile) {
+            node = await file_node_1.FileNode.readNodeFromObjBytes(storage, undefined, name, objId, src, key);
+        }
+        else if (info.isFolder) {
+            node = await FolderNode.readNodeFromObjBytes(storage, undefined, objId, src, key);
+        }
+        else if (info.isLink) {
+            node = await link_node_1.LinkNode.readNodeFromObjBytes(storage, undefined, name, objId, src, key);
+        }
+        else {
+            throw new Error(`Unknown type of fs node`);
+        }
+        return node;
+    }
     getFolder(name, undefOnMissing = false) {
         return this.getNode('folder', name, undefOnMissing);
     }
@@ -377,61 +419,6 @@ class FolderNode extends node_in_fs_1.NodeInFS {
         fileExc.inconsistentStateOfFS = true;
         throw fileExc;
     }
-    // XXX should we keep this, when merge with certain inputs will do same action
-    // async adoptItemsFromRemoteVersion(opts: OptionsToAdoptAllRemoteItems|undefined): Promise<number|undefined> {
-    // 	const { state, remote } = await this.syncStatus();
-    // 	if ((state !== 'conflicting') && (state !== 'behind')) {
-    // 		return;
-    // 	}
-    // 	const remoteVersion = versionFromRemoteBranch(remote!, opts?.remoteVersion);
-    // 	if (!remoteVersion) {
-    // 		throw 'something';
-    // 	}
-    // 	const { folderInfo: remoteState } = await this.readRemoteVersion(remoteVersion);
-    // 	const synced = undefined;
-    // 	return await this.doChangeWhileTrackingVersion(opts?.localVersion, async (state, newVersion) => {
-    // 		const { inRemote, nameOverlaps, differentKeys } = diffNodes(state, remoteState, synced);
-    // 		if (differentKeys) {
-    // 			throw makeFSSyncException(this.name, {
-    // 				message: `There are different keys, and implementation for it is not implemented, yet.`
-    // 			});
-    // 		}
-    // 		const events: { event: FSEvent; childObjId: string; }[] = [];
-    // 		if (!inRemote) {
-    // 			return events;
-    // 		}
-    // 		const addedNodes = new Set<string>();
-    // 		if (nameOverlaps) {
-    // 			const postfix = opts?.postfixForNameOverlaps;
-    // 			if ((postfix === undefined) || (postfix.length < 0)) {
-    // 				// XXX better exception
-    // 				throw 'something';
-    // 			}
-    // 			for (const itemName of nameOverlaps) {
-    // 				const node = remoteState.nodes[itemName];
-    // 				let newName = `${itemName}${postfix}`;
-    // 				while (state.nodes[newName]) {
-    // 					newName = `${newName}${postfix}`;
-    // 				}
-    // 				node.name = newName;
-    // 				state.nodes[newName] = node;
-    // 				addedNodes.add(itemName);
-    // 				const { event, childObjId } = this.makeEntryAdditionEvent(newVersion, 'sync', node);
-    // 				events.push({ event, childObjId });
-    // 			}
-    // 		}
-    // 		for (const { name: itemName } of inRemote) {
-    // 			if (addedNodes.has(itemName)) {
-    // 				continue;
-    // 			}
-    // 			const node = remoteState.nodes[itemName];
-    // 			state.nodes[itemName] = node;
-    // 			const { event, childObjId } = this.makeEntryAdditionEvent(newVersion, 'sync', node);
-    // 			events.push({ event, childObjId });
-    // 		}
-    // 		return events;
-    // 	});
-    // }
     /**
      * If no initial local version given, then this performs like doTransition(change) method.
      * When initial local version is given and check, exceptions are thrown if versions mismatch,
@@ -1061,7 +1048,7 @@ class FolderNode extends node_in_fs_1.NodeInFS {
     getStorage() {
         return this.storage;
     }
-    async mergeCurrentAndRemoteVersions(opts) {
+    async absorbRemoteChanges(opts) {
         const diff = await this.diffCurrentAndRemote(opts === null || opts === void 0 ? void 0 : opts.remoteVersion);
         if (!diff) {
             return;

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

@@ -32,7 +32,7 @@ type OptionsToDiffFileVersions = web3n.files.OptionsToDiffFileVersions;
 type OptionsToUploadLocal = web3n.files.OptionsToUploadLocal;
 type FolderDiff = web3n.files.FolderDiff;
 type FileDiff = web3n.files.FileDiff;
-type OptionsToMergeFolderVersions = web3n.files.OptionsToMergeFolderVersions;
+type OptionsToAdoptRemoteFolderChanges = web3n.files.OptionsToAdoptRemoteFolderChanges;
 export declare class XspFS implements WritableFS {
     readonly writable: boolean;
     name: string;
@@ -166,6 +166,7 @@ declare class V implements WritableFSVersionedAPI, N {
 declare class S implements WritableFSSyncAPI {
     private readonly n;
     constructor(n: N);
+    whenConnected(): Promise<void>;
     startUpload(path: string, opts?: OptionsToUploadLocal): Promise<{
         uploadVersion: number;
         uploadTaskId: number;
@@ -187,6 +188,6 @@ declare class S implements WritableFSSyncAPI {
     listRemoteFolderItem(path: string, remoteItemName: string, remoteVersion?: number): Promise<ListingEntry[]>;
     getRemoteFileItem(path: string, remoteItemName: string, remoteVersion?: number): Promise<ReadonlyFile>;
     getRemoteFolderItem(path: string, remoteItemName: string, remoteVersion?: number): Promise<ReadonlyFS>;
-    mergeFolderCurrentAndRemoteVersions(path: string, opts?: OptionsToMergeFolderVersions): Promise<number | undefined>;
+    absorbRemoteFolderChanges(path: string, opts?: OptionsToAdoptRemoteFolderChanges): Promise<number | undefined>;
 }
 export {};

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

@@ -708,6 +708,9 @@ class S {
         this.n = n;
         Object.freeze(this);
     }
+    whenConnected() {
+        return this.n.getRootIfNotClosed('').getStorage().whenConnected();
+    }
     async startUpload(path, opts) {
         this.n.ensureIsWritable();
         const node = await this.n.get(path);
@@ -859,9 +862,9 @@ class S {
             throw (0, file_1.makeFileException)('notDirectory', `${path}/${remoteItemName}`);
         }
     }
-    async mergeFolderCurrentAndRemoteVersions(path, opts) {
+    async absorbRemoteFolderChanges(path, opts) {
         const folderNode = await this.getFolderNode(path);
-        return await folderNode.mergeCurrentAndRemoteVersions(opts);
+        return await folderNode.absorbRemoteChanges(opts);
     }
 }
 Object.freeze(S.prototype);

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

@@ -26,6 +26,7 @@ export declare class LinkNode extends NodeInFS<LinkPersistance> {
     constructor(storage: Storage, name: string, objId: string, version: number, parentId: string | undefined, key: Uint8Array);
     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>;
+    static readNodeFromObjBytes(storage: Storage, parentId: string | undefined, name: string, objId: string, src: ObjSource, key: Uint8Array): Promise<LinkNode>;
     protected setCurrentStateFrom(src: ObjSource): Promise<void>;
     getStats(flags?: VersionedReadFlags): Promise<Stats>;
     private setUpdatedState;

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

@@ -93,6 +93,9 @@ class LinkNode extends node_in_fs_1.NodeInFS {
     }
     static async makeForExisting(storage, parentId, name, objId, key) {
         const src = await storage.getObjSrc(objId);
+        return await LinkNode.readNodeFromObjBytes(storage, parentId, name, objId, src, key);
+    }
+    static async readNodeFromObjBytes(storage, parentId, name, objId, src, key) {
         const link = new LinkNode(storage, name, objId, src.version, parentId, key);
         const { params, attrs, xattrs } = await link.crypto.read(src);
         link.setUpdatedState(params, src.version, attrs, xattrs);

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

@@ -124,5 +124,5 @@ export declare abstract class NodeInFS<P extends NodePersistance> implements Nod
 }
 export declare function shouldReadCurrentVersion(flags: VersionedReadFlags | undefined): boolean;
 export declare function areBytesEqual(b1: Uint8Array, b2: Uint8Array): boolean;
-export declare function versionFromRemoteBranch(remote: SyncVersionsBranch, remoteVersion: number | undefined): number | undefined;
+export declare function versionFromBranch(branch: SyncVersionsBranch, versionInBranch: number | undefined): number | undefined;
 export {};

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

@@ -19,7 +19,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.NodeInFS = void 0;
 exports.shouldReadCurrentVersion = shouldReadCurrentVersion;
 exports.areBytesEqual = areBytesEqual;
-exports.versionFromRemoteBranch = versionFromRemoteBranch;
+exports.versionFromBranch = versionFromBranch;
 /**
  * Everything in this module is assumed to be inside of a file system
  * reliance set.
@@ -550,14 +550,19 @@ class NodeInFS {
         let isCurrentLocal;
         if (state === 'behind') {
             isCurrentLocal = false;
+            remoteVersion = versionFromBranch(remote, remoteVersion);
         }
         else if (state === 'conflicting') {
             isCurrentLocal = true;
+            remoteVersion = versionFromBranch(remote, remoteVersion);
+        }
+        else if (state === 'unsynced') {
+            isCurrentLocal = true;
+            remoteVersion = versionFromBranch(synced, remoteVersion);
         }
         else {
             return;
         }
-        remoteVersion = versionFromRemoteBranch(remote, remoteVersion);
         if (remoteVersion) {
             return { rm: false, isCurrentLocal, remoteVersion, syncedVersion: synced === null || synced === void 0 ? void 0 : synced.latest };
         }
@@ -708,23 +713,20 @@ function areBytesEqual(b1, b2) {
     }
     return true;
 }
-function versionFromRemoteBranch(remote, remoteVersion) {
+function versionFromBranch(branch, versionInBranch) {
     var _a;
-    if (remote.isArchived) {
-        return;
-    }
-    if (remoteVersion) {
-        if ((remoteVersion !== remote.latest)
-            && !((_a = remote.archived) === null || _a === void 0 ? void 0 : _a.includes(remoteVersion))) {
+    if (versionInBranch) {
+        if ((versionInBranch !== branch.latest)
+            && !((_a = branch.archived) === null || _a === void 0 ? void 0 : _a.includes(versionInBranch))) {
             throw (0, exceptions_1.makeFSSyncException)(this.name, {
                 versionMismatch: true,
-                message: `Unknown remote version ${remoteVersion}`
+                message: `Unknown version in branch: ${versionInBranch}`
             });
         }
-        return remoteVersion;
+        return versionInBranch;
     }
     else {
-        return remote.latest;
+        return branch.latest;
     }
 }
 Object.freeze(exports);

package/build/lib-common/exceptions/error.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.errWithCause = errWithCause;
 exports.recursiveErrJSONify = recursiveErrJSONify;