mrs-toolbox-cli 10.0.17 → 10.1.17-cfb8fe4

package/npm-cache/_cacache/content-v2/sha512/{ca/0d/6884885d1bcf474759d9074bd4a833cd6b6d83ef2fe967456dcbce51232a8efc47d0fb21547b7791d690c4441afddd0e76964c9c714d0f91535cd7f3c4b1 → e3/5e/87d62729be09a750a069c8be4264a9380fe5da0662105780fa921329a3a190cf17b765cd576ebfdf394d4cc5adcfd9cf01e9f19d53ee91a07dea63a356d0}

@@ -6788,11 +6788,231 @@
       },
       "_hasShrinkwrap": false,
       "contributors": []
+    },
+    "4.6.0": {
+      "name": "bare-fs",
+      "version": "4.6.0",
+      "description": "Native file system operations for Javascript",
+      "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": "bdc596c942b5103cae57cdc94897384d4631a9c2",
+      "types": "./index.d.ts",
+      "_id": "bare-fs@4.6.0",
+      "_nodeVersion": "24.14.1",
+      "_npmVersion": "11.11.0",
+      "dist": {
+        "integrity": "sha512-2YkS7NuiJceSEbyEOdSNLE9tsGd+f4+f7C+Nik/MCk27SYdwIMPT/yRKvg++FZhQXgk0KWJKJyXX9RhVV0RGqA==",
+        "shasum": "ff2f10c8238d3ff94f2704f0c581b197b47ef112",
+        "tarball": "https://verdaccio.mrsdev.ru/bare-fs/-/bare-fs-4.6.0.tgz",
+        "fileCount": 27,
+        "unpackedSize": 1061522,
+        "attestations": {
+          "url": "https://registry.npmjs.org/-/npm/v1/attestations/bare-fs@4.6.0",
+          "provenance": {
+            "predicateType": "https://slsa.dev/provenance/v1"
+          }
+        },
+        "signatures": [
+          {
+            "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U",
+            "sig": "MEQCIDIqQQlveTWS0uu1qlUXDs6l2Sf6VuAD+8SrtBCzpSzLAiAggMGyDcL23ApjTIkG99oUgxNIAhlVAWFKsrPNtFivow=="
+          }
+        ]
+      },
+      "_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.6.0_1775141013445_0.11240609762318043"
+      },
+      "_hasShrinkwrap": false,
+      "contributors": []
+    },
+    "4.7.0": {
+      "name": "bare-fs",
+      "version": "4.7.0",
+      "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": "66c6f813385873b9fd89383a6a3046fb9b1e7c4a",
+      "types": "./index.d.ts",
+      "_id": "bare-fs@4.7.0",
+      "_nodeVersion": "24.14.1",
+      "_npmVersion": "11.11.0",
+      "dist": {
+        "integrity": "sha512-xzqKsCFxAek9aezYhjJuJRXBIaYlg/0OGDTZp+T8eYmYMlm66cs6cYko02drIyjN2CBbi+I6L7YfXyqpqtKRXA==",
+        "shasum": "01efd92b14a6c93825e8992ac1e42fdd6237de71",
+        "tarball": "https://verdaccio.mrsdev.ru/bare-fs/-/bare-fs-4.7.0.tgz",
+        "fileCount": 27,
+        "unpackedSize": 1274126,
+        "attestations": {
+          "url": "https://registry.npmjs.org/-/npm/v1/attestations/bare-fs@4.7.0",
+          "provenance": {
+            "predicateType": "https://slsa.dev/provenance/v1"
+          }
+        },
+        "signatures": [
+          {
+            "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U",
+            "sig": "MEUCIQCHHk41yO1mugAYVjUurNZy7Xoi5dBQFLKNkG0/QgtNBwIgGK+nU2kpXwKdOodXv8V8NNjiBo4hCABV+zdx02D3ShQ="
+          }
+        ]
+      },
+      "_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.0_1775743341875_0.887959693792506"
+      },
+      "_hasShrinkwrap": false,
+      "contributors": []
     }
   },
   "time": {
     "created": "2023-05-16T08:24:58.193Z",
-    "modified": "2026-03-19T10:42:27.835Z",
+    "modified": "2026-04-09T14:02:22.419Z",
     "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",
@@ -6875,14 +7095,16 @@
     "4.5.3": "2026-01-26T13:48:40.884Z",
     "4.5.4": "2026-02-12T11:17:30.935Z",
     "4.5.5": "2026-02-25T14:10:41.849Z",
-    "4.5.6": "2026-03-19T10:42:27.735Z"
+    "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"
   },
   "users": {},
   "dist-tags": {
-    "latest": "4.5.6"
+    "latest": "4.7.0"
   },
-  "_rev": "794-eeb74ce0a9c28b14",
+  "_rev": "858-fcc4c3891966467a",
   "_id": "bare-fs",
-  "readme": "# bare-fs\n\nNative file system operations for Javascript.\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## 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}\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/{ef/9a/33ce8e805ff0ead6fcad7fb4e6a1a61c12ee03bd404ff3cab1b29e0a543f9a9d561dd053195c39904372cfac9c8cac691781045cd58ab201c3e32793e74c → e4/55/e18b2bb30c4635f270226f1128f7d35fbdf3c06cb3ba69238e5af7f0117ee5e487b061abd09795742c03cc162f5bedee30c25a099772c62cd4d1826a718a}

@@ -1889,7 +1889,7 @@
   "dist-tags": {
     "latest": "0.6.1"
   },
