fsevents 1.2.4 → 1.2.9

package/node_modules/deep-extend/package.json

@@ -1,27 +1,32 @@
 {
-  "_from": "deep-extend@^0.5.1",
-  "_id": "deep-extend@0.5.1",
+  "_args": [
+    [
+      "deep-extend@0.6.0",
+      "/Users/pipobscure/fsevents"
+    ]
+  ],
+  "_from": "deep-extend@0.6.0",
+  "_id": "deep-extend@0.6.0",
   "_inBundle": false,
-  "_integrity": "sha512-N8vBdOa+DF7zkRrDCsaOXoCs/E2fJfx9B9MrKnnSiHNh4ws7eSys6YQE4KvT1cecKmOASYQBhbKjeuDD9lT81w==",
+  "_integrity": "sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==",
   "_location": "/deep-extend",
   "_phantomChildren": {},
   "_requested": {
-    "type": "range",
+    "type": "version",
     "registry": true,
-    "raw": "deep-extend@^0.5.1",
+    "raw": "deep-extend@0.6.0",
     "name": "deep-extend",
     "escapedName": "deep-extend",
-    "rawSpec": "^0.5.1",
+    "rawSpec": "0.6.0",
     "saveSpec": null,
-    "fetchSpec": "^0.5.1"
+    "fetchSpec": "0.6.0"
   },
   "_requiredBy": [
     "/rc"
   ],
-  "_resolved": "https://registry.npmjs.org/deep-extend/-/deep-extend-0.5.1.tgz",
-  "_shasum": "b894a9dd90d3023fbf1c55a394fb858eb2066f1f",
-  "_spec": "deep-extend@^0.5.1",
-  "_where": "/Users/eshanker/Code/fsevents/node_modules/rc",
+  "_resolved": "https://registry.npmjs.org/deep-extend/-/deep-extend-0.6.0.tgz",
+  "_spec": "0.6.0",
+  "_where": "/Users/pipobscure/fsevents",
   "author": {
     "name": "Viacheslav Lotsmanov",
     "email": "lotsmanov89@gmail.com"
@@ -29,7 +34,6 @@
   "bugs": {
     "url": "https://github.com/unclechu/node-deep-extend/issues"
   },
-  "bundleDependencies": false,
   "contributors": [
     {
       "name": "Romain Prieto",
@@ -48,15 +52,13 @@
       "url": "https://github.com/mwakerman"
     }
   ],
-  "deprecated": false,
   "description": "Recursive object extending",
   "devDependencies": {
-    "mocha": "2.2.1",
-    "should": "5.2.0"
+    "mocha": "5.2.0",
+    "should": "13.2.1"
   },
   "engines": {
-    "iojs": ">=1.0.0",
-    "node": ">=0.10.0"
+    "node": ">=4.0.0"
   },
   "files": [
     "index.js",
@@ -89,5 +91,5 @@
   "scripts": {
     "test": "mocha"
   },
-  "version": "0.5.1"
+  "version": "0.6.0"
 }

package/node_modules/delegates/package.json

@@ -2,7 +2,7 @@
   "_args": [
     [
       "delegates@1.0.0",
-      "/Users/eshanker/Code/fsevents"
+      "/Users/pipobscure/fsevents"
     ]
   ],
   "_from": "delegates@1.0.0",
@@ -26,7 +26,7 @@
   ],
   "_resolved": "https://registry.npmjs.org/delegates/-/delegates-1.0.0.tgz",
   "_spec": "1.0.0",
-  "_where": "/Users/eshanker/Code/fsevents",
+  "_where": "/Users/pipobscure/fsevents",
   "bugs": {
     "url": "https://github.com/visionmedia/node-delegates/issues"
   },

package/node_modules/detect-libc/package.json

@@ -2,7 +2,7 @@
   "_args": [
     [
       "detect-libc@1.0.3",
-      "/Users/eshanker/Code/fsevents"
+      "/Users/pipobscure/fsevents"
     ]
   ],
   "_from": "detect-libc@1.0.3",
@@ -26,7 +26,7 @@
   ],
   "_resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-1.0.3.tgz",
   "_spec": "1.0.3",
