atomically 2.0.3 → 2.0.5

package/.nyc_output/06ea27ff-9d6e-44e2-b922-121687bc5661.json

@@ -0,0 +1 @@
+{}

package/.nyc_output/58e93f70-472d-449b-ac6b-4e640c0aeb02.json

@@ -0,0 +1 @@
+{}

package/.nyc_output/a4a404bb-72b9-43f0-be83-3d2a65aaec5a.json

@@ -0,0 +1 @@
+{}

package/.nyc_output/c18f7e70-50ab-4df7-afb5-2c2e27792296.json

@@ -0,0 +1 @@
+{}

package/.nyc_output/d1b8239a-6e10-4482-af38-f54b9a5f29ee.json

@@ -0,0 +1 @@
+{}

package/.nyc_output/processinfo/06ea27ff-9d6e-44e2-b922-121687bc5661.json

@@ -0,0 +1 @@
+{"parent":"58e93f70-472d-449b-ac6b-4e640c0aeb02","pid":36955,"argv":["/Users/fabio/.nvm/versions/node/v18.19.0/bin/node","/Users/fabio/Code/fabiospampinato/atomically/test/basic.cjs"],"execArgv":[],"cwd":"/Users/fabio/Code/fabiospampinato/atomically","time":1761513266816,"ppid":36954,"coverageFilename":"/Users/fabio/Code/fabiospampinato/atomically/.nyc_output/06ea27ff-9d6e-44e2-b922-121687bc5661.json","externalId":"test/basic.cjs","uuid":"06ea27ff-9d6e-44e2-b922-121687bc5661","files":[]}

package/.nyc_output/processinfo/58e93f70-472d-449b-ac6b-4e640c0aeb02.json

@@ -0,0 +1 @@
+{"parent":null,"pid":36954,"argv":["/Users/fabio/.nvm/versions/node/v18.19.0/bin/node","/Users/fabio/Code/fabiospampinato/atomically/node_modules/.bin/tap","--no-check-coverage","--no-coverage-report"],"execArgv":[],"cwd":"/Users/fabio/Code/fabiospampinato/atomically","time":1761513266396,"ppid":36923,"coverageFilename":"/Users/fabio/Code/fabiospampinato/atomically/.nyc_output/58e93f70-472d-449b-ac6b-4e640c0aeb02.json","externalId":"","uuid":"58e93f70-472d-449b-ac6b-4e640c0aeb02","files":[]}

package/.nyc_output/processinfo/a4a404bb-72b9-43f0-be83-3d2a65aaec5a.json

@@ -0,0 +1 @@
+{"parent":"58e93f70-472d-449b-ac6b-4e640c0aeb02","pid":36957,"argv":["/Users/fabio/.nvm/versions/node/v18.19.0/bin/node","/Users/fabio/Code/fabiospampinato/atomically/test/integration.cjs"],"execArgv":[],"cwd":"/Users/fabio/Code/fabiospampinato/atomically","time":1761513266816,"ppid":36954,"coverageFilename":"/Users/fabio/Code/fabiospampinato/atomically/.nyc_output/a4a404bb-72b9-43f0-be83-3d2a65aaec5a.json","externalId":"test/integration.cjs","uuid":"a4a404bb-72b9-43f0-be83-3d2a65aaec5a","files":[]}

package/.nyc_output/processinfo/c18f7e70-50ab-4df7-afb5-2c2e27792296.json

@@ -0,0 +1 @@
+{"parent":"58e93f70-472d-449b-ac6b-4e640c0aeb02","pid":36958,"argv":["/Users/fabio/.nvm/versions/node/v18.19.0/bin/node","/Users/fabio/Code/fabiospampinato/atomically/test/atomically.cjs"],"execArgv":[],"cwd":"/Users/fabio/Code/fabiospampinato/atomically","time":1761513266816,"ppid":36954,"coverageFilename":"/Users/fabio/Code/fabiospampinato/atomically/.nyc_output/c18f7e70-50ab-4df7-afb5-2c2e27792296.json","externalId":"test/atomically.cjs","uuid":"c18f7e70-50ab-4df7-afb5-2c2e27792296","files":[]}

