@zenfs/core 1.2.5 → 1.2.6

package/dist/config.d.ts

@@ -61,6 +61,15 @@ export interface Configuration<T extends ConfigMounts> extends SharedConfig {
      * @default false
      */
     disableUpdateOnRead: boolean;
+    /**
+     * If true, files will only sync to the file system when closed.
+     *
+     * This can increase performance.
+     * @experimental
+     * @overrides `disableUpdateOnRead`
+     * @default false
+     */
+    onlySyncOnClose: boolean;
 }
 /**
  * Configures ZenFS with single mount point /

package/dist/config.js

@@ -70,7 +70,8 @@ export async function configure(configuration) {
     Object.assign(credentials, { uid, gid, suid: uid, sgid: gid, euid: uid, egid: gid });
     cache.setEnabled(configuration.cacheStats ?? false);
     config.checkAccess = !configuration.disableAccessChecks;
-    config.updateOnRead = !configuration.disableUpdateOnRead;
+    config.syncOnRead = !configuration.onlySyncOnClose || !configuration.disableUpdateOnRead;
+    config.syncOnWrite = !configuration.onlySyncOnClose;
     if (configuration.addDevices) {
         const devfs = new DeviceFS();
         devfs.createDevice('/null', nullDevice);

package/dist/emulation/config.d.ts

@@ -6,7 +6,11 @@ export declare const config: {
     /**
      * Whether to sync atime updates immediately when reading from a file
      */
-    updateOnRead: boolean;
+    syncOnRead: boolean;
+    /**
+     * Whether to immediately sync when files are written to
+     */
+    syncOnWrite: boolean;
     /**
      * If a file's buffer is not large enough to store content when writing and the buffer can't be resized, reuse the buffer passed to write()
      */

package/dist/emulation/config.js