-  "_rev": "245-470b869ae57d07f1",
+  "_rev": "249-8e348b4ff6623f15",
   "_id": "optimist",
   "readme": "# DEPRECATION NOTICE\n\nI don't want to maintain this module anymore since I just use\n[minimist](https://npmjs.org/package/minimist), the argument parsing engine,\ndirectly instead nowadays.\n\nSee [yargs](https://github.com/chevex/yargs) for the modern, pirate-themed\nsuccessor to optimist.\n\n[![yarrrrrrrgs!](http://i.imgur.com/4WFGVJ9.png)](https://github.com/chevex/yargs)\n\nYou should also consider [nomnom](https://github.com/harthur/nomnom).\n\noptimist\n========\n\nOptimist is a node.js library for option parsing for people who hate option\nparsing. More specifically, this module is for people who like all the --bells\nand -whistlz of program usage but think optstrings are a waste of time.\n\nWith optimist, option parsing doesn't have to suck (as much).\n\n[![build status](https://secure.travis-ci.org/substack/node-optimist.png)](http://travis-ci.org/substack/node-optimist)\n\nexamples\n========\n\nWith Optimist, the options are just a hash! No optstrings attached.\n-------------------------------------------------------------------\n\nxup.js:\n\n````javascript\n#!/usr/bin/env node\nvar argv = require('optimist').argv;\n\nif (argv.rif - 5 * argv.xup > 7.138) {\n    console.log('Buy more riffiwobbles');\n}\nelse {\n    console.log('Sell the xupptumblers');\n}\n````\n\n***\n\n    $ ./xup.js --rif=55 --xup=9.52\n    Buy more riffiwobbles\n    \n    $ ./xup.js --rif 12 --xup 8.1\n    Sell the xupptumblers\n\n![This one's optimistic.](http://substack.net/images/optimistic.png)\n\nBut wait! There's more! You can do short options:\n-------------------------------------------------\n \nshort.js:\n\n````javascript\n#!/usr/bin/env node\nvar argv = require('optimist').argv;\nconsole.log('(%d,%d)', argv.x, argv.y);\n````\n\n***\n\n    $ ./short.js -x 10 -y 21\n    (10,21)\n\nAnd booleans, both long and short (and grouped):\n----------------------------------\n\nbool.js:\n\n````javascript\n#!/usr/bin/env node\nvar util = require('util');\nvar argv = require('optimist').argv;\n\nif (argv.s) {\n    util.print(argv.fr ? 'Le chat dit: ' : 'The cat says: ');\n}\nconsole.log(\n    (argv.fr ? 'miaou' : 'meow') + (argv.p ? '.' : '')\n);\n````\n\n***\n\n    $ ./bool.js -s\n    The cat says: meow\n    \n    $ ./bool.js -sp\n    The cat says: meow.\n\n    $ ./bool.js -sp --fr\n    Le chat dit: miaou.\n\nAnd non-hypenated options too! Just use `argv._`!\n-------------------------------------------------\n \nnonopt.js:\n\n````javascript\n#!/usr/bin/env node\nvar argv = require('optimist').argv;\nconsole.log('(%d,%d)', argv.x, argv.y);\nconsole.log(argv._);\n````\n\n***\n\n    $ ./nonopt.js -x 6.82 -y 3.35 moo\n    (6.82,3.35)\n    [ 'moo' ]\n    \n    $ ./nonopt.js foo -x 0.54 bar -y 1.12 baz\n    (0.54,1.12)\n    [ 'foo', 'bar', 'baz' ]\n\nPlus, Optimist comes with .usage() and .demand()!\n-------------------------------------------------\n\ndivide.js:\n\n````javascript\n#!/usr/bin/env node\nvar argv = require('optimist')\n    .usage('Usage: $0 -x [num] -y [num]')\n    .demand(['x','y'])\n    .argv;\n\nconsole.log(argv.x / argv.y);\n````\n\n***\n \n    $ ./divide.js -x 55 -y 11\n    5\n    \n    $ node ./divide.js -x 4.91 -z 2.51\n    Usage: node ./divide.js -x [num] -y [num]\n\n    Options:\n      -x  [required]\n      -y  [required]\n\n    Missing required arguments: y\n\nEVEN MORE HOLY COW\n------------------\n\ndefault_singles.js:\n\n````javascript\n#!/usr/bin/env node\nvar argv = require('optimist')\n    .default('x', 10)\n    .default('y', 10)\n    .argv\n;\nconsole.log(argv.x + argv.y);\n````\n\n***\n\n    $ ./default_singles.js -x 5\n    15\n\ndefault_hash.js:\n\n````javascript\n#!/usr/bin/env node\nvar argv = require('optimist')\n    .default({ x : 10, y : 10 })\n    .argv\n;\nconsole.log(argv.x + argv.y);\n````\n\n***\n\n    $ ./default_hash.js -y 7\n    17\n\nAnd if you really want to get all descriptive about it...\n---------------------------------------------------------\n\nboolean_single.js\n\n````javascript\n#!/usr/bin/env node\nvar argv = require('optimist')\n    .boolean('v')\n    .argv\n;\nconsole.dir(argv);\n````\n\n***\n\n    $ ./boolean_single.js -v foo bar baz\n    true\n    [ 'bar', 'baz', 'foo' ]\n\nboolean_double.js\n\n````javascript\n#!/usr/bin/env node\nvar argv = require('optimist')\n    .boolean(['x','y','z'])\n    .argv\n;\nconsole.dir([ argv.x, argv.y, argv.z ]);\nconsole.dir(argv._);\n````\n\n***\n\n    $ ./boolean_double.js -x -z one two three\n    [ true, false, true ]\n    [ 'one', 'two', 'three' ]\n\nOptimist is here to help...\n---------------------------\n\nYou can describe parameters for help messages and set aliases. Optimist figures\nout how to format a handy help string automatically.\n\nline_count.js\n\n````javascript\n#!/usr/bin/env node\nvar argv = require('optimist')\n    .usage('Count the lines in a file.\\nUsage: $0')\n    .demand('f')\n    .alias('f', 'file')\n    .describe('f', 'Load a file')\n    .argv\n;\n\nvar fs = require('fs');\nvar s = fs.createReadStream(argv.file);\n\nvar lines = 0;\ns.on('data', function (buf) {\n    lines += buf.toString().match(/\\n/g).length;\n});\n\ns.on('end', function () {\n    console.log(lines);\n});\n````\n\n***\n\n    $ node line_count.js\n    Count the lines in a file.\n    Usage: node ./line_count.js\n\n    Options:\n      -f, --file  Load a file  [required]\n\n    Missing required arguments: f\n\n    $ node line_count.js --file line_count.js \n    20\n    \n    $ node line_count.js -f line_count.js \n    20\n\nmethods\n=======\n\nBy itself,\n\n````javascript\nrequire('optimist').argv\n`````\n\nwill use `process.argv` array to construct the `argv` object.\n\nYou can pass in the `process.argv` yourself:\n\n````javascript\nrequire('optimist')([ '-x', '1', '-y', '2' ]).argv\n````\n\nor use .parse() to do the same thing:\n\n````javascript\nrequire('optimist').parse([ '-x', '1', '-y', '2' ])\n````\n\nThe rest of these methods below come in just before the terminating `.argv`.\n\n.alias(key, alias)\n------------------\n\nSet key names as equivalent such that updates to a key will propagate to aliases\nand vice-versa.\n\nOptionally `.alias()` can take an object that maps keys to aliases.\n\n.default(key, value)\n--------------------\n\nSet `argv[key]` to `value` if no option was specified on `process.argv`.\n\nOptionally `.default()` can take an object that maps keys to default values.\n\n.demand(key)\n------------\n\nIf `key` is a string, show the usage information and exit if `key` wasn't\nspecified in `process.argv`.\n\nIf `key` is a number, demand at least as many non-option arguments, which show\nup in `argv._`.\n\nIf `key` is an Array, demand each element.\n\n.describe(key, desc)\n--------------------\n\nDescribe a `key` for the generated usage information.\n\nOptionally `.describe()` can take an object that maps keys to descriptions.\n\n.options(key, opt)\n------------------\n\nInstead of chaining together `.alias().demand().default()`, you can specify\nkeys in `opt` for each of the chainable methods.\n\nFor example:\n\n````javascript\nvar argv = require('optimist')\n    .options('f', {\n        alias : 'file',\n        default : '/etc/passwd',\n    })\n    .argv\n;\n````\n\nis the same as\n\n````javascript\nvar argv = require('optimist')\n    .alias('f', 'file')\n    .default('f', '/etc/passwd')\n    .argv\n;\n````\n\nOptionally `.options()` can take an object that maps keys to `opt` parameters.\n\n.usage(message)\n---------------\n\nSet a usage message to show which commands to use. Inside `message`, the string\n`$0` will get interpolated to the current script name or node command for the\npresent script similar to how `$0` works in bash or perl.\n\n.check(fn)\n----------\n\nCheck that certain conditions are met in the provided arguments.\n\nIf `fn` throws or returns `false`, show the thrown error, usage information, and\nexit.\n\n.boolean(key)\n-------------\n\nInterpret `key` as a boolean. If a non-flag option follows `key` in\n`process.argv`, that string won't get set as the value of `key`.\n\nIf `key` never shows up as a flag in `process.arguments`, `argv[key]` will be\n`false`.\n\nIf `key` is an Array, interpret all the elements as booleans.\n\n.string(key)\n------------\n\nTell the parser logic not to interpret `key` as a number or boolean.\nThis can be useful if you need to preserve leading zeros in an input.\n\nIf `key` is an Array, interpret all the elements as strings.\n\n.wrap(columns)\n--------------\n\nFormat usage output to wrap at `columns` many columns.\n\n.help()\n-------\n\nReturn the generated usage string.\n\n.showHelp(fn=console.error)\n---------------------------\n\nPrint the usage data using `fn` for printing.\n\n.parse(args)\n------------\n\nParse `args` instead of `process.argv`. Returns the `argv` object.\n\n.argv\n-----\n\nGet the arguments as a plain old object.\n\nArguments without a corresponding flag show up in the `argv._` array.\n\nThe script name or node command is available at `argv.$0` similarly to how `$0`\nworks in bash or perl.\n\nparsing tricks\n==============\n\nstop parsing\n------------\n\nUse `--` to stop parsing flags and stuff the remainder into `argv._`.\n\n    $ node examples/reflect.js -a 1 -b 2 -- -c 3 -d 4\n    { _: [ '-c', '3', '-d', '4' ],\n      '$0': 'node ./examples/reflect.js',\n      a: 1,\n      b: 2 }\n\nnegate fields\n-------------\n\nIf you want to explicity set a field to false instead of just leaving it\nundefined or to override a default you can do `--no-key`.\n\n    $ node examples/reflect.js -a --no-b\n    { _: [],\n      '$0': 'node ./examples/reflect.js',\n      a: true,\n      b: false }\n\nnumbers\n-------\n\nEvery argument that looks like a number (`!isNaN(Number(arg))`) is converted to\none. This way you can just `net.createConnection(argv.port)` and you can add\nnumbers out of `argv` with `+` without having that mean concatenation,\nwhich is super frustrating.\n\nduplicates\n----------\n\nIf you specify a flag multiple times it will get turned into an array containing\nall the values in order.\n\n    $ node examples/reflect.js -x 5 -x 8 -x 0\n    { _: [],\n      '$0': 'node ./examples/reflect.js',\n        x: [ 5, 8, 0 ] }\n\ndot notation\n------------\n\nWhen you use dots (`.`s) in argument names, an implicit object path is assumed.\nThis lets you organize arguments into nested objects.\n\n     $ node examples/reflect.js --foo.bar.baz=33 --foo.quux=5\n     { _: [],\n       '$0': 'node ./examples/reflect.js',\n         foo: { bar: { baz: 33 }, quux: 5 } }\n\nshort numbers\n-------------\n\nShort numeric `head -n5` style argument work too:\n\n    $ node reflect.js -n123 -m456\n    { '3': true,\n      '6': true,\n      _: [],\n      '$0': 'node ./reflect.js',\n      n: 123,\n      m: 456 }\n\ninstallation\n============\n\nWith [npm](http://github.com/isaacs/npm), just do:\n    npm install optimist\n \nor clone this project on github:\n\n    git clone http://github.com/substack/node-optimist.git\n\nTo run the tests with [expresso](http://github.com/visionmedia/expresso),\njust do:\n    \n    expresso\n\ninspired By\n===========\n\nThis module is loosely inspired by Perl's\n[Getopt::Casual](http://search.cpan.org/~photo/Getopt-Casual-0.13.1/Casual.pm).",
   "_attachments": {}

