0.3.0

README.md

@@ -0,0 +1,109 @@
+# @promistream/simple-sink
+
+A generic sink stream for [Promistreams](https://promistream.cryto.net/) that can cover most usecases. It automatically drives the pipeline above it once it is read from once, in its default configuration.
+
+Note that if you simply need to collect all of the values that came from a pipeline into an array, you are probably looking for [`@promistream/collect`](https://www.npmjs.com/package/@promistream/collect) instead, which is built on top of this stream. This library (`@promistream/simple-sink`) is only useful if you need lower-level control over reads and cumulative results than that.
+
+Stream characteristics:
+
+- __Promistream version:__ 0
+- __Stream type:__ Sink
+- __Supports parallelization:__ No, queues parallel reads
+- __Buffering:__ None
+
+## Examples
+
+Both of these examples are included in the package in runnable form.
+
+A simple stream (`example-simple.js`):
+
+```js
+"use strict";
+
+const pipe = require("@promistream/pipe");
+const fromIterable = require("@promistream/from-iterable");
+const simpleSink = require("@promistream/simple-sink");
+
+(async () => {
+	let result = await pipe([
+		fromIterable([ 1, 2, 3, 4, 5 ]),
+		simpleSink(async (value, abort) => {
+			console.log("value seen:", value);
+		})
+	]).read();
+
+	console.log("result:", result);
+})();
+
+/* Output:
+value seen: 1
+value seen: 2
+value seen: 3
+value seen: 4
+value seen: 5
+result: undefined
+*/
+```
+
+A stream that uses more of the features (`example.js`):
+
+```js
+"use strict";
+
+const pipe = require("@promistream/pipe");
+const fromIterable = require("@promistream/from-iterable");
+const simpleSink = require("@promistream/simple-sink");
+
+(async () => {
+	try {
+		let result = await pipe([
+			fromIterable([ 1, 2, 3, 4, 5 ]),
+			simpleSink({
+				onValue: async (value, abort) => {
+					console.log("value seen:", value);
+					// if (value === 3) { abort(new Error("uncomment this to trigger an abort")); }
+				},
+				onEnd: async () => {
+					console.log("stream finished");
+					return "arbitrary value";
+				},
+				onAbort: async (error) => {
+					console.log("stream aborted due to reason:", error);
+				}
+			})
+		]).read();
+
+		console.log("result:", result);
+	} catch (error) {
+		console.log("caught error:", error);
+	}
+})();
+
+/* Output:
+value seen: 1
+value seen: 2
+value seen: 3
+value seen: 4
+value seen: 5
+stream finished
+result: arbitrary value
+*/
+```
+
+## API
+
+### simpleSink(options)
+
+In the typical, simple usecase, all you need to do is to specify a single async callback that does something with each value, and returns (resolves) once it is done. You may also need to specify an `onEnd` handler to produce a cumulative result once the pipeline ends. The other options are mainly for more complex cases.
+
+- __options:__ Either a function (which will be interpreted as the `onValue` option), or an object of options:
+	- __onValue:__ *Required.* An async callback that is called for every value that is read from upstream. It receives the arguments `(value, abort)`, where the `value` is the value that has been read, and `abort` is a callable function. There are a few things that this callback can do:
+		- __Return, call, or throw nothing:__ This is the most common case, and lets the sink do its job of just continuously reading values from upstream and invoking your callback.
+		- __Return a Promise that rejects, or throw an error:__ As you would expect, this signals an error condition and causes the pipeline to be terminated early with an error condition.
+		- __Return a Promise that resolves to `undefined`:__ This pauses the reading by the sink until the Promise has resolved, and so can be used to delay reads (by having the Promise resolve at a later time).
+		- __Return a Promise that resolves to a non-`undefined` value:__ This causes the pipeline's `read` operation to return *before* the source stream has ended; this can be used to do some internal reading of a pipeline before handing it over to user code, for example, like in a protocol handler. Note that in this case, the stream-end handlers *will not* be called! The sink simply detaches and leaves the rest of the pipeline untouched.
+		- __Call the provided `abort` function with `true` as the argument:__ This asks the source stream to terminate early. It is equivalent to the `abort` method in the Promistream spec, and should only be used under success conditions (ie. the stream should terminate early for an expected and normal reason). Note that source streams are not required to honour this request.
+		- __Call the provided `abort` function with an Error object as the argument:__ This terminates the stream early, under error conditions. It is again equivalent to `abort` in the spec, and should be used in case of unexpected errors. Note that an Error that's thrown/rejected from the callback is handled the same way, so you should rarely need this.
+	- __onEnd:__ *Optional.* An async callback that is called when the stream ends normally, ie. the source stream has ended and the pipeline is being torn down. This is where you would do cleanup of underlying resources under success conditions. You can also generate and return a cumulative value here, which is returned from the `read` that started the sink processing.
+	- __onAbort:__ *Optional.* An async callback that is called when the stream terminates abnormally, ie. some sort of error has occurred, and the pipeline was aborted. This where you would do cleanup of underlying resources under error conditions, when the pipeline has not fully completed and never will.
+	- __onSourceChanged:__ *Optional.* An async callback that is called whenever the stream that is being read from, changes. In typical use (using [@promistream/pipe](https://www.npmjs.com/package/@promistream/pipe)), this will never happen, but you need to account for it if your stream logic depends on knowing what stream a value came from.

example-simple.js

@@ -0,0 +1,25 @@
+"use strict";
+
+const pipe = require("@promistream/pipe");
+const fromIterable = require("@promistream/from-iterable");
+const simpleSink = require(".");
+
+(async () => {
+	let result = await pipe([
+		fromIterable([ 1, 2, 3, 4, 5 ]),
+		simpleSink(async (value, abort) => {
+			console.log("value seen:", value);
+		})
+	]).read();
+
+	console.log("result:", result);
+})();
+
+/* Output:
+value seen: 1
+value seen: 2
+value seen: 3
+value seen: 4
+value seen: 5
+result: undefined
+*/

example.js

@@ -0,0 +1,40 @@
+"use strict";
+
+const pipe = require("@promistream/pipe");
+const fromIterable = require("@promistream/from-iterable");
+const simpleSink = require("./");
+
+(async () => {
+	try {
+		let result = await pipe([
+			fromIterable([ 1, 2, 3, 4, 5 ]),
+			simpleSink({
+				onValue: async (value, abort) => {
+					console.log("value seen:", value);
+					// if (value === 3) { abort(new Error("uncomment this to trigger an abort")); }
+				},
+				onEnd: async () => {
+					console.log("stream finished");
+					return "arbitrary value";
+				},
+				onAbort: async (error) => {
+					console.log("stream aborted due to reason:", error);
+				}
+			})
+		]).read();
+
+		console.log("result:", result);
+	} catch (error) {
+		console.log("caught error:", error);
+	}
+})();
+
+/* Output:
+value seen: 1
+value seen: 2
+value seen: 3
+value seen: 4
+value seen: 5
+stream finished
+result: arbitrary value
+*/

index.js

@@ -1,7 +1,8 @@
+/* eslint-disable no-loop-func */
 "use strict";
 
-const Promise = require("bluebird");
-const createResultBuffer = require("result-buffer");
+const matchValue = require("match-value");
+const pushBuffer = require("push-buffer");
 
 const propagateAbort = require("@promistream/propagate-abort");
 const propagatePeek = require("@promistream/propagate-peek");
@@ -12,123 +13,113 @@ const { validateOptions } = require("@validatem/core");
 const required = require("@validatem/required");
 const isFunction = require("@validatem/is-function");
 const wrapValueAsOption = require("@validatem/wrap-value-as-option");
+const defaultTo = require("@validatem/default-to");
+
+const states = {
+	OPEN: Symbol("states.OPEN"),
+	ABORTED: Symbol("states.ABORTED"),
+	ABORT_HANDLED: Symbol("states.ABORT_HANDLED"),
+	ABORT_THROW_CAUSE: Symbol("states.ABORT_THROW_CAUSE"),
+	ENDED: Symbol("states.ENDED"),
+	END_HANDLED: Symbol("states.END_HANDLED")
+};
+
+function noop() {
+	// Do nothing
+}
 
-// FIXME: Update other stream implementations to new API
 module.exports = function simpleSinkStream(_options) {
-	let { onResult, onEnd, onAbort, onSourceChanged } = validateOptions(arguments, [
+	let { onValue, onEnd, onAbort, onSourceChanged } = validateOptions(arguments, [
 		required,
-		wrapValueAsOption("onResult"), {
-			onResult: [ required, isFunction ],
-			onAbort: [ isFunction ],
-			onSourceChanged: [ isFunction ],
-			onEnd: [ isFunction ]
+		wrapValueAsOption("onValue"), {
+			onValue: [ required, isFunction ],
+			onAbort: [ defaultTo.literal(noop), isFunction ],
+			onSourceChanged: [ defaultTo.literal(noop), isFunction ],
+			onEnd: [ defaultTo.literal(noop), isFunction ]
 		}
 	]);
 
-	// FIXME: Bump minor version!
-
-	let onEndCalled = false;
-	let abortHandled = false;
+	let state = states.OPEN;
 	let lastKnownSource;
+	let abortMarker, endMarker;
 
-	let resultBuffer = createResultBuffer();
+	let buffer = pushBuffer({
+		sequential: true,
+		pull: async () => {
+			let result = undefined;
+			let forceReturn = false;
+
+			while (result === undefined && forceReturn === false) {
+				await matchValue(state, {
+					[states.OPEN]: async () => {
+						try {
+							let value = await lastKnownSource.read();
+							result = await onValue(value, (reason) => lastKnownSource.abort(reason));
+						} catch (error) {
+							if (isEndOfStream(error)) {
+								endMarker = error;
+								state = states.ENDED;
+							} else if (isAborted(error)) {
+								abortMarker = error;
+								state = states.ABORTED;
+							} else {
+								try {
+									await lastKnownSource.abort(error);
+								} catch (abortError) {
+									let message = [
+										`Tried to abort stream due to encountering an error, but the aborting itself failed`,
+										`Original error message: ${error.message}`,
+										`Abort failure message: ${abortError.message}`
+									].join("\n");
+		
+									// FIXME: Make this some sort of chained error
+									let combinedError = new Error(message);
+									combinedError.stack = abortError.stack; // HACK
+									throw combinedError;
+								}
+							}
+						}
+					},
+					[states.ABORTED]: async () => {
+						result = await onAbort(abortMarker.cause);
+						state = states.ABORT_THROW_CAUSE;
+					},
+					[states.ABORT_THROW_CAUSE]: async () => {
+						// NOTE: This ensures that the original error causing the abort is thrown exactly once
+						state = states.ABORT_HANDLED;
+						throw abortMarker.cause;
+					},
+					[states.ABORT_HANDLED]: async () => {
+						throw abortMarker;
+					},
+					[states.ENDED]: async () => {
+						// Note: we *always* return a value when handling the end of the stream - that is intentional. This is necessary because the end can only ever be reached as the ultimate result of a read call on this stream, and that call is expected to return a value. If we only returned a value when there's an onEnd handler producing one, then it would be possible in some cases for the handler to not produce any result, causing an entirely valid read call to result in a thrown EndOfStream error in the next state. That error should only be thrown if something *continues* to try and read from it, not at the first moment that the end is reached.
+						state = states.END_HANDLED;
+						result = await onEnd();
+						forceReturn = true;
+					},
+					[states.END_HANDLED]: async () => {
+						throw endMarker;
+					}
+				});
+			}
+
+			return result;
+		}
+	});
 
 	return {
 		_promistreamVersion: 0,
 		description: `simple sink stream`,
 		abort: propagateAbort,
 		peek: propagatePeek,
-		read: function produceValue_simpleSinkStream(source) {
-			function attemptRead() {
-				return Promise.try(() => {
-					return source.read();
-				}).then((value) => {
-					// FIXME: Document that you can pause the sink from the onResult callback, by returning a Promise that resolves when it should be resumed
-					return onResult(value, source.abort.bind(source));
-				}).then((result) => {
-					// FIXME: Replace all instances of undefined checks with a standardized NoValue marker
-					if (result !== undefined) {
-						// TODO: Force end of stream when this occurs?
-						return result;
-					} else {
-						return attemptRead();
-					}
-				});
+		read: async function produceValue_simpleSinkStream(source) {
+			if (source !== lastKnownSource && onSourceChanged != null) {
+				lastKnownSource = source;
+				await onSourceChanged(source);
 			}
 
-			return resultBuffer.maybeRead(() => {
-				return Promise.try(() => {
-					if (source !== lastKnownSource && onSourceChanged != null) {
-						lastKnownSource = source;
-						return onSourceChanged(source);
-					}
-				}).then(() => {
-					return attemptRead();
-				}).catch(isEndOfStream, (error) => {
-					/* Don't attempt to do another read, we're done.  */
-					return Promise.try(() => {
-						// Note: we *always* push a value to the buffer when handling the end of the stream - that is intentional. This is necessary because the end can only ever be reached as the ultimate result of a read call on this stream, and that call is expected to return a value. If we only pushed a value to the buffer when there's an onEnd handler producing one, then it would be possible in some cases for the buffer to remain empty, causing an entirely valid read call to result in a thrown EndOfStream error. That error should only be thrown if something *continues* to try and read from it, not at the first moment that the end is reached.
-						if (!onEndCalled) {
-							onEndCalled = true;
-
-							if (onEnd != null) {
-								return Promise.try(() => {
-									return onEnd();
-								}).then((result) => {
-									resultBuffer.push(result);
-								});
-							} else {
-								resultBuffer.push(undefined);
-							}
-						}
-					}).then(() => {
-						return resultBuffer.maybeRead(() => {
-							throw error;
-						});
-					});
-				}).catch((error) => !isAborted(error), (error) => {
-					return Promise.try(() => {
-						return source.abort(error);
-					}).catch((abortError) => {
-						let message = [
-							`Tried to abort stream due to encountering an error, but the aborting itself failed`,
-							`Original error message: ${error.message}`,
-							`Abort failure message: ${abortError.message}`
-						].join("\n");
-	
-						// FIXME: Make this some sort of chained error
-						let combinedError = new Error(message);
-						combinedError.stack = abortError.stack; // HACK
-						throw combinedError;
-					}).then(() => {
-						// Pass through the original error to the user
-						throw error;
-					});
-				}).catch(isAborted, (marker) => {
-					if (abortHandled === false) {
-						abortHandled = true;
-	
-						return Promise.try(() => {
-							if (onAbort != null) {
-								return onAbort(marker.reason);
-							}
-						}).then((value) => {
-							if (value !== undefined) {
-								resultBuffer.push(value);
-							}
-	
-							if (marker.reason instanceof Error) {
-								// NOTE: This ensures that the original error causing the abort is thrown exactly once
-								resultBuffer.push(Promise.reject(marker.reason));
-							}
-						});
-					}
-	
-					return resultBuffer.maybeRead(() => {
-						throw marker;
-					});
-				});
-			});
+			return buffer.request();
 		}
 	};
 };

package.json

@@ -1,7 +1,13 @@
 {
   "name": "@promistream/simple-sink",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "main": "index.js",
+  "files": [
+    "index.js",
+    "example.js",
+    "example-simple.js",
+    "README.md"
+  ],
   "repository": "http://git.cryto.net/promistream/simple-sink.git",
   "author": "Sven Slootweg <admin@cryto.net>",
   "license": "WTFPL OR CC0-1.0",
@@ -11,10 +17,15 @@
     "@promistream/propagate-abort": "^0.1.6",
     "@promistream/propagate-peek": "^0.1.1",
     "@validatem/core": "^0.3.11",
+    "@validatem/default-to": "^0.1.0",
     "@validatem/is-function": "^0.1.0",
     "@validatem/required": "^0.1.1",
     "@validatem/wrap-value-as-option": "^0.1.0",
-    "bluebird": "^3.5.4",
-    "result-buffer": "^0.1.0"
+    "match-value": "^1.1.0",
+    "push-buffer": "^1.1.0"
+  },
+  "devDependencies": {
+    "@promistream/from-iterable": "^0.1.0",
+    "@promistream/pipe": "^0.1.6"
   }
 }

pnpm-lock.yaml

@@ -0,0 +1,699 @@
+lockfileVersion: '6.0'
+
+settings:
+  autoInstallPeers: true
+  excludeLinksFromLockfile: false
+
+dependencies:
+  '@promistream/is-aborted':
+    specifier: ^0.1.1
+    version: 0.1.1
+  '@promistream/is-end-of-stream':
+    specifier: ^0.1.1
+    version: 0.1.1
+  '@promistream/propagate-abort':
+    specifier: ^0.1.6
+    version: 0.1.7
+  '@promistream/propagate-peek':
+    specifier: ^0.1.1
+    version: 0.1.1
+  '@validatem/core':
+    specifier: ^0.3.11
+    version: 0.3.17
+  '@validatem/default-to':
+    specifier: ^0.1.0
+    version: 0.1.0
+  '@validatem/is-function':
+    specifier: ^0.1.0
+    version: 0.1.0
+  '@validatem/required':
+    specifier: ^0.1.1
+    version: 0.1.1
+  '@validatem/wrap-value-as-option':
+    specifier: ^0.1.0
+    version: 0.1.0
+  match-value:
+    specifier: ^1.1.0
+    version: 1.1.0
+  push-buffer:
+    specifier: ^1.1.0
+    version: 1.1.0
+
+devDependencies:
+  '@promistream/from-iterable':
+    specifier: ^0.1.0
+    version: 0.1.0
+  '@promistream/pipe':
+    specifier: ^0.1.6
+    version: 0.1.6
+
+packages:
+
+  /@joepie91/promise-defer@1.0.1:
+    resolution: {integrity: sha512-yjDrKMpO155Ajmk+r3RG4WNGbrwd4Mj8UHqJtBSoIL9usT6cC0jhy1yn7dzJiKmYFxvCvgxDbjcWNFNCwQ9UUw==}
+    dev: false
+
+  /@joepie91/unreachable@1.0.0:
+    resolution: {integrity: sha512-vZRJ5UDq4mqP1vgSrcOLD3aIfS/nzwsvGFOOHv5sj5fa1Ss0dT1xnIzrXKLD9pu5EcUvF3K6n6jdaMW8uXpNEQ==}
+    dev: true
+
+  /@promistream/aborted@0.1.2:
+    resolution: {integrity: sha512-rLQgZTFr0r7yWtDbqA8zT5F4TKDiOiyowlAxSKiSY4XM+XVYeNq7k9SXIxVhLczjKh1Cv0nlvvZ7cZ41UjZPwQ==}
+    dependencies:
+      default-value: 1.0.0
+      error-chain: 0.1.3
+    dev: true
+
+  /@promistream/end-of-stream@0.1.2:
+    resolution: {integrity: sha512-rOeAIkcVZW6oYox2Jc1z/00iLVx0w0cIlcD/TbR798Qg5M5/nhErtjSG08QAtuaPSxAFKNl5ipAD8HHGV5esJw==}
+    dependencies:
+      default-value: 1.0.0
+      error-chain: 0.1.3
+    dev: true
+
+  /@promistream/from-iterable@0.1.0:
+    resolution: {integrity: sha512-P4wehrvRZu/QTkN0fBNvItZD1jwchv1p76q4yirXIDQclA08mN2QMR6heFLMSBYD2NPRoX+3smZCsRfJgfcmcA==}
+    dependencies:
+      '@promistream/end-of-stream': 0.1.2
+      '@promistream/simple-source': 0.1.4
+      '@validatem/core': 0.3.17
+      '@validatem/error': 1.1.0
+      '@validatem/required': 0.1.1
+    dev: true
+
+  /@promistream/is-aborted@0.1.1:
+    resolution: {integrity: sha512-2AYo+MFu0wNKXCEDHexaFWoESiUzHfGZgWpazbdA6OyU/AJsHRfMwKzE7awmgi1u0T43k5nLwwJXIiTypajSiw==}
+    dev: false
+
+  /@promistream/is-end-of-stream@0.1.1:
+    resolution: {integrity: sha512-GZn7W0wrUen7kkgWCcwFFgr0g/ftfuddnuK/Tp0MLWCCJA4hyAboglCZP0JzEJdi34gClEP8lCfDwGekw18LHg==}
+
+  /@promistream/no-value@1.0.0:
+    resolution: {integrity: sha512-PY/1gj60YKRRpzLY0UyM/b1OzXZS+5lvrVMrU3BzjTDv31P0EaCAb2X39DKQAfoX0ygiXOHewCaLVX1/+IZsTA==}
+    dev: false
+
+  /@promistream/pipe@0.1.6:
+    resolution: {integrity: sha512-B/n4WPJ/goXALCWJYgZV0M/lLMIF5OuaqvxezJq/lcSCo9RuV82wmdJBZd+IEmc6Ykn/EYTFtUHCnRjkl56+3w==}
+    dependencies:
+      '@validatem/allow-extra-properties': 0.1.0
+      '@validatem/anything': 0.1.0
+      '@validatem/array-of': 0.1.3
+      '@validatem/core': 0.3.17
+      '@validatem/error': 1.1.0
+      '@validatem/remove-nullish-items': 0.1.0
+      '@validatem/required': 0.1.1
+      '@validatem/wrap-error': 0.3.0
+    dev: true
+
+  /@promistream/propagate-abort@0.1.7:
+    resolution: {integrity: sha512-BR0XZMirAjO1IRpyTtOG4n0fGuuvRGJsO8Hmn4HOJXhi10onX3GlfCNZN2tqe4Mq/5fEDgRNGNUHjCY7naDYUA==}
+    dev: false
+
+  /@promistream/propagate-peek@0.1.1:
+    resolution: {integrity: sha512-4xfkSmtPQzlvL4+KCquPHX7sPXiAACGJac/y7fB3Sv6ZKXAT/cjTfms1nEjlDGn1nroN0MzReBza2HnpF59deg==}
+    dev: false
+
+  /@promistream/simple-source@0.1.4:
+    resolution: {integrity: sha512-dMAVpcX2WC40IVMA6zvSAcgwxXjDVj4QIQzOyDdXgOnKjCRnGPhtUvK2ST5Jiw8/lVpEYx0bviqgezttU3IaFg==}
+    dependencies:
+      '@joepie91/unreachable': 1.0.0
+      '@promistream/aborted': 0.1.2
+      '@promistream/end-of-stream': 0.1.2
+      '@promistream/is-end-of-stream': 0.1.1
+      '@validatem/core': 0.3.17
+      '@validatem/is-function': 0.1.0
+      '@validatem/required': 0.1.1
+      '@validatem/wrap-value-as-option': 0.1.0
+      bluebird: 3.7.2
+      error-chain: 0.1.3
+    dev: true
+
+  /@validatem/allow-extra-properties@0.1.0:
+    resolution: {integrity: sha512-9jihpYxw1vp4FdjnbN0bTVZMLYv//9OjFNTsVLG5OV4xHESwtgkgQEF5/N5rY1iBwoH/pcKuRl44MBZ8eMdrKw==}
+    dependencies:
+      '@validatem/with-context': 0.1.2
+    dev: true
+
+  /@validatem/annotate-errors@0.1.2:
+    resolution: {integrity: sha512-EuX7pzdYI/YpTmZcgdPG481Oi3elAg8JWh/LYXuE1h6MaZk3A8eP5DD33/l7EoKzrysn6y8nCsqNa1ngei562w==}
+    dependencies:
+      '@validatem/match-validation-error': 0.1.0
+
+  /@validatem/any-property@0.1.3:
+    resolution: {integrity: sha512-jYWxif5ff9pccu7566LIQ/4+snlApXEJUimBywzAriBgS3r4eDBbz3oZFHuiPmhxNK/NNof5YUS+L6Sk3zaMfg==}
+    dependencies:
+      '@validatem/annotate-errors': 0.1.2
+      '@validatem/combinator': 0.1.2
+      '@validatem/error': 1.1.0
+      '@validatem/validation-result': 0.1.2
+      '@validatem/virtual-property': 0.1.0
+      default-value: 1.0.0
+
+  /@validatem/anything@0.1.0:
+    resolution: {integrity: sha512-VJcygPpLw2fAhh29m2qL1AybHY7Ewl7xpvVgNIZpqUwMsSZXWSmzmbZhqE4Sr6Wy2n6FbZVzVoUFREO589SPcQ==}
+    dev: true
+
+  /@validatem/array-of@0.1.3:
+    resolution: {integrity: sha512-awaNPfmhv91tI3916WTwGaUq4mFpqJbNXiBFdeTzVp4S2KmczelVwIpZ6gyzvfXFOlQTVtq65RjD7C/G8u4n0Q==}
+    dependencies:
+      '@validatem/annotate-errors': 0.1.2
+      '@validatem/combinator': 0.1.2
+      '@validatem/is-array': 0.1.1
+      '@validatem/validation-result': 0.1.2
+      '@validatem/with-context': 0.1.2
+    dev: true
+
+  /@validatem/combinator@0.1.2:
+    resolution: {integrity: sha512-vE8t1tNXknmN62FlN6LxQmA2c6TwVKZ+fl/Wit3H2unFdOhu7SZj2kRPGjAXdK/ARh/3svYfUBeD75pea0j1Sw==}
+
+  /@validatem/core@0.3.17:
+    resolution: {integrity: sha512-VahE9TAKpaU13BcVQI/Dc9j/xsm/BgloRM0v1HjOMpoJ16tOkKQkUdOgiDCG4zmEek1bG3v9Zu4lS1lubgjLMw==}
+    dependencies:
+      '@validatem/annotate-errors': 0.1.2
+      '@validatem/any-property': 0.1.3
+      '@validatem/error': 1.1.0
+      '@validatem/match-validation-error': 0.1.0
+      '@validatem/match-versioned-special': 0.1.1
+      '@validatem/match-virtual-property': 0.1.0
+      '@validatem/normalize-rules': 0.1.3
+      '@validatem/required': 0.1.1
+      '@validatem/validation-result': 0.1.2
+      '@validatem/virtual-property': 0.1.0
+      as-expression: 1.0.0
+      assure-array: 1.0.0
+      create-error: 0.3.1
+      default-value: 1.0.0
+      execall: 2.0.0
+      flatten: 1.0.3
+      indent-string: 4.0.0
+      is-arguments: 1.1.1
+      supports-color: 7.2.0
+      syncpipe: 1.0.0
+
+  /@validatem/core@0.5.0:
+    resolution: {integrity: sha512-hLEdoRFRvFGUqHFFK0eR8r7sTJaqQjzB81FVMp86esZJiBrblnWhpZtzVouguoaAaKFX9oiWI3nAQc73xYrTJg==}
+    dependencies:
+      '@validatem/annotate-errors': 0.1.2
+      '@validatem/any-property': 0.1.3
+      '@validatem/error': 1.1.0
+      '@validatem/match-validation-error': 0.1.0
+      '@validatem/match-versioned-special': 0.1.1
+      '@validatem/match-virtual-property': 0.1.0
+      '@validatem/normalize-rules': 0.1.3
+      '@validatem/required': 0.1.1
+      '@validatem/validation-result': 0.1.2
+      '@validatem/virtual-property': 0.1.0
+      as-expression: 1.0.0
+      assure-array: 1.0.0
+      create-error: 0.3.1
+      default-value: 1.0.0
+      execall: 2.0.0
+      indent-string: 4.0.0
+      is-arguments: 1.1.1
+      supports-color: 7.2.0
+      syncpipe: 1.0.0
+    dev: false
+
+  /@validatem/default-to@0.1.0:
+    resolution: {integrity: sha512-UE/mJ6ZcHFlBLUhX75PQHDRYf80GFFhB+vZfIcsEWduh7Nm6lTMDnCPj4MI+jd9E/A7HV5D1yCZhaRSwoWo4vg==}
+    dependencies:
+      is-callable: 1.2.7
+
+  /@validatem/dynamic@0.1.2:
+    resolution: {integrity: sha512-TNZMUO9McL2kFYdLWTYSD+zxxZ9fbK9Si+3X5u/JngOWAq7PFxbU7o2oxREkwiSIZi5cjBCK/hvrZMWyl+FWEA==}
+    dependencies:
+      '@validatem/combinator': 0.1.2
+
+  /@validatem/either@0.1.9:
+    resolution: {integrity: sha512-cUqlRjy02qDcZ166/D6duk8lrtqrHynHuSakU0TvMGMBiLzjWpMJ+3beAWHe+kILB5/dlXVyc68ZIjSNhBi8Kw==}
+    dependencies:
+      '@validatem/combinator': 0.1.2
+      '@validatem/error': 1.1.0
+      '@validatem/match-validation-error': 0.1.0
+      '@validatem/validation-result': 0.1.2
+      flatten: 1.0.3
+
+  /@validatem/error@1.1.0:
+    resolution: {integrity: sha512-gZJEoZq1COi/8/5v0fVKQ9uX54x5lb5HbV7mzIOhY6dqjmLNfxdQmpECZPQrCAOpcRkRMJ7zaFhq4UTslpY9yA==}
+
+  /@validatem/forbidden@0.1.0:
+    resolution: {integrity: sha512-5GpgXt33z15oXZJwd+BKzEcX56YrU1Ysqe3NM20L9OzuSCJYbWU6xR6mMHkYVfF3TDLfkC8csOiKG2UnduCLhw==}
+    dependencies:
+      '@validatem/error': 1.1.0
+    dev: true
+
+  /@validatem/has-shape@0.1.8:
+    resolution: {integrity: sha512-x2i8toW1uraFF2Vl6WBl4CScbBeg5alrtoCKMyXbJkHf2B5QxL/ftUh2RQRcBzx6U0i7KUb8vdShcWAa+fehRQ==}
+    dependencies:
+      '@validatem/annotate-errors': 0.1.2
+      '@validatem/combinator': 0.1.2
+      '@validatem/error': 1.1.0
+      '@validatem/validation-result': 0.1.2
+      array-union: 2.1.0
+      as-expression: 1.0.0
+      assure-array: 1.0.0
+      default-value: 1.0.0
+      flatten: 1.0.3
+
+  /@validatem/is-array@0.1.1:
+    resolution: {integrity: sha512-XD3C+Nqfpnbb4oO//Ufodzvui7SsCIW/stxZ39dP/fyRsBHrdERinkFATH5HepegtDlWMQswm5m1XFRbQiP2oQ==}
+    dependencies:
+      '@validatem/error': 1.1.0
+    dev: true
+
+  /@validatem/is-boolean@0.1.1:
+    resolution: {integrity: sha512-eIFq+mCBEDgAp4ezaPn1mbVZd2H+IkQG3CcEFnLSlqfg1XKY5uv8AOI08+UqeWS+C7AIFk3rEqRg63+OuPCpsg==}
+    dependencies:
+      '@validatem/error': 1.1.0
+      is-boolean-object: 1.1.2
+
+  /@validatem/is-function@0.1.0:
+    resolution: {integrity: sha512-UtVrwTGhaIdIJ0mPG5XkAmYZUeWgRoMP1G9ZEHbKvAZJ4+SXf/prC0jPgE0pw+sPjdQG4hblsXSfo/9Bf3PGdQ==}
+    dependencies:
+      '@validatem/error': 1.1.0
+      is-callable: 1.2.7
+
+  /@validatem/is-integer@0.1.0:
+    resolution: {integrity: sha512-sSp66uxfirIFMqro64DAdfM+UKo+IICmHdy/x3ZJXUM9F4byz/GyFmhR4wfcQswywwF1fqKw9458GE38fozjOQ==}
+    dependencies:
+      '@validatem/error': 1.1.0
+      '@validatem/is-number': 0.1.3
+    dev: false
+
+  /@validatem/is-number@0.1.3:
+    resolution: {integrity: sha512-GjnbKYfYa0cTCJmsr5OUbylxTKHHZ6FDtJixWl+lEuXzeELDoYRp2UAjzfjTXJ9g2BumESqI/t0hap5rw5tEyQ==}
+    dependencies:
+      '@validatem/error': 1.1.0
+      is-number-object: 1.0.7
+    dev: false
+
+  /@validatem/is-plain-object@0.1.1:
+    resolution: {integrity: sha512-aNGbNIbKRpYI0lRBczlTBbiA+nqN52ADAASdySKg2/QeSCVtYS4uOIeCNIJRAgXe/5sUnLTuL4pgq628uAl7Kw==}
+    dependencies:
+      '@validatem/error': 1.1.0
+      is-plain-obj: 2.1.0
+
+  /@validatem/is-string@0.1.1:
+    resolution: {integrity: sha512-iyRVYRPgRt2ZlWyc7pzN1WkO6apzE8at39XQa4WUr8qRPfJn12V4khS9MumWbZs8N2qqajrxMigB2LJUCKOCRg==}
+    dependencies:
+      '@validatem/error': 1.1.0
+      is-string: 1.0.7
+    dev: true
+
+  /@validatem/match-special@0.1.0:
+    resolution: {integrity: sha512-TFiq9Wk/1Hoja4PK85WwNYnwBXk3+Lgoj59ZIMxm2an1qmNYp8j+BnSvkKBflba451yIn6V1laU9NJf+/NYZgw==}
+
+  /@validatem/match-validation-error@0.1.0:
+    resolution: {integrity: sha512-6akGTk7DdulOreyqDiGdikwRSixQz/AlvARSX18dcWaTFc79KxCLouL2hyoFcor9IIUhu5RTY4/i756y4T1yxA==}
+    dependencies:
+      '@validatem/match-versioned-special': 0.1.1
+
+  /@validatem/match-versioned-special@0.1.1:
+    resolution: {integrity: sha512-RRNeFSgzqSo0sKck/92a+yC9zKdt+DD6y4TK70+VDKVppdWsb8YzC/FBTucseN1OYrr1KcBPKNVZePg1NTROYw==}
+
+  /@validatem/match-virtual-property@0.1.0:
+    resolution: {integrity: sha512-ssd3coFgwbLuqvZftLZTy3eHN0TFST8oTS2XTViQdXJPXVoJmwEKBpFhXgwnb5Ly1CE037R/KWpjhd1TP/56kQ==}
+
+  /@validatem/normalize-rules@0.1.3:
+    resolution: {integrity: sha512-HHPceAP2ce9NWymIZrgLCTzpdwXNRBCCB5H6ZPc5ggOrbmh4STpT83fLazleHtvYNlqgXZ4GjQOvCwrjaM+qEA==}
+    dependencies:
+      '@validatem/has-shape': 0.1.8
+      '@validatem/is-plain-object': 0.1.1
+      '@validatem/match-special': 0.1.0
+      assure-array: 1.0.0
+      default-value: 1.0.0
+      flatten: 1.0.3
+      is-plain-obj: 2.1.0
+
+  /@validatem/one-of@0.1.1:
+    resolution: {integrity: sha512-lIgxnkNRouPx5Ydddi8OaAxmzp1ox44OJnrJPRrJkU4ccz9Yb7GSJ+wQJNVkAZCar+DGTDMoXoy51NwDnsf4sw==}
+    dependencies:
+      '@validatem/error': 1.1.0
+
+  /@validatem/remove-nullish-items@0.1.0:
+    resolution: {integrity: sha512-cs4YSF47TA/gHnV5muSUUqGi5PwybP5ztu5SYnPKxQVTyubvcbrFat51nOvJ2PmUasyrIccoYMmATiviXkTi6g==}
+    dev: true
+
+  /@validatem/required@0.1.1:
+    resolution: {integrity: sha512-vI4NzLfay4RFAzp7xyU34PHb8sAo6w/3frrNh1EY9Xjnw2zxjY5oaxwmbFP1jVevBE6QQEnKogtzUHz/Zuvh6g==}
+
+  /@validatem/validation-result@0.1.2:
+    resolution: {integrity: sha512-okmP8JarIwIgfpaVcvZGuQ1yOsLKT3Egt49Ynz6h1MAeGsP/bGHXkkXtbiWOVsk5Tzku5vDVFSrFnF+5IEHKxw==}
+    dependencies:
+      default-value: 1.0.0
+
+  /@validatem/virtual-property@0.1.0:
+    resolution: {integrity: sha512-JUUvWtdqoSkOwlsl20oB3qFHYIL05a/TAfdY4AJcs55QeVTiX5iI1b8IoQW644sIWWooBuLv+XwoxjRsQFczlQ==}
+
+  /@validatem/with-context@0.1.2:
+    resolution: {integrity: sha512-noAWf4CsmU+BCz+KOg3GPq9+R9BQLWOQnOgWVfkYHFdLnnbLhl8w/ONdzvFzUYGHIZGKZwsWVCp+Kwz/tAfMnA==}
+    dependencies:
+      '@validatem/combinator': 0.1.2
+    dev: true
+
+  /@validatem/wrap-error@0.1.3:
+    resolution: {integrity: sha512-86ANJACPGbH8jD/C/tUTZNgQh9xCePUKq4wf5ZRcwOvtIDaZO98FI9cdoT2/zS1CzQCp3VWlwz16YT6FNjJJJA==}
+    dependencies:
+      '@validatem/combinator': 0.1.2
+      '@validatem/error': 1.1.0
+      '@validatem/match-validation-error': 0.1.0
+      '@validatem/validation-result': 0.1.2
+      as-expression: 1.0.0
+      default-value: 1.0.0
+      split-filter-n: 1.1.3
+    dev: true
+
+  /@validatem/wrap-error@0.3.0:
+    resolution: {integrity: sha512-km5v6F/Xm7j8W/tmCmht2BTzxMLSpBUJ5MdhJD7ABEut/fdO0tNca1u1imTnWCULCJcdDHbNtpSmDMvXFg3E7Q==}
+    dependencies:
+      '@validatem/combinator': 0.1.2
+      '@validatem/error': 1.1.0
+      '@validatem/match-validation-error': 0.1.0
+      '@validatem/validation-result': 0.1.2
+      as-expression: 1.0.0
+      default-value: 1.0.0
+      split-filter-n: 1.1.3
+    dev: true
+
+  /@validatem/wrap-value-as-option@0.1.0:
+    resolution: {integrity: sha512-gWDkfyU0DOsbinE9iqvRSJ+NxuynChyueJsC+AFm3EYbe8+s7V2gRs3qkJ4mq7hOlUbEh8tgCWQfZZvr+IdVFw==}
+    dependencies:
+      '@validatem/either': 0.1.9
+      '@validatem/is-plain-object': 0.1.1
+
+  /ansi-styles@3.2.1:
+    resolution: {integrity: sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==}
+    engines: {node: '>=4'}
+    dependencies:
+      color-convert: 1.9.3
+    dev: true
+
+  /array-union@2.1.0:
+    resolution: {integrity: sha512-HGyxoOTYUyCM6stUe6EJgnd4EoewAI7zMdfqO+kGjnlZmBDz/cR5pf8r/cR4Wq60sL/p0IkcjUEEPwS3GFrIyw==}
+    engines: {node: '>=8'}
+
+  /as-expression@1.0.0:
+    resolution: {integrity: sha512-Iqh4GxNUfxbJdGn6b7/XMzc8m1Dz2ZHouBQ9DDTzyMRO3VPPIAXeoY/sucRxxxXKbUtzwzWZSN6jPR3zfpYHHA==}
+
+  /assure-array@1.0.0:
+    resolution: {integrity: sha512-igvOvGYidAcJKr6YQIHzLivUpAdqUfi7MN0QfrEnFtifQvuw6D0W4oInrIVgTaefJ+QBVWAj8ZYuUGNnwq6Ydw==}
+
+  /bluebird@3.7.2:
+    resolution: {integrity: sha512-XpNj6GDQzdfW+r2Wnn7xiSAd7TM3jzkxGXBGTtWKuSXv1xUV+azxAm8jdWZN06QTQk+2N2XB9jRDkvbmQmcRtg==}
+    dev: true
+
+  /call-bind@1.0.7:
+    resolution: {integrity: sha512-GHTSNSYICQ7scH7sZ+M2rFopRoLh8t2bLSW6BbgrtLsahOIB5iyAVJf9GjWK3cYTDaMj4XdBpM1cA6pIS0Kv2w==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      es-define-property: 1.0.0
+      es-errors: 1.3.0
+      function-bind: 1.1.2
+      get-intrinsic: 1.2.4
+      set-function-length: 1.2.2
+
+  /capture-promise@1.0.0:
+    resolution: {integrity: sha512-40FXZr0YaUWw2q6T8DcUOIF885saJni87ZbAOXkwDB14nMl6M1vIYAKUs2BjoeMyqnv3PGqEcDskGUXvgNIbZw==}
+    dev: false
+
+  /chalk@2.4.2:
+    resolution: {integrity: sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==}
+    engines: {node: '>=4'}
+    dependencies:
+      ansi-styles: 3.2.1
+      escape-string-regexp: 1.0.5
+      supports-color: 5.5.0
+    dev: true
+
+  /clone-regexp@2.2.0:
+    resolution: {integrity: sha512-beMpP7BOtTipFuW8hrJvREQ2DrRu3BE7by0ZpibtfBA+qfHYvMGTc2Yb1JMYPKg/JUw0CHYvpg796aNTSW9z7Q==}
+    engines: {node: '>=6'}
+    dependencies:
+      is-regexp: 2.1.0
+
+  /color-convert@1.9.3:
+    resolution: {integrity: sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==}
+    dependencies:
+      color-name: 1.1.3
+    dev: true
+
+  /color-name@1.1.3:
+    resolution: {integrity: sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==}
+    dev: true
+
+  /create-error@0.3.1:
+    resolution: {integrity: sha512-n/Q4aSCtYuuDneEW5Q+nd0IIZwbwmX/oF6wKcDUhXGJNwhmp2WHEoWKz7X+/H7rBtjimInW7f0ceouxU0SmuzQ==}
+
+  /debug@4.3.5:
+    resolution: {integrity: sha512-pt0bNEmneDIvdL1Xsd9oDQ/wrQRkXDT4AUWlNZNPKvW5x/jyO9VFXkJUP07vQ2upmw5PlaITaPKc31jK13V+jg==}
+    engines: {node: '>=6.0'}
+    peerDependencies:
+      supports-color: '*'
+    peerDependenciesMeta:
+      supports-color:
+        optional: true
+    dependencies:
+      ms: 2.1.2
+    dev: false
+
+  /default-value@1.0.0:
+    resolution: {integrity: sha512-y6j7G55tgWG7nfjXUNy/WkTLGExiPEUlhGv0zqgqKdlOwJnDDy/dbk7yCozn4biAGIRnMI+9fyZ1V2fZ7tjp6Q==}
+    dependencies:
+      es6-promise-try: 0.0.1
+
+  /define-data-property@1.1.4:
+    resolution: {integrity: sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      es-define-property: 1.0.0
+      es-errors: 1.3.0
+      gopd: 1.0.1
+
+  /error-chain@0.1.3:
+    resolution: {integrity: sha512-Hx/Yd7w6ku+bTIGzPxdgKAoZSADCf4EnM9CEcIyr75vw/FH/wbZ23YnKKv7ZQB80F4s7ZSVJ/9UPXk03SQsACQ==}
+    dependencies:
+      '@validatem/allow-extra-properties': 0.1.0
+      '@validatem/core': 0.3.17
+      '@validatem/default-to': 0.1.0
+      '@validatem/dynamic': 0.1.2
+      '@validatem/error': 1.1.0
+      '@validatem/forbidden': 0.1.0
+      '@validatem/is-boolean': 0.1.1
+      '@validatem/is-function': 0.1.0
+      '@validatem/is-plain-object': 0.1.1
+      '@validatem/is-string': 0.1.1
+      '@validatem/one-of': 0.1.1
+      '@validatem/required': 0.1.1
+      '@validatem/wrap-error': 0.1.3
+      chalk: 2.4.2
+      fromentries: 1.3.2
+      is.object: 1.0.0
+      syncpipe: 1.0.0
+    dev: true
+
+  /es-define-property@1.0.0:
+    resolution: {integrity: sha512-jxayLKShrEqqzJ0eumQbVhTYQM27CfT1T35+gCgDFoL82JLsXqTJ76zv6A0YLOgEnLUMvLzsDsGIrl8NFpT2gQ==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      get-intrinsic: 1.2.4
+
+  /es-errors@1.3.0:
+    resolution: {integrity: sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==}
+    engines: {node: '>= 0.4'}
+
+  /es6-promise-try@0.0.1:
+    resolution: {integrity: sha512-T6f3cNyF8y+3uua2IDGpGmeoDe2w7PXGfPGS94TyLfQLPzYVvZUfM8dQuN4DuVXpelK4tg9F7zKzZHzNS2f2IQ==}
+
+  /escape-string-regexp@1.0.5:
+    resolution: {integrity: sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==}
+    engines: {node: '>=0.8.0'}
+    dev: true
+
+  /execall@2.0.0:
+    resolution: {integrity: sha512-0FU2hZ5Hh6iQnarpRtQurM/aAvp3RIbfvgLHrcqJYzhXyV2KFruhuChf9NC6waAhiUR7FFtlugkI4p7f2Fqlow==}
+    engines: {node: '>=8'}
+    dependencies:
+      clone-regexp: 2.2.0
+
+  /flatten@1.0.3:
+    resolution: {integrity: sha512-dVsPA/UwQ8+2uoFe5GHtiBMu48dWLTdsuEd7CKGlZlD78r1TTWBvDuFaFGKCo/ZfEr95Uk56vZoX86OsHkUeIg==}
+    deprecated: flatten is deprecated in favor of utility frameworks such as lodash.
+
+  /fromentries@1.3.2:
+    resolution: {integrity: sha512-cHEpEQHUg0f8XdtZCc2ZAhrHzKzT0MrFUTcvx+hfxYu7rGMDc5SKoXFh+n4YigxsHXRzc6OrCshdR1bWH6HHyg==}
+    dev: true
+
+  /function-bind@1.1.2:
+    resolution: {integrity: sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==}
+
+  /get-intrinsic@1.2.4:
+    resolution: {integrity: sha512-5uYhsJH8VJBTv7oslg4BznJYhDoRI6waYCxMmCdnTrcCrHA/fCFKoTFz2JKKE0HdDFUF7/oQuhzumXJK7paBRQ==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      es-errors: 1.3.0
+      function-bind: 1.1.2
+      has-proto: 1.0.3
+      has-symbols: 1.0.3
+      hasown: 2.0.2
+
+  /gopd@1.0.1:
+    resolution: {integrity: sha512-d65bNlIadxvpb/A2abVdlqKqV563juRnZ1Wtk6s1sIR8uNsXR70xqIzVqxVf1eTqDunwT2MkczEeaezCKTZhwA==}
+    dependencies:
+      get-intrinsic: 1.2.4
+
+  /has-flag@3.0.0:
+    resolution: {integrity: sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==}
+    engines: {node: '>=4'}
+    dev: true
+
+  /has-flag@4.0.0:
+    resolution: {integrity: sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==}
+    engines: {node: '>=8'}
+
+  /has-property-descriptors@1.0.2:
+    resolution: {integrity: sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg==}
+    dependencies:
+      es-define-property: 1.0.0
+
+  /has-proto@1.0.3:
+    resolution: {integrity: sha512-SJ1amZAJUiZS+PhsVLf5tGydlaVB8EdFpaSO4gmiUKUOxk8qzn5AIy4ZeJUmh22znIdk/uMAUT2pl3FxzVUH+Q==}
+    engines: {node: '>= 0.4'}
+
+  /has-symbols@1.0.3:
+    resolution: {integrity: sha512-l3LCuF6MgDNwTDKkdYGEihYjt5pRPbEg46rtlmnSPlUbgmB8LOIrKJbYYFBSbnPaJexMKtiPO8hmeRjRz2Td+A==}
+    engines: {node: '>= 0.4'}
+
+  /has-tostringtag@1.0.2:
+    resolution: {integrity: sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      has-symbols: 1.0.3
+
+  /hasown@2.0.2:
+    resolution: {integrity: sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      function-bind: 1.1.2
+
+  /indent-string@4.0.0:
+    resolution: {integrity: sha512-EdDDZu4A2OyIK7Lr/2zG+w5jmbuk1DVBnEwREQvBzspBJkCEbRa8GxU1lghYcaGJCnRWibjDXlq779X1/y5xwg==}
+    engines: {node: '>=8'}
+
+  /is-arguments@1.1.1:
+    resolution: {integrity: sha512-8Q7EARjzEnKpt/PCD7e1cgUS0a6X8u5tdSiMqXhojOdoV9TsMsiO+9VLC5vAmO8N7/GmXn7yjR8qnA6bVAEzfA==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      call-bind: 1.0.7
+      has-tostringtag: 1.0.2
+
+  /is-boolean-object@1.1.2:
+    resolution: {integrity: sha512-gDYaKHJmnj4aWxyj6YHyXVpdQawtVLHU5cb+eztPGczf6cjuTdwve5ZIEfgXqH4e57An1D1AKf8CZ3kYrQRqYA==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      call-bind: 1.0.7
+      has-tostringtag: 1.0.2
+
+  /is-callable@1.2.7:
+    resolution: {integrity: sha512-1BC0BVFhS/p0qtw6enp8e+8OD0UrK0oFLztSjNzhcKA3WDuJxxAPXzPuPtKkjEY9UUoEWlX/8fgKeu2S8i9JTA==}
+    engines: {node: '>= 0.4'}
+
+  /is-number-object@1.0.7:
+    resolution: {integrity: sha512-k1U0IRzLMo7ZlYIfzRu23Oh6MiIFasgpb9X76eqfFZAqwH44UI4KTBvBYIZ1dSL9ZzChTB9ShHfLkR4pdW5krQ==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      has-tostringtag: 1.0.2
+    dev: false
+
+  /is-plain-obj@2.1.0:
+    resolution: {integrity: sha512-YWnfyRwxL/+SsrWYfOpUtz5b3YD+nyfkHvjbcanzk8zgyO4ASD67uVMRt8k5bM4lLMDnXfriRhOpemw+NfT1eA==}
+    engines: {node: '>=8'}
+
+  /is-regexp@2.1.0:
+    resolution: {integrity: sha512-OZ4IlER3zmRIoB9AqNhEggVxqIH4ofDns5nRrPS6yQxXE1TPCUpFznBfRQmQa8uC+pXqjMnukiJBxCisIxiLGA==}
+    engines: {node: '>=6'}
+
+  /is-string@1.0.7:
+    resolution: {integrity: sha512-tE2UXzivje6ofPW7l23cjDOMa09gb7xlAqG6jG5ej6uPV32TlWP3NKPigtaGeHNu9fohccRYvIiZMfOOnOYUtg==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      has-tostringtag: 1.0.2
+    dev: true
+
+  /is.object@1.0.0:
+    resolution: {integrity: sha512-BdDP6tLXkf0nrCnksLobALJxkt2hmrVL6ge1oRuzGU4Lb9NpreEbhhuCcY6HMzx/qo3Dff9DJ3jf0x9+U0bNMQ==}
+    engines: {node: '>=6.1'}
+    dev: true
+
+  /match-value@1.1.0:
+    resolution: {integrity: sha512-NOvpobcmkX+l9Eb6r2s3BkR1g1ZwzExDFdXA9d6p1r1O1olLbo88KuzMiBmg43xSpodfm7I6Hqlx2OoySquEgg==}
+    dev: false
+
+  /ms@2.1.2:
+    resolution: {integrity: sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==}
+    dev: false
+
+  /push-buffer@1.1.0:
+    resolution: {integrity: sha512-DWTNfYfsoNbMHmT6dBJ7jfUufRX1Osz1GlEPKryimDbqx8u2QG/PWVQBjLZYnzh3iV3V3MX8wqMyc9GcVCN0wA==}
+    dependencies:
+      '@joepie91/promise-defer': 1.0.1
+      '@promistream/no-value': 1.0.0
+      '@validatem/core': 0.5.0
+      '@validatem/default-to': 0.1.0
+      '@validatem/dynamic': 0.1.2
+      '@validatem/is-boolean': 0.1.1
+      '@validatem/is-function': 0.1.0
+      '@validatem/is-integer': 0.1.0
+      '@validatem/one-of': 0.1.1
+      '@validatem/required': 0.1.1
+      assure-array: 1.0.0
+      capture-promise: 1.0.0
+      debug: 4.3.5
+      single-concurrent: 1.0.0
+    transitivePeerDependencies:
+      - supports-color
+    dev: false
+
+  /set-function-length@1.2.2:
+    resolution: {integrity: sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      define-data-property: 1.1.4
+      es-errors: 1.3.0
+      function-bind: 1.1.2
+      get-intrinsic: 1.2.4
+      gopd: 1.0.1
+      has-property-descriptors: 1.0.2
+
+  /single-concurrent@1.0.0:
+    resolution: {integrity: sha512-lYx5vhQB1jhpVnS11rAZLTDId3E3cJFCteOvl6tsXmRPm1hfCQGFXFAgP12gUQJ4MRh3Cvt8eXwmnE8RIimzGw==}
+    dependencies:
+      '@validatem/core': 0.5.0
+      '@validatem/is-function': 0.1.0
+      '@validatem/required': 0.1.1
+      capture-promise: 1.0.0
+      debug: 4.3.5
+    transitivePeerDependencies:
+      - supports-color
+    dev: false
+
+  /split-filter-n@1.1.3:
+    resolution: {integrity: sha512-EU0EjvBI/mYBQMSAHq+ua/YNCuThuDjbU5h036k01+xieFW1aNvLNKb90xLihXIz5xJQX4VkEKan4LjSIyv7lg==}
+    dev: true
+
+  /supports-color@5.5.0:
+    resolution: {integrity: sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==}
+    engines: {node: '>=4'}
+    dependencies:
+      has-flag: 3.0.0
+    dev: true
+
+  /supports-color@7.2.0:
+    resolution: {integrity: sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==}
+    engines: {node: '>=8'}
+    dependencies:
+      has-flag: 4.0.0
+
+  /syncpipe@1.0.0:
+    resolution: {integrity: sha512-cdiAFTnFJRvUaNPDc2n9CqoFvtIL3+JUMJZrC3kA3FzpugHOqu0TvkgNwmnxPZ5/WjAzMcfMS3xm+AO7rg/j/w==}
+    dependencies:
+      assure-array: 1.0.0