poku 1.6.0 → 1.7.0

package/README.md

@@ -9,7 +9,7 @@
 [ci-url]: https://github.com/wellwelwel/poku/actions/workflows/ci.yml?query=branch%3Amain
 [ci-image]: https://img.shields.io/github/actions/workflow/status/wellwelwel/poku/ci.yml?event=push&style=flat&label=CI&branch=main
 [ql-url]: https://github.com/wellwelwel/poku/actions/workflows/codeql.yml?query=branch%3Amain
-[ql-image]: https://img.shields.io/github/actions/workflow/status/wellwelwel/poku/codeql.yml?event=push&style=flat&label=Code%20QL&branch=main
+[ql-image]: https://img.shields.io/github/actions/workflow/status/wellwelwel/poku/ci-codeql.yml?event=push&style=flat&label=Code%20QL&branch=main
 [license-url]: https://github.com/wellwelwel/poku/blob/main/LICENSE
 [license-image]: https://img.shields.io/npm/l/poku.svg?maxAge=2592000&color=9c88ff&label=License
 [downloads-image]: https://img.shields.io/npm/dt/poku.svg?&color=FFC312&label=Downloads
@@ -17,11 +17,11 @@
 
 # Poku
 
-<img align="right" width="128" height="128" alt="Logo" src=".github/assets/readme/poku.svg">
+<img align="right" width="128" height="128" alt="Logo" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/poku.svg">
 