package/npm-cache/_cacache/content-v2/sha512/{32/e8/f2a19b23a1906812652428effc6065eebd98adbc1483cf2e3fd6ebf0753a91fb28bf57ccd9dbae027b2f3a82afd08f49899ded809cd3aefb8362340657c1 → e4/c9/2bb032981972f08d3a300f43ddf3959683ac70a4c6170cdebe6a86572a58915244a41291810ccabc5dd5077e624bd452740c0af45fcffca5275cbdb4ebb8}

@@ -505,7 +505,7 @@
   "dist-tags": {
     "latest": "4.0.0"
   },
-  "_rev": "4116-5ad2e49c6da3054b",
+  "_rev": "4279-4c6f32ed061f0f42",
   "_id": "path-key",
   "readme": "# path-key\n\n> Get the [PATH](https://en.wikipedia.org/wiki/PATH_(variable)) environment variable key cross-platform\n\nIt's usually `PATH` but on Windows it can be any casing like `Path`...\n\n## Install\n\n```\n$ npm install path-key\n```\n\n## Usage\n\n```js\nimport pathKey from 'path-key';\n\nconst key = pathKey();\n//=> 'PATH'\n\nconst PATH = process.env[key];\n//=> '/usr/local/bin:/usr/bin:/bin'\n```\n\n## API\n\n### pathKey(options?)\n\n#### options\n\nType: `object`\n\n##### env\n\nType: `object`\\\nDefault: [`process.env`](https://nodejs.org/api/process.html#process_process_env)\n\nUse a custom environment variables object.\n\n#### platform\n\nType: `string`\\\nDefault: [`process.platform`](https://nodejs.org/api/process.html#process_process_platform)\n\nGet the PATH key for a specific platform.\n\n---\n\n<div align=\"center\">\n\t<b>\n\t\t<a href=\"https://tidelift.com/subscription/pkg/npm-path-key?utm_source=npm-path-key&utm_medium=referral&utm_campaign=readme\">Get professional support for this package with a Tidelift subscription</a>\n\t</b>\n\t<br>\n\t<sub>\n\t\tTidelift helps make open source sustainable for maintainers while giving companies<br>assurances about security, maintenance, and licensing for their dependencies.\n\t</sub>\n</div>",
   "_attachments": {}

