mrs-toolbox-cli 10.1.17-cfb8fe4 → 11.0.0

package/npm-cache/_cacache/content-v2/sha512/{e3/5e/87d62729be09a750a069c8be4264a9380fe5da0662105780fa921329a3a190cf17b765cd576ebfdf394d4cc5adcfd9cf01e9f19d53ee91a07dea63a356d0 → 2b/00/15c1d6fbe1012e188ee9c921c68a030ef3f407fe89c2cb58af946ab0f5a195cd48d575969a2ee68707bcf7e24f6ae0489f9563fa3f0f46c3da5d978ca37b}

@@ -7008,11 +7008,231 @@
       },
       "_hasShrinkwrap": false,
       "contributors": []
+    },
+    "4.7.1": {
+      "name": "bare-fs",
+      "version": "4.7.1",
+      "description": "Native file system operations for Bare",
+      "exports": {
+        "./package": "./package.json",
+        ".": {
+          "types": "./index.d.ts",
+          "default": "./index.js"
+        },
+        "./promises": {
+          "types": "./promises.d.ts",
+          "default": "./promises.js"
+        },
+        "./constants": {
+          "types": "./lib/constants.d.ts",
+          "default": "./lib/constants.js"
+        }
+      },
+      "addon": true,
+      "scripts": {
+        "format": "prettier --write . && lunte --fix",
+        "lint": "prettier --check . && lunte",
+        "test": "brittle-bare --coverage test.js"
+      },
+      "repository": {
+        "type": "git",
+        "url": "git+https://github.com/holepunchto/bare-fs.git"
+      },
+      "author": {
+        "name": "Holepunch"
+      },
+      "license": "Apache-2.0",
+      "bugs": {
+        "url": "https://github.com/holepunchto/bare-fs/issues"
+      },
+      "homepage": "https://github.com/holepunchto/bare-fs#readme",
+      "engines": {
+        "bare": ">=1.16.0"
+      },
+      "dependencies": {
+        "bare-events": "^2.5.4",
+        "bare-path": "^3.0.0",
+        "bare-stream": "^2.6.4",
+        "bare-url": "^2.2.2",
+        "fast-fifo": "^1.3.2"
+      },
+      "devDependencies": {
+        "bare-buffer": "^3.0.2",
+        "bare-crypto": "^1.11.2",
+        "brittle": "^3.1.1",
+        "cmake-bare": "^1.1.7",
+        "lunte": "^1.6.0",
+        "prettier": "^3.4.1",
+        "prettier-config-holepunch": "^2.0.0"
+      },
+      "peerDependencies": {
+        "bare-buffer": "*"
+      },
+      "peerDependenciesMeta": {
+        "bare-buffer": {
+          "optional": true
+        }
+      },
+      "gitHead": "5d97145266603f704e19458c85f41a9ea8b2fa40",
+      "types": "./index.d.ts",
+      "_id": "bare-fs@4.7.1",
+      "_nodeVersion": "24.14.1",
+      "_npmVersion": "11.11.0",
+      "dist": {
+        "integrity": "sha512-WDRsyVN52eAx/lBamKD6uyw8H4228h/x0sGGGegOamM2cd7Pag88GfMQalobXI+HaEUxpCkbKQUDOQqt9wawRw==",
+        "shasum": "6e81f784761102867c13f0823aa48c942d160f00",
+        "tarball": "https://verdaccio.mrsdev.ru/bare-fs/-/bare-fs-4.7.1.tgz",
+        "fileCount": 27,
+        "unpackedSize": 1274865,
+        "attestations": {
+          "url": "https://registry.npmjs.org/-/npm/v1/attestations/bare-fs@4.7.1",
+          "provenance": {
+            "predicateType": "https://slsa.dev/provenance/v1"
+          }
+        },
+        "signatures": [
+          {
+            "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U",
+            "sig": "MEUCIQCa3N/ZKHeiAg3s9lXrYZmTFQSL1cxLto7lhLrP4ZYfNQIgVbFUxjnTaDXHuzAB/VeE1hTEhS9kAPh5KO0fwSDkWx4="
+          }
+        ]
+      },
+      "_npmUser": {
+        "name": "GitHub Actions",
+        "email": "npm-oidc-no-reply@github.com",
+        "trustedPublisher": {
+          "id": "github",
+          "oidcConfigId": "oidc:a4369cbd-3898-4e7f-a8ec-854da1e8c697"
+        }
+      },
+      "directories": {},
+      "maintainers": [
+        {
+          "name": "mafintosh",
+          "email": "mathiasbuus@gmail.com"
+        }
+      ],
+      "_npmOperationalInternal": {
+        "host": "s3://npm-registry-packages-npm-production",
+        "tmp": "tmp/bare-fs_4.7.1_1776235267142_0.855447070023172"
+      },
+      "_hasShrinkwrap": false,
+      "contributors": []
+    },
+    "4.7.2": {
+      "name": "bare-fs",
+      "version": "4.7.2",
+      "description": "Native file system operations for Bare",
+      "exports": {
+        "./package": "./package.json",
+        ".": {
+          "types": "./index.d.ts",
+          "default": "./index.js"
+        },
+        "./promises": {
+          "types": "./promises.d.ts",
+          "default": "./promises.js"
+        },
+        "./constants": {
+          "types": "./lib/constants.d.ts",
+          "default": "./lib/constants.js"
+        }
+      },
+      "addon": true,
+      "scripts": {
+        "format": "prettier --write . && lunte --fix",
+        "lint": "prettier --check . && lunte",
+        "test": "brittle-bare --coverage test.js"
+      },
+      "repository": {
+        "type": "git",
+        "url": "git+https://github.com/holepunchto/bare-fs.git"
+      },
+      "author": {
+        "name": "Holepunch"
+      },
+      "license": "Apache-2.0",
+      "bugs": {
+        "url": "https://github.com/holepunchto/bare-fs/issues"
+      },
+      "homepage": "https://github.com/holepunchto/bare-fs#readme",
+      "engines": {
+        "bare": ">=1.16.0"
+      },
+      "dependencies": {
+        "bare-events": "^2.5.4",
+        "bare-path": "^3.0.0",
+        "bare-stream": "^2.6.4",
+        "bare-url": "^2.2.2",
+        "fast-fifo": "^1.3.2"
+      },
+      "devDependencies": {
+        "bare-buffer": "^3.0.2",
+        "bare-crypto": "^1.11.2",
+        "brittle": "^3.1.1",
+        "cmake-bare": "^1.1.7",
+        "lunte": "^1.6.0",
+        "prettier": "^3.4.1",
+        "prettier-config-holepunch": "^2.0.0"
+      },
+      "peerDependencies": {
+        "bare-buffer": "*"
+      },
+      "peerDependenciesMeta": {
+        "bare-buffer": {
+          "optional": true
+        }
+      },
+      "gitHead": "c3f1e565c8ee20828ef89a3227f1f19879c7b33b",
+      "types": "./index.d.ts",
+      "_id": "bare-fs@4.7.2",
+      "_nodeVersion": "24.16.0",
+      "_npmVersion": "11.13.0",
+      "dist": {
+        "integrity": "sha512-aTvMFUWkBmjzKtEQMDGGDNF8bkfpD5N1b/FCwt7A3wrU4t1o/e/85Wzkluh6JlODCjqVESYCkQCdTXqZ9G7VFg==",
+        "shasum": "0f59b317e5bdbec6a1489b519a06a203cd3fe035",
+        "tarball": "https://verdaccio.mrsdev.ru/bare-fs/-/bare-fs-4.7.2.tgz",
+        "fileCount": 27,
+        "unpackedSize": 1275122,
+        "attestations": {
+          "url": "https://registry.npmjs.org/-/npm/v1/attestations/bare-fs@4.7.2",
+          "provenance": {
+            "predicateType": "https://slsa.dev/provenance/v1"
+          }
+        },
+        "signatures": [
+          {
+            "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U",
+            "sig": "MEQCIBFpeaLq3GejTXY6l1InvySICz5kVMNlrrFX2fNYyzjrAiBOuzN2AsNG9tCq7JD5o17eUHCy59NkTCAYyeHVd0kGfA=="
+          }
+        ]
+      },
+      "_npmUser": {
+        "name": "GitHub Actions",
+        "email": "npm-oidc-no-reply@github.com",
+        "trustedPublisher": {
+          "id": "github",
+          "oidcConfigId": "oidc:a4369cbd-3898-4e7f-a8ec-854da1e8c697"
+        }
+      },
+      "directories": {},
+      "maintainers": [
+        {
+          "name": "mafintosh",
+          "email": "mathiasbuus@gmail.com"
+        }
+      ],
+      "_npmOperationalInternal": {
+        "host": "s3://npm-registry-packages-npm-production",
+        "tmp": "tmp/bare-fs_4.7.2_1780389250781_0.24096174679749338"
+      },
+      "_hasShrinkwrap": false,
+      "contributors": []
     }
   },
   "time": {
     "created": "2023-05-16T08:24:58.193Z",
-    "modified": "2026-04-09T14:02:22.419Z",
+    "modified": "2026-06-02T08:34:11.222Z",
     "1.5.3": "2023-05-16T08:24:58.385Z",
     "1.5.4": "2023-05-22T11:31:59.806Z",
     "1.5.5": "2023-05-23T12:29:17.979Z",
@@ -7097,14 +7317,16 @@
     "4.5.5": "2026-02-25T14:10:41.849Z",
     "4.5.6": "2026-03-19T10:42:27.735Z",
     "4.6.0": "2026-04-02T14:43:33.636Z",
-    "4.7.0": "2026-04-09T14:02:22.115Z"
+    "4.7.0": "2026-04-09T14:02:22.115Z",
+    "4.7.1": "2026-04-15T06:41:07.285Z",
+    "4.7.2": "2026-06-02T08:34:10.944Z"
   },
   "users": {},
   "dist-tags": {
-    "latest": "4.7.0"
+    "latest": "4.7.2"
   },