package/.nyc_output/processinfo/d1b8239a-6e10-4482-af38-f54b9a5f29ee.json

@@ -0,0 +1 @@
+{"parent":"58e93f70-472d-449b-ac6b-4e640c0aeb02","pid":36956,"argv":["/Users/fabio/.nvm/versions/node/v18.19.0/bin/node","/Users/fabio/Code/fabiospampinato/atomically/test/concurrency.cjs"],"execArgv":[],"cwd":"/Users/fabio/Code/fabiospampinato/atomically","time":1761513266816,"ppid":36954,"coverageFilename":"/Users/fabio/Code/fabiospampinato/atomically/.nyc_output/d1b8239a-6e10-4482-af38-f54b9a5f29ee.json","externalId":"test/concurrency.cjs","uuid":"d1b8239a-6e10-4482-af38-f54b9a5f29ee","files":[]}

package/.nyc_output/processinfo/index.json

@@ -0,0 +1 @@
+{"processes":{"06ea27ff-9d6e-44e2-b922-121687bc5661":{"parent":"58e93f70-472d-449b-ac6b-4e640c0aeb02","externalId":"test/basic.cjs","children":[]},"58e93f70-472d-449b-ac6b-4e640c0aeb02":{"parent":null,"children":["06ea27ff-9d6e-44e2-b922-121687bc5661","a4a404bb-72b9-43f0-be83-3d2a65aaec5a","c18f7e70-50ab-4df7-afb5-2c2e27792296","d1b8239a-6e10-4482-af38-f54b9a5f29ee"]},"a4a404bb-72b9-43f0-be83-3d2a65aaec5a":{"parent":"58e93f70-472d-449b-ac6b-4e640c0aeb02","externalId":"test/integration.cjs","children":[]},"c18f7e70-50ab-4df7-afb5-2c2e27792296":{"parent":"58e93f70-472d-449b-ac6b-4e640c0aeb02","externalId":"test/atomically.cjs","children":[]},"d1b8239a-6e10-4482-af38-f54b9a5f29ee":{"parent":"58e93f70-472d-449b-ac6b-4e640c0aeb02","externalId":"test/concurrency.cjs","children":[]}},"files":{},"externalIds":{"test/basic.cjs":{"root":"06ea27ff-9d6e-44e2-b922-121687bc5661","children":[]},"test/integration.cjs":{"root":"a4a404bb-72b9-43f0-be83-3d2a65aaec5a","children":[]},"test/atomically.cjs":{"root":"c18f7e70-50ab-4df7-afb5-2c2e27792296","children":[]},"test/concurrency.cjs":{"root":"d1b8239a-6e10-4482-af38-f54b9a5f29ee","children":[]}}}

package/dist/constants.d.ts

@@ -5,11 +5,11 @@ declare const DEFAULT_READ_OPTIONS: {};
 declare const DEFAULT_WRITE_OPTIONS: {};
 declare const DEFAULT_USER_UID: number;
 declare const DEFAULT_USER_GID: number;
+declare const DEFAULT_INTERVAL_ASYNC = 200;
 declare const DEFAULT_TIMEOUT_ASYNC = 7500;
 declare const DEFAULT_TIMEOUT_SYNC = 1000;
 declare const IS_POSIX: boolean;
 declare const IS_USER_ROOT: boolean;
 declare const LIMIT_BASENAME_LENGTH = 128;
-declare const LIMIT_FILES_DESCRIPTORS = 10000;
 declare const NOOP: () => void;
-export { DEFAULT_ENCODING, DEFAULT_FILE_MODE, DEFAULT_FOLDER_MODE, DEFAULT_READ_OPTIONS, DEFAULT_WRITE_OPTIONS, DEFAULT_USER_UID, DEFAULT_USER_GID, DEFAULT_TIMEOUT_ASYNC, DEFAULT_TIMEOUT_SYNC, IS_POSIX, IS_USER_ROOT, LIMIT_BASENAME_LENGTH, LIMIT_FILES_DESCRIPTORS, NOOP };
+export { DEFAULT_ENCODING, DEFAULT_FILE_MODE, DEFAULT_FOLDER_MODE, DEFAULT_READ_OPTIONS, DEFAULT_WRITE_OPTIONS, DEFAULT_USER_UID, DEFAULT_USER_GID, DEFAULT_INTERVAL_ASYNC, DEFAULT_TIMEOUT_ASYNC, DEFAULT_TIMEOUT_SYNC, IS_POSIX, IS_USER_ROOT, LIMIT_BASENAME_LENGTH, NOOP };

