poku 1.9.2 → 1.9.4

package/README.md

@@ -10,10 +10,12 @@
 [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/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
+[coverage-image]: https://img.shields.io/codecov/c/github/wellwelwel/poku?label=Coverage
+[coverage-url]: https://app.codecov.io/github/wellwelwel/poku
 [downloads-image]: https://img.shields.io/npm/dt/poku.svg?&color=FFC312&label=Downloads
 [downloads-url]: https://npmjs.org/package/poku
+[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
 
 <div align="center">
 <img width="170" height="170" alt="Logo" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/poku.svg">
@@ -28,6 +30,7 @@
 [![TypeScript Version][typescript-version-image]][typescript-url]<br />
 [![GitHub Workflow Status (with event)][ci-image]][ci-url]
 [![GitHub Workflow Status (with event)][ql-image]][ql-url]
+[![Coverage][coverage-image]][coverage-url]
 [![NPM Downloads][downloads-image]][downloads-url]
 [![License][license-image]][license-url]
 
@@ -55,11 +58,11 @@ Enjoying **Poku**? Consider giving him a star ⭐️
 <img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Less verbose<br />
 <img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> High **isolation** level per file<br />
 <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> No eval needed 🔐<br />
+<span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> No global state<br />
 <img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> **Parallel** and **Sequential** runs 🏃🏽🏃🏻<br />
 
 <img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> **Poku** is [**100%** documented](https://poku.io/docs)<br />
 <img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Designed to be human-friendly<br />
-<img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> **Poku** doesn't use a global state<br />
 <img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Compatible with **Coverage** tools<br />
 <img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> [**Node.js**][node-version-url], [**Bun**][bun-version-url] and [**Deno**][deno-version-url] compatibility 🩵<br />
 
@@ -108,8 +111,8 @@ bun add -d poku
 </td>
 <td width="400">
 
-```ts
-import { poku } from 'npm:poku';
+```bash
+deno add npm:poku
 ```
 
 </td>
@@ -121,7 +124,7 @@ import { poku } from 'npm:poku';
 <table>
 <tr>
 <td>
-<em><code>test/file.test.js</code></em>
+<em><code>test/file.test.mjs</code></em>
 </td>
 </tr>
 <tr>
@@ -137,7 +140,8 @@ assert(true, 'Poku will describe it 🐷');
 </tr>
 </table>
 
-> Note that these examples use [**ESM**](https://poku.io/docs/examples/cjs-esm), but you can use [**CJS**](https://poku.io/docs/examples/cjs-esm) as well.
+- Change from `.mjs` to `.js` by defining `"type": "module"` in your _package.json_.
+- Note that these examples use [**ESM**](https://poku.io/docs/examples/cjs-esm), but you can use [**CJS**](https://poku.io/docs/examples/cjs-esm) as well.
 
 ### Run it 🚀
 
@@ -190,11 +194,10 @@ deno run npm:poku
 
 ### Helpers
 
-- `beforeEach` and `afterEach`
-- `test`
-- `describe` and `log`
-- `listFiles`
-- `exit`
+- [**beforeEach**](https://poku.io/docs/category/beforeeach-and-aftereach) and [**afterEach**](https://poku.io/docs/category/beforeeach-and-aftereach)
+- [**test**](https://poku.io/docs/documentation/helpers/test)
+- [**describe**](https://poku.io/docs/documentation/helpers/describe)
+- _and much more_ ✨
 
 [**See the complete documentation**](https://poku.io/docs).
 

package/lib/bin/index.js

@@ -2,6 +2,7 @@
 "use strict";
 var _a, _b;
 Object.defineProperty(exports, "__esModule", { value: true });
+/* c8 ignore start */
 const list_files_js_1 = require("../modules/list-files.js");
 const get_arg_js_1 = require("../helpers/get-arg.js");
 const index_js_1 = require("../index.js");
@@ -26,3 +27,4 @@ if ((0, get_arg_js_1.hasArg)('log-success'))
     quiet,
     debug,
 });
+/* c8 ignore stop */

package/lib/configs/each.js

@@ -15,3 +15,4 @@ exports.each = {
         test: true,
     },
 };
+/* c8 ignore stop */

package/lib/helpers/find-file.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.findFile = void 0;
 const node_os_1 = require("os");
+/* c8 ignore start */
 const findFile = (error) => {
     var _a;
     const stackLines = ((_a = error.stack) === null || _a === void 0 ? void 0 : _a.split(node_os_1.EOL)) || [];
@@ -25,3 +26,4 @@ const findFile = (error) => {
     return file;
 };
 exports.findFile = findFile;
+/* c8 ignore stop */

package/lib/helpers/force-array.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.forceArray = void 0;
+/* c8 ignore start */
 const forceArray = (input) => {
     if (Array.isArray(input))
         return input;
     return [input];
 };
 exports.forceArray = forceArray;
+/* c8 ignore stop */

package/lib/helpers/format.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getLargestStringLength = exports.format = exports.backgroundColor = void 0;
+/* c8 ignore start */
 const pad_js_1 = require("./pad.js");
 exports.backgroundColor = {
     white: 7,
@@ -39,3 +40,4 @@ exports.format = {
 };
 const getLargestStringLength = (arr) => arr.reduce((max, current) => Math.max(max, current.length), 0);
 exports.getLargestStringLength = getLargestStringLength;
+/* c8 ignore stop */

package/lib/helpers/get-runtime.d.ts

@@ -2,3 +2,4 @@ import type { Configs } from '../@types/poku.js';
 export declare const supportedPlatforms: ReadonlyArray<Configs['platform']>;
 export declare const platformIsValid: (platform: unknown) => platform is "node" | "bun" | "deno" | undefined;
 export declare const getRuntime: (configs?: Configs) => (typeof supportedPlatforms)[number];
+export declare const nodeVersion: number | undefined;

package/lib/helpers/get-runtime.js

@@ -1,6 +1,12 @@
 "use strict";
+/* c8 ignore start */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getRuntime = exports.platformIsValid = exports.supportedPlatforms = void 0;
+exports.nodeVersion = exports.getRuntime = exports.platformIsValid = exports.supportedPlatforms = void 0;
+const node_process_1 = __importDefault(require("process"));
 exports.supportedPlatforms = [
     'node',
     'bun',
@@ -23,3 +29,7 @@ const getRuntime = (configs) => {
     return 'node';
 };
 exports.getRuntime = getRuntime;
+exports.nodeVersion = (0, exports.getRuntime)() === 'node'
+    ? Number((_a = node_process_1.default.version.match(/v(\d+)\./)) === null || _a === void 0 ? void 0 : _a[1])
+    : undefined;
+/* c8 ignore stop */

package/lib/helpers/hr.js

@@ -1,4 +1,5 @@
 "use strict";
+/* c8 ignore start */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -11,3 +12,4 @@ const hr = () => {
     console.log(`${node_os_1.EOL}\x1b[2m\x1b[90m${line}\x1b[0m${node_os_1.EOL}`);
 };
 exports.hr = hr;
+/* c8 ignore stop */

package/lib/helpers/pad.js

@@ -4,6 +4,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.padStart = void 0;
+/* c8 ignore start */
 const padStart = (str, targetLength, padString) => {
     padString = !padString ? ' ' : String(padString);
     if (str.length >= targetLength)
@@ -14,3 +15,4 @@ const padStart = (str, targetLength, padString) => {
     return fullPadString + str;
 };
 exports.padStart = padStart;
+/* c8 ignore stop */

package/lib/helpers/parseAsssetion.js

@@ -58,6 +58,7 @@ const parseAssertion = (cb, options) => __awaiter(void 0, void 0, void 0, functi
                 message = options.message.message;
             else if (typeof options.defaultMessage === 'string')
                 message = options.defaultMessage;
+            /* c8 ignore start */
             const finalMessage = (message === null || message === void 0 ? void 0 : message.trim().length) > 0
                 ? format_js_1.format.bold(format_js_1.format.fail(`✘ ${message}`))
                 : format_js_1.format.bold(format_js_1.format.fail('✘ No Message'));
@@ -86,5 +87,7 @@ const parseAssertion = (cb, options) => __awaiter(void 0, void 0, void 0, functi
         // Non-assertion errors
         throw error;
     }
+    /* c8 ignore stop */
+    /* c8 ignore next */
 });
 exports.parseAssertion = parseAssertion;

package/lib/helpers/remove-repeats.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.removeConsecutiveRepeats = void 0;
+/* c8 ignore start */
 const removeConsecutiveRepeats = (arr, specificItem) => {
     const result = [];
     let consecutiveCount = 0;
@@ -27,3 +28,4 @@ const removeConsecutiveRepeats = (arr, specificItem) => {
     return result;
 };
 exports.removeConsecutiveRepeats = removeConsecutiveRepeats;
+/* c8 ignore stop */

package/lib/helpers/runner.d.ts

@@ -1,4 +1,5 @@
 import { Configs } from '../@types/poku.js';
 import { Runner } from '../@types/runner.js';
+export declare const isWindows: boolean;
 export declare const runner: (filename: string, configs?: Configs) => string[];
 export declare const scriptRunner: (runner: Runner) => string[];

package/lib/helpers/runner.js

@@ -1,13 +1,14 @@
 "use strict";
+/* c8 ignore start */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.scriptRunner = exports.runner = void 0;
+exports.scriptRunner = exports.runner = exports.isWindows = void 0;
 const node_process_1 = __importDefault(require("process"));
 const node_path_1 = __importDefault(require("path"));
 const get_runtime_js_1 = require("./get-runtime.js");
-const isWindows = node_process_1.default.platform === 'win32';
+exports.isWindows = node_process_1.default.platform === 'win32';
 const runner = (filename, configs) => {
     const runtime = (0, get_runtime_js_1.getRuntime)(configs);
     // Bun
@@ -15,17 +16,24 @@ const runner = (filename, configs) => {
         return ['bun'];
     // Deno
     if (runtime === 'deno')
-        return ['deno', 'run', '--allow-read', '--allow-env', '--allow-run'];
+        return [
+            'deno',
+            'run',
+            '--allow-read', // Poku searches for all test files
+            '--allow-env', // Poku share the process.env with the `child_process`
+            '--allow-run', // Poku CLI
+            '--allow-net', // Create Service
+        ];
     // Node.js
     return node_path_1.default.extname(filename) === '.ts'
-        ? [isWindows ? 'npx.cmd' : 'npx', 'tsx']
+        ? [exports.isWindows ? 'npx.cmd' : 'npx', 'tsx']
         : ['node'];
 };
 exports.runner = runner;
 const scriptRunner = (runner) => {
     // Bun
     if (runner === 'bun')
-        return ['bun'];
+        return ['bun', 'run'];
     // Deno
     if (runner === 'deno')
         return ['deno', 'task'];
@@ -36,6 +44,7 @@ const scriptRunner = (runner) => {
     if (runner === 'pnpm')
         return ['pnpm', 'run'];
     // Node.js
-    return ['npm', 'run'];
+    return [exports.isWindows ? 'npm.cmd' : 'npm', 'run'];
 };
 exports.scriptRunner = scriptRunner;
+/* c8 ignore stop */

package/lib/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.startScript = exports.startService = exports.test = exports.listFiles = exports.afterEach = exports.beforeEach = exports.assertPromise = exports.log = exports.describe = exports.assert = exports.exit = exports.poku = void 0;
+/* c8 ignore start */
 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");
@@ -22,3 +23,4 @@ Object.defineProperty(exports, "test", { enumerable: true, get: function () { re
 var create_service_js_1 = require("./modules/create-service.js");
 Object.defineProperty(exports, "startService", { enumerable: true, get: function () { return create_service_js_1.startService; } });
 Object.defineProperty(exports, "startScript", { enumerable: true, get: function () { return create_service_js_1.startScript; } });
+/* c8 ignore stop */

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

@@ -24,7 +24,7 @@ export declare const assertPromise: ((value: unknown, message?: ParseAssertionOp
     notStrictEqual: (actual: unknown, expected: unknown, message?: ParseAssertionOptions['message']) => Promise<void>;
     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>;
+    ifError: (value: unknown, message?: ParseAssertionOptions['message']) => Promise<void>;
     fail: (message?: ParseAssertionOptions['message']) => Promise<void>;
     rejects: typeof rejects;
 };

package/lib/modules/assert-promise.js

@@ -31,20 +31,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.assertPromise = void 0;
-const node_process_1 = __importDefault(require("process"));
 const nodeAssert = __importStar(require("assert"));
 const parseAsssetion_js_1 = require("../helpers/parseAsssetion.js");
 const get_runtime_js_1 = require("../helpers/get-runtime.js");
-const runtime = (0, get_runtime_js_1.getRuntime)();
-const version = runtime === 'node'
-    ? Number((_a = node_process_1.default.version.match(/v(\d+)\./)) === null || _a === void 0 ? void 0 : _a[1])
-    : undefined;
 const ok = (value, message) => __awaiter(void 0, void 0, void 0, function* () {
     yield (0, parseAsssetion_js_1.parseAssertion)(() => {
         nodeAssert.ok(value);
@@ -90,10 +81,11 @@ const notDeepStrictEqual = (actual, expected, message) => __awaiter(void 0, void
         message,
     });
 });
-const ifError = (value) => __awaiter(void 0, void 0, void 0, function* () {
+const ifError = (value, message) => __awaiter(void 0, void 0, void 0, function* () {
     yield (0, parseAsssetion_js_1.parseAssertion)(() => {
         nodeAssert.ifError(value);
     }, {
+        message,
         defaultMessage: 'Expected no error, but received an error',
         hideDiff: true,
         throw: true,
@@ -186,8 +178,9 @@ function doesNotReject(block, errorOrMessage, message) {
         });
     });
 }
+/* c8 ignore start */
 const match = (value, regExp, message) => __awaiter(void 0, void 0, void 0, function* () {
-    if (typeof version === 'number' && version < 12) {
+    if (typeof get_runtime_js_1.nodeVersion === 'number' && get_runtime_js_1.nodeVersion < 12) {
         throw new Error('match is available from Node.js 12 or higher');
     }
     yield (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert === null || nodeAssert === void 0 ? void 0 : nodeAssert.match(value, regExp), {
@@ -197,8 +190,10 @@ const match = (value, regExp, message) => __awaiter(void 0, void 0, void 0, func
         defaultMessage: 'Value should match regExp',
     });
 });
+/* c8 ignore stop */
+/* c8 ignore start */
 const doesNotMatch = (value, regExp, message) => __awaiter(void 0, void 0, void 0, function* () {
-    if (typeof version === 'number' && version < 12) {
+    if (typeof get_runtime_js_1.nodeVersion === 'number' && get_runtime_js_1.nodeVersion < 12) {
         throw new Error('doesNotMatch is available from Node.js 12 or higher');
     }
     yield (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.doesNotMatch(value, regExp), {
@@ -208,6 +203,7 @@ const doesNotMatch = (value, regExp, message) => __awaiter(void 0, void 0, void
         defaultMessage: 'Value should not match regExp',
     });
 });
+/* c8 ignore stop */
 exports.assertPromise = Object.assign((value, message) => ok(value, message), {
     ok,
     equal,

package/lib/modules/assert.d.ts

@@ -24,7 +24,7 @@ export declare const assert: ((value: unknown, message?: ParseAssertionOptions['
     notStrictEqual: (actual: unknown, expected: unknown, message?: ParseAssertionOptions['message']) => void;
     notDeepStrictEqual: (actual: unknown, expected: unknown, message?: ParseAssertionOptions['message']) => void;
     match: (value: string, regExp: RegExp, message?: ParseAssertionOptions['message']) => void;
-    ifError: (value: unknown) => void;
+    ifError: (value: unknown, message?: ParseAssertionOptions['message']) => void;
     fail: (message?: ParseAssertionOptions['message']) => void;
     rejects: typeof rejects;
 };

package/lib/modules/assert.js

@@ -31,20 +31,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.assert = void 0;
-const node_process_1 = __importDefault(require("process"));
 const nodeAssert = __importStar(require("assert"));
 const parseAsssetion_js_1 = require("../helpers/parseAsssetion.js");
 const get_runtime_js_1 = require("../helpers/get-runtime.js");
-const runtime = (0, get_runtime_js_1.getRuntime)();
-const version = runtime === 'node'
-    ? Number((_a = node_process_1.default.version.match(/v(\d+)\./)) === null || _a === void 0 ? void 0 : _a[1])
-    : undefined;
 const ok = (value, message) => {
     (0, parseAsssetion_js_1.parseAssertion)(() => {
         nodeAssert.ok(value);
@@ -84,10 +75,11 @@ const notDeepStrictEqual = (actual, expected, message) => {
         message,
     });
 };
-const ifError = (value) => {
+const ifError = (value, message) => {
     (0, parseAsssetion_js_1.parseAssertion)(() => {
         nodeAssert.ifError(value);
     }, {
+        message,
         defaultMessage: 'Expected no error, but received an error',
         hideDiff: true,
         throw: true,
@@ -176,8 +168,9 @@ function doesNotReject(block, errorOrMessage, message) {
         });
     });
 }
+/* c8 ignore start */
 const match = (value, regExp, message) => {
-    if (typeof version === 'number' && version < 12) {
+    if (typeof get_runtime_js_1.nodeVersion === 'number' && get_runtime_js_1.nodeVersion < 12) {
         throw new Error('match is available from Node.js 12 or higher');
     }
     (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert === null || nodeAssert === void 0 ? void 0 : nodeAssert.match(value, regExp), {
@@ -187,8 +180,10 @@ const match = (value, regExp, message) => {
         defaultMessage: 'Value should match regExp',
     });
 };
+/* c8 ignore stop */
+/* c8 ignore start */
 const doesNotMatch = (value, regExp, message) => {
-    if (typeof version === 'number' && version < 12) {
+    if (typeof get_runtime_js_1.nodeVersion === 'number' && get_runtime_js_1.nodeVersion < 12) {
         throw new Error('doesNotMatch is available from Node.js 12 or higher');
     }
     (0, parseAsssetion_js_1.parseAssertion)(() => nodeAssert.doesNotMatch(value, regExp), {
@@ -198,6 +193,7 @@ const doesNotMatch = (value, regExp, message) => {
         defaultMessage: 'Value should not match regExp',
     });
 };
+/* c8 ignore stop */
 exports.assert = Object.assign((value, message) => ok(value, message), {
     ok,
     equal,

package/lib/modules/create-service.d.ts

@@ -6,7 +6,7 @@ import { StartScriptOptions, StartServiceOptions } from '../@types/background-pr
  * Useful for servers, APIs, etc.
  */
 export declare const startService: (file: string, options?: StartServiceOptions) => Promise<{
-    end: () => boolean;
+    end: () => void;
 }>;
 /**
  *
@@ -15,7 +15,13 @@ export declare const startService: (file: string, options?: StartServiceOptions)
  * By default, it uses **npm**, but you can costumize it using the `runner` option.
  *
  * Useful for servers, APIs, etc.
+ *
+ * ---
+ *
+ * `startScript` currently doesn't works for **Bun** and **Deno**.
+ *
+ * - See: https://github.com/wellwelwel/poku/issues/143
  */
 export declare const startScript: (script: string, options?: StartScriptOptions) => Promise<{
-    end: () => boolean;
+    end: () => void;
 }>;

package/lib/modules/create-service.js

@@ -18,25 +18,54 @@ const node_child_process_1 = require("child_process");
 const runner_js_1 = require("../helpers/runner.js");
 const node_path_1 = __importDefault(require("path"));
 const list_files_js_1 = require("./list-files.js");
+const node_os_1 = require("os");
+const format_js_1 = require("../helpers/format.js");
+/* c8 ignore start */
+const runningProcesses = {};
+const secureEnds = () => Object.values(runningProcesses).forEach((end) => end());
+const killWindowsProcess = (PID) => (0, node_child_process_1.spawn)('taskkill', ['/F', '/T', '/PID', PID.toString()]);
+node_process_1.default.once('SIGINT', () => {
+    secureEnds();
+});
+/* c8 ignore stop */
 const backgroundProcess = (runtime, args, file, options) => new Promise((resolve, reject) => {
     let isResolved = false;
     const service = (0, node_child_process_1.spawn)(runtime, args, {
         stdio: ['inherit', 'pipe', 'pipe'],
-        shell: false,
+        /* c8 ignore next */
+        shell: runner_js_1.isWindows,
         cwd: (options === null || options === void 0 ? void 0 : options.cwd) ? (0, list_files_js_1.sanitizePath)(node_path_1.default.normalize(options.cwd)) : undefined,
         env: node_process_1.default.env,
-        detached: true,
+        /* c8 ignore next */
+        detached: !runner_js_1.isWindows,
+        /* c8 ignore next */
+        windowsHide: runner_js_1.isWindows,
+        timeout: options === null || options === void 0 ? void 0 : options.timeout,
     });
+    const PID = service.pid;
+    /* c8 ignore start */
     const end = () => {
-        node_process_1.default.kill(-service.pid, 'SIGKILL');
-        return true;
+        delete runningProcesses[PID];
+        if (runner_js_1.isWindows) {
+            killWindowsProcess(PID);
+            return;
+        }
+        if (['bun', 'deno'].includes(runtime) ||
+            ['bun', 'deno'].includes(String(options === null || options === void 0 ? void 0 : options.runner))) {
+            node_process_1.default.kill(PID);
+            return;
+        }
+        node_process_1.default.kill(-PID, 'SIGKILL');
+        return;
     };
+    runningProcesses[PID] = end;
+    /* c8 ignore stop */
     service.stdout.on('data', (data) => {
         if (!isResolved && typeof (options === null || options === void 0 ? void 0 : options.startAfter) !== 'number') {
-            const stringData = String(data);
+            const stringData = JSON.stringify(String(data));
             if (typeof (options === null || options === void 0 ? void 0 : options.startAfter) === 'undefined' ||
                 (typeof (options === null || options === void 0 ? void 0 : options.startAfter) === 'string' &&
-                    stringData.includes(options.startAfter))) {
+                    stringData.includes(options === null || options === void 0 ? void 0 : options.startAfter))) {
                 resolve({ end });
                 clearTimeout(timeout);
                 isResolved = true;
@@ -45,18 +74,29 @@ const backgroundProcess = (runtime, args, file, options) => new Promise((resolve
         (options === null || options === void 0 ? void 0 : options.verbose) && console.log(String(data));
     });
     service.stderr.on('data', (data) => {
-        reject(new Error(`Service failed to start: ${data}`));
+        if (!isResolved && typeof (options === null || options === void 0 ? void 0 : options.startAfter) !== 'number') {
+            const stringData = JSON.stringify(String(data));
+            if (typeof (options === null || options === void 0 ? void 0 : options.startAfter) === 'undefined' ||
+                (typeof (options === null || options === void 0 ? void 0 : options.startAfter) === 'string' &&
+                    stringData.includes(options === null || options === void 0 ? void 0 : options.startAfter))) {
+                resolve({ end });
+                clearTimeout(timeout);
+                isResolved = true;
+            }
+        }
+        (options === null || options === void 0 ? void 0 : options.verbose) && console.log(String(data));
     });
     service.on('error', (err) => {
-        reject(new Error(`Service failed to start: ${err}`));
+        secureEnds();
+        reject(`Service failed to start: ${err}`);
     });
     service.on('close', (code) => {
         if (code !== 0)
-            reject(new Error(`Service exited with code ${code}`));
+            reject(`Service exited with code ${code}`);
     });
     const timeout = setTimeout(() => {
         if (!isResolved) {
-            service.kill();
+            secureEnds();
             reject(`createService: Timeout\nFile: ${file}`);
         }
     }, (options === null || options === void 0 ? void 0 : options.timeout) || 10000);
@@ -90,11 +130,22 @@ exports.startService = startService;
  * By default, it uses **npm**, but you can costumize it using the `runner` option.
  *
  * Useful for servers, APIs, etc.
+ *
+ * ---
+ *
+ * `startScript` currently doesn't works for **Bun** and **Deno**.
+ *
+ * - See: https://github.com/wellwelwel/poku/issues/143
  */
 const startScript = (script, options) => __awaiter(void 0, void 0, void 0, function* () {
-    const runtimeOptions = (0, runner_js_1.scriptRunner)((options === null || options === void 0 ? void 0 : options.runner) || 'npm');
+    const runner = (options === null || options === void 0 ? void 0 : options.runner) || 'npm';
+    const runtimeOptions = (0, runner_js_1.scriptRunner)(runner);
     const runtime = runtimeOptions.shift();
     const runtimeArgs = [...runtimeOptions, script];
-    return yield backgroundProcess(runtime, runtimeArgs, script, options);
+    /* c8 ignore start */
+    if (['bun', 'deno'].includes(runner))
+        throw new Error(`${format_js_1.format.bold('startScript')} currently doesn't works for Bun and Deno.${node_os_1.EOL}See: https://github.com/wellwelwel/poku/issues/143`);
+    /* c8 ignore stop */
+    return yield backgroundProcess(runtime, runtimeArgs, script, Object.assign(Object.assign({}, options), { isScript: true, runner }));
 });
 exports.startScript = startScript;

package/lib/modules/describe.js

@@ -25,3 +25,4 @@ const describe = (title, options) => {
     console.log(`${pad ? node_os_1.EOL : ''}${format_js_1.format.bg(format_js_1.backgroundColor[typeof background === 'string' ? background : 'grey'], message)}`);
 };
 exports.describe = describe;
+/* c8 ignore stop */

package/lib/modules/exit.js

@@ -1,4 +1,5 @@
 "use strict";
+/* c8 ignore start */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -31,3 +32,4 @@ node_process_1.default.on('uncaughtException', (err) => {
     console.log('uncaughtException', err);
     node_process_1.default.exit(1);
 });
+/* c8 ignore stop */

package/lib/modules/poku.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Both CLI, API, noExit, sequential and parallel runs are strictly tested, but these tests use deep child process for it
+ */
 import { Code } from '../@types/code.js';
 import { Configs } from '../@types/poku.js';
 export declare function poku(targetPaths: string | string[], configs: Configs & {

package/lib/modules/poku.js

@@ -1,4 +1,7 @@
 "use strict";
+/**
+ * Both CLI, API, noExit, sequential and parallel runs are strictly tested, but these tests use deep child process for it
+ */
 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) {
@@ -10,6 +13,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.poku = void 0;
+/* c8 ignore start */
 const node_os_1 = require("os");
 const force_array_js_1 = require("../helpers/force-array.js");
 const run_tests_js_1 = require("../services/run-tests.js");
@@ -58,3 +62,4 @@ function poku(targetPaths, configs) {
     });
 }
 exports.poku = poku;
+/* c8 ignore stop */

package/lib/modules/test.js

@@ -19,6 +19,7 @@ function test(cb) {
                 yield beforeResult;
         }
         const resultCb = cb();
+        /* c8 ignore next */
         if (resultCb instanceof Promise)
             yield resultCb;
         if (typeof each_js_1.each.after.cb === 'function' && each_js_1.each.after.test) {

package/lib/services/run-test-file.js

@@ -23,10 +23,13 @@ const format_js_1 = require("../helpers/format.js");
 const logs_js_1 = require("../helpers/logs.js");
 const remove_repeats_js_1 = require("../helpers/remove-repeats.js");
 const each_js_1 = require("./each.js");
+/* c8 ignore stop */
+/* c8 ignore start */
 exports.fileResults = {
     success: [],
     fail: [],
 };
+/* c8 ignore stop */
 const runTestFile = (filePath, configs) => new Promise((resolve) => __awaiter(void 0, void 0, void 0, function* () {
     const runtimeOptions = (0, runner_js_1.runner)(filePath, configs);
     const runtime = runtimeOptions.shift();
@@ -75,7 +78,8 @@ const runTestFile = (filePath, configs) => new Promise((resolve) => __awaiter(vo
     // Export spawn helper is not an option
     const child = (0, node_child_process_1.spawn)(runtime, runtimeArguments, {
         stdio: ['inherit', 'pipe', 'pipe'],
-        shell: false,
+        /* c8 ignore next */
+        shell: runner_js_1.isWindows,
         env: Object.assign(Object.assign({}, node_process_1.default.env), { FILE: (configs === null || configs === void 0 ? void 0 : configs.parallel) ? fileRelative : '' }),
     });
     child.stdout.on('data', stdOut);

package/package.json

@@ -1,22 +1,21 @@
 {
   "name": "poku",
-  "version": "1.9.2",
+  "version": "1.9.4",
   "description": "🐷 Poku makes testing easy for Node.js, Bun & Deno at the same time.",
   "main": "./lib/index.js",
   "scripts": {
-    "test": "tsx ./test/run.test.ts",
-    "pretest:c8": "npm run build",
-    "test:c8": "c8 --reporter=text --reporter=lcov npm run test:e2e",
-    "test:e2e": "npx poku --parallel ci/test/unit,ci/test/integration,ci/test/e2e",
+    "test": "tsx src/bin/index.ts --parallel --debug test/unit,test/integration,test/e2e",
+    "test:c8": "c8 npm run test",
     "test:ci": "tsx ./test/ci.test.ts",
     "test:node": "FILTER='node-' npm run test:ci",
     "test:deno": "FILTER='deno-' npm run test:ci",
     "test:bun": "FILTER='bun-' npm run test:ci",
     "predocker:deno": "docker compose -f ./test/docker/playground/deno/docker-compose.yml down",
     "docker:deno": "docker compose -f ./test/docker/playground/deno/docker-compose.yml up --build",
-    "clear": "rm -rf ./lib ./ci",
+    "clear": "shx rm -rf ./lib ./ci ./coverage",
+    "prebuild": "npm run clear",
     "build": "tsc && tsc -p tsconfig.test.json",
-    "postbuild": "tsx ./tools/compatibility/node.ts && chmod +x lib/bin/index.js",
+    "postbuild": "tsx ./tools/compatibility/node.ts && shx cp fixtures/server/package.json ci/fixtures/server/package.json && shx chmod +x lib/bin/index.js",
     "eslint:checker": "eslint . --ext .js,.ts",
     "eslint:fix": "eslint . --fix --config ./.eslintrc.json",
     "lint:checker": "npm run eslint:checker && npm run prettier:checker",
@@ -103,9 +102,9 @@
   ],
   "type": "commonjs",
   "devDependencies": {
-    "@types/node": "^20.11.27",
-    "@typescript-eslint/eslint-plugin": "^7.2.0",
-    "@typescript-eslint/parser": "^7.2.0",
+    "@types/node": "^20.12.7",
+    "@typescript-eslint/eslint-plugin": "^7.7.1",
+    "@typescript-eslint/parser": "^7.7.1",
     "c8": "^9.1.0",
     "eslint": "^8.57.0",
     "eslint-config-prettier": "^9.1.0",
@@ -114,7 +113,8 @@
     "eslint-plugin-prettier": "^5.1.3",
     "packages-update": "^1.2.1",
     "prettier": "^3.2.5",
-    "tsx": "^4.7.1",
-    "typescript": "^5.4.2"
+    "shx": "^0.3.4",
+    "tsx": "4.2.1",
+    "typescript": "^5.4.5"
   }
 }