-  "_where": "/Users/eshanker/Code/fsevents",
+  "_where": "/Users/pipobscure/fsevents",
   "author": {
     "name": "Lovell Fuller",
     "email": "npm@lovell.info"

package/node_modules/fs-minipass/package.json

@@ -2,7 +2,7 @@
   "_args": [
     [
       "fs-minipass@1.2.5",
-      "/Users/eshanker/Code/fsevents"
+      "/Users/pipobscure/fsevents"
     ]
   ],
   "_from": "fs-minipass@1.2.5",
@@ -26,7 +26,7 @@
   ],
   "_resolved": "https://registry.npmjs.org/fs-minipass/-/fs-minipass-1.2.5.tgz",
   "_spec": "1.2.5",
-  "_where": "/Users/eshanker/Code/fsevents",
+  "_where": "/Users/pipobscure/fsevents",
   "author": {
     "name": "Isaac Z. Schlueter",
     "email": "i@izs.me",

package/node_modules/fs.realpath/package.json

@@ -2,7 +2,7 @@
   "_args": [
     [
       "fs.realpath@1.0.0",
-      "/Users/eshanker/Code/fsevents"
+      "/Users/pipobscure/fsevents"
     ]
   ],
   "_from": "fs.realpath@1.0.0",
@@ -26,7 +26,7 @@
   ],
   "_resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz",
   "_spec": "1.0.0",
-  "_where": "/Users/eshanker/Code/fsevents",
+  "_where": "/Users/pipobscure/fsevents",
   "author": {
     "name": "Isaac Z. Schlueter",
     "email": "i@izs.me",

package/node_modules/gauge/package.json

@@ -2,7 +2,7 @@
   "_args": [
     [
       "gauge@2.7.4",
-      "/Users/eshanker/Code/fsevents"
+      "/Users/pipobscure/fsevents"
     ]
   ],
   "_from": "gauge@2.7.4",
@@ -26,7 +26,7 @@
   ],
   "_resolved": "https://registry.npmjs.org/gauge/-/gauge-2.7.4.tgz",
   "_spec": "2.7.4",