package/dist/constants.js

@@ -1,5 +1,4 @@
 /* IMPORT */
-import os from 'node:os';
 import process from 'node:process';
 /* MAIN */
 const DEFAULT_ENCODING = 'utf8';
@@ -7,14 +6,14 @@ const DEFAULT_FILE_MODE = 0o666;
 const DEFAULT_FOLDER_MODE = 0o777;
 const DEFAULT_READ_OPTIONS = {};
 const DEFAULT_WRITE_OPTIONS = {};
-const DEFAULT_USER_UID = os.userInfo().uid;
-const DEFAULT_USER_GID = os.userInfo().gid;
+const DEFAULT_USER_UID = process.geteuid ? process.geteuid() : -1;
+const DEFAULT_USER_GID = process.getegid ? process.getegid() : -1;
+const DEFAULT_INTERVAL_ASYNC = 200;
 const DEFAULT_TIMEOUT_ASYNC = 7500;
 const DEFAULT_TIMEOUT_SYNC = 1000;
 const IS_POSIX = !!process.getuid;
 const IS_USER_ROOT = process.getuid ? !process.getuid() : false;
 const LIMIT_BASENAME_LENGTH = 128; //TODO: Fetch the real limit from the filesystem //TODO: Fetch the whole-path length limit too
-const LIMIT_FILES_DESCRIPTORS = 10000; //TODO: Fetch the real limit from the filesystem
 const NOOP = () => { };
 /* EXPORT */
-export { DEFAULT_ENCODING, DEFAULT_FILE_MODE, DEFAULT_FOLDER_MODE, DEFAULT_READ_OPTIONS, DEFAULT_WRITE_OPTIONS, DEFAULT_USER_UID, DEFAULT_USER_GID, DEFAULT_TIMEOUT_ASYNC, DEFAULT_TIMEOUT_SYNC, IS_POSIX, IS_USER_ROOT, LIMIT_BASENAME_LENGTH, LIMIT_FILES_DESCRIPTORS, NOOP };
+export { DEFAULT_ENCODING, DEFAULT_FILE_MODE, DEFAULT_FOLDER_MODE, DEFAULT_READ_OPTIONS, DEFAULT_WRITE_OPTIONS, DEFAULT_USER_UID, DEFAULT_USER_GID, DEFAULT_INTERVAL_ASYNC, DEFAULT_TIMEOUT_ASYNC, DEFAULT_TIMEOUT_SYNC, IS_POSIX, IS_USER_ROOT, LIMIT_BASENAME_LENGTH, NOOP };

package/dist/index.d.ts

@@ -1,5 +1,4 @@
-/// <reference types="node" />
-import type { Callback, Data, Encoding, Path, ReadOptions, WriteOptions } from './types';
+import type { Callback, Data, Encoding, Path, ReadOptions, WriteOptions } from './types.js';
 declare function readFile(filePath: Path, options: Encoding | ReadOptions & {
     encoding: string;
 }): Promise<string>;

package/dist/index.js

@@ -1,21 +1,23 @@
 /* IMPORT */
 import path from 'node:path';
 import fs from 'stubborn-fs';