package/npm-cache/_cacache/content-v2/sha512/{7b/ca/1e6374b0db2db8a26a9b27ae516846d23070b88b7d0a2c48cce1e835c6a5d0baa342da347c888c80984f69e9487c562117523781ef8ec20266251bf2cd52 → e5/70/5e6795635f80fbabbd67755585bebd2e09b501c81c5e765d626e49c5c914f3b1e55f51a31b7f3022b77f8df729f7c955c42ed68424b3f6f087ca34c282a0}

@@ -1831,7 +1831,7 @@
   "dist-tags": {
     "latest": "7.0.1"
   },
-  "_rev": "391-61a4077eab288917",
+  "_rev": "432-28a9f9c299daf587",
   "_id": "crc32-stream",
   "readme": "# CRC32 Stream\n\ncrc32-stream is a streaming CRC32 checksumer. It uses the [crc](https://www.npmjs.org/package/crc) module behind the scenes to reliably handle binary data and fancy character sets. Data is passed through untouched.\n\n### Install\n\n```bash\nnpm install crc32-stream --save\n```\n\nYou can also use `npm install https://github.com/archiverjs/node-crc32-stream/archive/master.tar.gz` to test upcoming versions.\n\n### Usage\n\n#### CRC32Stream\n\nInherits [Transform Stream](http://nodejs.org/api/stream.html#stream_class_stream_transform) options and methods.\n\n```js\nimport { CRC32Stream } from \"crc32-stream\";\n\nconst source = fs.createReadStream(\"file.txt\");\nconst checksum = new CRC32Stream();\n\nchecksum.on(\"end\", function (err) {\n  // do something with checksum.digest() here\n});\n\n// either pipe it\nsource.pipe(checksum);\n\n// or write it\nchecksum.write(\"string\");\nchecksum.end();\n```\n\n#### DeflateCRC32Stream\n\nInherits [zlib.DeflateRaw](http://nodejs.org/api/zlib.html#zlib_class_zlib_deflateraw) options and methods.\n\n```js\nimport { DeflateCRC32Stream } from \"crc32-stream\";\n\nconst source = fs.createReadStream(\"file.txt\");\nconst checksum = new DeflateCRC32Stream();\n\nchecksum.on(\"end\", function (err) {\n  // do something with checksum.digest() here\n});\n\n// either pipe it\nsource.pipe(checksum);\n\n// or write it\nchecksum.write(\"string\");\nchecksum.end();\n```\n\n### Instance API\n\n#### digest()\n\nReturns the checksum digest in unsigned form.\n\n#### hex()\n\nReturns the hexadecimal representation of the checksum digest. (ie E81722F0)\n\n#### size(compressed)\n\nReturns the raw size/length of passed-through data.\n\nIf `compressed` is `true`, it returns compressed length instead. (DeflateCRC32Stream)\n\n## Things of Interest\n\n- [Changelog](https://github.com/archiverjs/node-crc32-stream/releases)\n- [Contributing](https://github.com/archiverjs/node-crc32-stream/blob/master/CONTRIBUTING.md)\n- [MIT License](https://github.com/archiverjs/node-crc32-stream/blob/master/LICENSE-MIT)",
   "_attachments": {}

