rimraf 3.0.2 → 4.0.0

package/LICENSE

@@ -1,6 +1,6 @@
 The ISC License
 
-Copyright (c) Isaac Z. Schlueter and Contributors
+Copyright (c) 2011-2023 Isaac Z. Schlueter and Contributors
 
 Permission to use, copy, modify, and/or distribute this software for any
 purpose with or without fee is hereby granted, provided that the above

package/README.md

@@ -1,101 +1,165 @@
-[![Build Status](https://travis-ci.org/isaacs/rimraf.svg?branch=master)](https://travis-ci.org/isaacs/rimraf) [![Dependency Status](https://david-dm.org/isaacs/rimraf.svg)](https://david-dm.org/isaacs/rimraf) [![devDependency Status](https://david-dm.org/isaacs/rimraf/dev-status.svg)](https://david-dm.org/isaacs/rimraf#info=devDependencies)
-
-The [UNIX command](http://en.wikipedia.org/wiki/Rm_(Unix)) `rm -rf` for node.
+The [UNIX command](<http://en.wikipedia.org/wiki/Rm_(Unix)>) `rm -rf` for node.
 
 Install with `npm install rimraf`, or just drop rimraf.js somewhere.
 
+## Major Changes from v3 to v4
+
+- The function returns a `Promise` instead of taking a callback.
+- Built-in glob support removed.
+- Functions take arrays of paths, as well as a single path.
+- Native implementation used by default when available.
+- New implementation on Windows, falling back to "move then
+  remove" strategy when exponential backoff for `EBUSY` fails to
+  resolve the situation.
+- Simplified implementation on Posix, since the Windows affordances are not
+  necessary there.
+
 ## API
 
-`rimraf(f, [opts], callback)`
+Hybrid module, load either with `import` or `require()`.
+
+```js
+// default export is the main rimraf function
+import rimraf from 'rimraf'
+// or
+const rimraf = require('rimraf').default
+
+// other strategies exported as well
+import { rimraf, rimrafSync, native, nativeSync } from 'rimraf'
+// or
+const { rimraf, rimrafSync, native, nativeSync } = require('rimraf')
+```
+
+### `rimraf(f, [opts]) -> Promise`
+
+This first parameter is a path or array of paths. The second
+argument is an options object.
+
+Options:
+
+- `preserveRoot`: If set to boolean `false`, then allow the
+  recursive removal of the root directory. Otherwise, this is
+  not allowed.
+- `tmp`: Windows only. Temp folder to use to place files and
+  folders for the "move then remove" fallback. Must be on the
+  same physical device as the path being deleted. Defaults to
+  `os.tmpdir()` when that is on the same drive letter as the path
+  being deleted, or `${drive}:\temp` if present, or `${drive}:\`
+  if not.
+- `maxRetries`: Windows and Native only. Maximum number of
+  retry attempts in case of `EBUSY`, `EMFILE`, and `ENFILE`
+  errors. Default `10` for Windows implementation, `0` for Native
+  implementation.
+- `backoff`: Windows only. Rate of exponential backoff for async
+  removal in case of `EBUSY`, `EMFILE`, and `ENFILE` errors.
+  Should be a number greater than 1. Default `1.2`
+- `maxBackoff`: Windows only. Maximum total backoff time in ms to
+  attempt asynchronous retries in case of `EBUSY`, `EMFILE`, and
+  `ENFILE` errors. Default `200`. With the default `1.2` backoff
+  rate, this results in 14 retries, with the final retry being
+  delayed 33ms.
+- `retryDelay`: Native only. Time to wait between retries, using
+  linear backoff. Default `100`.
+
+Any other options are provided to the native Node.js `fs.rm` implementation
+when that is used.
 
-The first parameter will be interpreted as a globbing pattern for files. If you
-want to disable globbing you can do so with `opts.disableGlob` (defaults to
-`false`). This might be handy, for instance, if you have filenames that contain
-globbing wildcard characters.
+This will attempt to choose the best implementation, based on Node.js
+version and `process.platform`. To force a specific implementation, use
+one of the other functions provided.
 
-The callback will be called with an error if there is one.  Certain
-errors are handled for you:
+### `rimraf.sync(f, [opts])` `rimraf.rimrafSync(f, [opts])`
 
-* Windows: `EBUSY` and `ENOTEMPTY` - rimraf will back off a maximum of
-  `opts.maxBusyTries` times before giving up, adding 100ms of wait
-  between each attempt.  The default `maxBusyTries` is 3.
-* `ENOENT` - If the file doesn't exist, rimraf will return
-  successfully, since your desired outcome is already the case.
-* `EMFILE` - Since `readdir` requires opening a file descriptor, it's
-  possible to hit `EMFILE` if too many file descriptors are in use.
-  In the sync case, there's nothing to be done for this.  But in the
-  async case, rimraf will gradually back off with timeouts up to
-  `opts.emfileWait` ms, which defaults to 1000.
+Synchronous form of `rimraf()`
 
-## options
+Note that, unlike many file system operations, the synchronous form will
+typically be significantly _slower_ than the async form, because recursive
+deletion is extremely parallelizable.
 
-* unlink, chmod, stat, lstat, rmdir, readdir,
-  unlinkSync, chmodSync, statSync, lstatSync, rmdirSync, readdirSync
+### `rimraf.native(f, [opts])`
 
-    In order to use a custom file system library, you can override
-    specific fs functions on the options object.
+Uses the built-in `fs.rm` implementation that Node.js provides. This is
+used by default on Node.js versions greater than or equal to `14.14.0`.
 
-    If any of these functions are present on the options object, then
-    the supplied function will be used instead of the default fs
-    method.
+### `rimraf.nativeSync(f, [opts])` `rimraf.native.sync(f, [opts])`
 
-    Sync methods are only relevant for `rimraf.sync()`, of course.
+Synchronous form of `rimraf.native`
 
-    For example:
+### `rimraf.manual(f, [opts])`
 
-    ```javascript
-    var myCustomFS = require('some-custom-fs')
+Use the JavaScript implementation appropriate for your operating system.
 
-    rimraf('some-thing', myCustomFS, callback)
-    ```
+### `rimraf.manualSync(f, [opts])` `rimraf.manualSync(f, opts)`
 
-* maxBusyTries
+Synchronous form of `rimraf.manual()`
 
-    If an `EBUSY`, `ENOTEMPTY`, or `EPERM` error code is encountered
-    on Windows systems, then rimraf will retry with a linear backoff
-    wait of 100ms longer on each try.  The default maxBusyTries is 3.
+### `rimraf.windows(f, [opts])`
 
-    Only relevant for async usage.
+JavaScript implementation of file removal appropriate for Windows
+platforms. Works around `unlink` and `rmdir` not being atomic
+operations, and `EPERM` when deleting files with certain
+permission modes.
 
-* emfileWait
+First deletes all non-directory files within the tree, and then
+removes all directories, which should ideally be empty by that
+time. When an `ENOTEMPTY` is raised in the second pass, falls
+back to the `rimraf.moveRemove` strategy as needed.
 
-    If an `EMFILE` error is encountered, then rimraf will retry
-    repeatedly with a linear backoff of 1ms longer on each try, until
-    the timeout counter hits this max.  The default limit is 1000.
+### `rimraf.windows.sync(path, [opts])` `rimraf.windowsSync(path, [opts])`
 
-    If you repeatedly encounter `EMFILE` errors, then consider using
-    [graceful-fs](http://npm.im/graceful-fs) in your program.
+Synchronous form of `rimraf.windows()`
 
-    Only relevant for async usage.
+### `rimraf.moveRemove(path, [opts])`
 
-* glob
+Moves all files and folders to the parent directory of `path`
+with a temporary filename prior to attempting to remove them.
 
-    Set to `false` to disable [glob](http://npm.im/glob) pattern
-    matching.
+Note that, in cases where the operation fails, this _may_ leave
+files lying around in the parent directory with names like
+`.file-basename.txt.0.123412341`. Until the Windows kernel
+provides a way to perform atomic `unlink` and `rmdir` operations,
+this is unfortunately unavoidable.
 
-    Set to an object to pass options to the glob module.  The default
-    glob options are `{ nosort: true, silent: true }`.
+To move files to a different temporary directory other than the
+parent, provide `opts.tmp`. Note that this _must_ be on the same
+physical device as the folder being deleted, or else the
+operation will fail.
 
-    Glob version 6 is used in this module.
+This is the slowest strategy, but most reliable on Windows
+platforms. Used as a last-ditch fallback by `rimraf.windows()`.
 
-    Relevant for both sync and async usage.
+### `rimraf.moveRemove.sync(path, [opts])` `rimraf.moveRemoveSync(path, [opts])`
 
-* disableGlob
+Synchronous form of `rimraf.moveRemove()`
 
-    Set to any non-falsey value to disable globbing entirely.
-    (Equivalent to setting `glob: false`.)
+### Command Line Interface
 
-## rimraf.sync
+```
+Usage: rimraf <path> [<path> ...]
+Deletes all files and folders at "path", recursively.
 
-It can remove stuff synchronously, too.  But that's not so good.  Use
-the async API.  It's better.
+Options:
+  --                  Treat all subsequent arguments as paths
+  -h --help           Display this usage info
+  --preserve-root     Do not remove '/' recursively (default)
+  --no-preserve-root  Do not treat '/' specially
 
-## CLI
+  --impl=<type>       Specify the implementationt to use.
+                      rimraf: choose the best option
+                      native: the C++ implementation in Node.js
+                      manual: the platform-specific JS implementation
+                      posix: the Posix JS implementation
+                      windows: the Windows JS implementation
+                      move-remove: a slower Windows JS fallback implementation
 
-If installed with `npm install rimraf -g` it can be used as a global
-command `rimraf <path> [<path> ...]` which is useful for cross platform support.
+Implementation-specific options:
+  --tmp=<path>        Folder to hold temp files for 'move-remove' implementation
+  --max-retries=<n>   maxRetries for the 'native' and 'windows' implementations
+  --retry-delay=<n>   retryDelay for the 'native' implementation, default 100
+  --backoff=<n>       Exponential backoff factor for retries (default: 1.2)
+```
 
 ## mkdirp
 
-If you need to create a directory recursively, check out
-[mkdirp](https://github.com/substack/node-mkdirp).
+If you need to _create_ a directory recursively, check out
+[mkdirp](https://github.com/isaacs/node-mkdirp).

package/dist/cjs/package.json

@@ -0,0 +1,74 @@
+{
+    "name": "rimraf",
+    "version": "4.0.0",
+    "main": "./dist/cjs/src/index.js",
+    "module": "./dist/mjs/src/index.js",
+    "bin": "./dist/cjs/src/bin.js",
+    "exports": {
+        ".": {
+            "import": "./dist/mjs/src/index.js",
+            "require": "./dist/cjs/src/index.js"
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "description": "A deep deletion module for node (like `rm -rf`)",
+    "author": "Isaac Z. Schlueter <i@izs.me> (http://blog.izs.me/)",
+    "license": "ISC",
+    "repository": "git://github.com/isaacs/rimraf.git",
+    "scripts": {
+        "preversion": "npm test",
+        "postversion": "npm publish",
+        "prepublishOnly": "git push origin --follow-tags",
+        "preprepare": "rm -rf dist",
+        "prepare": "tsc -p tsconfig-cjs.json && tsc -p tsconfig-esm.json",
+        "postprepare": "bash fixup.sh",
+        "pretest": "npm run prepare",
+        "presnap": "npm run prepare",
+        "test": "c8 tap",
+        "snap": "c8 tap",
+        "format": "prettier --write . --loglevel warn",
+        "benchmark": "node benchmark/index.js",
+        "typedoc": "typedoc --tsconfig tsconfig-esm.json ./src/*.ts"
+    },
+    "prettier": {
+        "semi": false,
+        "printWidth": 80,
+        "tabWidth": 2,
+        "useTabs": false,
+        "singleQuote": true,
+        "jsxSingleQuote": false,
+        "bracketSameLine": true,
+        "arrowParens": "avoid",
+        "endOfLine": "lf"
+    },
+    "devDependencies": {
+        "@types/node": "^18.11.9",
+        "@types/tap": "^15.0.7",
+        "c8": "^7.12.0",
+        "eslint-config-prettier": "^8.6.0",
+        "mkdirp": "1",
+        "prettier": "^2.8.2",
+        "tap": "^16.3.3",
+        "ts-node": "^10.9.1",
+        "typedoc": "^0.23.21",
+        "typescript": "^4.9.3"
+    },
+    "tap": {
+        "coverage": false,
+        "libtap-settings": "libtap-settings.js",
+        "node-arg": [
+            "--no-warnings",
+            "--loader",
+            "ts-node/esm"
+        ],
+        "ts": false
+    },
+    "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+    },
+    "engines": {
+        "node": ">=14"
+    }
+}

package/dist/cjs/src/bin.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+export declare const help: string;
+declare const main: {
+    (...args: string[]): Promise<1 | 0>;
+    help: string;
+};
+export default main;

package/dist/cjs/src/bin.js

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.help = void 0;
+const package_json_1 = require("../package.json");
+const _1 = __importDefault(require("./"));
+const runHelpForUsage = () => console.error('run `rimraf --help` for usage information');
+exports.help = `rimraf version ${package_json_1.version}
+
+Usage: rimraf <path> [<path> ...]
+Deletes all files and folders at "path", recursively.
+
+Options:
+  --                  Treat all subsequent arguments as paths
+  -h --help           Display this usage info
+  --preserve-root     Do not remove '/' recursively (default)
+  --no-preserve-root  Do not treat '/' specially
+
+  --impl=<type>       Specify the implementationt to use.
+                      rimraf: choose the best option
+                      native: the C++ implementation in Node.js
+                      manual: the platform-specific JS implementation
+                      posix: the Posix JS implementation
+                      windows: the Windows JS implementation
+                      move-remove: a slower Windows JS fallback implementation
+
+Implementation-specific options:
+  --tmp=<path>        Folder to hold temp files for 'move-remove' implementation
+  --max-retries=<n>   maxRetries for the 'native' and 'windows' implementations
+  --retry-delay=<n>   retryDelay for the 'native' implementation, default 100
+  --backoff=<n>       Exponential backoff factor for retries (default: 1.2)
+`;
+const path_1 = require("path");
+const main = async (...args) => {
+    if (process.env.__RIMRAF_TESTING_BIN_FAIL__ === '1') {
+        throw new Error('simulated rimraf failure');
+    }
+    const opt = {};
+    const paths = [];
+    let dashdash = false;
+    let impl = _1.default;
+    for (const arg of args) {
+        if (dashdash) {
+            paths.push(arg);
+            continue;
+        }
+        if (arg === '--') {
+            dashdash = true;
+            continue;
+        }
+        else if (arg === '-h' || arg === '--help') {
+            console.log(exports.help);
+            return 0;
+        }
+        else if (arg === '--preserve-root') {
+            opt.preserveRoot = true;
+            continue;
+        }
+        else if (arg === '--no-preserve-root') {
+            opt.preserveRoot = false;
+            continue;
+        }
+        else if (/^--tmp=/.test(arg)) {
+            const val = arg.substring('--tmp='.length);
+            opt.tmp = val;
+            continue;
+        }
+        else if (/^--max-retries=/.test(arg)) {
+            const val = +arg.substring('--max-retries='.length);
+            opt.maxRetries = val;
+            continue;
+        }
+        else if (/^--retry-delay=/.test(arg)) {
+            const val = +arg.substring('--retry-delay='.length);
+            opt.retryDelay = val;
+            continue;
+        }
+        else if (/^--backoff=/.test(arg)) {
+            const val = +arg.substring('--backoff='.length);
+            opt.backoff = val;
+            continue;
+        }
+        else if (/^--impl=/.test(arg)) {
+            const val = arg.substring('--impl='.length);
+            switch (val) {
+                case 'rimraf':
+                    impl = _1.default;
+                    continue;
+                case 'native':
+                case 'manual':
+                case 'posix':
+                case 'windows':
+                    impl = _1.default[val];
+                    continue;
+                case 'move-remove':
+                    impl = _1.default.moveRemove;
+                    continue;
+                default:
+                    console.error(`unknown implementation: ${val}`);
+                    runHelpForUsage();
+                    return 1;
+            }
+        }
+        else if (/^-/.test(arg)) {
+            console.error(`unknown option: ${arg}`);
+            runHelpForUsage();
+            return 1;
+        }
+        else {
+            paths.push(arg);
+        }
+    }
+    if (opt.preserveRoot !== false) {
+        for (const path of paths.map(p => (0, path_1.resolve)(p))) {
+            if (path === (0, path_1.parse)(path).root) {
+                console.error(`rimraf: it is dangerous to operate recursively on '/'`);
+                console.error('use --no-preserve-root to override this failsafe');
+                return 1;
+            }
+        }
+    }
+    if (!paths.length) {
+        console.error('rimraf: must provide a path to remove');
+        runHelpForUsage();
+        return 1;
+    }
+    await impl(paths, opt);
+    return 0;
+};
+main.help = exports.help;
+exports.default = main;
+if (typeof require === 'function' &&
+    typeof module === 'object' &&
+    require.main === module) {
+    const args = process.argv.slice(2);
+    main(...args).then(code => process.exit(code), er => {
+        console.error(er);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=bin.js.map

package/dist/cjs/src/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../../src/bin.ts"],"names":[],"mappings":"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"}

package/dist/cjs/src/default-tmp.d.ts

@@ -0,0 +1,2 @@
+export declare const defaultTmp: (path: string) => Promise<string>;
+export declare const defaultTmpSync: (path: string) => string;

package/dist/cjs/src/default-tmp.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultTmpSync = exports.defaultTmp = void 0;
+// The default temporary folder location for use in the windows algorithm.
+// It's TEMPting to use dirname(path), since that's guaranteed to be on the
+// same device.  However, this means that:
+// rimraf(path).then(() => rimraf(dirname(path)))
+// will often fail with EBUSY, because the parent dir contains
+// marked-for-deletion directory entries (which do not show up in readdir).
+// The approach here is to use os.tmpdir() if it's on the same drive letter,
+// or resolve(path, '\\temp') if it exists, or the root of the drive if not.
+// On Posix (not that you'd be likely to use the windows algorithm there),
+// it uses os.tmpdir() always.
+const os_1 = require("os");
+const path_1 = require("path");
+const fs_1 = require("./fs");
+const platform_1 = __importDefault(require("./platform"));
+const { stat } = fs_1.promises;
+const isDirSync = (path) => {
+    try {
+        return (0, fs_1.statSync)(path).isDirectory();
+    }
+    catch (er) {
+        return false;
+    }
+};
+const isDir = (path) => stat(path).then(st => st.isDirectory(), () => false);
+const win32DefaultTmp = async (path) => {
+    const { root } = (0, path_1.parse)(path);
+    const tmp = (0, os_1.tmpdir)();
+    const { root: tmpRoot } = (0, path_1.parse)(tmp);
+    if (root.toLowerCase() === tmpRoot.toLowerCase()) {
+        return tmp;
+    }
+    const driveTmp = (0, path_1.resolve)(root, '/temp');
+    if (await isDir(driveTmp)) {
+        return driveTmp;
+    }
+    return root;
+};
+const win32DefaultTmpSync = (path) => {
+    const { root } = (0, path_1.parse)(path);
+    const tmp = (0, os_1.tmpdir)();
+    const { root: tmpRoot } = (0, path_1.parse)(tmp);
+    if (root.toLowerCase() === tmpRoot.toLowerCase()) {
+        return tmp;
+    }
+    const driveTmp = (0, path_1.resolve)(root, '/temp');
+    if (isDirSync(driveTmp)) {
+        return driveTmp;
+    }
+    return root;
+};
+const posixDefaultTmp = async () => (0, os_1.tmpdir)();
+const posixDefaultTmpSync = () => (0, os_1.tmpdir)();
+exports.defaultTmp = platform_1.default === 'win32' ? win32DefaultTmp : posixDefaultTmp;
+exports.defaultTmpSync = platform_1.default === 'win32' ? win32DefaultTmpSync : posixDefaultTmpSync;
+//# sourceMappingURL=default-tmp.js.map

package/dist/cjs/src/default-tmp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-tmp.js","sourceRoot":"","sources":["../../../src/default-tmp.ts"],"names":[],"mappings":";;;;;;AAAA,0EAA0E;AAC1E,2EAA2E;AAC3E,0CAA0C;AAC1C,iDAAiD;AACjD,8DAA8D;AAC9D,2EAA2E;AAC3E,4EAA4E;AAC5E,4EAA4E;AAC5E,0EAA0E;AAC1E,8BAA8B;AAC9B,2BAA2B;AAC3B,+BAAqC;AACrC,6BAAyC;AACzC,0DAAiC;AACjC,MAAM,EAAE,IAAI,EAAE,GAAG,aAAQ,CAAA;AAEzB,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,EAAE;IACjC,IAAI;QACF,OAAO,IAAA,aAAQ,EAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAA;KACpC;IAAC,OAAO,EAAE,EAAE;QACX,OAAO,KAAK,CAAA;KACb;AACH,CAAC,CAAA;AAED,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE,CAC7B,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CACb,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,WAAW,EAAE,EACtB,GAAG,EAAE,CAAC,KAAK,CACZ,CAAA;AAEH,MAAM,eAAe,GAAG,KAAK,EAAE,IAAY,EAAE,EAAE;IAC7C,MAAM,EAAE,IAAI,EAAE,GAAG,IAAA,YAAK,EAAC,IAAI,CAAC,CAAA;IAC5B,MAAM,GAAG,GAAG,IAAA,WAAM,GAAE,CAAA;IACpB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAA,YAAK,EAAC,GAAG,CAAC,CAAA;IACpC,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,EAAE;QAChD,OAAO,GAAG,CAAA;KACX;IAED,MAAM,QAAQ,GAAG,IAAA,cAAO,EAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACvC,IAAI,MAAM,KAAK,CAAC,QAAQ,CAAC,EAAE;QACzB,OAAO,QAAQ,CAAA;KAChB;IAED,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED,MAAM,mBAAmB,GAAG,CAAC,IAAY,EAAE,EAAE;IAC3C,MAAM,EAAE,IAAI,EAAE,GAAG,IAAA,YAAK,EAAC,IAAI,CAAC,CAAA;IAC5B,MAAM,GAAG,GAAG,IAAA,WAAM,GAAE,CAAA;IACpB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAA,YAAK,EAAC,GAAG,CAAC,CAAA;IACpC,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,EAAE;QAChD,OAAO,GAAG,CAAA;KACX;IAED,MAAM,QAAQ,GAAG,IAAA,cAAO,EAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IACvC,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE;QACvB,OAAO,QAAQ,CAAA;KAChB;IAED,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED,MAAM,eAAe,GAAG,KAAK,IAAI,EAAE,CAAC,IAAA,WAAM,GAAE,CAAA;AAC5C,MAAM,mBAAmB,GAAG,GAAG,EAAE,CAAC,IAAA,WAAM,GAAE,CAAA;AAE7B,QAAA,UAAU,GACrB,kBAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,CAAA;AAC7C,QAAA,cAAc,GACzB,kBAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,mBAAmB,CAAA"}

package/dist/cjs/src/fix-eperm.d.ts

@@ -0,0 +1,2 @@
+export declare const fixEPERM: (fn: (path: string) => Promise<any>) => (path: string) => Promise<any>;
+export declare const fixEPERMSync: (fn: (path: string) => any) => (path: string) => any;

package/dist/cjs/src/fix-eperm.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fixEPERMSync = exports.fixEPERM = void 0;
+const fs_1 = require("./fs");
+const { chmod } = fs_1.promises;
+const fixEPERM = (fn) => async (path) => {
+    try {
+        return await fn(path);
+    }
+    catch (er) {
+        const fer = er;
+        if (fer?.code === 'ENOENT') {
+            return;
+        }
+        if (fer?.code === 'EPERM') {
+            try {
+                await chmod(path, 0o666);
+            }
+            catch (er2) {
+                const fer2 = er2;
+                if (fer2?.code === 'ENOENT') {
+                    return;
+                }
+                throw er;
+            }
+            return await fn(path);
+        }
+        throw er;
+    }
+};
+exports.fixEPERM = fixEPERM;
+const fixEPERMSync = (fn) => (path) => {
+    try {
+        return fn(path);
+    }
+    catch (er) {
+        const fer = er;
+        if (fer?.code === 'ENOENT') {
+            return;
+        }
+        if (fer?.code === 'EPERM') {
+            try {
+                (0, fs_1.chmodSync)(path, 0o666);
+            }
+            catch (er2) {
+                const fer2 = er2;
+                if (fer2?.code === 'ENOENT') {
+                    return;
+                }
+                throw er;
+            }
+            return fn(path);
+        }
+        throw er;
+    }
+};
+exports.fixEPERMSync = fixEPERMSync;
+//# sourceMappingURL=fix-eperm.js.map

package/dist/cjs/src/fix-eperm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix-eperm.js","sourceRoot":"","sources":["../../../src/fix-eperm.ts"],"names":[],"mappings":";;;AAAA,6BAAmD;AACnD,MAAM,EAAE,KAAK,EAAE,GAAG,aAAQ,CAAA;AAEnB,MAAM,QAAQ,GACnB,CAAC,EAAkC,EAAE,EAAE,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE;IAC7D,IAAI;QACF,OAAO,MAAM,EAAE,CAAC,IAAI,CAAC,CAAA;KACtB;IAAC,OAAO,EAAE,EAAE;QACX,MAAM,GAAG,GAAG,EAAa,CAAA;QACzB,IAAI,GAAG,EAAE,IAAI,KAAK,QAAQ,EAAE;YAC1B,OAAM;SACP;QACD,IAAI,GAAG,EAAE,IAAI,KAAK,OAAO,EAAE;YACzB,IAAI;gBACF,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;aACzB;YAAC,OAAO,GAAG,EAAE;gBACZ,MAAM,IAAI,GAAG,GAAc,CAAA;gBAC3B,IAAI,IAAI,EAAE,IAAI,KAAK,QAAQ,EAAE;oBAC3B,OAAM;iBACP;gBACD,MAAM,EAAE,CAAA;aACT;YACD,OAAO,MAAM,EAAE,CAAC,IAAI,CAAC,CAAA;SACtB;QACD,MAAM,EAAE,CAAA;KACT;AACH,CAAC,CAAA;AAvBU,QAAA,QAAQ,YAuBlB;AAEI,MAAM,YAAY,GAAG,CAAC,EAAyB,EAAE,EAAE,CAAC,CAAC,IAAY,EAAE,EAAE;IAC1E,IAAI;QACF,OAAO,EAAE,CAAC,IAAI,CAAC,CAAA;KAChB;IAAC,OAAO,EAAE,EAAE;QACX,MAAM,GAAG,GAAG,EAAa,CAAA;QACzB,IAAI,GAAG,EAAE,IAAI,KAAK,QAAQ,EAAE;YAC1B,OAAM;SACP;QACD,IAAI,GAAG,EAAE,IAAI,KAAK,OAAO,EAAE;YACzB,IAAI;gBACF,IAAA,cAAS,EAAC,IAAI,EAAE,KAAK,CAAC,CAAA;aACvB;YAAC,OAAO,GAAG,EAAE;gBACZ,MAAM,IAAI,GAAG,GAAc,CAAA;gBAC3B,IAAI,IAAI,EAAE,IAAI,KAAK,QAAQ,EAAE;oBAC3B,OAAM;iBACP;gBACD,MAAM,EAAE,CAAA;aACT;YACD,OAAO,EAAE,CAAC,IAAI,CAAC,CAAA;SAChB;QACD,MAAM,EAAE,CAAA;KACT;AACH,CAAC,CAAA;AAtBY,QAAA,YAAY,gBAsBxB"}

package/dist/cjs/src/fs.d.ts

@@ -0,0 +1,17 @@
+import fs from 'fs';
+export type FsError = Error & {
+    code?: string;
+};
+export { chmodSync, mkdirSync, readdirSync, renameSync, rmdirSync, rmSync, statSync, unlinkSync, } from 'fs';
+export declare const promises: {
+    chmod: (path: fs.PathLike, mode: fs.Mode) => Promise<void>;
+    mkdir: (path: fs.PathLike, options?: fs.Mode | (fs.MakeDirectoryOptions & {
+        recursive?: boolean | null;
+    }) | undefined | null) => Promise<string | undefined>;
+    readdir: (path: fs.PathLike) => Promise<string[]>;
+    rename: (oldPath: fs.PathLike, newPath: fs.PathLike) => Promise<void>;
+    rm: (path: fs.PathLike, options: fs.RmOptions) => Promise<void>;
+    rmdir: (path: fs.PathLike) => Promise<void>;
+    stat: (path: fs.PathLike) => Promise<fs.Stats>;
+    unlink: (path: fs.PathLike) => Promise<void>;
+};