@zenfs/core 1.2.3 → 1.2.4

package/dist/config.d.ts

@@ -54,13 +54,13 @@ export interface Configuration<T extends ConfigMounts> extends SharedConfig {
      */
     disableAccessChecks: boolean;
     /**
-     * If true, disables `read` and `readSync` from immediately syncing the updated atime to the file system.
+     * If true, disables `read` and `readSync` from updating the atime.
      *
      * This can increase performance.
      * @experimental
      * @default false
      */
-    disableSyncOnRead: boolean;
+    disableUpdateOnRead: boolean;
 }
 /**
  * Configures ZenFS with single mount point /

package/dist/config.js

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

package/dist/emulation/config.d.ts

@@ -6,5 +6,5 @@ export declare const config: {
     /**
      * Whether to sync atime updates immediately when reading from a file
      */
-    syncOnRead: boolean;
+    updateOnRead: boolean;
 };

package/dist/emulation/config.js

@@ -6,5 +6,5 @@ export const config = {
     /**
      * Whether to sync atime updates immediately when reading from a file
      */
-    syncOnRead: true,
+    updateOnRead: true,
 };

package/dist/file.js

@@ -358,13 +358,15 @@ 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;
         if (end > this.stats.size) {
             end = position + Math.max(this.stats.size - position, 0);
         }
-        this.stats.atimeMs = Date.now();
         this._position = end;
         const bytesRead = end - position;
         if (bytesRead == 0) {
@@ -384,8 +386,7 @@ export class PreloadFile extends File {
      */
     async read(buffer, offset, length, position) {
         const bytesRead = this._read(buffer, offset, length, position);
-        if (config.syncOnRead)
-            await this.sync();
+        await this.sync();
         return { bytesRead, buffer };
     }
     /**
@@ -399,8 +400,7 @@ export class PreloadFile extends File {
      */
     readSync(buffer, offset, length, position) {
         const bytesRead = this._read(buffer, offset, length, position);
-        if (config.syncOnRead)
-            this.syncSync();
+        this.syncSync();
         return bytesRead;
     }
     async chmod(mode) {

package/package.json

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

package/src/config.ts

@@ -119,13 +119,13 @@ export interface Configuration<T extends ConfigMounts> extends SharedConfig {
 	disableAccessChecks: boolean;
 
 	/**
-	 * If true, disables `read` and `readSync` from immediately syncing the updated atime to the file system.
+	 * If true, disables `read` and `readSync` from updating the atime.
 	 *
 	 * This can increase performance.
 	 * @experimental
 	 * @default false
 	 */
-	disableSyncOnRead: boolean;
+	disableUpdateOnRead: boolean;
 }
 
 /**
@@ -153,7 +153,7 @@ export async function configure<T extends ConfigMounts>(configuration: Partial<C
 
 	cache.setEnabled(configuration.cacheStats ?? false);
 	config.checkAccess = !configuration.disableAccessChecks;
-	config.syncOnRead = !configuration.disableSyncOnRead;
+	config.updateOnRead = !configuration.disableUpdateOnRead;
 
 	if (configuration.addDevices) {
 		const devfs = new DeviceFS();

package/src/emulation/config.ts

@@ -7,5 +7,5 @@ export const config = {
 	/**
 	 * Whether to sync atime updates immediately when reading from a file
 	 */
-	syncOnRead: true,
+	updateOnRead: true,
 };

package/src/file.ts

@@ -515,13 +515,15 @@ export class PreloadFile<FS extends FileSystem> 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 ??= this.position;
 		let end = position + length;
 		if (end > this.stats.size) {
 			end = position + Math.max(this.stats.size - position, 0);
 		}
-		this.stats.atimeMs = Date.now();
 		this._position = end;
 		const bytesRead = end - position;
 		if (bytesRead == 0) {
@@ -542,7 +544,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();
+		await this.sync();
 		return { bytesRead, buffer };
 	}
 
@@ -557,7 +559,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();
+		this.syncSync();
 		return bytesRead;
 	}