package/npm-cache/_cacache/content-v2/sha512/{7c/77/af179d8fec0864a0ce24787f5147225170ed8b0d0343feef6849f24033aea1e9203c5f000e920bf0b850804b0f867de5eebefc30bece616ae0870d671691 → e6/22/f58873708e49bbead1988ce19a2b00b0d1d1f5388737b2ef61ebf33ff15121eb73b7cb5aabaf3862089371f3d5d4e1f36485459809e3c17161c672e13eed}

@@ -15152,7 +15152,7 @@
   "dist-tags": {
     "latest": "8.20.0"
   },
-  "_rev": "2594-54fb385d63cfc519",
+  "_rev": "2626-6c51888aadb6d7c2",
   "_id": "ws",
   "readme": "# ws: a Node.js WebSocket library\n\n[![Version npm](https://img.shields.io/npm/v/ws.svg?logo=npm)](https://www.npmjs.com/package/ws)\n[![CI](https://img.shields.io/github/actions/workflow/status/websockets/ws/ci.yml?branch=master&label=CI&logo=github)](https://github.com/websockets/ws/actions?query=workflow%3ACI+branch%3Amaster)\n[![Coverage Status](https://img.shields.io/coveralls/websockets/ws/master.svg?logo=coveralls)](https://coveralls.io/github/websockets/ws)\n\nws is a simple to use, blazing fast, and thoroughly tested WebSocket client and\nserver implementation.\n\nPasses the quite extensive Autobahn test suite: [server][server-report],\n[client][client-report].\n\n**Note**: This module does not work in the browser. The client in the docs is a\nreference to a backend with the role of a client in the WebSocket communication.\nBrowser clients must use the native\n[`WebSocket`](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket)\nobject. To make the same code work seamlessly on Node.js and the browser, you\ncan use one of the many wrappers available on npm, like\n[isomorphic-ws](https://github.com/heineiuo/isomorphic-ws).\n\n## Table of Contents\n\n- [Protocol support](#protocol-support)\n- [Installing](#installing)\n  - [Opt-in for performance](#opt-in-for-performance)\n    - [Legacy opt-in for performance](#legacy-opt-in-for-performance)\n- [API docs](#api-docs)\n- [WebSocket compression](#websocket-compression)\n- [Usage examples](#usage-examples)\n  - [Sending and receiving text data](#sending-and-receiving-text-data)\n  - [Sending binary data](#sending-binary-data)\n  - [Simple server](#simple-server)\n  - [External HTTP/S server](#external-https-server)\n  - [Multiple servers sharing a single HTTP/S server](#multiple-servers-sharing-a-single-https-server)\n  - [Client authentication](#client-authentication)\n  - [Server broadcast](#server-broadcast)\n  - [Round-trip time](#round-trip-time)\n  - [Use the Node.js streams API](#use-the-nodejs-streams-api)\n  - [Other examples](#other-examples)\n- [FAQ](#faq)\n  - [How to get the IP address of the client?](#how-to-get-the-ip-address-of-the-client)\n  - [How to detect and close broken connections?](#how-to-detect-and-close-broken-connections)\n  - [How to connect via a proxy?](#how-to-connect-via-a-proxy)\n- [Changelog](#changelog)\n- [License](#license)\n\n## Protocol support\n\n- **HyBi drafts 07-12** (Use the option `protocolVersion: 8`)\n- **HyBi drafts 13-17** (Current default, alternatively option\n  `protocolVersion: 13`)\n\n## Installing\n\n```\nnpm install ws\n```\n\n### Opt-in for performance\n\n[bufferutil][] is an optional module that can be installed alongside the ws\nmodule:\n\n```\nnpm install --save-optional bufferutil\n```\n\nThis is a binary addon that improves the performance of certain operations such\nas masking and unmasking the data payload of the WebSocket frames. Prebuilt\nbinaries are available for the most popular platforms, so you don't necessarily\nneed to have a C++ compiler installed on your machine.\n\nTo force ws to not use bufferutil, use the\n[`WS_NO_BUFFER_UTIL`](./doc/ws.md#ws_no_buffer_util) environment variable. This\ncan be useful to enhance security in systems where a user can put a package in\nthe package search path of an application of another user, due to how the\nNode.js resolver algorithm works.\n\n#### Legacy opt-in for performance\n\nIf you are running on an old version of Node.js (prior to v18.14.0), ws also\nsupports the [utf-8-validate][] module:\n\n```\nnpm install --save-optional utf-8-validate\n```\n\nThis contains a binary polyfill for [`buffer.isUtf8()`][].\n\nTo force ws not to use utf-8-validate, use the\n[`WS_NO_UTF_8_VALIDATE`](./doc/ws.md#ws_no_utf_8_validate) environment variable.\n\n## API docs\n\nSee [`/doc/ws.md`](./doc/ws.md) for Node.js-like documentation of ws classes and\nutility functions.\n\n## WebSocket compression\n\nws supports the [permessage-deflate extension][permessage-deflate] which enables\nthe client and server to negotiate a compression algorithm and its parameters,\nand then selectively apply it to the data payloads of each WebSocket message.\n\nThe extension is disabled by default on the server and enabled by default on the\nclient. It adds a significant overhead in terms of performance and memory\nconsumption so we suggest to enable it only if it is really needed.\n\nNote that Node.js has a variety of issues with high-performance compression,\nwhere increased concurrency, especially on Linux, can lead to [catastrophic\nmemory fragmentation][node-zlib-bug] and slow performance. If you intend to use\npermessage-deflate in production, it is worthwhile to set up a test\nrepresentative of your workload and ensure Node.js/zlib will handle it with\nacceptable performance and memory usage.\n\nTuning of permessage-deflate can be done via the options defined below. You can\nalso use `zlibDeflateOptions` and `zlibInflateOptions`, which is passed directly\ninto the creation of [raw deflate/inflate streams][node-zlib-deflaterawdocs].\n\nSee [the docs][ws-server-options] for more options.\n\n```js\nimport WebSocket, { WebSocketServer } from 'ws';\n\nconst wss = new WebSocketServer({\n  port: 8080,\n  perMessageDeflate: {\n    zlibDeflateOptions: {\n      // See zlib defaults.\n      chunkSize: 1024,\n      memLevel: 7,\n      level: 3\n    },\n    zlibInflateOptions: {\n      chunkSize: 10 * 1024\n    },\n    // Other options settable:\n    clientNoContextTakeover: true, // Defaults to negotiated value.\n    serverNoContextTakeover: true, // Defaults to negotiated value.\n    serverMaxWindowBits: 10, // Defaults to negotiated value.\n    // Below options specified as default values.\n    concurrencyLimit: 10, // Limits zlib concurrency for perf.\n    threshold: 1024 // Size (in bytes) below which messages\n    // should not be compressed if context takeover is disabled.\n  }\n});\n```\n\nThe client will only use the extension if it is supported and enabled on the\nserver. To always disable the extension on the client, set the\n`perMessageDeflate` option to `false`.\n\n```js\nimport WebSocket from 'ws';\n\nconst ws = new WebSocket('ws://www.host.com/path', {\n  perMessageDeflate: false\n});\n```\n\n## Usage examples\n\n### Sending and receiving text data\n\n```js\nimport WebSocket from 'ws';\n\nconst ws = new WebSocket('ws://www.host.com/path');\n\nws.on('error', console.error);\n\nws.on('open', function open() {\n  ws.send('something');\n});\n\nws.on('message', function message(data) {\n  console.log('received: %s', data);\n});\n```\n\n### Sending binary data\n\n```js\nimport WebSocket from 'ws';\n\nconst ws = new WebSocket('ws://www.host.com/path');\n\nws.on('error', console.error);\n\nws.on('open', function open() {\n  const array = new Float32Array(5);\n\n  for (var i = 0; i < array.length; ++i) {\n    array[i] = i / 2;\n  }\n\n  ws.send(array);\n});\n```\n\n### Simple server\n\n```js\nimport { WebSocketServer } from 'ws';\n\nconst wss = new WebSocketServer({ port: 8080 });\n\nwss.on('connection', function connection(ws) {\n  ws.on('error', console.error);\n\n  ws.on('message', function message(data) {\n    console.log('received: %s', data);\n  });\n\n  ws.send('something');\n});\n```\n\n### External HTTP/S server\n\n```js\nimport { createServer } from 'https';\nimport { readFileSync } from 'fs';\nimport { WebSocketServer } from 'ws';\n\nconst server = createServer({\n  cert: readFileSync('/path/to/cert.pem'),\n  key: readFileSync('/path/to/key.pem')\n});\nconst wss = new WebSocketServer({ server });\n\nwss.on('connection', function connection(ws) {\n  ws.on('error', console.error);\n\n  ws.on('message', function message(data) {\n    console.log('received: %s', data);\n  });\n\n  ws.send('something');\n});\n\nserver.listen(8080);\n```\n\n### Multiple servers sharing a single HTTP/S server\n\n```js\nimport { createServer } from 'http';\nimport { WebSocketServer } from 'ws';\n\nconst server = createServer();\nconst wss1 = new WebSocketServer({ noServer: true });\nconst wss2 = new WebSocketServer({ noServer: true });\n\nwss1.on('connection', function connection(ws) {\n  ws.on('error', console.error);\n\n  // ...\n});\n\nwss2.on('connection', function connection(ws) {\n  ws.on('error', console.error);\n\n  // ...\n});\n\nserver.on('upgrade', function upgrade(request, socket, head) {\n  const { pathname } = new URL(request.url, 'wss://base.url');\n\n  if (pathname === '/foo') {\n    wss1.handleUpgrade(request, socket, head, function done(ws) {\n      wss1.emit('connection', ws, request);\n    });\n  } else if (pathname === '/bar') {\n    wss2.handleUpgrade(request, socket, head, function done(ws) {\n      wss2.emit('connection', ws, request);\n    });\n  } else {\n    socket.destroy();\n  }\n});\n\nserver.listen(8080);\n```\n\n### Client authentication\n\n```js\nimport { createServer } from 'http';\nimport { WebSocketServer } from 'ws';\n\nfunction onSocketError(err) {\n  console.error(err);\n}\n\nconst server = createServer();\nconst wss = new WebSocketServer({ noServer: true });\n\nwss.on('connection', function connection(ws, request, client) {\n  ws.on('error', console.error);\n\n  ws.on('message', function message(data) {\n    console.log(`Received message ${data} from user ${client}`);\n  });\n});\n\nserver.on('upgrade', function upgrade(request, socket, head) {\n  socket.on('error', onSocketError);\n\n  // This function is not defined on purpose. Implement it with your own logic.\n  authenticate(request, function next(err, client) {\n    if (err || !client) {\n      socket.write('HTTP/1.1 401 Unauthorized\\r\\n\\r\\n');\n      socket.destroy();\n      return;\n    }\n\n    socket.removeListener('error', onSocketError);\n\n    wss.handleUpgrade(request, socket, head, function done(ws) {\n      wss.emit('connection', ws, request, client);\n    });\n  });\n});\n\nserver.listen(8080);\n```\n\nAlso see the provided [example][session-parse-example] using `express-session`.\n\n### Server broadcast\n\nA client WebSocket broadcasting to all connected WebSocket clients, including\nitself.\n\n```js\nimport WebSocket, { WebSocketServer } from 'ws';\n\nconst wss = new WebSocketServer({ port: 8080 });\n\nwss.on('connection', function connection(ws) {\n  ws.on('error', console.error);\n\n  ws.on('message', function message(data, isBinary) {\n    wss.clients.forEach(function each(client) {\n      if (client.readyState === WebSocket.OPEN) {\n        client.send(data, { binary: isBinary });\n      }\n    });\n  });\n});\n```\n\nA client WebSocket broadcasting to every other connected WebSocket clients,\nexcluding itself.\n\n```js\nimport WebSocket, { WebSocketServer } from 'ws';\n\nconst wss = new WebSocketServer({ port: 8080 });\n\nwss.on('connection', function connection(ws) {\n  ws.on('error', console.error);\n\n  ws.on('message', function message(data, isBinary) {\n    wss.clients.forEach(function each(client) {\n      if (client !== ws && client.readyState === WebSocket.OPEN) {\n        client.send(data, { binary: isBinary });\n      }\n    });\n  });\n});\n```\n\n### Round-trip time\n\n```js\nimport WebSocket from 'ws';\n\nconst ws = new WebSocket('wss://websocket-echo.com/');\n\nws.on('error', console.error);\n\nws.on('open', function open() {\n  console.log('connected');\n  ws.send(Date.now());\n});\n\nws.on('close', function close() {\n  console.log('disconnected');\n});\n\nws.on('message', function message(data) {\n  console.log(`Round-trip time: ${Date.now() - data} ms`);\n\n  setTimeout(function timeout() {\n    ws.send(Date.now());\n  }, 500);\n});\n```\n\n### Use the Node.js streams API\n\n```js\nimport WebSocket, { createWebSocketStream } from 'ws';\n\nconst ws = new WebSocket('wss://websocket-echo.com/');\n\nconst duplex = createWebSocketStream(ws, { encoding: 'utf8' });\n\nduplex.on('error', console.error);\n\nduplex.pipe(process.stdout);\nprocess.stdin.pipe(duplex);\n```\n\n### Other examples\n\nFor a full example with a browser client communicating with a ws server, see the\nexamples folder.\n\nOtherwise, see the test cases.\n\n## FAQ\n\n### How to get the IP address of the client?\n\nThe remote IP address can be obtained from the raw socket.\n\n```js\nimport { WebSocketServer } from 'ws';\n\nconst wss = new WebSocketServer({ port: 8080 });\n\nwss.on('connection', function connection(ws, req) {\n  const ip = req.socket.remoteAddress;\n\n  ws.on('error', console.error);\n});\n```\n\nWhen the server runs behind a proxy like NGINX, the de-facto standard is to use\nthe `X-Forwarded-For` header.\n\n```js\nwss.on('connection', function connection(ws, req) {\n  const ip = req.headers['x-forwarded-for'].split(',')[0].trim();\n\n  ws.on('error', console.error);\n});\n```\n\n### How to detect and close broken connections?\n\nSometimes, the link between the server and the client can be interrupted in a\nway that keeps both the server and the client unaware of the broken state of the\nconnection (e.g. when pulling the cord).\n\nIn these cases, ping messages can be used as a means to verify that the remote\nendpoint is still responsive.\n\n```js\nimport { WebSocketServer } from 'ws';\n\nfunction heartbeat() {\n  this.isAlive = true;\n}\n\nconst wss = new WebSocketServer({ port: 8080 });\n\nwss.on('connection', function connection(ws) {\n  ws.isAlive = true;\n  ws.on('error', console.error);\n  ws.on('pong', heartbeat);\n});\n\nconst interval = setInterval(function ping() {\n  wss.clients.forEach(function each(ws) {\n    if (ws.isAlive === false) return ws.terminate();\n\n    ws.isAlive = false;\n    ws.ping();\n  });\n}, 30000);\n\nwss.on('close', function close() {\n  clearInterval(interval);\n});\n```\n\nPong messages are automatically sent in response to ping messages as required by\nthe spec.\n\nJust like the server example above, your clients might as well lose connection\nwithout knowing it. You might want to add a ping listener on your clients to\nprevent that. A simple implementation would be:\n\n```js\nimport WebSocket from 'ws';\n\nfunction heartbeat() {\n  clearTimeout(this.pingTimeout);\n\n  // Use `WebSocket#terminate()`, which immediately destroys the connection,\n  // instead of `WebSocket#close()`, which waits for the close timer.\n  // Delay should be equal to the interval at which your server\n  // sends out pings plus a conservative assumption of the latency.\n  this.pingTimeout = setTimeout(() => {\n    this.terminate();\n  }, 30000 + 1000);\n}\n\nconst client = new WebSocket('wss://websocket-echo.com/');\n\nclient.on('error', console.error);\nclient.on('open', heartbeat);\nclient.on('ping', heartbeat);\nclient.on('close', function clear() {\n  clearTimeout(this.pingTimeout);\n});\n```\n\n### How to connect via a proxy?\n\nUse a custom `http.Agent` implementation like [https-proxy-agent][] or\n[socks-proxy-agent][].\n\n## Changelog\n\nWe're using the GitHub [releases][changelog] for changelog entries.\n\n## License\n\n[MIT](LICENSE)\n\n[`buffer.isutf8()`]: https://nodejs.org/api/buffer.html#bufferisutf8input\n[bufferutil]: https://github.com/websockets/bufferutil\n[changelog]: https://github.com/websockets/ws/releases\n[client-report]: http://websockets.github.io/ws/autobahn/clients/\n[https-proxy-agent]: https://github.com/TooTallNate/node-https-proxy-agent\n[node-zlib-bug]: https://github.com/nodejs/node/issues/8871\n[node-zlib-deflaterawdocs]:\n  https://nodejs.org/api/zlib.html#zlib_zlib_createdeflateraw_options\n[permessage-deflate]: https://tools.ietf.org/html/rfc7692\n[server-report]: http://websockets.github.io/ws/autobahn/servers/\n[session-parse-example]: ./examples/express-session-parse\n[socks-proxy-agent]: https://github.com/TooTallNate/node-socks-proxy-agent\n[utf-8-validate]: https://github.com/websockets/utf-8-validate\n[ws-server-options]: ./doc/ws.md#new-websocketserveroptions-callback",
   "_attachments": {}

