@zenfs/core 1.2.6 → 1.2.7

package/dist/config.js

@@ -70,8 +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.syncOnRead = !configuration.onlySyncOnClose || !configuration.disableUpdateOnRead;
-    config.syncOnWrite = !configuration.onlySyncOnClose;
+    config.updateOnRead = !configuration.disableUpdateOnRead;
+    config.syncImmediately = !configuration.onlySyncOnClose;
     if (configuration.addDevices) {
         const devfs = new DeviceFS();
         devfs.createDevice('/null', nullDevice);

package/dist/emulation/config.d.ts

@@ -4,13 +4,13 @@ export declare const config: {
      */
     checkAccess: boolean;
     /**
-     * Whether to sync atime updates immediately when reading from a file
+     * Whether to mark a file as dirty after updating its `atime` when read from
      */
-    syncOnRead: boolean;
+    updateOnRead: boolean;
     /**
-     * Whether to immediately sync when files are written to
+     * Whether to immediately sync when files are changed
      */
-    syncOnWrite: boolean;
+    syncImmediately: 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

@@ -4,13 +4,13 @@ export const config = {
      */
     checkAccess: true,
     /**
-     * Whether to sync atime updates immediately when reading from a file
+     * Whether to mark a file as dirty after updating its `atime` when read from
      */
-    syncOnRead: true,
+    updateOnRead: true,
     /**
-     * Whether to immediately sync when files are written to
+     * Whether to immediately sync when files are changed
      */
-    syncOnWrite: true,
+    syncImmediately: 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,12 +289,12 @@ export class PreloadFile extends File {
     }
     async truncate(length) {
         this._truncate(length);
-        if (config.syncOnWrite)
+        if (config.syncImmediately)
             await this.sync();
     }
     truncateSync(length) {
         this._truncate(length);
-        if (config.syncOnWrite)
+        if (config.syncImmediately)
             this.syncSync();
     }
     _write(buffer, offset = 0, length = this.stats.size, position = this.position) {
@@ -339,7 +339,7 @@ export class PreloadFile extends File {
      */
     async write(buffer, offset, length, position) {
         const bytesWritten = this._write(buffer, offset, length, position);
-        if (config.syncOnWrite)
+        if (config.syncImmediately)
             await this.sync();
         return bytesWritten;
     }
@@ -354,7 +354,7 @@ export class PreloadFile extends File {
      */
     writeSync(buffer, offset = 0, length = this.stats.size, position = this.position) {
         const bytesWritten = this._write(buffer, offset, length, position);
-        if (config.syncOnWrite)
+        if (config.syncImmediately)
             this.syncSync();
         return bytesWritten;
     }
@@ -365,7 +365,9 @@ export class PreloadFile extends File {
         if (!isReadable(this.flag)) {
             throw new ErrnoError(Errno.EPERM, 'File not opened with a readable mode.');
         }
-        this.dirty = true;
+        if (config.updateOnRead) {
+            this.dirty = true;
+        }
         this.stats.atimeMs = Date.now();
         position ?? (position = this.position);
         let end = position + length;
@@ -391,7 +393,7 @@ export class PreloadFile extends File {
      */
     async read(buffer, offset, length, position) {
         const bytesRead = this._read(buffer, offset, length, position);
-        if (config.syncOnRead)
+        if (config.syncImmediately)
             await this.sync();
         return { bytesRead, buffer };
     }
@@ -406,7 +408,7 @@ export class PreloadFile extends File {
      */
     readSync(buffer, offset, length, position) {
         const bytesRead = this._read(buffer, offset, length, position);
-        if (config.syncOnRead)
+        if (config.syncImmediately)
             this.syncSync();
         return bytesRead;
     }
@@ -416,7 +418,7 @@ export class PreloadFile extends File {
         }
         this.dirty = true;
         this.stats.chmod(mode);
-        if (config.syncOnWrite)
+        if (config.syncImmediately)
             await this.sync();
     }
     chmodSync(mode) {
@@ -425,7 +427,7 @@ export class PreloadFile extends File {
         }
         this.dirty = true;
         this.stats.chmod(mode);
-        if (config.syncOnWrite)
+        if (config.syncImmediately)
             this.syncSync();
     }
     async chown(uid, gid) {
@@ -434,7 +436,7 @@ export class PreloadFile extends File {
         }
         this.dirty = true;
         this.stats.chown(uid, gid);
-        if (config.syncOnWrite)
+        if (config.syncImmediately)
             await this.sync();
     }
     chownSync(uid, gid) {
@@ -443,7 +445,7 @@ export class PreloadFile extends File {
         }
         this.dirty = true;
         this.stats.chown(uid, gid);
-        if (config.syncOnWrite)
+        if (config.syncImmediately)
             this.syncSync();
     }
     async utimes(atime, mtime) {
@@ -453,7 +455,7 @@ export class PreloadFile extends File {
         this.dirty = true;
         this.stats.atime = atime;
         this.stats.mtime = mtime;
-        if (config.syncOnWrite)
+        if (config.syncImmediately)
             await this.sync();
     }
     utimesSync(atime, mtime) {
@@ -463,7 +465,7 @@ export class PreloadFile extends File {
         this.dirty = true;
         this.stats.atime = atime;
         this.stats.mtime = mtime;
-        if (config.syncOnWrite)
+        if (config.syncImmediately)
             this.syncSync();
     }
     async _setType(type) {

package/package.json

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

package/src/config.ts

@@ -163,8 +163,8 @@ export async function configure<T extends ConfigMounts>(configuration: Partial<C
 
 	cache.setEnabled(configuration.cacheStats ?? false);
 	config.checkAccess = !configuration.disableAccessChecks;
-	config.syncOnRead = !configuration.onlySyncOnClose || !configuration.disableUpdateOnRead;
-	config.syncOnWrite = !configuration.onlySyncOnClose;
+	config.updateOnRead = !configuration.disableUpdateOnRead;
+	config.syncImmediately = !configuration.onlySyncOnClose;
 
 	if (configuration.addDevices) {
 		const devfs = new DeviceFS();

package/src/emulation/config.ts

@@ -5,14 +5,14 @@ export const config = {
 	checkAccess: true,
 
 	/**
-	 * Whether to sync atime updates immediately when reading from a file
+	 * Whether to mark a file as dirty after updating its `atime` when read from
 	 */
-	syncOnRead: true,
+	updateOnRead: true,
 
 	/**
-	 * Whether to immediately sync when files are written to
+	 * Whether to immediately sync when files are changed
 	 */
-	syncOnWrite: true,
+	syncImmediately: 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);
-		if (config.syncOnWrite) await this.sync();
+		if (config.syncImmediately) await this.sync();
 	}
 
 	public truncateSync(length: number): void {
 		this._truncate(length);
-		if (config.syncOnWrite) this.syncSync();
+		if (config.syncImmediately) 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);
-		if (config.syncOnWrite) await this.sync();
+		if (config.syncImmediately) 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);
-		if (config.syncOnWrite) this.syncSync();
+		if (config.syncImmediately) this.syncSync();
 		return bytesWritten;
 	}
 
@@ -517,11 +517,17 @@ export class PreloadFile<FS extends FileSystem> extends File {
 		if (this.closed) {
 			throw ErrnoError.With('EBADF', this.path, 'File.read');
 		}
+
 		if (!isReadable(this.flag)) {
 			throw new ErrnoError(Errno.EPERM, 'File not opened with a readable mode.');
 		}
-		this.dirty = true;
+
+		if (config.updateOnRead) {
+			this.dirty = true;
+		}
+
 		this.stats.atimeMs = Date.now();
+
 		position ??= this.position;
 		let end = position + length;
 		if (end > this.stats.size) {
@@ -547,7 +553,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);
-		if (config.syncOnRead) await this.sync();
+		if (config.syncImmediately) await this.sync();
 		return { bytesRead, buffer };
 	}
 
@@ -562,7 +568,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);
-		if (config.syncOnRead) this.syncSync();
+		if (config.syncImmediately) this.syncSync();
 		return bytesRead;
 	}
 
@@ -572,7 +578,7 @@ export class PreloadFile<FS extends FileSystem> extends File {
 		}
 		this.dirty = true;
 		this.stats.chmod(mode);
-		if (config.syncOnWrite) await this.sync();
+		if (config.syncImmediately) await this.sync();
 	}
 
 	public chmodSync(mode: number): void {
@@ -581,7 +587,7 @@ export class PreloadFile<FS extends FileSystem> extends File {
 		}
 		this.dirty = true;
 		this.stats.chmod(mode);
-		if (config.syncOnWrite) this.syncSync();
+		if (config.syncImmediately) this.syncSync();
 	}
 
 	public async chown(uid: number, gid: number): Promise<void> {
@@ -590,7 +596,7 @@ export class PreloadFile<FS extends FileSystem> extends File {
 		}
 		this.dirty = true;
 		this.stats.chown(uid, gid);
-		if (config.syncOnWrite) await this.sync();
+		if (config.syncImmediately) await this.sync();
 	}
 
 	public chownSync(uid: number, gid: number): void {
@@ -599,7 +605,7 @@ export class PreloadFile<FS extends FileSystem> extends File {
 		}
 		this.dirty = true;
 		this.stats.chown(uid, gid);
-		if (config.syncOnWrite) this.syncSync();
+		if (config.syncImmediately) this.syncSync();
 	}
 
 	public async utimes(atime: Date, mtime: Date): Promise<void> {
@@ -609,7 +615,7 @@ export class PreloadFile<FS extends FileSystem> extends File {
 		this.dirty = true;
 		this.stats.atime = atime;
 		this.stats.mtime = mtime;
-		if (config.syncOnWrite) await this.sync();
+		if (config.syncImmediately) await this.sync();
 	}
 
 	public utimesSync(atime: Date, mtime: Date): void {
@@ -619,7 +625,7 @@ export class PreloadFile<FS extends FileSystem> extends File {
 		this.dirty = true;
 		this.stats.atime = atime;
 		this.stats.mtime = mtime;
-		if (config.syncOnWrite) this.syncSync();
+		if (config.syncImmediately) this.syncSync();
 	}
 
 	public async _setType(type: FileType): Promise<void> {