-  "_rev": "858-fcc4c3891966467a",
+  "_rev": "912-fc3b26680e05211d",
   "_id": "bare-fs",
-  "readme": "# bare-fs\n\nNative file system operations for Bare. The API closely follows that of the Node.js `fs` module.\n\n```\nnpm i bare-fs\n```\n\n## Usage\n\n```js\nconst fs = require('bare-fs')\n\nconst fd = await fs.open('hello.txt')\n\nconst buffer = Buffer.alloc(1024)\n\ntry {\n  const length = await fs.read(fd, buffer)\n\n  console.log('Read', length, 'bytes')\n} finally {\n  await fs.close(fd)\n}\n```\n\n## API\n\n#### `const fd = await fs.open(filepath[, flags[, mode]])`\n\nOpen a file, returning a file descriptor. `flags` defaults to `'r'` and `mode` defaults to `0o666`. `flags` may be a string such as `'r'`, `'w'`, `'a'`, `'r+'`, etc., or a numeric combination of `fs.constants` flags.\n\n#### `fs.open(filepath[, flags[, mode]], callback)`\n\nCallback version of `fs.open()`.\n\n#### `const fd = fs.openSync(filepath[, flags[, mode]])`\n\nSynchronous version of `fs.open()`.\n\n#### `await fs.close(fd)`\n\nClose a file descriptor.\n\n#### `fs.close(fd, callback)`\n\nCallback version of `fs.close()`.\n\n#### `fs.closeSync(fd)`\n\nSynchronous version of `fs.close()`.\n\n#### `await fs.access(filepath[, mode])`\n\nCheck whether the file at `filepath` is accessible. `mode` defaults to `fs.constants.F_OK`.\n\n#### `fs.access(filepath[, mode], callback)`\n\nCallback version of `fs.access()`.\n\n#### `fs.accessSync(filepath[, mode])`\n\nSynchronous version of `fs.access()`.\n\n#### `const exists = await fs.exists(filepath)`\n\nCheck whether a file exists at `filepath`. Returns `true` if the file is accessible, `false` otherwise.\n\n#### `fs.exists(filepath, callback)`\n\nCallback version of `fs.exists()`.\n\n#### `const exists = fs.existsSync(filepath)`\n\nSynchronous version of `fs.exists()`.\n\n#### `const bytesRead = await fs.read(fd, buffer[, offset[, len[, pos]]])`\n\nRead from a file descriptor into `buffer`. `offset` defaults to `0`, `len` defaults to `buffer.byteLength - offset`, and `pos` defaults to `-1` (current position). Returns the number of bytes read.\n\n#### `fs.read(fd, buffer[, offset[, len[, pos]]], callback)`\n\nCallback version of `fs.read()`.\n\n#### `const bytesRead = fs.readSync(fd, buffer[, offset[, len[, pos]]])`\n\nSynchronous version of `fs.read()`.\n\n#### `const bytesRead = await fs.readv(fd, buffers[, pos])`\n\nRead from a file descriptor into an array of `buffers`. `pos` defaults to `-1`.\n\n#### `fs.readv(fd, buffers[, pos], callback)`\n\nCallback version of `fs.readv()`.\n\n#### `const bytesRead = fs.readvSync(fd, buffers[, pos])`\n\nSynchronous version of `fs.readv()`.\n\n#### `const bytesWritten = await fs.write(fd, data[, offset[, len[, pos]]])`\n\nWrite `data` to a file descriptor. When `data` is a string, the signature is `fs.write(fd, data[, pos[, encoding]])` where `encoding` defaults to `'utf8'`. Returns the number of bytes written.\n\n#### `fs.write(fd, data[, offset[, len[, pos]]], callback)`\n\nCallback version of `fs.write()`.\n\n#### `const bytesWritten = fs.writeSync(fd, data[, offset[, len[, pos]]])`\n\nSynchronous version of `fs.write()`.\n\n#### `const bytesWritten = await fs.writev(fd, buffers[, pos])`\n\nWrite an array of `buffers` to a file descriptor. `pos` defaults to `-1`.\n\n#### `fs.writev(fd, buffers[, pos], callback)`\n\nCallback version of `fs.writev()`.\n\n#### `const bytesWritten = fs.writevSync(fd, buffers[, pos])`\n\nSynchronous version of `fs.writev()`.\n\n#### `const stats = await fs.stat(filepath)`\n\nGet the status of a file. Returns a `Stats` object.\n\n#### `fs.stat(filepath, callback)`\n\nCallback version of `fs.stat()`.\n\n#### `const stats = fs.statSync(filepath)`\n\nSynchronous version of `fs.stat()`.\n\n#### `const stats = await fs.lstat(filepath)`\n\nLike `fs.stat()`, but if `filepath` is a symbolic link, the link itself is statted, not the file it refers to.\n\n#### `fs.lstat(filepath, callback)`\n\nCallback version of `fs.lstat()`.\n\n#### `const stats = fs.lstatSync(filepath)`\n\nSynchronous version of `fs.lstat()`.\n\n#### `const stats = await fs.fstat(fd)`\n\nGet the status of a file by its file descriptor. Returns a `Stats` object.\n\n#### `fs.fstat(fd, callback)`\n\nCallback version of `fs.fstat()`.\n\n#### `const stats = fs.fstatSync(fd)`\n\nSynchronous version of `fs.fstat()`.\n\n#### `const stats = await fs.statfs(filepath)`\n\nGet filesystem statistics. Returns a `StatFs` object.\n\n#### `fs.statfs(filepath, callback)`\n\nCallback version of `fs.statfs()`.\n\n#### `const stats = fs.statfsSync(filepath)`\n\nSynchronous version of `fs.statfs()`.\n\n#### `await fs.ftruncate(fd[, len])`\n\nTruncate a file to `len` bytes. `len` defaults to `0`.\n\n#### `fs.ftruncate(fd[, len], callback)`\n\nCallback version of `fs.ftruncate()`.\n\n#### `fs.ftruncateSync(fd[, len])`\n\nSynchronous version of `fs.ftruncate()`.\n\n#### `await fs.chmod(filepath, mode)`\n\nChange the permissions of a file. `mode` may be a numeric mode or a string that will be parsed as octal.\n\n#### `fs.chmod(filepath, mode, callback)`\n\nCallback version of `fs.chmod()`.\n\n#### `fs.chmodSync(filepath, mode)`\n\nSynchronous version of `fs.chmod()`.\n\n#### `await fs.fchmod(fd, mode)`\n\nChange the permissions of a file by its file descriptor.\n\n#### `fs.fchmod(fd, mode, callback)`\n\nCallback version of `fs.fchmod()`.\n\n#### `fs.fchmodSync(fd, mode)`\n\nSynchronous version of `fs.fchmod()`.\n\n#### `await fs.chown(filepath, uid, gid)`\n\nChange the owner and group of a file.\n\n**NOTE**: The `chown` functions are not implemented on Windows.\n\n#### `fs.chown(filepath,  uid, gid, callback)`\n\nCallback version of `fs.chown()`.\n\n#### `await fs.chownSync(filepath, uid, gid)`\n\nSynchronous version of `fs.chown()`.\n\n#### `await fs.lchown(filepath, uid, gid)`\n\nChange the owner and group of a file, but if `filepath` is a symbolic link, the changes are applied only to the link, not the file it refers to.\n\n#### `fs.lchown(filepath,  uid, gid, callback)`\n\nCallback version of `fs.lchown()`.\n\n#### `fs.lchownSync(filepath, uid, gid)`\n\nSynchronous version of `fs.lchown()`.\n\n#### `await fs.fchown(filepath, uid, gid)`\n\nChange the owner and group of a file by its file descriptor.\n\n#### `fs.fchown(filepath,  uid, gid, callback)`\n\nCallback version of `fs.fchown()`.\n\n#### `fs.fchownSync(filepath, uid, gid)`\n\nSynchronous version of `fs.fchown()`.\n\n#### `await fs.utimes(filepath, atime, mtime)`\n\nChange the access and modification times of a file. Times may be numbers (seconds since epoch) or `Date` objects.\n\n#### `fs.utimes(filepath, atime, mtime, callback)`\n\nCallback version of `fs.utimes()`.\n\n#### `fs.utimesSync(filepath, atime, mtime)`\n\nSynchronous version of `fs.utimes()`.\n\n#### `await fs.lutimes(filepath, atime, mtime)`\n\nLike `fs.utimes()`, but if `filepath` is a symbolic link, the timestamps of the link is changed, not the file it refers to.\n\n#### `fs.lutimes(filepath, atime, mtime, callback)`\n\nCallback version of `fs.lutimes()`.\n\n#### `fs.lutimesSync(filepath, atime, mtime)`\n\nSynchronous version of `fs.lutimes()`.\n\n#### `await fs.futimes(fd, atime, mtime)`\n\nChange the access and modification times of a file by its file descriptor. Times may be numbers (seconds since epoch) or `Date` objects.\n\n#### `fs.futimes(fd, atime, mtime, callback)`\n\nCallback version of `fs.futimes()`.\n\n#### `fs.futimesSync(fd, atime, mtime)`\n\nSynchronous version of `fs.futimes()`.\n\n#### `await fs.link(src, dst)`\n\nCreates a new link (also known as a hard link) to an existing file.\n\n#### `fs.link(src, dst, callback)`\n\nCallback version of `fs.link()`.\n\n#### `fs.linkSync(src, dst)`\n\nSynchronous version of `fs.link()`.\n\n#### `await fs.mkdir(filepath[, opts])`\n\nCreate a directory at `filepath`.\n\nOptions include:\n\n```js\noptions = {\n  mode: 0o777,\n  recursive: false\n}\n```\n\nIf `opts` is a number, it is treated as the `mode`. When `recursive` is `true`, parent directories are created as needed.\n\n#### `fs.mkdir(filepath[, opts], callback)`\n\nCallback version of `fs.mkdir()`.\n\n#### `fs.mkdirSync(filepath[, opts])`\n\nSynchronous version of `fs.mkdir()`.\n\n#### `const path = await fs.mkdtemp(prefix)`\n\nCreate a unique temporary directory.\n\n#### `fs.mkdtemp(prefix, callback)`\n\nCallback version of `fs.mkdtemp()`.\n\n#### `const path = fs.mkdtempSync(prefix)`\n\nSynchronous version of `fs.mkdtemp()`.\n\n#### `await fs.rmdir(filepath)`\n\nRemove an empty directory.\n\n#### `fs.rmdir(filepath, callback)`\n\nCallback version of `fs.rmdir()`.\n\n#### `fs.rmdirSync(filepath)`\n\nSynchronous version of `fs.rmdir()`.\n\n#### `await fs.rm(filepath[, opts])`\n\nRemove a file or directory at `filepath`.\n\nOptions include:\n\n```js\noptions = {\n  force: false,\n  recursive: false\n}\n```\n\nWhen `recursive` is `true`, directories are removed along with their contents. When `force` is `true`, no error is thrown if `filepath` does not exist.\n\n#### `fs.rm(filepath[, opts], callback)`\n\nCallback version of `fs.rm()`.\n\n#### `fs.rmSync(filepath[, opts])`\n\nSynchronous version of `fs.rm()`.\n\n#### `await fs.unlink(filepath)`\n\nRemove a file.\n\n#### `fs.unlink(filepath, callback)`\n\nCallback version of `fs.unlink()`.\n\n#### `fs.unlinkSync(filepath)`\n\nSynchronous version of `fs.unlink()`.\n\n#### `await fs.rename(src, dst)`\n\nRename a file from `src` to `dst`.\n\n#### `fs.rename(src, dst, callback)`\n\nCallback version of `fs.rename()`.\n\n#### `fs.renameSync(src, dst)`\n\nSynchronous version of `fs.rename()`.\n\n#### `await fs.copyFile(src, dst[, mode])`\n\nCopy a file from `src` to `dst`. `mode` is an optional bitmask created from `fs.constants.COPYFILE_EXCL`, `fs.constants.COPYFILE_FICLONE`, or `fs.constants.COPYFILE_FICLONE_FORCE`.\n\n#### `fs.copyFile(src, dst[, mode], callback)`\n\nCallback version of `fs.copyFile()`.\n\n#### `fs.copyFileSync(src, dst[, mode])`\n\nSynchronous version of `fs.copyFile()`.\n\n#### `await fs.cp(src, dst[, opts])`\n\nCopy a file or directory from `src` to `dst`.\n\nOptions include:\n\n```js\noptions = {\n  recursive: false\n}\n```\n\nSet `recursive` to `true` to copy directories and their contents. Files are copied preserving their permissions.\n\n#### `fs.cp(src, dst[, opts], callback)`\n\nCallback version of `fs.cp()`.\n\n#### `fs.cpSync(src, dst[, opts])`\n\nSynchronous version of `fs.cp()`.\n\n#### `const resolved = await fs.realpath(filepath[, opts])`\n\nResolve the real path of `filepath`, expanding all symbolic links.\n\nOptions include:\n\n```js\noptions = {\n  encoding: 'utf8'\n}\n```\n\nSet `encoding` to `'buffer'` to receive the result as a `Buffer`.\n\n#### `fs.realpath(filepath[, opts], callback)`\n\nCallback version of `fs.realpath()`.\n\n#### `const resolved = fs.realpathSync(filepath[, opts])`\n\nSynchronous version of `fs.realpath()`.\n\n#### `const target = await fs.readlink(filepath[, opts])`\n\nRead the target of a symbolic link.\n\nOptions include:\n\n```js\noptions = {\n  encoding: 'utf8'\n}\n```\n\n#### `fs.readlink(filepath[, opts], callback)`\n\nCallback version of `fs.readlink()`.\n\n#### `const target = fs.readlinkSync(filepath[, opts])`\n\nSynchronous version of `fs.readlink()`.\n\n#### `await fs.truncate(filename[, len])`\n\nTruncate the file at `filename` to `len` bytes. `len` defaults to `0`.\n\n#### `fs.truncate(filename[, len], callback)`\n\nCallback version of `fs.truncate()`.\n\n#### `fs.truncateSync(filename[, len])`\n\nSynchronous version of `fs.truncate()`.\n\n#### `await fs.symlink(target, filepath[, type])`\n\nCreate a symbolic link at `filepath` pointing to `target`. `type` may be `'file'`, `'dir'`, or `'junction'` (Windows only) or a numeric flag. On Windows, if `type` is not provided, it is inferred from the target.\n\n#### `fs.symlink(target, filepath[, type], callback)`\n\nCallback version of `fs.symlink()`.\n\n#### `fs.symlinkSync(target, filepath[, type])`\n\nSynchronous version of `fs.symlink()`.\n\n#### `await fs.fsync(fd)`\n\nFlush all modified in-core data of the file referred by its file descriptor to the disk device.\n\n#### `fs.fsync(fs, callback)`\n\nCallback version of `fs.fsync()`.\n\n#### `fs.fsyncSync(fd)`\n\nSynchronous version of `fs.fsync()`.\n\n#### `await fs.fdatasync(fd)`\n\nSimilar to `fsync`, but does not flush modified metadata unless necessary.\n\n#### `fs.fdatasync(fs, callback)`\n\nCallback version of `fs.fdatasync()`.\n\n#### `fs.fdatasyncSync(fd)`\n\nSynchronous version of `fs.fdatasync()`.\n\n#### `const dir = await fs.opendir(filepath[, opts])`\n\nOpen a directory for iteration. Returns a `Dir` object.\n\nOptions include:\n\n```js\noptions = {\n  encoding: 'utf8',\n  bufferSize: 32\n}\n```\n\n#### `fs.opendir(filepath[, opts], callback)`\n\nCallback version of `fs.opendir()`.\n\n#### `const dir = fs.opendirSync(filepath[, opts])`\n\nSynchronous version of `fs.opendir()`.\n\n#### `const entries = await fs.readdir(filepath[, opts])`\n\nRead the contents of a directory. Returns an array of filenames or, if `withFileTypes` is `true`, an array of `Dirent` objects.\n\nOptions include:\n\n```js\noptions = {\n  encoding: 'utf8',\n  withFileTypes: false\n}\n```\n\n#### `fs.readdir(filepath[, opts], callback)`\n\nCallback version of `fs.readdir()`.\n\n#### `const entries = fs.readdirSync(filepath[, opts])`\n\nSynchronous version of `fs.readdir()`.\n\n#### `const data = await fs.readFile(filepath[, opts])`\n\nRead the entire contents of a file. Returns a `Buffer` by default, or a string if an `encoding` is specified.\n\nOptions include:\n\n```js\noptions = {\n  encoding: 'buffer',\n  flag: 'r'\n}\n```\n\n#### `fs.readFile(filepath[, opts], callback)`\n\nCallback version of `fs.readFile()`.\n\n#### `const data = fs.readFileSync(filepath[, opts])`\n\nSynchronous version of `fs.readFile()`.\n\n#### `await fs.writeFile(filepath, data[, opts])`\n\nWrite `data` to a file, replacing it if it already exists.\n\nOptions include:\n\n```js\noptions = {\n  encoding: 'utf8',\n  flag: 'w',\n  mode: 0o666\n}\n```\n\n#### `fs.writeFile(filepath, data[, opts], callback)`\n\nCallback version of `fs.writeFile()`.\n\n#### `fs.writeFileSync(filepath, data[, opts])`\n\nSynchronous version of `fs.writeFile()`.\n\n#### `await fs.appendFile(filepath, data[, opts])`\n\nAppend `data` to a file, creating it if it does not exist. Accepts the same options as `fs.writeFile()` but defaults to the `'a'` flag.\n\n#### `fs.appendFile(filepath, data[, opts], callback)`\n\nCallback version of `fs.appendFile()`.\n\n#### `fs.appendFileSync(filepath, data[, opts])`\n\nSynchronous version of `fs.appendFile()`.\n\n#### `const watcher = fs.watch(filepath[, opts], callback)`\n\nWatch a file or directory for changes. Returns a `Watcher` object. The `callback`, if provided, is called with `(eventType, filename)` on each change.\n\nOptions include:\n\n```js\noptions = {\n  persistent: true,\n  recursive: false,\n  encoding: 'utf8'\n}\n```\n\n#### `const stream = fs.createReadStream(path[, opts])`\n\nCreate a readable stream for a file. Returns a `ReadStream`.\n\nOptions include:\n\n```js\noptions = {\n  fd: -1,\n  flags: 'r',\n  mode: 0o666,\n  start: 0,\n  end: Infinity\n}\n```\n\nIf `fd` is provided, `path` may be `null` and the stream reads from the given file descriptor.\n\n#### `const stream = fs.createWriteStream(path[, opts])`\n\nCreate a writable stream for a file. Returns a `WriteStream`.\n\nOptions include:\n\n```js\noptions = {\n  fd: -1,\n  flags: 'w',\n  mode: 0o666\n}\n```\n\nIf `fd` is provided, `path` may be `null` and the stream writes to the given file descriptor.\n\n#### `fs.constants`\n\nAn object containing file system constants. See `fs/constants` for the full list. Commonly used constants include:\n\n- `fs.constants.O_RDONLY`, `fs.constants.O_WRONLY`, `fs.constants.O_RDWR` — file access flags\n- `fs.constants.O_CREAT`, `fs.constants.O_TRUNC`, `fs.constants.O_APPEND` — file creation flags\n- `fs.constants.F_OK`, `fs.constants.R_OK`, `fs.constants.W_OK`, `fs.constants.X_OK` — file accessibility flags\n- `fs.constants.S_IFMT`, `fs.constants.S_IFREG`, `fs.constants.S_IFDIR`, `fs.constants.S_IFLNK` — file type flags\n- `fs.constants.COPYFILE_EXCL`, `fs.constants.COPYFILE_FICLONE`, `fs.constants.COPYFILE_FICLONE_FORCE` — copy flags\n\n### `Stats`\n\nReturned by `fs.stat()`, `fs.lstat()`, and `fs.fstat()`.\n\n#### `stats.dev`\n\nThe device identifier.\n\n#### `stats.mode`\n\nThe file mode (type and permissions).\n\n#### `stats.nlink`\n\nThe number of hard links.\n\n#### `stats.uid`\n\nThe user identifier of the file owner.\n\n#### `stats.gid`\n\nThe group identifier of the file owner.\n\n#### `stats.rdev`\n\nThe device identifier for special files.\n\n#### `stats.blksize`\n\nThe file system block size for I/O operations.\n\n#### `stats.ino`\n\nThe inode number.\n\n#### `stats.size`\n\nThe size of the file in bytes.\n\n#### `stats.blocks`\n\nThe number of 512-byte blocks allocated.\n\n#### `stats.atimeMs`\n\nThe access time in milliseconds since the epoch.\n\n#### `stats.mtimeMs`\n\nThe modification time in milliseconds since the epoch.\n\n#### `stats.ctimeMs`\n\nThe change time in milliseconds since the epoch.\n\n#### `stats.birthtimeMs`\n\nThe creation time in milliseconds since the epoch.\n\n#### `stats.atime`\n\nThe access time as a `Date` object.\n\n#### `stats.mtime`\n\nThe modification time as a `Date` object.\n\n#### `stats.ctime`\n\nThe change time as a `Date` object.\n\n#### `stats.birthtime`\n\nThe creation time as a `Date` object.\n\n#### `stats.isDirectory()`\n\nReturns `true` if the file is a directory.\n\n#### `stats.isFile()`\n\nReturns `true` if the file is a regular file.\n\n#### `stats.isBlockDevice()`\n\nReturns `true` if the file is a block device.\n\n#### `stats.isCharacterDevice()`\n\nReturns `true` if the file is a character device.\n\n#### `stats.isFIFO()`\n\nReturns `true` if the file is a FIFO (named pipe).\n\n#### `stats.isSymbolicLink()`\n\nReturns `true` if the file is a symbolic link. Only meaningful when using `fs.lstat()`.\n\n#### `stats.isSocket()`\n\nReturns `true` if the file is a socket.\n\n### `Dir`\n\nReturned by `fs.opendir()`. Supports both synchronous and asynchronous iteration.\n\n#### `dir.path`\n\nThe path of the directory.\n\n#### `const dirent = await dir.read()`\n\nRead the next directory entry. Returns a `Dirent` or `null` when all entries have been read.\n\n#### `dir.read(callback)`\n\nCallback version of `dir.read()`.\n\n#### `const dirent = dir.readSync()`\n\nSynchronous version of `dir.read()`.\n\n#### `await dir.close()`\n\nClose the directory handle.\n\n#### `dir.close(callback)`\n\nCallback version of `dir.close()`.\n\n#### `dir.closeSync()`\n\nSynchronous version of `dir.close()`.\n\n### `Dirent`\n\nRepresents a directory entry, returned when iterating a `Dir` or using `fs.readdir()` with `withFileTypes: true`.\n\n#### `dirent.parentPath`\n\nThe path of the parent directory.\n\n#### `dirent.name`\n\nThe name of the directory entry, as a string or `Buffer` depending on the encoding.\n\n#### `dirent.type`\n\nThe numeric type of the directory entry.\n\n#### `dirent.isFile()`\n\nReturns `true` if the entry is a regular file.\n\n#### `dirent.isDirectory()`\n\nReturns `true` if the entry is a directory.\n\n#### `dirent.isSymbolicLink()`\n\nReturns `true` if the entry is a symbolic link.\n\n#### `dirent.isFIFO()`\n\nReturns `true` if the entry is a FIFO.\n\n#### `dirent.isSocket()`\n\nReturns `true` if the entry is a socket.\n\n#### `dirent.isCharacterDevice()`\n\nReturns `true` if the entry is a character device.\n\n#### `dirent.isBlockDevice()`\n\nReturns `true` if the entry is a block device.\n\n### `ReadStream`\n\nA readable stream for file data, created by `fs.createReadStream()`. Extends `Readable` from <https://github.com/holepunchto/bare-stream>.\n\n#### `stream.path`\n\nThe file path, or `null` if opened by file descriptor.\n\n#### `stream.fd`\n\nThe underlying file descriptor.\n\n#### `stream.flags`\n\nThe flags the file was opened with.\n\n#### `stream.mode`\n\nThe mode the file was opened with.\n\n### `WriteStream`\n\nA writable stream for file data, created by `fs.createWriteStream()`. Extends `Writable` from <https://github.com/holepunchto/bare-stream>.\n\n#### `stream.path`\n\nThe file path, or `null` if opened by file descriptor.\n\n#### `stream.fd`\n\nThe underlying file descriptor.\n\n#### `stream.flags`\n\nThe flags the file was opened with.\n\n#### `stream.mode`\n\nThe mode the file was opened with.\n\n### `Watcher`\n\nWatches for file system changes, created by `fs.watch()`. Extends `EventEmitter` from <https://github.com/holepunchto/bare-events>.\n\n#### `watcher.close()`\n\nStop watching for changes.\n\n#### `watcher.ref()`\n\nPrevent the event loop from exiting while the watcher is active.\n\n#### `watcher.unref()`\n\nAllow the event loop to exit even if the watcher is still active.\n\n#### `event: 'change'`\n\nEmitted with `(eventType, filename)` when a change is detected. `eventType` is either `'rename'` or `'change'`.\n\n#### `event: 'error'`\n\nEmitted with `(err)` when an error occurs.\n\n#### `event: 'close'`\n\nEmitted when the watcher is closed.\n\n### `FileHandle`\n\nReturned by `require('bare-fs/promises').open()`. Provides an object-oriented API for working with file descriptors.\n\n#### `await handle.close()`\n\nClose the file handle.\n\n#### `const { bytesRead, buffer } = await handle.read(buffer[, offset[, len[, pos]]])`\n\nRead from the file into `buffer`.\n\n#### `const { bytesRead, buffers } = await handle.readv(buffers[, pos])`\n\nRead from the file into an array of `buffers`.\n\n#### `const { bytesWritten, buffer } = await handle.write(data[, offset[, len[, pos]]])`\n\nWrite `data` to the file.\n\n#### `const { bytesWritten, buffers } = await handle.writev(buffers[, pos])`\n\nWrite an array of `buffers` to the file.\n\n#### `const stats = await handle.stat()`\n\nGet the status of the file.\n\n#### `await handle.chmod(mode)`\n\nChange the permissions of the file.\n\n#### `await handle.chown(uid, gid)`\n\nChange the owner and group of the file.\n\n**NOTE**: This function is not implemented on Windows.\n\n#### `await handle.datasync()`\n\nSimilar to `fsync`, but does not flush modified metadata unless necessary.\n\n#### `await handle.sync()`\n\nFlush all modified in-core data of the file.\n\n#### `await handle.truncate(len)`\n\nTruncate the file.\n\n#### `await handle.utimes(mode)`\n\nChange the access and modification times of the file.\n\n#### `const stream = handle.createReadStream([opts])`\n\nCreate a readable stream for the file.\n\n#### `const stream = handle.createWriteStream([opts])`\n\nCreate a writable stream for the file.\n\n#### `handle.fd`\n\nThe file descriptor number.\n\n#### `event: 'close'`\n\nEmitted when the file handle is closed.\n\n## License\n\nApache-2.0",
+  "readme": "# bare-fs\n\nNative file system operations for Bare. The API closely follows that of the Node.js `fs` module.\n\n```\nnpm i bare-fs\n```\n\n## Usage\n\n```js\nconst fs = require('bare-fs')\n\nconst fd = await fs.open('hello.txt')\n\nconst buffer = Buffer.alloc(1024)\n\ntry {\n  const length = await fs.read(fd, buffer)\n\n  console.log('Read', length, 'bytes')\n} finally {\n  await fs.close(fd)\n}\n```\n\n## API\n\n#### `const fd = await fs.open(filepath[, flags[, mode]])`\n\nOpen a file, returning a file descriptor. `flags` defaults to `'r'` and `mode` defaults to `0o666`. `flags` may be a string such as `'r'`, `'w'`, `'a'`, `'r+'`, etc., or a numeric combination of `fs.constants` flags.\n\n#### `fs.open(filepath[, flags[, mode]], callback)`\n\nCallback version of `fs.open()`.\n\n#### `const fd = fs.openSync(filepath[, flags[, mode]])`\n\nSynchronous version of `fs.open()`.\n\n#### `await fs.close(fd)`\n\nClose a file descriptor.\n\n#### `fs.close(fd, callback)`\n\nCallback version of `fs.close()`.\n\n#### `fs.closeSync(fd)`\n\nSynchronous version of `fs.close()`.\n\n#### `await fs.access(filepath[, mode])`\n\nCheck whether the file at `filepath` is accessible. `mode` defaults to `fs.constants.F_OK`.\n\n#### `fs.access(filepath[, mode], callback)`\n\nCallback version of `fs.access()`.\n\n#### `fs.accessSync(filepath[, mode])`\n\nSynchronous version of `fs.access()`.\n\n#### `const exists = await fs.exists(filepath)`\n\nCheck whether a file exists at `filepath`. Returns `true` if the file is accessible, `false` otherwise.\n\n#### `fs.exists(filepath, callback)`\n\nCallback version of `fs.exists()`.\n\n#### `const exists = fs.existsSync(filepath)`\n\nSynchronous version of `fs.exists()`.\n\n#### `const bytesRead = await fs.read(fd, buffer[, offset[, len[, pos]]])`\n\nRead from a file descriptor into `buffer`. `offset` defaults to `0`, `len` defaults to `buffer.byteLength - offset`, and `pos` defaults to `-1` (current position). Returns the number of bytes read.\n\n#### `fs.read(fd, buffer[, offset[, len[, pos]]], callback)`\n\nCallback version of `fs.read()`.\n\n#### `const bytesRead = fs.readSync(fd, buffer[, offset[, len[, pos]]])`\n\nSynchronous version of `fs.read()`.\n\n#### `const bytesRead = await fs.readv(fd, buffers[, pos])`\n\nRead from a file descriptor into an array of `buffers`. `pos` defaults to `-1`.\n\n#### `fs.readv(fd, buffers[, pos], callback)`\n\nCallback version of `fs.readv()`.\n\n#### `const bytesRead = fs.readvSync(fd, buffers[, pos])`\n\nSynchronous version of `fs.readv()`.\n\n#### `const bytesWritten = await fs.write(fd, data[, offset[, len[, pos]]])`\n\nWrite `data` to a file descriptor. When `data` is a string, the signature is `fs.write(fd, data[, pos[, encoding]])` where `encoding` defaults to `'utf8'`. Returns the number of bytes written.\n\n#### `fs.write(fd, data[, offset[, len[, pos]]], callback)`\n\nCallback version of `fs.write()`.\n\n#### `const bytesWritten = fs.writeSync(fd, data[, offset[, len[, pos]]])`\n\nSynchronous version of `fs.write()`.\n\n#### `const bytesWritten = await fs.writev(fd, buffers[, pos])`\n\nWrite an array of `buffers` to a file descriptor. `pos` defaults to `-1`.\n\n#### `fs.writev(fd, buffers[, pos], callback)`\n\nCallback version of `fs.writev()`.\n\n#### `const bytesWritten = fs.writevSync(fd, buffers[, pos])`\n\nSynchronous version of `fs.writev()`.\n\n#### `const stats = await fs.stat(filepath)`\n\nGet the status of a file. Returns a `Stats` object.\n\n#### `fs.stat(filepath, callback)`\n\nCallback version of `fs.stat()`.\n\n#### `const stats = fs.statSync(filepath)`\n\nSynchronous version of `fs.stat()`.\n\n#### `const stats = await fs.lstat(filepath)`\n\nLike `fs.stat()`, but if `filepath` is a symbolic link, the link itself is statted, not the file it refers to.\n\n#### `fs.lstat(filepath, callback)`\n\nCallback version of `fs.lstat()`.\n\n#### `const stats = fs.lstatSync(filepath)`\n\nSynchronous version of `fs.lstat()`.\n\n#### `const stats = await fs.fstat(fd)`\n\nGet the status of a file by its file descriptor. Returns a `Stats` object.\n\n#### `fs.fstat(fd, callback)`\n\nCallback version of `fs.fstat()`.\n\n#### `const stats = fs.fstatSync(fd)`\n\nSynchronous version of `fs.fstat()`.\n\n#### `const stats = await fs.statfs(filepath)`\n\nGet filesystem statistics. Returns a `StatFs` object.\n\n#### `fs.statfs(filepath, callback)`\n\nCallback version of `fs.statfs()`.\n\n#### `const stats = fs.statfsSync(filepath)`\n\nSynchronous version of `fs.statfs()`.\n\n#### `await fs.ftruncate(fd[, len])`\n\nTruncate a file to `len` bytes. `len` defaults to `0`.\n\n#### `fs.ftruncate(fd[, len], callback)`\n\nCallback version of `fs.ftruncate()`.\n\n#### `fs.ftruncateSync(fd[, len])`\n\nSynchronous version of `fs.ftruncate()`.\n\n#### `await fs.chmod(filepath, mode)`\n\nChange the permissions of a file. `mode` may be a numeric mode or a string that will be parsed as octal.\n\n#### `fs.chmod(filepath, mode, callback)`\n\nCallback version of `fs.chmod()`.\n\n#### `fs.chmodSync(filepath, mode)`\n\nSynchronous version of `fs.chmod()`.\n\n#### `await fs.fchmod(fd, mode)`\n\nChange the permissions of a file by its file descriptor.\n\n#### `fs.fchmod(fd, mode, callback)`\n\nCallback version of `fs.fchmod()`.\n\n#### `fs.fchmodSync(fd, mode)`\n\nSynchronous version of `fs.fchmod()`.\n\n#### `await fs.chown(filepath, uid, gid)`\n\nChange the owner and group of a file.\n\n**NOTE**: The `chown` functions are not implemented on Windows.\n\n#### `fs.chown(filepath,  uid, gid, callback)`\n\nCallback version of `fs.chown()`.\n\n#### `await fs.chownSync(filepath, uid, gid)`\n\nSynchronous version of `fs.chown()`.\n\n#### `await fs.lchown(filepath, uid, gid)`\n\nChange the owner and group of a file, but if `filepath` is a symbolic link, the changes are applied only to the link, not the file it refers to.\n\n#### `fs.lchown(filepath,  uid, gid, callback)`\n\nCallback version of `fs.lchown()`.\n\n#### `fs.lchownSync(filepath, uid, gid)`\n\nSynchronous version of `fs.lchown()`.\n\n#### `await fs.fchown(filepath, uid, gid)`\n\nChange the owner and group of a file by its file descriptor.\n\n#### `fs.fchown(filepath,  uid, gid, callback)`\n\nCallback version of `fs.fchown()`.\n\n#### `fs.fchownSync(filepath, uid, gid)`\n\nSynchronous version of `fs.fchown()`.\n\n#### `await fs.utimes(filepath, atime, mtime)`\n\nChange the access and modification times of a file. Times may be numbers (seconds since epoch) or `Date` objects.\n\n#### `fs.utimes(filepath, atime, mtime, callback)`\n\nCallback version of `fs.utimes()`.\n\n#### `fs.utimesSync(filepath, atime, mtime)`\n\nSynchronous version of `fs.utimes()`.\n\n#### `await fs.lutimes(filepath, atime, mtime)`\n\nLike `fs.utimes()`, but if `filepath` is a symbolic link, the timestamps of the link is changed, not the file it refers to.\n\n#### `fs.lutimes(filepath, atime, mtime, callback)`\n\nCallback version of `fs.lutimes()`.\n\n#### `fs.lutimesSync(filepath, atime, mtime)`\n\nSynchronous version of `fs.lutimes()`.\n\n#### `await fs.futimes(fd, atime, mtime)`\n\nChange the access and modification times of a file by its file descriptor. Times may be numbers (seconds since epoch) or `Date` objects.\n\n#### `fs.futimes(fd, atime, mtime, callback)`\n\nCallback version of `fs.futimes()`.\n\n#### `fs.futimesSync(fd, atime, mtime)`\n\nSynchronous version of `fs.futimes()`.\n\n#### `await fs.link(src, dst)`\n\nCreates a new link (also known as a hard link) to an existing file.\n\n#### `fs.link(src, dst, callback)`\n\nCallback version of `fs.link()`.\n\n#### `fs.linkSync(src, dst)`\n\nSynchronous version of `fs.link()`.\n\n#### `await fs.mkdir(filepath[, opts])`\n\nCreate a directory at `filepath`.\n\nOptions include:\n\n```js\noptions = {\n  mode: 0o777,\n  recursive: false\n}\n```\n\nIf `opts` is a number, it is treated as the `mode`. When `recursive` is `true`, parent directories are created as needed.\n\n#### `fs.mkdir(filepath[, opts], callback)`\n\nCallback version of `fs.mkdir()`.\n\n#### `fs.mkdirSync(filepath[, opts])`\n\nSynchronous version of `fs.mkdir()`.\n\n#### `const path = await fs.mkdtemp(prefix)`\n\nCreate a unique temporary directory.\n\n#### `fs.mkdtemp(prefix, callback)`\n\nCallback version of `fs.mkdtemp()`.\n\n#### `const path = fs.mkdtempSync(prefix)`\n\nSynchronous version of `fs.mkdtemp()`.\n\n#### `await fs.rmdir(filepath)`\n\nRemove an empty directory.\n\n#### `fs.rmdir(filepath, callback)`\n\nCallback version of `fs.rmdir()`.\n\n#### `fs.rmdirSync(filepath)`\n\nSynchronous version of `fs.rmdir()`.\n\n#### `await fs.rm(filepath[, opts])`\n\nRemove a file or directory at `filepath`.\n\nOptions include:\n\n```js\noptions = {\n  force: false,\n  recursive: false\n}\n```\n\nWhen `recursive` is `true`, directories are removed along with their contents. When `force` is `true`, no error is thrown if `filepath` does not exist.\n\n#### `fs.rm(filepath[, opts], callback)`\n\nCallback version of `fs.rm()`.\n\n#### `fs.rmSync(filepath[, opts])`\n\nSynchronous version of `fs.rm()`.\n\n#### `await fs.unlink(filepath)`\n\nRemove a file.\n\n#### `fs.unlink(filepath, callback)`\n\nCallback version of `fs.unlink()`.\n\n#### `fs.unlinkSync(filepath)`\n\nSynchronous version of `fs.unlink()`.\n\n#### `await fs.rename(src, dst)`\n\nRename a file from `src` to `dst`.\n\n#### `fs.rename(src, dst, callback)`\n\nCallback version of `fs.rename()`.\n\n#### `fs.renameSync(src, dst)`\n\nSynchronous version of `fs.rename()`.\n\n#### `await fs.copyFile(src, dst[, mode])`\n\nCopy a file from `src` to `dst`. `mode` is an optional bitmask created from `fs.constants.COPYFILE_EXCL`, `fs.constants.COPYFILE_FICLONE`, or `fs.constants.COPYFILE_FICLONE_FORCE`.\n\n#### `fs.copyFile(src, dst[, mode], callback)`\n\nCallback version of `fs.copyFile()`.\n\n#### `fs.copyFileSync(src, dst[, mode])`\n\nSynchronous version of `fs.copyFile()`.\n\n#### `await fs.cp(src, dst[, opts])`\n\nCopy a file or directory from `src` to `dst`.\n\nOptions include:\n\n```js\noptions = {\n  recursive: false\n}\n```\n\nSet `recursive` to `true` to copy directories and their contents. Files are copied preserving their permissions.\n\n#### `fs.cp(src, dst[, opts], callback)`\n\nCallback version of `fs.cp()`.\n\n#### `fs.cpSync(src, dst[, opts])`\n\nSynchronous version of `fs.cp()`.\n\n#### `const resolved = await fs.realpath(filepath[, opts])`\n\nResolve the real path of `filepath`, expanding all symbolic links.\n\nOptions include:\n\n```js\noptions = {\n  encoding: 'utf8'\n}\n```\n\nSet `encoding` to `'buffer'` to receive the result as a `Buffer`.\n\n#### `fs.realpath(filepath[, opts], callback)`\n\nCallback version of `fs.realpath()`.\n\n#### `const resolved = fs.realpathSync(filepath[, opts])`\n\nSynchronous version of `fs.realpath()`.\n\n#### `const target = await fs.readlink(filepath[, opts])`\n\nRead the target of a symbolic link.\n\nOptions include:\n\n```js\noptions = {\n  encoding: 'utf8'\n}\n```\n\n#### `fs.readlink(filepath[, opts], callback)`\n\nCallback version of `fs.readlink()`.\n\n#### `const target = fs.readlinkSync(filepath[, opts])`\n\nSynchronous version of `fs.readlink()`.\n\n#### `await fs.truncate(filename[, len])`\n\nTruncate the file at `filename` to `len` bytes. `len` defaults to `0`.\n\n#### `fs.truncate(filename[, len], callback)`\n\nCallback version of `fs.truncate()`.\n\n#### `fs.truncateSync(filename[, len])`\n\nSynchronous version of `fs.truncate()`.\n\n#### `await fs.symlink(target, filepath[, type])`\n\nCreate a symbolic link at `filepath` pointing to `target`. `type` may be `'file'`, `'dir'`, or `'junction'` (Windows only) or a numeric flag. On Windows, if `type` is not provided, it is inferred from the target.\n\n#### `fs.symlink(target, filepath[, type], callback)`\n\nCallback version of `fs.symlink()`.\n\n#### `fs.symlinkSync(target, filepath[, type])`\n\nSynchronous version of `fs.symlink()`.\n\n#### `await fs.fsync(fd)`\n\nFlush all modified in-core data of the file referred by its file descriptor to the disk device.\n\n#### `fs.fsync(fs, callback)`\n\nCallback version of `fs.fsync()`.\n\n#### `fs.fsyncSync(fd)`\n\nSynchronous version of `fs.fsync()`.\n\n#### `await fs.fdatasync(fd)`\n\nSimilar to `fsync`, but does not flush modified metadata unless necessary.\n\n#### `fs.fdatasync(fs, callback)`\n\nCallback version of `fs.fdatasync()`.\n\n#### `fs.fdatasyncSync(fd)`\n\nSynchronous version of `fs.fdatasync()`.\n\n#### `const dir = await fs.opendir(filepath[, opts])`\n\nOpen a directory for iteration. Returns a `Dir` object.\n\nOptions include:\n\n```js\noptions = {\n  encoding: 'utf8',\n  bufferSize: 32\n}\n```\n\n#### `fs.opendir(filepath[, opts], callback)`\n\nCallback version of `fs.opendir()`.\n\n#### `const dir = fs.opendirSync(filepath[, opts])`\n\nSynchronous version of `fs.opendir()`.\n\n#### `const entries = await fs.readdir(filepath[, opts])`\n\nRead the contents of a directory. Returns an array of filenames or, if `withFileTypes` is `true`, an array of `Dirent` objects.\n\nOptions include:\n\n```js\noptions = {\n  encoding: 'utf8',\n  withFileTypes: false,\n  recursive: false\n}\n```\n\n#### `fs.readdir(filepath[, opts], callback)`\n\nCallback version of `fs.readdir()`.\n\n#### `const entries = fs.readdirSync(filepath[, opts])`\n\nSynchronous version of `fs.readdir()`.\n\n#### `const data = await fs.readFile(filepath[, opts])`\n\nRead the entire contents of a file. Returns a `Buffer` by default, or a string if an `encoding` is specified.\n\nOptions include:\n\n```js\noptions = {\n  encoding: 'buffer',\n  flag: 'r'\n}\n```\n\n#### `fs.readFile(filepath[, opts], callback)`\n\nCallback version of `fs.readFile()`.\n\n#### `const data = fs.readFileSync(filepath[, opts])`\n\nSynchronous version of `fs.readFile()`.\n\n#### `await fs.writeFile(filepath, data[, opts])`\n\nWrite `data` to a file, replacing it if it already exists.\n\nOptions include:\n\n```js\noptions = {\n  encoding: 'utf8',\n  flag: 'w',\n  mode: 0o666\n}\n```\n\n#### `fs.writeFile(filepath, data[, opts], callback)`\n\nCallback version of `fs.writeFile()`.\n\n#### `fs.writeFileSync(filepath, data[, opts])`\n\nSynchronous version of `fs.writeFile()`.\n\n#### `await fs.appendFile(filepath, data[, opts])`\n\nAppend `data` to a file, creating it if it does not exist. Accepts the same options as `fs.writeFile()` but defaults to the `'a'` flag.\n\n#### `fs.appendFile(filepath, data[, opts], callback)`\n\nCallback version of `fs.appendFile()`.\n\n#### `fs.appendFileSync(filepath, data[, opts])`\n\nSynchronous version of `fs.appendFile()`.\n\n#### `const watcher = fs.watch(filepath[, opts], callback)`\n\nWatch a file or directory for changes. Returns a `Watcher` object. The `callback`, if provided, is called with `(eventType, filename)` on each change.\n\nOptions include:\n\n```js\noptions = {\n  persistent: true,\n  recursive: false,\n  encoding: 'utf8'\n}\n```\n\n#### `const stream = fs.createReadStream(path[, opts])`\n\nCreate a readable stream for a file. Returns a `ReadStream`.\n\nOptions include:\n\n```js\noptions = {\n  fd: -1,\n  flags: 'r',\n  mode: 0o666,\n  start: 0,\n  end: Infinity\n}\n```\n\nIf `fd` is provided, `path` may be `null` and the stream reads from the given file descriptor.\n\n#### `const stream = fs.createWriteStream(path[, opts])`\n\nCreate a writable stream for a file. Returns a `WriteStream`.\n\nOptions include:\n\n```js\noptions = {\n  fd: -1,\n  flags: 'w',\n  mode: 0o666\n}\n```\n\nIf `fd` is provided, `path` may be `null` and the stream writes to the given file descriptor.\n\n#### `fs.constants`\n\nAn object containing file system constants. See `fs/constants` for the full list. Commonly used constants include:\n\n- `fs.constants.O_RDONLY`, `fs.constants.O_WRONLY`, `fs.constants.O_RDWR` — file access flags\n- `fs.constants.O_CREAT`, `fs.constants.O_TRUNC`, `fs.constants.O_APPEND` — file creation flags\n- `fs.constants.F_OK`, `fs.constants.R_OK`, `fs.constants.W_OK`, `fs.constants.X_OK` — file accessibility flags\n- `fs.constants.S_IFMT`, `fs.constants.S_IFREG`, `fs.constants.S_IFDIR`, `fs.constants.S_IFLNK` — file type flags\n- `fs.constants.COPYFILE_EXCL`, `fs.constants.COPYFILE_FICLONE`, `fs.constants.COPYFILE_FICLONE_FORCE` — copy flags\n\n### `Stats`\n\nReturned by `fs.stat()`, `fs.lstat()`, and `fs.fstat()`.\n\n#### `stats.dev`\n\nThe device identifier.\n\n#### `stats.mode`\n\nThe file mode (type and permissions).\n\n#### `stats.nlink`\n\nThe number of hard links.\n\n#### `stats.uid`\n\nThe user identifier of the file owner.\n\n#### `stats.gid`\n\nThe group identifier of the file owner.\n\n#### `stats.rdev`\n\nThe device identifier for special files.\n\n#### `stats.blksize`\n\nThe file system block size for I/O operations.\n\n#### `stats.ino`\n\nThe inode number.\n\n#### `stats.size`\n\nThe size of the file in bytes.\n\n#### `stats.blocks`\n\nThe number of 512-byte blocks allocated.\n\n#### `stats.atimeMs`\n\nThe access time in milliseconds since the epoch.\n\n#### `stats.mtimeMs`\n\nThe modification time in milliseconds since the epoch.\n\n#### `stats.ctimeMs`\n\nThe change time in milliseconds since the epoch.\n\n#### `stats.birthtimeMs`\n\nThe creation time in milliseconds since the epoch.\n\n#### `stats.atime`\n\nThe access time as a `Date` object.\n\n#### `stats.mtime`\n\nThe modification time as a `Date` object.\n\n#### `stats.ctime`\n\nThe change time as a `Date` object.\n\n#### `stats.birthtime`\n\nThe creation time as a `Date` object.\n\n#### `stats.isDirectory()`\n\nReturns `true` if the file is a directory.\n\n#### `stats.isFile()`\n\nReturns `true` if the file is a regular file.\n\n#### `stats.isBlockDevice()`\n\nReturns `true` if the file is a block device.\n\n#### `stats.isCharacterDevice()`\n\nReturns `true` if the file is a character device.\n\n#### `stats.isFIFO()`\n\nReturns `true` if the file is a FIFO (named pipe).\n\n#### `stats.isSymbolicLink()`\n\nReturns `true` if the file is a symbolic link. Only meaningful when using `fs.lstat()`.\n\n#### `stats.isSocket()`\n\nReturns `true` if the file is a socket.\n\n### `Dir`\n\nReturned by `fs.opendir()`. Supports both synchronous and asynchronous iteration.\n\n#### `dir.path`\n\nThe path of the directory.\n\n#### `const dirent = await dir.read()`\n\nRead the next directory entry. Returns a `Dirent` or `null` when all entries have been read.\n\n#### `dir.read(callback)`\n\nCallback version of `dir.read()`.\n\n#### `const dirent = dir.readSync()`\n\nSynchronous version of `dir.read()`.\n\n#### `await dir.close()`\n\nClose the directory handle.\n\n#### `dir.close(callback)`\n\nCallback version of `dir.close()`.\n\n#### `dir.closeSync()`\n\nSynchronous version of `dir.close()`.\n\n### `Dirent`\n\nRepresents a directory entry, returned when iterating a `Dir` or using `fs.readdir()` with `withFileTypes: true`.\n\n#### `dirent.parentPath`\n\nThe path of the parent directory.\n\n#### `dirent.name`\n\nThe name of the directory entry, as a string or `Buffer` depending on the encoding.\n\n#### `dirent.type`\n\nThe numeric type of the directory entry.\n\n#### `dirent.isFile()`\n\nReturns `true` if the entry is a regular file.\n\n#### `dirent.isDirectory()`\n\nReturns `true` if the entry is a directory.\n\n#### `dirent.isSymbolicLink()`\n\nReturns `true` if the entry is a symbolic link.\n\n#### `dirent.isFIFO()`\n\nReturns `true` if the entry is a FIFO.\n\n#### `dirent.isSocket()`\n\nReturns `true` if the entry is a socket.\n\n#### `dirent.isCharacterDevice()`\n\nReturns `true` if the entry is a character device.\n\n#### `dirent.isBlockDevice()`\n\nReturns `true` if the entry is a block device.\n\n### `ReadStream`\n\nA readable stream for file data, created by `fs.createReadStream()`. Extends `Readable` from <https://github.com/holepunchto/bare-stream>.\n\n#### `stream.path`\n\nThe file path, or `null` if opened by file descriptor.\n\n#### `stream.fd`\n\nThe underlying file descriptor.\n\n#### `stream.flags`\n\nThe flags the file was opened with.\n\n#### `stream.mode`\n\nThe mode the file was opened with.\n\n### `WriteStream`\n\nA writable stream for file data, created by `fs.createWriteStream()`. Extends `Writable` from <https://github.com/holepunchto/bare-stream>.\n\n#### `stream.path`\n\nThe file path, or `null` if opened by file descriptor.\n\n#### `stream.fd`\n\nThe underlying file descriptor.\n\n#### `stream.flags`\n\nThe flags the file was opened with.\n\n#### `stream.mode`\n\nThe mode the file was opened with.\n\n### `Watcher`\n\nWatches for file system changes, created by `fs.watch()`. Extends `EventEmitter` from <https://github.com/holepunchto/bare-events>.\n\n#### `watcher.close()`\n\nStop watching for changes.\n\n#### `watcher.ref()`\n\nPrevent the event loop from exiting while the watcher is active.\n\n#### `watcher.unref()`\n\nAllow the event loop to exit even if the watcher is still active.\n\n#### `event: 'change'`\n\nEmitted with `(eventType, filename)` when a change is detected. `eventType` is either `'rename'` or `'change'`.\n\n#### `event: 'error'`\n\nEmitted with `(err)` when an error occurs.\n\n#### `event: 'close'`\n\nEmitted when the watcher is closed.\n\n### `FileHandle`\n\nReturned by `require('bare-fs/promises').open()`. Provides an object-oriented API for working with file descriptors.\n\n#### `await handle.close()`\n\nClose the file handle.\n\n#### `const { bytesRead, buffer } = await handle.read(buffer[, offset[, len[, pos]]])`\n\nRead from the file into `buffer`.\n\n#### `const { bytesRead, buffers } = await handle.readv(buffers[, pos])`\n\nRead from the file into an array of `buffers`.\n\n#### `const { bytesWritten, buffer } = await handle.write(data[, offset[, len[, pos]]])`\n\nWrite `data` to the file.\n\n#### `const { bytesWritten, buffers } = await handle.writev(buffers[, pos])`\n\nWrite an array of `buffers` to the file.\n\n#### `const stats = await handle.stat()`\n\nGet the status of the file.\n\n#### `await handle.chmod(mode)`\n\nChange the permissions of the file.\n\n#### `await handle.chown(uid, gid)`\n\nChange the owner and group of the file.\n\n**NOTE**: This function is not implemented on Windows.\n\n#### `await handle.datasync()`\n\nSimilar to `fsync`, but does not flush modified metadata unless necessary.\n\n#### `await handle.sync()`\n\nFlush all modified in-core data of the file.\n\n#### `await handle.truncate(len)`\n\nTruncate the file.\n\n#### `await handle.utimes(mode)`\n\nChange the access and modification times of the file.\n\n#### `const stream = handle.createReadStream([opts])`\n\nCreate a readable stream for the file.\n\n#### `const stream = handle.createWriteStream([opts])`\n\nCreate a writable stream for the file.\n\n#### `handle.fd`\n\nThe file descriptor number.\n\n#### `event: 'close'`\n\nEmitted when the file handle is closed.\n\n## License\n\nApache-2.0",
   "_attachments": {}
 }