-import { DEFAULT_ENCODING, DEFAULT_FILE_MODE, DEFAULT_FOLDER_MODE, DEFAULT_READ_OPTIONS, DEFAULT_WRITE_OPTIONS, DEFAULT_USER_UID, DEFAULT_USER_GID, DEFAULT_TIMEOUT_ASYNC, DEFAULT_TIMEOUT_SYNC, IS_POSIX } from './constants.js';
+import { DEFAULT_ENCODING, DEFAULT_FILE_MODE, DEFAULT_FOLDER_MODE, DEFAULT_READ_OPTIONS, DEFAULT_WRITE_OPTIONS, DEFAULT_USER_UID, DEFAULT_USER_GID, DEFAULT_INTERVAL_ASYNC, DEFAULT_TIMEOUT_ASYNC, DEFAULT_TIMEOUT_SYNC, IS_POSIX } from './constants.js';
 import { isException, isFunction, isString, isUndefined } from './utils/lang.js';
 import Scheduler from './utils/scheduler.js';
 import Temp from './utils/temp.js';
 function readFile(filePath, options = DEFAULT_READ_OPTIONS) {
     if (isString(options))
         return readFile(filePath, { encoding: options });
-    const timeout = Date.now() + ((options.timeout ?? DEFAULT_TIMEOUT_ASYNC) || -1);
-    return fs.retry.readFile(timeout)(filePath, options);
+    const timeout = options.timeout ?? DEFAULT_TIMEOUT_ASYNC;
+    const retryOptions = { timeout, interval: DEFAULT_INTERVAL_ASYNC };
+    return fs.retry.readFile(retryOptions)(filePath, options);
 }
 function readFileSync(filePath, options = DEFAULT_READ_OPTIONS) {
     if (isString(options))
         return readFileSync(filePath, { encoding: options });
-    const timeout = Date.now() + ((options.timeout ?? DEFAULT_TIMEOUT_SYNC) || -1);
-    return fs.retry.readFileSync(timeout)(filePath, options);
+    const timeout = options.timeout ?? DEFAULT_TIMEOUT_SYNC;
+    const retryOptions = { timeout };
+    return fs.retry.readFileSync(retryOptions)(filePath, options);
 }
 function writeFile(filePath, data, options, callback) {
     if (isFunction(options))
@@ -28,7 +30,8 @@ function writeFile(filePath, data, options, callback) {
 async function writeFileAsync(filePath, data, options = DEFAULT_WRITE_OPTIONS) {
     if (isString(options))
         return writeFileAsync(filePath, data, { encoding: options });
-    const timeout = Date.now() + ((options.timeout ?? DEFAULT_TIMEOUT_ASYNC) || -1);
+    const timeout = options.timeout ?? DEFAULT_TIMEOUT_ASYNC;
+    const retryOptions = { timeout, interval: DEFAULT_INTERVAL_ASYNC };
     let schedulerCustomDisposer = null;
     let schedulerDisposer = null;
     let tempDisposer = null;
@@ -63,25 +66,25 @@ async function writeFileAsync(filePath, data, options = DEFAULT_WRITE_OPTIONS) {
                 recursive: true
             });
         }
-        fd = await fs.retry.open(timeout)(tempPath, 'w', options.mode || DEFAULT_FILE_MODE);
+        fd = await fs.retry.open(retryOptions)(tempPath, 'w', options.mode || DEFAULT_FILE_MODE);
         if (options.tmpCreated) {
             options.tmpCreated(tempPath);
         }
         if (isString(data)) {
-            await fs.retry.write(timeout)(fd, data, 0, options.encoding || DEFAULT_ENCODING);
+            await fs.retry.write(retryOptions)(fd, data, 0, options.encoding || DEFAULT_ENCODING);
         }
         else if (!isUndefined(data)) {
-            await fs.retry.write(timeout)(fd, data, 0, data.length, 0);
+            await fs.retry.write(retryOptions)(fd, data, 0, data.length, 0);
         }
         if (options.fsync !== false) {
             if (options.fsyncWait !== false) {
-                await fs.retry.fsync(timeout)(fd);
+                await fs.retry.fsync(retryOptions)(fd);
             }
             else {
                 fs.attempt.fsync(fd);
             }
         }
-        await fs.retry.close(timeout)(fd);
+        await fs.retry.close(retryOptions)(fd);
         fd = null;
         if (options.chown && (options.chown.uid !== DEFAULT_USER_UID || options.chown.gid !== DEFAULT_USER_GID)) {
             await fs.attempt.chown(tempPath, options.chown.uid, options.chown.gid);
@@ -90,14 +93,14 @@ async function writeFileAsync(filePath, data, options = DEFAULT_WRITE_OPTIONS) {
             await fs.attempt.chmod(tempPath, options.mode);
         }
         try {
-            await fs.retry.rename(timeout)(tempPath, filePath);
+            await fs.retry.rename(retryOptions)(tempPath, filePath);
         }
         catch (error) {
             if (!isException(error))
                 throw error;
             if (error.code !== 'ENAMETOOLONG')
                 throw error;
-            await fs.retry.rename(timeout)(tempPath, Temp.truncate(filePath));
+            await fs.retry.rename(retryOptions)(tempPath, Temp.truncate(filePath));
         }
         tempDisposer();
         tempPath = null;
@@ -116,7 +119,8 @@ async function writeFileAsync(filePath, data, options = DEFAULT_WRITE_OPTIONS) {
 function writeFileSync(filePath, data, options = DEFAULT_WRITE_OPTIONS) {
     if (isString(options))
         return writeFileSync(filePath, data, { encoding: options });
-    const timeout = Date.now() + ((options.timeout ?? DEFAULT_TIMEOUT_SYNC) || -1);
+    const timeout = options.timeout ?? DEFAULT_TIMEOUT_SYNC;
+    const retryOptions = { timeout };
     let tempDisposer = null;
     let tempPath = null;
     let fd = null;
@@ -146,25 +150,25 @@ function writeFileSync(filePath, data, options = DEFAULT_WRITE_OPTIONS) {
                 recursive: true
             });
         }
-        fd = fs.retry.openSync(timeout)(tempPath, 'w', options.mode || DEFAULT_FILE_MODE);
+        fd = fs.retry.openSync(retryOptions)(tempPath, 'w', options.mode || DEFAULT_FILE_MODE);
         if (options.tmpCreated) {
             options.tmpCreated(tempPath);
         }
         if (isString(data)) {
-            fs.retry.writeSync(timeout)(fd, data, 0, options.encoding || DEFAULT_ENCODING);
+            fs.retry.writeSync(retryOptions)(fd, data, 0, options.encoding || DEFAULT_ENCODING);
         }
         else if (!isUndefined(data)) {
-            fs.retry.writeSync(timeout)(fd, data, 0, data.length, 0);
+            fs.retry.writeSync(retryOptions)(fd, data, 0, data.length, 0);
         }
         if (options.fsync !== false) {
             if (options.fsyncWait !== false) {
-                fs.retry.fsyncSync(timeout)(fd);
+                fs.retry.fsyncSync(retryOptions)(fd);
             }
             else {
                 fs.attempt.fsync(fd);
             }
         }
-        fs.retry.closeSync(timeout)(fd);
+        fs.retry.closeSync(retryOptions)(fd);
         fd = null;
         if (options.chown && (options.chown.uid !== DEFAULT_USER_UID || options.chown.gid !== DEFAULT_USER_GID)) {
             fs.attempt.chownSync(tempPath, options.chown.uid, options.chown.gid);
@@ -173,14 +177,14 @@ function writeFileSync(filePath, data, options = DEFAULT_WRITE_OPTIONS) {
             fs.attempt.chmodSync(tempPath, options.mode);
         }
         try {
-            fs.retry.renameSync(timeout)(tempPath, filePath);
+            fs.retry.renameSync(retryOptions)(tempPath, filePath);
         }
         catch (error) {
             if (!isException(error))
                 throw error;
             if (error.code !== 'ENAMETOOLONG')
                 throw error;
-            fs.retry.renameSync(timeout)(tempPath, Temp.truncate(filePath));
+            fs.retry.renameSync(retryOptions)(tempPath, Temp.truncate(filePath));
         }
         tempDisposer();
         tempPath = null;

package/dist/types.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 type Callback = (error: Exception | void) => void;
 type Data = Uint8Array | string | undefined;
 type Disposer = () => void;

package/dist/utils/lang.d.ts

@@ -1,5 +1,5 @@
-/// <reference types="node" />
-declare const isException: (value: unknown) => value is NodeJS.ErrnoException;
+import type { Exception } from '../types.js';
+declare const isException: (value: unknown) => value is Exception;
 declare const isFunction: (value: unknown) => value is Function;
 declare const isString: (value: unknown) => value is string;
 declare const isUndefined: (value: unknown) => value is undefined;

package/dist/utils/scheduler.d.ts

@@ -1,4 +1,4 @@
-import type { Disposer } from '../types';
+import type { Disposer } from '../types.js';
 declare const Scheduler: {
     next: (id: string) => void;
     schedule: (id: string) => Promise<Disposer>;

package/dist/utils/temp.d.ts

@@ -1,4 +1,4 @@
-import type { Disposer } from '../types';
+import type { Disposer } from '../types.js';
 declare const Temp: {
     store: Record<string, boolean>;
     create: (filePath: string) => string;

package/dist/utils/temp.js

@@ -7,7 +7,7 @@ import { LIMIT_BASENAME_LENGTH } from '../constants.js';
 //TODO: Maybe publish this as a standalone package
 const Temp = {
     /* VARIABLES */
-    store: {},
+    store: {}, // filePath => purge
     /* API */
     create: (filePath) => {
         const randomness = `000000${Math.floor(Math.random() * 16777215).toString(16)}`.slice(-6); // 6 random-enough hex characters

package/package.json

@@ -2,7 +2,8 @@
   "name": "atomically",
   "repository": "github:fabiospampinato/atomically",
   "description": "Read and write files atomically and reliably.",
-  "version": "2.0.3",
+  "license": "MIT",
+  "version": "2.0.5",
   "type": "module",
   "main": "dist/index.js",
   "exports": "./dist/index.js",
@@ -26,16 +27,16 @@
     "reliable"
   ],
   "dependencies": {
-    "stubborn-fs": "^1.2.5",
-    "when-exit": "^2.1.1"
+    "stubborn-fs": "^2.0.0",
+    "when-exit": "^2.1.4"
   },
   "devDependencies": {
-    "@types/node": "^20.4.6",
-    "esbuild": "^0.18.17",
+    "@types/node": "^18.19.130",
+    "esbuild": "^0.18.20",
     "require-inject": "^1.4.4",
     "tap": "^16.3.8",
-    "tsex": "^3.0.0",
-    "typescript": "^5.1.6",
-    "write-file-atomic": "^5.0.1"
+    "tsex": "^4.0.2",
+    "typescript": "^5.9.3",
+    "write-file-atomic": "^7.0.0"
   }
 }

package/.editorconfig

@@ -1,10 +0,0 @@
-
-root = true
-
-[*]
-charset = utf-8
-end_of_line = lf
-indent_size = 2
-indent_style = space
-insert_final_newline = true
-trim_trailing_whitespace = true

package/src/constants.ts

@@ -1,39 +0,0 @@
-
-/* IMPORT */
-
-import os from 'node:os';
-import process from 'node:process';
-
-/* MAIN */
-
-const DEFAULT_ENCODING = 'utf8';
-
-const DEFAULT_FILE_MODE = 0o666;
-
-const DEFAULT_FOLDER_MODE = 0o777;
-
-const DEFAULT_READ_OPTIONS = {};
-
-const DEFAULT_WRITE_OPTIONS = {};
-
-const DEFAULT_USER_UID = os.userInfo ().uid;
-
-const DEFAULT_USER_GID = os.userInfo ().gid;
-
-const DEFAULT_TIMEOUT_ASYNC = 7500;
-
-const DEFAULT_TIMEOUT_SYNC = 1000;
-
-const IS_POSIX = !!process.getuid;
-
-const IS_USER_ROOT = process.getuid ? !process.getuid () : false;
-
-const LIMIT_BASENAME_LENGTH = 128; //TODO: Fetch the real limit from the filesystem //TODO: Fetch the whole-path length limit too
-
-const LIMIT_FILES_DESCRIPTORS = 10_000; //TODO: Fetch the real limit from the filesystem
-
-const NOOP = () => {};
-
-/* EXPORT */
-
-export {DEFAULT_ENCODING, DEFAULT_FILE_MODE, DEFAULT_FOLDER_MODE, DEFAULT_READ_OPTIONS, DEFAULT_WRITE_OPTIONS, DEFAULT_USER_UID, DEFAULT_USER_GID, DEFAULT_TIMEOUT_ASYNC, DEFAULT_TIMEOUT_SYNC, IS_POSIX, IS_USER_ROOT, LIMIT_BASENAME_LENGTH, LIMIT_FILES_DESCRIPTORS, NOOP};