-  "_where": "/Users/eshanker/Code/fsevents",
+  "_where": "/Users/pipobscure/fsevents",
   "author": {
     "name": "Rebecca Turner",
     "email": "me@re-becca.org"

package/node_modules/glob/package.json

@@ -1,32 +1,32 @@
 {
   "_args": [
     [
-      "glob@7.1.2",
-      "/Users/eshanker/Code/fsevents"
+      "glob@7.1.3",
+      "/Users/pipobscure/fsevents"
     ]
   ],
-  "_from": "glob@7.1.2",
-  "_id": "glob@7.1.2",
+  "_from": "glob@7.1.3",
+  "_id": "glob@7.1.3",
   "_inBundle": false,
-  "_integrity": "sha512-MJTUg1kjuLeQCJ+ccE4Vpa6kKVXkPYJ2mOCQyUuKLcLQsdrMCpBPUi8qVE6+YuaJkozeA9NusTAw3hLr8Xe5EQ==",
+  "_integrity": "sha512-vcfuiIxogLV4DlGBHIUOwI0IbrJ8HWPc4MU7HzviGeNho/UJDfi6B5p3sHeWIQ0KGIU0Jpxi5ZHxemQfLkkAwQ==",
   "_location": "/glob",
   "_phantomChildren": {},
   "_requested": {
     "type": "version",
     "registry": true,
-    "raw": "glob@7.1.2",
+    "raw": "glob@7.1.3",
     "name": "glob",
     "escapedName": "glob",
-    "rawSpec": "7.1.2",
+    "rawSpec": "7.1.3",
     "saveSpec": null,
-    "fetchSpec": "7.1.2"
+    "fetchSpec": "7.1.3"
   },
   "_requiredBy": [
     "/rimraf"
   ],
-  "_resolved": "https://registry.npmjs.org/glob/-/glob-7.1.2.tgz",
-  "_spec": "7.1.2",
-  "_where": "/Users/eshanker/Code/fsevents",
+  "_resolved": "https://registry.npmjs.org/glob/-/glob-7.1.3.tgz",
+  "_spec": "7.1.3",
+  "_where": "/Users/pipobscure/fsevents",
   "author": {
     "name": "Isaac Z. Schlueter",
     "email": "i@izs.me",
@@ -47,7 +47,7 @@
   "devDependencies": {
     "mkdirp": "0",
     "rimraf": "^2.2.8",
-    "tap": "^7.1.2",
+    "tap": "^12.0.1",
     "tick": "0.0.6"
   },
   "engines": {
@@ -75,5 +75,5 @@
     "test": "tap test/*.js --cov",
     "test-regen": "npm run profclean && TEST_REGEN=1 node test/00-setup.js"
   },
-  "version": "7.1.2"
+  "version": "7.1.3"
 }

package/node_modules/has-unicode/package.json

@@ -2,7 +2,7 @@
   "_args": [
     [
       "has-unicode@2.0.1",
-      "/Users/eshanker/Code/fsevents"
+      "/Users/pipobscure/fsevents"
     ]
   ],
   "_from": "has-unicode@2.0.1",
@@ -26,7 +26,7 @@
   ],
   "_resolved": "https://registry.npmjs.org/has-unicode/-/has-unicode-2.0.1.tgz",
   "_spec": "2.0.1",
-  "_where": "/Users/eshanker/Code/fsevents",
+  "_where": "/Users/pipobscure/fsevents",
   "author": {
     "name": "Rebecca Turner",
     "email": "me@re-becca.org"

package/node_modules/iconv-lite/Changelog.md

@@ -1,3 +1,19 @@
+# 0.4.24 / 2018-08-22
+
+  * Added MIK encoding (#196, by @Ivan-Kalatchev)
+
+
+# 0.4.23 / 2018-05-07
+
+  * Fix deprecation warning in Node v10 due to the last usage of `new Buffer` (#185, by @felixbuenemann)
+  * Switched from NodeBuffer to Buffer in typings (#155 by @felixfbecker, #186 by @larssn)
+
+
+# 0.4.22 / 2018-05-05
+
+  * Use older semver style for dependencies to be compatible with Node version 0.10 (#182, by @dougwilson)
+  * Fix tests to accomodate fixes in Node v10 (#182, by @dougwilson)
+
 
 # 0.4.21 / 2018-04-06
 

package/node_modules/iconv-lite/encodings/sbcs-codec.js

@@ -20,10 +20,10 @@ function SBCSCodec(codecOptions, iconv) {
         codecOptions.chars = asciiString + codecOptions.chars;
     }
 
-    this.decodeBuf = new Buffer.from(codecOptions.chars, 'ucs2');
+    this.decodeBuf = Buffer.from(codecOptions.chars, 'ucs2');
     
     // Encoding buffer.
-    var encodeBuf = new Buffer.alloc(65536, iconv.defaultCharSingleByte.charCodeAt(0));
+    var encodeBuf = Buffer.alloc(65536, iconv.defaultCharSingleByte.charCodeAt(0));
 
     for (var i = 0; i < codecOptions.chars.length; i++)
         encodeBuf[codecOptions.chars.charCodeAt(i)] = i;

package/node_modules/iconv-lite/encodings/sbcs-data.js

@@ -17,6 +17,11 @@ module.exports = {
         "chars": "АБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯабвгдежзийклмноп░▒▓│┤╡╢╖╕╣║╗╝╜╛┐└┴┬├─┼╞╟╚╔╩╦╠═╬╧╨╤╥╙╘╒╓╫╪┘┌█▄▌▐▀рстуфхцчшщъыьэюяЁёЄєЇїЎў°∙·√№€■ "
     },
 
+    "mik": {
+        "type": "_sbcs",
+        "chars": "АБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯабвгдежзийклмнопрстуфхцчшщъыьэюя└┴┬├─┼╣║╚╔╩╦╠═╬┐░▒▓│┤№§╗╝┘┌█▄▌▐▀αßΓπΣσµτΦΘΩδ∞φε∩≡±≥≤⌠⌡÷≈°∙·√ⁿ²■ "
+    },
+
     // Aliases of generated encodings.
     "ascii8bit": "ascii",
     "usascii": "ascii",

package/node_modules/iconv-lite/lib/extend-node.js

@@ -10,7 +10,7 @@ module.exports = function (iconv) {
     // Node authors rewrote Buffer internals to make it compatible with
     // Uint8Array and we cannot patch key functions since then.
     // Note: this does use older Buffer API on a purpose
-    iconv.supportsNodeEncodingsExtension = !(new Buffer(0) instanceof Uint8Array);
+    iconv.supportsNodeEncodingsExtension = !(Buffer.from || new Buffer(0) instanceof Uint8Array);
 
     iconv.extendNodeEncodings = function extendNodeEncodings() {
         if (original) return;

package/node_modules/iconv-lite/lib/index.d.ts

@@ -6,9 +6,9 @@
  *--------------------------------------------------------------------------------------------*/
 
 declare module 'iconv-lite' {
-	export function decode(buffer: NodeBuffer, encoding: string, options?: Options): string;
+	export function decode(buffer: Buffer, encoding: string, options?: Options): string;
 
-	export function encode(content: string, encoding: string, options?: Options): NodeBuffer;
+	export function encode(content: string, encoding: string, options?: Options): Buffer;
 
 	export function encodingExists(encoding: string): boolean;
 

package/node_modules/iconv-lite/package.json

@@ -1,32 +1,32 @@
 {
   "_args": [
     [
-      "iconv-lite@0.4.21",
-      "/Users/eshanker/Code/fsevents"
+      "iconv-lite@0.4.24",
+      "/Users/pipobscure/fsevents"
     ]
   ],
-  "_from": "iconv-lite@0.4.21",
-  "_id": "iconv-lite@0.4.21",
+  "_from": "iconv-lite@0.4.24",
+  "_id": "iconv-lite@0.4.24",
   "_inBundle": false,
-  "_integrity": "sha512-En5V9za5mBt2oUA03WGD3TwDv0MKAruqsuxstbMUZaj9W9k/m1CV/9py3l0L5kw9Bln8fdHQmzHSYtvpvTLpKw==",
+  "_integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==",
   "_location": "/iconv-lite",
   "_phantomChildren": {},
   "_requested": {
     "type": "version",
     "registry": true,
-    "raw": "iconv-lite@0.4.21",
+    "raw": "iconv-lite@0.4.24",
     "name": "iconv-lite",
     "escapedName": "iconv-lite",
-    "rawSpec": "0.4.21",
+    "rawSpec": "0.4.24",
     "saveSpec": null,
-    "fetchSpec": "0.4.21"
+    "fetchSpec": "0.4.24"
   },
   "_requiredBy": [
     "/needle"
   ],
-  "_resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.21.tgz",
-  "_spec": "0.4.21",
-  "_where": "/Users/eshanker/Code/fsevents",
+  "_resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz",
+  "_spec": "0.4.24",
+  "_where": "/Users/pipobscure/fsevents",
   "author": {
     "name": "Alexander Shtuchkin",
     "email": "ashtuchkin@gmail.com"
@@ -39,7 +39,7 @@
     "url": "https://github.com/ashtuchkin/iconv-lite/issues"
   },
   "dependencies": {
-    "safer-buffer": "^2.1.0"
+    "safer-buffer": ">= 2.1.2 < 3"
   },
   "description": "Convert character encodings in pure javascript.",
   "devDependencies": {
@@ -48,7 +48,7 @@
     "iconv": "*",
     "istanbul": "*",
     "mocha": "^3.1.0",
-    "request": "~2.81.0",
+    "request": "~2.87.0",
     "semver": "*",
     "unorm": "*"
   },
@@ -75,5 +75,5 @@
     "test": "mocha --reporter spec --grep ."
   },
   "typings": "./lib/index.d.ts",
-  "version": "0.4.21"
+  "version": "0.4.24"
 }

package/node_modules/ignore-walk/package.json

@@ -2,7 +2,7 @@
   "_args": [
     [
       "ignore-walk@3.0.1",
-      "/Users/eshanker/Code/fsevents"
+      "/Users/pipobscure/fsevents"
     ]
   ],
   "_from": "ignore-walk@3.0.1",
@@ -26,7 +26,7 @@
   ],
   "_resolved": "https://registry.npmjs.org/ignore-walk/-/ignore-walk-3.0.1.tgz",
   "_spec": "3.0.1",
-  "_where": "/Users/eshanker/Code/fsevents",
+  "_where": "/Users/pipobscure/fsevents",
   "author": {
     "name": "Isaac Z. Schlueter",
     "email": "i@izs.me",

package/node_modules/inflight/package.json

@@ -2,7 +2,7 @@
   "_args": [
     [
       "inflight@1.0.6",
-      "/Users/eshanker/Code/fsevents"
+      "/Users/pipobscure/fsevents"
     ]
   ],
   "_from": "inflight@1.0.6",
@@ -26,7 +26,7 @@
   ],
   "_resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz",
   "_spec": "1.0.6",
-  "_where": "/Users/eshanker/Code/fsevents",
+  "_where": "/Users/pipobscure/fsevents",
   "author": {
     "name": "Isaac Z. Schlueter",
     "email": "i@izs.me",

package/node_modules/inherits/package.json

@@ -2,7 +2,7 @@
   "_args": [
     [
       "inherits@2.0.3",
-      "/Users/eshanker/Code/fsevents"
+      "/Users/pipobscure/fsevents"
     ]
   ],
   "_from": "inherits@2.0.3",
@@ -23,13 +23,11 @@
   },
   "_requiredBy": [
     "/glob",
-    "/readable-stream",
-    "/tap",
-    "/tap/glob"
+    "/readable-stream"
   ],
   "_resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.3.tgz",
   "_spec": "2.0.3",
-  "_where": "/Users/eshanker/Code/fsevents",
+  "_where": "/Users/pipobscure/fsevents",
   "browser": "./inherits_browser.js",
   "bugs": {
     "url": "https://github.com/isaacs/inherits/issues"

package/node_modules/ini/package.json

@@ -2,7 +2,7 @@
   "_args": [
     [
       "ini@1.3.5",
-      "/Users/eshanker/Code/fsevents"
+      "/Users/pipobscure/fsevents"
     ]
   ],
   "_from": "ini@1.3.5",
@@ -26,7 +26,7 @@
   ],
   "_resolved": "https://registry.npmjs.org/ini/-/ini-1.3.5.tgz",
   "_spec": "1.3.5",
-  "_where": "/Users/eshanker/Code/fsevents",
+  "_where": "/Users/pipobscure/fsevents",
   "author": {
     "name": "Isaac Z. Schlueter",
     "email": "i@izs.me",

package/node_modules/is-fullwidth-code-point/package.json

@@ -2,7 +2,7 @@
   "_args": [
     [
       "is-fullwidth-code-point@1.0.0",
-      "/Users/eshanker/Code/fsevents"
+      "/Users/pipobscure/fsevents"
     ]
   ],
   "_from": "is-fullwidth-code-point@1.0.0",
@@ -26,7 +26,7 @@
   ],
   "_resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-1.0.0.tgz",
   "_spec": "1.0.0",
-  "_where": "/Users/eshanker/Code/fsevents",
+  "_where": "/Users/pipobscure/fsevents",
   "author": {
     "name": "Sindre Sorhus",
     "email": "sindresorhus@gmail.com",

package/node_modules/isarray/package.json

@@ -2,7 +2,7 @@
   "_args": [
     [
       "isarray@1.0.0",
-      "/Users/eshanker/Code/fsevents"
+      "/Users/pipobscure/fsevents"
     ]
   ],
   "_from": "isarray@1.0.0",
@@ -26,7 +26,7 @@
   ],
   "_resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz",
   "_spec": "1.0.0",
-  "_where": "/Users/eshanker/Code/fsevents",
+  "_where": "/Users/pipobscure/fsevents",
   "author": {
     "name": "Julian Gruber",
     "email": "mail@juliangruber.com",

package/node_modules/minimatch/package.json

@@ -2,7 +2,7 @@
   "_args": [
     [
       "minimatch@3.0.4",
-      "/Users/eshanker/Code/fsevents"
+      "/Users/pipobscure/fsevents"
     ]
   ],
   "_from": "minimatch@3.0.4",
@@ -27,7 +27,7 @@
   ],
   "_resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.0.4.tgz",
   "_spec": "3.0.4",
-  "_where": "/Users/eshanker/Code/fsevents",
+  "_where": "/Users/pipobscure/fsevents",
   "author": {
     "name": "Isaac Z. Schlueter",
     "email": "i@izs.me",

package/node_modules/minimist/package.json

@@ -2,7 +2,7 @@
   "_args": [
     [
       "minimist@0.0.8",
-      "/Users/eshanker/Code/fsevents"
+      "/Users/pipobscure/fsevents"
     ]
   ],
   "_from": "minimist@0.0.8",
@@ -26,7 +26,7 @@
   ],
   "_resolved": "https://registry.npmjs.org/minimist/-/minimist-0.0.8.tgz",
   "_spec": "0.0.8",
-  "_where": "/Users/eshanker/Code/fsevents",
+  "_where": "/Users/pipobscure/fsevents",
   "author": {
     "name": "James Halliday",
     "email": "mail@substack.net",

package/node_modules/minipass/LICENSE

@@ -0,0 +1,15 @@
+The ISC License
+
+Copyright (c) npm, Inc. and Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
+IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/node_modules/minipass/README.md

@@ -15,9 +15,7 @@ cases where PassThrough is a good idea.
 There is a `read()` method, but it's much more efficient to consume
 data from this stream via `'data'` events or by calling `pipe()` into
 some other stream.  Calling `read()` requires the buffer to be
-flattened in some cases, which requires copying memory.  Also,
-`read()` always returns Buffers, even if an `encoding` option is
-specified.
+flattened in some cases, which requires copying memory.
 
 There is also no `unpipe()` method.  Once you start piping, there is
 no stopping it!
@@ -44,3 +42,83 @@ mp.write('foo')
 mp.pipe(someOtherStream)
 mp.end('bar')
 ```
+
+### collecting
+
+```js
+mp.collect().then(all => {
+  // all is an array of all the data emitted
+  // encoding is supported in this case, so
+  // so the result will be a collection of strings if
+  // an encoding is specified, or buffers/objects if not.
+  //
+  // In an async function, you may do
+  // const data = await stream.collect()
+})
+```
+
+### iteration
+
+You can iterate over streams synchronously or asynchronously in
+platforms that support it.
+
+Synchronous iteration will end when the currently available data is
+consumed, even if the `end` event has not been reached.  In string and
+buffer mode, the data is concatenated, so unless multiple writes are
+occurring in the same tick as the `read()`, sync iteration loops will
+generally only have a single iteration.
+
+To consume chunks in this way exactly as they have been written, with
+no flattening, create the stream with the `{ objectMode: true }`
+option.
+
+```js
+const mp = new Minipass({ objectMode: true })
+mp.write('a')
+mp.write('b')
+for (let letter of mp) {
+  console.log(letter) // a, b
+}
+mp.write('c')
+mp.write('d')
+for (let letter of mp) {
+  console.log(letter) // c, d
+}
+mp.write('e')
+mp.end()
+for (let letter of mp) {
+  console.log(letter) // e
+}
+for (let letter of mp) {
+  console.log(letter) // nothing
+}
+```
+
+Asynchronous iteration will continue until the end event is reached,
+consuming all of the data.
+
+```js
+const mp = new Minipass({ encoding: 'utf8' })
+
+// some source of some data
+let i = 5
+const inter = setInterval(() => {
+  if (i --> 0)
+    mp.write(Buffer.from('foo\n', 'utf8'))
+  else {
+    mp.end()
+    clearInterval(inter)
+  }
+}, 100)
+
+// consume the data with asynchronous iteration
+async function consume () {
+  for await (let chunk of mp) {
+    console.log(chunk)
+  }
+  return 'ok'
+}
+
+consume().then(res => console.log(res))
+// logs `foo\n` 5 times, and then `ok`
+```