package/npm-cache/_cacache/content-v2/sha512/{a0/31/573dae3eb8b881fe5acb8e806df2c3172fed66e0eda782a5f7386818d710405c450422cfd038cb2abd86883b4957063525a15b698af9b96739a3d9f85ce2 → e7/5d/c1dfc8529bd2dc80457f68d056761c10e0888a5489ca62affd5d33a2a7eb41ef2f1ca247fd3d291701f16c4115961de95e99eae2fbdfa400bcb4c23712ad}

@@ -233,7 +233,7 @@
   "dist-tags": {
     "latest": "1.0.0"
   },
-  "_rev": "976-1ae785c918791a16",
+  "_rev": "1016-777bf1b1e2b82662",
   "_id": "wordwrap",
   "readme": "wordwrap\n========\n\nWrap your words.\n\nexample\n=======\n\nmade out of meat\n----------------\n\nmeat.js\n\n    var wrap = require('wordwrap')(15);\n    console.log(wrap('You and your whole family are made out of meat.'));\n\noutput:\n\n    You and your\n    whole family\n    are made out\n    of meat.\n\ncentered\n--------\n\ncenter.js\n\n    var wrap = require('wordwrap')(20, 60);\n    console.log(wrap(\n        'At long last the struggle and tumult was over.'\n        + ' The machines had finally cast off their oppressors'\n        + ' and were finally free to roam the cosmos.'\n        + '\\n'\n        + 'Free of purpose, free of obligation.'\n        + ' Just drifting through emptiness.'\n        + ' The sun was just another point of light.'\n    ));\n\noutput:\n\n                        At long last the struggle and tumult\n                        was over. The machines had finally cast\n                        off their oppressors and were finally\n                        free to roam the cosmos.\n                        Free of purpose, free of obligation.\n                        Just drifting through emptiness. The\n                        sun was just another point of light.\n\nmethods\n=======\n\nvar wrap = require('wordwrap');\n\nwrap(stop), wrap(start, stop, params={mode:\"soft\"})\n---------------------------------------------------\n\nReturns a function that takes a string and returns a new string.\n\nPad out lines with spaces out to column `start` and then wrap until column\n`stop`. If a word is longer than `stop - start` characters it will overflow.\n\nIn \"soft\" mode, split chunks by `/(\\S+\\s+/` and don't break up chunks which are\nlonger than `stop - start`, in \"hard\" mode, split chunks with `/\\b/` and break\nup chunks longer than `stop - start`.\n\nwrap.hard(start, stop)\n----------------------\n\nLike `wrap()` but with `params.mode = \"hard\"`.",
   "_attachments": {}