-**Poku** is your test runner pet for [**Node.js**][node-version-url], [**Bun**][bun-version-url] and [**Deno**][deno-version-url] combining **flexibility**, **parallel** and **sequential** runs, **human-friendly assertion errors** and **high isolation level**.
+[**English**](https://poku.io/docs) | [**Português (BR)**](https://poku.io/pt-BR/docs)
 
-> By creating **Poku**, my aim is to show that testing can be simpler.
+**Poku** is your Test Runner Pet for [**Node.js**][node-version-url], [**Bun**][bun-version-url] and [**Deno**][deno-version-url].
 
 [![Node.js Version][node-version-image]][node-version-url]
 [![Bun Version][bun-version-image]][bun-version-url]
@@ -32,151 +32,169 @@
 [![NPM Downloads][downloads-image]][downloads-url]
 [![License][license-image]][license-url]
 
+<!-- ![Codecov](https://img.shields.io/codecov/c/github/wellwelwel/poku?label=Coverage) -->
+
 Enjoying **Poku**? Consider giving him a star ⭐️
 
 ---
 
-🐷 [**Documentation Website**](https://poku.dev) • 🔬 [**Compare Poku with the Most Popular Test Runners**](https://poku.dev/docs/comparing) • 🧪 [**Examples**](https://poku.dev/docs/category/examples)
+🐷 [**Documentation**](https://poku.io) • 🧪 [**Examples**](https://poku.io/docs/category/examples) • 🔬 [**Compare the Most Popular Test Runners**](https://poku.io/docs/comparing)
 
 ---
 
 ## Why Poku?
 
-Let's make `describe`, `beforeEach` and everything else easier 🚀 <br/>
+By creating **Poku**, my aim is to show that testing can be simpler 🌱
 
+- No configurations
 - Supports **ESM** and **CJS**
+- High **isolation** level per file
+- **Poku** is [**100%** documented](https://poku.io/docs)
+- Zero external dependencies
+- **Parallel** and **Sequential** runs
 - Designed to be highly intuitive
 - Compatible with **Coverage** tools
 - [**Node.js**][node-version-url], [**Bun**][bun-version-url] and [**Deno**][deno-version-url] compatibility
-- Zero configurations, except you want
-- Allows both **API (_in-code_)** and **CLI** usage
-- Poku adapts to your test, not the other way around
-- You can use **Poku**'s `assert` with every test runner you want
-- [**And much more!**](https://poku.dev)
-
----
-
-- [![Install Size](https://packagephobia.com/badge?p=poku)](https://packagephobia.com/result?p=poku)
-- **Zero** external dependencies 🌱
+- You don't need to learn it all at once to get started 🧑🏻‍🎓
 
----
-
-## Documentation
-
-- See detailed usage in [**Documentation**](https://poku.dev/docs/category/documentation) section for **Poku**'s **CLI**, **API (_in-code_)** and **assert**, advanced concepts and much more.
+> _Poku adapts to your test, not the other way around._
 
 ---
 
-## Examples
+## Quickstart
 
-- See real example usages in [**Examples**](https://poku.dev/docs/category/examples) section for **Poku**'s + **Mock**, **Virutal DOM** and more.
+### Install 📦
 
----
+[![Install Size](https://packagephobia.com/badge?p=poku)](https://packagephobia.com/result?p=poku)
 
-## Overview
-
-### `poku`
-
-| Sequential                                         | Concurrent                                       |
-| -------------------------------------------------- | ------------------------------------------------ |
-| <img src=".github/assets/readme/sequential.png" /> | <img src=".github/assets/readme/parallel.png" /> |
-
-> [**See the complete `poku` documentation**](https://poku.dev/docs/category/poku).
-
----
-
-### `assert`
-
-| Using `poku`                                        | Using `node`                                        |
-| --------------------------------------------------- | --------------------------------------------------- |
-| <img src=".github/assets/readme/assert-poku.png" /> | <img src=".github/assets/readme/assert-node.png" /> |
-
-> [**See the complete assert's documentation**](https://poku.dev/docs/documentation/assert).
-
----
-
-## Install
-
-### **Node.js**
+<table>
+<tr>
+<td><img src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/node-js.svg" width="24" /></td>
+<td><img src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/node-js.svg" width="24" /> <img src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/plus.svg" width="24" /> <img src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/typescript.svg" width="24" /></td>
+<td><img src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/bun.svg" width="24" /></td>
+<td><img src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/deno.svg" width="24" /></td>
+</tr>
+<tr>
+<td width="400">
 
 ```bash
 npm i -D poku
 ```
 
-### TypeScript (Node.js)
+</td>
+<td width="400">
 
 ```bash
 npm i -D poku tsx
 ```
 
-### Bun
+</td>
+<td width="400">
 
 ```bash
 bun add -d poku
 ```
 
-### **Deno**
+</td>
+<td width="400">
 
 ```ts
 import { poku } from 'npm:poku';
 ```
 
----
+</td>
+</tr>
+</table>
 
-## Quick Start
+### Test it 🔬
 
-### `poku`
+<table>
+<tr>
+<td>
+<em><code>test/file.test.js</code></em>
+</td>
+</tr>
+<tr>
+<td width="1200">
+
+```ts
+import { assert } from 'poku';
+
+assert(true, 'Poku will describe it 🐷');
+```
 
-#### CLI
+</td>
+</tr>
+</table>
 
-> Try to set the flag `--parallel` before the target path 🚀
+### Run it 🚀
 
-> <img src=".github/assets/readme/node-js.svg" width="24" />
+<table>
+<tr>
+<td><img src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/node-js.svg" width="24" /></td>
+<td><img src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/bun.svg" width="24" /></td>
+<td><img src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/deno.svg" width="24" /></td>
+</tr>
+<tr>
+<td width="400">
 
 ```bash
-npx poku targetPath
-npx poku targetPathA,targetPathB
+npx poku
 ```
 
-> <img src=".github/assets/readme/bun.svg" width="24" />
+</td>
+<td width="400">
 
 ```bash
-bun poku targetPath
-bun poku targetPathA,targetPathB
+bun poku
 ```
 
-> <img src=".github/assets/readme/deno.svg" width="24" />
+</td>
+<td width="400">
 
 ```bash
-deno run npm:poku targetPath
-deno run npm:poku targetPathA,targetPathB
+deno run npm:poku
 ```
 
-#### API (_In-code_)
+</td>
+</tr>
+</table>
 
-##### Node.js, TypeScript (Node.js) and Bun
+### That's it 🎉
 
-```ts
-import { poku } from 'poku';
+- [**See the complete `assert`'s documentation**](https://poku.io/docs/documentation/assert).
+- [**See the complete `poku`'s documentation**](https://poku.io/docs/category/poku).
 
-await poku(['targetPath']);
-```
+---
 
-##### Deno
+## Overview
 
-```ts
-import { poku } from 'npm:poku';
+### `poku`
 
-await poku(['targetPath']);
-```
+| Sequential                                                                                                | Concurrent                                                                                              |
+| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
+| <img src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/sequential.png" /> | <img src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/parallel.png" /> |
+
+> [**See the complete `poku`'s documentation**](https://poku.io/docs/category/poku).
+
+---
 
 ### `assert`
 
-Use it exactly as it's for **Node.js** 💚
+- 💚 Use it exactly as it's for **Node.js**
+- 🐷 **Node.js**, **Bun** and **Deno** compatibility
+
+| Using `poku`                                                                                               | Using `node`                                                                                               |
+| ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
+| <img src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/assert-poku.png" /> | <img src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/assert-node.png" /> |
+
+> [**See the complete `assert`'s documentation**](https://poku.io/docs/documentation/assert).
 
 ---
 
-To see the detailed documentation, please visit the [**Documentation**](https://poku.dev/docs/category/documentation) and [**Examples**](https://poku.dev/docs/category/examples) sections in the [**Poku**'s website](https://poku.dev).
+## Documentation and Examples
+
+To see the detailed documentation, please visit the [**Documentation**](https://poku.io/docs/category/documentation) and [**Examples**](https://poku.io/docs/category/examples) sections in the [**Poku**'s website](https://poku.io).
 
 ---
 
@@ -186,24 +204,39 @@ I'm continuously working to improve **Poku**. If you've got something interestin
 
 ---
 
-## Acknowledgements
+## Contributing
 
-- [**Contributors**](https://github.com/wellwelwel/poku/graphs/contributors).
+Please check the [**CONTRIBUTING.md**](./CONTRIBUTING.md) for instructions 🚀
 
 ---
 
-## Contributing
+## Philosophy
 
-Please check the [**CONTRIBUTING.md**](./CONTRIBUTING.md) for instructions 🚀
+Please check the [**Philosophy**](https://poku.io/docs/philosophy) section from Documentation.
 
 ---
 
 ## License
 
-Poku is under the [**MIT** License](./LICENSE).
+Poku is under the [**MIT License**](./LICENSE).
 
 ---
 
 ## Security Policy
 
-Please check the [**SECURITY.md**](./SECURITY.md) and the section [**Is Poku Safe?**](https://poku.dev/docs/security) from Documentation.
+Please check the [**SECURITY.md**](./SECURITY.md) and the section [**Is Poku Safe?**](https://poku.io/docs/security) from Documentation.
+
+---
+
+## Acknowledgements
+
+[![Contributors](https://img.shields.io/github/contributors/wellwelwel/poku)](https://github.com/wellwelwel/poku/graphs/contributors)
+
+[![Contributors](https://contrib.rocks/image?repo=wellwelwel/poku)](https://github.com/wellwelwel/poku/graphs/contributors)
+
+---
+
+## Author
+
+| [![wellwelwel](https://avatars.githubusercontent.com/u/46850407?v=4?v=3&s=115)<br><sub>@wellwelwel</sub>](https://github.com/wellwelwel) |
+| :--------------------------------------------------------------------------------------------------------------------------------------: |

package/lib/configs/each.d.ts

@@ -0,0 +1,13 @@
+export type Control = {
+    pause: () => void;
+    continue: () => void;
+    reset: () => void;
+};
+export type EachConfigs = {
+    status: boolean;
+    cb?: () => unknown | Promise<unknown>;
+};
+export declare const each: {
+    before: EachConfigs;
+    after: EachConfigs;
+};

package/lib/configs/each.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.each = void 0;
+exports.each = {
+    before: {
+        status: true,
+        cb: undefined,
+    },
+    after: {
+        status: true,
+        cb: undefined,
+    },
+};

package/lib/helpers/find-file.d.ts

@@ -0,0 +1 @@
+export declare const findFile: (error: Error) => string;

package/lib/helpers/find-file.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findFile = void 0;
+const node_os_1 = require("os");
+const findFile = (error) => {
+    var _a;
+    const stackLines = ((_a = error.stack) === null || _a === void 0 ? void 0 : _a.split(node_os_1.EOL)) || [];
+    let file = '';
+    const basePath = 'poku/lib/';
+    for (const line of stackLines) {
+        if (!line.includes(basePath)) {
+            const match = line.match(/at\s(\/.+|file:.+)|^(\s+)at\smodule\scode\s\((\/.+|file:.+)\)/i);
+            // Node and Deno
+            if (match && match[1]) {
+                file = match[1];
+                break;
+            }
+            // Bun
+            if (match && match[3]) {
+                file = match[3];
+                break;
+            }
+        }
+    }
+    return file;
+};
+exports.findFile = findFile;

package/lib/helpers/format.d.ts

@@ -1,3 +1,20 @@
+export declare const backgroundColor: {
+    readonly white: 7;
+    readonly black: 40;
+    readonly grey: 100;
+    readonly red: 41;
+    readonly green: 42;
+    readonly yellow: 43;
+    readonly blue: 44;
+    readonly magenta: 45;
+    readonly cyan: 46;
+    readonly brightRed: 101;
+    readonly brightGreen: 102;
+    readonly brightYellow: 103;
+    readonly brightBlue: 104;
+    readonly brightMagenta: 105;
+    readonly brightCyan: 106;
+};
 export declare const format: {
     counter: (current: number, total: number, pad?: string) => string;
     dim: (value: string) => string;

package/lib/helpers/format.js

@@ -1,7 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getLargestStringLength = exports.format = void 0;
+exports.getLargestStringLength = exports.format = exports.backgroundColor = void 0;
 const pad_js_1 = require("./pad.js");
+exports.backgroundColor = {
+    white: 7,
+    black: 40,
+    grey: 100,
+    red: 41,
+    green: 42,
+    yellow: 43,
+    blue: 44,
+    magenta: 45,
+    cyan: 46,
+    brightRed: 101,
+    brightGreen: 102,
+    brightYellow: 103,
+    brightBlue: 104,
+    brightMagenta: 105,
+    brightCyan: 106,
+};
 exports.format = {
     counter: (current, total, pad = '0') => {
         const totalDigits = String(total).length;

package/lib/helpers/parseAsssetion.d.ts

@@ -6,4 +6,4 @@ export type ParseAssertionOptions = {
     throw?: boolean;
     hideDiff?: boolean;
 };
-export declare const parseAssertion: (cb: () => void, options: ParseAssertionOptions) => void;
+export declare const parseAssertion: (cb: () => void | Promise<void>, options: ParseAssertionOptions) => Promise<void>;

package/lib/helpers/parseAsssetion.js

@@ -1,4 +1,13 @@
 "use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -10,29 +19,26 @@ const node_assert_1 = __importDefault(require("assert"));
 const node_os_1 = require("os");
 const format_js_1 = require("./format.js");
 const hr_js_1 = require("./hr.js");
-const findFile = (error) => {
-    var _a;
-    const stackLines = ((_a = error.stack) === null || _a === void 0 ? void 0 : _a.split(node_os_1.EOL)) || [];
-    let file = '';
-    const basePath = 'poku/lib/';
-    for (const line of stackLines) {
-        if (!line.includes(basePath)) {
-            const match = line.match(/at\s(\/.+|file:\/\/\/.+)/i);
-            if (match && match[1]) {
-                file = match[1];
-                break;
-            }
-        }
-    }
-    return file;
-};
-const formatFail = (str) => format_js_1.format.bold(format_js_1.format.fail(`✘ ${str}`));
-const parseAssertion = (cb, options) => {
+const find_file_js_1 = require("./find-file.js");
+const each_js_1 = require("../configs/each.js");
+const parseAssertion = (cb, options) => __awaiter(void 0, void 0, void 0, function* () {
     var _a, _b;
     const isPoku = typeof ((_a = node_process_1.default.env) === null || _a === void 0 ? void 0 : _a.FILE) === 'string' && ((_b = node_process_1.default.env) === null || _b === void 0 ? void 0 : _b.FILE.length) > 0;
     const FILE = node_process_1.default.env.FILE;
     try {
-        cb();
+        if (typeof each_js_1.each.before.cb === 'function') {
+            const beforeResult = each_js_1.each.before.cb();
+            if (beforeResult instanceof Promise)
+                yield beforeResult;
+        }
+        const cbResult = cb();
+        if (cbResult instanceof Promise)
+            yield cbResult;
+        if (typeof each_js_1.each.after.cb === 'function') {
+            const afterResult = each_js_1.each.after.cb();
+            if (afterResult instanceof Promise)
+                yield afterResult;
+        }
         if (typeof options.message === 'string') {
             const message = isPoku
                 ? `${format_js_1.format.bold(format_js_1.format.success(`✔ ${options.message}`))} ${format_js_1.format.dim(format_js_1.format.success(`› ${FILE}`))}`
@@ -43,7 +49,7 @@ const parseAssertion = (cb, options) => {
     catch (error) {
         if (error instanceof node_assert_1.default.AssertionError) {
             const { code, actual, expected, operator } = error;
-            const absoultePath = findFile(error);
+            const absoultePath = (0, find_file_js_1.findFile)(error).replace(/file:(\/\/)?/, '');
             const file = node_path_1.default.relative(node_path_1.default.resolve(node_process_1.default.cwd()), absoultePath);
             let message = '';
             if (typeof options.message === 'string')
@@ -53,8 +59,8 @@ const parseAssertion = (cb, options) => {
             else if (typeof options.defaultMessage === 'string')
                 message = options.defaultMessage;
             const finalMessage = (message === null || message === void 0 ? void 0 : message.trim().length) > 0
-                ? `${formatFail(message)}`
-                : `${formatFail('No Message')}`;
+                ? format_js_1.format.bold(format_js_1.format.fail(`✘ ${message}`))
+                : format_js_1.format.bold(format_js_1.format.fail('✘ No Message'));
             console.log(isPoku
                 ? `${finalMessage} ${format_js_1.format.dim(format_js_1.format.fail(`› ${FILE}`))}`
                 : finalMessage);
@@ -80,5 +86,5 @@ const parseAssertion = (cb, options) => {
         // Non-assertion errors
         throw error;
     }
-};
+});
 exports.parseAssertion = parseAssertion;

package/lib/index.d.ts

@@ -1,6 +1,7 @@
 export { poku } from './modules/poku.js';
 export { exit } from './modules/exit.js';
 export { assert } from './modules/assert.js';
+export { describe, log } from './modules/describe.js';
 export { assertPromise } from './modules/assert-promise.js';
 export { beforeEach, afterEach } from './modules/each.js';
 export { publicListFiles as listFiles } from './modules/list-files.js';

package/lib/index.js

@@ -1,12 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.listFiles = exports.afterEach = exports.beforeEach = exports.assertPromise = exports.assert = exports.exit = exports.poku = void 0;
+exports.listFiles = exports.afterEach = exports.beforeEach = exports.assertPromise = exports.log = exports.describe = exports.assert = exports.exit = exports.poku = void 0;
 var poku_js_1 = require("./modules/poku.js");
 Object.defineProperty(exports, "poku", { enumerable: true, get: function () { return poku_js_1.poku; } });
 var exit_js_1 = require("./modules/exit.js");
 Object.defineProperty(exports, "exit", { enumerable: true, get: function () { return exit_js_1.exit; } });
 var assert_js_1 = require("./modules/assert.js");
 Object.defineProperty(exports, "assert", { enumerable: true, get: function () { return assert_js_1.assert; } });
+var describe_js_1 = require("./modules/describe.js");
+Object.defineProperty(exports, "describe", { enumerable: true, get: function () { return describe_js_1.describe; } });
+Object.defineProperty(exports, "log", { enumerable: true, get: function () { return describe_js_1.log; } });
 var assert_promise_js_1 = require("./modules/assert-promise.js");
 Object.defineProperty(exports, "assertPromise", { enumerable: true, get: function () { return assert_promise_js_1.assertPromise; } });
 var each_js_1 = require("./modules/each.js");

package/lib/modules/assert-promise.d.ts

@@ -1,14 +1,14 @@
 /// <reference types="node" />
 import * as nodeAssert from 'node:assert';
 import { ParseAssertionOptions } from '../helpers/parseAsssetion.js';
-declare function doesNotReject(block: (() => Promise<unknown>) | Promise<unknown>, message?: string | Error): Promise<void>;
-declare function doesNotReject(block: (() => Promise<unknown>) | Promise<unknown>, error: nodeAssert.AssertPredicate, message?: string | Error): Promise<void>;
-declare function doesNotThrow(block: () => unknown, message?: string | ParseAssertionOptions['message']): void;
-declare function doesNotThrow(block: () => unknown, error: nodeAssert.AssertPredicate, message?: ParseAssertionOptions['message']): void;
-declare function throws(block: () => unknown, message?: ParseAssertionOptions['message']): void;
-declare function throws(block: () => unknown, error: nodeAssert.AssertPredicate, message?: ParseAssertionOptions['message']): void;
+declare function doesNotThrow(block: () => unknown, message?: string | ParseAssertionOptions['message']): Promise<void>;
+declare function doesNotThrow(block: () => unknown, error: nodeAssert.AssertPredicate, message?: ParseAssertionOptions['message']): Promise<void>;
+declare function throws(block: () => unknown, message?: ParseAssertionOptions['message']): Promise<void>;
+declare function throws(block: () => unknown, error: nodeAssert.AssertPredicate, message?: ParseAssertionOptions['message']): Promise<void>;
 declare function rejects(block: (() => Promise<unknown>) | Promise<unknown>, message?: string | Error): Promise<void>;
 declare function rejects(block: (() => Promise<unknown>) | Promise<unknown>, error: nodeAssert.AssertPredicate, message?: string | Error): Promise<void>;
+declare function doesNotReject(block: (() => Promise<unknown>) | Promise<unknown>, message?: string | Error): Promise<void>;
+declare function doesNotReject(block: (() => Promise<unknown>) | Promise<unknown>, error: nodeAssert.AssertPredicate, message?: string | Error): Promise<void>;
 export declare const assertPromise: ((value: unknown, message?: ParseAssertionOptions['message']) => Promise<void>) & {
     ok: (value: unknown, message?: ParseAssertionOptions['message']) => Promise<void>;
     equal: (actual: unknown, expected: unknown, message?: ParseAssertionOptions['message']) => Promise<void>;
@@ -25,7 +25,7 @@ export declare const assertPromise: ((value: unknown, message?: ParseAssertionOp
     notDeepStrictEqual: (actual: unknown, expected: unknown, message?: ParseAssertionOptions['message']) => Promise<void>;
     match: (value: string, regExp: RegExp, message?: ParseAssertionOptions['message']) => Promise<void>;
     ifError: (value: unknown) => Promise<void>;
-    fail: (message?: ParseAssertionOptions['message']) => void;
+    fail: (message?: ParseAssertionOptions['message']) => Promise<void>;
     rejects: typeof rejects;
 };
 export {};