@@ -6,7 +6,11 @@ export const config = {
     /**
      * Whether to sync atime updates immediately when reading from a file
      */
-    updateOnRead: true,
+    syncOnRead: true,
+    /**
+     * Whether to immediately sync when files are written to
+     */
+    syncOnWrite: true,
     /**
      * If a file's buffer is not large enough to store content when writing and the buffer can't be resized, reuse the buffer passed to write()
      */

package/dist/file.js

@@ -289,11 +289,13 @@ export class PreloadFile extends File {
     }
     async truncate(length) {
         this._truncate(length);
-        await this.sync();
+        if (config.syncOnWrite)
+            await this.sync();
     }
     truncateSync(length) {
         this._truncate(length);
-        this.syncSync();
+        if (config.syncOnWrite)
+            this.syncSync();
     }
     _write(buffer, offset = 0, length = this.stats.size, position = this.position) {
         if (this.closed) {
@@ -337,7 +339,8 @@ export class PreloadFile extends File {
      */
     async write(buffer, offset, length, position) {
         const bytesWritten = this._write(buffer, offset, length, position);
-        await this.sync();
+        if (config.syncOnWrite)
+            await this.sync();
         return bytesWritten;
     }
     /**
@@ -351,7 +354,8 @@ export class PreloadFile extends File {
      */
     writeSync(buffer, offset = 0, length = this.stats.size, position = this.position) {
         const bytesWritten = this._write(buffer, offset, length, position);
-        this.syncSync();
+        if (config.syncOnWrite)
+            this.syncSync();
         return bytesWritten;
     }
     _read(buffer, offset = 0, length = this.stats.size, position) {
@@ -361,10 +365,8 @@ export class PreloadFile extends File {
         if (!isReadable(this.flag)) {
             throw new ErrnoError(Errno.EPERM, 'File not opened with a readable mode.');
         }
-        if (config.updateOnRead) {
-            this.dirty = true;
-            this.stats.atimeMs = Date.now();
-        }
+        this.dirty = true;
+        this.stats.atimeMs = Date.now();
         position ?? (position = this.position);
         let end = position + length;
         if (end > this.stats.size) {
@@ -389,7 +391,8 @@ export class PreloadFile extends File {
      */
     async read(buffer, offset, length, position) {
         const bytesRead = this._read(buffer, offset, length, position);
-        await this.sync();
+        if (config.syncOnRead)
+            await this.sync();
         return { bytesRead, buffer };
     }
     /**
@@ -403,7 +406,8 @@ export class PreloadFile extends File {
      */
     readSync(buffer, offset, length, position) {
         const bytesRead = this._read(buffer, offset, length, position);
-        this.syncSync();
+        if (config.syncOnRead)
+            this.syncSync();
         return bytesRead;
     }
     async chmod(mode) {
@@ -412,7 +416,8 @@ export class PreloadFile extends File {
         }
         this.dirty = true;
         this.stats.chmod(mode);
-        await this.sync();
+        if (config.syncOnWrite)
+            await this.sync();
     }
     chmodSync(mode) {
         if (this.closed) {
@@ -420,7 +425,8 @@ export class PreloadFile extends File {
         }
         this.dirty = true;
         this.stats.chmod(mode);
-        this.syncSync();
+        if (config.syncOnWrite)
+            this.syncSync();
     }
     async chown(uid, gid) {
         if (this.closed) {
@@ -428,7 +434,8 @@ export class PreloadFile extends File {
         }
         this.dirty = true;
         this.stats.chown(uid, gid);
-        await this.sync();
+        if (config.syncOnWrite)
+            await this.sync();
     }
     chownSync(uid, gid) {
         if (this.closed) {
@@ -436,7 +443,8 @@ export class PreloadFile extends File {
         }
         this.dirty = true;
         this.stats.chown(uid, gid);
-        this.syncSync();
+        if (config.syncOnWrite)
+            this.syncSync();
     }
     async utimes(atime, mtime) {
         if (this.closed) {
@@ -445,7 +453,8 @@ export class PreloadFile extends File {
         this.dirty = true;
         this.stats.atime = atime;
         this.stats.mtime = mtime;
-        await this.sync();
+        if (config.syncOnWrite)
+            await this.sync();
     }
     utimesSync(atime, mtime) {
         if (this.closed) {
@@ -454,7 +463,8 @@ export class PreloadFile extends File {
         this.dirty = true;
         this.stats.atime = atime;
         this.stats.mtime = mtime;
-        this.syncSync();
+        if (config.syncOnWrite)
+            this.syncSync();
     }
     async _setType(type) {
         if (this.closed) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zenfs/core",
-	"version": "1.2.5",
+	"version": "1.2.6",
 	"description": "A filesystem, anywhere",
 	"funding": {
 		"type": "individual",

package/src/config.ts

@@ -126,6 +126,16 @@ export interface Configuration<T extends ConfigMounts> extends SharedConfig {
 	 * @default false
 	 */
 	disableUpdateOnRead: boolean;
+
+	/**
+	 * If true, files will only sync to the file system when closed.
+	 *
+	 * This can increase performance.
+	 * @experimental
+	 * @overrides `disableUpdateOnRead`
+	 * @default false
+	 */
+	onlySyncOnClose: boolean;
 }
 
 /**
@@ -153,7 +163,8 @@ export async function configure<T extends ConfigMounts>(configuration: Partial<C
 
 	cache.setEnabled(configuration.cacheStats ?? false);
 	config.checkAccess = !configuration.disableAccessChecks;
-	config.updateOnRead = !configuration.disableUpdateOnRead;
+	config.syncOnRead = !configuration.onlySyncOnClose || !configuration.disableUpdateOnRead;
+	config.syncOnWrite = !configuration.onlySyncOnClose;
 
 	if (configuration.addDevices) {
 		const devfs = new DeviceFS();

package/src/emulation/config.ts

@@ -7,7 +7,12 @@ export const config = {
 	/**
 	 * Whether to sync atime updates immediately when reading from a file
 	 */
-	updateOnRead: true,
+	syncOnRead: true,
+
+	/**
+	 * Whether to immediately sync when files are written to
+	 */
+	syncOnWrite: true,
 
 	/**
 	 * If a file's buffer is not large enough to store content when writing and the buffer can't be resized, reuse the buffer passed to write()

package/src/file.ts

@@ -441,12 +441,12 @@ export class PreloadFile<FS extends FileSystem> extends File {
 
 	public async truncate(length: number): Promise<void> {
 		this._truncate(length);
-		await this.sync();
+		if (config.syncOnWrite) await this.sync();
 	}
 
 	public truncateSync(length: number): void {
 		this._truncate(length);
-		this.syncSync();
+		if (config.syncOnWrite) this.syncSync();
 	}
 
 	protected _write(buffer: Uint8Array, offset: number = 0, length: number = this.stats.size, position: number = this.position): number {
@@ -494,7 +494,7 @@ export class PreloadFile<FS extends FileSystem> extends File {
 	 */
 	public async write(buffer: Uint8Array, offset?: number, length?: number, position?: number): Promise<number> {
 		const bytesWritten = this._write(buffer, offset, length, position);
-		await this.sync();
+		if (config.syncOnWrite) await this.sync();
 		return bytesWritten;
 	}
 
@@ -509,7 +509,7 @@ export class PreloadFile<FS extends FileSystem> extends File {
 	 */
 	public writeSync(buffer: Uint8Array, offset: number = 0, length: number = this.stats.size, position: number = this.position): number {
 		const bytesWritten = this._write(buffer, offset, length, position);
-		this.syncSync();
+		if (config.syncOnWrite) this.syncSync();
 		return bytesWritten;
 	}
 
@@ -520,10 +520,8 @@ export class PreloadFile<FS extends FileSystem> extends File {
 		if (!isReadable(this.flag)) {
 			throw new ErrnoError(Errno.EPERM, 'File not opened with a readable mode.');
 		}
-		if (config.updateOnRead) {
-			this.dirty = true;
-			this.stats.atimeMs = Date.now();
-		}
+		this.dirty = true;
+		this.stats.atimeMs = Date.now();
 		position ??= this.position;
 		let end = position + length;
 		if (end > this.stats.size) {
@@ -549,7 +547,7 @@ export class PreloadFile<FS extends FileSystem> extends File {
 	 */
 	public async read<TBuffer extends ArrayBufferView>(buffer: TBuffer, offset?: number, length?: number, position?: number): Promise<{ bytesRead: number; buffer: TBuffer }> {
 		const bytesRead = this._read(buffer, offset, length, position);
-		await this.sync();
+		if (config.syncOnRead) await this.sync();
 		return { bytesRead, buffer };
 	}
 
@@ -564,7 +562,7 @@ export class PreloadFile<FS extends FileSystem> extends File {
 	 */
 	public readSync(buffer: ArrayBufferView, offset?: number, length?: number, position?: number): number {
 		const bytesRead = this._read(buffer, offset, length, position);
-		this.syncSync();
+		if (config.syncOnRead) this.syncSync();
 		return bytesRead;
 	}
 
@@ -574,7 +572,7 @@ export class PreloadFile<FS extends FileSystem> extends File {
 		}
 		this.dirty = true;
 		this.stats.chmod(mode);
-		await this.sync();
+		if (config.syncOnWrite) await this.sync();
 	}
 
 	public chmodSync(mode: number): void {
@@ -583,7 +581,7 @@ export class PreloadFile<FS extends FileSystem> extends File {
 		}
 		this.dirty = true;
 		this.stats.chmod(mode);
-		this.syncSync();
+		if (config.syncOnWrite) this.syncSync();
 	}
 
 	public async chown(uid: number, gid: number): Promise<void> {
@@ -592,7 +590,7 @@ export class PreloadFile<FS extends FileSystem> extends File {
 		}
 		this.dirty = true;
 		this.stats.chown(uid, gid);
-		await this.sync();
+		if (config.syncOnWrite) await this.sync();
 	}
 
 	public chownSync(uid: number, gid: number): void {
@@ -601,7 +599,7 @@ export class PreloadFile<FS extends FileSystem> extends File {
 		}
 		this.dirty = true;
 		this.stats.chown(uid, gid);
-		this.syncSync();
+		if (config.syncOnWrite) this.syncSync();
 	}
 
 	public async utimes(atime: Date, mtime: Date): Promise<void> {
@@ -611,7 +609,7 @@ export class PreloadFile<FS extends FileSystem> extends File {
 		this.dirty = true;
 		this.stats.atime = atime;
 		this.stats.mtime = mtime;
-		await this.sync();
+		if (config.syncOnWrite) await this.sync();
 	}
 
 	public utimesSync(atime: Date, mtime: Date): void {
@@ -621,7 +619,7 @@ export class PreloadFile<FS extends FileSystem> extends File {
 		this.dirty = true;
 		this.stats.atime = atime;
 		this.stats.mtime = mtime;
-		this.syncSync();
+		if (config.syncOnWrite) this.syncSync();
 	}
 
 	public async _setType(type: FileType): Promise<void> {