cdk-ecr-deployment 2.5.6 → 2.5.22

package/node_modules/@types/cacheable-request/node_modules/@types/node/assert.d.ts

@@ -1,7 +1,7 @@
 /**
- * The `assert` module provides a set of assertion functions for verifying
+ * The `node:assert` module provides a set of assertion functions for verifying
  * invariants.
- * @see [source](https://github.com/nodejs/node/blob/v17.0.0/lib/assert.js)
+ * @see [source](https://github.com/nodejs/node/blob/v20.2.0/lib/assert.js)
  */
 declare module 'assert' {
     /**
@@ -12,14 +12,28 @@ declare module 'assert' {
     function assert(value: unknown, message?: string | Error): asserts value;
     namespace assert {
         /**
-         * Indicates the failure of an assertion. All errors thrown by the `assert` module
-         * will be instances of the `AssertionError` class.
+         * Indicates the failure of an assertion. All errors thrown by the `node:assert`module will be instances of the `AssertionError` class.
          */
         class AssertionError extends Error {
+            /**
+             * Set to the `actual` argument for methods such as {@link assert.strictEqual()}.
+             */
             actual: unknown;
+            /**
+             * Set to the `expected` argument for methods such as {@link assert.strictEqual()}.
+             */
             expected: unknown;
+            /**
+             * Set to the passed in operator value.
+             */
             operator: string;
+            /**
+             * Indicates if the message was auto-generated (`true`) or not.
+             */
             generatedMessage: boolean;
+            /**
+             * Value is always `ERR_ASSERTION` to show that the error is an assertion error.
+             */
             code: 'ERR_ASSERTION';
             constructor(options?: {
                 /** If provided, the error message is set to this value. */
@@ -36,9 +50,10 @@ declare module 'assert' {
             });
         }
         /**
-         * This feature is currently experimental and behavior might still change.
+         * This feature is deprecated and will be removed in a future version.
+         * Please consider using alternatives such as the `mock` helper function.
          * @since v14.2.0, v12.19.0
-         * @experimental
+         * @deprecated Deprecated
          */
         class CallTracker {
             /**
@@ -47,7 +62,7 @@ declare module 'assert' {
              * error.
              *
              * ```js
-             * import assert from 'assert';
+             * import assert from 'node:assert';
              *
              * // Creates call tracker.
              * const tracker = new assert.CallTracker();
@@ -65,26 +80,44 @@ declare module 'assert' {
              */
             calls(exact?: number): () => void;
             calls<Func extends (...args: any[]) => any>(fn?: Func, exact?: number): Func;
+            /**
+             * Example:
+             *
+             * ```js
+             * import assert from 'node:assert';
+             *
+             * const tracker = new assert.CallTracker();
+             *
+             * function func() {}
+             * const callsfunc = tracker.calls(func);
+             * callsfunc(1, 2, 3);
+             *
+             * assert.deepStrictEqual(tracker.getCalls(callsfunc),
+             *                        [{ thisArg: undefined, arguments: [1, 2, 3] }]);
+             * ```
+             * @since v18.8.0, v16.18.0
+             * @param fn
+             * @return An Array with all the calls to a tracked function.
+             */
+            getCalls(fn: Function): CallTrackerCall[];
             /**
              * The arrays contains information about the expected and actual number of calls of
              * the functions that have not been called the expected number of times.
              *
              * ```js
-             * import assert from 'assert';
+             * import assert from 'node:assert';
              *
              * // Creates call tracker.
              * const tracker = new assert.CallTracker();
              *
              * function func() {}
              *
-             * function foo() {}
-             *
              * // Returns a function that wraps func() that must be called exact times
              * // before tracker.verify().
              * const callsfunc = tracker.calls(func, 2);
              *
              * // Returns an array containing information on callsfunc()
-             * tracker.report();
+             * console.log(tracker.report());
              * // [
              * //  {
              * //    message: 'Expected the func function to be executed 2 time(s) but was
@@ -97,15 +130,39 @@ declare module 'assert' {
              * // ]
              * ```
              * @since v14.2.0, v12.19.0
-             * @return of objects containing information about the wrapper functions returned by `calls`.
+             * @return An Array of objects containing information about the wrapper functions returned by `calls`.
              */
             report(): CallTrackerReportInformation[];
+            /**
+             * Reset calls of the call tracker.
+             * If a tracked function is passed as an argument, the calls will be reset for it.
+             * If no arguments are passed, all tracked functions will be reset.
+             *
+             * ```js
+             * import assert from 'node:assert';
+             *
+             * const tracker = new assert.CallTracker();
+             *
+             * function func() {}
+             * const callsfunc = tracker.calls(func);
+             *
+             * callsfunc();
+             * // Tracker was called once
+             * assert.strictEqual(tracker.getCalls(callsfunc).length, 1);
+             *
+             * tracker.reset(callsfunc);
+             * assert.strictEqual(tracker.getCalls(callsfunc).length, 0);
+             * ```
+             * @since v18.8.0, v16.18.0
+             * @param fn a tracked function to reset.
+             */
+            reset(fn?: Function): void;
             /**
              * Iterates through the list of functions passed to `tracker.calls()` and will throw an error for functions that
              * have not been called the expected number of times.
              *
              * ```js
-             * import assert from 'assert';
+             * import assert from 'node:assert';
              *
              * // Creates call tracker.
              * const tracker = new assert.CallTracker();
@@ -125,6 +182,10 @@ declare module 'assert' {
              */
             verify(): void;
         }
+        interface CallTrackerCall {
+            thisArg: object;
+            arguments: unknown[];
+        }
         interface CallTrackerReportInformation {
             message: string;
             /** The actual number of times the function was called. */
@@ -143,7 +204,7 @@ declare module 'assert' {
          * it will be thrown instead of the `AssertionError`.
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * assert.fail();
          * // AssertionError [ERR_ASSERTION]: Failed
@@ -181,7 +242,7 @@ declare module 'assert' {
          * thrown in a file! See below for further details.
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * assert.ok(true);
          * // OK
@@ -216,7 +277,7 @@ declare module 'assert' {
          * ```
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * // Using `assert()` works the same:
          * assert(0);
@@ -237,11 +298,11 @@ declare module 'assert' {
          * > Stability: 3 - Legacy: Use {@link strictEqual} instead.
          *
          * Tests shallow, coercive equality between the `actual` and `expected` parameters
-         * using the [Abstract Equality Comparison](https://tc39.github.io/ecma262/#sec-abstract-equality-comparison) ( `==` ). `NaN` is special handled
-         * and treated as being identical in case both sides are `NaN`.
+         * using the [`==` operator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Equality). `NaN` is specially handled
+         * and treated as being identical if both sides are `NaN`.
          *
          * ```js
-         * import assert from 'assert';
+         * import assert from 'node:assert';
          *
          * assert.equal(1, 1);
          * // OK, 1 == 1
@@ -270,12 +331,11 @@ declare module 'assert' {
          *
          * > Stability: 3 - Legacy: Use {@link notStrictEqual} instead.
          *
-         * Tests shallow, coercive inequality with the [Abstract Equality Comparison](https://tc39.github.io/ecma262/#sec-abstract-equality-comparison)(`!=` ). `NaN` is special handled and treated as
-         * being identical in case both
-         * sides are `NaN`.
+         * Tests shallow, coercive inequality with the [`!=` operator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Inequality). `NaN` is
+         * specially handled and treated as being identical if both sides are `NaN`.
          *
          * ```js
-         * import assert from 'assert';
+         * import assert from 'node:assert';
          *
          * assert.notEqual(1, 2);
          * // OK
@@ -322,24 +382,24 @@ declare module 'assert' {
          * Tests for any deep inequality. Opposite of {@link deepEqual}.
          *
          * ```js
-         * import assert from 'assert';
+         * import assert from 'node:assert';
          *
          * const obj1 = {
          *   a: {
-         *     b: 1
-         *   }
+         *     b: 1,
+         *   },
          * };
          * const obj2 = {
          *   a: {
-         *     b: 2
-         *   }
+         *     b: 2,
+         *   },
          * };
          * const obj3 = {
          *   a: {
-         *     b: 1
-         *   }
+         *     b: 1,
+         *   },
          * };
-         * const obj4 = Object.create(obj1);
+         * const obj4 = { __proto__: obj1 };
          *
          * assert.notDeepEqual(obj1, obj1);
          * // AssertionError: { a: { b: 1 } } notDeepEqual { a: { b: 1 } }
@@ -362,10 +422,10 @@ declare module 'assert' {
         function notDeepEqual(actual: unknown, expected: unknown, message?: string | Error): void;
         /**
          * Tests strict equality between the `actual` and `expected` parameters as
-         * determined by the [SameValue Comparison](https://tc39.github.io/ecma262/#sec-samevalue).
+         * determined by [`Object.is()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/is).
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * assert.strictEqual(1, 2);
          * // AssertionError [ERR_ASSERTION]: Expected inputs to be strictly equal:
@@ -400,10 +460,10 @@ declare module 'assert' {
         function strictEqual<T>(actual: unknown, expected: T, message?: string | Error): asserts actual is T;
         /**
          * Tests strict inequality between the `actual` and `expected` parameters as
-         * determined by the [SameValue Comparison](https://tc39.github.io/ecma262/#sec-samevalue).
+         * determined by [`Object.is()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/is).
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * assert.notStrictEqual(1, 2);
          * // OK
@@ -434,7 +494,7 @@ declare module 'assert' {
          * Tests for deep strict inequality. Opposite of {@link deepStrictEqual}.
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * assert.notDeepStrictEqual({ a: 1 }, { a: '1' });
          * // OK
@@ -465,14 +525,14 @@ declare module 'assert' {
          * Custom validation object/error instance:
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * const err = new TypeError('Wrong value');
          * err.code = 404;
          * err.foo = 'bar';
          * err.info = {
          *   nested: true,
-         *   baz: 'text'
+         *   baz: 'text',
          * };
          * err.reg = /abc/i;
          *
@@ -485,16 +545,16 @@ declare module 'assert' {
          *     message: 'Wrong value',
          *     info: {
          *       nested: true,
-         *       baz: 'text'
-         *     }
+         *       baz: 'text',
+         *     },
          *     // Only properties on the validation object will be tested for.
          *     // Using nested objects requires all properties to be present. Otherwise
          *     // the validation is going to fail.
-         *   }
+         *   },
          * );
          *
          * // Using regular expressions to validate error properties:
-         * throws(
+         * assert.throws(
          *   () => {
          *     throw err;
          *   },
@@ -508,17 +568,17 @@ declare module 'assert' {
          *     info: {
          *       nested: true,
          *       // It is not possible to use regular expressions for nested properties!
-         *       baz: 'text'
+         *       baz: 'text',
          *     },
          *     // The `reg` property contains a regular expression and only if the
          *     // validation object contains an identical regular expression, it is going
          *     // to pass.
-         *     reg: /abc/i
-         *   }
+         *     reg: /abc/i,
+         *   },
          * );
          *
          * // Fails due to the different `message` and `name` properties:
-         * throws(
+         * assert.throws(
          *   () => {
          *     const otherErr = new Error('Not found');
          *     // Copy all enumerable properties from `err` to `otherErr`.
@@ -529,20 +589,20 @@ declare module 'assert' {
          *   },
          *   // The error's `message` and `name` properties will also be checked when using
          *   // an error as validation object.
-         *   err
+         *   err,
          * );
          * ```
          *
          * Validate instanceof using constructor:
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * assert.throws(
          *   () => {
          *     throw new Error('Wrong value');
          *   },
-         *   Error
+         *   Error,
          * );
          * ```
          *
@@ -552,13 +612,13 @@ declare module 'assert' {
          * therefore also include the error name.
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * assert.throws(
          *   () => {
          *     throw new Error('Wrong value');
          *   },
-         *   /^Error: Wrong value$/
+         *   /^Error: Wrong value$/,
          * );
          * ```
          *
@@ -568,7 +628,7 @@ declare module 'assert' {
          * It will otherwise fail with an `AssertionError`.
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * assert.throws(
          *   () => {
@@ -584,7 +644,7 @@ declare module 'assert' {
          *     // possible.
          *     return true;
          *   },
-         *   'unexpected error'
+         *   'unexpected error',
          * );
          * ```
          *
@@ -594,7 +654,7 @@ declare module 'assert' {
          * a string as the second argument gets considered:
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * function throwingFirst() {
          *   throw new Error('First');
@@ -650,20 +710,20 @@ declare module 'assert' {
          * propagated back to the caller.
          *
          * If specified, `error` can be a [`Class`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes),
-         * [`RegExp`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions) or a validation
+         * [`RegExp`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions), or a validation
          * function. See {@link throws} for more details.
          *
          * The following, for instance, will throw the `TypeError` because there is no
          * matching error type in the assertion:
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * assert.doesNotThrow(
          *   () => {
          *     throw new TypeError('Wrong value');
          *   },
-         *   SyntaxError
+         *   SyntaxError,
          * );
          * ```
          *
@@ -671,27 +731,27 @@ declare module 'assert' {
          * 'Got unwanted exception...':
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * assert.doesNotThrow(
          *   () => {
          *     throw new TypeError('Wrong value');
          *   },
-         *   TypeError
+         *   TypeError,
          * );
          * ```
          *
          * If an `AssertionError` is thrown and a value is provided for the `message`parameter, the value of `message` will be appended to the `AssertionError` message:
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * assert.doesNotThrow(
          *   () => {
          *     throw new TypeError('Wrong value');
          *   },
          *   /Wrong value/,
-         *   'Whoops'
+         *   'Whoops',
          * );
          * // Throws: AssertionError: Got unwanted exception: Whoops
          * ```
@@ -705,7 +765,7 @@ declare module 'assert' {
          * from the error passed to `ifError()` including the potential new frames for`ifError()` itself.
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * assert.ifError(null);
          * // OK
@@ -751,7 +811,7 @@ declare module 'assert' {
          * If specified, `message` will be the message provided by the `AssertionError` if the `asyncFn` fails to reject.
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * await assert.rejects(
          *   async () => {
@@ -759,13 +819,13 @@ declare module 'assert' {
          *   },
          *   {
          *     name: 'TypeError',
-         *     message: 'Wrong value'
-         *   }
+         *     message: 'Wrong value',
+         *   },
          * );
          * ```
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * await assert.rejects(
          *   async () => {
@@ -775,16 +835,16 @@ declare module 'assert' {
          *     assert.strictEqual(err.name, 'TypeError');
          *     assert.strictEqual(err.message, 'Wrong value');
          *     return true;
-         *   }
+         *   },
          * );
          * ```
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * assert.rejects(
          *   Promise.reject(new Error('Wrong value')),
-         *   Error
+         *   Error,
          * ).then(() => {
          *   // ...
          * });
@@ -814,24 +874,24 @@ declare module 'assert' {
          * error messages as expressive as possible.
          *
          * If specified, `error` can be a [`Class`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes),
-         * [`RegExp`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions) or a validation
+         * [`RegExp`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions), or a validation
          * function. See {@link throws} for more details.
          *
          * Besides the async nature to await the completion behaves identically to {@link doesNotThrow}.
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * await assert.doesNotReject(
          *   async () => {
          *     throw new TypeError('Wrong value');
          *   },
-         *   SyntaxError
+         *   SyntaxError,
          * );
          * ```
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * assert.doesNotReject(Promise.reject(new TypeError('Wrong value')))
          *   .then(() => {
@@ -846,7 +906,7 @@ declare module 'assert' {
          * Expects the `string` input to match the regular expression.
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * assert.match('I will fail', /pass/);
          * // AssertionError [ERR_ASSERTION]: The input did not match the regular ...
@@ -869,7 +929,7 @@ declare module 'assert' {
          * Expects the `string` input not to match the regular expression.
          *
          * ```js
-         * import assert from 'assert/strict';
+         * import assert from 'node:assert/strict';
          *
          * assert.doesNotMatch('I will fail', /fail/);
          * // AssertionError [ERR_ASSERTION]: The input was expected to not match the ...