package/npm-cache/_cacache/content-v2/sha512/{22/52/6ad80b07324ab432121e45d53195a2f8ff1a7a6f5d58d7e3e34d0692228dc96e827a7ea5c1d8fa204462d95d337b37bec636bc573d92444093af23fea35b → 2c/18/d01469d3901a33c45e77b817aa4cd37a81c4619c8bc7e1ebce16cb0fcab9152e4cc1638304b075389435709484bec4258c75fe3af8ed39af7e5b07d536ee}

@@ -3141,7 +3141,7 @@
   "dist-tags": {
     "latest": "6.0.1"
   },
-  "_rev": "326-7b0f763c68eee7ed",
+  "_rev": "347-82709d77c6b8d65d",
   "_id": "@js-joda/core",
   "readme": "# Immutable date and time library for JavaScript\n\n[![npm version](https://badge.fury.io/js/%40js-joda%2Fcore.svg)](https://badge.fury.io/js/%40js-joda%2Fcore)\n[![GH Actions Build Status](https://github.com/js-joda/js-joda/actions/workflows/tests.yaml/badge.svg?branch=main)](https://github.com/js-joda/js-joda/actions)\n[![Coverage Status](https://coveralls.io/repos/js-joda/js-joda/badge.svg?branch=main&service=github)](https://coveralls.io/github/js-joda/js-joda?branch=main)\n[![Downloads/Month](https://img.shields.io/npm/dm/%40js-joda%2Fcore.svg)](https://img.shields.io/npm/dm/%40js-joda%2Fcore.svg)\n\n\n## Introduction\n\n**js-joda** is an **immutable date and time library** for JavaScript. It provides a **simple, domain-driven and clean API** based on the ISO calendar system, which is the de facto world calendar following the proleptic Gregorian rules.\n\n- js-joda has a lightweight footprint, only **43 kB minified and compressed**, no third party dependencies.\n\n- js-joda is **fast**. It is about 2 to 10 times faster than other JavaScript date libraries.\n\n- js-joda comes with built-in parsers/ formatters for ISO 8601 as specified in RFC 3339, that can be easily customized.\n\n- js-joda supports **ECMAScript 5** browsers down to IE11.\n\n- js-joda is a **port of the threeten** backport, which is the base for JSR-310 implementation of the Java SE 8 java.time package. Threeten is inspired by **Joda-Time**, having similar concepts and the same author.\n\n- js-joda is **robust and stable**. We ported more then 1700 test-cases with a lots of test-permutations from the threetenbp project. We run the automated karma test-suite against Firefox, Chrome, Node and phantomjs.\n\n## Why yet another JavaScript date and time library?\n\n- Popular JavaScript date libraries like [moment](https://momentjs.com/) or [date-utils](https://github.com/continuouscalendar/dateutils) are **wrappers** around the native JavaScript `Date` object, providing syntactic sugar. The native `Date` object always consist of a date, time and a timezone part. In contrast, js-joda is a **standalone** date and time implementation.\n\n- The API has a **domain-driven design** with classes for each of the different use cases, like `LocalDate`, `ZonedDateTime` or `Period`. For example, `LocalDate` allows you to handle dates without times (like birthdays or holidays) in a clean and error-safe way, especially if these dates are persisted to an external server.\n\n- js-joda is **immutable**. Immutability aligns well with pure functions and with the architecture of frameworks like React and Flux.\n\n## The ThreeTen domain models\n\n### Dates and Times\n\n- **LocalDate** represents a date without a time and timezone in the ISO-8601 calendar system, such as 2007-12-24.\n\n- **LocalTime** represents a time without timezone in the ISO-8601 calendar system such as '11:55:00'.\n\n- **LocalDateTime** is a description of the date (LocalDate), as used for birthdays, combined with the local time (LocalTime) as seen on a wall clock.\n\n- **ZonedDateTime** is a date-time with a timezone in the ISO-8601 calendar system, such as 2007-12-24T16:15:30+01:00 UTC+01:00.\n\n- **Instant** is an instantaneous point on the time-line measured from the epoch of _1970-01-01T00:00:00Z_ in epoch-seconds and nanosecond-of-second.\n\n### Duration and Period\n\n- **Duration** is a time-based amount of time, such as '34.5 seconds'.\n\n- **Period** is a date-based amount of time in the ISO-8601 calendar system, such as '2 years, 3 months and 4 days'.\n\n### Additional value types\n\n- **Year** represents a year in the ISO-8601 calendar system, such as '2016'.\n\n- **YearMonth** represents a year and a month in the ISO-8601 calendar system, such as '2016-01'.\n\n- **Month** represents a month-of-year in the ISO-8601 calendar system, such as 'July'.\n\n- **MonthDay** represents a month-day in the ISO-8601 calendar system, such as '--12-03'. Could be used to represent e.g. Birthdays.\n\n- **DayOfWeek** represents a day-of-week in the ISO-8601 calendar system, such as 'Tuesday'.\n\n## Getting started\n\n### Node\n\nInstall joda using npm\n\n```\nnpm install @js-joda/core\n```\n\nThen require it to any module\n\n```js\nvar LocalDate = require('@js-joda/core').LocalDate;\n\nvar d = LocalDate.parse('2012-12-24').atStartOfDay().plusMonths(2); // 2013-02-24T00:00:00\n```\n\n### Browser\n\nTo use js-joda from a browser, download either `dist/js-joda.min.js` or `dist/js-joda.js` (with sourcemaps for development). Then add it as a script tag to your page\n\n```html\n<script src=\"js-joda.min.js\"></script>\n<script>\n    var LocalDate = JSJoda.LocalDate;\n    var d = LocalDate.parse('2012-12-24').atStartOfDay().plusMonths(2); // 2013-02-24T00:00:00\n</script>\n```\n\n## js-joda packages\n\njs-joda consist of four packages:\n\n|  package name | description  |  path |\n|---|---|---|\n| `@js-joda/core` | Implementation of the ThreeTen Classes and API | [/packages/core](//github.com/js-joda/js-joda/tree/main/packages/core) |\n| `@js-joda/timezone` | Implementation of timezone calculation based on the iana Time Zone Database | [/packages/timezone](//github.com/js-joda/js-joda/tree/main/packages/timezone) |\n| `@js-joda/locale` | Implementation of locale specific functionality for js-joda, especially for formatting and parsing locale specific dates | [/packages/locale](//github.com/js-joda/js-joda/tree/main/packages/locale) |\n| `@js-joda/extra` | Implementation of the ThreeTen-Extra Classes and API |[/packages/extra](//github.com/js-joda/js-joda/tree/main/packages/extra) |\n\nThe [@js-joda/examples](//github.com/js-joda/js-joda/tree/main/packages/examples) package is for testing the different build artifacts in different context, like webpack, browser node, etc.\n\n## Documentation\n\n- [js-joda Quick start guide](//js-joda.github.io/js-joda/manual/getting-started.html) Quick start guide and examples\n- [API](//js-joda.github.io/js-joda/identifiers.html) ESDoc generated API documentation\n\n## Contributing\n\nContributions are always welcome. Before contributing please read the [code of conduct](http://contributor-covenant.org/version/1/4/) &\nsearch the issue tracker. We use GitHub issues. Your issue may have already been discussed or fixed. To contribute, fork js-joda, commit your changes, & send a pull request.\n\nBy contributing to js-joda, you agree that your contributions will be licensed under its BSD license.\n\nNote that only pull requests and issues that match the threeten backport API will be considered. Additional requested features will be rejected.\n\n## License\n\n- `js-joda` is released under the [BSD 3-clause license](//github.com/js-joda/js-joda/blob/main/LICENSE).\n\n- `js-joda` uses the ThreeTen-Backport implementation (http://www.threeten.org/threetenbp/) as a reference base for implementation. This allows us to release js-joda under the BSD License while the OpenJDK java.time implementation is under GNU GPL+linking exception. The API of the ThreeTen-Backport is mostly identical to the official Java SE 8 API from the view of our JavaScript port.\n\n- Our implementation reference base ThreeTen-Backport (http://www.threeten.org/threetenbp/) is also released under the BSD 3-clause license\n\n- `OpenJDK` is under GNU GPL+linking exception.\n\n- The author of `Joda-Time` and the lead architect of the JSR-310 is Stephen Colebourne.\n\nThe API of this project (as far as possible with JavaScript), a lot of implementation details and documentation\nare just copied but never equalled.\n\n## Roadmap\n\n### Milestone 1: Core domains (reached with version v1.0.0)\n\n- Support for the domain models `LocalDate`, `LocalDateTime`, `ZonedDateTime`, `Instant`, `Duration` and `Period` converting to and from ISO8601.\n- `ZonedDateTime` (without support for loading iana timezone databases) currently supports only fixed offsets like UTC or UTC+02:00 and the system default time zone.\n\n### Milestone 2: IANA timezone support (reached with version v1.2.0)\n\n- Add IANA timezone database support to js-joda. Implement handling of daylight saving transitions, mainly in `ZonedDateTime`.\n- For access to the IANA timezone database, the plugin [@js-joda/timezone](//github.com/js-joda/js-joda/tree/main/packages/timezone) is required. It provides an implementation of the [ZoneRulesProvider](//js-joda.github.io/js-joda/class/packages/core/src/zone/ZoneRulesProvider.js~ZoneRulesProvider.html) and contains the iana timezone database.\n\n### Milestone 3: Locale support (reached with v2.0.0 of @js-joda/locale)\n\n- Add locale support.\n- Extend pattern parser/ formatter for text with locale support.\n\nsee the plugin [@js-joda/locale](//github.com/js-joda/js-joda/tree/main/packages/locale)\n\n### Future Milestones\n\n- Reduce library size by removing redundant code, especially by refactoring code for formatting/ parsing dates.\n- Increase test coverage (ongoing task)\n- Cleanup documentation (ongoing task)",
   "_attachments": {}